@xyo-network/xl1-cli 5.1.1 → 5.2.0

package/dist/cli-min.mjs

@@ -66368,7 +66368,7 @@ config$1(en_default());
 //#region ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/index.js
 var zod_default = external_exports;
 //#endregion
-//#region ../../node_modules/.pnpm/@xyo-network+xl1-protocol@5.2.3_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@4.4._fbc42be6f32cdaed5463bdb0247640b5/node_modules/@xyo-network/xl1-protocol/dist/neutral/protocol-model.mjs
+//#region ../../node_modules/.pnpm/@xyo-network+xl1-protocol@5.3.1_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@4.4._8d90734bf06d8373d67780d6e09d467a/node_modules/@xyo-network/xl1-protocol/dist/neutral/protocol-model.mjs
 var ExchangeOutcomeSchema$1 = asSchema$1("network.xyo.exchange.outcome", true);
 var isExchangeOutcome$1 = isPayloadOfZodType$1(/* @__PURE__ */ object$5({
 	/** Hash of the ExchangeTerms payload this outcome settles */
@@ -67254,7 +67254,7 @@ var TransactionRejectionSchema$1 = asSchema$1("network.xyo.transaction.rejection
 var isTransactionRejection$1 = isPayloadOfSchemaType$1(TransactionRejectionSchema$1);
 AsObjectFactory.create(isTransactionRejection$1);
 //#endregion
-//#region ../../node_modules/.pnpm/@xyo-network+xl1-protocol@5.2.3_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@4.4._fbc42be6f32cdaed5463bdb0247640b5/node_modules/@xyo-network/xl1-protocol/dist/neutral/protocol-lib.mjs
+//#region ../../node_modules/.pnpm/@xyo-network+xl1-protocol@5.3.1_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@4.4._8d90734bf06d8373d67780d6e09d467a/node_modules/@xyo-network/xl1-protocol/dist/neutral/protocol-lib.mjs
 function derivedReceiveAddress(address, scope) {
 	return toAddress(keccak256(new TextEncoder().encode(isDefined$1(scope) ? `${scope}|${address}` : address)).slice(-40), { prefix: false });
 }
@@ -67290,6 +67290,20 @@ var NetworkStakeRewardsIndexPublishRunnerMoniker = "NetworkStakeRewardsIndexPubl
 var SystemStatusRunnerMoniker = "SystemStatusRunner";
 var SystemStatusViewerMoniker$1 = "SystemStatusViewer";
 var SystemStatusPublisherMoniker = "SystemStatusPublisher";
+var FinalizedBlockStreamMoniker$1 = "FinalizedBlockStream";
+var FinalizedBlockStreamDesyncError$1 = class extends Error {
+	/** The block whose `previous` did not match, when it could be fetched. */
+	block;
+	/** The hash the walk expected the next block's `previous` to be. */
+	expectedPrevious;
+	constructor(expectedPrevious, block) {
+		const found = block ? `found ${block[0].previous} at block ${block[0].block}` : "no block found";
+		super(`FinalizedBlockStream desynced: expected previous ${expectedPrevious}, ${found}`);
+		this.name = "FinalizedBlockStreamDesyncError";
+		this.expectedPrevious = expectedPrevious;
+		this.block = block;
+	}
+};
 var BlocksStepSummarySchema$1 = asSchema$1("network.xyo.step.summary.blocks", true);
 var isBlocksStepSummary$1 = isPayloadOfSchemaType$1(BlocksStepSummarySchema$1);
 var asBlocksStepSummary$1 = AsObjectFactory.create(isBlocksStepSummary$1);
@@ -67498,7 +67512,7 @@ var TransactionValidationViewerMoniker$1 = "TransactionValidationViewer";
 var WindowedBlockViewerMoniker$1 = "WindowedBlockViewer";
 var XyoViewerMoniker$1 = "XyoViewer";
 //#endregion
-//#region ../../node_modules/.pnpm/@xyo-network+xl1-protocol@5.2.3_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@4.4._fbc42be6f32cdaed5463bdb0247640b5/node_modules/@xyo-network/xl1-protocol/dist/neutral/network-model.mjs
+//#region ../../node_modules/.pnpm/@xyo-network+xl1-protocol@5.3.1_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@4.4._8d90734bf06d8373d67780d6e09d467a/node_modules/@xyo-network/xl1-protocol/dist/neutral/network-model.mjs
 var local_default = "<svg id=\"Layer_1\" xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 256 256\"><g style=\"opacity:.5;\"><path d=\"M154.71,97c.46,2.59,2.5,4.62,5.1,5.05l14.05,2.34,31.71-46.17c4.57-6.65-3.62-14.62-10.14-9.87l-43.68,31.83,2.97,16.82Z\" style=\"fill:#f47f00;\"/><path d=\"M173.86,151.62l-14.05,2.34c-2.6.43-4.64,2.45-5.1,5.05l-2.97,16.82,43.68,31.83c6.52,4.75,14.71-3.21,10.14-9.87l-31.71-46.17Z\" style=\"fill:#f47f00;\"/><path d=\"M82.14,104.38l14.05-2.34c2.6-.43,4.64-2.45,5.1-5.05l2.97-16.82-43.68-31.83c-6.52-4.75-14.71,3.21-10.14,9.87l31.71,46.17Z\" style=\"fill:#f47f00;\"/><path d=\"M101.29,159c-.46-2.59-2.5-4.62-5.1-5.05l-14.05-2.34-31.71,46.17c-4.57,6.65,3.62,14.62,10.14,9.87l43.68-31.83-2.97-16.82Z\" style=\"fill:#f47f00;\"/></g><path d=\"M107.33,104l15.94-90.32c.93-5.3,8.53-5.3,9.47,0l15.94,90.32c.35,2.01,1.94,3.57,3.95,3.91l92.24,15.35c5.36.89,5.36,8.59,0,9.49l-92.24,15.35c-2.01.33-3.59,1.9-3.95,3.91l-15.94,90.32c-.93,5.3-8.53,5.3-9.47,0l-15.94-90.32c-.35-2.01-1.94-3.57-3.95-3.91l-92.24-15.35c-5.36-.89-5.36-8.59,0-9.49l92.24-15.35c2.01-.33,3.59-1.9,3.95-3.91Z\" style=\"fill:#f47f00;\"/></svg>";
 var mainnet_default = "<svg id=\"Layer_1\" xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 256 256\"><path d=\"M154.71,97c.46,2.59,2.5,4.62,5.1,5.05l14.05,2.34,31.71-46.17c4.57-6.65-3.62-14.62-10.14-9.87l-43.68,31.83,2.97,16.82Z\" style=\"fill:#8d8fc6;\"/><path d=\"M173.86,151.62l-14.05,2.34c-2.6.43-4.64,2.45-5.1,5.05l-2.97,16.82,43.68,31.83c6.52,4.75,14.71-3.21,10.14-9.87l-31.71-46.17Z\" style=\"fill:#eb407a;\"/><path d=\"M82.14,104.38l14.05-2.34c2.6-.43,4.64-2.45,5.1-5.05l2.97-16.82-43.68-31.83c-6.52-4.75-14.71,3.21-10.14,9.87l31.71,46.17Z\" style=\"fill:#579fd6;\"/><path d=\"M101.29,159c-.46-2.59-2.5-4.62-5.1-5.05l-14.05-2.34-31.71,46.17c-4.57,6.65,3.62,14.62,10.14,9.87l43.68-31.83-2.97-16.82Z\" style=\"fill:#f27046;\"/><path d=\"M107.33,104l15.94-90.32c.93-5.3,8.53-5.3,9.47,0l15.94,90.32c.35,2.01,1.94,3.57,3.95,3.91l92.24,15.35c5.36.89,5.36,8.59,0,9.49l-92.24,15.35c-2.01.33-3.59,1.9-3.95,3.91l-15.94,90.32c-.93,5.3-8.53,5.3-9.47,0l-15.94-90.32c-.35-2.01-1.94-3.57-3.95-3.91l-92.24-15.35c-5.36-.89-5.36-8.59,0-9.49l92.24-15.35c2.01-.33,3.59-1.9,3.95-3.91Z\" style=\"fill:#572aff;\"/></svg>";
 var testnet_default = "<svg id=\"Layer_1\" xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 256 256\"><g style=\"opacity:.5;\"><path d=\"M154.71,97c.46,2.59,2.5,4.62,5.1,5.05l14.05,2.34,31.71-46.17c4.57-6.65-3.62-14.62-10.14-9.87l-43.68,31.83,2.97,16.82Z\" style=\"fill:#579fd6;\"/><path d=\"M173.86,151.62l-14.05,2.34c-2.6.43-4.64,2.45-5.1,5.05l-2.97,16.82,43.68,31.83c6.52,4.75,14.71-3.21,10.14-9.87l-31.71-46.17Z\" style=\"fill:#579fd6;\"/><path d=\"M82.14,104.38l14.05-2.34c2.6-.43,4.64-2.45,5.1-5.05l2.97-16.82-43.68-31.83c-6.52-4.75-14.71,3.21-10.14,9.87l31.71,46.17Z\" style=\"fill:#579fd6;\"/><path d=\"M101.29,159c-.46-2.59-2.5-4.62-5.1-5.05l-14.05-2.34-31.71,46.17c-4.57,6.65,3.62,14.62,10.14,9.87l43.68-31.83-2.97-16.82Z\" style=\"fill:#579fd6;\"/></g><path d=\"M107.33,104l15.94-90.32c.93-5.3,8.53-5.3,9.47,0l15.94,90.32c.35,2.01,1.94,3.57,3.95,3.91l92.24,15.35c5.36.89,5.36,8.59,0,9.49l-92.24,15.35c-2.01.33-3.59,1.9-3.95,3.91l-15.94,90.32c-.93,5.3-8.53,5.3-9.47,0l-15.94-90.32c-.35-2.01-1.94-3.57-3.95-3.91l-92.24-15.35c-5.36-.89-5.36-8.59,0-9.49l92.24-15.35c2.01-.33,3.59-1.9,3.95-3.91Z\" style=\"fill:#579fd6;\"/></svg>";
@@ -68148,7 +68162,7 @@ function admissionShadowHeadPath() {
 	return "admission/shadow/head.json";
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@xyo-network+xl1-protocol@5.2.3_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@4.4._fbc42be6f32cdaed5463bdb0247640b5/node_modules/@xyo-network/xl1-protocol/dist/neutral/schema.mjs
+//#region ../../node_modules/.pnpm/@xyo-network+xl1-protocol@5.3.1_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@4.4._8d90734bf06d8373d67780d6e09d467a/node_modules/@xyo-network/xl1-protocol/dist/neutral/schema.mjs
 var asRequiredStrings = (required) => {
 	if (typeof required === "string") return [required];
 	if (!Array.isArray(required)) return [];
@@ -68384,7 +68398,7 @@ var TransferPayloadJsonSchema = {
 };
 var TransferPayloadJsonSchemaPayload = new PayloadBuilder$1({ schema: SchemaSchema$1 }).fields({ definition: TransferPayloadJsonSchema }).build();
 //#endregion
-//#region ../../node_modules/.pnpm/@xyo-network+xl1-protocol@5.2.3_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@4.4._fbc42be6f32cdaed5463bdb0247640b5/node_modules/@xyo-network/xl1-protocol/dist/neutral/validation.mjs
+//#region ../../node_modules/.pnpm/@xyo-network+xl1-protocol@5.3.1_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@4.4._8d90734bf06d8373d67780d6e09d467a/node_modules/@xyo-network/xl1-protocol/dist/neutral/validation.mjs
 function maxTransactionFeeCost(tx) {
 	const { base, gasLimit, priority } = tx.fees;
 	return hexToBigInt(base) + hexToBigInt(priority) + hexToBigInt(gasLimit);
@@ -68630,7 +68644,7 @@ var validateTransaction = async (context, tx, additionalValidators) => {
 	}
 };
 //#endregion
-//#region ../../node_modules/.pnpm/@xyo-network+xl1-sdk@5.2.3_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@4.4.3__@o_f803ff54f950c092c4a357d77886b418/node_modules/@xyo-network/xl1-sdk/dist/neutral/driver-memory.mjs
+//#region ../../node_modules/.pnpm/@xyo-network+xl1-sdk@5.3.1_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@4.4.3__@o_3a01f3229f2daa942444e08696345b23/node_modules/@xyo-network/xl1-sdk/dist/neutral/driver-memory.mjs
 var LruCacheMap$1 = class {
 	lruCache;
 	/** Creates an instance with the supplied configuration. */
@@ -71814,7 +71828,7 @@ var require_ExplorerSync = /* @__PURE__ */ __commonJSMin(((exports) => {
 	exports.ExplorerSync = ExplorerSync;
 }));
 //#endregion
-//#region ../../node_modules/.pnpm/@xyo-network+xl1-sdk@5.2.3_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@4.4.3__@o_f803ff54f950c092c4a357d77886b418/node_modules/@xyo-network/xl1-sdk/dist/node/protocol-sdk.mjs
+//#region ../../node_modules/.pnpm/@xyo-network+xl1-sdk@5.3.1_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@4.4.3__@o_3a01f3229f2daa942444e08696345b23/node_modules/@xyo-network/xl1-sdk/dist/node/protocol-sdk.mjs
 var import_dist = (/* @__PURE__ */ __commonJSMin(((exports) => {
 	Object.defineProperty(exports, "__esModule", { value: true });
 	exports.defaultLoadersSync = exports.defaultLoaders = exports.globalConfigSearchPlacesSync = exports.globalConfigSearchPlaces = exports.getDefaultSearchPlacesSync = exports.getDefaultSearchPlaces = exports.cosmiconfigSync = exports.cosmiconfig = void 0;
@@ -73065,21 +73079,47 @@ function blocksToChains$1(blocks) {
 	}
 	return chains;
 }
-function toValidUncle$1(_context, finalizedWindowedChain, possibleUncle) {
+function toValidUncle$1(_context, finalizedWindowedChain, possibleUncle, onReject) {
 	const finalizedWindowStartBlockNumber = finalizedWindowedChain.at(0)?.[0].block ?? -1;
 	const finalizedHead = assertEx$1(finalizedWindowedChain.at(-1), () => "finalizedWindowedChain is empty");
+	const tip = assertEx$1(possibleUncle.at(-1), () => "possibleUncle is empty");
+	const reject = (reason, offendingTransactionHashes) => {
+		onReject?.({
+			blockHash: tip[0]._hash,
+			blockNumber: tip[0].block,
+			offendingTransactionHashes,
+			reason
+		});
+	};
 	const prunedPossibleUncle = possibleUncle.filter((b) => b[0].block > finalizedHead[0].block);
-	if (prunedPossibleUncle.length === 0) return;
-	if (prunedPossibleUncle[0][0].block !== finalizedHead[0].block + 1) return;
-	if (prunedPossibleUncle[0][0].previous !== finalizedHead[0]._hash) return;
+	if (prunedPossibleUncle.length === 0) {
+		reject("behind-finalized-head");
+		return;
+	}
+	if (prunedPossibleUncle[0][0].block !== finalizedHead[0].block + 1) {
+		reject("block-number-mismatch");
+		return;
+	}
+	if (prunedPossibleUncle[0][0].previous !== finalizedHead[0]._hash) {
+		reject("previous-hash-mismatch");
+		return;
+	}
 	const allUncleTransactions = prunedPossibleUncle.flatMap((b) => b[1]).filter(isTransactionBoundWitness$1);
 	const allFinalizedTransactions = finalizedWindowedChain.flatMap((b) => b[1]).filter(isTransactionBoundWitness$1);
-	if (allUncleTransactions.some((tx) => tx.nbf < finalizedWindowStartBlockNumber)) return;
-	if (allUncleTransactions.some((tx) => allFinalizedTransactions.some((finalTx) => finalTx._hash === tx._hash))) return;
+	const txsBeforeWindow = allUncleTransactions.filter((tx) => tx.nbf < finalizedWindowStartBlockNumber);
+	if (txsBeforeWindow.length > 0) {
+		reject("tx-before-window", txsBeforeWindow.map((tx) => tx._hash));
+		return;
+	}
+	const txsInWindow = allUncleTransactions.filter((tx) => allFinalizedTransactions.some((finalTx) => finalTx._hash === tx._hash));
+	if (txsInWindow.length > 0) {
+		reject("tx-already-finalized", txsInWindow.map((tx) => tx._hash));
+		return;
+	}
 	return prunedPossibleUncle;
 }
-function findUncles$1(context, finalizedWindowedChain, blocks) {
-	return blocksToChains$1(blocks).map((chain) => toValidUncle$1(context, finalizedWindowedChain, chain)).filter(exists$1);
+function findUncles$1(context, finalizedWindowedChain, blocks, onReject) {
+	return blocksToChains$1(blocks).map((chain) => toValidUncle$1(context, finalizedWindowedChain, chain, onReject)).filter(exists$1);
 }
 var ValidationConfigZod$1 = object$3({
 	signerAuthorizations: array$1(SignerAuthorizationZod$1).default([]).register(globalRegistry, {
@@ -73933,6 +73973,21 @@ async function buildUnsignedTransaction(chain, onChainPayloads, offChainPayloads
 }
 var DEFAULT_CONFIRMATION_ATTEMPTS = 20;
 var DEFAULT_DELAY_BETWEEN_ATTEMPTS = 1e3;
+var TransactionConfirmationTimeoutError = class extends Error {
+	/** Number of confirmation attempts made before giving up. */
+	attempts;
+	/** Marks the negative result as inconclusive: the transaction may still be pending or included later. */
+	inconclusive = true;
+	/** Hash of the transaction whose confirmation timed out. */
+	txHash;
+	/** Creates an instance for the given transaction and attempt count. */
+	constructor(txHash, attempts) {
+		super(`Transaction ${txHash} not confirmed after ${attempts} attempts \u2014 inconclusive: the transaction may still be pending or included later`);
+		this.name = "TransactionConfirmationTimeoutError";
+		this.attempts = attempts;
+		this.txHash = txHash;
+	}
+};
 var assertNotExpired = async (viewer, txHash, exp, options) => {
 	const head = await viewer.currentBlockNumber();
 	if (head > exp) {
@@ -73953,8 +74008,8 @@ var confirmSubmittedTransaction = async (viewer, txHash, options) => {
 		if (isNumber(exp)) await assertNotExpired(viewer, txHash, exp, options);
 		attempts++;
 		if (attempts > maxAttempts) {
-			options?.logger?.error(`\u26A0\uFE0F Transaction not confirmed after ${maxAttempts} attempts`);
-			throw new Error(`Transaction ${txHash} not confirmed after ${maxAttempts} attempts`);
+			options?.logger?.error(`\u26A0\uFE0F Transaction not confirmed after ${maxAttempts} attempts (inconclusive \u2014 it may still be pending)`);
+			throw new TransactionConfirmationTimeoutError(txHash, maxAttempts);
 		}
 		options?.logger?.debug(`Transaction not confirmed yet, attempt ${attempts}. Retrying...`, txHash);
 		await delay$2(attemptDelay);
@@ -75206,6 +75261,7 @@ var SimpleBlockValidationViewer$1 = class extends AbstractCreatableProvider$1 {
 			state: true,
 			head: void 0
 		};
+		if (config !== void 0 && value !== true && state !== true) this.logger?.warn("validateBlocks called with a config that selects no validators (neither value nor state is true) — every block will report valid");
 		const blocksWithMeta = await Promise.all(blocks.map((b) => Promise.all([PayloadBuilder$1.addHashMeta(b[0]), PayloadBuilder$1.addHashMeta(b[1])])));
 		let head;
 		if (isChainQualifiedHeadConfig$1(config)) {
@@ -75254,18 +75310,30 @@ var SimpleBlockValidationViewer$1 = class extends AbstractCreatableProvider$1 {
 	}
 	async doValidateState(blocks, chainIdAtBlockNumber) {
 		const windowedUncleChain = await this.updateWindowedChainCache();
-		const uncles = findUncles$1(this.context, windowedUncleChain, blocks);
+		const rejections = [];
+		const uncles = findUncles$1(this.context, windowedUncleChain, blocks, (rejection) => rejections.push(rejection));
 		if (uncles.length !== 1) {
-			this.logger?.warn(`Unexpected uncle count during block validation [uncles=${uncles.length}, blocks=${blocks.length}]`);
+			const rejectionSummary = rejections.map((r) => `${r.blockNumber} [${r.blockHash}]: ${r.reason}${(r.offendingTransactionHashes?.length ?? 0) > 0 ? ` (tx ${r.offendingTransactionHashes?.join(", ")})` : ""}`).join("; ");
+			this.logger?.warn(`Unexpected uncle count during block validation [uncles=${uncles.length}, blocks=${blocks.length}]` + (rejectionSummary.length > 0 ? ` \u2014 rejected: ${rejectionSummary}` : ""));
 			this.logger?.debug(JSON.stringify({
 				uncles,
 				blocks: blocks.length
 			}, null, 2));
 			this.logger?.debug(JSON.stringify(windowedUncleChain, null, 2));
-			return blocks.map((block) => [new HydratedBlockValidationError$1(block[0]._hash, block, "Unexpected uncle count during state validation", {
-				uncles: uncles.length,
-				blocks: blocks.length
-			})]);
+			return blocks.map((block) => {
+				const rejection = rejections.find((r) => r.blockHash === block[0]._hash);
+				const offendingTransactionHashes = rejection?.offendingTransactionHashes ?? [];
+				if (rejection && offendingTransactionHashes.length > 0) return offendingTransactionHashes.map((txHash) => new HydratedBlockValidationError$1(txHash, block, `Uncle rejected during state validation: ${rejection.reason}`, {
+					blockHash: rejection.blockHash,
+					hash: txHash,
+					reason: rejection.reason
+				}));
+				return [new HydratedBlockValidationError$1(block[0]._hash, block, `Unexpected uncle count during state validation${rejection ? `: ${rejection.reason}` : ""}`, {
+					reason: rejection?.reason,
+					uncles: uncles.length,
+					blocks: blocks.length
+				})];
+			});
 		}
 		const validateState = assertEx$1(this.validators.blockStateValidator, () => "No block state validator registered");
 		return await Promise.all(uncles[0].map(async (block) => {
@@ -76102,6 +76170,303 @@ __publicField$25(SimpleFinalizationViewer$1, "monikers", [FinalizationViewerMoni
 /** Read, write, or mixed capability surface exposed by the provider. */
 __publicField$25(SimpleFinalizationViewer$1, "surface", "node");
 SimpleFinalizationViewer$1 = __decorateClass$26([creatableProvider$1()], SimpleFinalizationViewer$1);
+var MIN_POLL_INTERVAL_MS$1 = 5e3;
+var DEFAULT_POLL_INTERVAL_MS$1 = 1e4;
+var DEFAULT_FETCH_WINDOW$1 = StepSizes$1[2];
+var MAX_FETCH_WINDOW$1 = StepSizes$1[3];
+var SimpleFinalizedBlockStreamOptionsZod$1 = object$3({
+	/**
+	* Hot-surface resume checkpoint: emit blocks strictly after this hash, as a
+	* verified splice (the first emission's `previous` must equal it — mismatch
+	* emits `desynced` at startup rather than delivering a diverged chain).
+	* Omitted, the stream starts at the current head, delivered as the first
+	* `nextBlock`.
+	*/
+	after: optional$1(HashZod),
+	/**
+	* Upper bound on blocks fetched per `blocksByNumber` window during a walk.
+	* The window adapts to the lag (never fetching past the head) and grows up to
+	* this cap on deep replays, letting REST-backed viewers tile each window from
+	* step rollup files. Capped at the largest served rollup (`StepSizes[3]`);
+	* raise toward it for indexer-style deep replays, lower it to bound memory.
+	*/
+	fetchWindow: number$1().int().positive().max(MAX_FETCH_WINDOW$1).default(DEFAULT_FETCH_WINDOW$1),
+	/**
+	* Hot-surface catch-up bound: when the head is further ahead than this, a
+	* `gap` is announced and delivery resumes `maxCatchUp` blocks behind head.
+	* The cold `blocks()` surface ignores this — it never gaps.
+	*/
+	maxCatchUp: number$1().int().positive().default(StepSizes$1[1]),
+	/** Head poll cadence shared by the hot surface and all `blocks()` iterations. */
+	pollIntervalMs: number$1().min(MIN_POLL_INTERVAL_MS$1).default(DEFAULT_POLL_INTERVAL_MS$1)
+});
+function cursorFromBlock$1(block) {
+	return {
+		block: block[0].block,
+		hash: block[0]._hash
+	};
+}
+var SimpleFinalizedBlockStream$1 = class extends AbstractCreatableProvider$1 {
+	/** Moniker implemented by this provider instance. */
+	moniker = FinalizedBlockStreamMoniker$1;
+	_blockViewer;
+	_cursor;
+	_finalizationViewer;
+	_head;
+	_headWaiters = [];
+	_hotLoop;
+	_isLive = false;
+	_options;
+	_pollInProgress = false;
+	_pollTimer = null;
+	_stopping = false;
+	_terminal = false;
+	/** Last position delivered on the hot surface, or `undefined` before the first. */
+	get cursor() {
+		return this._cursor;
+	}
+	/** True once the hot surface has caught up to the live head. */
+	get isLive() {
+		return this._isLive;
+	}
+	get options() {
+		this._options ??= SimpleFinalizedBlockStreamOptionsZod$1.parse(this.config.options);
+		return this._options;
+	}
+	/** Validates the provider options at create time. */
+	static async paramsHandler(params = {}) {
+		const handled = await super.paramsHandler(params);
+		SimpleFinalizedBlockStreamOptionsZod$1.parse(handled.context.config.options);
+		return handled;
+	}
+	/**
+	* Cold, per-caller iteration: replay from `after`, then follow the head.
+	* Gapless by construction — the caller paces the walk. Throws
+	* `FinalizedBlockStreamDesyncError` on any continuity failure, including a
+	* failed resume splice; other (transient) fetch errors also throw, and the
+	* caller resumes from its own checkpoint.
+	*/
+	async *blocks(options) {
+		let cursor;
+		if (isDefined$1(options?.after)) cursor = await this.resolveCheckpoint(options.after);
+		else {
+			const head = await this.currentHead();
+			yield {
+				block: head,
+				head: head[0].block
+			};
+			cursor = cursorFromBlock$1(head);
+		}
+		while (!this._stopping) {
+			const headNumber = (await this.currentHead())[0].block;
+			if (cursor.block >= headNumber) {
+				await this.waitForHeadAdvance();
+				continue;
+			}
+			for (const block of await this.nextBlocks(cursor, headNumber)) {
+				cursor = this.advanceCursor(cursor, block);
+				yield {
+					block,
+					head: headNumber
+				};
+				if (this._stopping) return;
+			}
+		}
+	}
+	/** Creates the provider instance after its dependencies and configuration have resolved. */
+	async createHandler() {
+		await super.createHandler();
+		const injected = this.params.viewers;
+		this._blockViewer = injected?.blocks ?? assertEx$1(await this.locator.getInstance("BlockViewer"), () => "BlockViewer instance is required");
+		this._finalizationViewer = injected?.finalization ?? assertEx$1(await this.locator.getInstance("FinalizationViewer"), () => "FinalizationViewer instance is required");
+	}
+	/** Starts the head poll and the hot delivery loop. */
+	async startHandler() {
+		await super.startHandler();
+		this._stopping = false;
+		this._terminal = false;
+		await this.pollHead();
+		this._pollTimer = setInterval(() => {
+			this.pollHead();
+		}, this.options.pollIntervalMs);
+		this._hotLoop = this.runHot();
+	}
+	/** Stops the poll, ends the hot loop, and emits the terminal `stopped` event. */
+	async stopHandler() {
+		this._stopping = true;
+		if (this._pollTimer) {
+			clearInterval(this._pollTimer);
+			this._pollTimer = null;
+		}
+		this.releaseHeadWaiters();
+		await this._hotLoop;
+		this._hotLoop = void 0;
+		if (!this._terminal) {
+			this._terminal = true;
+			await this.emitSerial("stopped", { cursor: this._cursor });
+		}
+		this._head = void 0;
+		await super.stopHandler();
+	}
+	/**
+	* Verifies continuity and advances a cursor to the delivered block. A
+	* `previous` mismatch on the expected block number is a data-integrity
+	* fault; a wrong/missing block number is a transient fetch problem.
+	*/
+	advanceCursor(cursor, block) {
+		assertEx$1(block[0].block === cursor.block + 1, () => `FinalizedBlockStream: expected block ${cursor.block + 1}, fetched ${block[0].block}`);
+		if (block[0].previous !== cursor.hash) throw new FinalizedBlockStreamDesyncError$1(cursor.hash, block);
+		return cursorFromBlock$1(block);
+	}
+	/** One hot-loop step: bound the lag (announcing a `gap`), deliver the next window, mark live. */
+	async advanceHot() {
+		const head = await this.currentHead();
+		const headNumber = head[0].block;
+		const cursor = assertEx$1(this._cursor);
+		if (cursor.block >= headNumber) {
+			await this.markLive(head);
+			await this.waitForHeadAdvance();
+			return;
+		}
+		if (headNumber - cursor.block > this.options.maxCatchUp) {
+			await this.announceGap(cursor, headNumber);
+			return;
+		}
+		for (const block of await this.nextBlocks(cursor, headNumber)) {
+			if (this._stopping) return;
+			this._cursor = this.advanceCursor(assertEx$1(this._cursor), block);
+			await this.emitSerial("nextBlock", {
+				block,
+				head: headNumber
+			});
+		}
+		if (assertEx$1(this._cursor).block >= headNumber) await this.markLive(head);
+	}
+	/** Announces a hot-surface gap and splices the shared cursor to `maxCatchUp` behind head. */
+	async announceGap(cursor, headNumber) {
+		const resumeNumber = asXL1BlockNumber$1(headNumber - this.options.maxCatchUp + 1, true);
+		const resumeBlock = assertEx$1(await this._blockViewer.blockByNumber(resumeNumber), () => `FinalizedBlockStream: gap resume block ${resumeNumber} unavailable`);
+		const skipped = [asXL1BlockNumber$1(cursor.block + 1, true), asXL1BlockNumber$1(resumeNumber - 1, true)];
+		this._isLive = false;
+		await this.emitSerial("gap", {
+			before: cursor,
+			resumedAt: cursorFromBlock$1(resumeBlock),
+			skipped
+		});
+		this._cursor = {
+			block: asXL1BlockNumber$1(resumeNumber - 1, true),
+			hash: assertEx$1(resumeBlock[0].previous, () => "FinalizedBlockStream: gap resume block has no previous")
+		};
+	}
+	/** Returns the last polled head, fetching once when no poll has landed yet. */
+	async currentHead() {
+		if (this._head) return this._head;
+		this._head ??= await this._finalizationViewer.head();
+		return this._head;
+	}
+	/** Initializes the hot cursor: verified splice from `after`, or head-first delivery. */
+	async initHotCursor() {
+		const { after } = this.options;
+		if (isDefined$1(after)) {
+			this._cursor = await this.resolveCheckpoint(after);
+			return;
+		}
+		const head = await this.currentHead();
+		this._cursor = cursorFromBlock$1(head);
+		await this.emitSerial("nextBlock", {
+			block: head,
+			head: head[0].block
+		});
+		await this.markLive(head);
+	}
+	/** Marks the hot surface live, emitting the transition once. */
+	async markLive(head) {
+		if (this._isLive) return;
+		this._isLive = true;
+		await this.emitSerial("live", { head: cursorFromBlock$1(head) });
+	}
+	/**
+	* Fetches the ordered run of blocks after `cursor`, up to one window. Order
+	* is normalized here; continuity is verified per block by `advanceCursor`.
+	*/
+	async nextBlocks(cursor, headNumber) {
+		const hi = asXL1BlockNumber$1(Math.min(cursor.block + this.options.fetchWindow, headNumber), true);
+		const run = (await this._blockViewer.blocksByNumber(hi, hi - cursor.block)).filter((block) => block[0].block > cursor.block).toSorted((a, b) => a[0].block - b[0].block);
+		assertEx$1(run.length > 0, () => `FinalizedBlockStream: no blocks fetched in (${cursor.block}, ${hi}]`);
+		return run;
+	}
+	/** Polls the finalized head, releasing all cursor walks blocked on head growth. */
+	async pollHead() {
+		if (this._pollInProgress) return;
+		this._pollInProgress = true;
+		try {
+			const head = await this._finalizationViewer.head();
+			if (head[0]._hash !== this._head?.[0]._hash) {
+				this._head = head;
+				this.releaseHeadWaiters();
+			}
+		} catch (ex) {
+			this.logger?.error("FinalizedBlockStream: error polling head", ex);
+		} finally {
+			this._pollInProgress = false;
+		}
+	}
+	releaseHeadWaiters() {
+		const waiters = this._headWaiters.splice(0);
+		for (const release of waiters) release();
+	}
+	/** Resolves a checkpoint hash to a cursor, or throws the desync error a missing checkpoint implies. */
+	async resolveCheckpoint(after) {
+		const checkpoint = await this._blockViewer.blockByHash(after);
+		if (!checkpoint) throw new FinalizedBlockStreamDesyncError$1(after);
+		return cursorFromBlock$1(checkpoint);
+	}
+	/**
+	* The hot delivery loop. Transient errors are logged and retried on the next
+	* head advance; a continuity failure emits the terminal `desynced` event.
+	*/
+	async runHot() {
+		try {
+			await this.initHotCursor();
+			while (!this._stopping) try {
+				await this.advanceHot();
+			} catch (ex) {
+				if (ex instanceof FinalizedBlockStreamDesyncError$1) throw ex;
+				if (this._stopping) return;
+				this.logger?.error("FinalizedBlockStream: hot loop error, retrying on next head", ex);
+				await this.waitForHeadAdvance();
+			}
+		} catch (ex) {
+			if (ex instanceof FinalizedBlockStreamDesyncError$1 && !this._terminal) {
+				this._terminal = true;
+				await this.emitSerial("desynced", {
+					block: ex.block,
+					expectedPrevious: ex.expectedPrevious
+				});
+				return;
+			}
+			this.logger?.error("FinalizedBlockStream: hot loop terminated", ex);
+		}
+	}
+	/** Suspends until the polled head changes or the stream stops. */
+	waitForHeadAdvance() {
+		if (this._stopping) return Promise.resolve();
+		return new Promise((resolve) => {
+			this._headWaiters.push(resolve);
+		});
+	}
+};
+/** Connection kinds supported by this provider. */
+__publicField$25(SimpleFinalizedBlockStream$1, "connectionTypes", ["none"]);
+/** Primary moniker used to resolve this provider. */
+__publicField$25(SimpleFinalizedBlockStream$1, "defaultMoniker", FinalizedBlockStreamMoniker$1);
+/** Provider monikers that must resolve before this provider can be created. */
+__publicField$25(SimpleFinalizedBlockStream$1, "dependencies", [BlockViewerMoniker$1, FinalizationViewerMoniker$1]);
+/** Provider monikers implemented by this provider class. */
+__publicField$25(SimpleFinalizedBlockStream$1, "monikers", [FinalizedBlockStreamMoniker$1]);
+/** Read, write, or mixed capability surface exposed by the provider. */
+__publicField$25(SimpleFinalizedBlockStream$1, "surface", "node");
+SimpleFinalizedBlockStream$1 = __decorateClass$26([creatableProvider$1()], SimpleFinalizedBlockStream$1);
 var SimpleXyoGatewayRunner = class _SimpleXyoGatewayRunner extends AbstractCreatableProvider$1 {
 	/** Connection kinds supported by this provider. */
 	static connectionTypes = ["none"];
@@ -76345,6 +76710,83 @@ var nextPruneCursor$1 = (batch, pruneHashes, cursor) => {
 	const pruneSet = new Set(pruneHashes);
 	return batch.findLast((bundle3) => !pruneSet.has(bundle3._hash))?._sequence ?? cursor;
 };
+async function simpleBlockValidationCheck$1(payloads, context) {
+	return (await Promise.all(payloads.map(async (payload) => {
+		return [isPayloadBundle$1(payload) ? await bundledPayloadToHydratedBlock$1(payload) : void 0, payload];
+	}))).map(([block, bundle3]) => evaluateBlockCandidate$1(block, bundle3, context));
+}
+async function simpleTransactionValidationCheck$1(payloads, context) {
+	const transactionBundles = await Promise.all(payloads.map(async (payload) => {
+		return [isPayloadBundle$1(payload) ? await bundledPayloadToHydratedTransaction$1(payload) : void 0, payload];
+	}));
+	return Promise.all(transactionBundles.map(async ([transaction, bundle3]) => {
+		return evaluateTransactionCandidate$1(transaction, bundle3, context);
+	}));
+}
+function evaluateBlockCandidate$1(block, bundle3, { chainId, headNumber, logger }) {
+	const typeCheckPassed = isSignedHydratedBlockWithHashMeta$1(block);
+	const chainIdPassed = typeCheckPassed && block[0].chain === chainId;
+	const blockNumberPassed = typeCheckPassed && block[0].block > headNumber;
+	const validationPassed = typeCheckPassed && chainIdPassed && blockNumberPassed;
+	if (!validationPassed) logFailedBlockCheck$1({
+		block,
+		blockNumberPassed,
+		bundle: bundle3,
+		chainIdPassed,
+		headNumber,
+		logger,
+		typeCheckPassed
+	});
+	return [validationPassed ? block : void 0, bundle3];
+}
+async function evaluateTransactionCandidate$1(transaction, bundle3, { chainId, headNumber, logger, maxExpAhead }) {
+	const typeCheckPassed = isSignedHydratedTransactionWithHashMeta$1(transaction);
+	const chainIdPassed = typeCheckPassed && transaction[0].chain === chainId;
+	const expPassed = typeCheckPassed && transaction[0].exp > headNumber && transaction[0].exp <= headNumber + maxExpAhead;
+	const opcodeCheckPassed = await checkTransactionOpcodes$1(transaction, bundle3, logger);
+	const validationPassed = typeCheckPassed && chainIdPassed && expPassed && opcodeCheckPassed;
+	if (!validationPassed) logFailedTransactionCheck$1({
+		bundle: bundle3,
+		chainIdPassed,
+		expPassed,
+		headNumber,
+		logger,
+		opcodeCheckPassed,
+		transaction,
+		typeCheckPassed
+	});
+	return [validationPassed ? transaction : void 0, bundle3];
+}
+async function checkTransactionOpcodes$1(transaction, bundle3, logger) {
+	try {
+		await validateTransactionsOpcodes$1(transaction === void 0 ? [] : [transaction]);
+		return true;
+	} catch (error) {
+		const message = error instanceof Error ? error.message : String(error);
+		logger?.debug(`Opcode validation failed for transaction ${bundle3._hash} during simpleValidationCheck`);
+		logger?.debug(`  - error: ${message}`);
+		return false;
+	}
+}
+function logFailedBlockCheck$1({ block, blockNumberPassed, bundle: bundle3, chainIdPassed, headNumber, logger, typeCheckPassed }) {
+	if (chainIdPassed && typeCheckPassed && !blockNumberPassed) {
+		logger?.debug(`Pruning stale block candidate bundle ${bundle3._hash} during simpleValidationCheck (candidate height ${block?.[0].block} <= finalized head ${headNumber} \u2014 routine GC of a finalized or superseded candidate)`);
+		return;
+	}
+	logger?.debug(`Pruning block bundle ${bundle3._hash} during simpleValidationCheck`);
+	logger?.debug(`  - chainId match: ${chainIdPassed}`);
+	logger?.debug(`  - blockNumber check: ${blockNumberPassed} [head=${headNumber} candidate=${block?.[0].block}]`);
+	logger?.debug(`  - typeCheck: ${typeCheckPassed}`);
+	logger?.debug(`  - bundle hash: ${bundle3._hash}`);
+}
+function logFailedTransactionCheck$1({ bundle: bundle3, chainIdPassed, expPassed, headNumber, logger, opcodeCheckPassed, transaction, typeCheckPassed }) {
+	logger?.debug(`Pruning transaction bundle ${bundle3._hash} during simpleValidationCheck`);
+	logger?.debug(`  - chainId match: ${chainIdPassed}`);
+	logger?.debug(`  - exp check: ${expPassed} [head=${headNumber} exp=${transaction?.[0].exp}]`);
+	logger?.debug(`  - opcode check: ${opcodeCheckPassed}`);
+	logger?.debug(`  - typeCheck: ${typeCheckPassed}`);
+	logger?.debug(`  - bundle hash: ${bundle3._hash}`);
+}
 var DEFAULT_SYNC_INTERVAL$1 = 3e4;
 var DEFAULT_SYNC_LIMIT$1 = 100;
 var ENFORCE_CAP_BATCH_SIZE$1 = 1e3;
@@ -76477,7 +76919,11 @@ var SimpleMempoolRunner$1 = class extends AbstractCreatableProvider$1 {
 		}
 		while (batch.length > 0 && pruned < maxPrune && total < maxCheck) {
 			batches += 1;
-			const blocksAndBundles = await this.simpleBlockValidationCheck(batch);
+			const blocksAndBundles = await simpleBlockValidationCheck$1(batch, {
+				chainId: await this.chainContractViewer.chainId(),
+				headNumber: await this.finalizationViewer.headNumber(),
+				logger: this.logger
+			});
 			const blocks = blocksAndBundles.map(([b]) => b);
 			const bundles = blocksAndBundles.map(([_, p]) => p);
 			const valid = blocks.map((b) => !!b);
@@ -76491,9 +76937,10 @@ var SimpleMempoolRunner$1 = class extends AbstractCreatableProvider$1 {
 					state: true
 				}))),
 				isValidated: isSignedHydratedBlockWithHashMeta$1,
-				onInvalid: ({ bundle: bundle3, result }) => {
-					const errors = result;
+				onInvalid: async ({ bundle: bundle3, item, result }) => {
+					const errors = isSignedHydratedBlockWithHashMeta$1(result) ? [] : result;
 					this.logger?.info(`[SimpleMempoolRunner] prunePendingBlocks deleting block ${bundle3._hash} (validation: ${errors.at(0)?.message ?? "failed simple/full check"})`);
+					await this.routeRejectedBlock(item, errors);
 				}
 			});
 			const pruneHashes = invalidBundleHashes$1(bundles, valid);
@@ -76529,7 +76976,12 @@ var SimpleMempoolRunner$1 = class extends AbstractCreatableProvider$1 {
 		}
 		while (batch.length > 0 && pruned < maxPrune && total < maxCheck) {
 			batches += 1;
-			const transactionsAndBundles = await this.simpleTransactionValidationCheck(batch);
+			const transactionsAndBundles = await simpleTransactionValidationCheck$1(batch, {
+				chainId: await this.chainContractViewer.chainId(),
+				headNumber: await this.finalizationViewer.headNumber(),
+				logger: this.logger,
+				maxExpAhead: this.maxExpAhead
+			});
 			const transactions = transactionsAndBundles.map(([t]) => t);
 			const bundles = transactionsAndBundles.map(([_, p]) => p);
 			const valid = transactions.map((t) => !!t);
@@ -76689,6 +77141,20 @@ var SimpleMempoolRunner$1 = class extends AbstractCreatableProvider$1 {
 		if (isDemotionAware$1(this._mempoolViewer)) return this._mempoolViewer.getEvictionPriorityOrder(bundleHashesOldestFirst);
 		return bundleHashesOldestFirst;
 	}
+	async routeRejectedBlock(block, errors) {
+		if (!this._deadLetterQueueRunner) return;
+		const rejectionErrors = errors.map((e) => ({
+			hash: e.hash ?? block[0]._hash,
+			name: e.name ?? "BlockValidationError",
+			message: String(e.message ?? e)
+		}));
+		await this._deadLetterQueueRunner.rejectBlock({
+			schema: BlockRejectionSchema$1,
+			block,
+			errors: rejectionErrors,
+			rejector: "mempool"
+		});
+	}
 	async routeRejectedTransaction(transaction, errors) {
 		if (!this._deadLetterQueueRunner) return;
 		const rejectionErrors = errors.map((e) => ({
@@ -76703,60 +77169,6 @@ var SimpleMempoolRunner$1 = class extends AbstractCreatableProvider$1 {
 			rejector: "mempool"
 		});
 	}
-	async simpleBlockValidationCheck(payloads) {
-		const headNumber = await this.finalizationViewer.headNumber();
-		const chainId = await this.chainContractViewer.chainId();
-		return (await Promise.all(payloads.map(async (p) => {
-			return [isPayloadBundle$1(p) ? await bundledPayloadToHydratedBlock$1(p) : void 0, p];
-		}))).map(([block, bundle3]) => {
-			const blockCheckPassed = !!block;
-			const chainIdPassed = blockCheckPassed ? block[0].chain === chainId : false;
-			const blockNumberPassed = blockCheckPassed ? block[0].block > headNumber : false;
-			const typeCheckPassed = blockCheckPassed ? isSignedHydratedBlockWithHashMeta$1(block) : false;
-			const validationPassed = blockCheckPassed && chainIdPassed && blockNumberPassed && typeCheckPassed;
-			const validatedBlock = validationPassed ? block : void 0;
-			if (!validationPassed) {
-				this.logger?.debug(`Pruning block bundle ${bundle3._hash} during simpleValidationCheck`);
-				this.logger?.debug(`  - chainId match: ${chainIdPassed}`);
-				this.logger?.debug(`  - blockNumber check: ${blockNumberPassed} [${headNumber}|${block?.[0].block}]`);
-				this.logger?.debug(`  - typeCheck: ${typeCheckPassed}`);
-				this.logger?.debug(`  - bundle hash: ${bundle3._hash}`);
-			}
-			return [validatedBlock, bundle3];
-		});
-	}
-	async simpleTransactionValidationCheck(payloads) {
-		const headNumber = await this.finalizationViewer.headNumber();
-		const chainId = await this.chainContractViewer.chainId();
-		const transactionBundles = await Promise.all(payloads.map(async (p) => {
-			return [isPayloadBundle$1(p) ? await bundledPayloadToHydratedTransaction$1(p) : void 0, p];
-		}));
-		return await Promise.all(transactionBundles.map(async ([transaction, bundle3]) => {
-			const transactionCheckPassed = !!transaction;
-			const chainIdPassed = transactionCheckPassed ? transaction[0].chain === chainId : false;
-			const expPassed = transactionCheckPassed ? transaction[0].exp > headNumber && transaction[0].exp <= headNumber + this.maxExpAhead : false;
-			const typeCheckPassed = transactionCheckPassed ? isSignedHydratedTransactionWithHashMeta$1(transaction) : false;
-			let opcodeCheckPassed = false;
-			try {
-				await validateTransactionsOpcodes$1(transaction ? [transaction] : []);
-				opcodeCheckPassed = true;
-			} catch (e) {
-				this.logger?.debug(`Opcode validation failed for transaction ${bundle3._hash} during simpleValidationCheck`);
-				this.logger?.debug(`  - error: ${e.message}`);
-			}
-			const validationPassed = transactionCheckPassed && chainIdPassed && expPassed && typeCheckPassed && opcodeCheckPassed;
-			const validatedTransaction = validationPassed ? transaction : void 0;
-			if (!validationPassed) {
-				this.logger?.debug(`Pruning block bundle ${bundle3._hash} during simpleValidationCheck`);
-				this.logger?.debug(`  - chainId match: ${chainIdPassed}`);
-				this.logger?.debug(`  - exp check: ${expPassed}`);
-				this.logger?.debug(`  - opcode check: ${opcodeCheckPassed}`);
-				this.logger?.debug(`  - typeCheck: ${typeCheckPassed}`);
-				this.logger?.debug(`  - bundle hash: ${bundle3._hash}`);
-			}
-			return [validatedTransaction, bundle3];
-		}));
-	}
 	async syncBlocksFrom(external) {
 		const externalBlocks = await external.pendingBlocks({ limit: this.syncLimit });
 		if (externalBlocks.length === 0) return;
@@ -76803,6 +77215,11 @@ __publicField$25(SimpleMempoolRunner$1, "monikers", [MempoolRunnerMoniker$1]);
 /** Read, write, or mixed capability surface exposed by the provider. */
 __publicField$25(SimpleMempoolRunner$1, "surface", "node");
 SimpleMempoolRunner$1 = __decorateClass$26([creatableProvider$1()], SimpleMempoolRunner$1);
+async function resolveHashCursor$1(archivist, providedCursor) {
+	if (!isHash(providedCursor)) return void 0;
+	const [payload] = await archivist.get([providedCursor]);
+	return isDefined$1(payload) ? payload._sequence : void 0;
+}
 var SimpleMempoolViewerOptionsZod$1 = object$3({
 	demotionThreshold: number$1().default(3),
 	handoutStatsTtlBlocks: number$1().default(1e3),
@@ -76870,11 +77287,7 @@ var SimpleMempoolViewer$1 = class extends AbstractCreatableProvider$1 {
 	}
 	/** Returns the pending blocks result exposed by this provider. */
 	async pendingBlocks({ cursor: providedCursor } = {}) {
-		let cursor;
-		if (isHash(providedCursor)) {
-			const [p] = await this.pendingBlocksArchivist.get([providedCursor]);
-			if (isDefined$1(p)) cursor = p._sequence;
-		}
+		const cursor = await resolveHashCursor$1(this.pendingBlocksArchivist, providedCursor);
 		const filteredBundles = (await this.pendingBlocksArchivist.next({
 			order: "desc",
 			limit: 100,
@@ -76884,11 +77297,8 @@ var SimpleMempoolViewer$1 = class extends AbstractCreatableProvider$1 {
 	}
 	/** Returns the pending transactions result exposed by this provider. */
 	async pendingTransactions({ cursor: providedCursor, limit = 100 } = {}) {
-		let cursor;
-		if (isHash(providedCursor)) {
-			const [p] = await this.pendingTransactionsArchivist.get([providedCursor]);
-			if (isDefined$1(p)) cursor = p._sequence;
-		}
+		await this.windowedBlockViewer.sync?.();
+		const cursor = await resolveHashCursor$1(this.pendingTransactionsArchivist, providedCursor);
 		this.logger?.debug(`Fetching pending transactions from cursor: ${cursor}`);
 		const bundles = await this.pendingTransactionsArchivist.next({
 			order: "asc",
@@ -78055,7 +78465,9 @@ var SimpleWindowedBlockViewer$1 = class extends AbstractCreatableProvider$1 {
 	_blockNumberMap;
 	_blockViewer;
 	_chain = [];
+	_inFlightSync = null;
 	_options;
+	_queuedSync = null;
 	_syncMutex = new Mutex();
 	_timerId = null;
 	_transactionHashMap;
@@ -78163,6 +78575,32 @@ var SimpleWindowedBlockViewer$1 = class extends AbstractCreatableProvider$1 {
 		await super.stopHandler();
 		this.stopPoll();
 	}
+	/**
+	* Synchronizes the in-memory window with the backing block viewer immediately, waiting for any
+	* in-flight sync to complete first. Callers whose correctness depends on seeing the latest
+	* finalized blocks (e.g. mempool inclusion checks) must call this rather than rely on the
+	* background poll, whose interval is far coarser than block finalization.
+	*
+	* Concurrent callers are coalesced: a caller arriving while a sync runs joins one shared
+	* follow-up pass (which starts after the running pass and therefore observes every block
+	* finalized before the caller arrived) instead of enqueuing its own. Without this, N
+	* concurrent callers — the handout path is reachable per producer tick and over RPC — would
+	* execute N sequential backing reads behind the sync mutex.
+	*/
+	async sync() {
+		if (this._inFlightSync === null) {
+			const run = this.runSync().finally(() => {
+				if (this._inFlightSync === run) this._inFlightSync = null;
+			});
+			this._inFlightSync = run;
+			return await run;
+		}
+		this._queuedSync ??= this._inFlightSync.then(() => {
+			this._queuedSync = null;
+			return this.sync();
+		});
+		return await this._queuedSync;
+	}
 	addBlock(block) {
 		this._chain.push(block);
 		this._blockHashMap.set(block[0]._hash, block);
@@ -78176,18 +78614,8 @@ var SimpleWindowedBlockViewer$1 = class extends AbstractCreatableProvider$1 {
 			for (const tx of transactionsFromHydratedBlock$1(removedBlock)) this._transactionHashMap.delete(tx._hash);
 		}
 	}
-	startPoll() {
-		this._timerId = setInterval(() => {
-			this.sync();
-		}, this.syncInterval);
-	}
-	stopPoll() {
-		if (this._timerId) clearInterval(this._timerId);
-		this._timerId = null;
-	}
-	async sync() {
-		if (this._syncMutex.isLocked()) return;
-		return await this._syncMutex.runExclusive(async () => {
+	async runSync() {
+		await this._syncMutex.runExclusive(async () => {
 			try {
 				let cursor = await this._blockViewer.currentBlock();
 				const previousHead = this._chain.length > 0 ? await this.currentBlockHash() : null;
@@ -78203,6 +78631,19 @@ var SimpleWindowedBlockViewer$1 = class extends AbstractCreatableProvider$1 {
 			}
 		});
 	}
+	startPoll() {
+		this._timerId = setInterval(() => {
+			this.syncIfIdle();
+		}, this.syncInterval);
+	}
+	stopPoll() {
+		if (this._timerId) clearInterval(this._timerId);
+		this._timerId = null;
+	}
+	async syncIfIdle() {
+		if (this._syncMutex.isLocked()) return;
+		await this.sync();
+	}
 };
 /** Connection kinds supported by this provider. */
 __publicField$25(SimpleWindowedBlockViewer$1, "connectionTypes", [
@@ -81798,7 +82239,7 @@ function getOriginalId$1(rawRequest) {
 	return [void 0, false];
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@xyo-network+xl1-sdk@5.2.3_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@4.4.3__@o_f803ff54f950c092c4a357d77886b418/node_modules/@xyo-network/xl1-sdk/dist/neutral/rpc.mjs
+//#region ../../node_modules/.pnpm/@xyo-network+xl1-sdk@5.3.1_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@4.4.3__@o_3a01f3229f2daa942444e08696345b23/node_modules/@xyo-network/xl1-sdk/dist/neutral/rpc.mjs
 var __defProp$26 = Object.defineProperty;
 var __getOwnPropDesc$25 = Object.getOwnPropertyDescriptor;
 var __defNormalProp$24 = (obj, key, value) => key in obj ? __defProp$26(obj, key, {
@@ -84340,7 +84781,7 @@ var createRpcDispatchMiddleware = (schemas, handlers, options) => async ({ reque
 	}
 };
 //#endregion
-//#region ../../node_modules/.pnpm/@xyo-network+xl1-sdk@5.2.3_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@4.4.3__@o_f803ff54f950c092c4a357d77886b418/node_modules/@xyo-network/xl1-sdk/dist/neutral/rest-block-viewer.mjs
+//#region ../../node_modules/.pnpm/@xyo-network+xl1-sdk@5.3.1_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@4.4.3__@o_3a01f3229f2daa942444e08696345b23/node_modules/@xyo-network/xl1-sdk/dist/neutral/rest-block-viewer.mjs
 var __defProp$25 = Object.defineProperty;
 var __getOwnPropDesc$24 = Object.getOwnPropertyDescriptor;
 var __defNormalProp$23 = (obj, key, value) => key in obj ? __defProp$25(obj, key, {
@@ -105003,7 +105444,7 @@ var StakedXyoChainV2__factory = class extends ContractFactory {
 	}
 };
 //#endregion
-//#region ../../node_modules/.pnpm/@xyo-network+xl1-sdk@5.2.3_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@4.4.3__@o_f803ff54f950c092c4a357d77886b418/node_modules/@xyo-network/xl1-sdk/dist/neutral/providers.mjs
+//#region ../../node_modules/.pnpm/@xyo-network+xl1-sdk@5.3.1_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@4.4.3__@o_3a01f3229f2daa942444e08696345b23/node_modules/@xyo-network/xl1-sdk/dist/neutral/providers.mjs
 var __defProp$23 = Object.defineProperty;
 var __getOwnPropDesc$23 = Object.getOwnPropertyDescriptor;
 var __defNormalProp$22 = (obj, key, value) => key in obj ? __defProp$23(obj, key, {
@@ -105957,6 +106398,179 @@ __publicField$22(EvmStakeViewer$1, "monikers", [StakeViewerMoniker$1]);
 /** Read, write, or mixed capability surface exposed by the provider. */
 __publicField$22(EvmStakeViewer$1, "surface", "node");
 EvmStakeViewer$1 = __decorateClass$23([creatableProvider$1()], EvmStakeViewer$1);
+var DEFAULT_HEAD_POLL_INTERVAL_MS$2 = 5e3;
+var RestNetworkStakeStepRewardsByPositionViewerOptionsZod$1 = object$3({
+	headPollIntervalMs: number$1().min(5e3).default(DEFAULT_HEAD_POLL_INTERVAL_MS$2),
+	policyId: NetworkStakeRewardsPolicyIdZod.default(NETWORK_STAKE_REWARDS_UNMULTIPLIED_POLICY)
+});
+var RestNetworkStakeStepRewardsByPositionViewer$1 = class extends AbstractCreatableProvider$1 {
+	moniker = RestNetworkStakeStepRewardsByPositionViewer$1.defaultMoniker;
+	currentHead;
+	headPollIntervalMs = DEFAULT_HEAD_POLL_INTERVAL_MS$2;
+	headPromise;
+	lastSuccessfulHeadAt;
+	manifestPromise;
+	policyId = NETWORK_STAKE_REWARDS_UNMULTIPLIED_POLICY;
+	snapshotPromises = /* @__PURE__ */ new Map();
+	stepPromises = /* @__PURE__ */ new Map();
+	get baseUrl() {
+		const connection = RestNetworkStakeStepRewardsByPositionViewer$1.requireBoundConnection(this.config);
+		const config = connection.config;
+		if (config.type !== "rest") throw new Error(`Connection "${connection.name}" must be a rest connection`);
+		return assertEx$1(config.baseUrl, () => `Connection "${connection.name}" requires a rest baseUrl`);
+	}
+	get fetchFn() {
+		return this.context.fetchFn ?? fetch.bind(globalThis);
+	}
+	/** Returns the policy bonus. The unmultiplied-v1 index has no multipliers, so bonus is zero. */
+	async bonus(options = {}) {
+		const total = await this.total(options);
+		return Object.fromEntries(Object.keys(total).map((key) => [Number(key), asAttoXL1$1(0n)]));
+	}
+	/** Claimed rewards are not part of the earned-reward index. */
+	claimed(_options) {
+		throw new Error("Method [claimed] not implemented.");
+	}
+	/** Creates the provider instance after validating its REST binding and options. */
+	async createHandler() {
+		await super.createHandler();
+		RestNetworkStakeStepRewardsByPositionViewer$1.requireBoundConnection(this.config);
+		const options = RestNetworkStakeStepRewardsByPositionViewerOptionsZod$1.parse(this.config.options);
+		this.headPollIntervalMs = options.headPollIntervalMs;
+		this.policyId = options.policyId;
+	}
+	/** Base-v1 total and earned rewards are identical. */
+	async earned(options = {}) {
+		return await this.total(options);
+	}
+	/** Returns rewards by requested position from the durable index. */
+	async total({ range, positions } = {}) {
+		if (!isArray(positions)) return {};
+		const head = await this.getHead();
+		const resolvedRange = asXL1BlockRange$1(range ?? [0, head.processedThroughBlock], { name: "RestNetworkStakeStepRewardsByPositionViewer" });
+		const result = {};
+		for (const position of positions) result[position] = (await this.totalForPosition(position, resolvedRange))[0];
+		return result;
+	}
+	/** Returns one position's cumulative reward and the range's emitted reward pool. */
+	async totalForPosition(position, range) {
+		const head = await this.getHead();
+		this.assertPublishedRange(range, head);
+		if (head.positionCount === 0) return [asAttoXL1$1(0n), asAttoXL1$1(0n)];
+		this.assertPosition(position, head);
+		if (range[0] === 0 && range[1] >= head.processedThroughBlock) {
+			const snapshot = await this.getSnapshot(head);
+			return [asAttoXL1$1(BigInt(snapshot.positionRewards[String(position)] ?? "0")), asAttoXL1$1(BigInt(snapshot.totalReward))];
+		}
+		const steps = await this.stepsForRange(range, head);
+		return [asAttoXL1$1(steps.reduce((sum, step) => sum + BigInt(step.positionRewards[String(position)] ?? "0"), 0n)), asAttoXL1$1(steps.reduce((sum, step) => sum + BigInt(step.totalReward), 0n))];
+	}
+	/** Returns the emitted reward pool for one indexed step. */
+	async totalForStep(step) {
+		const head = await this.getHead();
+		this.assertPublishedStep(step, head);
+		return asAttoXL1$1(BigInt((await this.getStep(step)).totalReward));
+	}
+	/** Returns one position's allocation and emitted pool for one indexed step. */
+	async totalForStepForPosition(step, position) {
+		const head = await this.getHead();
+		this.assertPosition(position, head);
+		this.assertPublishedStep(step, head);
+		const record = await this.getStep(step);
+		return [asAttoXL1$1(BigInt(record.positionRewards[String(position)] ?? "0")), asAttoXL1$1(BigInt(record.totalReward))];
+	}
+	/** Unclaimed rewards require redemption state and are not part of this index. */
+	unclaimed(_options) {
+		throw new Error("Method [unclaimed] not implemented.");
+	}
+	assertPosition(position, head) {
+		assertEx$1(Number.isSafeInteger(position) && position >= 0 && position < head.positionCount, () => `Position ${position} is outside rewards index positionCount ${head.positionCount}`);
+	}
+	assertPublishedRange(range, head) {
+		assertEx$1(range[1] <= head.processedThroughBlock, () => `Reward range ends at ${range[1]}, beyond index watermark ${head.processedThroughBlock}`);
+	}
+	assertPublishedStep(step, head) {
+		assertEx$1(step.block <= head.processedThroughBlock, () => `Reward step ${step.block}|${step.step} is beyond index watermark ${head.processedThroughBlock}`);
+	}
+	async fetchJson(path) {
+		const response = await this.fetchFn(`${this.baseUrl.replace(/\/$/, "")}/${path}`);
+		if (!response.ok) throw new Error(`Network stake rewards index request failed [${response.status}] for ${path}`);
+		return await response.json();
+	}
+	async getHead() {
+		const now = Date.now();
+		const elapsed = this.lastSuccessfulHeadAt === void 0 ? void 0 : now - this.lastSuccessfulHeadAt;
+		if (this.currentHead !== void 0 && elapsed !== void 0 && elapsed >= 0 && elapsed < this.headPollIntervalMs) return this.currentHead;
+		this.headPromise ??= this.syncHead().finally(() => {
+			this.headPromise = void 0;
+		});
+		return await this.headPromise;
+	}
+	async getManifest() {
+		this.manifestPromise ??= this.fetchJson(networkStakeRewardsIndexManifestPath(this.policyId)).then((value) => asNetworkStakeRewardsIndexManifest(value, true)).catch((error) => {
+			this.manifestPromise = void 0;
+			throw error;
+		});
+		return await this.manifestPromise;
+	}
+	async getSnapshot(head) {
+		const { snapshotHash } = head;
+		let promise = this.snapshotPromises.get(snapshotHash);
+		if (promise === void 0) {
+			const path = networkStakeRewardsIndexSnapshotPath(this.policyId, snapshotHash);
+			promise = this.fetchJson(path).then(async (value) => {
+				const snapshot = asNetworkStakeRewardsIndexSnapshot(value, true);
+				assertEx$1(await PayloadBuilder$1.hash(snapshot) === snapshotHash, () => `Rewards snapshot hash mismatch: ${path}`);
+				return snapshot;
+			});
+			this.snapshotPromises.set(snapshotHash, promise);
+		}
+		try {
+			const snapshot = await promise;
+			assertEx$1(snapshot.policyId === this.policyId, () => "Rewards snapshot policy mismatch");
+			assertEx$1(snapshot.stepCount === head.stepCount, () => "Rewards snapshot step count mismatch");
+			return snapshot;
+		} catch (error) {
+			this.snapshotPromises.delete(snapshotHash);
+			throw error;
+		}
+	}
+	async getStep(step) {
+		const path = networkStakeRewardsIndexStepPath(this.policyId, step);
+		let promise = this.stepPromises.get(path);
+		if (promise === void 0) {
+			promise = this.fetchJson(path).then((value) => asNetworkStakeRewardsIndexStep(value, true));
+			this.stepPromises.set(path, promise);
+		}
+		try {
+			const record = await promise;
+			assertEx$1(record.policyId === this.policyId, () => "Rewards step policy mismatch");
+			assertEx$1(record.step.block === step.block && record.step.step === step.step, () => "Rewards step identity mismatch");
+			return record;
+		} catch (error) {
+			this.stepPromises.delete(path);
+			throw error;
+		}
+	}
+	async stepsForRange(range, head) {
+		const steps = blockRangeSteps(range, (await this.getManifest()).stepLevels).filter((step) => step.block <= head.processedThroughBlock);
+		return await Promise.all(steps.map(async (step) => await this.getStep(step)));
+	}
+	async syncHead() {
+		assertEx$1((await this.getManifest()).policyId === this.policyId, () => "Rewards manifest policy mismatch");
+		const head = asNetworkStakeRewardsIndexHead(await this.fetchJson(networkStakeRewardsIndexHeadPath(this.policyId)), true);
+		assertEx$1(head.policyId === this.policyId, () => "Rewards head policy mismatch");
+		this.currentHead = head;
+		this.lastSuccessfulHeadAt = Date.now();
+		return head;
+	}
+};
+__publicField$22(RestNetworkStakeStepRewardsByPositionViewer$1, "connectionTypes", ["rest"]);
+__publicField$22(RestNetworkStakeStepRewardsByPositionViewer$1, "defaultMoniker", NetworkStakeStepRewardsByPositionViewerMoniker$1);
+__publicField$22(RestNetworkStakeStepRewardsByPositionViewer$1, "dependencies", []);
+__publicField$22(RestNetworkStakeStepRewardsByPositionViewer$1, "monikers", [NetworkStakeStepRewardsByPositionViewerMoniker$1]);
+__publicField$22(RestNetworkStakeStepRewardsByPositionViewer$1, "surface", "node");
+RestNetworkStakeStepRewardsByPositionViewer$1 = __decorateClass$23([creatableProvider$1()], RestNetworkStakeStepRewardsByPositionViewer$1);
 var SimpleDeadLetterQueueRunner$1 = class extends AbstractCreatableProvider$1 {
 	/** Moniker implemented by this provider instance. */
 	moniker = SimpleDeadLetterQueueRunner$1.defaultMoniker;
@@ -107353,181 +107967,8 @@ __publicField$22(RestChainParamsViewer$1, "monikers", [ChainParamsViewerMoniker]
 /** Read, write, or mixed capability surface exposed by the provider. */
 __publicField$22(RestChainParamsViewer$1, "surface", "node");
 RestChainParamsViewer$1 = __decorateClass$23([creatableProvider$1()], RestChainParamsViewer$1);
-var DEFAULT_HEAD_POLL_INTERVAL_MS2$1 = 5e3;
-var RestNetworkStakeStepRewardsByPositionViewerOptionsZod$1 = object$3({
-	headPollIntervalMs: number$1().min(5e3).default(DEFAULT_HEAD_POLL_INTERVAL_MS2$1),
-	policyId: NetworkStakeRewardsPolicyIdZod.default(NETWORK_STAKE_REWARDS_UNMULTIPLIED_POLICY)
-});
-var RestNetworkStakeStepRewardsByPositionViewer$1 = class extends AbstractCreatableProvider$1 {
-	moniker = RestNetworkStakeStepRewardsByPositionViewer$1.defaultMoniker;
-	currentHead;
-	headPollIntervalMs = DEFAULT_HEAD_POLL_INTERVAL_MS2$1;
-	headPromise;
-	lastSuccessfulHeadAt;
-	manifestPromise;
-	policyId = NETWORK_STAKE_REWARDS_UNMULTIPLIED_POLICY;
-	snapshotPromises = /* @__PURE__ */ new Map();
-	stepPromises = /* @__PURE__ */ new Map();
-	get baseUrl() {
-		const connection = RestNetworkStakeStepRewardsByPositionViewer$1.requireBoundConnection(this.config);
-		const config = connection.config;
-		if (config.type !== "rest") throw new Error(`Connection "${connection.name}" must be a rest connection`);
-		return assertEx$1(config.baseUrl, () => `Connection "${connection.name}" requires a rest baseUrl`);
-	}
-	get fetchFn() {
-		return this.context.fetchFn ?? fetch.bind(globalThis);
-	}
-	/** Returns the policy bonus. The unmultiplied-v1 index has no multipliers, so bonus is zero. */
-	async bonus(options = {}) {
-		const total = await this.total(options);
-		return Object.fromEntries(Object.keys(total).map((key) => [Number(key), asAttoXL1$1(0n)]));
-	}
-	/** Claimed rewards are not part of the earned-reward index. */
-	claimed(_options) {
-		throw new Error("Method [claimed] not implemented.");
-	}
-	/** Creates the provider instance after validating its REST binding and options. */
-	async createHandler() {
-		await super.createHandler();
-		RestNetworkStakeStepRewardsByPositionViewer$1.requireBoundConnection(this.config);
-		const options = RestNetworkStakeStepRewardsByPositionViewerOptionsZod$1.parse(this.config.options);
-		this.headPollIntervalMs = options.headPollIntervalMs;
-		this.policyId = options.policyId;
-	}
-	/** Base-v1 total and earned rewards are identical. */
-	async earned(options = {}) {
-		return await this.total(options);
-	}
-	/** Returns rewards by requested position from the durable index. */
-	async total({ range, positions } = {}) {
-		if (!isArray(positions)) return {};
-		const head = await this.getHead();
-		const resolvedRange = asXL1BlockRange$1(range ?? [0, head.processedThroughBlock], { name: "RestNetworkStakeStepRewardsByPositionViewer" });
-		const result = {};
-		for (const position of positions) result[position] = (await this.totalForPosition(position, resolvedRange))[0];
-		return result;
-	}
-	/** Returns one position's cumulative reward and the range's emitted reward pool. */
-	async totalForPosition(position, range) {
-		const head = await this.getHead();
-		this.assertPublishedRange(range, head);
-		if (head.positionCount === 0) return [asAttoXL1$1(0n), asAttoXL1$1(0n)];
-		this.assertPosition(position, head);
-		if (range[0] === 0 && range[1] >= head.processedThroughBlock) {
-			const snapshot = await this.getSnapshot(head);
-			return [asAttoXL1$1(BigInt(snapshot.positionRewards[String(position)] ?? "0")), asAttoXL1$1(BigInt(snapshot.totalReward))];
-		}
-		const steps = await this.stepsForRange(range, head);
-		return [asAttoXL1$1(steps.reduce((sum, step) => sum + BigInt(step.positionRewards[String(position)] ?? "0"), 0n)), asAttoXL1$1(steps.reduce((sum, step) => sum + BigInt(step.totalReward), 0n))];
-	}
-	/** Returns the emitted reward pool for one indexed step. */
-	async totalForStep(step) {
-		const head = await this.getHead();
-		this.assertPublishedStep(step, head);
-		return asAttoXL1$1(BigInt((await this.getStep(step)).totalReward));
-	}
-	/** Returns one position's allocation and emitted pool for one indexed step. */
-	async totalForStepForPosition(step, position) {
-		const head = await this.getHead();
-		this.assertPosition(position, head);
-		this.assertPublishedStep(step, head);
-		const record = await this.getStep(step);
-		return [asAttoXL1$1(BigInt(record.positionRewards[String(position)] ?? "0")), asAttoXL1$1(BigInt(record.totalReward))];
-	}
-	/** Unclaimed rewards require redemption state and are not part of this index. */
-	unclaimed(_options) {
-		throw new Error("Method [unclaimed] not implemented.");
-	}
-	assertPosition(position, head) {
-		assertEx$1(Number.isSafeInteger(position) && position >= 0 && position < head.positionCount, () => `Position ${position} is outside rewards index positionCount ${head.positionCount}`);
-	}
-	assertPublishedRange(range, head) {
-		assertEx$1(range[1] <= head.processedThroughBlock, () => `Reward range ends at ${range[1]}, beyond index watermark ${head.processedThroughBlock}`);
-	}
-	assertPublishedStep(step, head) {
-		assertEx$1(step.block <= head.processedThroughBlock, () => `Reward step ${step.block}|${step.step} is beyond index watermark ${head.processedThroughBlock}`);
-	}
-	async fetchJson(path) {
-		const response = await this.fetchFn(`${this.baseUrl.replace(/\/$/, "")}/${path}`);
-		if (!response.ok) throw new Error(`Network stake rewards index request failed [${response.status}] for ${path}`);
-		return await response.json();
-	}
-	async getHead() {
-		const now = Date.now();
-		const elapsed = this.lastSuccessfulHeadAt === void 0 ? void 0 : now - this.lastSuccessfulHeadAt;
-		if (this.currentHead !== void 0 && elapsed !== void 0 && elapsed >= 0 && elapsed < this.headPollIntervalMs) return this.currentHead;
-		this.headPromise ??= this.syncHead().finally(() => {
-			this.headPromise = void 0;
-		});
-		return await this.headPromise;
-	}
-	async getManifest() {
-		this.manifestPromise ??= this.fetchJson(networkStakeRewardsIndexManifestPath(this.policyId)).then((value) => asNetworkStakeRewardsIndexManifest(value, true)).catch((error) => {
-			this.manifestPromise = void 0;
-			throw error;
-		});
-		return await this.manifestPromise;
-	}
-	async getSnapshot(head) {
-		const { snapshotHash } = head;
-		let promise = this.snapshotPromises.get(snapshotHash);
-		if (promise === void 0) {
-			const path = networkStakeRewardsIndexSnapshotPath(this.policyId, snapshotHash);
-			promise = this.fetchJson(path).then(async (value) => {
-				const snapshot = asNetworkStakeRewardsIndexSnapshot(value, true);
-				assertEx$1(await PayloadBuilder$1.hash(snapshot) === snapshotHash, () => `Rewards snapshot hash mismatch: ${path}`);
-				return snapshot;
-			});
-			this.snapshotPromises.set(snapshotHash, promise);
-		}
-		try {
-			const snapshot = await promise;
-			assertEx$1(snapshot.policyId === this.policyId, () => "Rewards snapshot policy mismatch");
-			assertEx$1(snapshot.stepCount === head.stepCount, () => "Rewards snapshot step count mismatch");
-			return snapshot;
-		} catch (error) {
-			this.snapshotPromises.delete(snapshotHash);
-			throw error;
-		}
-	}
-	async getStep(step) {
-		const path = networkStakeRewardsIndexStepPath(this.policyId, step);
-		let promise = this.stepPromises.get(path);
-		if (promise === void 0) {
-			promise = this.fetchJson(path).then((value) => asNetworkStakeRewardsIndexStep(value, true));
-			this.stepPromises.set(path, promise);
-		}
-		try {
-			const record = await promise;
-			assertEx$1(record.policyId === this.policyId, () => "Rewards step policy mismatch");
-			assertEx$1(record.step.block === step.block && record.step.step === step.step, () => "Rewards step identity mismatch");
-			return record;
-		} catch (error) {
-			this.stepPromises.delete(path);
-			throw error;
-		}
-	}
-	async stepsForRange(range, head) {
-		const steps = blockRangeSteps(range, (await this.getManifest()).stepLevels).filter((step) => step.block <= head.processedThroughBlock);
-		return await Promise.all(steps.map(async (step) => await this.getStep(step)));
-	}
-	async syncHead() {
-		assertEx$1((await this.getManifest()).policyId === this.policyId, () => "Rewards manifest policy mismatch");
-		const head = asNetworkStakeRewardsIndexHead(await this.fetchJson(networkStakeRewardsIndexHeadPath(this.policyId)), true);
-		assertEx$1(head.policyId === this.policyId, () => "Rewards head policy mismatch");
-		this.currentHead = head;
-		this.lastSuccessfulHeadAt = Date.now();
-		return head;
-	}
-};
-__publicField$22(RestNetworkStakeStepRewardsByPositionViewer$1, "connectionTypes", ["rest"]);
-__publicField$22(RestNetworkStakeStepRewardsByPositionViewer$1, "defaultMoniker", NetworkStakeStepRewardsByPositionViewerMoniker$1);
-__publicField$22(RestNetworkStakeStepRewardsByPositionViewer$1, "dependencies", []);
-__publicField$22(RestNetworkStakeStepRewardsByPositionViewer$1, "monikers", [NetworkStakeStepRewardsByPositionViewerMoniker$1]);
-__publicField$22(RestNetworkStakeStepRewardsByPositionViewer$1, "surface", "node");
-RestNetworkStakeStepRewardsByPositionViewer$1 = __decorateClass$23([creatableProvider$1()], RestNetworkStakeStepRewardsByPositionViewer$1);
 //#endregion
-//#region ../../node_modules/.pnpm/@xyo-network+xl1-sdk@5.2.3_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@4.4.3__@o_f803ff54f950c092c4a357d77886b418/node_modules/@xyo-network/xl1-sdk/dist/neutral/gateway.mjs
+//#region ../../node_modules/.pnpm/@xyo-network+xl1-sdk@5.3.1_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@4.4.3__@o_3a01f3229f2daa942444e08696345b23/node_modules/@xyo-network/xl1-sdk/dist/neutral/gateway.mjs
 async function witnessPreviousStep(gateway, options) {
 	const { addToChain = false, step = 2, transactionOptions, witness: witnessOption } = options ?? {};
 	const size = stepSize$1(step);
@@ -107554,7 +107995,7 @@ async function witnessPreviousStep(gateway, options) {
 	return { witness };
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@xyo-network+xl1-sdk@5.2.3_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@4.4.3__@o_f803ff54f950c092c4a357d77886b418/node_modules/@xyo-network/xl1-sdk/dist/neutral/wrappers.mjs
+//#region ../../node_modules/.pnpm/@xyo-network+xl1-sdk@5.3.1_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@4.4.3__@o_3a01f3229f2daa942444e08696345b23/node_modules/@xyo-network/xl1-sdk/dist/neutral/wrappers.mjs
 function parseHexOrBigInt(value) {
 	return AttoXL1$1(typeof value === "bigint" ? value : hexToBigInt(value));
 }
@@ -109102,26 +109543,23 @@ function createInstalledActorRegistry() {
 	return createInstalledActorRegistry$1();
 }
 var DEFAULT_LMDB_CONNECTION$1 = "local-store";
-var DEFAULT_MONGO_CONNECTION$1 = "chain-mongo";
-var DEFAULT_MEMORY_CONNECTION$1 = "memory";
-function isBindableStoreType$1(type) {
-	return type === "lmdb" || type === "memory" || type === "mongo";
+var DEFAULT_MONGO_CONNECTION = "chain-mongo";
+function isStoreConnectionType(type) {
+	return type === "lmdb" || type === "mongo";
 }
-function connectionProfiles$1(config) {
-	const merged = { ...config.connections };
-	if (!Object.hasOwn(merged, DEFAULT_MEMORY_CONNECTION$1)) merged[DEFAULT_MEMORY_CONNECTION$1] = { type: "memory" };
-	return merged;
+function isBindableStoreType(type) {
+	return isStoreConnectionType(type) || type === "memory";
 }
-function storeConnectionName$1(profiles) {
-	const localStore = profiles[DEFAULT_LMDB_CONNECTION$1];
-	if (localStore !== void 0 && isBindableStoreType$1(localStore.type)) return DEFAULT_LMDB_CONNECTION$1;
-	if (profiles[DEFAULT_MONGO_CONNECTION$1]?.type === "mongo") return DEFAULT_MONGO_CONNECTION$1;
-	for (const [name, connection] of Object.entries(profiles)) if (isBindableStoreType$1(connection.type)) return name;
+function localChainStoreConnectionName(connections) {
+	const localStore = connections[DEFAULT_LMDB_CONNECTION$1];
+	if (localStore !== void 0 && isBindableStoreType(localStore.type)) return DEFAULT_LMDB_CONNECTION$1;
+	if (connections["chain-mongo"]?.type === "mongo") return DEFAULT_MONGO_CONNECTION;
+	for (const [name, connection] of Object.entries(connections)) if (connection !== void 0 && isStoreConnectionType(connection.type)) return name;
 }
 function resolveMongoConnection(config) {
-	const profiles = connectionProfiles$1(config);
-	const name = storeConnectionName$1(profiles);
-	const connection = name === void 0 ? void 0 : profiles[name];
+	const connections = config.connections ?? {};
+	const name = localChainStoreConnectionName(connections);
+	const connection = name === void 0 ? void 0 : connections[name];
 	if (connection?.type !== "mongo") return void 0;
 	return connection;
 }
@@ -115918,7 +116356,7 @@ __publicField$19(MemoryArchivist, "labels", {
 });
 MemoryArchivist = __decorateClass$19([creatableModule()], MemoryArchivist);
 //#endregion
-//#region ../../node_modules/.pnpm/@xyo-network+xl1-protocol@5.2.3_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@4.4._d1eafcd2dfc50c437c3d55abb854ddad/node_modules/@xyo-network/xl1-protocol/dist/neutral/protocol-model.mjs
+//#region ../../node_modules/.pnpm/@xyo-network+xl1-protocol@5.3.1_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@4.4._8a6486617e91c015a37921faa069ed7b/node_modules/@xyo-network/xl1-protocol/dist/neutral/protocol-model.mjs
 var ExchangeOutcomeSchema = asSchema("network.xyo.exchange.outcome", true);
 var isExchangeOutcome = isPayloadOfZodType(/* @__PURE__ */ object$5({
 	/** Hash of the ExchangeTerms payload this outcome settles */
@@ -116743,6 +117181,20 @@ var FinalizationRunnerMoniker = "FinalizationRunner";
 var MempoolRunnerMoniker = "MempoolRunner";
 var DEFAULT_MAX_EXP_AHEAD = 1e3;
 var SystemStatusViewerMoniker = "SystemStatusViewer";
+var FinalizedBlockStreamMoniker = "FinalizedBlockStream";
+var FinalizedBlockStreamDesyncError = class extends Error {
+	/** The block whose `previous` did not match, when it could be fetched. */
+	block;
+	/** The hash the walk expected the next block's `previous` to be. */
+	expectedPrevious;
+	constructor(expectedPrevious, block) {
+		const found = block ? `found ${block[0].previous} at block ${block[0].block}` : "no block found";
+		super(`FinalizedBlockStream desynced: expected previous ${expectedPrevious}, ${found}`);
+		this.name = "FinalizedBlockStreamDesyncError";
+		this.expectedPrevious = expectedPrevious;
+		this.block = block;
+	}
+};
 var BlocksStepSummarySchema = asSchema("network.xyo.step.summary.blocks", true);
 var isBlocksStepSummary = isPayloadOfSchemaType(BlocksStepSummarySchema);
 var asBlocksStepSummary = AsObjectFactory.create(isBlocksStepSummary);
@@ -116904,7 +117356,7 @@ new import_ajv.Ajv({
 	strict: true
 });
 //#endregion
-//#region ../../node_modules/.pnpm/@xyo-network+xl1-sdk@5.2.3_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@4.4.3__@o_d668443a8314bbcb6b4d304ca8d635e8/node_modules/@xyo-network/xl1-sdk/dist/neutral/driver-memory.mjs
+//#region ../../node_modules/.pnpm/@xyo-network+xl1-sdk@5.3.1_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@4.4.3__@o_a771cefd6e9eb69efc5a95a989caf2a3/node_modules/@xyo-network/xl1-sdk/dist/neutral/driver-memory.mjs
 var LruCacheMap = class {
 	lruCache;
 	/** Creates an instance with the supplied configuration. */
@@ -116986,7 +117438,7 @@ var MemoryMap = class {
 	}
 };
 //#endregion
-//#region ../../node_modules/.pnpm/@xyo-network+xl1-sdk@5.2.3_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@4.4.3__@o_d668443a8314bbcb6b4d304ca8d635e8/node_modules/@xyo-network/xl1-sdk/dist/node/protocol-sdk.mjs
+//#region ../../node_modules/.pnpm/@xyo-network+xl1-sdk@5.3.1_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@4.4.3__@o_a771cefd6e9eb69efc5a95a989caf2a3/node_modules/@xyo-network/xl1-sdk/dist/node/protocol-sdk.mjs
 var __defProp$18 = Object.defineProperty;
 var __getOwnPropDesc$18 = Object.getOwnPropertyDescriptor;
 var __defNormalProp$18 = (obj, key, value) => key in obj ? __defProp$18(obj, key, {
@@ -117854,21 +118306,47 @@ function blocksToChains(blocks) {
 	}
 	return chains;
 }
-function toValidUncle(_context, finalizedWindowedChain, possibleUncle) {
+function toValidUncle(_context, finalizedWindowedChain, possibleUncle, onReject) {
 	const finalizedWindowStartBlockNumber = finalizedWindowedChain.at(0)?.[0].block ?? -1;
 	const finalizedHead = assertEx$1(finalizedWindowedChain.at(-1), () => "finalizedWindowedChain is empty");
+	const tip = assertEx$1(possibleUncle.at(-1), () => "possibleUncle is empty");
+	const reject = (reason, offendingTransactionHashes) => {
+		onReject?.({
+			blockHash: tip[0]._hash,
+			blockNumber: tip[0].block,
+			offendingTransactionHashes,
+			reason
+		});
+	};
 	const prunedPossibleUncle = possibleUncle.filter((b) => b[0].block > finalizedHead[0].block);
-	if (prunedPossibleUncle.length === 0) return;
-	if (prunedPossibleUncle[0][0].block !== finalizedHead[0].block + 1) return;
-	if (prunedPossibleUncle[0][0].previous !== finalizedHead[0]._hash) return;
+	if (prunedPossibleUncle.length === 0) {
+		reject("behind-finalized-head");
+		return;
+	}
+	if (prunedPossibleUncle[0][0].block !== finalizedHead[0].block + 1) {
+		reject("block-number-mismatch");
+		return;
+	}
+	if (prunedPossibleUncle[0][0].previous !== finalizedHead[0]._hash) {
+		reject("previous-hash-mismatch");
+		return;
+	}
 	const allUncleTransactions = prunedPossibleUncle.flatMap((b) => b[1]).filter(isTransactionBoundWitness);
 	const allFinalizedTransactions = finalizedWindowedChain.flatMap((b) => b[1]).filter(isTransactionBoundWitness);
-	if (allUncleTransactions.some((tx) => tx.nbf < finalizedWindowStartBlockNumber)) return;
-	if (allUncleTransactions.some((tx) => allFinalizedTransactions.some((finalTx) => finalTx._hash === tx._hash))) return;
+	const txsBeforeWindow = allUncleTransactions.filter((tx) => tx.nbf < finalizedWindowStartBlockNumber);
+	if (txsBeforeWindow.length > 0) {
+		reject("tx-before-window", txsBeforeWindow.map((tx) => tx._hash));
+		return;
+	}
+	const txsInWindow = allUncleTransactions.filter((tx) => allFinalizedTransactions.some((finalTx) => finalTx._hash === tx._hash));
+	if (txsInWindow.length > 0) {
+		reject("tx-already-finalized", txsInWindow.map((tx) => tx._hash));
+		return;
+	}
 	return prunedPossibleUncle;
 }
-function findUncles(context, finalizedWindowedChain, blocks) {
-	return blocksToChains(blocks).map((chain) => toValidUncle(context, finalizedWindowedChain, chain)).filter(exists$1);
+function findUncles(context, finalizedWindowedChain, blocks, onReject) {
+	return blocksToChains(blocks).map((chain) => toValidUncle(context, finalizedWindowedChain, chain, onReject)).filter(exists$1);
 }
 var ValidationConfigZod = object$3({
 	signerAuthorizations: array$1(SignerAuthorizationZod).default([]).register(globalRegistry, {
@@ -119366,6 +119844,7 @@ var SimpleBlockValidationViewer = class extends AbstractCreatableProvider {
 			state: true,
 			head: void 0
 		};
+		if (config !== void 0 && value !== true && state !== true) this.logger?.warn("validateBlocks called with a config that selects no validators (neither value nor state is true) — every block will report valid");
 		const blocksWithMeta = await Promise.all(blocks.map((b) => Promise.all([PayloadBuilder.addHashMeta(b[0]), PayloadBuilder.addHashMeta(b[1])])));
 		let head;
 		if (isChainQualifiedHeadConfig(config)) {
@@ -119414,18 +119893,30 @@ var SimpleBlockValidationViewer = class extends AbstractCreatableProvider {
 	}
 	async doValidateState(blocks, chainIdAtBlockNumber) {
 		const windowedUncleChain = await this.updateWindowedChainCache();
-		const uncles = findUncles(this.context, windowedUncleChain, blocks);
+		const rejections = [];
+		const uncles = findUncles(this.context, windowedUncleChain, blocks, (rejection) => rejections.push(rejection));
 		if (uncles.length !== 1) {
-			this.logger?.warn(`Unexpected uncle count during block validation [uncles=${uncles.length}, blocks=${blocks.length}]`);
+			const rejectionSummary = rejections.map((r) => `${r.blockNumber} [${r.blockHash}]: ${r.reason}${(r.offendingTransactionHashes?.length ?? 0) > 0 ? ` (tx ${r.offendingTransactionHashes?.join(", ")})` : ""}`).join("; ");
+			this.logger?.warn(`Unexpected uncle count during block validation [uncles=${uncles.length}, blocks=${blocks.length}]` + (rejectionSummary.length > 0 ? ` \u2014 rejected: ${rejectionSummary}` : ""));
 			this.logger?.debug(JSON.stringify({
 				uncles,
 				blocks: blocks.length
 			}, null, 2));
 			this.logger?.debug(JSON.stringify(windowedUncleChain, null, 2));
-			return blocks.map((block) => [new HydratedBlockValidationError(block[0]._hash, block, "Unexpected uncle count during state validation", {
-				uncles: uncles.length,
-				blocks: blocks.length
-			})]);
+			return blocks.map((block) => {
+				const rejection = rejections.find((r) => r.blockHash === block[0]._hash);
+				const offendingTransactionHashes = rejection?.offendingTransactionHashes ?? [];
+				if (rejection && offendingTransactionHashes.length > 0) return offendingTransactionHashes.map((txHash) => new HydratedBlockValidationError(txHash, block, `Uncle rejected during state validation: ${rejection.reason}`, {
+					blockHash: rejection.blockHash,
+					hash: txHash,
+					reason: rejection.reason
+				}));
+				return [new HydratedBlockValidationError(block[0]._hash, block, `Unexpected uncle count during state validation${rejection ? `: ${rejection.reason}` : ""}`, {
+					reason: rejection?.reason,
+					uncles: uncles.length,
+					blocks: blocks.length
+				})];
+			});
 		}
 		const validateState = assertEx$1(this.validators.blockStateValidator, () => "No block state validator registered");
 		return await Promise.all(uncles[0].map(async (block) => {
@@ -120262,6 +120753,303 @@ __publicField$18(SimpleFinalizationViewer, "monikers", [FinalizationViewerMonike
 /** Read, write, or mixed capability surface exposed by the provider. */
 __publicField$18(SimpleFinalizationViewer, "surface", "node");
 SimpleFinalizationViewer = __decorateClass$18([creatableProvider()], SimpleFinalizationViewer);
+var MIN_POLL_INTERVAL_MS = 5e3;
+var DEFAULT_POLL_INTERVAL_MS = 1e4;
+var DEFAULT_FETCH_WINDOW = StepSizes[2];
+var MAX_FETCH_WINDOW = StepSizes[3];
+var SimpleFinalizedBlockStreamOptionsZod = object$3({
+	/**
+	* Hot-surface resume checkpoint: emit blocks strictly after this hash, as a
+	* verified splice (the first emission's `previous` must equal it — mismatch
+	* emits `desynced` at startup rather than delivering a diverged chain).
+	* Omitted, the stream starts at the current head, delivered as the first
+	* `nextBlock`.
+	*/
+	after: optional$1(HashZod),
+	/**
+	* Upper bound on blocks fetched per `blocksByNumber` window during a walk.
+	* The window adapts to the lag (never fetching past the head) and grows up to
+	* this cap on deep replays, letting REST-backed viewers tile each window from
+	* step rollup files. Capped at the largest served rollup (`StepSizes[3]`);
+	* raise toward it for indexer-style deep replays, lower it to bound memory.
+	*/
+	fetchWindow: number$1().int().positive().max(MAX_FETCH_WINDOW).default(DEFAULT_FETCH_WINDOW),
+	/**
+	* Hot-surface catch-up bound: when the head is further ahead than this, a
+	* `gap` is announced and delivery resumes `maxCatchUp` blocks behind head.
+	* The cold `blocks()` surface ignores this — it never gaps.
+	*/
+	maxCatchUp: number$1().int().positive().default(StepSizes[1]),
+	/** Head poll cadence shared by the hot surface and all `blocks()` iterations. */
+	pollIntervalMs: number$1().min(MIN_POLL_INTERVAL_MS).default(DEFAULT_POLL_INTERVAL_MS)
+});
+function cursorFromBlock(block) {
+	return {
+		block: block[0].block,
+		hash: block[0]._hash
+	};
+}
+var SimpleFinalizedBlockStream = class extends AbstractCreatableProvider {
+	/** Moniker implemented by this provider instance. */
+	moniker = FinalizedBlockStreamMoniker;
+	_blockViewer;
+	_cursor;
+	_finalizationViewer;
+	_head;
+	_headWaiters = [];
+	_hotLoop;
+	_isLive = false;
+	_options;
+	_pollInProgress = false;
+	_pollTimer = null;
+	_stopping = false;
+	_terminal = false;
+	/** Last position delivered on the hot surface, or `undefined` before the first. */
+	get cursor() {
+		return this._cursor;
+	}
+	/** True once the hot surface has caught up to the live head. */
+	get isLive() {
+		return this._isLive;
+	}
+	get options() {
+		this._options ??= SimpleFinalizedBlockStreamOptionsZod.parse(this.config.options);
+		return this._options;
+	}
+	/** Validates the provider options at create time. */
+	static async paramsHandler(params = {}) {
+		const handled = await super.paramsHandler(params);
+		SimpleFinalizedBlockStreamOptionsZod.parse(handled.context.config.options);
+		return handled;
+	}
+	/**
+	* Cold, per-caller iteration: replay from `after`, then follow the head.
+	* Gapless by construction — the caller paces the walk. Throws
+	* `FinalizedBlockStreamDesyncError` on any continuity failure, including a
+	* failed resume splice; other (transient) fetch errors also throw, and the
+	* caller resumes from its own checkpoint.
+	*/
+	async *blocks(options) {
+		let cursor;
+		if (isDefined$1(options?.after)) cursor = await this.resolveCheckpoint(options.after);
+		else {
+			const head = await this.currentHead();
+			yield {
+				block: head,
+				head: head[0].block
+			};
+			cursor = cursorFromBlock(head);
+		}
+		while (!this._stopping) {
+			const headNumber = (await this.currentHead())[0].block;
+			if (cursor.block >= headNumber) {
+				await this.waitForHeadAdvance();
+				continue;
+			}
+			for (const block of await this.nextBlocks(cursor, headNumber)) {
+				cursor = this.advanceCursor(cursor, block);
+				yield {
+					block,
+					head: headNumber
+				};
+				if (this._stopping) return;
+			}
+		}
+	}
+	/** Creates the provider instance after its dependencies and configuration have resolved. */
+	async createHandler() {
+		await super.createHandler();
+		const injected = this.params.viewers;
+		this._blockViewer = injected?.blocks ?? assertEx$1(await this.locator.getInstance("BlockViewer"), () => "BlockViewer instance is required");
+		this._finalizationViewer = injected?.finalization ?? assertEx$1(await this.locator.getInstance("FinalizationViewer"), () => "FinalizationViewer instance is required");
+	}
+	/** Starts the head poll and the hot delivery loop. */
+	async startHandler() {
+		await super.startHandler();
+		this._stopping = false;
+		this._terminal = false;
+		await this.pollHead();
+		this._pollTimer = setInterval(() => {
+			this.pollHead();
+		}, this.options.pollIntervalMs);
+		this._hotLoop = this.runHot();
+	}
+	/** Stops the poll, ends the hot loop, and emits the terminal `stopped` event. */
+	async stopHandler() {
+		this._stopping = true;
+		if (this._pollTimer) {
+			clearInterval(this._pollTimer);
+			this._pollTimer = null;
+		}
+		this.releaseHeadWaiters();
+		await this._hotLoop;
+		this._hotLoop = void 0;
+		if (!this._terminal) {
+			this._terminal = true;
+			await this.emitSerial("stopped", { cursor: this._cursor });
+		}
+		this._head = void 0;
+		await super.stopHandler();
+	}
+	/**
+	* Verifies continuity and advances a cursor to the delivered block. A
+	* `previous` mismatch on the expected block number is a data-integrity
+	* fault; a wrong/missing block number is a transient fetch problem.
+	*/
+	advanceCursor(cursor, block) {
+		assertEx$1(block[0].block === cursor.block + 1, () => `FinalizedBlockStream: expected block ${cursor.block + 1}, fetched ${block[0].block}`);
+		if (block[0].previous !== cursor.hash) throw new FinalizedBlockStreamDesyncError(cursor.hash, block);
+		return cursorFromBlock(block);
+	}
+	/** One hot-loop step: bound the lag (announcing a `gap`), deliver the next window, mark live. */
+	async advanceHot() {
+		const head = await this.currentHead();
+		const headNumber = head[0].block;
+		const cursor = assertEx$1(this._cursor);
+		if (cursor.block >= headNumber) {
+			await this.markLive(head);
+			await this.waitForHeadAdvance();
+			return;
+		}
+		if (headNumber - cursor.block > this.options.maxCatchUp) {
+			await this.announceGap(cursor, headNumber);
+			return;
+		}
+		for (const block of await this.nextBlocks(cursor, headNumber)) {
+			if (this._stopping) return;
+			this._cursor = this.advanceCursor(assertEx$1(this._cursor), block);
+			await this.emitSerial("nextBlock", {
+				block,
+				head: headNumber
+			});
+		}
+		if (assertEx$1(this._cursor).block >= headNumber) await this.markLive(head);
+	}
+	/** Announces a hot-surface gap and splices the shared cursor to `maxCatchUp` behind head. */
+	async announceGap(cursor, headNumber) {
+		const resumeNumber = asXL1BlockNumber(headNumber - this.options.maxCatchUp + 1, true);
+		const resumeBlock = assertEx$1(await this._blockViewer.blockByNumber(resumeNumber), () => `FinalizedBlockStream: gap resume block ${resumeNumber} unavailable`);
+		const skipped = [asXL1BlockNumber(cursor.block + 1, true), asXL1BlockNumber(resumeNumber - 1, true)];
+		this._isLive = false;
+		await this.emitSerial("gap", {
+			before: cursor,
+			resumedAt: cursorFromBlock(resumeBlock),
+			skipped
+		});
+		this._cursor = {
+			block: asXL1BlockNumber(resumeNumber - 1, true),
+			hash: assertEx$1(resumeBlock[0].previous, () => "FinalizedBlockStream: gap resume block has no previous")
+		};
+	}
+	/** Returns the last polled head, fetching once when no poll has landed yet. */
+	async currentHead() {
+		if (this._head) return this._head;
+		this._head ??= await this._finalizationViewer.head();
+		return this._head;
+	}
+	/** Initializes the hot cursor: verified splice from `after`, or head-first delivery. */
+	async initHotCursor() {
+		const { after } = this.options;
+		if (isDefined$1(after)) {
+			this._cursor = await this.resolveCheckpoint(after);
+			return;
+		}
+		const head = await this.currentHead();
+		this._cursor = cursorFromBlock(head);
+		await this.emitSerial("nextBlock", {
+			block: head,
+			head: head[0].block
+		});
+		await this.markLive(head);
+	}
+	/** Marks the hot surface live, emitting the transition once. */
+	async markLive(head) {
+		if (this._isLive) return;
+		this._isLive = true;
+		await this.emitSerial("live", { head: cursorFromBlock(head) });
+	}
+	/**
+	* Fetches the ordered run of blocks after `cursor`, up to one window. Order
+	* is normalized here; continuity is verified per block by `advanceCursor`.
+	*/
+	async nextBlocks(cursor, headNumber) {
+		const hi = asXL1BlockNumber(Math.min(cursor.block + this.options.fetchWindow, headNumber), true);
+		const run = (await this._blockViewer.blocksByNumber(hi, hi - cursor.block)).filter((block) => block[0].block > cursor.block).toSorted((a, b) => a[0].block - b[0].block);
+		assertEx$1(run.length > 0, () => `FinalizedBlockStream: no blocks fetched in (${cursor.block}, ${hi}]`);
+		return run;
+	}
+	/** Polls the finalized head, releasing all cursor walks blocked on head growth. */
+	async pollHead() {
+		if (this._pollInProgress) return;
+		this._pollInProgress = true;
+		try {
+			const head = await this._finalizationViewer.head();
+			if (head[0]._hash !== this._head?.[0]._hash) {
+				this._head = head;
+				this.releaseHeadWaiters();
+			}
+		} catch (ex) {
+			this.logger?.error("FinalizedBlockStream: error polling head", ex);
+		} finally {
+			this._pollInProgress = false;
+		}
+	}
+	releaseHeadWaiters() {
+		const waiters = this._headWaiters.splice(0);
+		for (const release of waiters) release();
+	}
+	/** Resolves a checkpoint hash to a cursor, or throws the desync error a missing checkpoint implies. */
+	async resolveCheckpoint(after) {
+		const checkpoint = await this._blockViewer.blockByHash(after);
+		if (!checkpoint) throw new FinalizedBlockStreamDesyncError(after);
+		return cursorFromBlock(checkpoint);
+	}
+	/**
+	* The hot delivery loop. Transient errors are logged and retried on the next
+	* head advance; a continuity failure emits the terminal `desynced` event.
+	*/
+	async runHot() {
+		try {
+			await this.initHotCursor();
+			while (!this._stopping) try {
+				await this.advanceHot();
+			} catch (ex) {
+				if (ex instanceof FinalizedBlockStreamDesyncError) throw ex;
+				if (this._stopping) return;
+				this.logger?.error("FinalizedBlockStream: hot loop error, retrying on next head", ex);
+				await this.waitForHeadAdvance();
+			}
+		} catch (ex) {
+			if (ex instanceof FinalizedBlockStreamDesyncError && !this._terminal) {
+				this._terminal = true;
+				await this.emitSerial("desynced", {
+					block: ex.block,
+					expectedPrevious: ex.expectedPrevious
+				});
+				return;
+			}
+			this.logger?.error("FinalizedBlockStream: hot loop terminated", ex);
+		}
+	}
+	/** Suspends until the polled head changes or the stream stops. */
+	waitForHeadAdvance() {
+		if (this._stopping) return Promise.resolve();
+		return new Promise((resolve) => {
+			this._headWaiters.push(resolve);
+		});
+	}
+};
+/** Connection kinds supported by this provider. */
+__publicField$18(SimpleFinalizedBlockStream, "connectionTypes", ["none"]);
+/** Primary moniker used to resolve this provider. */
+__publicField$18(SimpleFinalizedBlockStream, "defaultMoniker", FinalizedBlockStreamMoniker);
+/** Provider monikers that must resolve before this provider can be created. */
+__publicField$18(SimpleFinalizedBlockStream, "dependencies", [BlockViewerMoniker, FinalizationViewerMoniker]);
+/** Provider monikers implemented by this provider class. */
+__publicField$18(SimpleFinalizedBlockStream, "monikers", [FinalizedBlockStreamMoniker]);
+/** Read, write, or mixed capability surface exposed by the provider. */
+__publicField$18(SimpleFinalizedBlockStream, "surface", "node");
+SimpleFinalizedBlockStream = __decorateClass$18([creatableProvider()], SimpleFinalizedBlockStream);
 var SimpleIndexViewer = class extends AbstractCreatableProvider {
 	/** Moniker implemented by this provider instance. */
 	moniker = SimpleIndexViewer.defaultMoniker;
@@ -120435,6 +121223,83 @@ var nextPruneCursor = (batch, pruneHashes, cursor) => {
 	const pruneSet = new Set(pruneHashes);
 	return batch.findLast((bundle3) => !pruneSet.has(bundle3._hash))?._sequence ?? cursor;
 };
+async function simpleBlockValidationCheck(payloads, context) {
+	return (await Promise.all(payloads.map(async (payload) => {
+		return [isPayloadBundle(payload) ? await bundledPayloadToHydratedBlock(payload) : void 0, payload];
+	}))).map(([block, bundle3]) => evaluateBlockCandidate(block, bundle3, context));
+}
+async function simpleTransactionValidationCheck(payloads, context) {
+	const transactionBundles = await Promise.all(payloads.map(async (payload) => {
+		return [isPayloadBundle(payload) ? await bundledPayloadToHydratedTransaction(payload) : void 0, payload];
+	}));
+	return Promise.all(transactionBundles.map(async ([transaction, bundle3]) => {
+		return evaluateTransactionCandidate(transaction, bundle3, context);
+	}));
+}
+function evaluateBlockCandidate(block, bundle3, { chainId, headNumber, logger }) {
+	const typeCheckPassed = isSignedHydratedBlockWithHashMeta(block);
+	const chainIdPassed = typeCheckPassed && block[0].chain === chainId;
+	const blockNumberPassed = typeCheckPassed && block[0].block > headNumber;
+	const validationPassed = typeCheckPassed && chainIdPassed && blockNumberPassed;
+	if (!validationPassed) logFailedBlockCheck({
+		block,
+		blockNumberPassed,
+		bundle: bundle3,
+		chainIdPassed,
+		headNumber,
+		logger,
+		typeCheckPassed
+	});
+	return [validationPassed ? block : void 0, bundle3];
+}
+async function evaluateTransactionCandidate(transaction, bundle3, { chainId, headNumber, logger, maxExpAhead }) {
+	const typeCheckPassed = isSignedHydratedTransactionWithHashMeta(transaction);
+	const chainIdPassed = typeCheckPassed && transaction[0].chain === chainId;
+	const expPassed = typeCheckPassed && transaction[0].exp > headNumber && transaction[0].exp <= headNumber + maxExpAhead;
+	const opcodeCheckPassed = await checkTransactionOpcodes(transaction, bundle3, logger);
+	const validationPassed = typeCheckPassed && chainIdPassed && expPassed && opcodeCheckPassed;
+	if (!validationPassed) logFailedTransactionCheck({
+		bundle: bundle3,
+		chainIdPassed,
+		expPassed,
+		headNumber,
+		logger,
+		opcodeCheckPassed,
+		transaction,
+		typeCheckPassed
+	});
+	return [validationPassed ? transaction : void 0, bundle3];
+}
+async function checkTransactionOpcodes(transaction, bundle3, logger) {
+	try {
+		await validateTransactionsOpcodes(transaction === void 0 ? [] : [transaction]);
+		return true;
+	} catch (error) {
+		const message = error instanceof Error ? error.message : String(error);
+		logger?.debug(`Opcode validation failed for transaction ${bundle3._hash} during simpleValidationCheck`);
+		logger?.debug(`  - error: ${message}`);
+		return false;
+	}
+}
+function logFailedBlockCheck({ block, blockNumberPassed, bundle: bundle3, chainIdPassed, headNumber, logger, typeCheckPassed }) {
+	if (chainIdPassed && typeCheckPassed && !blockNumberPassed) {
+		logger?.debug(`Pruning stale block candidate bundle ${bundle3._hash} during simpleValidationCheck (candidate height ${block?.[0].block} <= finalized head ${headNumber} \u2014 routine GC of a finalized or superseded candidate)`);
+		return;
+	}
+	logger?.debug(`Pruning block bundle ${bundle3._hash} during simpleValidationCheck`);
+	logger?.debug(`  - chainId match: ${chainIdPassed}`);
+	logger?.debug(`  - blockNumber check: ${blockNumberPassed} [head=${headNumber} candidate=${block?.[0].block}]`);
+	logger?.debug(`  - typeCheck: ${typeCheckPassed}`);
+	logger?.debug(`  - bundle hash: ${bundle3._hash}`);
+}
+function logFailedTransactionCheck({ bundle: bundle3, chainIdPassed, expPassed, headNumber, logger, opcodeCheckPassed, transaction, typeCheckPassed }) {
+	logger?.debug(`Pruning transaction bundle ${bundle3._hash} during simpleValidationCheck`);
+	logger?.debug(`  - chainId match: ${chainIdPassed}`);
+	logger?.debug(`  - exp check: ${expPassed} [head=${headNumber} exp=${transaction?.[0].exp}]`);
+	logger?.debug(`  - opcode check: ${opcodeCheckPassed}`);
+	logger?.debug(`  - typeCheck: ${typeCheckPassed}`);
+	logger?.debug(`  - bundle hash: ${bundle3._hash}`);
+}
 var DEFAULT_SYNC_INTERVAL = 3e4;
 var DEFAULT_SYNC_LIMIT = 100;
 var ENFORCE_CAP_BATCH_SIZE = 1e3;
@@ -120567,7 +121432,11 @@ var SimpleMempoolRunner = class extends AbstractCreatableProvider {
 		}
 		while (batch.length > 0 && pruned < maxPrune && total < maxCheck) {
 			batches += 1;
-			const blocksAndBundles = await this.simpleBlockValidationCheck(batch);
+			const blocksAndBundles = await simpleBlockValidationCheck(batch, {
+				chainId: await this.chainContractViewer.chainId(),
+				headNumber: await this.finalizationViewer.headNumber(),
+				logger: this.logger
+			});
 			const blocks = blocksAndBundles.map(([b]) => b);
 			const bundles = blocksAndBundles.map(([_, p]) => p);
 			const valid = blocks.map((b) => !!b);
@@ -120581,9 +121450,10 @@ var SimpleMempoolRunner = class extends AbstractCreatableProvider {
 					state: true
 				}))),
 				isValidated: isSignedHydratedBlockWithHashMeta,
-				onInvalid: ({ bundle: bundle3, result }) => {
-					const errors = result;
+				onInvalid: async ({ bundle: bundle3, item, result }) => {
+					const errors = isSignedHydratedBlockWithHashMeta(result) ? [] : result;
 					this.logger?.info(`[SimpleMempoolRunner] prunePendingBlocks deleting block ${bundle3._hash} (validation: ${errors.at(0)?.message ?? "failed simple/full check"})`);
+					await this.routeRejectedBlock(item, errors);
 				}
 			});
 			const pruneHashes = invalidBundleHashes(bundles, valid);
@@ -120619,7 +121489,12 @@ var SimpleMempoolRunner = class extends AbstractCreatableProvider {
 		}
 		while (batch.length > 0 && pruned < maxPrune && total < maxCheck) {
 			batches += 1;
-			const transactionsAndBundles = await this.simpleTransactionValidationCheck(batch);
+			const transactionsAndBundles = await simpleTransactionValidationCheck(batch, {
+				chainId: await this.chainContractViewer.chainId(),
+				headNumber: await this.finalizationViewer.headNumber(),
+				logger: this.logger,
+				maxExpAhead: this.maxExpAhead
+			});
 			const transactions = transactionsAndBundles.map(([t]) => t);
 			const bundles = transactionsAndBundles.map(([_, p]) => p);
 			const valid = transactions.map((t) => !!t);
@@ -120779,6 +121654,20 @@ var SimpleMempoolRunner = class extends AbstractCreatableProvider {
 		if (isDemotionAware(this._mempoolViewer)) return this._mempoolViewer.getEvictionPriorityOrder(bundleHashesOldestFirst);
 		return bundleHashesOldestFirst;
 	}
+	async routeRejectedBlock(block, errors) {
+		if (!this._deadLetterQueueRunner) return;
+		const rejectionErrors = errors.map((e) => ({
+			hash: e.hash ?? block[0]._hash,
+			name: e.name ?? "BlockValidationError",
+			message: String(e.message ?? e)
+		}));
+		await this._deadLetterQueueRunner.rejectBlock({
+			schema: BlockRejectionSchema,
+			block,
+			errors: rejectionErrors,
+			rejector: "mempool"
+		});
+	}
 	async routeRejectedTransaction(transaction, errors) {
 		if (!this._deadLetterQueueRunner) return;
 		const rejectionErrors = errors.map((e) => ({
@@ -120793,60 +121682,6 @@ var SimpleMempoolRunner = class extends AbstractCreatableProvider {
 			rejector: "mempool"
 		});
 	}
-	async simpleBlockValidationCheck(payloads) {
-		const headNumber = await this.finalizationViewer.headNumber();
-		const chainId = await this.chainContractViewer.chainId();
-		return (await Promise.all(payloads.map(async (p) => {
-			return [isPayloadBundle(p) ? await bundledPayloadToHydratedBlock(p) : void 0, p];
-		}))).map(([block, bundle3]) => {
-			const blockCheckPassed = !!block;
-			const chainIdPassed = blockCheckPassed ? block[0].chain === chainId : false;
-			const blockNumberPassed = blockCheckPassed ? block[0].block > headNumber : false;
-			const typeCheckPassed = blockCheckPassed ? isSignedHydratedBlockWithHashMeta(block) : false;
-			const validationPassed = blockCheckPassed && chainIdPassed && blockNumberPassed && typeCheckPassed;
-			const validatedBlock = validationPassed ? block : void 0;
-			if (!validationPassed) {
-				this.logger?.debug(`Pruning block bundle ${bundle3._hash} during simpleValidationCheck`);
-				this.logger?.debug(`  - chainId match: ${chainIdPassed}`);
-				this.logger?.debug(`  - blockNumber check: ${blockNumberPassed} [${headNumber}|${block?.[0].block}]`);
-				this.logger?.debug(`  - typeCheck: ${typeCheckPassed}`);
-				this.logger?.debug(`  - bundle hash: ${bundle3._hash}`);
-			}
-			return [validatedBlock, bundle3];
-		});
-	}
-	async simpleTransactionValidationCheck(payloads) {
-		const headNumber = await this.finalizationViewer.headNumber();
-		const chainId = await this.chainContractViewer.chainId();
-		const transactionBundles = await Promise.all(payloads.map(async (p) => {
-			return [isPayloadBundle(p) ? await bundledPayloadToHydratedTransaction(p) : void 0, p];
-		}));
-		return await Promise.all(transactionBundles.map(async ([transaction, bundle3]) => {
-			const transactionCheckPassed = !!transaction;
-			const chainIdPassed = transactionCheckPassed ? transaction[0].chain === chainId : false;
-			const expPassed = transactionCheckPassed ? transaction[0].exp > headNumber && transaction[0].exp <= headNumber + this.maxExpAhead : false;
-			const typeCheckPassed = transactionCheckPassed ? isSignedHydratedTransactionWithHashMeta(transaction) : false;
-			let opcodeCheckPassed = false;
-			try {
-				await validateTransactionsOpcodes(transaction ? [transaction] : []);
-				opcodeCheckPassed = true;
-			} catch (e) {
-				this.logger?.debug(`Opcode validation failed for transaction ${bundle3._hash} during simpleValidationCheck`);
-				this.logger?.debug(`  - error: ${e.message}`);
-			}
-			const validationPassed = transactionCheckPassed && chainIdPassed && expPassed && typeCheckPassed && opcodeCheckPassed;
-			const validatedTransaction = validationPassed ? transaction : void 0;
-			if (!validationPassed) {
-				this.logger?.debug(`Pruning block bundle ${bundle3._hash} during simpleValidationCheck`);
-				this.logger?.debug(`  - chainId match: ${chainIdPassed}`);
-				this.logger?.debug(`  - exp check: ${expPassed}`);
-				this.logger?.debug(`  - opcode check: ${opcodeCheckPassed}`);
-				this.logger?.debug(`  - typeCheck: ${typeCheckPassed}`);
-				this.logger?.debug(`  - bundle hash: ${bundle3._hash}`);
-			}
-			return [validatedTransaction, bundle3];
-		}));
-	}
 	async syncBlocksFrom(external) {
 		const externalBlocks = await external.pendingBlocks({ limit: this.syncLimit });
 		if (externalBlocks.length === 0) return;
@@ -120893,6 +121728,11 @@ __publicField$18(SimpleMempoolRunner, "monikers", [MempoolRunnerMoniker]);
 /** Read, write, or mixed capability surface exposed by the provider. */
 __publicField$18(SimpleMempoolRunner, "surface", "node");
 SimpleMempoolRunner = __decorateClass$18([creatableProvider()], SimpleMempoolRunner);
+async function resolveHashCursor(archivist, providedCursor) {
+	if (!isHash(providedCursor)) return void 0;
+	const [payload] = await archivist.get([providedCursor]);
+	return isDefined$1(payload) ? payload._sequence : void 0;
+}
 var SimpleMempoolViewerOptionsZod = object$3({
 	demotionThreshold: number$1().default(3),
 	handoutStatsTtlBlocks: number$1().default(1e3),
@@ -120960,11 +121800,7 @@ var SimpleMempoolViewer = class extends AbstractCreatableProvider {
 	}
 	/** Returns the pending blocks result exposed by this provider. */
 	async pendingBlocks({ cursor: providedCursor } = {}) {
-		let cursor;
-		if (isHash(providedCursor)) {
-			const [p] = await this.pendingBlocksArchivist.get([providedCursor]);
-			if (isDefined$1(p)) cursor = p._sequence;
-		}
+		const cursor = await resolveHashCursor(this.pendingBlocksArchivist, providedCursor);
 		const filteredBundles = (await this.pendingBlocksArchivist.next({
 			order: "desc",
 			limit: 100,
@@ -120974,11 +121810,8 @@ var SimpleMempoolViewer = class extends AbstractCreatableProvider {
 	}
 	/** Returns the pending transactions result exposed by this provider. */
 	async pendingTransactions({ cursor: providedCursor, limit = 100 } = {}) {
-		let cursor;
-		if (isHash(providedCursor)) {
-			const [p] = await this.pendingTransactionsArchivist.get([providedCursor]);
-			if (isDefined$1(p)) cursor = p._sequence;
-		}
+		await this.windowedBlockViewer.sync?.();
+		const cursor = await resolveHashCursor(this.pendingTransactionsArchivist, providedCursor);
 		this.logger?.debug(`Fetching pending transactions from cursor: ${cursor}`);
 		const bundles = await this.pendingTransactionsArchivist.next({
 			order: "asc",
@@ -122104,7 +122937,9 @@ var SimpleWindowedBlockViewer = class extends AbstractCreatableProvider {
 	_blockNumberMap;
 	_blockViewer;
 	_chain = [];
+	_inFlightSync = null;
 	_options;
+	_queuedSync = null;
 	_syncMutex = new Mutex();
 	_timerId = null;
 	_transactionHashMap;
@@ -122212,6 +123047,32 @@ var SimpleWindowedBlockViewer = class extends AbstractCreatableProvider {
 		await super.stopHandler();
 		this.stopPoll();
 	}
+	/**
+	* Synchronizes the in-memory window with the backing block viewer immediately, waiting for any
+	* in-flight sync to complete first. Callers whose correctness depends on seeing the latest
+	* finalized blocks (e.g. mempool inclusion checks) must call this rather than rely on the
+	* background poll, whose interval is far coarser than block finalization.
+	*
+	* Concurrent callers are coalesced: a caller arriving while a sync runs joins one shared
+	* follow-up pass (which starts after the running pass and therefore observes every block
+	* finalized before the caller arrived) instead of enqueuing its own. Without this, N
+	* concurrent callers — the handout path is reachable per producer tick and over RPC — would
+	* execute N sequential backing reads behind the sync mutex.
+	*/
+	async sync() {
+		if (this._inFlightSync === null) {
+			const run = this.runSync().finally(() => {
+				if (this._inFlightSync === run) this._inFlightSync = null;
+			});
+			this._inFlightSync = run;
+			return await run;
+		}
+		this._queuedSync ??= this._inFlightSync.then(() => {
+			this._queuedSync = null;
+			return this.sync();
+		});
+		return await this._queuedSync;
+	}
 	addBlock(block) {
 		this._chain.push(block);
 		this._blockHashMap.set(block[0]._hash, block);
@@ -122225,18 +123086,8 @@ var SimpleWindowedBlockViewer = class extends AbstractCreatableProvider {
 			for (const tx of transactionsFromHydratedBlock(removedBlock)) this._transactionHashMap.delete(tx._hash);
 		}
 	}
-	startPoll() {
-		this._timerId = setInterval(() => {
-			this.sync();
-		}, this.syncInterval);
-	}
-	stopPoll() {
-		if (this._timerId) clearInterval(this._timerId);
-		this._timerId = null;
-	}
-	async sync() {
-		if (this._syncMutex.isLocked()) return;
-		return await this._syncMutex.runExclusive(async () => {
+	async runSync() {
+		await this._syncMutex.runExclusive(async () => {
 			try {
 				let cursor = await this._blockViewer.currentBlock();
 				const previousHead = this._chain.length > 0 ? await this.currentBlockHash() : null;
@@ -122252,6 +123103,19 @@ var SimpleWindowedBlockViewer = class extends AbstractCreatableProvider {
 			}
 		});
 	}
+	startPoll() {
+		this._timerId = setInterval(() => {
+			this.syncIfIdle();
+		}, this.syncInterval);
+	}
+	stopPoll() {
+		if (this._timerId) clearInterval(this._timerId);
+		this._timerId = null;
+	}
+	async syncIfIdle() {
+		if (this._syncMutex.isLocked()) return;
+		await this.sync();
+	}
 };
 /** Connection kinds supported by this provider. */
 __publicField$18(SimpleWindowedBlockViewer, "connectionTypes", [
@@ -123269,7 +124133,7 @@ function getOriginalId(rawRequest) {
 	return [void 0, false];
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@xyo-network+xl1-sdk@5.2.3_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@4.4.3__@o_d668443a8314bbcb6b4d304ca8d635e8/node_modules/@xyo-network/xl1-sdk/dist/neutral/rpc.mjs
+//#region ../../node_modules/.pnpm/@xyo-network+xl1-sdk@5.3.1_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@4.4.3__@o_a771cefd6e9eb69efc5a95a989caf2a3/node_modules/@xyo-network/xl1-sdk/dist/neutral/rpc.mjs
 var __defProp$17 = Object.defineProperty;
 var __getOwnPropDesc$17 = Object.getOwnPropertyDescriptor;
 var __defNormalProp$17 = (obj, key, value) => key in obj ? __defProp$17(obj, key, {
@@ -224588,7 +225452,7 @@ var BaseMongoSdk = class {
 	}
 };
 //#endregion
-//#region ../../node_modules/.pnpm/@xyo-network+xl1-driver-mongodb@5.2.3_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zo_13d35ab58c6839187ab33de3996ce7b7/node_modules/@xyo-network/xl1-driver-mongodb/dist/neutral/index.mjs
+//#region ../../node_modules/.pnpm/@xyo-network+xl1-driver-mongodb@5.3.1_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zo_c6dcb1b9a06ee930febaf04848b7a277/node_modules/@xyo-network/xl1-driver-mongodb/dist/neutral/index.mjs
 var __defProp$15 = Object.defineProperty;
 var __getOwnPropDesc$15 = Object.getOwnPropertyDescriptor;
 var __defNormalProp$15 = (obj, key, value) => key in obj ? __defProp$15(obj, key, {
@@ -227822,7 +228686,12 @@ var ChainFinalizer = class extends Base {
 		this.windowedFinalizedChain = [...this.windowedFinalizedChain, ...chain].slice(-this.maxWindowSize);
 	}
 };
-var ChainHeadSelector = class extends ChainFinalizer {
+var ChainHeadSelector = class _ChainHeadSelector extends ChainFinalizer {
+	/**
+	* How long uncle selection may go without a single qualifying candidate (while candidates are
+	* present) before a warning is emitted; also the minimum interval between repeat warnings.
+	*/
+	static SilentUncleRejectionWarnAfterMs = 5e3;
 	admission;
 	allowedProducers;
 	backoffMs;
@@ -227848,6 +228717,7 @@ var ChainHeadSelector = class extends ChainFinalizer {
 			const proposedBlocks = await this.admit(allProposedBlocks, allowed);
 			this.windowedFinalizedChain = await getWindowedChain$1(this.context, this.blockViewer, this.maxWindowSize, this.windowedFinalizedChain);
 			const uncles = findUncles$1(this.context, this.windowedFinalizedChain, proposedBlocks);
+			this.reportSilentUncleRejections(proposedBlocks, uncles.length);
 			return findBestUncle(this.windowedFinalizedChain, uncles, {
 				backoffMs: this.backoffMs,
 				minCandidates: this.minCandidates
@@ -227918,6 +228788,32 @@ var ChainHeadSelector = class extends ChainFinalizer {
 			});
 		} catch {}
 	}
+	/**
+	* Surfaces the otherwise-silent case where candidates are continuously present but none
+	* qualifies as an uncle — without this, the only signal of a stalled selector is an endless
+	* "No new blocks found N to N" while rejected candidates cycle through the pool. Zero-qualify
+	* moments are routine in healthy operation (a just-finalized candidate lingers until the pool
+	* GC), so this warns only after candidates have been failing continuously for
+	* SilentUncleRejectionWarnAfterMs — an idle (candidate-free) tick resets the clock — then
+	* rate-limits to one warn per that interval. State lives in context.singletons because a
+	* fresh ChainHeadSelector is constructed on every finalization tick.
+	*/
+	reportSilentUncleRejections(proposedBlocks, uncleCount) {
+		const singletons = this.context.singletons;
+		const stateKey = "ChainHeadSelector:uncleSelectionHealth";
+		const now = Date.now();
+		const state = singletons[stateKey] ?? { lastWarnedAt: 0 };
+		singletons[stateKey] = state;
+		if (uncleCount > 0 || proposedBlocks.length === 0) {
+			state.unqualifiedSince = void 0;
+			return;
+		}
+		state.unqualifiedSince ??= now;
+		if (now - state.unqualifiedSince < _ChainHeadSelector.SilentUncleRejectionWarnAfterMs) return;
+		if (now - state.lastWarnedAt < _ChainHeadSelector.SilentUncleRejectionWarnAfterMs) return;
+		state.lastWarnedAt = now;
+		this.context.logger?.warn(`findBestHead: candidates have failed uncle qualification continuously for ${now - state.unqualifiedSince}ms \u2014 ${proposedBlocks.length} pending candidate(s): ` + proposedBlocks.map((b) => `${b[0].block} [${b[0]._hash}]`).join(", "));
+	}
 };
 asSchema$1("network.xyo.chain.summary.producers", true);
 asSchema$1("network.xyo.chain.summary.staked.intent", true);
@@ -228072,7 +228968,7 @@ var STAKE_EVENT_NAMES$1 = /* @__PURE__ */ new Set([
 	"StakeRemoved",
 	"StakeWithdrawn"
 ]);
-var DEFAULT_HEAD_POLL_INTERVAL_MS = 5e3;
+var DEFAULT_HEAD_POLL_INTERVAL_MS$1 = 5e3;
 var MIN_HEAD_POLL_INTERVAL_MS = 5e3;
 var RestStakeEventsViewerOptionsZod = object$3({ headPollIntervalMs: number$1().optional() });
 var RestStakeEventsViewer = class extends AbstractCreatableProvider$1 {
@@ -228080,7 +228976,7 @@ var RestStakeEventsViewer = class extends AbstractCreatableProvider$1 {
 	completeFrames = /* @__PURE__ */ new Map();
 	contractInterface = new Interface(IAddressStakingEvents__factory2.abi);
 	currentHead;
-	headPollIntervalMs = DEFAULT_HEAD_POLL_INTERVAL_MS;
+	headPollIntervalMs = DEFAULT_HEAD_POLL_INTERVAL_MS$1;
 	lastSuccessfulSyncAt;
 	manifestPromise;
 	positionCountCheckpoints = [];
@@ -228104,7 +229000,7 @@ var RestStakeEventsViewer = class extends AbstractCreatableProvider$1 {
 		RestStakeEventsViewer.requireBoundConnection(this.config);
 		const { headPollIntervalMs } = RestStakeEventsViewerOptionsZod.parse(this.config.options);
 		if (headPollIntervalMs !== void 0) assertEx$1(headPollIntervalMs >= MIN_HEAD_POLL_INTERVAL_MS, () => `headPollIntervalMs must be at least ${MIN_HEAD_POLL_INTERVAL_MS}ms`);
-		this.headPollIntervalMs = headPollIntervalMs ?? DEFAULT_HEAD_POLL_INTERVAL_MS;
+		this.headPollIntervalMs = headPollIntervalMs ?? DEFAULT_HEAD_POLL_INTERVAL_MS$1;
 	}
 	async positionCount(range) {
 		await this.sync();
@@ -230079,7 +230975,7 @@ var SimpleBlockRunner = class extends AbstractCreatableProvider$1 {
 	moniker = SimpleBlockRunner.defaultMoniker;
 	_blockRewardDiviner;
 	_deadLetterQueueRunner;
-	_excludedTransactionHashes = /* @__PURE__ */ new Set();
+	_excludedTransactionHashes = /* @__PURE__ */ new Map();
 	_lastRedeclarationBlock;
 	_rejectedTransactionsArchivist;
 	_account;
@@ -230089,6 +230985,7 @@ var SimpleBlockRunner = class extends AbstractCreatableProvider$1 {
 	_blockValidationViewer;
 	_chainParamsViewer;
 	_finalizationViewer;
+	_lastRejectedBuildAt = 0;
 	/** Cache of the last candidate this runner signed; the mempool is the source of truth. */
 	_lastSignedCandidate;
 	_mempoolViewer;
@@ -230203,10 +231100,13 @@ var SimpleBlockRunner = class extends AbstractCreatableProvider$1 {
 		const shouldValidateBalances = validateBalances ?? this.params.validateBalances ?? true;
 		return await this.spanAsync("proposeNextValidBlock", async () => {
 			try {
+				if (this.isWithinRejectedBuildBackoff(force)) return;
 				const { block: previousBlock } = assertEx$1(asBlockBoundWitness$1(head), () => "Invalid head block");
 				const nextBlock = previousBlock + 1;
 				const chainId = await this.finalizationViewer.chainId();
-				const pendingTransactions = (await this.mempoolViewer.pendingTransactions({ limit: SimpleBlockRunner.DefaultBlockSize })).filter((tx) => !this._excludedTransactionHashes.has(tx[0]._hash));
+				const pendingTransactionsRaw = await this.mempoolViewer.pendingTransactions({ limit: SimpleBlockRunner.DefaultBlockSize });
+				this.evictStaleExclusions(previousBlock);
+				const pendingTransactions = pendingTransactionsRaw.filter((tx) => !this._excludedTransactionHashes.has(tx[0]._hash));
 				const nextBlockTransactions = await this.rejectWrongChainTransactions(pendingTransactions, chainId);
 				this.logger?.log(`Pending Tx Count ${nextBlockTransactions.length}`);
 				const nonTxPayloads = [];
@@ -230216,10 +231116,7 @@ var SimpleBlockRunner = class extends AbstractCreatableProvider$1 {
 				const rewardTransferPayloads = await this.getBlockRewardTransfers(nextBlock);
 				nonTxPayloads.push(...rewardTransferPayloads);
 				const transactionTransfers = await generateTransactionFeeTransfers(this.address, nextBlockTransactions);
-				const timeStart = Date.now();
 				const timePayload = await this.generateTimePayload();
-				const timeDuration = Date.now() - timeStart;
-				if (timeDuration > 100) this.logger?.warn(`[Slow] Generated time payload in ${timeDuration}ms`);
 				const [initialFundedTransactions, initialFundedTransfers] = await this.filterByFunded(head, nextBlockTransactions, transactionTransfers, shouldValidateBalances);
 				const stepRewardPoolBalance = (await this.accountBalanceViewer.accountBalances([XYO_STEP_REWARD_ADDRESS]))[String(XYO_STEP_REWARD_ADDRESS)];
 				const { block: proposedBlock, errors: proposedErrors } = await this.runBuildValidateRetryLoop({
@@ -230231,14 +231128,31 @@ var SimpleBlockRunner = class extends AbstractCreatableProvider$1 {
 					initialFundedTransactions,
 					initialFundedTransfers
 				});
-				if (isSignedHydratedBlockWithHashMeta$1(proposedBlock)) return proposedBlock;
-				if (proposedBlock !== void 0) await this.rejectExhaustedBlock(proposedBlock, proposedErrors);
+				return await this.commitProposedBlock(proposedBlock, proposedErrors);
 			} catch (error) {
 				this.logger?.error(`Error proposing next valid block: ${error.message}`);
 				throw error;
 			}
 		}, this.context);
 	}
+	addTransferOutflow(outflow, payload) {
+		let result = outflow;
+		for (const [to, amount] of Object.entries(payload.transfers)) {
+			if (to === payload.from) continue;
+			result += hexToBigInt(amount ?? "00");
+		}
+		return result;
+	}
+	async commitProposedBlock(proposedBlock, proposedErrors) {
+		if (proposedErrors.length === 0 && isSignedHydratedBlockWithHashMeta$1(proposedBlock)) {
+			this._lastRejectedBuildAt = 0;
+			return proposedBlock;
+		}
+		if (proposedBlock !== void 0) {
+			this._lastRejectedBuildAt = Date.now();
+			await this.rejectExhaustedBlock(proposedBlock, proposedErrors);
+		}
+	}
 	/**
 	* Compute the cumulative outflow a single tx would charge to its `from`
 	* address, using the same rule as `BlockCumulativeBalanceValidator`:
@@ -230248,14 +231162,6 @@ var SimpleBlockRunner = class extends AbstractCreatableProvider$1 {
 	* reject, which would otherwise wedge the chain because the producer's
 	* `_lastProducedBlock` cache mutes retries.
 	*/
-	addTransferOutflow(outflow, payload) {
-		let result = outflow;
-		for (const [to, amount] of Object.entries(payload.transfers)) {
-			if (to === payload.from) continue;
-			result += hexToBigInt(amount ?? "00");
-		}
-		return result;
-	}
 	computeTransactionOutflow(tx) {
 		const [bw, payloads] = tx;
 		const { base, gasLimit, priority } = bw.fees;
@@ -230269,6 +231175,14 @@ var SimpleBlockRunner = class extends AbstractCreatableProvider$1 {
 		}
 		return outflow;
 	}
+	/**
+	* Drops head-relative ('block-balance') exclusions once the head has advanced past the height
+	* they were recorded at — the sender's funding is re-evaluated by filterByFunded at the new
+	* head. Deterministic ('tx-invalid') exclusions are kept for the process lifetime.
+	*/
+	evictStaleExclusions(headBlock) {
+		for (const [hash, entry] of this._excludedTransactionHashes) if (entry.reason === "block-balance" && headBlock > entry.excludedAtBlock) this._excludedTransactionHashes.delete(hash);
+	}
 	async filterByFunded(head, txs, transfers, validateBalances = false) {
 		const fundedTransfers = [];
 		const fundedTransactions = [];
@@ -230298,7 +231212,11 @@ var SimpleBlockRunner = class extends AbstractCreatableProvider$1 {
 		return [fundedTransactions, fundedTransfers];
 	}
 	async generateTimePayload() {
-		return await this.timeSyncViewer.currentTimePayload();
+		const timeStart = Date.now();
+		const timePayload = await this.timeSyncViewer.currentTimePayload();
+		const timeDuration = Date.now() - timeStart;
+		if (timeDuration > 100) this.logger?.warn(`[Slow] Generated time payload in ${timeDuration}ms`);
+		return timePayload;
 	}
 	/**
 	* Check if a heartbeat block is required based on network activity.
@@ -230310,6 +231228,11 @@ var SimpleBlockRunner = class extends AbstractCreatableProvider$1 {
 		if (isDefined$1(epoch) && Date.now() - epoch > this.heartbeatInterval) return true;
 		return false;
 	}
+	isWithinRejectedBuildBackoff(force) {
+		if (force || Date.now() - this._lastRejectedBuildAt >= SimpleBlockRunner.RejectedBuildBackoffMs) return false;
+		this.logger?.debug("Skipping block production during rejected-build backoff");
+		return true;
+	}
 	/**
 	* The hash of this producer's own earlier candidate at the same height and parent, if any.
 	*
@@ -230404,7 +231327,11 @@ var SimpleBlockRunner = class extends AbstractCreatableProvider$1 {
 			];
 			this.logger?.info(`Building block ${head.block + 1}${attempt > 0 ? ` (retry ${attempt})` : ""}`);
 			lastBlock = await buildNextBlock(head, candidateTransactions, blockPayloads, [this.account], XYO_STEP_REWARD_ADDRESS, stepRewardPoolBalance, void 0, chainId, supersedes);
-			const validated = await this.blockValidationViewer.validateBlock(lastBlock, { head: head._hash });
+			const validated = await this.blockValidationViewer.validateBlock(lastBlock, {
+				value: true,
+				state: true,
+				head: head._hash
+			});
 			if (isSignedHydratedBlockWithHashMeta$1(validated)) {
 				this._lastSignedCandidate = {
 					block: validated[0].block,
@@ -230423,7 +231350,10 @@ var SimpleBlockRunner = class extends AbstractCreatableProvider$1 {
 				errors: validated
 			});
 			if (offendingHashes.length === 0 || reason === "unknown") break;
-			for (const offendingHash of offendingHashes) this._excludedTransactionHashes.add(offendingHash);
+			for (const offendingHash of offendingHashes) this._excludedTransactionHashes.set(offendingHash, {
+				excludedAtBlock: head.block,
+				reason
+			});
 			const offendingSet = new Set(offendingHashes);
 			candidateTransactions = candidateTransactions.filter((tx) => !offendingSet.has(tx[0]._hash));
 			const remainingFromAddresses = new Set(candidateTransactions.map((tx) => tx[0].from));
@@ -230436,6 +231366,12 @@ var SimpleBlockRunner = class extends AbstractCreatableProvider$1 {
 		};
 	}
 };
+/**
+* Minimum time between build attempts after a fully-rejected build (validation exhausted with
+* no attributable transaction to exclude). Such a build fails identically until external state
+* changes, so retrying at the production tick rate only churns build → validate → DLQ.
+*/
+__publicField$11(SimpleBlockRunner, "RejectedBuildBackoffMs", 1e3);
 __publicField$11(SimpleBlockRunner, "connectionTypes", [
 	"lmdb",
 	"mongo",
@@ -232388,6 +233324,8 @@ var ProducerActor = class extends ChainActor {
 	_blockViewer;
 	_chainContractViewer;
 	_chainId;
+	_fastCandidateRecoveriesForHead = 0;
+	_lastCandidateGoneCheckTime = 0;
 	_lastHeadChangeTime;
 	_lastHeadHash;
 	_mempoolRunner;
@@ -232453,6 +233391,8 @@ var ProducerActor = class extends ChainActor {
 		this._lastProducedBlock = void 0;
 		this._lastHeadHash = void 0;
 		this._lastHeadChangeTime = void 0;
+		this._fastCandidateRecoveriesForHead = 0;
+		this._lastCandidateGoneCheckTime = 0;
 		this.registerTimer("BlockProductionTimer", async () => {
 			await this.produceBlock();
 		}, 2e3, this.blockProductionCheckInterval);
@@ -232463,6 +233403,25 @@ var ProducerActor = class extends ChainActor {
 	calculateBlocksUntilProducerDeclarationExpiration(currentBlock) {
 		return (this._lastRedeclarationIntent?.exp ?? currentBlock) - currentBlock;
 	}
+	/**
+	* Whether the last produced candidate has vanished from the pending-block pool while the head
+	* has not advanced — i.e. the mempool pruned it after downstream validation rejected it. The
+	* probe runs at most once per CandidateGoneCheckIntervalMs while a candidate stands on an
+	* unchanged head (one pendingBlocks read per probe); only POSITIVE recoveries — probes that
+	* find the candidate gone — are capped at MaxFastCandidateRecoveriesPerHead per head, so a
+	* persistently-rejected producer backs off to the stale-head resubmission threshold instead of
+	* churning rebuilds forever.
+	*/
+	async lastCandidateDropped(now) {
+		const lastProduced = this._lastProducedBlock;
+		if (isUndefined$1(lastProduced)) return false;
+		if (this._fastCandidateRecoveriesForHead >= ProducerActor.MaxFastCandidateRecoveriesPerHead) return false;
+		if (now - this._lastCandidateGoneCheckTime < ProducerActor.CandidateGoneCheckIntervalMs) return false;
+		this._lastCandidateGoneCheckTime = now;
+		const pendingBlocks = await this.mempoolViewer.pendingBlocks();
+		if (pendingBlocks.some((candidate) => candidate[0]._hash === lastProduced[0]._hash)) return false;
+		return pendingBlocks.length < ProducerActor.CandidateGoneScanLimit;
+	}
 	async produceBlock() {
 		this._producerActorBlockProductionChecks.add(1, this._metricAttributes);
 		await this.spanAsync("produceBlock", async () => {
@@ -232470,40 +233429,7 @@ var ProducerActor = class extends ChainActor {
 				this.logger?.debug("Skipping block production, previous production still in progress");
 				return;
 			}
-			await this._produceBlockMutex.runExclusive(async () => {
-				const [head] = await this.blockViewer.currentBlock();
-				const headHash = head._hash;
-				const currentTime = Date.now();
-				if (this._lastHeadHash !== headHash) {
-					const lastHeadHashHex = isDefined$1(this._lastHeadHash) ? `0x${this._lastHeadHash}` : "undefined";
-					const currentHeadHashHex = `0x${headHash}`;
-					this.logger?.log(`Found updated head ${lastHeadHashHex} -> ${currentHeadHashHex}`);
-					this._lastHeadHash = headHash;
-					this._lastHeadChangeTime = currentTime;
-				}
-				const timeSinceHeadChange = isDefined$1(this._lastHeadChangeTime) ? currentTime - this._lastHeadChangeTime : 0;
-				const shouldSubmit = this._lastProducedBlock?.[0].previous !== headHash;
-				const shouldResubmit = timeSinceHeadChange > this.headResubmissionThreshold;
-				if (!(shouldSubmit || shouldResubmit)) {
-					this.logger?.debug("No block submission required at this time.");
-					return;
-				}
-				if (shouldResubmit) {
-					this.logger?.log(`Resubmitting block due to stale head. Head ${toFormattedBlockReference(head)} unchanged for ${timeSinceHeadChange}ms`);
-					this._lastHeadChangeTime = currentTime;
-				}
-				this._producerActorBlockProductionAttempts.add(1, this._metricAttributes);
-				const nextBlock = await this.blockRunner.produceNextBlock(head);
-				if (nextBlock) {
-					const displayBlockNumber = toFormattedBlockReference(nextBlock[0]);
-					this.logger?.log("Produced block:", displayBlockNumber);
-					this._producerActorBlocksProduced.add(1, this._metricAttributes);
-					if ((await this.mempoolRunner.submitBlocks([nextBlock])).length === 0) this.logger?.error(`Submit dropped block ${displayBlockNumber} silently \u2014 archivist accepted 0 of 1 (hash ${nextBlock[0]._hash})`);
-					else this.logger?.log("Published block:", displayBlockNumber);
-					this._producerActorBlocksPublished.add(1, this._metricAttributes);
-					this._lastProducedBlock = nextBlock;
-				} else this.logger?.log("No block produced for submission.");
-			});
+			await this._produceBlockMutex.runExclusive(() => this.produceBlockExclusive());
 		}, {
 			...this.context,
 			timeBudgetLimit: 1e3
@@ -232568,8 +233494,73 @@ var ProducerActor = class extends ChainActor {
 		}
 		return true;
 	}
+	async produceBlockExclusive() {
+		const [head] = await this.blockViewer.currentBlock();
+		const headHash = head._hash;
+		const currentTime = Date.now();
+		this.recordHeadChange(headHash, currentTime);
+		const timeSinceHeadChange = isDefined$1(this._lastHeadChangeTime) ? currentTime - this._lastHeadChangeTime : 0;
+		const shouldSubmit = this._lastProducedBlock?.[0].previous !== headHash;
+		const shouldResubmit = timeSinceHeadChange > this.headResubmissionThreshold;
+		const shouldRecoverDroppedCandidate = !shouldSubmit && !shouldResubmit && await this.lastCandidateDropped(currentTime);
+		if (!(shouldSubmit || shouldResubmit || shouldRecoverDroppedCandidate)) {
+			this.logger?.debug("No block submission required at this time.");
+			return;
+		}
+		if (shouldResubmit) {
+			this.logger?.log(`Resubmitting block due to stale head. Head ${toFormattedBlockReference(head)} unchanged for ${timeSinceHeadChange}ms`);
+			this._lastHeadChangeTime = currentTime;
+		}
+		if (shouldRecoverDroppedCandidate) this.recoverDroppedCandidate();
+		await this.publishNextBlock(head, currentTime);
+	}
+	async publishNextBlock(head, currentTime) {
+		this._producerActorBlockProductionAttempts.add(1, this._metricAttributes);
+		const nextBlock = await this.blockRunner.produceNextBlock(head);
+		if (!nextBlock) {
+			this.logger?.log("No block produced for submission.");
+			return;
+		}
+		const displayBlockNumber = toFormattedBlockReference(nextBlock[0]);
+		this.logger?.log("Produced block:", displayBlockNumber);
+		this._producerActorBlocksProduced.add(1, this._metricAttributes);
+		if ((await this.mempoolRunner.submitBlocks([nextBlock])).length === 0) {
+			this.logger?.error(`Submit dropped block ${displayBlockNumber} silently \u2014 archivist accepted 0 of 1 (hash ${nextBlock[0]._hash})`);
+			return;
+		}
+		this.logger?.log("Published block:", displayBlockNumber);
+		this._producerActorBlocksPublished.add(1, this._metricAttributes);
+		this._lastProducedBlock = nextBlock;
+		this._lastCandidateGoneCheckTime = currentTime;
+	}
+	recordHeadChange(headHash, currentTime) {
+		if (this._lastHeadHash === headHash) return;
+		const lastHeadHashHex = isDefined$1(this._lastHeadHash) ? `0x${this._lastHeadHash}` : "undefined";
+		this.logger?.log(`Found updated head ${lastHeadHashHex} -> 0x${headHash}`);
+		this._lastHeadHash = headHash;
+		this._lastHeadChangeTime = currentTime;
+		this._fastCandidateRecoveriesForHead = 0;
+	}
+	recoverDroppedCandidate() {
+		const lastProduced = this._lastProducedBlock;
+		if (isUndefined$1(lastProduced)) return;
+		this._fastCandidateRecoveriesForHead += 1;
+		this.logger?.warn(`Last produced candidate ${toFormattedBlockReference(lastProduced[0])} is no longer pending (pruned or rejected); resuming production (recovery ${this._fastCandidateRecoveriesForHead}/${ProducerActor.MaxFastCandidateRecoveriesPerHead} for this head)`);
+		this._lastProducedBlock = void 0;
+	}
 };
 /**
+* Minimum time in milliseconds between checks of whether the last produced
+* candidate is still in the pending-block pool. Bounds the cost of the
+* dropped-candidate recovery probe (a pendingBlocks read per check).
+*/
+__publicField$7(ProducerActor, "CandidateGoneCheckIntervalMs", 1e3);
+/**
+* The mempool viewer's fixed pendingBlocks page size. A probe that sees a full page cannot
+* prove the candidate is gone and must treat it as still pending.
+*/
+__publicField$7(ProducerActor, "CandidateGoneScanLimit", 100);
+/**
 * The default interval time (in MS) between block production attempts.
 */
 __publicField$7(ProducerActor, "DefaultBlockProductionCheckInterval", DEFAULT_BLOCK_PRODUCTION_CHECK_INTERVAL);
@@ -232589,6 +233580,13 @@ __publicField$7(ProducerActor, "DefaultBlockProductionCheckInterval", DEFAULT_BL
 */
 __publicField$7(ProducerActor, "HeadResubmissionThresholdMs", 3e4);
 /**
+* Maximum number of dropped-candidate recoveries per head before deferring to
+* the stale-head resubmission threshold. A producer whose candidates are
+* persistently rejected (e.g. not on the allow-list) must back off rather
+* than churn rebuild/reject cycles at the recovery cadence forever.
+*/
+__publicField$7(ProducerActor, "MaxFastCandidateRecoveriesPerHead", 3);
+/**
 * The window (in blocks) before expiration to attempt redeclaration of producer intent.
 */
 __publicField$7(ProducerActor, "RedeclarationWindow", 1e3);
@@ -240910,7 +241908,7 @@ function withDeprecationWarning$1(module, host, options = {}) {
 	return module;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@xyo-network+xl1-sdk@5.2.3_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@4.4.3__@o_f803ff54f950c092c4a357d77886b418/node_modules/@xyo-network/xl1-sdk/dist/node/providers.mjs
+//#region ../../node_modules/.pnpm/@xyo-network+xl1-sdk@5.3.1_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@4.4.3__@o_3a01f3229f2daa942444e08696345b23/node_modules/@xyo-network/xl1-sdk/dist/node/providers.mjs
 var __defProp$3 = Object.defineProperty;
 var __getOwnPropDesc$3 = Object.getOwnPropertyDescriptor;
 var __defNormalProp$3 = (obj, key, value) => key in obj ? __defProp$3(obj, key, {
@@ -241864,6 +242862,179 @@ __publicField$3(EvmStakeViewer, "monikers", [StakeViewerMoniker$1]);
 /** Read, write, or mixed capability surface exposed by the provider. */
 __publicField$3(EvmStakeViewer, "surface", "node");
 EvmStakeViewer = __decorateClass$3([creatableProvider$1()], EvmStakeViewer);
+var DEFAULT_HEAD_POLL_INTERVAL_MS = 5e3;
+var RestNetworkStakeStepRewardsByPositionViewerOptionsZod = object$3({
+	headPollIntervalMs: number$1().min(5e3).default(DEFAULT_HEAD_POLL_INTERVAL_MS),
+	policyId: NetworkStakeRewardsPolicyIdZod.default(NETWORK_STAKE_REWARDS_UNMULTIPLIED_POLICY)
+});
+var RestNetworkStakeStepRewardsByPositionViewer = class extends AbstractCreatableProvider$1 {
+	moniker = RestNetworkStakeStepRewardsByPositionViewer.defaultMoniker;
+	currentHead;
+	headPollIntervalMs = DEFAULT_HEAD_POLL_INTERVAL_MS;
+	headPromise;
+	lastSuccessfulHeadAt;
+	manifestPromise;
+	policyId = NETWORK_STAKE_REWARDS_UNMULTIPLIED_POLICY;
+	snapshotPromises = /* @__PURE__ */ new Map();
+	stepPromises = /* @__PURE__ */ new Map();
+	get baseUrl() {
+		const connection = RestNetworkStakeStepRewardsByPositionViewer.requireBoundConnection(this.config);
+		const config = connection.config;
+		if (config.type !== "rest") throw new Error(`Connection "${connection.name}" must be a rest connection`);
+		return assertEx$1(config.baseUrl, () => `Connection "${connection.name}" requires a rest baseUrl`);
+	}
+	get fetchFn() {
+		return this.context.fetchFn ?? fetch.bind(globalThis);
+	}
+	/** Returns the policy bonus. The unmultiplied-v1 index has no multipliers, so bonus is zero. */
+	async bonus(options = {}) {
+		const total = await this.total(options);
+		return Object.fromEntries(Object.keys(total).map((key) => [Number(key), asAttoXL1$1(0n)]));
+	}
+	/** Claimed rewards are not part of the earned-reward index. */
+	claimed(_options) {
+		throw new Error("Method [claimed] not implemented.");
+	}
+	/** Creates the provider instance after validating its REST binding and options. */
+	async createHandler() {
+		await super.createHandler();
+		RestNetworkStakeStepRewardsByPositionViewer.requireBoundConnection(this.config);
+		const options = RestNetworkStakeStepRewardsByPositionViewerOptionsZod.parse(this.config.options);
+		this.headPollIntervalMs = options.headPollIntervalMs;
+		this.policyId = options.policyId;
+	}
+	/** Base-v1 total and earned rewards are identical. */
+	async earned(options = {}) {
+		return await this.total(options);
+	}
+	/** Returns rewards by requested position from the durable index. */
+	async total({ range, positions } = {}) {
+		if (!isArray(positions)) return {};
+		const head = await this.getHead();
+		const resolvedRange = asXL1BlockRange$1(range ?? [0, head.processedThroughBlock], { name: "RestNetworkStakeStepRewardsByPositionViewer" });
+		const result = {};
+		for (const position of positions) result[position] = (await this.totalForPosition(position, resolvedRange))[0];
+		return result;
+	}
+	/** Returns one position's cumulative reward and the range's emitted reward pool. */
+	async totalForPosition(position, range) {
+		const head = await this.getHead();
+		this.assertPublishedRange(range, head);
+		if (head.positionCount === 0) return [asAttoXL1$1(0n), asAttoXL1$1(0n)];
+		this.assertPosition(position, head);
+		if (range[0] === 0 && range[1] >= head.processedThroughBlock) {
+			const snapshot = await this.getSnapshot(head);
+			return [asAttoXL1$1(BigInt(snapshot.positionRewards[String(position)] ?? "0")), asAttoXL1$1(BigInt(snapshot.totalReward))];
+		}
+		const steps = await this.stepsForRange(range, head);
+		return [asAttoXL1$1(steps.reduce((sum, step) => sum + BigInt(step.positionRewards[String(position)] ?? "0"), 0n)), asAttoXL1$1(steps.reduce((sum, step) => sum + BigInt(step.totalReward), 0n))];
+	}
+	/** Returns the emitted reward pool for one indexed step. */
+	async totalForStep(step) {
+		const head = await this.getHead();
+		this.assertPublishedStep(step, head);
+		return asAttoXL1$1(BigInt((await this.getStep(step)).totalReward));
+	}
+	/** Returns one position's allocation and emitted pool for one indexed step. */
+	async totalForStepForPosition(step, position) {
+		const head = await this.getHead();
+		this.assertPosition(position, head);
+		this.assertPublishedStep(step, head);
+		const record = await this.getStep(step);
+		return [asAttoXL1$1(BigInt(record.positionRewards[String(position)] ?? "0")), asAttoXL1$1(BigInt(record.totalReward))];
+	}
+	/** Unclaimed rewards require redemption state and are not part of this index. */
+	unclaimed(_options) {
+		throw new Error("Method [unclaimed] not implemented.");
+	}
+	assertPosition(position, head) {
+		assertEx$1(Number.isSafeInteger(position) && position >= 0 && position < head.positionCount, () => `Position ${position} is outside rewards index positionCount ${head.positionCount}`);
+	}
+	assertPublishedRange(range, head) {
+		assertEx$1(range[1] <= head.processedThroughBlock, () => `Reward range ends at ${range[1]}, beyond index watermark ${head.processedThroughBlock}`);
+	}
+	assertPublishedStep(step, head) {
+		assertEx$1(step.block <= head.processedThroughBlock, () => `Reward step ${step.block}|${step.step} is beyond index watermark ${head.processedThroughBlock}`);
+	}
+	async fetchJson(path) {
+		const response = await this.fetchFn(`${this.baseUrl.replace(/\/$/, "")}/${path}`);
+		if (!response.ok) throw new Error(`Network stake rewards index request failed [${response.status}] for ${path}`);
+		return await response.json();
+	}
+	async getHead() {
+		const now = Date.now();
+		const elapsed = this.lastSuccessfulHeadAt === void 0 ? void 0 : now - this.lastSuccessfulHeadAt;
+		if (this.currentHead !== void 0 && elapsed !== void 0 && elapsed >= 0 && elapsed < this.headPollIntervalMs) return this.currentHead;
+		this.headPromise ??= this.syncHead().finally(() => {
+			this.headPromise = void 0;
+		});
+		return await this.headPromise;
+	}
+	async getManifest() {
+		this.manifestPromise ??= this.fetchJson(networkStakeRewardsIndexManifestPath(this.policyId)).then((value) => asNetworkStakeRewardsIndexManifest(value, true)).catch((error) => {
+			this.manifestPromise = void 0;
+			throw error;
+		});
+		return await this.manifestPromise;
+	}
+	async getSnapshot(head) {
+		const { snapshotHash } = head;
+		let promise = this.snapshotPromises.get(snapshotHash);
+		if (promise === void 0) {
+			const path = networkStakeRewardsIndexSnapshotPath(this.policyId, snapshotHash);
+			promise = this.fetchJson(path).then(async (value) => {
+				const snapshot = asNetworkStakeRewardsIndexSnapshot(value, true);
+				assertEx$1(await PayloadBuilder$1.hash(snapshot) === snapshotHash, () => `Rewards snapshot hash mismatch: ${path}`);
+				return snapshot;
+			});
+			this.snapshotPromises.set(snapshotHash, promise);
+		}
+		try {
+			const snapshot = await promise;
+			assertEx$1(snapshot.policyId === this.policyId, () => "Rewards snapshot policy mismatch");
+			assertEx$1(snapshot.stepCount === head.stepCount, () => "Rewards snapshot step count mismatch");
+			return snapshot;
+		} catch (error) {
+			this.snapshotPromises.delete(snapshotHash);
+			throw error;
+		}
+	}
+	async getStep(step) {
+		const path = networkStakeRewardsIndexStepPath(this.policyId, step);
+		let promise = this.stepPromises.get(path);
+		if (promise === void 0) {
+			promise = this.fetchJson(path).then((value) => asNetworkStakeRewardsIndexStep(value, true));
+			this.stepPromises.set(path, promise);
+		}
+		try {
+			const record = await promise;
+			assertEx$1(record.policyId === this.policyId, () => "Rewards step policy mismatch");
+			assertEx$1(record.step.block === step.block && record.step.step === step.step, () => "Rewards step identity mismatch");
+			return record;
+		} catch (error) {
+			this.stepPromises.delete(path);
+			throw error;
+		}
+	}
+	async stepsForRange(range, head) {
+		const steps = blockRangeSteps(range, (await this.getManifest()).stepLevels).filter((step) => step.block <= head.processedThroughBlock);
+		return await Promise.all(steps.map(async (step) => await this.getStep(step)));
+	}
+	async syncHead() {
+		assertEx$1((await this.getManifest()).policyId === this.policyId, () => "Rewards manifest policy mismatch");
+		const head = asNetworkStakeRewardsIndexHead(await this.fetchJson(networkStakeRewardsIndexHeadPath(this.policyId)), true);
+		assertEx$1(head.policyId === this.policyId, () => "Rewards head policy mismatch");
+		this.currentHead = head;
+		this.lastSuccessfulHeadAt = Date.now();
+		return head;
+	}
+};
+__publicField$3(RestNetworkStakeStepRewardsByPositionViewer, "connectionTypes", ["rest"]);
+__publicField$3(RestNetworkStakeStepRewardsByPositionViewer, "defaultMoniker", NetworkStakeStepRewardsByPositionViewerMoniker$1);
+__publicField$3(RestNetworkStakeStepRewardsByPositionViewer, "dependencies", []);
+__publicField$3(RestNetworkStakeStepRewardsByPositionViewer, "monikers", [NetworkStakeStepRewardsByPositionViewerMoniker$1]);
+__publicField$3(RestNetworkStakeStepRewardsByPositionViewer, "surface", "node");
+RestNetworkStakeStepRewardsByPositionViewer = __decorateClass$3([creatableProvider$1()], RestNetworkStakeStepRewardsByPositionViewer);
 var SimpleDeadLetterQueueRunner = class extends AbstractCreatableProvider$1 {
 	/** Moniker implemented by this provider instance. */
 	moniker = SimpleDeadLetterQueueRunner.defaultMoniker;
@@ -243260,181 +244431,8 @@ __publicField$3(RestChainParamsViewer, "monikers", [ChainParamsViewerMoniker]);
 /** Read, write, or mixed capability surface exposed by the provider. */
 __publicField$3(RestChainParamsViewer, "surface", "node");
 RestChainParamsViewer = __decorateClass$3([creatableProvider$1()], RestChainParamsViewer);
-var DEFAULT_HEAD_POLL_INTERVAL_MS2 = 5e3;
-var RestNetworkStakeStepRewardsByPositionViewerOptionsZod = object$3({
-	headPollIntervalMs: number$1().min(5e3).default(DEFAULT_HEAD_POLL_INTERVAL_MS2),
-	policyId: NetworkStakeRewardsPolicyIdZod.default(NETWORK_STAKE_REWARDS_UNMULTIPLIED_POLICY)
-});
-var RestNetworkStakeStepRewardsByPositionViewer = class extends AbstractCreatableProvider$1 {
-	moniker = RestNetworkStakeStepRewardsByPositionViewer.defaultMoniker;
-	currentHead;
-	headPollIntervalMs = DEFAULT_HEAD_POLL_INTERVAL_MS2;
-	headPromise;
-	lastSuccessfulHeadAt;
-	manifestPromise;
-	policyId = NETWORK_STAKE_REWARDS_UNMULTIPLIED_POLICY;
-	snapshotPromises = /* @__PURE__ */ new Map();
-	stepPromises = /* @__PURE__ */ new Map();
-	get baseUrl() {
-		const connection = RestNetworkStakeStepRewardsByPositionViewer.requireBoundConnection(this.config);
-		const config = connection.config;
-		if (config.type !== "rest") throw new Error(`Connection "${connection.name}" must be a rest connection`);
-		return assertEx$1(config.baseUrl, () => `Connection "${connection.name}" requires a rest baseUrl`);
-	}
-	get fetchFn() {
-		return this.context.fetchFn ?? fetch.bind(globalThis);
-	}
-	/** Returns the policy bonus. The unmultiplied-v1 index has no multipliers, so bonus is zero. */
-	async bonus(options = {}) {
-		const total = await this.total(options);
-		return Object.fromEntries(Object.keys(total).map((key) => [Number(key), asAttoXL1$1(0n)]));
-	}
-	/** Claimed rewards are not part of the earned-reward index. */
-	claimed(_options) {
-		throw new Error("Method [claimed] not implemented.");
-	}
-	/** Creates the provider instance after validating its REST binding and options. */
-	async createHandler() {
-		await super.createHandler();
-		RestNetworkStakeStepRewardsByPositionViewer.requireBoundConnection(this.config);
-		const options = RestNetworkStakeStepRewardsByPositionViewerOptionsZod.parse(this.config.options);
-		this.headPollIntervalMs = options.headPollIntervalMs;
-		this.policyId = options.policyId;
-	}
-	/** Base-v1 total and earned rewards are identical. */
-	async earned(options = {}) {
-		return await this.total(options);
-	}
-	/** Returns rewards by requested position from the durable index. */
-	async total({ range, positions } = {}) {
-		if (!isArray(positions)) return {};
-		const head = await this.getHead();
-		const resolvedRange = asXL1BlockRange$1(range ?? [0, head.processedThroughBlock], { name: "RestNetworkStakeStepRewardsByPositionViewer" });
-		const result = {};
-		for (const position of positions) result[position] = (await this.totalForPosition(position, resolvedRange))[0];
-		return result;
-	}
-	/** Returns one position's cumulative reward and the range's emitted reward pool. */
-	async totalForPosition(position, range) {
-		const head = await this.getHead();
-		this.assertPublishedRange(range, head);
-		if (head.positionCount === 0) return [asAttoXL1$1(0n), asAttoXL1$1(0n)];
-		this.assertPosition(position, head);
-		if (range[0] === 0 && range[1] >= head.processedThroughBlock) {
-			const snapshot = await this.getSnapshot(head);
-			return [asAttoXL1$1(BigInt(snapshot.positionRewards[String(position)] ?? "0")), asAttoXL1$1(BigInt(snapshot.totalReward))];
-		}
-		const steps = await this.stepsForRange(range, head);
-		return [asAttoXL1$1(steps.reduce((sum, step) => sum + BigInt(step.positionRewards[String(position)] ?? "0"), 0n)), asAttoXL1$1(steps.reduce((sum, step) => sum + BigInt(step.totalReward), 0n))];
-	}
-	/** Returns the emitted reward pool for one indexed step. */
-	async totalForStep(step) {
-		const head = await this.getHead();
-		this.assertPublishedStep(step, head);
-		return asAttoXL1$1(BigInt((await this.getStep(step)).totalReward));
-	}
-	/** Returns one position's allocation and emitted pool for one indexed step. */
-	async totalForStepForPosition(step, position) {
-		const head = await this.getHead();
-		this.assertPosition(position, head);
-		this.assertPublishedStep(step, head);
-		const record = await this.getStep(step);
-		return [asAttoXL1$1(BigInt(record.positionRewards[String(position)] ?? "0")), asAttoXL1$1(BigInt(record.totalReward))];
-	}
-	/** Unclaimed rewards require redemption state and are not part of this index. */
-	unclaimed(_options) {
-		throw new Error("Method [unclaimed] not implemented.");
-	}
-	assertPosition(position, head) {
-		assertEx$1(Number.isSafeInteger(position) && position >= 0 && position < head.positionCount, () => `Position ${position} is outside rewards index positionCount ${head.positionCount}`);
-	}
-	assertPublishedRange(range, head) {
-		assertEx$1(range[1] <= head.processedThroughBlock, () => `Reward range ends at ${range[1]}, beyond index watermark ${head.processedThroughBlock}`);
-	}
-	assertPublishedStep(step, head) {
-		assertEx$1(step.block <= head.processedThroughBlock, () => `Reward step ${step.block}|${step.step} is beyond index watermark ${head.processedThroughBlock}`);
-	}
-	async fetchJson(path) {
-		const response = await this.fetchFn(`${this.baseUrl.replace(/\/$/, "")}/${path}`);
-		if (!response.ok) throw new Error(`Network stake rewards index request failed [${response.status}] for ${path}`);
-		return await response.json();
-	}
-	async getHead() {
-		const now = Date.now();
-		const elapsed = this.lastSuccessfulHeadAt === void 0 ? void 0 : now - this.lastSuccessfulHeadAt;
-		if (this.currentHead !== void 0 && elapsed !== void 0 && elapsed >= 0 && elapsed < this.headPollIntervalMs) return this.currentHead;
-		this.headPromise ??= this.syncHead().finally(() => {
-			this.headPromise = void 0;
-		});
-		return await this.headPromise;
-	}
-	async getManifest() {
-		this.manifestPromise ??= this.fetchJson(networkStakeRewardsIndexManifestPath(this.policyId)).then((value) => asNetworkStakeRewardsIndexManifest(value, true)).catch((error) => {
-			this.manifestPromise = void 0;
-			throw error;
-		});
-		return await this.manifestPromise;
-	}
-	async getSnapshot(head) {
-		const { snapshotHash } = head;
-		let promise = this.snapshotPromises.get(snapshotHash);
-		if (promise === void 0) {
-			const path = networkStakeRewardsIndexSnapshotPath(this.policyId, snapshotHash);
-			promise = this.fetchJson(path).then(async (value) => {
-				const snapshot = asNetworkStakeRewardsIndexSnapshot(value, true);
-				assertEx$1(await PayloadBuilder$1.hash(snapshot) === snapshotHash, () => `Rewards snapshot hash mismatch: ${path}`);
-				return snapshot;
-			});
-			this.snapshotPromises.set(snapshotHash, promise);
-		}
-		try {
-			const snapshot = await promise;
-			assertEx$1(snapshot.policyId === this.policyId, () => "Rewards snapshot policy mismatch");
-			assertEx$1(snapshot.stepCount === head.stepCount, () => "Rewards snapshot step count mismatch");
-			return snapshot;
-		} catch (error) {
-			this.snapshotPromises.delete(snapshotHash);
-			throw error;
-		}
-	}
-	async getStep(step) {
-		const path = networkStakeRewardsIndexStepPath(this.policyId, step);
-		let promise = this.stepPromises.get(path);
-		if (promise === void 0) {
-			promise = this.fetchJson(path).then((value) => asNetworkStakeRewardsIndexStep(value, true));
-			this.stepPromises.set(path, promise);
-		}
-		try {
-			const record = await promise;
-			assertEx$1(record.policyId === this.policyId, () => "Rewards step policy mismatch");
-			assertEx$1(record.step.block === step.block && record.step.step === step.step, () => "Rewards step identity mismatch");
-			return record;
-		} catch (error) {
-			this.stepPromises.delete(path);
-			throw error;
-		}
-	}
-	async stepsForRange(range, head) {
-		const steps = blockRangeSteps(range, (await this.getManifest()).stepLevels).filter((step) => step.block <= head.processedThroughBlock);
-		return await Promise.all(steps.map(async (step) => await this.getStep(step)));
-	}
-	async syncHead() {
-		assertEx$1((await this.getManifest()).policyId === this.policyId, () => "Rewards manifest policy mismatch");
-		const head = asNetworkStakeRewardsIndexHead(await this.fetchJson(networkStakeRewardsIndexHeadPath(this.policyId)), true);
-		assertEx$1(head.policyId === this.policyId, () => "Rewards head policy mismatch");
-		this.currentHead = head;
-		this.lastSuccessfulHeadAt = Date.now();
-		return head;
-	}
-};
-__publicField$3(RestNetworkStakeStepRewardsByPositionViewer, "connectionTypes", ["rest"]);
-__publicField$3(RestNetworkStakeStepRewardsByPositionViewer, "defaultMoniker", NetworkStakeStepRewardsByPositionViewerMoniker$1);
-__publicField$3(RestNetworkStakeStepRewardsByPositionViewer, "dependencies", []);
-__publicField$3(RestNetworkStakeStepRewardsByPositionViewer, "monikers", [NetworkStakeStepRewardsByPositionViewerMoniker$1]);
-__publicField$3(RestNetworkStakeStepRewardsByPositionViewer, "surface", "node");
-RestNetworkStakeStepRewardsByPositionViewer = __decorateClass$3([creatableProvider$1()], RestNetworkStakeStepRewardsByPositionViewer);
 //#endregion
-//#region ../../node_modules/.pnpm/@xyo-network+xl1-s3-providers@5.2.3_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@_4205ae6dac1e18bd0f69855afce06c53/node_modules/@xyo-network/xl1-s3-providers/dist/node/index.mjs
+//#region ../../node_modules/.pnpm/@xyo-network+xl1-s3-providers@5.3.1_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@_ce56e55bbf1d84b2b77d13465e8b0d29/node_modules/@xyo-network/xl1-s3-providers/dist/node/index.mjs
 var __defProp$2 = Object.defineProperty;
 var __getOwnPropDesc$2 = Object.getOwnPropertyDescriptor;
 var __defNormalProp$2 = (obj, key, value) => key in obj ? __defProp$2(obj, key, {
@@ -246045,6 +247043,7 @@ async function initFinalizationArchivistIfNeeded(archivist, config, account, opt
 		const genesisAccount = await Account$1.random();
 		const chainId2 = possibleChainId ?? toAddress(genesisAccount.address);
 		possibleChainId = chainId2;
+		options.logger?.info(`No head found in chain store \u2014 creating genesis block for chain [${chainId2}]`);
 		if (!config.chain.genesisRewardAddress) {
 			const accounts = await buildInsecureGenesisRewardAccounts();
 			options.logger?.warn(formatInsecureGenesisRewardWarning(accounts));
@@ -246061,23 +247060,16 @@ function ownStoreArchivist(runtimeResourceOwner, lease) {
 	runtimeResourceOwner.add(async () => await lease.release());
 	return lease.archivist;
 }
-var DEFAULT_LMDB_CONNECTION2 = "local-store";
-var DEFAULT_MONGO_CONNECTION = "chain-mongo";
-function isStoreConnectionType(type) {
-	return type === "lmdb" || type === "mongo";
-}
-function isBindableStoreType(type) {
-	return isStoreConnectionType(type) || type === "memory";
-}
 function storeConnectionName(connections) {
 	const profiles = connections;
-	const localStore = profiles[DEFAULT_LMDB_CONNECTION2];
-	if (localStore !== void 0 && isBindableStoreType(localStore.type)) return DEFAULT_LMDB_CONNECTION2;
-	if (profiles[DEFAULT_MONGO_CONNECTION]?.type === "mongo") return DEFAULT_MONGO_CONNECTION;
+	const localStore = profiles[DEFAULT_LMDB_CONNECTION$1];
+	if (localStore !== void 0 && isBindableStoreType(localStore.type)) return DEFAULT_LMDB_CONNECTION$1;
+	if (profiles["chain-mongo"]?.type === "mongo") return DEFAULT_MONGO_CONNECTION;
+	for (const [name, connection] of Object.entries(profiles)) if (isStoreConnectionType(connection.type)) return name;
 	for (const [name, connection] of Object.entries(profiles)) if (isBindableStoreType(connection.type)) return name;
 }
 function shouldSkipLocalNodeBoot(config) {
-	return resolveStoreConnection(config) === void 0;
+	return localChainStoreConnectionName(config.connections ?? {}) === void 0;
 }
 function resolveStoreConnection(config) {
 	const profiles = connectionProfiles(config);
@@ -246676,7 +247668,7 @@ async function tryParseConfig(options) {
 	return finalize ? finalizeConfig(section) : section;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@xyo-network+xl1-system-status@5.2.3_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod_c6ee099c6748fee22caff53c55e7c439/node_modules/@xyo-network/xl1-system-status/dist/node/index.mjs
+//#region ../../node_modules/.pnpm/@xyo-network+xl1-system-status@5.3.1_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod_53421f1300494c9cc1ceb6d1caea9317/node_modules/@xyo-network/xl1-system-status/dist/node/index.mjs
 function resolveStatusProbe(status, url) {
 	switch (url) {
 		case "/healthz": {
@@ -247860,8 +248852,8 @@ $0 <command> [options]`).parserConfiguration({
 		}
 	}).help().alias("help", "h").version(fullVersion2);
 }
-var version = isDefined$1("5.1.1") ? "5.1.1" : "unknown";
-var gitHash = isDefined$1("ff4b080df") ? "ff4b080df" : "";
+var version = isDefined$1("5.2.0") ? "5.2.0" : "unknown";
+var gitHash = isDefined$1("eb511295a") ? "eb511295a" : "";
 var fullVersion = gitHash.length > 0 ? `${version} (${gitHash})` : version;
 var mapXl1CliFailure = createSysExitFailureMapper();
 var defaultDependencies2 = {