@xyo-network/xl1-protocol-sdk 2.0.11 → 2.0.12

package/dist/neutral/index.mjs

@@ -1162,10 +1162,10 @@ import {
   zodIsFactory as zodIsFactory2,
   zodToFactory as zodToFactory2
 } from "@xylabs/sdk-js";
-import { globalRegistry as globalRegistry12, z as z17 } from "zod/mini";
+import { globalRegistry as globalRegistry13, z as z18 } from "zod/mini";
 
 // src/config/Base.ts
-import { z as z16 } from "zod/mini";
+import { z as z17 } from "zod/mini";
 
 // src/config/Chain.ts
 import { HexZod } from "@xylabs/sdk-js";
@@ -1370,11 +1370,47 @@ var MongoConfigZod = z12.object({
   })
 });
 
-// src/config/storage/Storage.ts
+// src/config/storage/driver/R2.ts
+import { isDefined as isDefined5, isUndefined as isUndefined6 } from "@xylabs/sdk-js";
 import { globalRegistry as globalRegistry9, z as z13 } from "zod";
-var StorageConfigZod = z13.object({
+var hasR2Config = (config) => {
+  if (isUndefined6(config)) return false;
+  return isDefined5(config.accountId) && isDefined5(config.accessKeyId) && isDefined5(config.secretAccessKey) && isDefined5(config.bucket);
+};
+var R2ConfigZod = z13.object({
+  accessKeyId: z13.string().nonempty().optional().register(globalRegistry9, {
+    description: "Cloudflare R2 access key id (from an R2 API token)",
+    title: "storage.r2.accessKeyId",
+    type: "string"
+  }),
+  accountId: z13.string().nonempty().optional().register(globalRegistry9, {
+    description: "Cloudflare account id; determines the R2 endpoint https://<accountId>.r2.cloudflarestorage.com",
+    title: "storage.r2.accountId",
+    type: "string"
+  }),
+  bucket: z13.string().nonempty().optional().register(globalRegistry9, {
+    description: "Cloudflare R2 bucket name",
+    title: "storage.r2.bucket",
+    type: "string"
+  }),
+  prefix: z13.string().nonempty().optional().register(globalRegistry9, {
+    description: "Optional key prefix namespacing this store within the bucket",
+    title: "storage.r2.prefix",
+    type: "string"
+  }),
+  secretAccessKey: z13.string().nonempty().optional().register(globalRegistry9, {
+    description: "Cloudflare R2 secret access key (from an R2 API token)",
+    title: "storage.r2.secretAccessKey",
+    type: "string"
+  })
+});
+
+// src/config/storage/Storage.ts
+import { globalRegistry as globalRegistry10, z as z14 } from "zod";
+var StorageConfigZod = z14.object({
   mongo: MongoConfigZod.optional().describe("Configuration for the MongoD storage driver"),
-  root: z13.string().optional().register(globalRegistry9, {
+  r2: R2ConfigZod.optional().describe("Configuration for the Cloudflare R2 storage driver"),
+  root: z14.string().optional().register(globalRegistry10, {
     description: "Root directory for local storage",
     title: "storage.root",
     type: "string"
@@ -1382,7 +1418,7 @@ var StorageConfigZod = z13.object({
 }).describe("Storage configuration options");
 
 // src/config/Telemetry.ts
-import { globalRegistry as globalRegistry10, z as z14 } from "zod";
+import { globalRegistry as globalRegistry11, z as z15 } from "zod";
 var DefaultMetricsScrapePorts = {
   api: 9465,
   bridge: 9468,
@@ -1390,29 +1426,29 @@ var DefaultMetricsScrapePorts = {
   producer: 9464,
   rewardRedemptionApi: 9467
 };
-var MetricsScrapeConfigZod = z14.object({
-  path: z14.string().default("/metrics").register(globalRegistry10, {
+var MetricsScrapeConfigZod = z15.object({
+  path: z15.string().default("/metrics").register(globalRegistry11, {
     default: "/metrics",
     description: "Path for the metrics scrape endpoint",
     title: "telemetry.metrics.scrape.path",
     type: "string"
   }),
-  port: z14.coerce.number().int().positive().optional().register(globalRegistry10, {
+  port: z15.coerce.number().int().positive().optional().register(globalRegistry11, {
     description: "Port for the metrics scrape endpoint",
     title: "telemetry.metrics.scrape.port",
     type: "number"
   })
 }).describe("Metrics scrape configuration");
-var MetricsConfigZod = z14.object({ scrape: MetricsScrapeConfigZod }).describe("Metrics configuration options");
-var OpenTelemetryConfigZod = z14.object({
+var MetricsConfigZod = z15.object({ scrape: MetricsScrapeConfigZod }).describe("Metrics configuration options");
+var OpenTelemetryConfigZod = z15.object({
   // OpenTelemetry options
-  otlpEndpoint: z14.url().optional().register(globalRegistry10, {
+  otlpEndpoint: z15.url().optional().register(globalRegistry11, {
     description: "OTLP endpoint for exporting telemetry data",
     title: "telemetry.otel.otlpEndpoint",
     type: "string"
   })
 });
-var TelemetryConfigZod = z14.object({
+var TelemetryConfigZod = z15.object({
   // Metrics configuration
   metrics: MetricsConfigZod.optional().describe("Metrics configuration"),
   // OpenTelemetry configuration
@@ -1421,7 +1457,7 @@ var TelemetryConfigZod = z14.object({
 
 // src/config/Validation.ts
 import { XyoAddressZod as XyoAddressZod2 } from "@xyo-network/address";
-import { globalRegistry as globalRegistry11, z as z15 } from "zod";
+import { globalRegistry as globalRegistry12, z as z16 } from "zod";
 
 // src/primitives/block/range/blockRangeSteps.ts
 import { asXL1BlockNumber as asXL1BlockNumber2, StepSizes as StepSizes3 } from "@xyo-network/xl1-protocol-lib";
@@ -1442,11 +1478,11 @@ function blockRangeSteps(range, steps) {
 }
 
 // src/primitives/block/rate/blockRate.ts
-import { isDefined as isDefined6, isFalsy } from "@xylabs/sdk-js";
+import { isDefined as isDefined7, isFalsy } from "@xylabs/sdk-js";
 import { asXL1BlockRange } from "@xyo-network/xl1-protocol-lib";
 
 // src/primitives/block/rate/timeHelpers.ts
-import { assertEx as assertEx8, isDefined as isDefined5 } from "@xylabs/sdk-js";
+import { assertEx as assertEx8, isDefined as isDefined6 } from "@xylabs/sdk-js";
 var rateMultipliers = {
   millis: 1,
   seconds: 1e3,
@@ -1464,7 +1500,7 @@ var timeDurations = (timeInMs) => ({
   weeks: timeInMs / (1e3 * 60 * 60 * 24 * 7)
 });
 var getTimeConfigInMilliseconds = (timeConfig) => {
-  const assertedTimeConfig = assertEx8(isDefined5(timeConfig) ? timeConfig : void 0, () => "Time configuration must be provided");
+  const assertedTimeConfig = assertEx8(isDefined6(timeConfig) ? timeConfig : void 0, () => "Time configuration must be provided");
   let totalMilliseconds = 0;
   if ("years" in assertedTimeConfig) {
     totalMilliseconds += assertedTimeConfig.years * 31536e6;
@@ -1503,13 +1539,13 @@ var blockRate = (startBlock, endBlock, timeUnit) => {
     throw new Error("Time difference must be greater than 0");
   }
   const rate = heightDifference / timeDifference;
-  const timeUnitValue = isDefined6(timeUnit) ? timeUnit : "millis";
-  const returnedTimeDifference = isDefined6(timeUnit) ? timeDurations(timeDifference)[timeUnit] : timeDifference;
+  const timeUnitValue = isDefined7(timeUnit) ? timeUnit : "millis";
+  const returnedTimeDifference = isDefined7(timeUnit) ? timeDurations(timeDifference)[timeUnit] : timeDifference;
   const timePerBlock = returnedTimeDifference / heightDifference;
   return {
     range: asXL1BlockRange([startingBlock.block, endingBlock.block], true),
     span: heightDifference,
-    rate: isDefined6(timeUnit) ? rate * rateMultipliers[timeUnit] : rate,
+    rate: isDefined7(timeUnit) ? rate * rateMultipliers[timeUnit] : rate,
     timeUnit: timeUnitValue,
     timeDifference: returnedTimeDifference,
     timePerBlock
@@ -1557,7 +1593,7 @@ var calculateStepSizeRate = async (viewer, start, stepIndex, count = 1, timeUnit
 // src/primitives/block/rate/timeRate.ts
 import {
   assertEx as assertEx10,
-  isDefined as isDefined7,
+  isDefined as isDefined8,
   isDefinedNotNull
 } from "@xylabs/sdk-js";
 import { asXL1BlockNumber as asXL1BlockNumber3, asXL1BlockRange as asXL1BlockRange3 } from "@xyo-network/xl1-protocol-lib";
@@ -1594,7 +1630,7 @@ var findEndBlockRecursive = async (viewer, startBlock, targetTimeMs, estimatedBl
   }
   const endBlock = await viewer.blockByNumber(estimatedEndBlockNumber);
   const resolvedEndBlock = assertEx10(
-    isDefined7(endBlock?.[0]) ? endBlock[0] : void 0,
+    isDefined8(endBlock?.[0]) ? endBlock[0] : void 0,
     () => `Could not retrieve block ${estimatedEndBlockNumber} for time rate calculation`
   );
   const endBlockEpoch = resolvedEndBlock.$epoch;
@@ -1631,7 +1667,7 @@ var findEndBlockRecursive = async (viewer, startBlock, targetTimeMs, estimatedBl
 // src/primitives/chain/getWindowedChain.ts
 import {
   assertEx as assertEx11,
-  isDefined as isDefined8,
+  isDefined as isDefined9,
   isNull,
   spanRootAsync
 } from "@xylabs/sdk-js";
@@ -1645,7 +1681,7 @@ async function getWindowedChain(context, blockViewer, maxWindowSize, previousCha
     while (currentBlock !== null && newChain.length < maxWindowSize) {
       const currentBlockNumber = currentBlock[0].block;
       const nextBlock = newChain[0];
-      if (isDefined8(nextBlock)) {
+      if (isDefined9(nextBlock)) {
         const nextBlockNumber = nextBlock[0].block;
         assertEx11(
           currentBlockNumber === nextBlockNumber - 1,
@@ -1740,7 +1776,7 @@ async function chainStepRewardAddress(context, blockViewer, { block, step }) {
 }
 
 // src/primitives/chain/step/stepRewardTotal.ts
-import { assertEx as assertEx15, isDefined as isDefined9 } from "@xylabs/sdk-js";
+import { assertEx as assertEx15, isDefined as isDefined10 } from "@xylabs/sdk-js";
 import {
   asAttoXL1,
   asXL1BlockRange as asXL1BlockRange5,
@@ -1829,7 +1865,7 @@ function stepInRange(step, range) {
   return stepRange[0] >= range[0] && stepRange[1] <= range[1];
 }
 async function stepRewardTotal(context, blockViewer, { block, step }, multipliers) {
-  const cacheKey = `${block}|${step}|${isDefined9(multipliers)}`;
+  const cacheKey = `${block}|${step}|${isDefined10(multipliers)}`;
   return await withContextCacheResponse(context, "stepRewardTotal", cacheKey, async () => {
     const [blockBw, payloads] = await stepRewardBlock(context, blockViewer, { block, step });
     assertEx15(blockBw.block === block, () => `Block Mismatch: expected ${block}, got ${blockBw.block}`);
@@ -1918,7 +1954,7 @@ async function externalBlockRangeFromStep(context, blockViewer, stepIdentity) {
 }
 
 // src/primitives/mapToMapType.ts
-import { isDefined as isDefined10 } from "@xylabs/sdk-js";
+import { isDefined as isDefined11 } from "@xylabs/sdk-js";
 function mapToMapType(map) {
   return {
     get: (key) => map.get(key),
@@ -1937,7 +1973,7 @@ function mapToMapType(map) {
       const result = [];
       for (const key of keys) {
         const value = map.get(key);
-        if (isDefined10(value)) {
+        if (isDefined11(value)) {
           result.push(value);
         }
       }
@@ -1952,7 +1988,7 @@ function mapToMapType(map) {
 }
 
 // src/primitives/readPayloadMapFromStore.ts
-import { isDefined as isDefined11 } from "@xylabs/sdk-js";
+import { isDefined as isDefined12 } from "@xylabs/sdk-js";
 function readPayloadMapFromStore(store) {
   if (isReadArchivist(store)) {
     return {
@@ -1963,7 +1999,7 @@ function readPayloadMapFromStore(store) {
         return await store.get(hashes);
       },
       has: async (hash) => {
-        return isDefined11((await store.get([hash]))[0]);
+        return isDefined12((await store.get([hash]))[0]);
       }
     };
   }
@@ -1979,7 +2015,7 @@ function payloadMapFromStore(store) {
         return await store.get(hashes);
       },
       has: async (hash) => {
-        return isDefined11((await store.get([hash]))[0]);
+        return isDefined12((await store.get([hash]))[0]);
       },
       clear: async () => {
         return await store.clear();
@@ -2025,7 +2061,7 @@ function rewardFromBlockNumber(blockNumber) {
 import { XYO_NETWORK_STAKING_ADDRESS } from "@xyo-network/xl1-protocol-lib";
 
 // src/primitives/stake/activeStakeAtTimeByAddress.ts
-import { isDefined as isDefined12 } from "@xylabs/sdk-js";
+import { isDefined as isDefined13 } from "@xylabs/sdk-js";
 
 // src/primitives/stake/mergedAddRemoveStakeEventsByStaker.ts
 async function mergedAddRemoveStakeEventsByStaker(chainEvents, range, staked, staker) {
@@ -2044,7 +2080,7 @@ async function activeStakeAtTimeByAddress(chain, staked, time, staker) {
   for (const event of stakeEvents) {
     if (event.time > time) break;
     if (event.args.staked !== staked) continue;
-    if (isDefined12(staker) && event.args.staker !== staker) continue;
+    if (isDefined13(staker) && event.args.staker !== staker) continue;
     if (event.name === "StakeAdded") {
       result += event.args.amount;
     } else if (event.name === "StakeRemoved") {
@@ -2055,7 +2091,7 @@ async function activeStakeAtTimeByAddress(chain, staked, time, staker) {
 }
 
 // src/primitives/stake/activeStakeAtTimeByPosition.ts
-import { isUndefined as isUndefined6 } from "@xylabs/sdk-js";
+import { isUndefined as isUndefined7 } from "@xylabs/sdk-js";
 
 // src/primitives/stake/mergedAddRemoveStakeEventsByPosition.ts
 async function mergedAddRemoveStakeEventsByPosition(chainEvents, range, position) {
@@ -2073,7 +2109,7 @@ async function activeStakeAtTimeByPosition(chainStakeEvents, externalTime, posit
   let result = 0n;
   for (const event of stakeEvents) {
     if (event.time > externalTime) break;
-    if (isUndefined6(position) || position === Number(event.args.id)) {
+    if (isUndefined7(position) || position === Number(event.args.id)) {
       if (event.name === "StakeAdded") {
         result += event.args.amount;
       } else if (event.name === "StakeRemoved") {
@@ -2117,13 +2153,13 @@ async function allStakersForStep(context, blockViewer, stakeEventsViewer, stepCo
 }
 
 // src/primitives/stake/weightedStakeForRangeByPosition.ts
-import { isDefined as isDefined13 } from "@xylabs/sdk-js";
+import { isDefined as isDefined14 } from "@xylabs/sdk-js";
 import { asBlockNumber as asBlockNumber2 } from "@xyo-network/xl1-protocol-lib";
 async function weightedStakeForRangeByPosition(context, blockViewer, stakeEventsViewer, externalRange, staked, positionId) {
-  const cacheKey = isDefined13(positionId) ? `${externalRange[0]}-${externalRange[1]}-${positionId}` : `${externalRange[0]}-${externalRange[1]}-all`;
+  const cacheKey = isDefined14(positionId) ? `${externalRange[0]}-${externalRange[1]}-${positionId}` : `${externalRange[0]}-${externalRange[1]}-all`;
   return await withContextCacheResponse(context, "weightedStakeForRangeByPosition", cacheKey, async () => {
     let weightedStakeSum = 0n;
-    if (isDefined13(positionId)) {
+    if (isDefined14(positionId)) {
       const mergedEvents = (await mergedAddRemoveStakeEventsByPosition(
         stakeEventsViewer,
         [0, externalRange[1]],
@@ -2131,7 +2167,7 @@ async function weightedStakeForRangeByPosition(context, blockViewer, stakeEvents
       )).toSorted((a, b) => a.time - b.time);
       let currentTime = externalRange[0];
       let currentStake = 0n;
-      if (isDefined13(staked) && mergedEvents.at(0)?.args.staked !== staked) {
+      if (isDefined14(staked) && mergedEvents.at(0)?.args.staked !== staked) {
         return 0n;
       }
       for (const event of mergedEvents) {
@@ -2320,24 +2356,24 @@ function findUncles(context, finalizedWindowedChain, blocks) {
 }
 
 // src/config/Validation.ts
-var ValidationConfigZod = z15.object({
-  allowedRewardRedeemers: z15.array(XyoAddressZod2).optional().register(globalRegistry11, {
+var ValidationConfigZod = z16.object({
+  allowedRewardRedeemers: z16.array(XyoAddressZod2).optional().register(globalRegistry12, {
     description: "List of allowed reward redeemer addresses, if undefined anyone can participate",
     title: "allowedRewardRedeemers",
     type: "array"
   }),
-  allowedRewardEscrowAccountSigners: z15.array(XyoAddressZod2).optional().register(globalRegistry11, {
+  allowedRewardEscrowAccountSigners: z16.array(XyoAddressZod2).optional().register(globalRegistry12, {
     description: "List of allowed reward escrow account signer addresses, if undefined anyone can participate",
     title: "allowedRewardEscrowAccountSigners",
     type: "array"
   }),
-  minCandidates: z15.coerce.number().default(DEFAULT_MIN_CANDIDATES).register(globalRegistry11, {
+  minCandidates: z16.coerce.number().default(DEFAULT_MIN_CANDIDATES).register(globalRegistry12, {
     default: DEFAULT_MIN_CANDIDATES,
     description: "Minimum number of uncle candidates before selecting the best uncle",
     title: "validation.minCandidates",
     type: "number"
   }),
-  backoffMs: z15.coerce.number().default(DEFAULT_BACKOFF_MS).register(globalRegistry11, {
+  backoffMs: z16.coerce.number().default(DEFAULT_BACKOFF_MS).register(globalRegistry12, {
     default: DEFAULT_BACKOFF_MS,
     description: "Back-off timeout in ms. If head age exceeds this, minCandidates is ignored",
     title: "validation.backoffMs",
@@ -2346,26 +2382,26 @@ var ValidationConfigZod = z15.object({
 });
 
 // src/config/Base.ts
-var BaseConfigZod = z16.object({
-  chain: z16._default(ChainConfigZod, ChainConfigZod.parse({})).check(z16.describe("Configuration for the chain")),
-  dataLake: z16.optional(DataLakeConfigZod).check(z16.describe("Configuration for data lakes")),
-  evm: z16._default(EvmConfigZod, EvmConfigZod.parse({})).check(z16.describe("Configuration for EVM-backed services")),
-  log: z16._default(LogConfigZod, LogConfigZod.parse({})).check(z16.describe("Configuration for logging")),
-  providers: z16._default(ProvidersConfigZod, ProvidersConfigZod.parse([])).check(z16.describe("Configuration for providers")),
-  remote: z16._default(RemoteConfigZod, RemoteConfigZod.parse({})).check(z16.describe("Configuration for remote services")),
-  storage: z16._default(StorageConfigZod, StorageConfigZod.parse({})).check(z16.describe("Configuration for the storage")),
-  telemetry: z16._default(TelemetryConfigZod, TelemetryConfigZod.parse({})).check(z16.describe("Configuration for telemetry")),
-  validation: z16._default(ValidationConfigZod, ValidationConfigZod.parse({})).check(z16.describe("Configuration for validation"))
+var BaseConfigZod = z17.object({
+  chain: z17._default(ChainConfigZod, ChainConfigZod.parse({})).check(z17.describe("Configuration for the chain")),
+  dataLake: z17.optional(DataLakeConfigZod).check(z17.describe("Configuration for data lakes")),
+  evm: z17._default(EvmConfigZod, EvmConfigZod.parse({})).check(z17.describe("Configuration for EVM-backed services")),
+  log: z17._default(LogConfigZod, LogConfigZod.parse({})).check(z17.describe("Configuration for logging")),
+  providers: z17._default(ProvidersConfigZod, ProvidersConfigZod.parse([])).check(z17.describe("Configuration for providers")),
+  remote: z17._default(RemoteConfigZod, RemoteConfigZod.parse({})).check(z17.describe("Configuration for remote services")),
+  storage: z17._default(StorageConfigZod, StorageConfigZod.parse({})).check(z17.describe("Configuration for the storage")),
+  telemetry: z17._default(TelemetryConfigZod, TelemetryConfigZod.parse({})).check(z17.describe("Configuration for telemetry")),
+  validation: z17._default(ValidationConfigZod, ValidationConfigZod.parse({})).check(z17.describe("Configuration for validation"))
 });
 
 // src/config/Actor.ts
-var AccountPathZod = z17.string().check(z17.regex(
+var AccountPathZod = z18.string().check(z18.regex(
   /^(m(\/\d+'?)+|\d+'?(\/\d+'?)*)$/,
   `Invalid BIP-32 derivation path. Use either an absolute path like "m/44'/60'/0'/0/0" or a relative path like "0", "0/1", or "44'/60'/0'/0/0".`
 ));
-var ActorConfigZod = z17.extend(BaseConfigZod, {
-  name: z17.string(),
-  accountPath: z17.optional(AccountPathZod).register(globalRegistry12, {
+var ActorConfigZod = z18.extend(BaseConfigZod, {
+  name: z18.string(),
+  accountPath: z18.optional(AccountPathZod).register(globalRegistry13, {
     description: 'BIP-32 derivation path for the actor wallet. Absolute when it starts with "m/"; otherwise relative to the root wallet base path. Each actor must derive to a distinct path.',
     title: "accountPath",
     type: "string"
@@ -2376,22 +2412,22 @@ var asActorConfig = zodAsFactory3(ActorConfigZod, "asActorConfig");
 var toActorConfig = zodToFactory2(ActorConfigZod, "toActorConfig");
 
 // src/config/Actors.ts
-import { z as z18 } from "zod/mini";
-var ActorsConfigZod = z18._default(
-  z18.array(z18.looseObject(ActorConfigZod.shape)).check(z18.describe("Actor-specific configurations that override the base configuration when the actor is running")),
+import { z as z19 } from "zod/mini";
+var ActorsConfigZod = z19._default(
+  z19.array(z19.looseObject(ActorConfigZod.shape)).check(z19.describe("Actor-specific configurations that override the base configuration when the actor is running")),
   []
 );
 
 // src/config/Config.ts
-import { globalRegistry as globalRegistry13, z as z19 } from "zod/mini";
-var ConfigZod = z19.extend(BaseConfigZod, {
+import { globalRegistry as globalRegistry14, z as z20 } from "zod/mini";
+var ConfigZod = z20.extend(BaseConfigZod, {
   actors: ActorsConfigZod,
-  healthCheckPort: z19.optional(z19.coerce.number()).register(globalRegistry13, {
+  healthCheckPort: z20.optional(z20.coerce.number()).register(globalRegistry14, {
     description: "Port for the system-wide health, readiness, and liveness endpoints (/healthz, /livez, /readyz). Set to 0 to disable.",
     title: "healthCheckPort",
     type: "number"
   })
-}).check(z19.describe("The complete configuration for the protocol, including global settings and actor-specific overrides"));
+}).check(z20.describe("The complete configuration for the protocol, including global settings and actor-specific overrides"));
 function resolveConfig(config) {
   const parsedConfig = ConfigZod.parse(config);
   const {
@@ -2400,7 +2436,7 @@ function resolveConfig(config) {
     ...rootConfig
   } = parsedConfig;
   parsedConfig.actors = actors.map((actorConfig) => {
-    return z19.looseObject(ActorConfigZod.shape).parse({ ...rootConfig, ...actorConfig });
+    return z20.looseObject(ActorConfigZod.shape).parse({ ...rootConfig, ...actorConfig });
   });
   return parsedConfig;
 }
@@ -2411,15 +2447,15 @@ import {
   zodIsFactory as zodIsFactory3,
   zodToFactory as zodToFactory3
 } from "@xylabs/sdk-js";
-import { globalRegistry as globalRegistry14, z as z20 } from "zod/mini";
-var HostActorConfigZod = z20.extend(ActorConfigZod, {
-  host: z20._default(z20.string(), "localhost").register(globalRegistry14, {
+import { globalRegistry as globalRegistry15, z as z21 } from "zod/mini";
+var HostActorConfigZod = z21.extend(ActorConfigZod, {
+  host: z21._default(z21.string(), "localhost").register(globalRegistry15, {
     default: "localhost",
     description: "Host for the Actor",
     title: "host",
     type: "string"
   }),
-  port: z20._default(z20.coerce.number(), 8080).register(globalRegistry14, {
+  port: z21._default(z21.coerce.number(), 8080).register(globalRegistry15, {
     default: 8080,
     description: "Port for the Actor",
     title: "port",
@@ -2431,30 +2467,30 @@ var asHostActorConfig = zodAsFactory4(HostActorConfigZod, "asHostActorConfig");
 var toHostActorConfig = zodToFactory3(HostActorConfigZod, "toHostActorConfig");
 
 // src/config/UsageMeta.ts
-import { z as z21 } from "zod";
-var DescriptionSchema = z21.string();
-var TitleSchema = z21.string();
-var JSONSchemaMetaSchema = z21.object({
-  id: z21.string().optional(),
+import { z as z22 } from "zod";
+var DescriptionSchema = z22.string();
+var TitleSchema = z22.string();
+var JSONSchemaMetaSchema = z22.object({
+  id: z22.string().optional(),
   title: TitleSchema.optional(),
   description: DescriptionSchema.optional(),
-  deprecated: z21.boolean().optional()
-}).catchall(z21.unknown());
+  deprecated: z22.boolean().optional()
+}).catchall(z22.unknown());
 var GlobalMetaSchema = JSONSchemaMetaSchema.extend({});
-var ChoicesSchema = z21.array(z21.union([z21.string(), z21.number(), z21.literal(true), z21.undefined()])).readonly();
+var ChoicesSchema = z22.array(z22.union([z22.string(), z22.number(), z22.literal(true), z22.undefined()])).readonly();
 var UsageMetaSchema = GlobalMetaSchema.extend({
   choices: ChoicesSchema.optional(),
-  default: z21.unknown().optional(),
+  default: z22.unknown().optional(),
   description: DescriptionSchema,
-  group: z21.string().optional(),
-  hidden: z21.boolean().optional(),
+  group: z22.string().optional(),
+  hidden: z22.boolean().optional(),
   title: TitleSchema,
-  type: z21.union([
-    z21.literal("array"),
-    z21.literal("count"),
-    z21.literal("boolean"),
-    z21.literal("number"),
-    z21.literal("string")
+  type: z22.union([
+    z22.literal("array"),
+    z22.literal("count"),
+    z22.literal("boolean"),
+    z22.literal("number"),
+    z22.literal("string")
   ])
 });
 function isUsageMeta(v) {
@@ -2467,7 +2503,7 @@ import {
   zodIsFactory as zodIsFactory5,
   zodToFactory as zodToFactory5
 } from "@xylabs/sdk-js";
-import { z as z23 } from "zod/mini";
+import { z as z24 } from "zod/mini";
 
 // src/model/CreatableProviderContext.zod.ts
 import {
@@ -2476,17 +2512,17 @@ import {
   zodToFactory as zodToFactory4
 } from "@xylabs/sdk-js";
 import { CachingContextZod } from "@xyo-network/xl1-protocol-lib";
-import { z as z22 } from "zod/mini";
-var RuntimeStatusMonitorZod = z22.custom((val) => val && typeof val === "object");
-var ProviderFactoryLocatorZod = z22.lazy(() => z22.custom((val) => val && typeof val === "object" && "context" in val && "registry" in val));
-var BaseConfigContextZod = z22.extend(CachingContextZod, {
-  config: z22.looseObject(BaseConfigZod.shape),
-  locator: z22.optional(ProviderFactoryLocatorZod)
+import { z as z23 } from "zod/mini";
+var RuntimeStatusMonitorZod = z23.custom((val) => val && typeof val === "object");
+var ProviderFactoryLocatorZod = z23.lazy(() => z23.custom((val) => val && typeof val === "object" && "context" in val && "registry" in val));
+var BaseConfigContextZod = z23.extend(CachingContextZod, {
+  config: z23.looseObject(BaseConfigZod.shape),
+  locator: z23.optional(ProviderFactoryLocatorZod)
 });
-var CreatableProviderContextZod = z22.lazy(() => z22.extend(BaseConfigContextZod, {
-  _id: z22.optional(z22.string()),
+var CreatableProviderContextZod = z23.lazy(() => z23.extend(BaseConfigContextZod, {
+  _id: z23.optional(z23.string()),
   locator: ProviderFactoryLocatorZod,
-  statusReporter: z22.optional(RuntimeStatusMonitorZod)
+  statusReporter: z23.optional(RuntimeStatusMonitorZod)
 }));
 var isBaseConfigContext = zodIsFactory4(BaseConfigContextZod);
 var asBaseConfigContext = zodAsFactory5(BaseConfigContextZod, "asBaseConfigContext");
@@ -2607,7 +2643,7 @@ async function buildUnsignedTransaction(chain, onChainPayloads, offChainPayloads
 // src/transaction/confirmSubmittedTransaction.ts
 import {
   delay,
-  isDefined as isDefined14,
+  isDefined as isDefined15,
   isNumber
 } from "@xylabs/sdk-js";
 var DEFAULT_CONFIRMATION_ATTEMPTS = 20;
@@ -2629,7 +2665,7 @@ var confirmSubmittedTransaction = async (viewer, txHash, options) => {
   let attempts = 0;
   while (true) {
     const tx = await viewer.transaction.byHash(txHash) ?? void 0;
-    if (isDefined14(tx)) {
+    if (isDefined15(tx)) {
       options?.logger?.debug("Transaction confirmed", txHash);
       return tx;
     } else {
@@ -2944,7 +2980,7 @@ var bundle2 = (root, transaction) => {
 };
 
 // src/context/Actor.ts
-var ActorConfigContext = z23.extend(BaseConfigContextZod, { config: ActorConfigZod });
+var ActorConfigContext = z24.extend(BaseConfigContextZod, { config: ActorConfigZod });
 var isActorConfigContext = zodIsFactory5(ActorConfigContext);
 var asActorConfigContext = zodAsFactory6(ActorConfigContext, "asActorConfigContext");
 var toActorConfigContext = zodToFactory5(ActorConfigContext, "toActorConfigContext");
@@ -3334,20 +3370,20 @@ import {
   zodIsFactory as zodIsFactory6,
   zodToFactory as zodToFactory6
 } from "@xylabs/sdk-js";
-import { z as z24 } from "zod/mini";
-var HostActorConfigContext = z24.extend(BaseConfigContextZod, { config: HostActorConfigZod });
+import { z as z25 } from "zod/mini";
+var HostActorConfigContext = z25.extend(BaseConfigContextZod, { config: HostActorConfigZod });
 var isHostActorConfigContext = zodIsFactory6(HostActorConfigContext);
 var asHostActorConfigContext = zodAsFactory7(HostActorConfigContext, "asHostActorConfigContext");
 var toHostActorConfigContext = zodToFactory6(HostActorConfigContext, "toHostActorConfigContext");
 
 // src/createDeclarationPayload.ts
-import { isDefined as isDefined15 } from "@xylabs/sdk-js";
+import { isDefined as isDefined16 } from "@xylabs/sdk-js";
 import { PayloadBuilder as PayloadBuilder13 } from "@xyo-network/sdk-js";
 import {
   ChainStakeIntentSchema
 } from "@xyo-network/xl1-protocol-lib";
 var createDeclarationIntent = (address, intent, nbf, exp) => {
-  const expiration = isDefined15(exp) ? exp : nbf + 1e4;
+  const expiration = isDefined16(exp) ? exp : nbf + 1e4;
   const redeclarationIntent = new PayloadBuilder13({ schema: ChainStakeIntentSchema }).fields({
     from: address,
     intent,
@@ -3376,26 +3412,26 @@ import {
   asSchema as asSchema2,
   isPayloadOfZodType
 } from "@xyo-network/sdk-js";
-import { z as z26 } from "zod";
+import { z as z27 } from "zod";
 
 // src/eip-712/Types.ts
-import { z as z25 } from "zod";
-var TypedDataDomainZod = z25.object({
-  name: z25.string().nullable().optional(),
-  version: z25.string().nullable().optional(),
-  chainId: z25.union([z25.string(), z25.number(), z25.bigint()]).nullable().optional(),
-  verifyingContract: z25.string().nullable().optional(),
-  salt: z25.union([z25.string(), z25.instanceof(Uint8Array)]).nullable().optional()
+import { z as z26 } from "zod";
+var TypedDataDomainZod = z26.object({
+  name: z26.string().nullable().optional(),
+  version: z26.string().nullable().optional(),
+  chainId: z26.union([z26.string(), z26.number(), z26.bigint()]).nullable().optional(),
+  verifyingContract: z26.string().nullable().optional(),
+  salt: z26.union([z26.string(), z26.instanceof(Uint8Array)]).nullable().optional()
 });
-var TypedDataFieldZod = z25.object({
-  name: z25.string(),
-  type: z25.string()
+var TypedDataFieldZod = z26.object({
+  name: z26.string(),
+  type: z26.string()
 });
-var TypedDataTypesZod = z25.record(z25.string(), z25.array(TypedDataFieldZod));
-var TypedDataValueZod = z25.record(z25.string(), z25.any());
+var TypedDataTypesZod = z26.record(z26.string(), z26.array(TypedDataFieldZod));
+var TypedDataValueZod = z26.record(z26.string(), z26.any());
 
 // src/eip-712/Payloads/EIP712Data.ts
-var EIP712DataPayloadFieldsZod = z26.object({
+var EIP712DataPayloadFieldsZod = z27.object({
   domain: TypedDataDomainZod,
   types: TypedDataTypesZod,
   values: TypedDataValueZod
@@ -3413,11 +3449,11 @@ import {
   asSchema as asSchema3,
   isPayloadOfZodType as isPayloadOfZodType2
 } from "@xyo-network/sdk-js";
-import { z as z27 } from "zod";
-var EIP712SignaturePayloadFieldsZod = z27.object({
-  address: z27.string(),
+import { z as z28 } from "zod";
+var EIP712SignaturePayloadFieldsZod = z28.object({
+  address: z28.string(),
   hash: HashZod,
-  signature: z27.string()
+  signature: z28.string()
 });
 var EIP712SignaturePayloadSchema = asSchema3("network.xyo.chains.ethereum.eip712.signature", true);
 var isEIP712SignaturePayload = isPayloadOfZodType2(
@@ -3446,7 +3482,7 @@ var signEIP712Message = async (signer, data) => {
 };
 
 // src/eip-712/verify.ts
-import { asHash as asHash3, isUndefined as isUndefined7 } from "@xylabs/sdk-js";
+import { asHash as asHash3, isUndefined as isUndefined8 } from "@xylabs/sdk-js";
 import { PayloadBuilder as PayloadBuilder16 } from "@xyo-network/sdk-js";
 import { verifyTypedData } from "ethers";
 var verifyEIP712Message = async (data, sig) => {
@@ -3457,7 +3493,7 @@ var verifyEIP712Message = async (data, sig) => {
   } = sig;
   const { schema, ...fields } = data;
   const signedHash = asHash3(hash);
-  if (isUndefined7(signedHash) || signedHash !== await PayloadBuilder16.hash(data)) return false;
+  if (isUndefined8(signedHash) || signedHash !== await PayloadBuilder16.hash(data)) return false;
   const recoveredAddress = verifyTypedData(fields.domain, fields.types, fields.values, signature);
   return recoveredAddress.toLowerCase() === address.toLowerCase();
 };
@@ -3528,7 +3564,7 @@ import {
   asHash as asHash4,
   assertEx as assertEx33,
   exists as exists3,
-  isDefined as isDefined16,
+  isDefined as isDefined17,
   ZERO_ADDRESS
 } from "@xylabs/sdk-js";
 import {
@@ -4043,7 +4079,7 @@ var SimpleAccountBalanceViewer = class extends AbstractCreatableProvider {
             block[1].find((p) => p._hash === hash),
             () => `Error: Could not find Transfer with hash ${hash} in block ${block[0]._hash}`
           );
-        }).filter(exists3).filter((t) => t.from === address || isDefined16(t.transfers[address]));
+        }).filter(exists3).filter((t) => t.from === address || isDefined17(t.transfers[address]));
         if (transfers.length === 0) {
           continue;
         }
@@ -4162,7 +4198,7 @@ var SimpleAccountBalanceViewer = class extends AbstractCreatableProvider {
     return await this.spanAsync("qualifiedAccountBalanceHistory", async () => {
       const range = asRange(headOrRange);
       const headHash = asHash4(headOrRange);
-      const [head] = assertEx33(isDefined16(headHash) ? await this.blockViewer.blockByHash(headHash) : await this.blockViewer.currentBlock(), () => "Could not resolve head block");
+      const [head] = assertEx33(isDefined17(headHash) ? await this.blockViewer.blockByHash(headHash) : await this.blockViewer.currentBlock(), () => "Could not resolve head block");
       const startingRange = asXL1BlockRange10(range ?? [0, head.block], true);
       const blockNumbers = await this.distillTransferHistory(address, startingRange);
       const blocks = (await Promise.all(blockNumbers.map(async (bn) => await this.blockViewer.blockByNumber(bn)))).filter(exists3);
@@ -4175,7 +4211,7 @@ var SimpleAccountBalanceViewer = class extends AbstractCreatableProvider {
             block[1].find((p) => p._hash === hash),
             () => `Error: Could not find Transfer with hash ${hash} in block ${block[0]._hash}`
           );
-        }).filter(exists3).filter((t) => t.from === address || isDefined16(t.transfers[address]));
+        }).filter(exists3).filter((t) => t.from === address || isDefined17(t.transfers[address]));
         if (transfers.length === 0) {
           continue;
         }
@@ -4203,7 +4239,7 @@ SimpleAccountBalanceViewer = __decorateClass([
 import {
   assertEx as assertEx34,
   exists as exists4,
-  isUndefined as isUndefined8
+  isUndefined as isUndefined9
 } from "@xylabs/sdk-js";
 import { LruCacheMap as LruCacheMap2 } from "@xyo-network/xl1-driver-memory";
 import {
@@ -4242,12 +4278,12 @@ var HydratedCache = class {
 };
 
 // src/utils/isZodError.ts
-import { z as z28 } from "zod";
+import { z as z29 } from "zod";
 var isZodError = (error) => {
-  return error instanceof z28.ZodError;
+  return error instanceof z29.ZodError;
 };
 var prettifyZodError = (error) => {
-  return z28.prettifyError(error);
+  return z29.prettifyError(error);
 };
 
 // src/simple/block/SimpleBlockViewer.ts
@@ -4315,7 +4351,7 @@ var SimpleBlockViewer = class extends AbstractCreatableProvider {
   async blockByNumber(blockNumber) {
     return await this.spanAsync("blockByNumber", async () => {
       const chainContext = await this.getChainContextRead();
-      if (isUndefined8(chainContext.head)) {
+      if (isUndefined9(chainContext.head)) {
         return null;
       }
       return await this.blockByNumberWithContext(chainContext, blockNumber);
@@ -4341,7 +4377,7 @@ var SimpleBlockViewer = class extends AbstractCreatableProvider {
       assertEx34(limit > 0, () => "limit must be greater than 0");
       assertEx34(limit <= 100, () => "limit must be less than 100");
       const chainContext = await this.getChainContextRead();
-      if (isUndefined8(chainContext.head)) {
+      if (isUndefined9(chainContext.head)) {
         return [];
       }
       const blocks = [];
@@ -4364,7 +4400,7 @@ var SimpleBlockViewer = class extends AbstractCreatableProvider {
         () => `blocksByStep does not support step levels above ${blocksMaxStep} (requested ${stepLevel})`
       );
       const chainContext = await this.getChainContextRead();
-      if (isUndefined8(chainContext.head)) {
+      if (isUndefined9(chainContext.head)) {
         return [];
       }
       const start = stepIndex * size;
@@ -4717,7 +4753,7 @@ var SimpleXyoClient = class {
 import { assertEx as assertEx37, exists as exists6 } from "@xylabs/sdk-js";
 import { isAnyPayload as isAnyPayload8, PayloadZodLoose } from "@xyo-network/sdk-js";
 import { DataLakeRunnerMoniker } from "@xyo-network/xl1-protocol-lib";
-import { z as z29 } from "zod/mini";
+import { z as z30 } from "zod/mini";
 
 // src/simple/datalake/AbstractRestDataLake.ts
 import { FetchClientError, FetchJsonClient } from "@xylabs/sdk-js";
@@ -4790,7 +4826,7 @@ var RestDataLakeRunner = class extends AbstractRestDataLake {
     }).filter(exists6);
     if (allowedItems.length > 0) {
       const result = await this.client.post(`${this.params.endpoint}/insert`, allowedItems);
-      return z29.array(PayloadZodLoose).parse(result.data);
+      return z30.array(PayloadZodLoose).parse(result.data);
     } else {
       return [];
     }
@@ -5033,7 +5069,7 @@ var SimpleXyoGateway = class _SimpleXyoGateway extends AbstractCreatableProvider
 import {
   assertEx as assertEx39,
   BigIntToJsonZod,
-  isDefined as isDefined17
+  isDefined as isDefined18
 } from "@xylabs/sdk-js";
 import { PayloadBuilder as PayloadBuilder20 } from "@xyo-network/sdk-js";
 import {
@@ -5071,9 +5107,9 @@ var SimpleXyoGatewayRunner = class _SimpleXyoGatewayRunner extends AbstractCreat
       chain,
       fees
     } = options ?? {};
-    const resolvedChainId = isDefined17(chain) ? chain : await viewer.chainId();
-    const resolvedNbf = asXL1BlockNumber10(isDefined17(nbf) ? nbf : await viewer.currentBlockNumber(), true);
-    const resolvedExp = asXL1BlockNumber10(isDefined17(exp) ? exp : resolvedNbf + 10, true);
+    const resolvedChainId = isDefined18(chain) ? chain : await viewer.chainId();
+    const resolvedNbf = asXL1BlockNumber10(isDefined18(nbf) ? nbf : await viewer.currentBlockNumber(), true);
+    const resolvedExp = asXL1BlockNumber10(isDefined18(exp) ? exp : resolvedNbf + 10, true);
     const tx = await buildUnsignedTransaction(resolvedChainId, onChain, offChain, resolvedNbf, resolvedExp, await this.signer.address(), fees);
     return await this.addTransactionToChain(tx, await PayloadBuilder20.addHashMeta(offChain));
   }
@@ -5561,7 +5597,7 @@ SimpleMempoolRunner = __decorateClass([
 // src/simple/mempool/SimpleMempoolViewer.ts
 import {
   exists as exists9,
-  isDefined as isDefined18,
+  isDefined as isDefined19,
   isHash as isHash2
 } from "@xylabs/sdk-js";
 import { isHashMeta as isHashMeta2, isPayloadBundle as isPayloadBundle2 } from "@xyo-network/sdk-js";
@@ -5622,7 +5658,7 @@ var SimpleMempoolViewer = class extends AbstractCreatableProvider {
     let cursor = void 0;
     if (isHash2(providedCursor)) {
       const [p] = await this.pendingBlocksArchivist.get([providedCursor]);
-      if (isDefined18(p)) {
+      if (isDefined19(p)) {
         cursor = p._sequence;
       }
     }
@@ -5641,7 +5677,7 @@ var SimpleMempoolViewer = class extends AbstractCreatableProvider {
     let cursor = void 0;
     if (isHash2(providedCursor)) {
       const [p] = await this.pendingTransactionsArchivist.get([providedCursor]);
-      if (isDefined18(p)) {
+      if (isDefined19(p)) {
         cursor = p._sequence;
       }
     }
@@ -5656,7 +5692,7 @@ var SimpleMempoolViewer = class extends AbstractCreatableProvider {
     const hydratedWithBundle = (await Promise.all(
       filteredBundles.map(async (bundle3) => {
         const tx = await bundledPayloadToHydratedTransaction(bundle3);
-        return isDefined18(tx) ? { bundle: bundle3, tx } : void 0;
+        return isDefined19(tx) ? { bundle: bundle3, tx } : void 0;
       })
     )).filter(exists9);
     const currentBlock = await this.windowedBlockViewer.currentBlock();
@@ -5776,7 +5812,7 @@ function deduplicateWithBundleBySigner(items) {
 }
 
 // src/simple/network/SimpleXyoNetwork.ts
-import { fetchJsonGet, isUndefined as isUndefined9 } from "@xylabs/sdk-js";
+import { fetchJsonGet, isUndefined as isUndefined10 } from "@xylabs/sdk-js";
 import { isNetworkStatus } from "@xyo-network/xl1-protocol-lib";
 
 // src/simple/network/lib/FailedNetworkStatusPayloads.ts
@@ -5824,7 +5860,7 @@ var SimpleXyoNetwork = class {
   }
   async status() {
     const statusNetwork = StatusNetworks[this._networkId];
-    if (isUndefined9(statusNetwork)) {
+    if (isUndefined10(statusNetwork)) {
       throw new Error(`Unknown status network ID: ${this._networkId}`);
     }
     return await this.makeRequest(statusNetwork.statusUrl);
@@ -6007,7 +6043,7 @@ var SimpleXyoSigner = class _SimpleXyoSigner extends AbstractCreatableProvider {
 };
 
 // src/simple/StakeEventsViewer/SimpleStakeEventsViewer.ts
-import { isDefined as isDefined19 } from "@xylabs/sdk-js";
+import { isDefined as isDefined20 } from "@xylabs/sdk-js";
 import { StakeEventsViewerMoniker } from "@xyo-network/xl1-protocol-lib";
 var SimpleStakeEventsViewer = class extends AbstractCreatableProvider {
   moniker = SimpleStakeEventsViewer.defaultMoniker;
@@ -6020,7 +6056,7 @@ var SimpleStakeEventsViewer = class extends AbstractCreatableProvider {
   stakeEvents(range, { name } = {}) {
     const positions = this.positionsFromRange(range);
     const events = this.eventsFromPositions(positions);
-    if (isDefined19(name)) {
+    if (isDefined20(name)) {
       return events.filter((event) => event.name === name);
     }
     return events;
@@ -6368,7 +6404,7 @@ RestSyncViewer = __decorateClass([
 import {
   asHash as asHash5,
   assertEx as assertEx45,
-  isDefined as isDefined20
+  isDefined as isDefined21
 } from "@xylabs/sdk-js";
 import {
   asTimePayload as asTimePayload2,
@@ -6392,7 +6428,7 @@ var SimpleTimeSyncViewer = class extends AbstractCreatableProvider {
         const [block, payloads] = assertEx45(await this.blockViewer.blockByNumber(asXL1BlockNumber11(from, true)), () => "Block not found");
         const timeSchemaIndex = block.payload_schemas.indexOf(TimeSchema);
         const hash = timeSchemaIndex === -1 ? void 0 : block.payload_hashes[timeSchemaIndex];
-        const timePayload = asTimePayload2(isDefined20(hash) ? payloads.find((p) => p._hash === hash) : void 0);
+        const timePayload = asTimePayload2(isDefined21(hash) ? payloads.find((p) => p._hash === hash) : void 0);
         if (timePayload === void 0) return 0;
         switch (toDomain) {
           case "xl1": {
@@ -6465,7 +6501,7 @@ var SimpleTimeSyncViewer = class extends AbstractCreatableProvider {
       xl1Hash: assertEx45(xl1Hash, () => "No xl1 hash available from time sync service"),
       epoch: Date.now()
     };
-    if (isDefined20(this.ethProvider)) {
+    if (isDefined21(this.ethProvider)) {
       const [ethereum, ethHashOrNull] = await this.currentTimeAndHash("ethereum");
       const ethereumHash = asHash5(ethHashOrNull, () => "No ethereum hash available from time sync service");
       timePayload.ethereum = ethereum;
@@ -6935,14 +6971,375 @@ var RuntimeStatusMonitor = class extends LoggerStatusReporter {
   }
 };
 
+// src/test/buildRandomChain.ts
+import { asAddress as asAddress2, assertEx as assertEx51 } from "@xylabs/sdk-js";
+import {
+  Account as Account4,
+  asSchema as asSchema11,
+  IdSchema as IdSchema2,
+  MemoryArchivist,
+  PayloadBuilder as PayloadBuilder29
+} from "@xyo-network/sdk-js";
+import {
+  asXL1BlockNumber as asXL1BlockNumber17
+} from "@xyo-network/xl1-protocol-lib";
+
+// src/test/buildNextBlock.ts
+import {
+  AttoXL1 as AttoXL15,
+  XYO_STEP_REWARD_ADDRESS as XYO_STEP_REWARD_ADDRESS4
+} from "@xyo-network/xl1-protocol-lib";
+
+// src/test/buildBlock.ts
+import { assertEx as assertEx49, isDefined as isDefined22 } from "@xylabs/sdk-js";
+import {
+  asAnyPayload as asAnyPayload5,
+  BoundWitnessBuilder as BoundWitnessBuilder3,
+  PayloadBuilder as PayloadBuilder25
+} from "@xyo-network/sdk-js";
+import {
+  asXL1BlockNumber as asXL1BlockNumber13,
+  AttoXL1 as AttoXL14,
+  isBlockBoundWitness,
+  rewardAddressFromStepIdentity,
+  StepRewardFractions,
+  StepSizes as StepSizes15,
+  XL1_PROTOCOL_VERSION,
+  XYO_STEP_REWARD_ADDRESS as XYO_STEP_REWARD_ADDRESS3,
+  XYO_ZERO_ADDRESS as XYO_ZERO_ADDRESS2
+} from "@xyo-network/xl1-protocol-lib";
+
+// src/test/BuildBlockOptions.ts
+import {
+  isAddress,
+  isArray as isArray2,
+  isHash as isHash3,
+  isNumber as isNumber2,
+  isObject as isObject3
+} from "@xylabs/sdk-js";
+var isBaseBuildBlockOptions = (value) => {
+  if (!isObject3(value)) {
+    return false;
+  }
+  const typedValue = value;
+  if (!isArray2(typedValue.blockPayloads) || !isAddress(typedValue.chainId) || !isArray2(typedValue.signers) || !isArray2(typedValue.txs)) {
+    return false;
+  }
+  return true;
+};
+var isBuildGenesisBlockOptions = (value) => {
+  if (!isBaseBuildBlockOptions(value)) {
+    return false;
+  }
+  const typedValue = value;
+  if (typedValue.previousBlockHash !== null) {
+    return false;
+  }
+  if (typedValue.previousBlockNumber !== void 0) {
+    return false;
+  }
+  return true;
+};
+var isBuildNextBlockOptions = (value) => {
+  if (!isBaseBuildBlockOptions(value)) {
+    return false;
+  }
+  const typedValue = value;
+  if (!isHash3(typedValue.previousBlockHash)) {
+    return false;
+  }
+  if (!isNumber2(typedValue.previousBlockNumber)) {
+    return false;
+  }
+  if (!isArray2(typedValue.previousStepHashes)) {
+    return false;
+  }
+  return true;
+};
+
+// src/test/buildBlock.ts
+function calculateCompletedStepReward(step, balance) {
+  return AttoXL14(StepRewardFractions[step][0] * balance / StepRewardFractions[step][1]);
+}
+async function buildBlock(options) {
+  const previousBlockNumber = isBuildGenesisBlockOptions(options) ? -1 : options.previousBlockNumber;
+  const blockNumber = asXL1BlockNumber13(previousBlockNumber + 1, true);
+  const inStepHashes = isBuildNextBlockOptions(options) ? options.previousStepHashes : [];
+  const previousBlockHash = isBuildNextBlockOptions(options) ? options.previousBlockHash : void 0;
+  const stepRewardPoolBalance = isBuildNextBlockOptions(options) ? options.stepRewardPoolBalance : AttoXL14(0n);
+  const {
+    chainId,
+    txs,
+    chainStepRewardAddress: chainStepRewardAddress2 = XYO_STEP_REWARD_ADDRESS3,
+    blockPayloads,
+    protocol = XL1_PROTOCOL_VERSION,
+    signers
+  } = options;
+  const step_hashes = [];
+  for (const [tx] of txs) {
+    if (tx.nbf > blockNumber) {
+      throw new Error(`Transaction ${await PayloadBuilder25.hash(tx)} not valid for block ${blockNumber} - NBF is ${tx.nbf}`);
+    }
+    if (tx.exp < blockNumber) {
+      throw new Error(`Transaction ${await PayloadBuilder25.hash(tx)} not valid for block ${blockNumber} - EXP is ${tx.exp}`);
+    }
+  }
+  const completedStepRewardTransfers = [];
+  for (const [i, step] of StepSizes15.entries()) {
+    if (blockNumber < step) {
+      break;
+    }
+    if (blockNumber % step === 0) {
+      if (StepRewardFractions[i][0] > 0 && chainStepRewardAddress2 !== XYO_ZERO_ADDRESS2) {
+        const completedStepRewardHolderAddress = rewardAddressFromStepIdentity({ block: blockNumber, step });
+        const completedStepReward = calculateCompletedStepReward(i, stepRewardPoolBalance);
+        completedStepRewardTransfers.push(createTransferPayload(chainStepRewardAddress2, { [completedStepRewardHolderAddress]: completedStepReward }));
+      }
+      step_hashes.push(assertEx49(previousBlockHash, () => `Previous block hash is required for step ${step} at block ${blockNumber}`));
+    } else {
+      if (isDefined22(inStepHashes.at(i))) {
+        step_hashes.push(inStepHashes[i]);
+      }
+    }
+  }
+  const previous = previousBlockHash ?? null;
+  const block = blockNumber;
+  const txElevatedPayloads = await validateTransactionsOpcodes(txs);
+  const payloads = [
+    ...txs.map(([tx]) => tx),
+    ...blockPayloads,
+    ...txElevatedPayloads,
+    ...completedStepRewardTransfers
+  ];
+  const [bw, txPayloads] = await new BoundWitnessBuilder3().fields({
+    block,
+    chain: chainId,
+    previous,
+    step_hashes,
+    protocol
+  }).meta({ $epoch: Date.now(), $signatures: [] }).signers(signers).payloads(await PayloadBuilder25.addStorageMeta(payloads)).build();
+  assertEx49(isBlockBoundWitness(bw), () => "Build of BlockBoundWitness failed");
+  return [await PayloadBuilder25.addStorageMeta(bw), txPayloads.map((p) => asAnyPayload5(p, true))];
+}
+
+// src/test/buildNextBlock.ts
+async function buildNextBlock(previousBlock, txs, blockPayloads, signers, chainStepRewardAddress2 = XYO_STEP_REWARD_ADDRESS4, stepRewardPoolBalance = AttoXL15(0n), protocol, chainId) {
+  return await buildBlock({
+    chainId: chainId ?? previousBlock.chain,
+    previousBlockNumber: previousBlock.block,
+    previousStepHashes: previousBlock.step_hashes ?? [],
+    previousBlockHash: previousBlock._hash,
+    txs,
+    blockPayloads,
+    signers,
+    protocol,
+    chainStepRewardAddress: chainStepRewardAddress2,
+    stepRewardPoolBalance
+  });
+}
+
+// src/test/buildRandomGenesisBlock.ts
+import { asAddress, assertEx as assertEx50 } from "@xylabs/sdk-js";
+import {
+  Account as Account3,
+  asAnyPayload as asAnyPayload6,
+  asSchema as asSchema10,
+  IdSchema,
+  PayloadBuilder as PayloadBuilder26
+} from "@xyo-network/sdk-js";
+import {
+  asXL1BlockNumber as asXL1BlockNumber15
+} from "@xyo-network/xl1-protocol-lib";
+
+// src/test/buildGenesisBlock.ts
+import { XYO_ZERO_ADDRESS as XYO_ZERO_ADDRESS3 } from "@xyo-network/xl1-protocol-lib";
+async function buildGenesisBlock(chainId, txs, blockPayloads, signers, chainStepRewardAddress2 = XYO_ZERO_ADDRESS3, protocol) {
+  return await buildBlock({
+    previousBlockHash: null,
+    chainId,
+    txs,
+    blockPayloads,
+    signers,
+    chainStepRewardAddress: chainStepRewardAddress2,
+    protocol
+  });
+}
+
+// src/test/buildRandomTransaction.ts
+import { Account as Account2 } from "@xyo-network/sdk-js";
+import { asXL1BlockNumber as asXL1BlockNumber14, isAllowedBlockPayload as isAllowedBlockPayload3 } from "@xyo-network/xl1-protocol-lib";
+var buildRandomTransaction = async (chain, payloads, account, nbf = asXL1BlockNumber14(0, true), exp = asXL1BlockNumber14(nbf + 1e3, true), privatePayloadSchemas = [], receiverAddress) => {
+  const elevatedPayloads = (payloads ?? []).filter(isAllowedBlockPayload3);
+  const additionalPayloads = (payloads ?? []).filter((payload) => !isAllowedBlockPayload3(payload));
+  const sender = account ?? await Account2.random();
+  if (elevatedPayloads.length === 0) {
+    const receiver = receiverAddress ?? (await Account2.random()).address;
+    const transferPayload = createTransferPayload(sender.address, { [receiver]: 1n });
+    elevatedPayloads.push(transferPayload);
+  }
+  const hydratedTransaction = await buildTransaction(chain, elevatedPayloads, additionalPayloads, sender, nbf, exp);
+  return [hydratedTransaction[0], hydratedTransaction[1].filter((payload) => !privatePayloadSchemas.includes(payload.schema))];
+};
+
+// src/test/buildRandomGenesisBlock.ts
+var TestChainId = assertEx50(asAddress("c5fe2e6F6841Cbab12d8C0618Be2DF8C6156cC44"));
+
+// src/test/createGenesisBlock.ts
+import { PayloadBuilder as PayloadBuilder28 } from "@xyo-network/sdk-js";
+import {
+  BlockBoundWitnessSchemaPayload,
+  BlockBoundWitnessWithStorageMetaSchemaPayload,
+  ChainStakeIntentPayloadJsonSchemaPayload,
+  HashPayloadJsonSchemaPayload,
+  TransactionBoundWitnessSchemaPayload,
+  TransactionBoundWitnessWithStorageMetaSchemaPayload,
+  TransferPayloadJsonSchemaPayload
+} from "@xyo-network/xl1-schema";
+
+// src/test/createProducerChainStakeIntentTransaction.ts
+import { PayloadBuilder as PayloadBuilder27 } from "@xyo-network/sdk-js";
+import {
+  asXL1BlockNumber as asXL1BlockNumber16,
+  ChainStakeIntentSchema as ChainStakeIntentSchema2,
+  defaultTransactionFees as defaultTransactionFees4
+} from "@xyo-network/xl1-protocol-lib";
+async function createProducerChainStakeIntent(from, exp, nbf = 0) {
+  return await PayloadBuilder27.addHashMeta(new PayloadBuilder27({ schema: ChainStakeIntentSchema2 }).fields({
+    from,
+    exp,
+    nbf,
+    intent: "producer"
+  }).build());
+}
+
+// src/test/createGenesisBlock.ts
+var createGenesisBlock = async (initialBlockProducer, nextContractAddress, genesisBlockRewardAmount, genesisBlockRewardAddress) => {
+  const blockPayloads = await PayloadBuilder28.addHashMeta([
+    TransferPayloadJsonSchemaPayload,
+    BlockBoundWitnessSchemaPayload,
+    BlockBoundWitnessWithStorageMetaSchemaPayload,
+    TransactionBoundWitnessSchemaPayload,
+    TransactionBoundWitnessWithStorageMetaSchemaPayload,
+    ChainStakeIntentPayloadJsonSchemaPayload,
+    HashPayloadJsonSchemaPayload
+  ]);
+  const intentPayload = await createProducerChainStakeIntent(initialBlockProducer.address, 1, 0);
+  blockPayloads.push(intentPayload);
+  if (genesisBlockRewardAmount > 0n) {
+    blockPayloads.push(await PayloadBuilder28.addHashMeta(createTransferPayload(
+      nextContractAddress,
+      { [genesisBlockRewardAddress]: genesisBlockRewardAmount }
+    )));
+  }
+  return await buildGenesisBlock(nextContractAddress, [], blockPayloads, [initialBlockProducer]);
+};
+
+// src/test/buildRandomChain.ts
+var TestGenesisBlockRewardAddress = assertEx51(asAddress2("fa7f0bb865a4bfff3d5e2c726d3e063297014da9"));
+var buildRandomChain = async (blockProducer, count = 10, previousBlock, chainId, transactionAccount, receiverAddresses) => {
+  const chainIdToUse = chainId ?? TestChainId;
+  const blocks = [];
+  let remaining = count;
+  let lastBlock = previousBlock;
+  const transactionAccountToUse = transactionAccount ?? await Account4.random();
+  if (!lastBlock) {
+    const block = await createGenesisBlock(
+      blockProducer,
+      chainIdToUse,
+      1000000000n * 10n ** 18n,
+      transactionAccountToUse.address
+    );
+    blocks.push(block);
+    remaining = remaining - 1;
+    lastBlock = block;
+  }
+  const resolvedReceiverAddresses = receiverAddresses ?? [(await Account4.random()).address];
+  let saltCounter = 0;
+  while (remaining > 0) {
+    saltCounter += 1;
+    const payloads = [new PayloadBuilder29({ schema: IdSchema2 }).fields({ salt: `${Date.now()}-${saltCounter}` }).build()];
+    saltCounter += 1;
+    const additionalPrivatePayloads = remaining % 2 === 0 ? [new PayloadBuilder29({ schema: asSchema11("network.xyo.private", true) }).fields({ salt: `${Date.now()}-${saltCounter}` }).build()] : [];
+    const txs = [];
+    for (const receiverAddress of resolvedReceiverAddresses) {
+      txs.push(await buildRandomTransaction(
+        chainIdToUse,
+        [...payloads, ...additionalPrivatePayloads],
+        transactionAccountToUse,
+        asXL1BlockNumber17(Math.max(count - remaining - 1e3, 0), true),
+        asXL1BlockNumber17(count - remaining + 1e3, true),
+        [asSchema11("network.xyo.private", true)],
+        receiverAddress
+      ));
+    }
+    const previousBlock2 = assertEx51(lastBlock?.[0], () => new Error("No last block"));
+    const block = await buildNextBlock(previousBlock2, txs, [], [blockProducer], transactionAccountToUse.address);
+    blocks.push(block);
+    remaining = remaining - 1;
+    lastBlock = block;
+  }
+  return blocks;
+};
+async function buildRandomChainArchivist(count = 20) {
+  const producerAccount = await Account4.random();
+  const blocks = await buildRandomChain(producerAccount, count);
+  const archivist = await MemoryArchivist.create();
+  const payloads = flattenHydratedBlocks(blocks);
+  await archivist.insert(payloads);
+  return archivist;
+}
+
+// src/test/getSimpleBlockViewerLocator.ts
+import { XYO_ZERO_ADDRESS as XYO_ZERO_ADDRESS4 } from "@xyo-network/xl1-protocol-lib";
+
+// src/_internal/context/getTestProviderContext.ts
+function getTestProviderContext(config) {
+  const singletons = {};
+  const caches = {};
+  const locator = new ProviderFactoryLocator({
+    config,
+    singletons,
+    caches,
+    logger: console
+  });
+  return locator.context;
+}
+
+// src/test/getSimpleBlockViewerLocator.ts
+async function getTestSimpleBlockViewerLocator({
+  minWithdrawalBlocks = 10,
+  config = ConfigZod.parse({}),
+  finalizedArchivist: finalizedArchivistIn,
+  rewardsContract = XYO_ZERO_ADDRESS4,
+  stakingTokenAddress = XYO_ZERO_ADDRESS4
+}) {
+  const finalizedArchivist = finalizedArchivistIn ?? await buildRandomChainArchivist();
+  const context = getTestProviderContext(config);
+  context.locator.registerMany([
+    SimpleChainContractViewer.factory(SimpleChainContractViewer.dependencies, {
+      minWithdrawalBlocks,
+      rewardsContract,
+      stakingTokenAddress
+    }),
+    SimpleFinalizationViewer.factory(SimpleFinalizationViewer.dependencies, { finalizedArchivist }),
+    SimpleBlockViewer.factory(SimpleBlockViewer.dependencies, { finalizedArchivist })
+  ]);
+  return context.locator;
+}
+
+// src/test/getTestProviderContext.ts
+function getTestProviderContext2(config) {
+  return getTestProviderContext(config);
+}
+
 // src/time/primitives/xl1BlockNumberToEthBlockNumber.ts
-import { assertEx as assertEx49 } from "@xylabs/sdk-js";
+import { assertEx as assertEx52 } from "@xylabs/sdk-js";
 import { asTimePayload as asTimePayload3, TimeSchema as TimeSchema2 } from "@xyo-network/xl1-protocol-lib";
 async function xl1BlockNumberToEthBlockNumber(context, xl1BlockNumber) {
   const blockHash = await hashFromBlockNumber(context, xl1BlockNumber);
   const hydratedBlock = await hydrateBlock(context, blockHash);
   const timePayload = asTimePayload3(hydratedBlock[1].find((p) => p.schema === TimeSchema2), { required: true });
-  return assertEx49(timePayload.ethereum, () => "No ethereum timestamp found on block");
+  return assertEx52(timePayload.ethereum, () => "No ethereum timestamp found on block");
 }
 
 // src/validation/lib/isLocalhost.ts
@@ -6960,8 +7357,8 @@ var getUrl = (host, port) => {
 var TODO = true;
 
 // src/validation/schema/Mnemonic.ts
-import { z as z30 } from "zod";
-var MnemonicStringZod = z30.string().transform((s) => s.trim().replaceAll(/\s+/g, " ")).refine(
+import { z as z31 } from "zod";
+var MnemonicStringZod = z31.string().transform((s) => s.trim().replaceAll(/\s+/g, " ")).refine(
   (s) => [12, 15, 18, 21, 24].includes(s.split(" ").length),
   { message: "Mnemonic must contain 12, 15, 18, 21, or 24 words." }
 ).describe("BIP-39 mnemonic string");
@@ -7076,6 +7473,7 @@ export {
   SimpleXyoSigner,
   StepSummarySchema,
   TODO,
+  TestGenesisBlockRewardAddress,
   TransactionBuilder,
   TransfersStepSummarySchema,
   TypedDataDomainZod,
@@ -7133,6 +7531,9 @@ export {
   blocksMaxStep,
   blocksStepSummaryFromRange,
   blocksStepSummaryKey,
+  buildRandomChain,
+  buildRandomChainArchivist,
+  buildRandomTransaction,
   buildTransaction,
   buildUnsignedTransaction,
   bundledPayloadToHydratedBlock,
@@ -7171,11 +7572,14 @@ export {
   getEmptyContext,
   getEmptyProviderContext,
   getProducerKey,
+  getTestProviderContext2 as getTestProviderContext,
+  getTestSimpleBlockViewerLocator,
   getTimeConfigInMilliseconds,
   getUrl,
   getWindowedChain,
   hasLabels,
   hasMongoConfig,
+  hasR2Config,
   hashFromBlockNumber,
   hydrateBlock,
   hydrateElevatedTransaction,