@xyo-network/xl1-protocol-sdk 1.26.27 → 1.26.29

package/dist/neutral/test/index.mjs

@@ -11,18 +11,88 @@ var __decorateClass = (decorators, target, key, kind) => {
 };
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 
+// src/test/buildRandomTransaction.ts
+import { Account } from "@xyo-network/sdk-js";
+import { asXL1BlockNumber, isAllowedBlockPayload } from "@xyo-network/xl1-protocol-lib";
+
+// src/createTransferPayload.ts
+import { toHex } from "@xylabs/sdk-js";
+import { PayloadBuilder } from "@xyo-network/sdk-js";
+import { TransferSchema } from "@xyo-network/xl1-protocol-lib";
+function createTransferPayload(from, transfers, context) {
+  return new PayloadBuilder({ schema: TransferSchema }).fields({
+    epoch: Date.now(),
+    from,
+    transfers: Object.fromEntries(Object.entries(transfers).map(([k, v]) => [k, toHex(v)])),
+    context
+  }).build();
+}
+
+// src/transaction/buildTransaction.ts
+import { assertEx, toHex as toHex2 } from "@xylabs/sdk-js";
+import {
+  asAnyPayload,
+  BoundWitnessBuilder,
+  PayloadBuilder as PayloadBuilder2
+} from "@xyo-network/sdk-js";
+import { defaultTransactionFees } from "@xyo-network/xl1-protocol-lib";
+async function buildTransaction(chain, onChainPayloads, offChainPayloads, signer, nbf, exp, from, fees = defaultTransactionFees) {
+  if (from === void 0 && Array.isArray(signer)) {
+    throw new Error("from is required when signer is an array");
+  }
+  const txBoundWitnessFields = {
+    chain,
+    fees: {
+      base: toHex2(fees.base),
+      gasLimit: toHex2(fees.gasLimit),
+      gasPrice: toHex2(fees.gasPrice),
+      priority: toHex2(fees.priority)
+    },
+    nbf,
+    exp
+  };
+  const elevatedHashes = await PayloadBuilder2.hashes(onChainPayloads);
+  const script = [];
+  for (const elevatedHash of elevatedHashes) {
+    script.push(`elevate|${elevatedHash}`);
+  }
+  const fields = {
+    ...txBoundWitnessFields,
+    from: from ?? (Array.isArray(signer) ? assertEx(signer.at(0)?.address) : signer.address)
+  };
+  if (script.length > 0) {
+    fields.script = script;
+  }
+  const [tx, txPayloads] = await new BoundWitnessBuilder().fields(fields).meta({ $signatures: [] }).payloads([...onChainPayloads, ...offChainPayloads]).signers(Array.isArray(signer) ? signer : [signer]).build();
+  return [await PayloadBuilder2.addHashMeta(tx), await PayloadBuilder2.addHashMeta(txPayloads.map((p) => asAnyPayload(p, true)))];
+}
+
+// src/test/buildRandomTransaction.ts
+var buildRandomTransaction = async (chain, payloads, account, nbf = asXL1BlockNumber(0, true), exp = asXL1BlockNumber(nbf + 1e3, true), privatePayloadSchemas = [], receiverAddress) => {
+  const elevatedPayloads = (payloads ?? []).filter(isAllowedBlockPayload);
+  const additionalPayloads = (payloads ?? []).filter((payload) => !isAllowedBlockPayload(payload));
+  const sender = account ?? await Account.random();
+  if (elevatedPayloads.length === 0) {
+    const receiver = receiverAddress ?? (await Account.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/getSimpleBlockViewerLocator.ts
 import { XYO_ZERO_ADDRESS as XYO_ZERO_ADDRESS3 } from "@xyo-network/xl1-protocol-lib";
 
 // src/CreatableProvider/AbstractCreatableProvider.ts
 import {
   AbstractCreatable,
-  assertEx as assertEx2,
+  assertEx as assertEx3,
   IdLogger
 } from "@xylabs/sdk-js";
 
 // src/CreatableProvider/ProviderFactory.ts
-import { assertEx } from "@xylabs/sdk-js";
+import { assertEx as assertEx2 } from "@xylabs/sdk-js";
 function providerFactoryDescription(factory, labels) {
   return `${factory.providerName}:${factory.defaultMoniker}:${JSON.stringify(labels ?? factory.labels ?? {})}`;
 }
@@ -43,7 +113,7 @@ var ProviderFactory = class _ProviderFactory {
     this.dependencies = dependencies;
     this.monikers = creatableProvider2.monikers;
     this.scope = scope;
-    assertEx(this.monikers.includes(this.defaultMoniker), () => "defaultMoniker must be in monikers");
+    assertEx2(this.monikers.includes(this.defaultMoniker), () => "defaultMoniker must be in monikers");
     this.labels = Object.assign({}, creatableProvider2.labels ?? {}, labels ?? {});
     this.providerName = creatableProvider2.name;
     this._uniqueId = Symbol(providerFactoryDescription(this));
@@ -71,7 +141,7 @@ var ProviderFactory = class _ProviderFactory {
         break;
       }
       case "context": {
-        const context = assertEx(
+        const context = assertEx2(
           params?.context,
           () => "Context is required for context-scoped providers"
         );
@@ -92,7 +162,7 @@ var ProviderFactory = class _ProviderFactory {
     scopeObject[this.resolvedMoniker] = resultPromise;
     const result = await resultPromise;
     if (start) {
-      assertEx(await result.start(), () => `Failed to start provider instance [${this.resolvedMoniker}]`);
+      assertEx2(await result.start(), () => `Failed to start provider instance [${this.resolvedMoniker}]`);
     }
     return result;
   }
@@ -137,9 +207,9 @@ var AbstractCreatableProvider = class extends AbstractCreatable {
     return factory;
   }
   static async paramsHandler(params = {}) {
-    const context = assertEx2(params.context, () => new Error("Context is required"));
-    const config = assertEx2(context.config, () => new Error("Context config is required"));
-    const locator = assertEx2(context.locator, () => new Error("Context locator is required"));
+    const context = assertEx3(params.context, () => new Error("Context is required"));
+    const config = assertEx3(context.config, () => new Error("Context config is required"));
+    const locator = assertEx3(context.locator, () => new Error("Context locator is required"));
     return await super.paramsHandler({
       ...params,
       statusReporter: params.statusReporter ?? context.statusReporter,
@@ -234,7 +304,7 @@ var hasLabels = (factory) => {
 
 // src/CreatableProvider/ProviderFactoryLocator.ts
 import { hasAllLabels } from "@xylabs/sdk-js";
-import { assertEx as assertEx3 } from "@xylabs/sdk-js";
+import { assertEx as assertEx4 } from "@xylabs/sdk-js";
 var ProviderFactoryLocator = class _ProviderFactoryLocator {
   _context;
   _registry;
@@ -266,7 +336,7 @@ var ProviderFactoryLocator = class _ProviderFactoryLocator {
     this._frozen = true;
   }
   async getInstance(moniker, { start = true, labels } = {}) {
-    return assertEx3(
+    return assertEx4(
       await this.tryGetInstance(moniker, { start, labels }),
       () => `No provider instance for the supplied config moniker [${moniker}]${labels ? ` & labels [${JSON.stringify(labels)}]` : ""} could be created`
     );
@@ -281,7 +351,7 @@ var ProviderFactoryLocator = class _ProviderFactoryLocator {
    * @returns A provider factory that matches the supplied moniker and labels or throws if one is not found
    */
   locate(moniker, labels) {
-    return assertEx3(
+    return assertEx4(
       this.tryLocate(moniker, labels),
       () => `No module factory for the supplied config moniker [${moniker}]${labels ? ` & labels [${JSON.stringify(labels)}]` : ""} registered`
     );
@@ -303,10 +373,10 @@ var ProviderFactoryLocator = class _ProviderFactoryLocator {
    * @param labels The labels for the module factory
    */
   register(factory, labels, primary = false) {
-    assertEx3(!this._frozen, () => "Cannot register a module factory after the locator has been frozen");
+    assertEx4(!this._frozen, () => "Cannot register a module factory after the locator has been frozen");
     if (this.validateDepsOnRegister) {
       const missingDeps = factory.dependencies.filter((dep) => !this.registered(dep));
-      assertEx3(missingDeps.length === 0, () => `Cannot register module factory [${factory.uniqueId.description}] due to missing dependencies: ${missingDeps.join(", ")}`);
+      assertEx4(missingDeps.length === 0, () => `Cannot register module factory [${factory.uniqueId.description}] due to missing dependencies: ${missingDeps.join(", ")}`);
     }
     registerCreatableProviderFactory(this._registry, factory, labels, primary);
     return this;
@@ -354,7 +424,7 @@ var ProviderFactoryLocator = class _ProviderFactoryLocator {
     for (const moniker in this.registry) {
       for (const factory of this.registry[moniker] ?? []) {
         const missingDeps = factory.dependencies.filter((dep) => !this.registered(dep));
-        assertEx3(missingDeps.length === 0, () => `Module factory [${factory.uniqueId.description}] is missing dependencies: ${missingDeps.join(", ")}`);
+        assertEx4(missingDeps.length === 0, () => `Module factory [${factory.uniqueId.description}] is missing dependencies: ${missingDeps.join(", ")}`);
       }
     }
   }
@@ -640,7 +710,7 @@ import { isDefined as isDefined3, isFalsy } from "@xylabs/sdk-js";
 import { asXL1BlockRange } from "@xyo-network/xl1-protocol-lib";
 
 // src/primitives/block/rate/timeHelpers.ts
-import { assertEx as assertEx4, isDefined as isDefined2 } from "@xylabs/sdk-js";
+import { assertEx as assertEx5, isDefined as isDefined2 } from "@xylabs/sdk-js";
 var rateMultipliers = {
   millis: 1,
   seconds: 1e3,
@@ -658,7 +728,7 @@ var timeDurations = (timeInMs) => ({
   weeks: timeInMs / (1e3 * 60 * 60 * 24 * 7)
 });
 var getTimeConfigInMilliseconds = (timeConfig) => {
-  const assertedTimeConfig = assertEx4(isDefined2(timeConfig) ? timeConfig : void 0, () => "Time configuration must be provided");
+  const assertedTimeConfig = assertEx5(isDefined2(timeConfig) ? timeConfig : void 0, () => "Time configuration must be provided");
   let totalMilliseconds = 0;
   if ("years" in assertedTimeConfig) {
     totalMilliseconds += assertedTimeConfig.years * 31536e6;
@@ -733,7 +803,7 @@ var calculateBlockRate = async (viewer, range, timeUnit) => {
 };
 
 // src/primitives/block/rate/stepRate.ts
-import { assertEx as assertEx5 } from "@xylabs/sdk-js";
+import { assertEx as assertEx6 } from "@xylabs/sdk-js";
 import {
   asXL1BlockRange as asXL1BlockRange2,
   isValidStep,
@@ -745,26 +815,26 @@ var stepRate = async (viewer, start, step, count = 1, timeUnit) => {
   return await calculateBlockRate(viewer, range, timeUnit);
 };
 var calculateStepSizeRate = async (viewer, start, stepIndex, count = 1, timeUnit) => {
-  assertEx5(isValidStep(stepIndex), () => `Invalid step index: ${stepIndex}`);
+  assertEx6(isValidStep(stepIndex), () => `Invalid step index: ${stepIndex}`);
   const step = StepSizes[stepIndex];
   return await stepRate(viewer, start, step, count, timeUnit);
 };
 
 // src/primitives/block/rate/timeRate.ts
 import {
-  assertEx as assertEx6,
+  assertEx as assertEx7,
   isDefined as isDefined4,
   isDefinedNotNull
 } from "@xylabs/sdk-js";
-import { asXL1BlockNumber, asXL1BlockRange as asXL1BlockRange3 } from "@xyo-network/xl1-protocol-lib";
+import { asXL1BlockNumber as asXL1BlockNumber2, asXL1BlockRange as asXL1BlockRange3 } from "@xyo-network/xl1-protocol-lib";
 var DEFAULT_TOLERANCE_MS = 3e4;
 var DEFAULT_MAX_ATTEMPTS = 10;
 var calculateTimeRate = async (viewer, timeConfig, startBlockNumber, timeUnit, toleranceMs = DEFAULT_TOLERANCE_MS, maxAttempts = DEFAULT_MAX_ATTEMPTS) => {
-  assertEx6(Object.keys(timeConfig ?? {}).length === 1, () => "Only one time unit should be specified in timeConfig");
+  assertEx7(Object.keys(timeConfig ?? {}).length === 1, () => "Only one time unit should be specified in timeConfig");
   const startBlock = isDefinedNotNull(startBlockNumber) ? await viewer.blockByNumber(startBlockNumber) : null;
   const resolvedStartBlock = isDefinedNotNull(startBlock) ? startBlock[0] : (await viewer.currentBlock())[0];
   const timeInMilliseconds = getTimeConfigInMilliseconds(timeConfig);
-  assertEx6(timeInMilliseconds > 0, () => "Time duration must be greater than zero");
+  assertEx7(timeInMilliseconds > 0, () => "Time duration must be greater than zero");
   const blocksPerMillisecondRate = 1 / (12 * 1e3);
   const initialBlocksInDuration = Math.floor(blocksPerMillisecondRate * timeInMilliseconds);
   const endBlockNumber = await findEndBlockRecursive(
@@ -783,14 +853,14 @@ var calculateTimeRate = async (viewer, timeConfig, startBlockNumber, timeUnit, t
 };
 var findEndBlockRecursive = async (viewer, startBlock, targetTimeMs, estimatedBlocksBack, toleranceMs, attemptsRemaining) => {
   console.log(`Attempts remaining: ${attemptsRemaining}, Estimated blocks back: ${estimatedBlocksBack}`);
-  assertEx6(attemptsRemaining >= 0, () => "Maximum attempts reached while searching for end block");
+  assertEx7(attemptsRemaining >= 0, () => "Maximum attempts reached while searching for end block");
   const startBlockEpoch = startBlock.$epoch;
-  const estimatedEndBlockNumber = asXL1BlockNumber(startBlock.block - estimatedBlocksBack, true);
+  const estimatedEndBlockNumber = asXL1BlockNumber2(startBlock.block - estimatedBlocksBack, true);
   if (estimatedEndBlockNumber < 0) {
     throw new Error("Estimated end block number is less than zero");
   }
   const endBlock = await viewer.blockByNumber(estimatedEndBlockNumber);
-  const resolvedEndBlock = assertEx6(
+  const resolvedEndBlock = assertEx7(
     isDefined4(endBlock?.[0]) ? endBlock[0] : void 0,
     () => `Could not retrieve block ${estimatedEndBlockNumber} for time rate calculation`
   );
@@ -825,16 +895,6 @@ var findEndBlockRecursive = async (viewer, startBlock, targetTimeMs, estimatedBl
   );
 };
 
-// src/primitives/step/completedStepRewardAddress.ts
-import { toAddress } from "@xylabs/sdk-js";
-import { StepSizes as StepSizes2 } from "@xyo-network/xl1-protocol-lib";
-import { keccak256 } from "ethers";
-function completedStepRewardAddress({ block, step }) {
-  const resolvedStepSize = step < StepSizes2.length ? StepSizes2[step] : step;
-  const addressKey = new TextEncoder().encode(`${block}|${resolvedStepSize}`);
-  return toAddress(keccak256(addressKey).slice(-40), { prefix: false });
-}
-
 // src/ChainContextHelpers.ts
 import {
   isDefined as isDefined6,
@@ -964,30 +1024,30 @@ var flattenHydratedBlock = (hydratedBlock) => {
 var flattenHydratedBlocks = (hydratedBlocks) => hydratedBlocks.flatMap((blk) => flattenHydratedBlock(blk));
 
 // src/block/hydrate/hydrateBlock.ts
-import { assertEx as assertEx7 } from "@xylabs/sdk-js";
-import { asAnyPayload } from "@xyo-network/sdk-js";
+import { assertEx as assertEx8 } from "@xylabs/sdk-js";
+import { asAnyPayload as asAnyPayload2 } from "@xyo-network/sdk-js";
 import { asBlockBoundWitnessWithStorageMeta, isTransactionBoundWitnessWithStorageMeta } from "@xyo-network/xl1-protocol-lib";
 var hydrateBlock = async (context, hash, maxDepth = 1, minDepth = maxDepth) => {
-  assertEx7(maxDepth >= 0, () => "maxDepth must be greater than or equal to 0");
-  assertEx7(minDepth >= 0, () => "minDepth must be greater than or equal to 0");
-  assertEx7(maxDepth >= minDepth, () => "maxDepth must be greater than or equal to minDepth");
+  assertEx8(maxDepth >= 0, () => "maxDepth must be greater than or equal to 0");
+  assertEx8(minDepth >= 0, () => "minDepth must be greater than or equal to 0");
+  assertEx8(maxDepth >= minDepth, () => "maxDepth must be greater than or equal to minDepth");
   const { chainMap } = context;
   const [block] = await chainMap.get([hash]);
-  const bw = assertEx7(asBlockBoundWitnessWithStorageMeta(
-    assertEx7(block, () => `block ${hash} not found`)
+  const bw = assertEx8(asBlockBoundWitnessWithStorageMeta(
+    assertEx8(block, () => `block ${hash} not found`)
   ), () => `hash ${hash} is not a BlockBoundWitness`);
   if (maxDepth === 0) return [bw, []];
-  const blkPayloads = (await chainMap.get(bw.payload_hashes)).map((p) => asAnyPayload(p, true));
-  if (minDepth === 1) assertEx7(allHashesPresent(bw.payload_hashes, blkPayloads), () => `Unable to find all payloads for block ${hash}`);
+  const blkPayloads = (await chainMap.get(bw.payload_hashes)).map((p) => asAnyPayload2(p, true));
+  if (minDepth === 1) assertEx8(allHashesPresent(bw.payload_hashes, blkPayloads), () => `Unable to find all payloads for block ${hash}`);
   if (maxDepth === 1) return [bw, blkPayloads];
   const transactions = blkPayloads.filter(isTransactionBoundWitnessWithStorageMeta);
   const transactionsPayloadHashes = transactions.flatMap((tx) => tx.payload_hashes);
-  const transactionsPayloads = (await chainMap.get(transactionsPayloadHashes)).map((p) => asAnyPayload(p, true));
-  assertEx7(allHashesPresent(transactionsPayloadHashes, transactionsPayloads), () => `Unable to find all payloads for transactions in block ${hash}`);
+  const transactionsPayloads = (await chainMap.get(transactionsPayloadHashes)).map((p) => asAnyPayload2(p, true));
+  assertEx8(allHashesPresent(transactionsPayloadHashes, transactionsPayloads), () => `Unable to find all payloads for transactions in block ${hash}`);
   const allPayloadsHashes = new Set([...blkPayloads, ...transactionsPayloads].flatMap((p) => p._hash));
-  const allPayloads = (await chainMap.get([...allPayloadsHashes])).map((p) => asAnyPayload(p, true));
+  const allPayloads = (await chainMap.get([...allPayloadsHashes])).map((p) => asAnyPayload2(p, true));
   const allPayloadsFiltered = allPayloads.filter((p) => allPayloadsHashes.has(p._hash));
-  if (maxDepth === 2) assertEx7(allHashesPresent(
+  if (maxDepth === 2) assertEx8(allHashesPresent(
     [...allPayloadsHashes],
     allPayloadsFiltered
   ), () => `Unable to find all payloads for transactions in block ${hash}`);
@@ -1004,7 +1064,7 @@ import { toSafeJsonString } from "@xylabs/sdk-js";
 import {
   asSignedBlockBoundWitnessWithStorageMeta,
   SignedBlockBoundWitnessWithHashMetaZod,
-  StepSizes as StepSizes3
+  StepSizes as StepSizes2
 } from "@xyo-network/xl1-protocol-lib";
 async function blockFromBlockNumber(context, blockNumber) {
   return await spanAsync("blockFromBlockNumber", async () => {
@@ -1025,7 +1085,7 @@ async function blockFromBlockNumber(context, blockNumber) {
       while (currentBlock.block > blockNumber) {
         let jumpHash = currentBlock.previous;
         let jumpBlockNumber = currentBlock.block - 1;
-        for (const [step, stepSize] of StepSizes3.entries()) {
+        for (const [step, stepSize] of StepSizes2.entries()) {
           const possibleJumpBlockNumber = currentBlock.block - currentBlock.block % stepSize - 1;
           if (possibleJumpBlockNumber >= blockNumber && possibleJumpBlockNumber <= jumpBlockNumber) {
             jumpBlockNumber = possibleJumpBlockNumber;
@@ -1059,12 +1119,12 @@ async function blockFromBlockNumber(context, blockNumber) {
 
 // src/block/primitives/validateTransactionOpcodes.ts
 import {
-  assertEx as assertEx8,
+  assertEx as assertEx9,
   isHash,
   toSafeJsonString as toSafeJsonString2
 } from "@xylabs/sdk-js";
 import {
-  PayloadBuilder
+  PayloadBuilder as PayloadBuilder3
 } from "@xyo-network/sdk-js";
 import { isExecutable } from "@xyo-network/xl1-protocol-lib";
 async function validateTransactionsOpcodes(txs) {
@@ -1076,14 +1136,14 @@ async function validateTransactionsOpcodes(txs) {
         switch (opCode) {
           case "elevate": {
             const [hash, ...rest] = args;
-            const txPayloadsWithStorageMeta = await PayloadBuilder.addStorageMeta(txPayloads);
-            assertEx8(rest.length === 0, () => `Invalid elevate operation ${opCode} ${args.join(", ")} - Too many Arguments`);
+            const txPayloadsWithStorageMeta = await PayloadBuilder3.addStorageMeta(txPayloads);
+            assertEx9(rest.length === 0, () => `Invalid elevate operation ${opCode} ${args.join(", ")} - Too many Arguments`);
             if (isHash(hash)) {
-              assertEx8(
+              assertEx9(
                 txBw.payload_hashes.includes(hash),
                 () => `Invalid elevate operation ${opCode} ${args.join(", ")} - Hash not in payload hashes => ${toSafeJsonString2(txBw, 20)}`
               );
-              const txPayload = assertEx8(
+              const txPayload = assertEx9(
                 txPayloadsWithStorageMeta.find((p) => p._hash === hash),
                 () => `Invalid elevate operation ${opCode} ${args.join(", ")} - Payload not found`
               );
@@ -1105,12 +1165,12 @@ async function validateTransactionsOpcodes(txs) {
 
 // src/primitives/datalake/addDataLakePayloadsToPayloads.ts
 import { isUndefined as isUndefined3 } from "@xylabs/sdk-js";
-import { isAnyPayload, PayloadBuilder as PayloadBuilder2 } from "@xyo-network/sdk-js";
+import { isAnyPayload, PayloadBuilder as PayloadBuilder4 } from "@xyo-network/sdk-js";
 async function addDataLakePayloadsToPayloads(hashes, payloads, dataLakeViewer) {
   if (isUndefined3(dataLakeViewer)) return [payloads, []];
   const missingPayloadHashes = hashes.filter((hash) => !payloads.some((p) => p._hash === hash));
-  const payloadsFromDataLake = await PayloadBuilder2.addHashMeta(
-    await PayloadBuilder2.addHashMeta((await dataLakeViewer.get(missingPayloadHashes)).filter(isAnyPayload))
+  const payloadsFromDataLake = await PayloadBuilder4.addHashMeta(
+    await PayloadBuilder4.addHashMeta((await dataLakeViewer.get(missingPayloadHashes)).filter(isAnyPayload))
   );
   return [[...payloads, ...payloadsFromDataLake], payloadsFromDataLake.map((p) => p._hash)];
 }
@@ -1155,7 +1215,7 @@ var findMostRecentBlock = async (chainArchivist, nextOptions = DEFAULT_NEXT_OPTI
 };
 
 // src/primitives/state/hydratedBlockByNumber.ts
-import { assertEx as assertEx9, spanAsync as spanAsync2 } from "@xylabs/sdk-js";
+import { assertEx as assertEx10, spanAsync as spanAsync2 } from "@xylabs/sdk-js";
 async function hydratedBlockByNumber(context, blockNumber) {
   return await spanAsync2("hydratedBlockByNumber", async () => {
     if (blockNumber < 0) throw new Error(`Block number ${blockNumber} is less than 0`);
@@ -1163,7 +1223,7 @@ async function hydratedBlockByNumber(context, blockNumber) {
     if (blockNumber % 1 !== 0) throw new Error(`Block number ${blockNumber} is not an integer`);
     const cacheKey = `${blockNumber}`;
     return await withContextCacheResponse(context, "hydratedBlockByNumber", cacheKey, async () => {
-      const block = assertEx9(
+      const block = assertEx10(
         await blockFromBlockNumber(context, blockNumber),
         () => `Could not find block for block number ${blockNumber}`
       );
@@ -1252,14 +1312,14 @@ var ConfigZod = BaseConfigZod.extend({ actors: ActorsConfigZod }).describe("The
 
 // src/simple/block/SimpleBlockViewer.ts
 import {
-  assertEx as assertEx10,
+  assertEx as assertEx11,
   exists,
   isUndefined as isUndefined4
 } from "@xylabs/sdk-js";
 import {
   asSignedHydratedBlockWithHashMeta,
   asSignedHydratedBlockWithStorageMeta,
-  asXL1BlockNumber as asXL1BlockNumber2,
+  asXL1BlockNumber as asXL1BlockNumber3,
   BlockViewerMoniker,
   DataLakeViewerMoniker,
   FinalizationViewerMoniker
@@ -1315,7 +1375,7 @@ var SimpleBlockViewer = class extends AbstractCreatableProvider {
   static async paramsHandler(params) {
     return {
       ...await super.paramsHandler(params),
-      finalizedArchivist: assertEx10(params.finalizedArchivist, () => "finalizedArchivist is required")
+      finalizedArchivist: assertEx11(params.finalizedArchivist, () => "finalizedArchivist is required")
     };
   }
   async blockByHash(hash) {
@@ -1344,8 +1404,8 @@ var SimpleBlockViewer = class extends AbstractCreatableProvider {
   }
   async blocksByHash(hash, limit = 50) {
     return await this.spanAsync("blocksByHash", async () => {
-      assertEx10(limit > 0, () => "limit must be greater than 0");
-      assertEx10(limit <= 100, () => "limit must be less than 100");
+      assertEx11(limit > 0, () => "limit must be greater than 0");
+      assertEx11(limit <= 100, () => "limit must be less than 100");
       const blocks = [];
       let current = await this.blockByHash(hash);
       while (current && blocks.length < limit) {
@@ -1359,8 +1419,8 @@ var SimpleBlockViewer = class extends AbstractCreatableProvider {
   }
   async blocksByNumber(blockNumber, limit = 50) {
     return await this.spanAsync("blocksByNumber", async () => {
-      assertEx10(limit > 0, () => "limit must be greater than 0");
-      assertEx10(limit <= 100, () => "limit must be less than 100");
+      assertEx11(limit > 0, () => "limit must be greater than 0");
+      assertEx11(limit <= 100, () => "limit must be less than 100");
       const chainContext = await this.getChainContextRead();
       if (isUndefined4(chainContext.head)) {
         return [];
@@ -1370,7 +1430,7 @@ var SimpleBlockViewer = class extends AbstractCreatableProvider {
       while (current && blocks.length < limit) {
         blocks.push(current);
         if (current[0].block === 0) break;
-        const previousNumber = asXL1BlockNumber2(current[0].block - 1, true);
+        const previousNumber = asXL1BlockNumber3(current[0].block - 1, true);
         current = await this.blockByNumberWithContext(chainContext, previousNumber);
       }
       return blocks.map((b) => asSignedHydratedBlockWithHashMeta(b, true));
@@ -1378,7 +1438,7 @@ var SimpleBlockViewer = class extends AbstractCreatableProvider {
   }
   async chainId(blockNumber = "latest") {
     return await this.spanAsync("chainId", async () => {
-      return blockNumber === "latest" ? (await this.finalizationViewer.headBlock()).chain : assertEx10(await this.blockByNumber(blockNumber), () => `Block not found [${blockNumber}]`)[0].chain;
+      return blockNumber === "latest" ? (await this.finalizationViewer.headBlock()).chain : assertEx11(await this.blockByNumber(blockNumber), () => `Block not found [${blockNumber}]`)[0].chain;
     }, this.context);
   }
   async createHandler() {
@@ -1449,7 +1509,7 @@ SimpleBlockViewer = __decorateClass([
 
 // src/simple/chainContractViewer/SimpleChainContractViewer.ts
 import {
-  assertEx as assertEx11
+  assertEx as assertEx12
 } from "@xylabs/sdk-js";
 import {
   ChainContractViewerMoniker,
@@ -1470,7 +1530,7 @@ var SimpleChainContractViewer = class extends AbstractCreatableProvider {
       let contractViewer = this;
       let forkedAtBlockNumber = await contractViewer.forkedAtBlockNumber();
       while (forkedAtBlockNumber !== null && blockNumber <= forkedAtBlockNumber) {
-        contractViewer = assertEx11(await contractViewer.forkedChainContractViewer());
+        contractViewer = assertEx12(await contractViewer.forkedChainContractViewer());
         forkedAtBlockNumber = await contractViewer.forkedAtBlockNumber();
         chainId = await contractViewer.chainId();
       }
@@ -1512,7 +1572,7 @@ SimpleChainContractViewer = __decorateClass([
 
 // src/simple/finalization/SimpleFinalizationViewer.ts
 import {
-  assertEx as assertEx12
+  assertEx as assertEx13
 } from "@xylabs/sdk-js";
 import {
   asSignedHydratedBlockWithStorageMeta as asSignedHydratedBlockWithStorageMeta2,
@@ -1542,7 +1602,7 @@ var SimpleFinalizationViewer = class extends AbstractCreatableProvider {
   static async paramsHandler(params) {
     return {
       ...await super.paramsHandler(params),
-      finalizedArchivist: assertEx12(params.finalizedArchivist, () => "finalizedArchivist is required")
+      finalizedArchivist: assertEx13(params.finalizedArchivist, () => "finalizedArchivist is required")
     };
   }
   chainId() {
@@ -1550,18 +1610,18 @@ var SimpleFinalizationViewer = class extends AbstractCreatableProvider {
   }
   async createHandler() {
     await super.createHandler();
-    this._chainId = assertEx12(this.config.chain.id ?? (await findMostRecentBlock(this.params.finalizedArchivist))?.chain, () => "chain.id is required if empty archivist");
+    this._chainId = assertEx13(this.config.chain.id ?? (await findMostRecentBlock(this.params.finalizedArchivist))?.chain, () => "chain.id is required if empty archivist");
     this._store = { chainMap: this.params.finalizedArchivist };
   }
   async head() {
     return await this.spanAsync("head", async () => {
-      const currentHead = assertEx12(await this.getCurrentHead(), () => "Could not find most recent block [currentBlock]");
+      const currentHead = assertEx13(await this.getCurrentHead(), () => "Could not find most recent block [currentBlock]");
       const cache = this.hydratedBlockCache;
       const block = await cache.get(currentHead._hash);
       if (!block) {
         console.log(`Could not find current block with hash ${currentHead._hash}`);
       }
-      return assertEx12(block, () => "Could not find current block");
+      return assertEx13(block, () => "Could not find current block");
     }, this.context);
   }
   async headBlock() {
@@ -1587,8 +1647,8 @@ var SimpleFinalizationViewer = class extends AbstractCreatableProvider {
   }
   async getCurrentHead() {
     const chainArchivist = this.finalizedArchivist;
-    const result = assertEx12(await findMostRecentBlock(chainArchivist), () => "Could not find most recent block [getCurrentHead]");
-    assertEx12(result?.chain === this._chainId, () => "Chain ID does not match head block chain ID");
+    const result = assertEx13(await findMostRecentBlock(chainArchivist), () => "Could not find most recent block [getCurrentHead]");
+    assertEx13(result?.chain === this._chainId, () => "Chain ID does not match head block chain ID");
     return result;
   }
 };
@@ -1599,76 +1659,6 @@ SimpleFinalizationViewer = __decorateClass([
   creatableProvider()
 ], SimpleFinalizationViewer);
 
-// src/transaction/buildRandomTransaction.ts
-import { Account } from "@xyo-network/sdk-js";
-import { asXL1BlockNumber as asXL1BlockNumber3, isAllowedBlockPayload } from "@xyo-network/xl1-protocol-lib";
-
-// src/createTransferPayload.ts
-import { toHex } from "@xylabs/sdk-js";
-import { PayloadBuilder as PayloadBuilder3 } from "@xyo-network/sdk-js";
-import { TransferSchema } from "@xyo-network/xl1-protocol-lib";
-function createTransferPayload(from, transfers, context) {
-  return new PayloadBuilder3({ schema: TransferSchema }).fields({
-    epoch: Date.now(),
-    from,
-    transfers: Object.fromEntries(Object.entries(transfers).map(([k, v]) => [k, toHex(v)])),
-    context
-  }).build();
-}
-
-// src/transaction/buildTransaction.ts
-import { assertEx as assertEx13, toHex as toHex2 } from "@xylabs/sdk-js";
-import {
-  asAnyPayload as asAnyPayload2,
-  BoundWitnessBuilder,
-  PayloadBuilder as PayloadBuilder4
-} from "@xyo-network/sdk-js";
-import { defaultTransactionFees } from "@xyo-network/xl1-protocol-lib";
-async function buildTransaction(chain, onChainPayloads, offChainPayloads, signer, nbf, exp, from, fees = defaultTransactionFees) {
-  if (from === void 0 && Array.isArray(signer)) {
-    throw new Error("from is required when signer is an array");
-  }
-  const txBoundWitnessFields = {
-    chain,
-    fees: {
-      base: toHex2(fees.base),
-      gasLimit: toHex2(fees.gasLimit),
-      gasPrice: toHex2(fees.gasPrice),
-      priority: toHex2(fees.priority)
-    },
-    nbf,
-    exp
-  };
-  const elevatedHashes = await PayloadBuilder4.hashes(onChainPayloads);
-  const script = [];
-  for (const elevatedHash of elevatedHashes) {
-    script.push(`elevate|${elevatedHash}`);
-  }
-  const fields = {
-    ...txBoundWitnessFields,
-    from: from ?? (Array.isArray(signer) ? assertEx13(signer.at(0)?.address) : signer.address)
-  };
-  if (script.length > 0) {
-    fields.script = script;
-  }
-  const [tx, txPayloads] = await new BoundWitnessBuilder().fields(fields).meta({ $signatures: [] }).payloads([...onChainPayloads, ...offChainPayloads]).signers(Array.isArray(signer) ? signer : [signer]).build();
-  return [await PayloadBuilder4.addHashMeta(tx), await PayloadBuilder4.addHashMeta(txPayloads.map((p) => asAnyPayload2(p, true)))];
-}
-
-// src/transaction/buildRandomTransaction.ts
-var buildRandomTransaction = async (chain, payloads, account, nbf = asXL1BlockNumber3(0, true), exp = asXL1BlockNumber3(nbf + 1e3, true), privatePayloadSchemas = [], receiverAddress) => {
-  const elevatedPayloads = (payloads ?? []).filter(isAllowedBlockPayload);
-  const additionalPayloads = (payloads ?? []).filter((payload) => !isAllowedBlockPayload(payload));
-  const sender = account ?? await Account.random();
-  if (elevatedPayloads?.length === 0) {
-    const receiver = receiverAddress ?? (await Account.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((p) => !privatePayloadSchemas.includes(p.schema))];
-};
-
 // src/test/buildRandomChain.ts
 import { asAddress as asAddress3, assertEx as assertEx16 } from "@xylabs/sdk-js";
 import {
@@ -1698,9 +1688,10 @@ import {
 import {
   asXL1BlockNumber as asXL1BlockNumber4,
   AttoXL1,
+  completedStepRewardAddress,
   isBlockBoundWitness,
   StepRewardFractions,
-  StepSizes as StepSizes4,
+  StepSizes as StepSizes3,
   XL1_PROTOCOL_VERSION,
   XYO_STEP_REWARD_ADDRESS,
   XYO_ZERO_ADDRESS
@@ -1782,7 +1773,7 @@ async function buildBlock(options) {
     }
   }
   const completedStepRewardTransfers = [];
-  for (const [i, step] of StepSizes4.entries()) {
+  for (const [i, step] of StepSizes3.entries()) {
     if (blockNumber < step) {
       break;
     }
@@ -1997,6 +1988,7 @@ function getTestProviderContext2(config) {
   return getTestProviderContext(config);
 }
 export {
+  buildRandomTransaction,
   getTestProviderContext2 as getTestProviderContext,
   getTestSimpleBlockViewerLocator
 };