@xyo-network/xl1-protocol-sdk 1.5.28 → 1.5.30

package/dist/neutral/index.mjs

@@ -1,8 +1,190 @@
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 
-// src/transaction/buildTransaction.ts
+// src/block/hydrateBlock.ts
+import { filterAs } from "@xylabs/array";
 import { assertEx } from "@xylabs/assert";
+import { asOptionalBlockBoundWitnessWithStorageMeta, asOptionalTransactionBoundWitnessWithStorageMeta, isTransactionBoundWitnessWithStorageMeta } from "@xyo-network/xl1-protocol";
+function allHashesPresent(hashes, payloads) {
+  const payloadHashes = new Set(payloads.map((p) => p._hash));
+  return hashes.every((hash) => payloadHashes.has(hash));
+}
+__name(allHashesPresent, "allHashesPresent");
+var tryHydrateBlock = /* @__PURE__ */ __name(async (archivist, hash, maxDepth = 1, minDepth) => {
+  try {
+    return await hydrateBlock(archivist, hash, maxDepth, minDepth);
+  } catch (e) {
+    if (e instanceof Error) {
+      console.warn(`Failed to hydrate block ${hash}: ${e.message}`);
+    } else {
+      console.warn(`Failed to hydrate block ${hash}: ${e}`);
+    }
+    return void 0;
+  }
+}, "tryHydrateBlock");
+var hydrateBlock = /* @__PURE__ */ __name(async (archivist, hash, maxDepth = 1, minDepth) => {
+  if (minDepth === void 0) minDepth = maxDepth;
+  assertEx(maxDepth >= 0, () => "maxDepth must be greater than or equal to 0");
+  assertEx(minDepth >= 0, () => "minDepth must be greater than or equal to 0");
+  assertEx(maxDepth >= minDepth, () => "maxDepth must be greater than or equal to minDepth");
+  const bw = assertEx(filterAs(await archivist.get([
+    hash
+  ]), asOptionalBlockBoundWitnessWithStorageMeta).at(0), () => `block ${hash} not found`);
+  if (maxDepth === 0) return [
+    bw,
+    []
+  ];
+  const blkPayloads = await archivist.get(bw.payload_hashes);
+  if (minDepth === 1) assertEx(allHashesPresent(bw.payload_hashes, blkPayloads), () => `Unable to find all payloads for block ${hash}`);
+  if (maxDepth === 1) return [
+    bw,
+    blkPayloads
+  ];
+  const transactions = filterAs(blkPayloads, asOptionalTransactionBoundWitnessWithStorageMeta);
+  const transactionsPayloadHashes = transactions.flatMap((tx) => tx.payload_hashes);
+  const transactionsPayloads = await archivist.get(transactionsPayloadHashes);
+  assertEx(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 archivist.get([
+    ...allPayloadsHashes
+  ]);
+  const allPayloadsFiltered = allPayloads.filter((p) => allPayloadsHashes.has(p._hash));
+  if (maxDepth === 2) assertEx(allHashesPresent([
+    ...allPayloadsHashes
+  ], allPayloadsFiltered), () => `Unable to find all payloads for transactions in block ${hash}`);
+  return [
+    bw,
+    allPayloadsFiltered
+  ];
+}, "hydrateBlock");
+var flattenHydratedBlock = /* @__PURE__ */ __name((hydratedBlock) => {
+  const [blk, blkPayloads] = hydratedBlock;
+  return [
+    ...blkPayloads,
+    blk
+  ];
+}, "flattenHydratedBlock");
+var flattenHydratedBlocks = /* @__PURE__ */ __name((hydratedBlocks) => hydratedBlocks.flatMap((blk) => flattenHydratedBlock(blk)), "flattenHydratedBlocks");
+var transactionsFromHydratedBlock = /* @__PURE__ */ __name((block) => {
+  return filterAs(block[1], asOptionalTransactionBoundWitnessWithStorageMeta);
+}, "transactionsFromHydratedBlock");
+var blockPayloadsFromHydratedBlock = /* @__PURE__ */ __name((block) => {
+  return block[0].payload_hashes.map((hash) => assertEx(block[1].find((p) => p._hash === hash), () => `missing payload ${hash}`)).filter((x) => !isTransactionBoundWitnessWithStorageMeta(x));
+}, "blockPayloadsFromHydratedBlock");
+
+// src/block/primitives/frames/stepHashFramesFromBlock.ts
+import { assertEx as assertEx2 } from "@xylabs/assert";
+import { isHash } from "@xylabs/hex";
+import { isDefined } from "@xylabs/typeof";
+import { isBlockBoundWitness, StepSizes } from "@xyo-network/xl1-protocol";
+async function stepHashFramesFromBlockAtSize(archivist, head, sizeIndex) {
+  if (!Number.isInteger(sizeIndex) || sizeIndex < 0 || sizeIndex >= StepSizes.length) {
+    throw new Error(`Invalid sizeIndex: ${sizeIndex}`);
+  }
+  let currentHead = head;
+  const steps = [];
+  while (isHash(currentHead)) {
+    const [block] = await archivist.get([
+      currentHead
+    ]);
+    if (!isBlockBoundWitness(block)) {
+      throw new Error(`Block with hash ${currentHead} not found`);
+    }
+    let stepHash = block.step_hashes.at(sizeIndex);
+    while (isDefined(stepHash)) {
+      const [stepHashBlock] = await archivist.get([
+        stepHash
+      ]);
+      if (!isBlockBoundWitness(stepHashBlock)) {
+        throw new Error(`StepHashBlock with hash ${currentHead} not found`);
+      }
+      const [lastBlockInStep] = await archivist.get([
+        assertEx2(stepHashBlock.previous, () => "StepHashBlock must have a previous block")
+      ]);
+      if (!isBlockBoundWitness(lastBlockInStep)) {
+        throw new Error(`StepHashBlock with hash ${currentHead} not found`);
+      }
+      steps.push([
+        stepHash,
+        stepHashBlock.block - StepSizes[sizeIndex],
+        stepHashBlock.block - 1
+      ]);
+      stepHash = lastBlockInStep.step_hashes.at(sizeIndex);
+    }
+  }
+  return steps;
+}
+__name(stepHashFramesFromBlockAtSize, "stepHashFramesFromBlockAtSize");
+async function stepHashFramesFromBlock(archivist, head) {
+  const [block] = await archivist.get([
+    head
+  ]);
+  if (!isBlockBoundWitness(block)) {
+    throw new Error(`Block with hash ${head} not found`);
+  }
+  let availableRanges = [
+    [
+      0,
+      block.block
+    ]
+  ];
+  const foundRanges = [];
+  for (let i = StepSizes.length - 1; i >= 0; i--) {
+    const steps = await stepHashFramesFromBlockAtSize(archivist, head, i);
+    for (let step of steps) {
+      const [, start, end] = step;
+      if (availableRanges.some((range) => range[0] <= start && range[1] >= end)) {
+        foundRanges.push(step);
+        availableRanges = availableRanges.flatMap((range) => {
+          if (range[0] >= start && range[1] <= end) {
+            return [
+              [
+                range[0],
+                start - 1
+              ]
+            ];
+          } else if (range[0] < start && range[1] >= end) {
+            return [
+              [
+                range[0],
+                start - 1
+              ],
+              [
+                end + 1,
+                range[1]
+              ]
+            ];
+          } else if (range[0] < start && range[1] < end) {
+            return [
+              [
+                range[0],
+                start - 1
+              ]
+            ];
+          } else if (range[0] > start && range[1] > end) {
+            return [
+              [
+                end + 1,
+                range[1]
+              ]
+            ];
+          }
+          return [
+            range
+          ];
+        });
+      }
+    }
+  }
+  return foundRanges;
+}
+__name(stepHashFramesFromBlock, "stepHashFramesFromBlock");
+
+// src/transaction/buildTransaction.ts
+import { assertEx as assertEx3 } from "@xylabs/assert";
 import { toHex } from "@xylabs/hex";
 import { BoundWitnessBuilder } from "@xyo-network/boundwitness-builder";
 import { PayloadBuilder } from "@xyo-network/payload-builder";
@@ -30,7 +212,7 @@ async function buildTransaction(chain, elevatedPayloads, additionalPayloads, sig
   const [tx, txPayloads] = await new BoundWitnessBuilder().fields({
     ...txBoundWitnessFields,
     script,
-    from: from ?? (Array.isArray(signer) ? assertEx(signer.at(0)?.address) : signer.address)
+    from: from ?? (Array.isArray(signer) ? assertEx3(signer.at(0)?.address) : signer.address)
   }).meta({
     $signatures: []
   }).payloads([
@@ -47,14 +229,14 @@ async function buildTransaction(chain, elevatedPayloads, additionalPayloads, sig
 __name(buildTransaction, "buildTransaction");
 
 // src/transaction/hydrateTransaction.ts
-import { assertEx as assertEx2 } from "@xylabs/assert";
+import { assertEx as assertEx4 } from "@xylabs/assert";
 import { hydrateTypedBoundWitness, tryHydrateTypedBoundWitness } from "@xyo-network/archivist-model";
-import { isAllowedBlockPayload, isTransactionBoundWitnessWithStorageMeta } from "@xyo-network/xl1-protocol";
+import { isAllowedBlockPayload, isTransactionBoundWitnessWithStorageMeta as isTransactionBoundWitnessWithStorageMeta2 } from "@xyo-network/xl1-protocol";
 var tryHydrateTransaction = /* @__PURE__ */ __name(async (archivist, hash) => {
-  return await tryHydrateTypedBoundWitness(archivist, hash, isTransactionBoundWitnessWithStorageMeta);
+  return await tryHydrateTypedBoundWitness(archivist, hash, isTransactionBoundWitnessWithStorageMeta2);
 }, "tryHydrateTransaction");
 var hydrateTransaction = /* @__PURE__ */ __name(async (archivist, hash) => {
-  return await hydrateTypedBoundWitness(archivist, hash, isTransactionBoundWitnessWithStorageMeta);
+  return await hydrateTypedBoundWitness(archivist, hash, isTransactionBoundWitnessWithStorageMeta2);
 }, "hydrateTransaction");
 var flattenHydratedTransaction = /* @__PURE__ */ __name((hydratedTransaction) => {
   const [tx, txPayloads] = hydratedTransaction;
@@ -90,26 +272,91 @@ var tryHydrateElevatedTransaction = /* @__PURE__ */ __name(async (archivist, has
   return void 0;
 }, "tryHydrateElevatedTransaction");
 var hydrateElevatedTransaction = /* @__PURE__ */ __name(async (archivist, hash) => {
-  return assertEx2(await tryHydrateElevatedTransaction(archivist, hash), () => "Hydration failed");
+  return assertEx4(await tryHydrateElevatedTransaction(archivist, hash), () => "Hydration failed");
 }, "hydrateElevatedTransaction");
 
-// src/transaction/transactionRequiredGas.ts
+// src/transaction/primitives/transactionBlockByteCount.ts
+import { PayloadBuilder as PayloadBuilder2 } from "@xyo-network/payload-builder";
+function transactionBlockByteCount([transaction, payloads]) {
+  const cleanTransaction = PayloadBuilder2.omitStorageMeta(transaction);
+  const transactionBytes = JSON.stringify(cleanTransaction).length;
+  const cleanPayloads = PayloadBuilder2.omitStorageMeta(payloads);
+  return cleanPayloads.reduce((acc, payload) => acc + JSON.stringify(payload).length, 0) + transactionBytes;
+}
+__name(transactionBlockByteCount, "transactionBlockByteCount");
+
+// src/transaction/primitives/transactionElevatedPayloads.ts
+import { asHash } from "@xylabs/hex";
+
+// src/transaction/primitives/transactionOperations.ts
+function crackOperation(operation) {
+  const parts = operation.split("|");
+  if (parts.length < 2) {
+    throw new Error(`Invalid operation format: ${operation}`);
+  }
+  return [
+    parts[0],
+    parts.slice(1)
+  ];
+}
+__name(crackOperation, "crackOperation");
+function crackOperations(operations) {
+  return operations.map((op) => crackOperation(op));
+}
+__name(crackOperations, "crackOperations");
+
+// src/transaction/primitives/transactionElevatedPayloads.ts
+function transactionElevatedPayloadHashes(transaction) {
+  const elevateOperations = crackOperations(transaction.script ?? []).filter((op) => op[0] === "elevate");
+  return elevateOperations.map((op) => asHash(op[1][0], true));
+}
+__name(transactionElevatedPayloadHashes, "transactionElevatedPayloadHashes");
+function transactionElevatedPayloads([transaction, payloads]) {
+  const hashes = transactionElevatedPayloadHashes(transaction);
+  const elevatedPayloads = payloads.filter((payload) => hashes.includes(payload._hash));
+  return elevatedPayloads;
+}
+__name(transactionElevatedPayloads, "transactionElevatedPayloads");
+
+// src/transaction/primitives/transactionRequiredGas.ts
 import { AttoXL1, TransactionGasCosts } from "@xyo-network/xl1-protocol";
-function transactionRequiredGas([transaction, payloads]) {
-  const characters = payloads.reduce((acc, payload) => acc + JSON.stringify(payload).length, 0);
-  const hashes = transaction.payload_hashes.length + 1;
-  const signatures = transaction.addresses.length + 1;
-  const elevatedPayloads = (transaction.script ?? []).length;
-  return AttoXL1(TransactionGasCosts.characterStorage * BigInt(characters) + TransactionGasCosts.hashValidation * BigInt(hashes) + TransactionGasCosts.signatureValidation * BigInt(signatures) + TransactionGasCosts.payloadValidation * BigInt(elevatedPayloads));
+function transactionBytesRequiredGas([transaction, payloads]) {
+  const transactionBlockBytes = transactionBlockByteCount([
+    transaction,
+    payloads
+  ]);
+  return AttoXL1(TransactionGasCosts.characterStorage * BigInt(transactionBlockBytes));
+}
+__name(transactionBytesRequiredGas, "transactionBytesRequiredGas");
+function transactionRequiredGas(hydratedTransaction) {
+  const elevatedPayloads = transactionElevatedPayloads(hydratedTransaction);
+  const hashes = elevatedPayloads.length + 1;
+  const signatures = hydratedTransaction[0].addresses.length;
+  return AttoXL1(transactionBytesRequiredGas(hydratedTransaction) + TransactionGasCosts.hashValidation * BigInt(hashes) + TransactionGasCosts.signatureValidation * BigInt(signatures) + TransactionGasCosts.payloadValidation * BigInt(elevatedPayloads.length));
 }
 __name(transactionRequiredGas, "transactionRequiredGas");
 export {
+  allHashesPresent,
+  blockPayloadsFromHydratedBlock,
   buildTransaction,
+  crackOperation,
+  crackOperations,
+  flattenHydratedBlock,
+  flattenHydratedBlocks,
   flattenHydratedTransaction,
   flattenHydratedTransactions,
+  hydrateBlock,
   hydrateElevatedTransaction,
   hydrateTransaction,
+  stepHashFramesFromBlock,
+  stepHashFramesFromBlockAtSize,
+  transactionBlockByteCount,
+  transactionBytesRequiredGas,
+  transactionElevatedPayloadHashes,
+  transactionElevatedPayloads,
   transactionRequiredGas,
+  transactionsFromHydratedBlock,
+  tryHydrateBlock,
   tryHydrateElevatedTransaction,
   tryHydrateTransaction
 };

package/dist/neutral/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/transaction/buildTransaction.ts","../../src/transaction/hydrateTransaction.ts","../../src/transaction/transactionRequiredGas.ts"],"sourcesContent":["import { assertEx } from '@xylabs/assert'\nimport type { Address } from '@xylabs/hex'\nimport { toHex } from '@xylabs/hex'\nimport type { AccountInstance } from '@xyo-network/account-model'\nimport { BoundWitnessBuilder } from '@xyo-network/boundwitness-builder'\nimport { PayloadBuilder } from '@xyo-network/payload-builder'\nimport type { Payload } from '@xyo-network/payload-model'\nimport {\n  type AllowedBlockPayload,\n  defaultTransactionFees,\n  type HydratedTransactionWithStorageMeta, type TransactionBoundWitness, type TransactionBoundWitnessFields, type TransactionFeesBigInt,\n} from '@xyo-network/xl1-protocol'\n\nexport async function buildTransaction(\n  chain: Address,\n  elevatedPayloads: AllowedBlockPayload[],\n  additionalPayloads: Payload[],\n  signer: AccountInstance | AccountInstance[],\n  nbf: number,\n  exp: number,\n  from?: Address,\n  fees: TransactionFeesBigInt = defaultTransactionFees,\n): Promise<HydratedTransactionWithStorageMeta> {\n  if (from === undefined && Array.isArray(signer)) {\n    throw new Error('from is required when signer is an array')\n  }\n\n  const txBoundWitnessFields: TransactionBoundWitnessFields = {\n    chain,\n    fees: {\n      base: toHex(fees.base),\n      gasLimit: toHex(fees.gasLimit),\n      gasPrice: toHex(fees.gasPrice),\n      priority: toHex(fees.priority),\n    },\n    nbf,\n    exp,\n  }\n\n  const elevatedHashes = await PayloadBuilder.hashes(elevatedPayloads)\n  const script: string[] = []\n  for (const elevatedHash of elevatedHashes) {\n    script.push(`elevate|${elevatedHash}`)\n  }\n\n  const [tx, txPayloads] = await new BoundWitnessBuilder<TransactionBoundWitness>()\n    .fields({\n      ...txBoundWitnessFields,\n      script,\n      from: from ?? (Array.isArray(signer) ? assertEx(signer.at(0)?.address) : signer.address),\n    })\n    .meta({ $signatures: [] })\n    .payloads([...elevatedPayloads, ...additionalPayloads])\n    .signers(Array.isArray(signer) ? signer : [signer])\n    .build()\n\n  return [await PayloadBuilder.addStorageMeta(tx), await PayloadBuilder.addStorageMeta(txPayloads)]\n}\n","import { assertEx } from '@xylabs/assert'\nimport type { Hash } from '@xylabs/hex'\nimport type { ReadArchivist } from '@xyo-network/archivist-model'\nimport { hydrateTypedBoundWitness, tryHydrateTypedBoundWitness } from '@xyo-network/archivist-model'\nimport type { Payload } from '@xyo-network/payload-model'\nimport type {\n  AllowedBlockPayload,\n  HydratedTransaction, HydratedTransactionWithStorageMeta, TransactionBoundWitness,\n} from '@xyo-network/xl1-protocol'\nimport { isAllowedBlockPayload, isTransactionBoundWitnessWithStorageMeta } from '@xyo-network/xl1-protocol'\n\nexport const tryHydrateTransaction = async (\n  archivist: ReadArchivist,\n  hash: Hash,\n): Promise<HydratedTransactionWithStorageMeta | undefined> => {\n  return (await tryHydrateTypedBoundWitness<TransactionBoundWitness>(\n    archivist,\n    hash,\n    isTransactionBoundWitnessWithStorageMeta,\n  )) as HydratedTransactionWithStorageMeta | undefined\n}\n\nexport const hydrateTransaction = async (\n  archivist: ReadArchivist,\n  hash: Hash,\n): Promise<HydratedTransactionWithStorageMeta> => {\n  return await hydrateTypedBoundWitness<TransactionBoundWitness>(\n    archivist,\n    hash,\n    isTransactionBoundWitnessWithStorageMeta,\n  ) as HydratedTransactionWithStorageMeta\n}\n\nexport const flattenHydratedTransaction = (hydratedTransaction: HydratedTransaction): Payload[] => {\n  const [tx, txPayloads] = hydratedTransaction\n  return [...txPayloads, tx]\n}\n\nexport const flattenHydratedTransactions = (hydratedTransactions: HydratedTransaction[]): Payload[] =>\n  hydratedTransactions.flatMap(tx => flattenHydratedTransaction(tx))\n\nexport const tryHydrateElevatedTransaction = async (\n  archivist: ReadArchivist,\n  hash: Hash,\n): Promise<HydratedTransaction | undefined> => {\n  const hydratedTransaction = await tryHydrateTransaction(archivist, hash)\n  if (!hydratedTransaction) {\n    return undefined\n  }\n  const [transaction, payloads] = hydratedTransaction\n  const opCodes = (transaction.script ?? []).filter(operation => operation.startsWith('elevate|'))\n  const elevatedPayloads: AllowedBlockPayload[] = []\n  for (const opCode of opCodes) {\n    const [code, hash] = opCode.split('|')\n    if (code === 'elevated') {\n      const elevatedPayload = payloads.find(payload => payload._hash === hash)\n      if (isAllowedBlockPayload(elevatedPayload)) {\n        elevatedPayloads.push(elevatedPayload)\n      }\n    }\n  }\n  if (opCodes.length === elevatedPayloads.length) {\n    return [transaction, elevatedPayloads]\n  }\n  return undefined\n}\n\nexport const hydrateElevatedTransaction = async (\n  archivist: ReadArchivist,\n  hash: Hash,\n): Promise<HydratedTransaction> => {\n  return assertEx(await tryHydrateElevatedTransaction(archivist, hash), () => 'Hydration failed')\n}\n","import type { HydratedTransaction } from '@xyo-network/xl1-protocol'\nimport { AttoXL1, TransactionGasCosts } from '@xyo-network/xl1-protocol'\n\nexport function transactionRequiredGas([transaction, payloads]: HydratedTransaction): AttoXL1 {\n  const characters = payloads.reduce((acc: number, payload) => acc + JSON.stringify(payload).length, 0)\n  const hashes = transaction.payload_hashes.length + 1 /* for transaction itself */\n  const signatures = transaction.addresses.length + 1\n  const elevatedPayloads = (transaction.script ?? []).length\n  return AttoXL1(TransactionGasCosts.characterStorage * BigInt(characters)\n    + TransactionGasCosts.hashValidation * BigInt(hashes)\n    + TransactionGasCosts.signatureValidation * BigInt(signatures)\n    + TransactionGasCosts.payloadValidation * BigInt(elevatedPayloads))\n}\n"],"mappings":"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","names":["assertEx","toHex","BoundWitnessBuilder","PayloadBuilder","defaultTransactionFees","buildTransaction","chain","elevatedPayloads","additionalPayloads","signer","nbf","exp","from","fees","defaultTransactionFees","undefined","Array","isArray","Error","txBoundWitnessFields","base","toHex","gasLimit","gasPrice","priority","elevatedHashes","PayloadBuilder","hashes","script","elevatedHash","push","tx","txPayloads","BoundWitnessBuilder","fields","assertEx","at","address","meta","$signatures","payloads","signers","build","addStorageMeta","assertEx","hydrateTypedBoundWitness","tryHydrateTypedBoundWitness","isAllowedBlockPayload","isTransactionBoundWitnessWithStorageMeta","tryHydrateTransaction","archivist","hash","tryHydrateTypedBoundWitness","isTransactionBoundWitnessWithStorageMeta","hydrateTransaction","hydrateTypedBoundWitness","flattenHydratedTransaction","hydratedTransaction","tx","txPayloads","flattenHydratedTransactions","hydratedTransactions","flatMap","tryHydrateElevatedTransaction","undefined","transaction","payloads","opCodes","script","filter","operation","startsWith","elevatedPayloads","opCode","code","split","elevatedPayload","find","payload","_hash","isAllowedBlockPayload","push","length","hydrateElevatedTransaction","assertEx","AttoXL1","TransactionGasCosts","transactionRequiredGas","transaction","payloads","characters","reduce","acc","payload","JSON","stringify","length","hashes","payload_hashes","signatures","addresses","elevatedPayloads","script","AttoXL1","TransactionGasCosts","characterStorage","BigInt","hashValidation","signatureValidation","payloadValidation"]}
+{"version":3,"sources":["../../src/block/hydrateBlock.ts","../../src/block/primitives/frames/stepHashFramesFromBlock.ts","../../src/transaction/buildTransaction.ts","../../src/transaction/hydrateTransaction.ts","../../src/transaction/primitives/transactionBlockByteCount.ts","../../src/transaction/primitives/transactionElevatedPayloads.ts","../../src/transaction/primitives/transactionOperations.ts","../../src/transaction/primitives/transactionRequiredGas.ts"],"sourcesContent":["import { filterAs } from '@xylabs/array'\nimport { assertEx } from '@xylabs/assert'\nimport type { Hash } from '@xylabs/hex'\nimport type { ReadArchivist } from '@xyo-network/archivist-model'\nimport type { Payload, WithStorageMeta } from '@xyo-network/payload-model'\nimport type { HydratedBlock, TransactionBoundWitness } from '@xyo-network/xl1-protocol'\nimport {\n  asOptionalBlockBoundWitnessWithStorageMeta, asOptionalTransactionBoundWitnessWithStorageMeta, isTransactionBoundWitnessWithStorageMeta,\n} from '@xyo-network/xl1-protocol'\n\nexport function allHashesPresent(hashes: Hash[], payloads: WithStorageMeta<Payload>[]): boolean {\n  const payloadHashes = new Set(payloads.map(p => p._hash))\n  return hashes.every(hash => payloadHashes.has(hash))\n}\n\nexport const tryHydrateBlock = async (\n  archivist: ReadArchivist,\n  hash: Hash,\n  maxDepth: number = 1,\n  minDepth?: number,\n): Promise<HydratedBlock | undefined> => {\n  try {\n    return await hydrateBlock(archivist, hash, maxDepth, minDepth)\n  } catch (e) {\n    if (e instanceof Error) {\n      console.warn(`Failed to hydrate block ${hash}: ${e.message}`)\n    } else {\n      console.warn(`Failed to hydrate block ${hash}: ${e}`)\n    }\n    return undefined\n  }\n}\n\nexport const hydrateBlock = async (\n  archivist: ReadArchivist,\n  hash: Hash,\n  maxDepth: number = 1,\n  minDepth?: number,\n): Promise<HydratedBlock> => {\n  if (minDepth === undefined) minDepth = maxDepth\n  assertEx(maxDepth >= 0, () => 'maxDepth must be greater than or equal to 0')\n  assertEx(minDepth >= 0, () => 'minDepth must be greater than or equal to 0')\n  assertEx(maxDepth >= minDepth, () => 'maxDepth must be greater than or equal to minDepth')\n  const bw = assertEx(\n    filterAs(await archivist.get([hash]), asOptionalBlockBoundWitnessWithStorageMeta).at(0),\n    () => `block ${hash} not found`,\n  )\n  if (maxDepth === 0) return [bw, []]\n  const blkPayloads = await archivist.get(bw.payload_hashes)\n  if (minDepth === 1) assertEx(allHashesPresent(bw.payload_hashes, blkPayloads), () => `Unable to find all payloads for block ${hash}`)\n  if (maxDepth === 1) return [bw, blkPayloads]\n  const transactions = filterAs(blkPayloads, asOptionalTransactionBoundWitnessWithStorageMeta)\n  const transactionsPayloadHashes = transactions.flatMap(tx => tx.payload_hashes)\n  const transactionsPayloads = await archivist.get(transactionsPayloadHashes)\n  assertEx(allHashesPresent(transactionsPayloadHashes, transactionsPayloads), () => `Unable to find all payloads for transactions in block ${hash}`)\n  const allPayloadsHashes = new Set([...blkPayloads, ...transactionsPayloads].flatMap(p => p._hash))\n  const allPayloads = await archivist.get([...allPayloadsHashes])\n  const allPayloadsFiltered = allPayloads.filter(p => allPayloadsHashes.has(p._hash))\n  if (maxDepth === 2) assertEx(allHashesPresent(\n    [...allPayloadsHashes],\n    allPayloadsFiltered,\n  ), () => `Unable to find all payloads for transactions in block ${hash}`)\n  return [bw, allPayloadsFiltered]\n}\n\nexport const flattenHydratedBlock = (hydratedBlock: HydratedBlock): WithStorageMeta<Payload>[] => {\n  const [blk, blkPayloads] = hydratedBlock\n  return [...blkPayloads, blk]\n}\n\nexport const flattenHydratedBlocks = (hydratedBlocks: HydratedBlock[]): WithStorageMeta<Payload>[] =>\n  hydratedBlocks.flatMap(blk => flattenHydratedBlock(blk))\n\nexport const transactionsFromHydratedBlock = (block: HydratedBlock): WithStorageMeta<TransactionBoundWitness>[] => {\n  return filterAs(block[1], asOptionalTransactionBoundWitnessWithStorageMeta)\n}\n\nexport const blockPayloadsFromHydratedBlock = (block: HydratedBlock): WithStorageMeta<Payload>[] => {\n  return block[0].payload_hashes.map(hash => assertEx(\n    block[1].find(p => p._hash === hash),\n    () => `missing payload ${hash}`,\n  )).filter(x => !isTransactionBoundWitnessWithStorageMeta(x))\n}\n","import { assertEx } from '@xylabs/assert'\nimport { type Hash, isHash } from '@xylabs/hex'\nimport { isDefined } from '@xylabs/typeof'\nimport type { ArchivistInstance } from '@xyo-network/archivist-model'\nimport { isBlockBoundWitness, StepSizes } from '@xyo-network/xl1-protocol'\n\n// get the list of step frames for a block at a specific step size index\nexport async function stepHashFramesFromBlockAtSize(archivist: ArchivistInstance, head: Hash, sizeIndex: number) {\n  if (!Number.isInteger(sizeIndex) || sizeIndex < 0 || sizeIndex >= StepSizes.length) {\n    throw new Error(`Invalid sizeIndex: ${sizeIndex}`)\n  }\n  let currentHead = head\n  const steps: [Hash, number, number][] = []\n  while (isHash(currentHead)) {\n    const [block] = await archivist.get([currentHead])\n    if (!isBlockBoundWitness(block)) {\n      throw new Error(`Block with hash ${currentHead} not found`)\n    }\n    let stepHash = block.step_hashes.at(sizeIndex)\n    while (isDefined(stepHash)) {\n      const [stepHashBlock] = await archivist.get([stepHash])\n      if (!isBlockBoundWitness(stepHashBlock)) {\n        throw new Error(`StepHashBlock with hash ${currentHead} not found`)\n      }\n      const [lastBlockInStep] = await archivist.get([assertEx(stepHashBlock.previous, () => 'StepHashBlock must have a previous block')])\n      if (!isBlockBoundWitness(lastBlockInStep)) {\n        throw new Error(`StepHashBlock with hash ${currentHead} not found`)\n      }\n      steps.push([stepHash, stepHashBlock.block - StepSizes[sizeIndex], stepHashBlock.block - 1])\n      stepHash = lastBlockInStep.step_hashes.at(sizeIndex)\n    }\n  }\n  return steps\n}\n\n// TODO: Figure out how to get ranges of smaller blocks for each available range\nexport async function stepHashFramesFromBlock(archivist: ArchivistInstance, head: Hash) {\n  const [block] = await archivist.get([head])\n  if (!isBlockBoundWitness(block)) {\n    throw new Error(`Block with hash ${head} not found`)\n  }\n  let availableRanges: [number, number][] = [[0, block.block]]\n  const foundRanges: [Hash, number, number][] = []\n  // fit biggest to smallest\n  for (let i = StepSizes.length - 1; i >= 0; i--) {\n    const steps = await stepHashFramesFromBlockAtSize(archivist, head, i)\n    for (let step of steps) {\n      const [, start, end] = step\n      if (availableRanges.some(range => range[0] <= start && range[1] >= end)) {\n        foundRanges.push(step)\n        availableRanges = availableRanges.flatMap((range) => {\n          if (range[0] >= start && range[1] <= end) {\n            // remove the range\n            return [[range[0], start - 1]]\n          } else if (range[0] < start && range[1] >= end) {\n            // split the range\n            return [[range[0], start - 1], [end + 1, range[1]]]\n          } else if (range[0] < start && range[1] < end) {\n            // adjust the end of the range\n            return [[range[0], start - 1]]\n          } else if (range[0] > start && range[1] > end) {\n            // adjust the start of the range\n            return [[end + 1, range[1]]]\n          }\n          // otherwise, return the range as is\n          return [range]\n        })\n      }\n    }\n  }\n  return foundRanges\n}\n","import { assertEx } from '@xylabs/assert'\nimport type { Address } from '@xylabs/hex'\nimport { toHex } from '@xylabs/hex'\nimport type { AccountInstance } from '@xyo-network/account-model'\nimport { BoundWitnessBuilder } from '@xyo-network/boundwitness-builder'\nimport { PayloadBuilder } from '@xyo-network/payload-builder'\nimport type { Payload } from '@xyo-network/payload-model'\nimport {\n  type AllowedBlockPayload,\n  defaultTransactionFees,\n  type HydratedTransactionWithStorageMeta, type TransactionBoundWitness, type TransactionBoundWitnessFields, type TransactionFeesBigInt,\n} from '@xyo-network/xl1-protocol'\n\nexport async function buildTransaction(\n  chain: Address,\n  elevatedPayloads: AllowedBlockPayload[],\n  additionalPayloads: Payload[],\n  signer: AccountInstance | AccountInstance[],\n  nbf: number,\n  exp: number,\n  from?: Address,\n  fees: TransactionFeesBigInt = defaultTransactionFees,\n): Promise<HydratedTransactionWithStorageMeta> {\n  if (from === undefined && Array.isArray(signer)) {\n    throw new Error('from is required when signer is an array')\n  }\n\n  const txBoundWitnessFields: TransactionBoundWitnessFields = {\n    chain,\n    fees: {\n      base: toHex(fees.base),\n      gasLimit: toHex(fees.gasLimit),\n      gasPrice: toHex(fees.gasPrice),\n      priority: toHex(fees.priority),\n    },\n    nbf,\n    exp,\n  }\n\n  const elevatedHashes = await PayloadBuilder.hashes(elevatedPayloads)\n  const script: string[] = []\n  for (const elevatedHash of elevatedHashes) {\n    script.push(`elevate|${elevatedHash}`)\n  }\n\n  const [tx, txPayloads] = await new BoundWitnessBuilder<TransactionBoundWitness>()\n    .fields({\n      ...txBoundWitnessFields,\n      script,\n      from: from ?? (Array.isArray(signer) ? assertEx(signer.at(0)?.address) : signer.address),\n    })\n    .meta({ $signatures: [] })\n    .payloads([...elevatedPayloads, ...additionalPayloads])\n    .signers(Array.isArray(signer) ? signer : [signer])\n    .build()\n\n  return [await PayloadBuilder.addStorageMeta(tx), await PayloadBuilder.addStorageMeta(txPayloads)]\n}\n","import { assertEx } from '@xylabs/assert'\nimport type { Hash } from '@xylabs/hex'\nimport type { ReadArchivist } from '@xyo-network/archivist-model'\nimport { hydrateTypedBoundWitness, tryHydrateTypedBoundWitness } from '@xyo-network/archivist-model'\nimport type { Payload } from '@xyo-network/payload-model'\nimport type {\n  AllowedBlockPayload,\n  HydratedTransaction, HydratedTransactionWithStorageMeta, TransactionBoundWitness,\n} from '@xyo-network/xl1-protocol'\nimport { isAllowedBlockPayload, isTransactionBoundWitnessWithStorageMeta } from '@xyo-network/xl1-protocol'\n\nexport const tryHydrateTransaction = async (\n  archivist: ReadArchivist,\n  hash: Hash,\n): Promise<HydratedTransactionWithStorageMeta | undefined> => {\n  return (await tryHydrateTypedBoundWitness<TransactionBoundWitness>(\n    archivist,\n    hash,\n    isTransactionBoundWitnessWithStorageMeta,\n  )) as HydratedTransactionWithStorageMeta | undefined\n}\n\nexport const hydrateTransaction = async (\n  archivist: ReadArchivist,\n  hash: Hash,\n): Promise<HydratedTransactionWithStorageMeta> => {\n  return await hydrateTypedBoundWitness<TransactionBoundWitness>(\n    archivist,\n    hash,\n    isTransactionBoundWitnessWithStorageMeta,\n  ) as HydratedTransactionWithStorageMeta\n}\n\nexport const flattenHydratedTransaction = (hydratedTransaction: HydratedTransaction): Payload[] => {\n  const [tx, txPayloads] = hydratedTransaction\n  return [...txPayloads, tx]\n}\n\nexport const flattenHydratedTransactions = (hydratedTransactions: HydratedTransaction[]): Payload[] =>\n  hydratedTransactions.flatMap(tx => flattenHydratedTransaction(tx))\n\nexport const tryHydrateElevatedTransaction = async (\n  archivist: ReadArchivist,\n  hash: Hash,\n): Promise<HydratedTransaction | undefined> => {\n  const hydratedTransaction = await tryHydrateTransaction(archivist, hash)\n  if (!hydratedTransaction) {\n    return undefined\n  }\n  const [transaction, payloads] = hydratedTransaction\n  const opCodes = (transaction.script ?? []).filter(operation => operation.startsWith('elevate|'))\n  const elevatedPayloads: AllowedBlockPayload[] = []\n  for (const opCode of opCodes) {\n    const [code, hash] = opCode.split('|')\n    if (code === 'elevated') {\n      const elevatedPayload = payloads.find(payload => payload._hash === hash)\n      if (isAllowedBlockPayload(elevatedPayload)) {\n        elevatedPayloads.push(elevatedPayload)\n      }\n    }\n  }\n  if (opCodes.length === elevatedPayloads.length) {\n    return [transaction, elevatedPayloads]\n  }\n  return undefined\n}\n\nexport const hydrateElevatedTransaction = async (\n  archivist: ReadArchivist,\n  hash: Hash,\n): Promise<HydratedTransaction> => {\n  return assertEx(await tryHydrateElevatedTransaction(archivist, hash), () => 'Hydration failed')\n}\n","import { PayloadBuilder } from '@xyo-network/payload-builder'\nimport type { HydratedTransaction } from '@xyo-network/xl1-protocol'\n\n/** The number of bytes that a transaction and its payloads will take up in a block */\nexport function transactionBlockByteCount([transaction, payloads]: HydratedTransaction): number {\n  const cleanTransaction = PayloadBuilder.omitStorageMeta(transaction)\n  const transactionBytes = JSON.stringify(cleanTransaction).length\n  const cleanPayloads = PayloadBuilder.omitStorageMeta(payloads)\n  return cleanPayloads.reduce((acc: number, payload) => acc + JSON.stringify(payload).length, 0) + transactionBytes\n}\n","import { asHash, type Hash } from '@xylabs/hex'\nimport type { Payload, WithHashStorageMeta } from '@xyo-network/payload-model'\nimport type { HydratedTransactionWithHashStorageMeta, TransactionBoundWitness } from '@xyo-network/xl1-protocol'\n\nimport { crackOperations } from './transactionOperations.ts'\n\nexport function transactionElevatedPayloadHashes(transaction: TransactionBoundWitness): Hash[] {\n  const elevateOperations = crackOperations(transaction.script ?? []).filter(op => op[0] === 'elevate')\n  return elevateOperations.map(op => asHash(op[1][0], true))\n}\n\nexport function transactionElevatedPayloads([transaction, payloads]: HydratedTransactionWithHashStorageMeta): WithHashStorageMeta<Payload>[] {\n  const hashes = transactionElevatedPayloadHashes(transaction)\n  const elevatedPayloads = payloads.filter(payload => hashes.includes(payload._hash))\n  return elevatedPayloads\n}\n","export function crackOperation(operation: string): [string, string[]] {\n  const parts = operation.split('|')\n  if (parts.length < 2) {\n    throw new Error(`Invalid operation format: ${operation}`)\n  }\n  return [parts[0], parts.slice(1)]\n}\n\nexport function crackOperations(operations: string[]): [string, string[]][] {\n  return operations.map(op => crackOperation(op))\n}\n","import type { HydratedTransaction, HydratedTransactionWithHashStorageMeta } from '@xyo-network/xl1-protocol'\nimport { AttoXL1, TransactionGasCosts } from '@xyo-network/xl1-protocol'\n\nimport { transactionBlockByteCount } from './transactionBlockByteCount.ts'\nimport { transactionElevatedPayloads } from './transactionElevatedPayloads.ts'\n\n/** The required gas for the byte storage on the block chain for a transaction */\nexport function transactionBytesRequiredGas([transaction, payloads]: HydratedTransaction): AttoXL1 {\n  const transactionBlockBytes = transactionBlockByteCount([transaction, payloads])\n  return AttoXL1(TransactionGasCosts.characterStorage * BigInt(transactionBlockBytes))\n}\n\nexport function transactionRequiredGas(hydratedTransaction: HydratedTransactionWithHashStorageMeta): AttoXL1 {\n  const elevatedPayloads = transactionElevatedPayloads(hydratedTransaction)\n  const hashes = elevatedPayloads.length + 1 /* for transaction itself */\n  const signatures = hydratedTransaction[0].addresses.length\n  return AttoXL1(transactionBytesRequiredGas(hydratedTransaction)\n    + TransactionGasCosts.hashValidation * BigInt(hashes)\n    + TransactionGasCosts.signatureValidation * BigInt(signatures)\n    + TransactionGasCosts.payloadValidation * BigInt(elevatedPayloads.length))\n}\n"],"mappings":"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","names":["filterAs","assertEx","asOptionalBlockBoundWitnessWithStorageMeta","asOptionalTransactionBoundWitnessWithStorageMeta","isTransactionBoundWitnessWithStorageMeta","allHashesPresent","hashes","payloads","payloadHashes","Set","map","p","_hash","every","hash","has","tryHydrateBlock","archivist","maxDepth","minDepth","hydrateBlock","e","Error","console","warn","message","undefined","assertEx","bw","filterAs","get","asOptionalBlockBoundWitnessWithStorageMeta","at","blkPayloads","payload_hashes","transactions","asOptionalTransactionBoundWitnessWithStorageMeta","transactionsPayloadHashes","flatMap","tx","transactionsPayloads","allPayloadsHashes","allPayloads","allPayloadsFiltered","filter","flattenHydratedBlock","hydratedBlock","blk","flattenHydratedBlocks","hydratedBlocks","transactionsFromHydratedBlock","block","blockPayloadsFromHydratedBlock","find","x","isTransactionBoundWitnessWithStorageMeta","assertEx","isHash","isDefined","isBlockBoundWitness","StepSizes","stepHashFramesFromBlockAtSize","archivist","head","sizeIndex","Number","isInteger","StepSizes","length","Error","currentHead","steps","isHash","block","get","isBlockBoundWitness","stepHash","step_hashes","at","isDefined","stepHashBlock","lastBlockInStep","assertEx","previous","push","stepHashFramesFromBlock","availableRanges","foundRanges","i","step","start","end","some","range","flatMap","assertEx","toHex","BoundWitnessBuilder","PayloadBuilder","defaultTransactionFees","buildTransaction","chain","elevatedPayloads","additionalPayloads","signer","nbf","exp","from","fees","defaultTransactionFees","undefined","Array","isArray","Error","txBoundWitnessFields","base","toHex","gasLimit","gasPrice","priority","elevatedHashes","PayloadBuilder","hashes","script","elevatedHash","push","tx","txPayloads","BoundWitnessBuilder","fields","assertEx","at","address","meta","$signatures","payloads","signers","build","addStorageMeta","assertEx","hydrateTypedBoundWitness","tryHydrateTypedBoundWitness","isAllowedBlockPayload","isTransactionBoundWitnessWithStorageMeta","tryHydrateTransaction","archivist","hash","tryHydrateTypedBoundWitness","isTransactionBoundWitnessWithStorageMeta","hydrateTransaction","hydrateTypedBoundWitness","flattenHydratedTransaction","hydratedTransaction","tx","txPayloads","flattenHydratedTransactions","hydratedTransactions","flatMap","tryHydrateElevatedTransaction","undefined","transaction","payloads","opCodes","script","filter","operation","startsWith","elevatedPayloads","opCode","code","split","elevatedPayload","find","payload","_hash","isAllowedBlockPayload","push","length","hydrateElevatedTransaction","assertEx","PayloadBuilder","transactionBlockByteCount","transaction","payloads","cleanTransaction","PayloadBuilder","omitStorageMeta","transactionBytes","JSON","stringify","length","cleanPayloads","reduce","acc","payload","asHash","crackOperation","operation","parts","split","length","Error","slice","crackOperations","operations","map","op","transactionElevatedPayloadHashes","transaction","elevateOperations","crackOperations","script","filter","op","map","asHash","transactionElevatedPayloads","payloads","hashes","elevatedPayloads","payload","includes","_hash","AttoXL1","TransactionGasCosts","transactionBytesRequiredGas","transaction","payloads","transactionBlockBytes","transactionBlockByteCount","AttoXL1","TransactionGasCosts","characterStorage","BigInt","transactionRequiredGas","hydratedTransaction","elevatedPayloads","transactionElevatedPayloads","hashes","length","signatures","addresses","hashValidation","signatureValidation","payloadValidation"]}

package/dist/types/block/hydrateBlock.d.ts

@@ -0,0 +1,12 @@
+import type { Hash } from '@xylabs/hex';
+import type { ReadArchivist } from '@xyo-network/archivist-model';
+import type { Payload, WithStorageMeta } from '@xyo-network/payload-model';
+import type { HydratedBlock, TransactionBoundWitness } from '@xyo-network/xl1-protocol';
+export declare function allHashesPresent(hashes: Hash[], payloads: WithStorageMeta<Payload>[]): boolean;
+export declare const tryHydrateBlock: (archivist: ReadArchivist, hash: Hash, maxDepth?: number, minDepth?: number) => Promise<HydratedBlock | undefined>;
+export declare const hydrateBlock: (archivist: ReadArchivist, hash: Hash, maxDepth?: number, minDepth?: number) => Promise<HydratedBlock>;
+export declare const flattenHydratedBlock: (hydratedBlock: HydratedBlock) => WithStorageMeta<Payload>[];
+export declare const flattenHydratedBlocks: (hydratedBlocks: HydratedBlock[]) => WithStorageMeta<Payload>[];
+export declare const transactionsFromHydratedBlock: (block: HydratedBlock) => WithStorageMeta<TransactionBoundWitness>[];
+export declare const blockPayloadsFromHydratedBlock: (block: HydratedBlock) => WithStorageMeta<Payload>[];
+//# sourceMappingURL=hydrateBlock.d.ts.map

package/dist/types/block/hydrateBlock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydrateBlock.d.ts","sourceRoot":"","sources":["../../../src/block/hydrateBlock.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAA;AACjE,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AAC1E,OAAO,KAAK,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAA;AAKvF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,eAAe,CAAC,OAAO,CAAC,EAAE,GAAG,OAAO,CAG9F;AAED,eAAO,MAAM,eAAe,GAC1B,WAAW,aAAa,EACxB,MAAM,IAAI,EACV,WAAU,MAAU,EACpB,WAAW,MAAM,KAChB,OAAO,CAAC,aAAa,GAAG,SAAS,CAWnC,CAAA;AAED,eAAO,MAAM,YAAY,GACvB,WAAW,aAAa,EACxB,MAAM,IAAI,EACV,WAAU,MAAU,EACpB,WAAW,MAAM,KAChB,OAAO,CAAC,aAAa,CAyBvB,CAAA;AAED,eAAO,MAAM,oBAAoB,GAAI,eAAe,aAAa,KAAG,eAAe,CAAC,OAAO,CAAC,EAG3F,CAAA;AAED,eAAO,MAAM,qBAAqB,GAAI,gBAAgB,aAAa,EAAE,KAAG,eAAe,CAAC,OAAO,CAAC,EACtC,CAAA;AAE1D,eAAO,MAAM,6BAA6B,GAAI,OAAO,aAAa,KAAG,eAAe,CAAC,uBAAuB,CAAC,EAE5G,CAAA;AAED,eAAO,MAAM,8BAA8B,GAAI,OAAO,aAAa,KAAG,eAAe,CAAC,OAAO,CAAC,EAK7F,CAAA"}

package/dist/types/block/index.d.ts

@@ -0,0 +1,3 @@
+export * from './hydrateBlock.ts';
+export * from './primitives/index.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/block/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/block/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA;AACjC,cAAc,uBAAuB,CAAA"}

package/dist/types/block/primitives/frames/BlockNumberRange.d.ts

@@ -0,0 +1,2 @@
+export type BlockNumberRange = [number, number];
+//# sourceMappingURL=BlockNumberRange.d.ts.map

package/dist/types/block/primitives/frames/BlockNumberRange.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlockNumberRange.d.ts","sourceRoot":"","sources":["../../../../../src/block/primitives/frames/BlockNumberRange.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA"}

package/dist/types/block/primitives/frames/calculateFramesFromRange.d.ts

@@ -0,0 +1,6 @@
+import type { BlockNumberRange } from './BlockNumberRange.ts';
+export declare function calculateFramesFromRange(range: BlockNumberRange, step: number): [
+    BlockNumberRange[],
+    BlockNumberRange[]
+];
+//# sourceMappingURL=calculateFramesFromRange.d.ts.map

package/dist/types/block/primitives/frames/calculateFramesFromRange.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calculateFramesFromRange.d.ts","sourceRoot":"","sources":["../../../../../src/block/primitives/frames/calculateFramesFromRange.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAE7D,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,GAAG;IAE/E,gBAAgB,EAAE;IAElB,gBAAgB,EAAE;CAAC,CAoBpB"}

package/dist/types/block/primitives/frames/deepCalculateFramesFromRange.d.ts

@@ -0,0 +1,3 @@
+import type { BlockNumberRange } from './BlockNumberRange.ts';
+export declare function deepCalculateFramesFromRange(range: BlockNumberRange, startingStep?: number): BlockNumberRange[];
+//# sourceMappingURL=deepCalculateFramesFromRange.d.ts.map

package/dist/types/block/primitives/frames/deepCalculateFramesFromRange.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepCalculateFramesFromRange.d.ts","sourceRoot":"","sources":["../../../../../src/block/primitives/frames/deepCalculateFramesFromRange.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAG7D,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,gBAAgB,EAAE,YAAY,SAAyB,GAAG,gBAAgB,EAAE,CAqB/H"}

package/dist/types/block/primitives/frames/index.d.ts

@@ -0,0 +1,3 @@
+export * from './BlockNumberRange.ts';
+export * from './stepHashFramesFromBlock.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/block/primitives/frames/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/block/primitives/frames/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAA;AACrC,cAAc,8BAA8B,CAAA"}

package/dist/types/block/primitives/frames/loadFrameSummaries.d.ts

@@ -0,0 +1,5 @@
+import type { ArchivistInstance } from '@xyo-network/archivist-model';
+import type { Payload } from '@xyo-network/payload-model';
+import type { BlockNumberRange } from './BlockNumberRange.ts';
+export declare function loadFrameSummaries(ranges: BlockNumberRange[], finalizedArchivist: ArchivistInstance, summaryArchivist: ArchivistInstance): Promise<Payload[]>;
+//# sourceMappingURL=loadFrameSummaries.d.ts.map

package/dist/types/block/primitives/frames/loadFrameSummaries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadFrameSummaries.d.ts","sourceRoot":"","sources":["../../../../../src/block/primitives/frames/loadFrameSummaries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AACrE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAA;AAEzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAE7D,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,gBAAgB,EAAE,EAC1B,kBAAkB,EAAE,iBAAiB,EACrC,gBAAgB,EAAE,iBAAiB,GAClC,OAAO,CAAC,OAAO,EAAE,CAAC,CAEpB"}

package/dist/types/block/primitives/frames/stepHashFramesFromBlock.d.ts

@@ -0,0 +1,5 @@
+import { type Hash } from '@xylabs/hex';
+import type { ArchivistInstance } from '@xyo-network/archivist-model';
+export declare function stepHashFramesFromBlockAtSize(archivist: ArchivistInstance, head: Hash, sizeIndex: number): Promise<[Lowercase<string>, number, number][]>;
+export declare function stepHashFramesFromBlock(archivist: ArchivistInstance, head: Hash): Promise<[Lowercase<string>, number, number][]>;
+//# sourceMappingURL=stepHashFramesFromBlock.d.ts.map

package/dist/types/block/primitives/frames/stepHashFramesFromBlock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepHashFramesFromBlock.d.ts","sourceRoot":"","sources":["../../../../../src/block/primitives/frames/stepHashFramesFromBlock.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,IAAI,EAAU,MAAM,aAAa,CAAA;AAE/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AAIrE,wBAAsB,6BAA6B,CAAC,SAAS,EAAE,iBAAiB,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,kDA0B9G;AAGD,wBAAsB,uBAAuB,CAAC,SAAS,EAAE,iBAAiB,EAAE,IAAI,EAAE,IAAI,kDAmCrF"}

package/dist/types/block/primitives/index.d.ts

@@ -0,0 +1,2 @@
+export * from './frames/index.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/block/primitives/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/block/primitives/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA"}

package/dist/types/index.d.ts

@@ -1,3 +1,4 @@
+export * from './block/index.ts';
 export * from './instances/index.ts';
 export * from './transaction/index.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAA;AACpC,cAAc,wBAAwB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA;AAChC,cAAc,sBAAsB,CAAA;AACpC,cAAc,wBAAwB,CAAA"}

package/dist/types/instances/block/BlockFields.d.ts

@@ -1,6 +1,4 @@
 export interface BlockFieldsInstance<TTransactionResult> {
-    privatePayloadCount: number;
-    publicPayloadCount: number;
     reward: bigint;
     transactionCount: number;
     transactions: TTransactionResult[];

package/dist/types/instances/block/BlockFields.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BlockFields.d.ts","sourceRoot":"","sources":["../../../../src/instances/block/BlockFields.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB,CAAC,kBAAkB;IACrD,mBAAmB,EAAE,MAAM,CAAA;IAE3B,kBAAkB,EAAE,MAAM,CAAA;IAE1B,MAAM,EAAE,MAAM,CAAA;IAEd,gBAAgB,EAAE,MAAM,CAAA;IAExB,YAAY,EAAE,kBAAkB,EAAE,CAAA;IAElC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAAA;CAC3D"}
+{"version":3,"file":"BlockFields.d.ts","sourceRoot":"","sources":["../../../../src/instances/block/BlockFields.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB,CAAC,kBAAkB;IACrD,MAAM,EAAE,MAAM,CAAA;IAEd,gBAAgB,EAAE,MAAM,CAAA;IAExB,YAAY,EAAE,kBAAkB,EAAE,CAAA;IAElC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAAA;CAC3D"}

package/dist/types/instances/block/HydratedBlock.d.ts

@@ -3,6 +3,5 @@ import type { HydratedBoundWitnessInstance } from '../HydratedBoundWitness.ts';
 import type { HydratedTransactionInstance } from '../transaction/index.ts';
 import type { BlockFieldsInstance } from './BlockFields.ts';
 export interface HydratedBlockInstance<T extends HydratedBlock = HydratedBlock> extends BlockFieldsInstance<HydratedTransactionInstance>, HydratedBoundWitnessInstance<T> {
-    publicPayloads: T[1][number][];
 }
 //# sourceMappingURL=HydratedBlock.d.ts.map

package/dist/types/instances/block/HydratedBlock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HydratedBlock.d.ts","sourceRoot":"","sources":["../../../../src/instances/block/HydratedBlock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAE9D,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAA;AAC9E,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAA;AAC1E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AAE3D,MAAM,WAAW,qBAAqB,CAAC,CAAC,SAAS,aAAa,GAAG,aAAa,CAAE,SAC9E,mBAAmB,CAAC,2BAA2B,CAAC,EAAE,4BAA4B,CAAC,CAAC,CAAC;IACjF,cAAc,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAA;CAC/B"}
+{"version":3,"file":"HydratedBlock.d.ts","sourceRoot":"","sources":["../../../../src/instances/block/HydratedBlock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAE9D,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAA;AAC9E,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAA;AAC1E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AAE3D,MAAM,WAAW,qBAAqB,CAAC,CAAC,SAAS,aAAa,GAAG,aAAa,CAAE,SAC9E,mBAAmB,CAAC,2BAA2B,CAAC,EAAE,4BAA4B,CAAC,CAAC,CAAC;CAAG"}

package/dist/types/instances/transaction/TransactionFields.d.ts

@@ -1,9 +1,14 @@
+import type { Hash } from '@xylabs/hex';
+import type { Payload, Schema } from '@xyo-network/payload-model';
 import type { AllowedBlockPayload } from '@xyo-network/xl1-protocol';
 import type { TransactionFeesInstance } from '../Fees.ts';
 export interface TransactionFieldsInstance<TBlockPayload extends AllowedBlockPayload = AllowedBlockPayload> {
     elevatedPayloadCount: number;
     elevatedPayloads: TBlockPayload[];
+    externalPayloads: Record<Hash, Schema | Payload>;
     fees: TransactionFeesInstance;
+    privateExternalPayloads: Record<Hash, Schema>;
+    publicExternalPayloads: Payload[];
     elevatedPayload(index: number): TBlockPayload | undefined;
     reward(): bigint;
 }

package/dist/types/instances/transaction/TransactionFields.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TransactionFields.d.ts","sourceRoot":"","sources":["../../../../src/instances/transaction/TransactionFields.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AAEpE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAA;AAEzD,MAAM,WAAW,yBAAyB,CAAC,aAAa,SAAS,mBAAmB,GAAG,mBAAmB;IACxG,oBAAoB,EAAE,MAAM,CAAA;IAC5B,gBAAgB,EAAE,aAAa,EAAE,CAAA;IAEjC,IAAI,EAAE,uBAAuB,CAAA;IAE7B,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAA;IACzD,MAAM,IAAI,MAAM,CAAA;CACjB"}
+{"version":3,"file":"TransactionFields.d.ts","sourceRoot":"","sources":["../../../../src/instances/transaction/TransactionFields.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAA;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AAEpE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAA;AAEzD,MAAM,WAAW,yBAAyB,CAAC,aAAa,SAAS,mBAAmB,GAAG,mBAAmB;IACxG,oBAAoB,EAAE,MAAM,CAAA;IAC5B,gBAAgB,EAAE,aAAa,EAAE,CAAA;IACjC,gBAAgB,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAA;IAEhD,IAAI,EAAE,uBAAuB,CAAA;IAE7B,uBAAuB,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IAC7C,sBAAsB,EAAE,OAAO,EAAE,CAAA;IAEjC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAA;IACzD,MAAM,IAAI,MAAM,CAAA;CACjB"}

package/dist/types/transaction/index.d.ts

@@ -1,4 +1,4 @@
 export * from './buildTransaction.ts';
 export * from './hydrateTransaction.ts';
-export * from './transactionRequiredGas.ts';
+export * from './primitives/index.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/transaction/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/transaction/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAA;AACrC,cAAc,yBAAyB,CAAA;AACvC,cAAc,6BAA6B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/transaction/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAA;AACrC,cAAc,yBAAyB,CAAA;AACvC,cAAc,uBAAuB,CAAA"}

package/dist/types/transaction/primitives/index.d.ts

@@ -0,0 +1,5 @@
+export * from './transactionBlockByteCount.ts';
+export * from './transactionElevatedPayloads.ts';
+export * from './transactionOperations.ts';
+export * from './transactionRequiredGas.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/transaction/primitives/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/transaction/primitives/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAA;AAC9C,cAAc,kCAAkC,CAAA;AAChD,cAAc,4BAA4B,CAAA;AAC1C,cAAc,6BAA6B,CAAA"}

package/dist/types/transaction/primitives/transactionBlockByteCount.d.ts

@@ -0,0 +1,4 @@
+import type { HydratedTransaction } from '@xyo-network/xl1-protocol';
+/** The number of bytes that a transaction and its payloads will take up in a block */
+export declare function transactionBlockByteCount([transaction, payloads]: HydratedTransaction): number;
+//# sourceMappingURL=transactionBlockByteCount.d.ts.map

package/dist/types/transaction/primitives/transactionBlockByteCount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactionBlockByteCount.d.ts","sourceRoot":"","sources":["../../../../src/transaction/primitives/transactionBlockByteCount.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AAEpE,sFAAsF;AACtF,wBAAgB,yBAAyB,CAAC,CAAC,WAAW,EAAE,QAAQ,CAAC,EAAE,mBAAmB,GAAG,MAAM,CAK9F"}

package/dist/types/transaction/primitives/transactionElevatedPayloads.d.ts

@@ -0,0 +1,6 @@
+import { type Hash } from '@xylabs/hex';
+import type { Payload, WithHashStorageMeta } from '@xyo-network/payload-model';
+import type { HydratedTransactionWithHashStorageMeta, TransactionBoundWitness } from '@xyo-network/xl1-protocol';
+export declare function transactionElevatedPayloadHashes(transaction: TransactionBoundWitness): Hash[];
+export declare function transactionElevatedPayloads([transaction, payloads]: HydratedTransactionWithHashStorageMeta): WithHashStorageMeta<Payload>[];
+//# sourceMappingURL=transactionElevatedPayloads.d.ts.map

package/dist/types/transaction/primitives/transactionElevatedPayloads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactionElevatedPayloads.d.ts","sourceRoot":"","sources":["../../../../src/transaction/primitives/transactionElevatedPayloads.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,IAAI,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAC9E,OAAO,KAAK,EAAE,sCAAsC,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAA;AAIhH,wBAAgB,gCAAgC,CAAC,WAAW,EAAE,uBAAuB,GAAG,IAAI,EAAE,CAG7F;AAED,wBAAgB,2BAA2B,CAAC,CAAC,WAAW,EAAE,QAAQ,CAAC,EAAE,sCAAsC,GAAG,mBAAmB,CAAC,OAAO,CAAC,EAAE,CAI3I"}

package/dist/types/transaction/primitives/transactionOperations.d.ts

@@ -0,0 +1,3 @@
+export declare function crackOperation(operation: string): [string, string[]];
+export declare function crackOperations(operations: string[]): [string, string[]][];
+//# sourceMappingURL=transactionOperations.d.ts.map

package/dist/types/transaction/primitives/transactionOperations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactionOperations.d.ts","sourceRoot":"","sources":["../../../../src/transaction/primitives/transactionOperations.ts"],"names":[],"mappings":"AAAA,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAMpE;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,CAE1E"}

package/dist/types/transaction/primitives/transactionRequiredGas.d.ts

@@ -0,0 +1,6 @@
+import type { HydratedTransaction, HydratedTransactionWithHashStorageMeta } from '@xyo-network/xl1-protocol';
+import { AttoXL1 } from '@xyo-network/xl1-protocol';
+/** The required gas for the byte storage on the block chain for a transaction */
+export declare function transactionBytesRequiredGas([transaction, payloads]: HydratedTransaction): AttoXL1;
+export declare function transactionRequiredGas(hydratedTransaction: HydratedTransactionWithHashStorageMeta): AttoXL1;
+//# sourceMappingURL=transactionRequiredGas.d.ts.map

package/dist/types/transaction/primitives/transactionRequiredGas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactionRequiredGas.d.ts","sourceRoot":"","sources":["../../../../src/transaction/primitives/transactionRequiredGas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,sCAAsC,EAAE,MAAM,2BAA2B,CAAA;AAC5G,OAAO,EAAE,OAAO,EAAuB,MAAM,2BAA2B,CAAA;AAKxE,iFAAiF;AACjF,wBAAgB,2BAA2B,CAAC,CAAC,WAAW,EAAE,QAAQ,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAGjG;AAED,wBAAgB,sBAAsB,CAAC,mBAAmB,EAAE,sCAAsC,GAAG,OAAO,CAQ3G"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "http://json.schemastore.org/package.json",
   "name": "@xyo-network/xl1-protocol-sdk",
-  "version": "1.5.28",
+  "version": "1.5.30",
   "description": "XYO Layer One SDK Protocol",
   "homepage": "https://xylabs.com",
   "bugs": {
@@ -34,24 +34,27 @@
     "deploy3": "echo Deploy3 not allowed!"
   },
   "dependencies": {
-    "@xylabs/assert": "^4.11.16",
-    "@xylabs/hex": "^4.11.16",
-    "@xylabs/object": "^4.11.16",
-    "@xylabs/promise": "^4.11.16",
-    "@xyo-network/account-model": "^3.18.5",
-    "@xyo-network/archivist-model": "^3.18.5",
-    "@xyo-network/boundwitness-builder": "^3.18.5",
-    "@xyo-network/boundwitness-model": "^3.18.5",
-    "@xyo-network/payload-builder": "^3.18.5",
-    "@xyo-network/payload-model": "^3.18.5",
-    "@xyo-network/xl1-protocol": "^1.4.19"
+    "@xylabs/array": "^4.11.20",
+    "@xylabs/assert": "^4.11.20",
+    "@xylabs/hex": "^4.11.20",
+    "@xylabs/object": "^4.11.20",
+    "@xylabs/promise": "^4.11.20",
+    "@xylabs/typeof": "^4.11.20",
+    "@xyo-network/account-model": "^3.18.8",
+    "@xyo-network/archivist-model": "^3.18.8",
+    "@xyo-network/boundwitness-builder": "^3.18.8",
+    "@xyo-network/boundwitness-model": "^3.18.8",
+    "@xyo-network/payload-builder": "^3.18.8",
+    "@xyo-network/payload-model": "^3.18.8",
+    "@xyo-network/xl1-protocol": "^1.4.25"
   },
   "devDependencies": {
-    "@types/node": "^22.15.30",
+    "@types/node": "^24.0.1",
     "@xylabs/ts-scripts-yarn3": "^6.5.8",
     "@xylabs/tsconfig": "^6.5.8",
-    "knip": "^5.60.2",
-    "typescript": "^5.8.3"
+    "knip": "^5.61.0",
+    "typescript": "^5.8.3",
+    "vitest": "^3.2.3"
   },
   "engines": {
     "node": ">=22.3 <23"

package/src/block/hydrateBlock.ts

@@ -0,0 +1,83 @@
+import { filterAs } from '@xylabs/array'
+import { assertEx } from '@xylabs/assert'
+import type { Hash } from '@xylabs/hex'
+import type { ReadArchivist } from '@xyo-network/archivist-model'
+import type { Payload, WithStorageMeta } from '@xyo-network/payload-model'
+import type { HydratedBlock, TransactionBoundWitness } from '@xyo-network/xl1-protocol'
+import {
+  asOptionalBlockBoundWitnessWithStorageMeta, asOptionalTransactionBoundWitnessWithStorageMeta, isTransactionBoundWitnessWithStorageMeta,
+} from '@xyo-network/xl1-protocol'
+
+export function allHashesPresent(hashes: Hash[], payloads: WithStorageMeta<Payload>[]): boolean {
+  const payloadHashes = new Set(payloads.map(p => p._hash))
+  return hashes.every(hash => payloadHashes.has(hash))
+}
+
+export const tryHydrateBlock = async (
+  archivist: ReadArchivist,
+  hash: Hash,
+  maxDepth: number = 1,
+  minDepth?: number,
+): Promise<HydratedBlock | undefined> => {
+  try {
+    return await hydrateBlock(archivist, hash, maxDepth, minDepth)
+  } catch (e) {
+    if (e instanceof Error) {
+      console.warn(`Failed to hydrate block ${hash}: ${e.message}`)
+    } else {
+      console.warn(`Failed to hydrate block ${hash}: ${e}`)
+    }
+    return undefined
+  }
+}
+
+export const hydrateBlock = async (
+  archivist: ReadArchivist,
+  hash: Hash,
+  maxDepth: number = 1,
+  minDepth?: number,
+): Promise<HydratedBlock> => {
+  if (minDepth === undefined) minDepth = maxDepth
+  assertEx(maxDepth >= 0, () => 'maxDepth must be greater than or equal to 0')
+  assertEx(minDepth >= 0, () => 'minDepth must be greater than or equal to 0')
+  assertEx(maxDepth >= minDepth, () => 'maxDepth must be greater than or equal to minDepth')
+  const bw = assertEx(
+    filterAs(await archivist.get([hash]), asOptionalBlockBoundWitnessWithStorageMeta).at(0),
+    () => `block ${hash} not found`,
+  )
+  if (maxDepth === 0) return [bw, []]
+  const blkPayloads = await archivist.get(bw.payload_hashes)
+  if (minDepth === 1) assertEx(allHashesPresent(bw.payload_hashes, blkPayloads), () => `Unable to find all payloads for block ${hash}`)
+  if (maxDepth === 1) return [bw, blkPayloads]
+  const transactions = filterAs(blkPayloads, asOptionalTransactionBoundWitnessWithStorageMeta)
+  const transactionsPayloadHashes = transactions.flatMap(tx => tx.payload_hashes)
+  const transactionsPayloads = await archivist.get(transactionsPayloadHashes)
+  assertEx(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 archivist.get([...allPayloadsHashes])
+  const allPayloadsFiltered = allPayloads.filter(p => allPayloadsHashes.has(p._hash))
+  if (maxDepth === 2) assertEx(allHashesPresent(
+    [...allPayloadsHashes],
+    allPayloadsFiltered,
+  ), () => `Unable to find all payloads for transactions in block ${hash}`)
+  return [bw, allPayloadsFiltered]
+}
+
+export const flattenHydratedBlock = (hydratedBlock: HydratedBlock): WithStorageMeta<Payload>[] => {
+  const [blk, blkPayloads] = hydratedBlock
+  return [...blkPayloads, blk]
+}
+
+export const flattenHydratedBlocks = (hydratedBlocks: HydratedBlock[]): WithStorageMeta<Payload>[] =>
+  hydratedBlocks.flatMap(blk => flattenHydratedBlock(blk))
+
+export const transactionsFromHydratedBlock = (block: HydratedBlock): WithStorageMeta<TransactionBoundWitness>[] => {
+  return filterAs(block[1], asOptionalTransactionBoundWitnessWithStorageMeta)
+}
+
+export const blockPayloadsFromHydratedBlock = (block: HydratedBlock): WithStorageMeta<Payload>[] => {
+  return block[0].payload_hashes.map(hash => assertEx(
+    block[1].find(p => p._hash === hash),
+    () => `missing payload ${hash}`,
+  )).filter(x => !isTransactionBoundWitnessWithStorageMeta(x))
+}

package/src/block/index.ts

@@ -0,0 +1,2 @@
+export * from './hydrateBlock.ts'
+export * from './primitives/index.ts'

package/src/block/primitives/frames/BlockNumberRange.ts

@@ -0,0 +1 @@
+export type BlockNumberRange = [number, number]

package/src/block/primitives/frames/calculateFramesFromRange.ts

@@ -0,0 +1,29 @@
+import { stepSizeV2 } from '@xyo-network/xl1-protocol'
+
+import type { BlockNumberRange } from './BlockNumberRange.ts'
+
+export function calculateFramesFromRange(range: BlockNumberRange, step: number): [
+  // ranges of fitted frames
+  BlockNumberRange[],
+  // ranges of remaining blocks
+  BlockNumberRange[]] {
+  const size = stepSizeV2(step)
+  let start = (Math.trunc(range[0] / size)) * size
+  const fitted: BlockNumberRange[] = []
+  const remaining: BlockNumberRange[] = []
+
+  // if the start is not aligned with the range, add a remaining block
+  if (start !== range[0]) {
+    start += size
+    remaining.push([range[0], Math.min(start - 1, range[1])])
+  }
+
+  for (let i = start; i <= range[1]; i += size) {
+    if ((i + size - 1) <= range[1]) {
+      fitted.push([i, Math.min(i + size - 1, range[1])])
+    } else {
+      remaining.push([i, range[1]])
+    }
+  }
+  return [fitted, remaining]
+}

package/src/block/primitives/frames/deepCalculateFramesFromRange.ts

@@ -0,0 +1,27 @@
+import { StepSizesV2 } from '@xyo-network/xl1-protocol'
+
+import type { BlockNumberRange } from './BlockNumberRange.ts'
+import { calculateFramesFromRange } from './calculateFramesFromRange.ts'
+
+export function deepCalculateFramesFromRange(range: BlockNumberRange, startingStep = StepSizesV2.length - 1): BlockNumberRange[] {
+  const fitted: BlockNumberRange[] = []
+  let remaining: BlockNumberRange[] = [range]
+
+  for (let step = startingStep; step >= 0; step--) {
+    const newRemaining: BlockNumberRange[] = []
+    for (const range of remaining) {
+      const [newFittedFrames, newRemainingFrames] = calculateFramesFromRange(range, step)
+      fitted.push(...newFittedFrames)
+      newRemaining.push(...newRemainingFrames)
+    }
+    remaining = newRemaining
+  }
+
+  for (const range of remaining) {
+    for (let i = range[0]; i <= range[1]; i++) {
+      fitted.push([i, i]) // Add individual frames for remaining ranges
+    }
+  }
+
+  return fitted.toSorted((a, b) => a[0] - b[0]) // Sort by start of range
+}

package/src/block/primitives/frames/index.ts

@@ -0,0 +1,2 @@
+export * from './BlockNumberRange.ts'
+export * from './stepHashFramesFromBlock.ts'

package/src/block/primitives/frames/loadFrameSummaries.ts

@@ -0,0 +1,12 @@
+import type { ArchivistInstance } from '@xyo-network/archivist-model'
+import type { Payload } from '@xyo-network/payload-model'
+
+import type { BlockNumberRange } from './BlockNumberRange.ts'
+
+export async function loadFrameSummaries(
+  ranges: BlockNumberRange[],
+  finalizedArchivist: ArchivistInstance,
+  summaryArchivist: ArchivistInstance,
+): Promise<Payload[]> {
+  return await Promise.resolve([])
+}

package/src/block/primitives/frames/stepHashFramesFromBlock.ts

@@ -0,0 +1,72 @@
+import { assertEx } from '@xylabs/assert'
+import { type Hash, isHash } from '@xylabs/hex'
+import { isDefined } from '@xylabs/typeof'
+import type { ArchivistInstance } from '@xyo-network/archivist-model'
+import { isBlockBoundWitness, StepSizes } from '@xyo-network/xl1-protocol'
+
+// get the list of step frames for a block at a specific step size index
+export async function stepHashFramesFromBlockAtSize(archivist: ArchivistInstance, head: Hash, sizeIndex: number) {
+  if (!Number.isInteger(sizeIndex) || sizeIndex < 0 || sizeIndex >= StepSizes.length) {
+    throw new Error(`Invalid sizeIndex: ${sizeIndex}`)
+  }
+  let currentHead = head
+  const steps: [Hash, number, number][] = []
+  while (isHash(currentHead)) {
+    const [block] = await archivist.get([currentHead])
+    if (!isBlockBoundWitness(block)) {
+      throw new Error(`Block with hash ${currentHead} not found`)
+    }
+    let stepHash = block.step_hashes.at(sizeIndex)
+    while (isDefined(stepHash)) {
+      const [stepHashBlock] = await archivist.get([stepHash])
+      if (!isBlockBoundWitness(stepHashBlock)) {
+        throw new Error(`StepHashBlock with hash ${currentHead} not found`)
+      }
+      const [lastBlockInStep] = await archivist.get([assertEx(stepHashBlock.previous, () => 'StepHashBlock must have a previous block')])
+      if (!isBlockBoundWitness(lastBlockInStep)) {
+        throw new Error(`StepHashBlock with hash ${currentHead} not found`)
+      }
+      steps.push([stepHash, stepHashBlock.block - StepSizes[sizeIndex], stepHashBlock.block - 1])
+      stepHash = lastBlockInStep.step_hashes.at(sizeIndex)
+    }
+  }
+  return steps
+}
+
+// TODO: Figure out how to get ranges of smaller blocks for each available range
+export async function stepHashFramesFromBlock(archivist: ArchivistInstance, head: Hash) {
+  const [block] = await archivist.get([head])
+  if (!isBlockBoundWitness(block)) {
+    throw new Error(`Block with hash ${head} not found`)
+  }
+  let availableRanges: [number, number][] = [[0, block.block]]
+  const foundRanges: [Hash, number, number][] = []
+  // fit biggest to smallest
+  for (let i = StepSizes.length - 1; i >= 0; i--) {
+    const steps = await stepHashFramesFromBlockAtSize(archivist, head, i)
+    for (let step of steps) {
+      const [, start, end] = step
+      if (availableRanges.some(range => range[0] <= start && range[1] >= end)) {
+        foundRanges.push(step)
+        availableRanges = availableRanges.flatMap((range) => {
+          if (range[0] >= start && range[1] <= end) {
+            // remove the range
+            return [[range[0], start - 1]]
+          } else if (range[0] < start && range[1] >= end) {
+            // split the range
+            return [[range[0], start - 1], [end + 1, range[1]]]
+          } else if (range[0] < start && range[1] < end) {
+            // adjust the end of the range
+            return [[range[0], start - 1]]
+          } else if (range[0] > start && range[1] > end) {
+            // adjust the start of the range
+            return [[end + 1, range[1]]]
+          }
+          // otherwise, return the range as is
+          return [range]
+        })
+      }
+    }
+  }
+  return foundRanges
+}

package/src/block/primitives/index.ts

@@ -0,0 +1 @@
+export * from './frames/index.ts'

package/src/index.ts

@@ -1,2 +1,3 @@
+export * from './block/index.ts'
 export * from './instances/index.ts'
 export * from './transaction/index.ts'

package/src/instances/block/BlockFields.ts

@@ -1,8 +1,4 @@
 export interface BlockFieldsInstance<TTransactionResult> {
-  privatePayloadCount: number
-
-  publicPayloadCount: number
-
   reward: bigint
 
   transactionCount: number

package/src/instances/block/HydratedBlock.ts

@@ -5,6 +5,4 @@ import type { HydratedTransactionInstance } from '../transaction/index.ts'
 import type { BlockFieldsInstance } from './BlockFields.ts'
 
 export interface HydratedBlockInstance<T extends HydratedBlock = HydratedBlock> extends
-  BlockFieldsInstance<HydratedTransactionInstance>, HydratedBoundWitnessInstance<T> {
-  publicPayloads: T[1][number][]
-}
+  BlockFieldsInstance<HydratedTransactionInstance>, HydratedBoundWitnessInstance<T> {}

package/src/instances/transaction/TransactionFields.ts

@@ -1,3 +1,5 @@
+import type { Hash } from '@xylabs/hex'
+import type { Payload, Schema } from '@xyo-network/payload-model'
 import type { AllowedBlockPayload } from '@xyo-network/xl1-protocol'
 
 import type { TransactionFeesInstance } from '../Fees.ts'
@@ -5,9 +7,13 @@ import type { TransactionFeesInstance } from '../Fees.ts'
 export interface TransactionFieldsInstance<TBlockPayload extends AllowedBlockPayload = AllowedBlockPayload> {
   elevatedPayloadCount: number
   elevatedPayloads: TBlockPayload[]
+  externalPayloads: Record<Hash, Schema | Payload>
 
   fees: TransactionFeesInstance
 
+  privateExternalPayloads: Record<Hash, Schema>
+  publicExternalPayloads: Payload[]
+
   elevatedPayload(index: number): TBlockPayload | undefined
   reward(): bigint
 }

package/src/transaction/index.ts

@@ -1,3 +1,3 @@
 export * from './buildTransaction.ts'
 export * from './hydrateTransaction.ts'
-export * from './transactionRequiredGas.ts'
+export * from './primitives/index.ts'

package/src/transaction/primitives/index.ts

@@ -0,0 +1,4 @@
+export * from './transactionBlockByteCount.ts'
+export * from './transactionElevatedPayloads.ts'
+export * from './transactionOperations.ts'
+export * from './transactionRequiredGas.ts'

package/src/transaction/primitives/transactionBlockByteCount.ts

@@ -0,0 +1,10 @@
+import { PayloadBuilder } from '@xyo-network/payload-builder'
+import type { HydratedTransaction } from '@xyo-network/xl1-protocol'
+
+/** The number of bytes that a transaction and its payloads will take up in a block */
+export function transactionBlockByteCount([transaction, payloads]: HydratedTransaction): number {
+  const cleanTransaction = PayloadBuilder.omitStorageMeta(transaction)
+  const transactionBytes = JSON.stringify(cleanTransaction).length
+  const cleanPayloads = PayloadBuilder.omitStorageMeta(payloads)
+  return cleanPayloads.reduce((acc: number, payload) => acc + JSON.stringify(payload).length, 0) + transactionBytes
+}

package/src/transaction/primitives/transactionElevatedPayloads.ts

@@ -0,0 +1,16 @@
+import { asHash, type Hash } from '@xylabs/hex'
+import type { Payload, WithHashStorageMeta } from '@xyo-network/payload-model'
+import type { HydratedTransactionWithHashStorageMeta, TransactionBoundWitness } from '@xyo-network/xl1-protocol'
+
+import { crackOperations } from './transactionOperations.ts'
+
+export function transactionElevatedPayloadHashes(transaction: TransactionBoundWitness): Hash[] {
+  const elevateOperations = crackOperations(transaction.script ?? []).filter(op => op[0] === 'elevate')
+  return elevateOperations.map(op => asHash(op[1][0], true))
+}
+
+export function transactionElevatedPayloads([transaction, payloads]: HydratedTransactionWithHashStorageMeta): WithHashStorageMeta<Payload>[] {
+  const hashes = transactionElevatedPayloadHashes(transaction)
+  const elevatedPayloads = payloads.filter(payload => hashes.includes(payload._hash))
+  return elevatedPayloads
+}

package/src/transaction/primitives/transactionOperations.ts

@@ -0,0 +1,11 @@
+export function crackOperation(operation: string): [string, string[]] {
+  const parts = operation.split('|')
+  if (parts.length < 2) {
+    throw new Error(`Invalid operation format: ${operation}`)
+  }
+  return [parts[0], parts.slice(1)]
+}
+
+export function crackOperations(operations: string[]): [string, string[]][] {
+  return operations.map(op => crackOperation(op))
+}

package/src/transaction/primitives/transactionRequiredGas.ts

@@ -0,0 +1,21 @@
+import type { HydratedTransaction, HydratedTransactionWithHashStorageMeta } from '@xyo-network/xl1-protocol'
+import { AttoXL1, TransactionGasCosts } from '@xyo-network/xl1-protocol'
+
+import { transactionBlockByteCount } from './transactionBlockByteCount.ts'
+import { transactionElevatedPayloads } from './transactionElevatedPayloads.ts'
+
+/** The required gas for the byte storage on the block chain for a transaction */
+export function transactionBytesRequiredGas([transaction, payloads]: HydratedTransaction): AttoXL1 {
+  const transactionBlockBytes = transactionBlockByteCount([transaction, payloads])
+  return AttoXL1(TransactionGasCosts.characterStorage * BigInt(transactionBlockBytes))
+}
+
+export function transactionRequiredGas(hydratedTransaction: HydratedTransactionWithHashStorageMeta): AttoXL1 {
+  const elevatedPayloads = transactionElevatedPayloads(hydratedTransaction)
+  const hashes = elevatedPayloads.length + 1 /* for transaction itself */
+  const signatures = hydratedTransaction[0].addresses.length
+  return AttoXL1(transactionBytesRequiredGas(hydratedTransaction)
+    + TransactionGasCosts.hashValidation * BigInt(hashes)
+    + TransactionGasCosts.signatureValidation * BigInt(signatures)
+    + TransactionGasCosts.payloadValidation * BigInt(elevatedPayloads.length))
+}

package/dist/types/transaction/transactionRequiredGas.d.ts

@@ -1,4 +0,0 @@
-import type { HydratedTransaction } from '@xyo-network/xl1-protocol';
-import { AttoXL1 } from '@xyo-network/xl1-protocol';
-export declare function transactionRequiredGas([transaction, payloads]: HydratedTransaction): AttoXL1;
-//# sourceMappingURL=transactionRequiredGas.d.ts.map

package/dist/types/transaction/transactionRequiredGas.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"transactionRequiredGas.d.ts","sourceRoot":"","sources":["../../../src/transaction/transactionRequiredGas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AACpE,OAAO,EAAE,OAAO,EAAuB,MAAM,2BAA2B,CAAA;AAExE,wBAAgB,sBAAsB,CAAC,CAAC,WAAW,EAAE,QAAQ,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAS5F"}

package/knip.config.ts

@@ -1,15 +0,0 @@
-import type { KnipConfig } from 'knip'
-
-const config: KnipConfig = {
-  entry: [
-    'src/index.ts',
-  ],
-  project: ['src/**/*.ts*'],
-  typescript: {
-    config: [
-      'tsconfig.json',
-    ],
-  },
-}
-
-export default config

package/src/transaction/transactionRequiredGas.ts

@@ -1,13 +0,0 @@
-import type { HydratedTransaction } from '@xyo-network/xl1-protocol'
-import { AttoXL1, TransactionGasCosts } from '@xyo-network/xl1-protocol'
-
-export function transactionRequiredGas([transaction, payloads]: HydratedTransaction): AttoXL1 {
-  const characters = payloads.reduce((acc: number, payload) => acc + JSON.stringify(payload).length, 0)
-  const hashes = transaction.payload_hashes.length + 1 /* for transaction itself */
-  const signatures = transaction.addresses.length + 1
-  const elevatedPayloads = (transaction.script ?? []).length
-  return AttoXL1(TransactionGasCosts.characterStorage * BigInt(characters)
-    + TransactionGasCosts.hashValidation * BigInt(hashes)
-    + TransactionGasCosts.signatureValidation * BigInt(signatures)
-    + TransactionGasCosts.payloadValidation * BigInt(elevatedPayloads))
-}