@xyo-network/xl1-protocol-sdk 1.26.4 → 1.26.7

package/dist/neutral/index.mjs

@@ -2167,7 +2167,7 @@ import {
 } from "@xylabs/sdk-js";
 import { span } from "@xylabs/sdk-js";
 import { isTransfer } from "@xyo-network/xl1-protocol-lib";
-var netBalancesForPayloads = (payloads) => {
+var netBalancesForPayloads = (context, payloads) => {
   return span("netBalancesForPayloads", () => {
     const balances = {};
     for (const payload of payloads) {
@@ -2180,7 +2180,7 @@ var netBalancesForPayloads = (payloads) => {
       }
     }
     return balances;
-  });
+  }, context.traceProvider);
 };
 
 // src/payloads/netSchemasForPayloads.ts
@@ -2190,7 +2190,7 @@ import {
 } from "@xylabs/sdk-js";
 import { span as span2 } from "@xylabs/sdk-js";
 import { isTransfer as isTransfer2 } from "@xyo-network/xl1-protocol-lib";
-var netSchemasForPayloads = (payloads) => {
+var netSchemasForPayloads = (context, payloads) => {
   return span2("netSchemasForPayloads", () => {
     const balances = {};
     for (const payload of payloads) {
@@ -2203,7 +2203,7 @@ var netSchemasForPayloads = (payloads) => {
       }
     }
     return balances;
-  });
+  }, context.traceProvider);
 };
 
 // src/payloads/netTransfersForPayloads.ts
@@ -2212,7 +2212,7 @@ import {
 } from "@xylabs/sdk-js";
 import { span as span3 } from "@xylabs/sdk-js";
 import { isTransfer as isTransfer3 } from "@xyo-network/xl1-protocol-lib";
-function netTransfersForPayloads(payloads) {
+function netTransfersForPayloads(context, payloads) {
   return span3("netTransfersForPayloads", () => {
     const transfers = {};
     for (const payload of payloads) {
@@ -2227,7 +2227,7 @@ function netTransfersForPayloads(payloads) {
       }
     }
     return transfers;
-  });
+  }, context.traceProvider);
 }
 
 // src/primitives/block/range/blockRangeSteps.ts
@@ -2586,7 +2586,7 @@ async function stepRewardTotal(context, blockViewer, { block, step }, multiplier
       () => `No step transfer found for step ${step} at block ${block} (${blockBw._hash})`
     );
     const rewards = assertEx22(
-      netTransfersForPayloads([stepTransfer])[XYO_STEP_REWARD_ADDRESS2],
+      netTransfersForPayloads(context, [stepTransfer])[XYO_STEP_REWARD_ADDRESS2],
       () => `No rewards found for step reward address ${XYO_STEP_REWARD_ADDRESS2} at block ${block} (${blockBw._hash})`
     );
     const sortedTransfers = Object.entries(rewards).toSorted(([, a], [, b]) => a > b ? -1 : a < b ? 1 : 0);
