@xyo-network/xl1-cli 5.2.1 → 5.2.2

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.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
+//#region ../../node_modules/.pnpm/@xyo-network+xl1-protocol@5.3.3_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@4.4._ff2a6e59f51e5daef4ffb30e331f5092/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.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
+//#region ../../node_modules/.pnpm/@xyo-network+xl1-protocol@5.3.3_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@4.4._ff2a6e59f51e5daef4ffb30e331f5092/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 });
 }
@@ -67512,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.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
+//#region ../../node_modules/.pnpm/@xyo-network+xl1-protocol@5.3.3_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@4.4._ff2a6e59f51e5daef4ffb30e331f5092/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>";
@@ -68162,7 +68162,7 @@ function admissionShadowHeadPath() {
 	return "admission/shadow/head.json";
 }
 //#endregion
-//#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
+//#region ../../node_modules/.pnpm/@xyo-network+xl1-protocol@5.3.3_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@4.4._ff2a6e59f51e5daef4ffb30e331f5092/node_modules/@xyo-network/xl1-protocol/dist/neutral/schema.mjs
 var asRequiredStrings = (required) => {
 	if (typeof required === "string") return [required];
 	if (!Array.isArray(required)) return [];
@@ -68398,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.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
+//#region ../../node_modules/.pnpm/@xyo-network+xl1-protocol@5.3.3_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@4.4._ff2a6e59f51e5daef4ffb30e331f5092/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);
@@ -68644,7 +68644,7 @@ var validateTransaction = async (context, tx, additionalValidators) => {
 	}
 };
 //#endregion
-//#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
+//#region ../../node_modules/.pnpm/@xyo-network+xl1-sdk@5.3.3_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@4.4.3__@o_d8f0054b13f6e551673802e6b9e450ca/node_modules/@xyo-network/xl1-sdk/dist/neutral/driver-memory.mjs
 var LruCacheMap$1 = class {
 	lruCache;
 	/** Creates an instance with the supplied configuration. */
@@ -71828,7 +71828,7 @@ var require_ExplorerSync = /* @__PURE__ */ __commonJSMin(((exports) => {
 	exports.ExplorerSync = ExplorerSync;
 }));
 //#endregion
-//#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
+//#region ../../node_modules/.pnpm/@xyo-network+xl1-sdk@5.3.3_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@4.4.3__@o_d8f0054b13f6e551673802e6b9e450ca/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;
@@ -73036,6 +73036,41 @@ async function hydratedBlockByNumber$1(context, blockNumber) {
 		timeBudgetLimit: 500
 	});
 }
+function blockLabel$1(block, hash) {
+	return `block ${block} [${hash}]`;
+}
+function headLabel$1(head) {
+	return `finalized head ${head.block} [${head.hash}]`;
+}
+function transactionCount$1(hashes) {
+	const count = hashes?.length ?? 0;
+	return `${count} transaction${count === 1 ? "" : "s"}`;
+}
+function transactionList$1(hashes) {
+	return hashes !== void 0 && hashes.length > 0 ? ` (tx ${hashes.join(", ")})` : "";
+}
+var DESCRIPTIONS$1 = {
+	"behind-finalized-head": ({ blockHash, blockNumber, finalizedHead }) => `candidate ${blockLabel$1(blockNumber, blockHash)} is at or below ${headLabel$1(finalizedHead)} \u2014 the head advanced past it while it was being built, so it can no longer be appended`,
+	"block-number-mismatch": ({ blockHash, blockNumber, candidateBase, finalizedHead }) => `candidate ${blockLabel$1(blockNumber, blockHash)} starts at block ${candidateBase?.block} but the block after ${headLabel$1(finalizedHead)} must be ${finalizedHead.block + 1} \u2014 it was built on a different head`,
+	"previous-hash-mismatch": ({ blockHash, blockNumber, candidateBase, finalizedHead }) => `candidate ${blockLabel$1(blockNumber, blockHash)} links to previous ${candidateBase?.previous} instead of ${headLabel$1(finalizedHead)} \u2014 it was built on a superseded or competing head`,
+	"tx-already-finalized": ({ blockHash, blockNumber, finalizedHead, offendingTransactionHashes, windowStartBlockNumber }) => `candidate ${blockLabel$1(blockNumber, blockHash)} carries ${transactionCount$1(offendingTransactionHashes)} already included in a finalized block within ${windowStartBlockNumber}..${finalizedHead.block} \u2014 its pending-transaction view was stale; exclude ${(offendingTransactionHashes?.length ?? 0) === 1 ? "it" : "them"} and rebuild` + transactionList$1(offendingTransactionHashes),
+	"tx-before-window": ({ blockHash, blockNumber, finalizedHead, offendingTransactionHashes, windowStartBlockNumber }) => `candidate ${blockLabel$1(blockNumber, blockHash)} carries ${transactionCount$1(offendingTransactionHashes)} whose nbf precedes the finalized window ${windowStartBlockNumber}..${finalizedHead.block}, so inclusion in an earlier block cannot be ruled out` + transactionList$1(offendingTransactionHashes)
+};
+function describeUncleRejection$1(rejection) {
+	return `${DESCRIPTIONS$1[rejection.reason](rejection)} [${rejection.reason}]`;
+}
+function describeUncleOutcome$1(finalizedChain, candidates, uncles, rejections) {
+	const head = finalizedChain.at(-1)?.[0];
+	const against = head === void 0 ? "the finalized head" : headLabel$1({
+		block: head.block,
+		hash: head._hash
+	});
+	const checked = `${candidates.length} candidate block${candidates.length === 1 ? "" : "s"} checked`;
+	if (uncles.length === 0) return `No candidate block can be appended to ${against} (${checked}): ${rejections.length > 0 ? rejections.map((rejection) => describeUncleRejection$1(rejection)).join("; ") : candidates.length === 0 ? "no candidate blocks were supplied" : "the candidate blocks do not form a contiguous chain"}`;
+	if (uncles.length === 1) return `Exactly one candidate chain extends ${against} (${checked})`;
+	const tips = uncles.map((chain) => chain.at(-1)?.[0]).filter(exists$1).map((tip) => blockLabel$1(tip.block, tip._hash)).join(", ");
+	return `${uncles.length} competing candidate chains extend ${against} (${checked}; tips ${tips}) \u2014 state validation needs exactly one chain, so none was validated`;
+}
 function getProducerKey(block) {
 	return block[0].addresses.toSorted((a, b) => a.localeCompare(b)).join(",");
 }