@@ -3218,7 +3218,7 @@ async function balancesStepSummaryFromRange(context, semaphores, blockViewer, su
       return frameSize === 1 ? await spanRootAsync2(`balancesStepSummaryFromRange.frameSize=1[${key}]`, async () => {
         const [, payloads] = assertEx26(await blockViewer.blockByNumber(range[0]), () => `Block not found for number: ${range[0]}`);
         const balances = {};
-        for (const [address, balance] of Object.entries(netBalancesForPayloads(payloads))) {
+        for (const [address, balance] of Object.entries(netBalancesForPayloads(context, payloads))) {
           balances[address] = toSignedBigInt(balance);
         }
         return {
@@ -3422,7 +3422,7 @@ async function transfersStepSummaryFromRange(context, semaphores, blockViewer, s
       if (frameSize === 1) {
         const [, payloads] = assertEx30(await blockViewer.blockByNumber(range[0]), () => `Block not found for number: ${range[0]}`);
         const transfers = {};
-        for (const [from, toMap] of Object.entries(netTransfersForPayloads(payloads))) {
+        for (const [from, toMap] of Object.entries(netTransfersForPayloads(context, payloads))) {
           transfers[from] = transfers[from] ?? {};
           for (const [to, amount] of Object.entries(toMap)) {
             transfers[from][to] = toSignedBigInt(amount);
@@ -3818,13 +3818,11 @@ var SimpleBlockViewer = class extends AbstractCreatableProvider {
   }
   async blockByNumber(blockNumber) {
     return await this.spanAsync("blockByNumber", async () => {
-      const [head] = await this.currentBlock();
-      if (isUndefined6(head)) {
+      const chainContext = await this.getChainContextRead();
+      if (isUndefined6(chainContext.head)) {
         return null;
       }
-      const block = asSignedHydratedBlockWithHashMeta(await hydratedBlockByNumber(await this.getChainContextRead(), blockNumber)) ?? null;
-      const [result] = block ? await addDataLakePayloads(block, this.dataLakeViewer) : [null, []];
-      return result;
+      return await this.blockByNumberWithContext(chainContext, blockNumber);
     }, { ...this.context, timeBudgetLimit: 100 });
   }
   async blocksByHash(hash, limit = 50) {
@@ -3846,13 +3844,17 @@ var SimpleBlockViewer = class extends AbstractCreatableProvider {
     return await this.spanAsync("blocksByNumber", async () => {
       assertEx33(limit > 0, () => "limit must be greater than 0");
       assertEx33(limit <= 100, () => "limit must be less than 100");
+      const chainContext = await this.getChainContextRead();
+      if (isUndefined6(chainContext.head)) {
+        return [];
+      }
       const blocks = [];
-      let current = await this.blockByNumber(blockNumber);
+      let current = await this.blockByNumberWithContext(chainContext, blockNumber);
       while (current && blocks.length < limit) {
         blocks.push(current);
         if (current[0].block === 0) break;
         const previousNumber = asXL1BlockNumber9(current[0].block - 1, true);
-        current = await this.blockByNumber(previousNumber);
+        current = await this.blockByNumberWithContext(chainContext, previousNumber);
       }
       return blocks.map((b) => asSignedHydratedBlockWithHashMeta(b, true));
     }, this.context);
@@ -3915,6 +3917,11 @@ var SimpleBlockViewer = class extends AbstractCreatableProvider {
       head: (await this.finalizationViewer.head())[0]
     };
   }
+  async blockByNumberWithContext(chainContext, blockNumber) {
+    const block = asSignedHydratedBlockWithHashMeta(await hydratedBlockByNumber(chainContext, blockNumber)) ?? null;
+    const [result] = block ? await addDataLakePayloads(block, this.dataLakeViewer) : [null, []];
+    return result;
+  }
 };
 __publicField(SimpleBlockViewer, "defaultMoniker", BlockViewerMoniker2);
 __publicField(SimpleBlockViewer, "dependencies", [FinalizationViewerMoniker]);
@@ -4586,7 +4593,8 @@ import {
   isHydratedTransactionWithHashMeta,
   isSignedHydratedBlockWithHashMeta,
   isSignedHydratedTransactionWithHashMeta,
-  MempoolRunnerMoniker
+  MempoolRunnerMoniker,
+  TransactionValidationViewerMoniker
 } from "@xyo-network/xl1-protocol-lib";
 import { Mutex } from "async-mutex";
 var DEFAULT_SYNC_INTERVAL = 3e4;
@@ -4596,6 +4604,7 @@ var SimpleMempoolRunner = class extends AbstractCreatableProvider {
   _blockValidationViewer;
   _chainContractViewer;
   _finalizationViewer;
+  _transactionValidationViewer;
   _syncMutex = new Mutex();
   _syncTimerId = null;
   get blockValidationViewer() {
@@ -4625,6 +4634,9 @@ var SimpleMempoolRunner = class extends AbstractCreatableProvider {
   get syncLimit() {
     return this.params.syncLimit ?? DEFAULT_SYNC_LIMIT;
   }
+  get transactionValidationViewer() {
+    return this._transactionValidationViewer;
+  }
   static async paramsHandler(params) {
     return {
       ...await super.paramsHandler(params),
@@ -4637,6 +4649,7 @@ var SimpleMempoolRunner = class extends AbstractCreatableProvider {
     this._blockValidationViewer = await this.locator.getInstance(BlockValidationViewerMoniker2);
     this._chainContractViewer = await this.locator.getInstance(ChainContractViewerMoniker4);
     this._finalizationViewer = await this.locator.getInstance(FinalizationViewerMoniker4);
+    this._transactionValidationViewer = await this.locator.getInstance(TransactionValidationViewerMoniker);
   }
   async prunePendingBlocks({
     batchSize = 10,
@@ -4668,7 +4681,7 @@ var SimpleMempoolRunner = class extends AbstractCreatableProvider {
         remainingBlockMap.length === remainingBlocks.length,
         () => `remainingBlockMap length should match remainingBlocks length [${remainingBlockMap.length}/${remainingBlocks.length}]`
       );
-      const validationResults = await this.blockValidationViewer.validateBlocks(remainingBlocks, { value: true, state: false });
+      const validationResults = await this.blockValidationViewer.validateBlocks(remainingBlocks, { value: true, state: true });
       for (const [i, r] of validationResults.entries()) {
         const validated = isHydratedBlockWithHashMeta(r);
         if (!validated) {
@@ -4725,7 +4738,7 @@ var SimpleMempoolRunner = class extends AbstractCreatableProvider {
         remainingTransactionMap.length === remainingTransactions.length,
         () => `remainingTransactionMap length should match remainingTransactions length [${remainingTransactionMap.length}/${remainingTransactions.length}]`
       );
-      const validationResults = remainingTransactions.map((t) => t);
+      const validationResults = await this.transactionValidationViewer.validateTransactions(remainingTransactions, { value: true, state: true });
       for (const [i, r] of validationResults.entries()) {
         const validated = isHydratedTransactionWithHashMeta(r);
         if (!validated) {
@@ -4881,7 +4894,7 @@ var SimpleMempoolRunner = class extends AbstractCreatableProvider {
   }
 };
 __publicField(SimpleMempoolRunner, "defaultMoniker", MempoolRunnerMoniker);
-__publicField(SimpleMempoolRunner, "dependencies", [FinalizationViewerMoniker4, BlockValidationViewerMoniker2, ChainContractViewerMoniker4]);
+__publicField(SimpleMempoolRunner, "dependencies", [FinalizationViewerMoniker4, BlockValidationViewerMoniker2, TransactionValidationViewerMoniker, ChainContractViewerMoniker4]);
 __publicField(SimpleMempoolRunner, "monikers", [MempoolRunnerMoniker]);
 SimpleMempoolRunner = __decorateClass([
   creatableProvider()
@@ -5699,16 +5712,133 @@ SimpleTimeSyncViewer = __decorateClass([
   creatableProvider()
 ], SimpleTimeSyncViewer);
 
+// src/simple/transactionValidation/SimpleTransactionValidationViewer.ts
+import { assertEx as assertEx45 } from "@xylabs/sdk-js";
+import { PayloadBuilder as PayloadBuilder23 } from "@xyo-network/sdk-js";
+import {
+  AccountBalanceViewerMoniker as AccountBalanceViewerMoniker3,
+  asXL1BlockRange as asXL1BlockRange12,
+  BlockViewerMoniker as BlockViewerMoniker5,
+  ChainContractViewerMoniker as ChainContractViewerMoniker5,
+  isChainQualifiedHeadConfig as isChainQualifiedHeadConfig6,
+  isHydratedTransaction,
+  TransactionValidationViewerMoniker as TransactionValidationViewerMoniker2
+} from "@xyo-network/xl1-protocol-lib";
+var SimpleTransactionValidationViewer = class extends AbstractCreatableProvider {
+  moniker = SimpleTransactionValidationViewer.defaultMoniker;
+  _accountBalanceViewer;
+  _blockViewer;
+  _chainContractViewer;
+  get blockViewer() {
+    return this._blockViewer;
+  }
+  get chainContractViewer() {
+    return this._chainContractViewer;
+  }
+  get maxUncleWindowSize() {
+    return this.params.maxUncleWindowSize;
+  }
+  static async paramsHandler(params) {
+    return {
+      ...await super.paramsHandler(params),
+      protocol: params.protocol,
+      state: params.state,
+      maxUncleWindowSize: params.maxUncleWindowSize ?? 100
+    };
+  }
+  async createHandler() {
+    await super.createHandler();
+    this._accountBalanceViewer = await this.locator.getInstance(AccountBalanceViewerMoniker3);
+    this._chainContractViewer = await this.locator.getInstance(ChainContractViewerMoniker5);
+    this._blockViewer = await this.locator.getInstance(BlockViewerMoniker5);
+  }
+  async qualifiedValidateTransaction(block, config) {
+    const result = await this.qualifiedValidateTransactions([block], config);
+    return [result[0][0], result[1]];
+  }
+  async qualifiedValidateTransactions(transactions, config) {
+    const { value, state } = config ?? {
+      shape: true,
+      links: true,
+      state: true,
+      head: void 0
+    };
+    const transactionsWithMeta = await Promise.all(transactions.map((b) => Promise.all([PayloadBuilder23.addHashMeta(b[0]), PayloadBuilder23.addHashMeta(b[1])])));
+    const head = isChainQualifiedHeadConfig6(config) ? assertEx45(
+      (await this.blockViewer.blockByHash(config.head))?.[0],
+      () => `Specified a head that is not in the chain [${config.head}]`
+    ) : void 0;
+    const headBlock = head ?? (await this.blockViewer.currentBlock())[0];
+    const validateProtocol = value ? this.doValidateProtocol.bind(this) : void 0;
+    const validateState = state ? this.doValidateState.bind(this) : void 0;
+    const chainId = headBlock.chain;
+    const qualification = { head: headBlock._hash, range: asXL1BlockRange12([0, headBlock.block], true) };
+    const [protocolResults, stateResults] = await Promise.all([
+      validateProtocol?.(transactionsWithMeta, chainId),
+      validateState?.(transactionsWithMeta, chainId)
+    ]);
+    const blockResults = transactionsWithMeta.map((r, i) => {
+      const errors = [];
+      if (protocolResults && !isHydratedTransaction(protocolResults[i])) {
+        errors.push(...protocolResults[i]);
+      }
+      if (stateResults && !isHydratedTransaction(stateResults[i])) {
+        errors.push(...stateResults[i]);
+      }
+      return errors.length === 0 ? r : errors;
+    });
+    return [blockResults, qualification];
+  }
+  qualifiedValidateUncle(_transactions, _config) {
+    throw new Error("Method not implemented.");
+  }
+  async validateTransaction(block, config) {
+    return (await this.validateTransactions([block], config))[0];
+  }
+  async validateTransactions(transactions, config) {
+    return (await this.qualifiedValidateTransactions(transactions, config))[0];
+  }
+  async doValidateProtocol(transactions, chainId) {
+    return await Promise.all(transactions.map(async (tx) => {
+      const errors = await this.params.protocol(
+        { ...this.context, chainId },
+        tx
+      );
+      return errors.length === 0 ? tx : errors;
+    }));
+  }
+  async doValidateState(transactions, chainId) {
+    return await Promise.all(transactions.map(async (tx) => {
+      const errors = await this.params.state(
+        {
+          ...this.context,
+          chainId,
+          accountBalanceViewer: this._accountBalanceViewer,
+          blockViewer: this.blockViewer
+        },
+        tx
+      );
+      return errors.length === 0 ? tx : errors;
+    }));
+  }
+};
+__publicField(SimpleTransactionValidationViewer, "defaultMoniker", TransactionValidationViewerMoniker2);
+__publicField(SimpleTransactionValidationViewer, "dependencies", [AccountBalanceViewerMoniker3, ChainContractViewerMoniker5, BlockViewerMoniker5]);
+__publicField(SimpleTransactionValidationViewer, "monikers", [TransactionValidationViewerMoniker2]);
+SimpleTransactionValidationViewer = __decorateClass([
+  creatableProvider()
+], SimpleTransactionValidationViewer);
+
 // src/simple/TransactionViewer/SimpleTransactionViewer.ts
 import {
-  assertEx as assertEx45,
+  assertEx as assertEx46,
   exists as exists10
 } from "@xylabs/sdk-js";
 import { BoundWitnessSchema } from "@xyo-network/sdk-js";
 import {
   asSignedHydratedTransactionWithHashMeta,
   asSignedTransactionBoundWitness,
-  BlockViewerMoniker as BlockViewerMoniker5,
+  BlockViewerMoniker as BlockViewerMoniker6,
   isTransactionBoundWitnessWithHashMeta,
   TransactionViewerMoniker
 } from "@xyo-network/xl1-protocol-lib";
@@ -5720,7 +5850,7 @@ var SimpleTransactionViewer = class extends AbstractCreatableProvider {
   }
   async byBlockHashAndIndex(blockHash, transactionIndex) {
     return await this.spanAsync("byBlockHashAndIndex", async () => {
-      assertEx45(transactionIndex >= 0, () => "transactionIndex must be greater than or equal to 0");
+      assertEx46(transactionIndex >= 0, () => "transactionIndex must be greater than or equal to 0");
       try {
         const block = await this.blockViewer.blockByHash(blockHash);
         if (!block) return null;
@@ -5763,7 +5893,7 @@ var SimpleTransactionViewer = class extends AbstractCreatableProvider {
   }
   async createHandler() {
     await super.createHandler();
-    this._blockViewer = await this.locator.getInstance(BlockViewerMoniker5);
+    this._blockViewer = await this.locator.getInstance(BlockViewerMoniker6);
   }
   async transactionByBlockHashAndIndex(blockHash, transactionIndex = 0) {
     return await this.byBlockHashAndIndex(blockHash, transactionIndex);
@@ -5776,7 +5906,7 @@ var SimpleTransactionViewer = class extends AbstractCreatableProvider {
   }
 };
 __publicField(SimpleTransactionViewer, "defaultMoniker", TransactionViewerMoniker);
-__publicField(SimpleTransactionViewer, "dependencies", [BlockViewerMoniker5]);
+__publicField(SimpleTransactionViewer, "dependencies", [BlockViewerMoniker6]);
 __publicField(SimpleTransactionViewer, "monikers", [TransactionViewerMoniker]);
 SimpleTransactionViewer = __decorateClass([
   creatableProvider()
@@ -5784,13 +5914,13 @@ SimpleTransactionViewer = __decorateClass([
 
 // src/simple/windowedBlock/SimpleWindowedBlockViewer.ts
 import {
-  assertEx as assertEx46,
+  assertEx as assertEx47,
   exists as exists11,
   isNull as isNull2
 } from "@xylabs/sdk-js";
 import {
   asXL1BlockNumber as asXL1BlockNumber12,
-  BlockViewerMoniker as BlockViewerMoniker6,
+  BlockViewerMoniker as BlockViewerMoniker7,
   WindowedBlockViewerMoniker as WindowedBlockViewerMoniker2
 } from "@xyo-network/xl1-protocol-lib";
 import { Mutex as Mutex2 } from "async-mutex";
@@ -5855,8 +5985,8 @@ var SimpleWindowedBlockViewer = class extends AbstractCreatableProvider {
   }
   async createHandler() {
     await super.createHandler();
-    this._blockViewer = assertEx46(
-      this.params.blockViewer ?? await this.locator.getInstance(BlockViewerMoniker6),
+    this._blockViewer = assertEx47(
+      this.params.blockViewer ?? await this.locator.getInstance(BlockViewerMoniker7),
       () => "BlockViewer instance is required"
     );
     this._blockHashMap = new MemoryMap();
@@ -5864,13 +5994,13 @@ var SimpleWindowedBlockViewer = class extends AbstractCreatableProvider {
     this._transactionHashMap = new MemoryMap();
   }
   currentBlock() {
-    return assertEx46(this._chain.at(-1));
+    return assertEx47(this._chain.at(-1));
   }
   currentBlockHash() {
-    return assertEx46(this._chain.at(-1)?.[0]._hash);
+    return assertEx47(this._chain.at(-1)?.[0]._hash);
   }
   currentBlockNumber() {
-    return assertEx46(this._chain.at(-1)?.[0].block);
+    return assertEx47(this._chain.at(-1)?.[0].block);
   }
   async payloadByHash(hash) {
     const payloads = await this.payloadsByHash([hash]);
@@ -5941,7 +6071,7 @@ var SimpleWindowedBlockViewer = class extends AbstractCreatableProvider {
   }
 };
 __publicField(SimpleWindowedBlockViewer, "defaultMoniker", WindowedBlockViewerMoniker2);
-__publicField(SimpleWindowedBlockViewer, "dependencies", [BlockViewerMoniker6]);
+__publicField(SimpleWindowedBlockViewer, "dependencies", [BlockViewerMoniker7]);
 __publicField(SimpleWindowedBlockViewer, "monikers", [WindowedBlockViewerMoniker2]);
 SimpleWindowedBlockViewer = __decorateClass([
   creatableProvider()
@@ -6029,13 +6159,13 @@ var RuntimeStatusMonitor = class extends LoggerStatusReporter {
 };
 
 // src/time/primitives/xl1BlockNumberToEthBlockNumber.ts
-import { assertEx as assertEx47 } from "@xylabs/sdk-js";
+import { assertEx as assertEx48 } from "@xylabs/sdk-js";
 import { asTimePayload as asTimePayload3, TimeSchema as TimeSchema2 } from "@xyo-network/xl1-protocol-lib";
 async function xl1BlockNumberToEthBlockNumber(context, xl1BlockNumber) {
   const blockHash = await hashFromBlockNumber(context, xl1BlockNumber);
   const hydratedBlock = await hydrateBlock(context, blockHash);
   const timePayload = asTimePayload3(hydratedBlock[1].find((p) => p.schema === TimeSchema2), { required: true });
-  return assertEx47(timePayload.ethereum, () => "No ethereum timestamp found on block");
+  return assertEx48(timePayload.ethereum, () => "No ethereum timestamp found on block");
 }
 
 // src/wallet/generateXyoBaseWalletFromPhrase.ts
@@ -6127,6 +6257,7 @@ export {
   SimpleStakeTotalsViewer,
   SimpleStakeViewer,
   SimpleTimeSyncViewer,
+  SimpleTransactionValidationViewer,
   SimpleTransactionViewer,
   SimpleWindowedBlockViewer,
   SimpleXyoClient,