@@ -73083,15 +73118,25 @@ function toValidUncle$1(_context, finalizedWindowedChain, possibleUncle, onRejec
 	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 prunedPossibleUncle = possibleUncle.filter((b) => b[0].block > finalizedHead[0].block);
+	const base = prunedPossibleUncle.at(0);
 	const reject = (reason, offendingTransactionHashes) => {
 		onReject?.({
 			blockHash: tip[0]._hash,
 			blockNumber: tip[0].block,
+			candidateBase: base === void 0 ? void 0 : {
+				block: base[0].block,
+				previous: base[0].previous
+			},
+			finalizedHead: {
+				block: finalizedHead[0].block,
+				hash: finalizedHead[0]._hash
+			},
 			offendingTransactionHashes,
-			reason
+			reason,
+			windowStartBlockNumber: finalizedWindowStartBlockNumber
 		});
 	};
-	const prunedPossibleUncle = possibleUncle.filter((b) => b[0].block > finalizedHead[0].block);
 	if (prunedPossibleUncle.length === 0) {
 		reject("behind-finalized-head");
 		return;
@@ -75313,8 +75358,8 @@ var SimpleBlockValidationViewer$1 = class extends AbstractCreatableProvider$1 {
 		const rejections = [];
 		const uncles = findUncles$1(this.context, windowedUncleChain, blocks, (rejection) => rejections.push(rejection));
 		if (uncles.length !== 1) {
-			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}` : ""));
+			const outcome = describeUncleOutcome$1(windowedUncleChain, blocks, uncles, rejections);
+			this.logger?.warn(outcome);
 			this.logger?.debug(JSON.stringify({
 				uncles,
 				blocks: blocks.length
@@ -75323,12 +75368,13 @@ var SimpleBlockValidationViewer$1 = class extends AbstractCreatableProvider$1 {
 			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}`, {
+				if (rejection && offendingTransactionHashes.length > 0) return offendingTransactionHashes.map((txHash) => new HydratedBlockValidationError$1(txHash, block, `Candidate rejected during state validation: ${describeUncleRejection$1(rejection)}`, {
 					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}` : ""}`, {
+				const message = rejection ? `Candidate rejected during state validation: ${describeUncleRejection$1(rejection)}` : `Candidate not validated: ${outcome}`;
+				return [new HydratedBlockValidationError$1(block[0]._hash, block, message, {
 					reason: rejection?.reason,
 					uncles: uncles.length,
 					blocks: blocks.length
@@ -82239,7 +82285,7 @@ function getOriginalId$1(rawRequest) {
 	return [void 0, false];
 }
 //#endregion
-//#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
+//#region ../../node_modules/.pnpm/@xyo-network+xl1-sdk@5.3.3_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@4.4.3__@o_d8f0054b13f6e551673802e6b9e450ca/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, {
@@ -82525,6 +82571,16 @@ var NetworkStakingStepRewardsByPositionViewerRpcSchemas$1 = {
 			from: /* @__PURE__ */ pipe$1(JsonToBigIntZod, /* @__PURE__ */ transform$1((val) => asAttoXL1$1(val)))
 		}
 	},
+	networkStakingStepRewardsByPositionViewer_allocationsForStep: {
+		params: {
+			to: /* @__PURE__ */ tuple$1([StepIdentityZod$1]),
+			from: /* @__PURE__ */ tuple$1([StepIdentityZod$1])
+		},
+		result: {
+			to: /* @__PURE__ */ record$2(/* @__PURE__ */ number$5(), BigIntToJsonZod),
+			from: /* @__PURE__ */ record$2(/* @__PURE__ */ number$5(), /* @__PURE__ */ pipe$1(JsonToBigIntZod, /* @__PURE__ */ transform$1((val) => asAttoXL1$1(val))))
+		}
+	},
 	networkStakingStepRewardsByPositionViewer_totalForStepForPosition: {
 		params: {
 			to: /* @__PURE__ */ tuple$1([StepIdentityZod$1, /* @__PURE__ */ number$5()]),
@@ -83210,6 +83266,16 @@ var XyoViewerRpcSchemas$1 = {
 			from: /* @__PURE__ */ pipe$1(JsonToBigIntZod, /* @__PURE__ */ transform$1((val) => asAttoXL1$1(val)))
 		}
 	},
+	xyoViewer_networkStakeStepRewardAllocationsForStep: {
+		params: {
+			to: /* @__PURE__ */ tuple$1([StepIdentityZod$1]),
+			from: /* @__PURE__ */ tuple$1([StepIdentityZod$1])
+		},
+		result: {
+			to: /* @__PURE__ */ record$2(/* @__PURE__ */ number$5(), BigIntToJsonZod),
+			from: /* @__PURE__ */ record$2(/* @__PURE__ */ number$5(), /* @__PURE__ */ pipe$1(JsonToBigIntZod, /* @__PURE__ */ transform$1((val) => asAttoXL1$1(val))))
+		}
+	},
 	xyoViewer_networkStakeStepRewardRandomizer: {
 		params: {
 			to: /* @__PURE__ */ tuple$1([StepIdentityZod$1]),
@@ -83474,6 +83540,28 @@ tuple([object$3({
 	id: string$2(),
 	payloads: array$1(union$1([PayloadZodLoose$1, JsonToArrayBufferZod2$1]))
 })]), union$1([PayloadZodLoose$1, ArrayBufferToJsonZod$1]), union$1([PayloadZodLoose$1, JsonToArrayBufferZod2$1]);
+function trimTrailingNull$1(params) {
+	let end = params.length;
+	while (end > 0 && params[end - 1] === null) end--;
+	return params.slice(0, end);
+}
+function parseRpcRequest$1(requestSchema, request) {
+	const parsed = requestSchema.safeParse(request);
+	if (parsed.success || !isObject$5(request)) return parsed;
+	const { params } = request;
+	if (!Array.isArray(params) || params.at(-1) !== null) return parsed;
+	const retried = requestSchema.safeParse({
+		...request,
+		params: trimTrailingNull$1(params)
+	});
+	return retried.success ? retried : parsed;
+}
+function trimTrailingUndefined$1(params) {
+	if (!Array.isArray(params)) return params;
+	let end = params.length;
+	while (end > 0 && params[end - 1] === void 0) end--;
+	return end === params.length ? params : params.slice(0, end);
+}
 var HttpRpcTransport$1 = class {
 	_passThrough;
 	_rpcUrl;
@@ -83497,7 +83585,7 @@ var HttpRpcTransport$1 = class {
 			};
 			const schema = schemas[method];
 			if (params !== void 0) {
-				body.params = isDefined$1(schema) ? schema.params.to.parse(params) : this._passThrough ? (/* @__PURE__ */ json$3()).parse(params) : void 0;
+				body.params = isDefined$1(schema) ? trimTrailingUndefined$1(schema.params.to.parse(params)) : this._passThrough ? (/* @__PURE__ */ json$3()).parse(trimTrailingUndefined$1(params)) : void 0;
 				if (!isDefined$1(body.params)) throw new Error(`[callRpc] RPC method ${String(method)} missing schema`);
 			}
 			body.params ??= [];
@@ -83918,6 +84006,10 @@ JsonRpcMempoolViewer$1 = __decorateClass$25([creatableProvider$1()], JsonRpcMemp
 var JsonRpcNetworkStakeStepRewardsByPositionViewerMethods$1 = class extends AbstractJsonRpcViewer$1 {
 	/** Moniker implemented by this provider instance. */
 	moniker = NetworkStakeStepRewardsByPositionViewerMoniker$1;
+	/** Per-position allocations for one completed step. */
+	async allocationsForStep(step) {
+		return await this.transport.sendRequest("networkStakingStepRewardsByPositionViewer_allocationsForStep", [step]);
+	}
 	/** Returns the bonus result exposed by this provider. */
 	async bonus(options) {
 		return await this.transport.sendRequest("networkStakingStepRewardsByPositionViewer_bonus", [options]);
@@ -84528,6 +84620,10 @@ var JsonRpcXyoViewer$1 = class extends AbstractJsonRpcViewer$1 {
 	async networkStakeStepRewardAddressShare(context, address) {
 		return await this.transport.sendRequest("xyoViewer_networkStakeStepRewardAddressShare", [context, address]);
 	}
+	/** Per-position allocations for one completed step. */
+	async networkStakeStepRewardAllocationsForStep(context) {
+		return await this.transport.sendRequest("xyoViewer_networkStakeStepRewardAllocationsForStep", [context]);
+	}
 	/** Returns the network stake step reward claimed by address result exposed by this provider. */
 	async networkStakeStepRewardClaimedByAddress(address) {
 		return await this.transport.sendRequest("xyoViewer_networkStakeStepRewardClaimedByAddress", [address]);
@@ -84766,7 +84862,7 @@ var createRpcDispatchMiddleware = (schemas, handlers, options) => async ({ reque
 		requestSchema = createRequestSchema$1(method, schema.params.from);
 		requestSchemas$1[method] = requestSchema;
 	}
-	const parsed = requestSchema.safeParse(request);
+	const parsed = parseRpcRequest$1(requestSchema, request);
 	if (!parsed.success) {
 		options?.logger?.error("RPC Request Validation Error", parsed.error);
 		throw new Error(parsed.error.message);
@@ -84781,7 +84877,7 @@ var createRpcDispatchMiddleware = (schemas, handlers, options) => async ({ reque
 	}
 };
 //#endregion
-//#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
+//#region ../../node_modules/.pnpm/@xyo-network+xl1-sdk@5.3.3_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@4.4.3__@o_d8f0054b13f6e551673802e6b9e450ca/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, {
@@ -105444,7 +105540,7 @@ var StakedXyoChainV2__factory = class extends ContractFactory {
 	}
 };
 //#endregion
-//#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
+//#region ../../node_modules/.pnpm/@xyo-network+xl1-sdk@5.3.3_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@4.4.3__@o_d8f0054b13f6e551673802e6b9e450ca/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, {
@@ -106422,6 +106518,18 @@ var RestNetworkStakeStepRewardsByPositionViewer$1 = class extends AbstractCreata
 	get fetchFn() {
 		return this.context.fetchFn ?? fetch.bind(globalThis);
 	}
+	/** Per-position allocations for one completed step from the durable index record. */
+	async allocationsForStep(step) {
+		const head = await this.getHead();
+		this.assertPublishedStep(step, head);
+		const record = await this.getStep(step);
+		const result = {};
+		for (const [positionId, amount] of Object.entries(record.positionRewards)) {
+			const reward = asAttoXL1$1(BigInt(amount));
+			if (reward > 0n) result[Number(positionId)] = reward;
+		}
+		return result;
+	}
 	/** Returns the policy bonus. The unmultiplied-v1 index has no multipliers, so bonus is zero. */
 	async bonus(options = {}) {
 		const total = await this.total(options);
@@ -106913,6 +107021,18 @@ var SimpleStepRewardsByPositionViewer$1 = class extends AbstractCreatableProvide
 	get stakeViewer() {
 		return this._stakeViewer;
 	}
+	/** Per-position allocations for one completed step (compute path). */
+	async allocationsForStep(step) {
+		const externalRange = await externalBlockRangeFromStep(this.context, this.blockViewer, step, this.timeAnchor);
+		const positionCount = await this.stakeViewer.stakeEvents.positionCount(externalRange);
+		if (positionCount === 0) return {};
+		const positions = await this.loadPositions(positionCount);
+		const eventsByPosition = indexStakeEventsByPosition$1(await this.stakeViewer.stakeEvents.stakeEvents([0, externalRange[1]]));
+		const computed = await networkStakeStepRewardsForPositions$1(this.context, this.blockViewer, step, positions, eventsByPosition, this.rewardMultipliers, this.timeAnchor, externalRange);
+		const result = {};
+		for (const [positionId, amount] of computed.positionRewards) if (amount > 0n) result[positionId] = amount;
+		return result;
+	}
 	/** Returns the bonus result exposed by this provider. */
 	async bonus({ range, positions } = {}) {
 		const total = await this.total({
@@ -107659,6 +107779,10 @@ var SimpleXyoViewer$1 = class extends AbstractCreatableProvider$1 {
 	networkStakeStepRewardAddressShare(_context, _address) {
 		throw new Error("Method [networkStakeStepRewardAddressShare] not implemented.");
 	}
+	/** Per-position allocations for one completed step (`positionId → reward`). */
+	async networkStakeStepRewardAllocationsForStep(stepIdentity) {
+		return await this.networkStepRewardsByPositionViewer.allocationsForStep(stepIdentity);
+	}
 	/** Returns the network stake step reward claimed by address result exposed by this provider. */
 	networkStakeStepRewardClaimedByAddress(_address) {
 		throw new Error("Method [networkStakeStepRewardClaimedByAddress] not implemented.");
@@ -107968,7 +108092,7 @@ __publicField$22(RestChainParamsViewer$1, "monikers", [ChainParamsViewerMoniker]
 __publicField$22(RestChainParamsViewer$1, "surface", "node");
 RestChainParamsViewer$1 = __decorateClass$23([creatableProvider$1()], RestChainParamsViewer$1);
 //#endregion
-//#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
+//#region ../../node_modules/.pnpm/@xyo-network+xl1-sdk@5.3.3_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@4.4.3__@o_d8f0054b13f6e551673802e6b9e450ca/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);
@@ -107995,7 +108119,7 @@ async function witnessPreviousStep(gateway, options) {
 	return { witness };
 }
 //#endregion
-//#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
+//#region ../../node_modules/.pnpm/@xyo-network+xl1-sdk@5.3.3_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@4.4.3__@o_d8f0054b13f6e551673802e6b9e450ca/node_modules/@xyo-network/xl1-sdk/dist/neutral/wrappers.mjs
 function parseHexOrBigInt(value) {
 	return AttoXL1$1(typeof value === "bigint" ? value : hexToBigInt(value));
 }
@@ -116356,7 +116480,7 @@ __publicField$19(MemoryArchivist, "labels", {
 });
 MemoryArchivist = __decorateClass$19([creatableModule()], MemoryArchivist);
 //#endregion
-//#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
+//#region ../../node_modules/.pnpm/@xyo-network+xl1-protocol@5.3.3_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@4.4._2ed50aef22cdff8a2ce2a77e44721cb3/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 */
@@ -117356,7 +117480,7 @@ new import_ajv.Ajv({
 	strict: true
 });
 //#endregion
-//#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
+//#region ../../node_modules/.pnpm/@xyo-network+xl1-sdk@5.3.3_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@4.4.3__@o_549107f828095a76ec89d9dd63b02b3d/node_modules/@xyo-network/xl1-sdk/dist/neutral/driver-memory.mjs
 var LruCacheMap = class {
 	lruCache;
 	/** Creates an instance with the supplied configuration. */
@@ -117438,7 +117562,7 @@ var MemoryMap = class {
 	}
 };
 //#endregion
-//#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
+//#region ../../node_modules/.pnpm/@xyo-network+xl1-sdk@5.3.3_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@4.4.3__@o_549107f828095a76ec89d9dd63b02b3d/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, {
@@ -118286,6 +118410,41 @@ async function hydratedBlockByNumber(context, blockNumber) {
 		timeBudgetLimit: 500
 	});
 }
+function blockLabel(block, hash) {
+	return `block ${block} [${hash}]`;
+}
+function headLabel(head) {
+	return `finalized head ${head.block} [${head.hash}]`;
+}
+function transactionCount(hashes) {
+	const count = hashes?.length ?? 0;
+	return `${count} transaction${count === 1 ? "" : "s"}`;
+}
+function transactionList(hashes) {
+	return hashes !== void 0 && hashes.length > 0 ? ` (tx ${hashes.join(", ")})` : "";
+}
+var DESCRIPTIONS = {
+	"behind-finalized-head": ({ blockHash, blockNumber, finalizedHead }) => `candidate ${blockLabel(blockNumber, blockHash)} is at or below ${headLabel(finalizedHead)} \u2014 the head advanced past it while it was being built, so it can no longer be appended`,
+	"block-number-mismatch": ({ blockHash, blockNumber, candidateBase, finalizedHead }) => `candidate ${blockLabel(blockNumber, blockHash)} starts at block ${candidateBase?.block} but the block after ${headLabel(finalizedHead)} must be ${finalizedHead.block + 1} \u2014 it was built on a different head`,
+	"previous-hash-mismatch": ({ blockHash, blockNumber, candidateBase, finalizedHead }) => `candidate ${blockLabel(blockNumber, blockHash)} links to previous ${candidateBase?.previous} instead of ${headLabel(finalizedHead)} \u2014 it was built on a superseded or competing head`,
+	"tx-already-finalized": ({ blockHash, blockNumber, finalizedHead, offendingTransactionHashes, windowStartBlockNumber }) => `candidate ${blockLabel(blockNumber, blockHash)} carries ${transactionCount(offendingTransactionHashes)} already included in a finalized block within ${windowStartBlockNumber}..${finalizedHead.block} \u2014 its pending-transaction view was stale; exclude ${(offendingTransactionHashes?.length ?? 0) === 1 ? "it" : "them"} and rebuild` + transactionList(offendingTransactionHashes),
+	"tx-before-window": ({ blockHash, blockNumber, finalizedHead, offendingTransactionHashes, windowStartBlockNumber }) => `candidate ${blockLabel(blockNumber, blockHash)} carries ${transactionCount(offendingTransactionHashes)} whose nbf precedes the finalized window ${windowStartBlockNumber}..${finalizedHead.block}, so inclusion in an earlier block cannot be ruled out` + transactionList(offendingTransactionHashes)
+};
+function describeUncleRejection(rejection) {
+	return `${DESCRIPTIONS[rejection.reason](rejection)} [${rejection.reason}]`;
+}
+function describeUncleOutcome(finalizedChain, candidates, uncles, rejections) {
+	const head = finalizedChain.at(-1)?.[0];
+	const against = head === void 0 ? "the finalized head" : headLabel({
+		block: head.block,
+		hash: head._hash
+	});
+	const checked = `${candidates.length} candidate block${candidates.length === 1 ? "" : "s"} checked`;
+	if (uncles.length === 0) return `No candidate block can be appended to ${against} (${checked}): ${rejections.length > 0 ? rejections.map((rejection) => describeUncleRejection(rejection)).join("; ") : candidates.length === 0 ? "no candidate blocks were supplied" : "the candidate blocks do not form a contiguous chain"}`;
+	if (uncles.length === 1) return `Exactly one candidate chain extends ${against} (${checked})`;
+	const tips = uncles.map((chain) => chain.at(-1)?.[0]).filter(exists$1).map((tip) => blockLabel(tip.block, tip._hash)).join(", ");
+	return `${uncles.length} competing candidate chains extend ${against} (${checked}; tips ${tips}) \u2014 state validation needs exactly one chain, so none was validated`;
+}
 var DEFAULT_BACKOFF_MS = 12e4;
 function extendUncleChain(block, map) {
 	const uncle = [block];
@@ -118310,15 +118469,25 @@ 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 prunedPossibleUncle = possibleUncle.filter((b) => b[0].block > finalizedHead[0].block);
+	const base = prunedPossibleUncle.at(0);
 	const reject = (reason, offendingTransactionHashes) => {
 		onReject?.({
 			blockHash: tip[0]._hash,
 			blockNumber: tip[0].block,
+			candidateBase: base === void 0 ? void 0 : {
+				block: base[0].block,
+				previous: base[0].previous
+			},
+			finalizedHead: {
+				block: finalizedHead[0].block,
+				hash: finalizedHead[0]._hash
+			},
 			offendingTransactionHashes,
-			reason
+			reason,
+			windowStartBlockNumber: finalizedWindowStartBlockNumber
 		});
 	};
-	const prunedPossibleUncle = possibleUncle.filter((b) => b[0].block > finalizedHead[0].block);
 	if (prunedPossibleUncle.length === 0) {
 		reject("behind-finalized-head");
 		return;
@@ -119896,8 +120065,8 @@ var SimpleBlockValidationViewer = class extends AbstractCreatableProvider {
 		const rejections = [];
 		const uncles = findUncles(this.context, windowedUncleChain, blocks, (rejection) => rejections.push(rejection));
 		if (uncles.length !== 1) {
-			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}` : ""));
+			const outcome = describeUncleOutcome(windowedUncleChain, blocks, uncles, rejections);
+			this.logger?.warn(outcome);
 			this.logger?.debug(JSON.stringify({
 				uncles,
 				blocks: blocks.length
@@ -119906,12 +120075,13 @@ var SimpleBlockValidationViewer = class extends AbstractCreatableProvider {
 			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}`, {
+				if (rejection && offendingTransactionHashes.length > 0) return offendingTransactionHashes.map((txHash) => new HydratedBlockValidationError(txHash, block, `Candidate rejected during state validation: ${describeUncleRejection(rejection)}`, {
 					blockHash: rejection.blockHash,
 					hash: txHash,
 					reason: rejection.reason
 				}));
-				return [new HydratedBlockValidationError(block[0]._hash, block, `Unexpected uncle count during state validation${rejection ? `: ${rejection.reason}` : ""}`, {
+				const message = rejection ? `Candidate rejected during state validation: ${describeUncleRejection(rejection)}` : `Candidate not validated: ${outcome}`;
+				return [new HydratedBlockValidationError(block[0]._hash, block, message, {
 					reason: rejection?.reason,
 					uncles: uncles.length,
 					blocks: blocks.length
@@ -124133,7 +124303,7 @@ function getOriginalId(rawRequest) {
 	return [void 0, false];
 }
 //#endregion
-//#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
+//#region ../../node_modules/.pnpm/@xyo-network+xl1-sdk@5.3.3_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@4.4.3__@o_549107f828095a76ec89d9dd63b02b3d/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, {
@@ -124189,6 +124359,7 @@ var rpcMethodHandlersFromNetworkStakingStepRewardsByPositionViewer = (viewer) =>
 		networkStakingStepRewardsByPositionViewer_total: (params) => viewer.total(...params ?? []),
 		networkStakingStepRewardsByPositionViewer_totalForPosition: (params) => viewer.totalForPosition(...params),
 		networkStakingStepRewardsByPositionViewer_totalForStep: (params) => viewer.totalForStep(...params),
+		networkStakingStepRewardsByPositionViewer_allocationsForStep: (params) => viewer.allocationsForStep(...params),
 		networkStakingStepRewardsByPositionViewer_totalForStepForPosition: (params) => viewer.totalForStepForPosition(...params),
 		networkStakingStepRewardsByPositionViewer_unclaimed: (params) => viewer.unclaimed(...params ?? [])
 	};
@@ -124231,6 +124402,7 @@ var rpcMethodHandlersFromViewer = (viewer) => {
 		xyoViewer_networkStakeStepRewardPositionWeight: (params) => viewer.networkStakeStepRewardPositionWeight?.(...params ?? []),
 		xyoViewer_networkStakeStepRewardPotentialPositionLoss: (params) => viewer.networkStakeStepRewardPotentialPositionLoss?.(...params ?? []),
 		xyoViewer_networkStakeStepRewardForStep: (params) => viewer.networkStakeStepRewardForStep?.(...params ?? []),
+		xyoViewer_networkStakeStepRewardAllocationsForStep: (params) => viewer.networkStakeStepRewardAllocationsForStep?.(...params ?? []),
 		xyoViewer_networkStakeStepRewardRandomizer: (params) => viewer.networkStakeStepRewardRandomizer?.(...params ?? []),
 		xyoViewer_networkStakeStepRewardStakerCount: (params) => viewer.networkStakeStepRewardStakerCount?.(...params ?? []),
 		xyoViewer_networkStakeStepRewardForStepForPosition: (params) => viewer.networkStakeStepRewardForStepForPosition?.(...params ?? []),
@@ -124511,6 +124683,16 @@ var NetworkStakingStepRewardsByPositionViewerRpcSchemas = {
 			from: /* @__PURE__ */ pipe$1(JsonToBigIntZod, /* @__PURE__ */ transform$1((val) => asAttoXL1(val)))
 		}
 	},
+	networkStakingStepRewardsByPositionViewer_allocationsForStep: {
+		params: {
+			to: /* @__PURE__ */ tuple$1([StepIdentityZod]),
+			from: /* @__PURE__ */ tuple$1([StepIdentityZod])
+		},
+		result: {
+			to: /* @__PURE__ */ record$2(/* @__PURE__ */ number$5(), BigIntToJsonZod),
+			from: /* @__PURE__ */ record$2(/* @__PURE__ */ number$5(), /* @__PURE__ */ pipe$1(JsonToBigIntZod, /* @__PURE__ */ transform$1((val) => asAttoXL1(val))))
+		}
+	},
 	networkStakingStepRewardsByPositionViewer_totalForStepForPosition: {
 		params: {
 			to: /* @__PURE__ */ tuple$1([StepIdentityZod, /* @__PURE__ */ number$5()]),
@@ -125196,6 +125378,16 @@ var XyoViewerRpcSchemas = {
 			from: /* @__PURE__ */ pipe$1(JsonToBigIntZod, /* @__PURE__ */ transform$1((val) => asAttoXL1(val)))
 		}
 	},
+	xyoViewer_networkStakeStepRewardAllocationsForStep: {
+		params: {
+			to: /* @__PURE__ */ tuple$1([StepIdentityZod]),
+			from: /* @__PURE__ */ tuple$1([StepIdentityZod])
+		},
+		result: {
+			to: /* @__PURE__ */ record$2(/* @__PURE__ */ number$5(), BigIntToJsonZod),
+			from: /* @__PURE__ */ record$2(/* @__PURE__ */ number$5(), /* @__PURE__ */ pipe$1(JsonToBigIntZod, /* @__PURE__ */ transform$1((val) => asAttoXL1(val))))
+		}
+	},
 	xyoViewer_networkStakeStepRewardRandomizer: {
 		params: {
 			to: /* @__PURE__ */ tuple$1([StepIdentityZod]),
@@ -125460,6 +125652,28 @@ tuple([object$3({
 	id: string$2(),
 	payloads: array$1(union$1([PayloadZodLoose, JsonToArrayBufferZod2]))
 })]), union$1([PayloadZodLoose, ArrayBufferToJsonZod]), union$1([PayloadZodLoose, JsonToArrayBufferZod2]);
+function trimTrailingNull(params) {
+	let end = params.length;
+	while (end > 0 && params[end - 1] === null) end--;
+	return params.slice(0, end);
+}
+function parseRpcRequest(requestSchema, request) {
+	const parsed = requestSchema.safeParse(request);
+	if (parsed.success || !isObject$5(request)) return parsed;
+	const { params } = request;
+	if (!Array.isArray(params) || params.at(-1) !== null) return parsed;
+	const retried = requestSchema.safeParse({
+		...request,
+		params: trimTrailingNull(params)
+	});
+	return retried.success ? retried : parsed;
+}
+function trimTrailingUndefined(params) {
+	if (!Array.isArray(params)) return params;
+	let end = params.length;
+	while (end > 0 && params[end - 1] === void 0) end--;
+	return end === params.length ? params : params.slice(0, end);
+}
 var HttpRpcTransport = class {
 	_passThrough;
 	_rpcUrl;
@@ -125483,7 +125697,7 @@ var HttpRpcTransport = class {
 			};
 			const schema = schemas[method];
 			if (params !== void 0) {
-				body.params = isDefined$1(schema) ? schema.params.to.parse(params) : this._passThrough ? (/* @__PURE__ */ json$3()).parse(params) : void 0;
+				body.params = isDefined$1(schema) ? trimTrailingUndefined(schema.params.to.parse(params)) : this._passThrough ? (/* @__PURE__ */ json$3()).parse(trimTrailingUndefined(params)) : void 0;
 				if (!isDefined$1(body.params)) throw new Error(`[callRpc] RPC method ${String(method)} missing schema`);
 			}
 			body.params ??= [];
@@ -125904,6 +126118,10 @@ JsonRpcMempoolViewer = __decorateClass$17([creatableProvider()], JsonRpcMempoolV
 var JsonRpcNetworkStakeStepRewardsByPositionViewerMethods = class extends AbstractJsonRpcViewer {
 	/** Moniker implemented by this provider instance. */
 	moniker = NetworkStakeStepRewardsByPositionViewerMoniker;
+	/** Per-position allocations for one completed step. */
+	async allocationsForStep(step) {
+		return await this.transport.sendRequest("networkStakingStepRewardsByPositionViewer_allocationsForStep", [step]);
+	}
 	/** Returns the bonus result exposed by this provider. */
 	async bonus(options) {
 		return await this.transport.sendRequest("networkStakingStepRewardsByPositionViewer_bonus", [options]);
@@ -126514,6 +126732,10 @@ var JsonRpcXyoViewer = class extends AbstractJsonRpcViewer {
 	async networkStakeStepRewardAddressShare(context, address) {
 		return await this.transport.sendRequest("xyoViewer_networkStakeStepRewardAddressShare", [context, address]);
 	}
+	/** Per-position allocations for one completed step. */
+	async networkStakeStepRewardAllocationsForStep(context) {
+		return await this.transport.sendRequest("xyoViewer_networkStakeStepRewardAllocationsForStep", [context]);
+	}
 	/** Returns the network stake step reward claimed by address result exposed by this provider. */
 	async networkStakeStepRewardClaimedByAddress(address) {
 		return await this.transport.sendRequest("xyoViewer_networkStakeStepRewardClaimedByAddress", [address]);
@@ -126775,7 +126997,7 @@ var createValidationMiddleware = (schemas) => ({ request, context, next }) => {
 		requestSchema = createRequestSchema(request.method, schema.params.from);
 		requestSchemas[request.method] = requestSchema;
 	}
-	const parsed = requestSchema.safeParse(request);
+	const parsed = parseRpcRequest(requestSchema, request);
 	if (!parsed.success) throw new Error(parsed.error.message);
 	context.set("schema", schema);
 	context.set("params", parsed.data.params);
@@ -225452,7 +225674,7 @@ var BaseMongoSdk = class {
 	}
 };
 //#endregion
-//#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
+//#region ../../node_modules/.pnpm/@xyo-network+xl1-driver-mongodb@5.3.3_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zo_b41a198c42289d2824f3326456687c6d/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, {
@@ -230485,6 +230707,9 @@ var BaseNetworkStakeStepRewardService = class extends AbstractCreatableProvider$
 	networkStakeStepRewardAddressShare(_context, _address) {
 		throw new Error("Method [networkStakeStepRewardAddressShare] not implemented.");
 	}
+	networkStakeStepRewardAllocationsForStep(_context) {
+		throw new Error("Method [networkStakeStepRewardAllocationsForStep] not implemented.");
+	}
 	networkStakeStepRewardClaimedByAddress(_address) {
 		throw new Error("Method [networkStakeStepRewardClaimedByAddress] not implemented.");
 	}
@@ -241940,7 +242165,7 @@ function withDeprecationWarning$1(module, host, options = {}) {
 	return module;
 }
 //#endregion
-//#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
+//#region ../../node_modules/.pnpm/@xyo-network+xl1-sdk@5.3.3_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@4.4.3__@o_d8f0054b13f6e551673802e6b9e450ca/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, {
@@ -242918,6 +243143,18 @@ var RestNetworkStakeStepRewardsByPositionViewer = class extends AbstractCreatabl
 	get fetchFn() {
 		return this.context.fetchFn ?? fetch.bind(globalThis);
 	}
+	/** Per-position allocations for one completed step from the durable index record. */
+	async allocationsForStep(step) {
+		const head = await this.getHead();
+		this.assertPublishedStep(step, head);
+		const record = await this.getStep(step);
+		const result = {};
+		for (const [positionId, amount] of Object.entries(record.positionRewards)) {
+			const reward = asAttoXL1$1(BigInt(amount));
+			if (reward > 0n) result[Number(positionId)] = reward;
+		}
+		return result;
+	}
 	/** Returns the policy bonus. The unmultiplied-v1 index has no multipliers, so bonus is zero. */
 	async bonus(options = {}) {
 		const total = await this.total(options);
@@ -243409,6 +243646,18 @@ var SimpleStepRewardsByPositionViewer = class extends AbstractCreatableProvider$
 	get stakeViewer() {
 		return this._stakeViewer;
 	}
+	/** Per-position allocations for one completed step (compute path). */
+	async allocationsForStep(step) {
+		const externalRange = await externalBlockRangeFromStep(this.context, this.blockViewer, step, this.timeAnchor);
+		const positionCount = await this.stakeViewer.stakeEvents.positionCount(externalRange);
+		if (positionCount === 0) return {};
+		const positions = await this.loadPositions(positionCount);
+		const eventsByPosition = indexStakeEventsByPosition(await this.stakeViewer.stakeEvents.stakeEvents([0, externalRange[1]]));
+		const computed = await networkStakeStepRewardsForPositions(this.context, this.blockViewer, step, positions, eventsByPosition, this.rewardMultipliers, this.timeAnchor, externalRange);
+		const result = {};
+		for (const [positionId, amount] of computed.positionRewards) if (amount > 0n) result[positionId] = amount;
+		return result;
+	}
 	/** Returns the bonus result exposed by this provider. */
 	async bonus({ range, positions } = {}) {
 		const total = await this.total({
@@ -244155,6 +244404,10 @@ var SimpleXyoViewer = class extends AbstractCreatableProvider$1 {
 	networkStakeStepRewardAddressShare(_context, _address) {
 		throw new Error("Method [networkStakeStepRewardAddressShare] not implemented.");
 	}
+	/** Per-position allocations for one completed step (`positionId → reward`). */
+	async networkStakeStepRewardAllocationsForStep(stepIdentity) {
+		return await this.networkStepRewardsByPositionViewer.allocationsForStep(stepIdentity);
+	}
 	/** Returns the network stake step reward claimed by address result exposed by this provider. */
 	networkStakeStepRewardClaimedByAddress(_address) {
 		throw new Error("Method [networkStakeStepRewardClaimedByAddress] not implemented.");
@@ -244464,7 +244717,7 @@ __publicField$3(RestChainParamsViewer, "monikers", [ChainParamsViewerMoniker]);
 __publicField$3(RestChainParamsViewer, "surface", "node");
 RestChainParamsViewer = __decorateClass$3([creatableProvider$1()], RestChainParamsViewer);
 //#endregion
-//#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
+//#region ../../node_modules/.pnpm/@xyo-network+xl1-s3-providers@5.3.3_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod@_d1d2fde6ed1017438dbf810bb4a75181/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, {
@@ -247701,7 +247954,7 @@ async function tryParseConfig(options) {
 	return finalize ? finalizeConfig(section) : section;
 }
 //#endregion
-//#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
+//#region ../../node_modules/.pnpm/@xyo-network+xl1-system-status@5.3.3_@ariestools+sdk@8.1.9_@opentelemetry+api@1.9.1_zod_19e6693dd338050e1795f614861c0e57/node_modules/@xyo-network/xl1-system-status/dist/node/index.mjs
 function resolveStatusProbe(status, url) {
 	switch (url) {
 		case "/healthz": {
@@ -248885,8 +249138,8 @@ $0 <command> [options]`).parserConfiguration({
 		}
 	}).help().alias("help", "h").version(fullVersion2);
 }
-var version = isDefined$1("5.2.1") ? "5.2.1" : "unknown";
-var gitHash = isDefined$1("2708f0cd8") ? "2708f0cd8" : "";
+var version = isDefined$1("5.2.2") ? "5.2.2" : "unknown";
+var gitHash = isDefined$1("0eaaafa63") ? "0eaaafa63" : "";
 var fullVersion = gitHash.length > 0 ? `${version} (${gitHash})` : version;
 var mapXl1CliFailure = createSysExitFailureMapper();
 var defaultDependencies2 = {