@xyo-network/xl1-validation 1.26.9 → 1.26.11

package/dist/neutral/block/validators/BlockCumulativeBalanceValidator.d.ts

@@ -1,4 +1,7 @@
-import type { HydratedBlockStateValidationFunction } from '@xyo-network/xl1-protocol-lib';
+import { type Address } from '@xylabs/sdk-js';
+import type { HydratedBlockStateValidationFunction, HydratedBlockWithHashMeta, TransactionBoundWitnessWithHashMeta } from '@xyo-network/xl1-protocol-lib';
+/** Accumulate outflows per address from fees and transfers in the given transactions. */
+export declare function accumulateOutflows(transactions: TransactionBoundWitnessWithHashMeta[], payloads: HydratedBlockWithHashMeta[1]): Record<Address, bigint>;
 /** Creates a block state validator that checks cumulative outflows per address do not exceed pre-block balances. */
 export declare function BlockCumulativeBalanceValidatorFactory(): HydratedBlockStateValidationFunction;
 //# sourceMappingURL=BlockCumulativeBalanceValidator.d.ts.map

package/dist/neutral/block/validators/BlockCumulativeBalanceValidator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BlockCumulativeBalanceValidator.d.ts","sourceRoot":"","sources":["../../../../src/block/validators/BlockCumulativeBalanceValidator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,oCAAoC,EAErC,MAAM,+BAA+B,CAAA;AAetC,oHAAoH;AACpH,wBAAgB,sCAAsC,IAAI,oCAAoC,CAqD7F"}
+{"version":3,"file":"BlockCumulativeBalanceValidator.d.ts","sourceRoot":"","sources":["../../../../src/block/validators/BlockCumulativeBalanceValidator.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EACb,MAAM,gBAAgB,CAAA;AACvB,OAAO,KAAK,EACV,oCAAoC,EACpC,yBAAyB,EACzB,mCAAmC,EACpC,MAAM,+BAA+B,CAAA;AAgBtC,yFAAyF;AACzF,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,mCAAmC,EAAE,EACnD,QAAQ,EAAE,yBAAyB,CAAC,CAAC,CAAC,GACrC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAsBzB;AAED,oHAAoH;AACpH,wBAAgB,sCAAsC,IAAI,oCAAoC,CAqC7F"}

package/dist/neutral/boundwitness/validators/BoundWitnessReferences.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BoundWitnessReferences.d.ts","sourceRoot":"","sources":["../../../../src/boundwitness/validators/BoundWitnessReferences.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,YAAY,EAEZ,MAAM,EAEP,MAAM,qBAAqB,CAAA;AAE5B,OAAO,KAAK,EAAE,sCAAsC,EAAoC,MAAM,+BAA+B,CAAA;AAO7H,qKAAqK;AACrK,eAAO,MAAM,+BAA+B,GAEvC,CAAC,SAAS,YAAY,GAAG,YAAY,EAAE,iBAAiB,MAAM,EAAE,KAAG,sCAAsC,CAAC,CAAC,CAuC7G,CAAA"}
+{"version":3,"file":"BoundWitnessReferences.d.ts","sourceRoot":"","sources":["../../../../src/boundwitness/validators/BoundWitnessReferences.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,YAAY,EAEZ,MAAM,EAEP,MAAM,qBAAqB,CAAA;AAE5B,OAAO,KAAK,EAAE,sCAAsC,EAAoC,MAAM,+BAA+B,CAAA;AAO7H,qKAAqK;AACrK,eAAO,MAAM,+BAA+B,GAEvC,CAAC,SAAS,YAAY,GAAG,YAAY,EAAE,iBAAiB,MAAM,EAAE,KAAG,sCAAsC,CAAC,CAAC,CAsC7G,CAAA"}

package/dist/neutral/index.mjs

@@ -5,42 +5,48 @@ import {
 import {
   HydratedBlockStateValidationError,
   isTransactionBoundWitnessWithHashMeta,
-  isTransfer
+  isTransfer,
+  XYO_ZERO_ADDRESS
 } from "@xyo-network/xl1-protocol-lib";
-function transactionFeeCost(tx) {
+function maxTransactionFeeCost(tx) {
   const {
     base,
     gasLimit,
-    gasPrice,
     priority
   } = tx.fees;
-  return hexToBigInt(base) + hexToBigInt(priority) + hexToBigInt(gasLimit) * hexToBigInt(gasPrice);
+  return hexToBigInt(base) + hexToBigInt(priority) + hexToBigInt(gasLimit);
+}
+function accumulateOutflows(transactions, payloads) {
+  const outflows = {};
+  for (const tx of transactions) {
+    const feeCost = maxTransactionFeeCost(tx);
+    const feePayer = tx.from;
+    outflows[feePayer] = (outflows[feePayer] ?? 0n) + feeCost;
+    const txPayloadHashes = new Set(tx.payload_hashes);
+    for (const payload of payloads) {
+      if (!txPayloadHashes.has(payload._hash) || !isTransfer(payload)) continue;
+      const { from } = payload;
+      for (const [to, amount] of Object.entries(payload.transfers)) {
+        if (to === from) continue;
+        outflows[from] = (outflows[from] ?? 0n) + hexToBigInt(amount);
+      }
+    }
+  }
+  return outflows;
 }
 function BlockCumulativeBalanceValidatorFactory() {
   return async (context, hydratedBlock) => {
     const [blockBw, payloads] = hydratedBlock;
     const transactions = payloads.filter(isTransactionBoundWitnessWithHashMeta);
     if (transactions.length === 0) return [];
-    const outflows = {};
-    for (const tx of transactions) {
-      const feeCost = transactionFeeCost(tx);
-      const feePayer = tx.from;
-      outflows[feePayer] = (outflows[feePayer] ?? 0n) + feeCost;
-      const txPayloadHashes = new Set(tx.payload_hashes);
-      for (const payload of payloads) {
-        if (!txPayloadHashes.has(payload._hash) || !isTransfer(payload)) continue;
-        const { from } = payload;
-        for (const amount of Object.values(payload.transfers)) {
-          outflows[from] = (outflows[from] ?? 0n) + hexToBigInt(amount);
-        }
-      }
-    }
+    const outflows = accumulateOutflows(transactions, payloads);
     const addresses = Object.keys(outflows);
     if (addresses.length === 0) return [];
     const balances = await context.accountBalance.accountBalances(addresses);
     const chainId = await context.chainIdAtBlockNumber(blockBw.block);
     const errors = [];
     for (const address of addresses) {
+      if (address === XYO_ZERO_ADDRESS) continue;
       const balance = balances[address] ?? 0n;
       const totalOutflow = outflows[address];
       if (totalOutflow > balance) {
@@ -90,8 +96,7 @@ var BoundWitnessReferencesValidator = (allowedSchemas) => ([bw, payloadSet]) =>
       }
     }
   } catch (ex) {
-    const error = new HydratedBoundWitnessValidationError(bw?._hash ?? ZERO_HASH, [bw, payloadSet], `validation excepted: ${ex}`);
-    error.cause = ex;
+    const error = new HydratedBoundWitnessValidationError(bw?._hash ?? ZERO_HASH, [bw, payloadSet], `validation excepted: ${ex}`, ex);
     errors.push(error);
   }
   return errors;
@@ -312,9 +317,9 @@ var TransactionJsonSchemaValidator = (context, tx) => {
       const error = new HydratedTransactionValidationError5(
         tx?.[0]?._hash ?? ZERO_HASH7,
         tx,
-        `failed JSON schema validation: ${ajv.errorsText(validate.errors, { separator: "\n" })}`
+        `failed JSON schema validation: ${ajv.errorsText(validate.errors, { separator: "\n" })}`,
+        validate.errors
       );
-      error.cause = validate.errors;
       errors.push(error);
     }
   } catch (ex) {
@@ -424,6 +429,7 @@ export {
   TransactionJsonSchemaValidator,
   TransactionProtocolValidator,
   TransactionTransfersValidatorFactory,
+  accumulateOutflows,
   validateTransaction
 };
 //# sourceMappingURL=index.mjs.map

package/dist/neutral/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/block/validators/BlockCumulativeBalanceValidator.ts","../../src/boundwitness/validators/BoundWitnessReferences.ts","../../src/boundwitness/validators/BoundWitnessSignatures.ts","../../src/transaction/validateTransaction.ts","../../src/transaction/validators/TransactionDurationValidator.ts","../../src/transaction/validators/TransactionElevationValidator.ts","../../src/transaction/validators/TransactionFromValidator.ts","../../src/transaction/validators/TransactionGasValidator.ts","../../src/transaction/validators/TransactionJsonSchemaValidator.ts","../../src/transaction/validators/TransactionProtocolValidator.ts","../../src/transaction/validators/TransactionTransfersValidator.ts"],"sourcesContent":["import {\n  type Address, type Hex, hexToBigInt,\n} from '@xylabs/sdk-js'\nimport type {\n  HydratedBlockStateValidationFunction,\n  TransactionBoundWitnessWithHashMeta,\n} from '@xyo-network/xl1-protocol-lib'\nimport {\n  HydratedBlockStateValidationError,\n  isTransactionBoundWitnessWithHashMeta,\n  isTransfer,\n} from '@xyo-network/xl1-protocol-lib'\n\n/** Compute the maximum fee commitment for a transaction (base + priority + gasLimit * gasPrice). */\nfunction transactionFeeCost(tx: TransactionBoundWitnessWithHashMeta): bigint {\n  const {\n    base, gasLimit, gasPrice, priority,\n  } = tx.fees\n  return hexToBigInt(base) + hexToBigInt(priority) + (hexToBigInt(gasLimit) * hexToBigInt(gasPrice))\n}\n\n/** Creates a block state validator that checks cumulative outflows per address do not exceed pre-block balances. */\nexport function BlockCumulativeBalanceValidatorFactory(): HydratedBlockStateValidationFunction {\n  return async (context, hydratedBlock) => {\n    const [blockBw, payloads] = hydratedBlock\n\n    // Find all transactions in the block\n    const transactions = payloads.filter(isTransactionBoundWitnessWithHashMeta)\n\n    if (transactions.length === 0) return []\n\n    // Accumulate outflows per address\n    const outflows: Record<Address, bigint> = {}\n\n    for (const tx of transactions) {\n      // Fee cost charged to the transaction sender\n      const feeCost = transactionFeeCost(tx)\n      const feePayer = tx.from\n      outflows[feePayer] = (outflows[feePayer] ?? 0n) + feeCost\n\n      // Find transfer payloads belonging to this transaction\n      const txPayloadHashes = new Set(tx.payload_hashes)\n      for (const payload of payloads) {\n        if (!txPayloadHashes.has(payload._hash) || !isTransfer(payload)) continue\n        const { from } = payload\n        for (const amount of Object.values(payload.transfers) as Hex[]) {\n          outflows[from] = (outflows[from] ?? 0n) + hexToBigInt(amount)\n        }\n      }\n    }\n\n    // Query pre-block balances for all addresses with outflows\n    const addresses = Object.keys(outflows) as Address[]\n    if (addresses.length === 0) return []\n\n    const balances = await context.accountBalance.accountBalances(addresses)\n\n    // Check each address\n    const chainId = await context.chainIdAtBlockNumber(blockBw.block)\n    const errors: HydratedBlockStateValidationError[] = []\n    for (const address of addresses) {\n      const balance = balances[address] ?? 0n\n      const totalOutflow = outflows[address]\n      if (totalOutflow > balance) {\n        errors.push(new HydratedBlockStateValidationError(\n          blockBw._hash,\n          chainId,\n          hydratedBlock,\n          `Cumulative outflow for address ${address} exceeds available balance: outflow ${totalOutflow} > balance ${balance}`,\n        ))\n      }\n    }\n\n    return errors\n  }\n}\n","import type { Hash, Promisable } from '@xylabs/sdk-js'\nimport { ZERO_HASH } from '@xylabs/sdk-js'\nimport type {\n  BoundWitness,\n  Payload,\n  Schema,\n  WithHashMeta,\n} from '@xyo-network/sdk-js'\nimport { isAnyPayload } from '@xyo-network/sdk-js'\nimport type { HydratedBoundWitnessValidationFunction, HydratedBoundWitnessWithHashMeta } from '@xyo-network/xl1-protocol-lib'\nimport { HydratedBoundWitnessValidationError } from '@xyo-network/xl1-protocol-lib'\n\nfunction getPayloadsFromPayloadArray(payloads: WithHashMeta<Payload>[], hashes: Hash[]): (WithHashMeta<Payload> | undefined)[] {\n  return hashes.map(hash => payloads.find(payload => payload._hash === hash || payload._dataHash === hash))\n}\n\n/** Creates a validator that checks all payload references in a BoundWitness are present, have matching schemas, and optionally conform to an allowed schema list. */\nexport const BoundWitnessReferencesValidator\n\n  = <T extends BoundWitness = BoundWitness>(allowedSchemas?: Schema[]): HydratedBoundWitnessValidationFunction<T> => (\n    [bw, payloadSet]: HydratedBoundWitnessWithHashMeta<T>,\n  // eslint-disable-next-line complexity\n  ): Promisable<HydratedBoundWitnessValidationError[]> => {\n    const errors: HydratedBoundWitnessValidationError[] = []\n    try {\n      const payloads = getPayloadsFromPayloadArray(payloadSet, bw.payload_hashes)\n      if (payloads.length !== bw.payload_hashes.length) {\n        errors.push(new HydratedBoundWitnessValidationError(bw?._hash ?? ZERO_HASH, [bw, payloadSet], 'unable to locate payloads'))\n      }\n\n      // check if payloads are valid and if their schemas match the declared schemas\n      for (let payload of payloads) {\n        if (isAnyPayload(payload)) {\n          const payloadHashIndex = bw.payload_hashes.indexOf(payload._hash)\n          const payloadDataHashIndex = bw.payload_hashes.indexOf(payload._dataHash)\n          const payloadIndex = Math.max(payloadHashIndex, payloadDataHashIndex)\n          if (payloadIndex === -1) {\n            errors.push(new HydratedBoundWitnessValidationError(bw?._hash ?? ZERO_HASH, [bw, payloadSet], 'payload hash not found'))\n          }\n\n          const declaredSchema = bw.payload_schemas[payloadIndex]\n          if (declaredSchema !== payload.schema) {\n            errors.push(new HydratedBoundWitnessValidationError(bw?._hash ?? ZERO_HASH, [bw, payloadSet], 'mismatched schema'))\n          }\n\n          if (allowedSchemas && !allowedSchemas.includes(payload.schema)) {\n            errors.push(new HydratedBoundWitnessValidationError(bw?._hash ?? ZERO_HASH, [bw, payloadSet], `disallowed schema [${payload.schema}]`))\n          }\n        } else {\n          errors.push(new HydratedBoundWitnessValidationError(bw?._hash ?? ZERO_HASH, [bw, payloadSet], 'invalid payload'))\n        }\n      }\n    } catch (ex) {\n      const error = new HydratedBoundWitnessValidationError(bw?._hash ?? ZERO_HASH, [bw, payloadSet], `validation excepted: ${ex}`)\n      error.cause = ex\n      errors.push(error)\n    }\n    return errors\n  }\n","import { type Address, ZERO_HASH } from '@xylabs/sdk-js'\nimport { toArrayBuffer } from '@xylabs/sdk-js'\nimport type { BoundWitness, WithStorageMeta } from '@xyo-network/sdk-js'\nimport { BoundWitnessBuilder, BoundWitnessValidator } from '@xyo-network/sdk-js'\nimport type { BoundWitnessValidationFunction } from '@xyo-network/xl1-protocol-lib'\nimport { BoundWitnessValidationError } from '@xyo-network/xl1-protocol-lib'\n\n/** Validates that all signatures on a BoundWitness are cryptographically valid for their corresponding addresses. */\nexport const BoundWitnessSignaturesValidator: BoundWitnessValidationFunction = async (\n  bw: BoundWitness,\n) => {\n  const errors: BoundWitnessValidationError[] = []\n  try {\n    const dataHash = await BoundWitnessBuilder.dataHash(bw)\n    const results: [Address, Error[]][] = await Promise.all(bw.addresses.map(async (address, index) => {\n      return [address, await BoundWitnessValidator.validateSignature(\n        toArrayBuffer(dataHash),\n        toArrayBuffer(address),\n        toArrayBuffer(bw.$signatures[index] ?? undefined),\n      )]\n    }))\n    for (const [, bwErrors] of results) {\n      for (const bwError of bwErrors) {\n        errors.push(new BoundWitnessValidationError((bw as WithStorageMeta<BoundWitness>)?._hash ?? ZERO_HASH, bw, 'validation errors', bwError))\n      }\n    }\n  } catch (ex) {\n    errors.push(new BoundWitnessValidationError((bw as WithStorageMeta<BoundWitness>)?._hash ?? ZERO_HASH, bw, 'validation excepted', ex))\n  }\n  return errors\n}\n","import type {\n  HydratedTransactionValidationFunction,\n  HydratedTransactionValidationFunctionContext,\n  HydratedTransactionWithHashMeta,\n} from '@xyo-network/xl1-protocol-lib'\nimport { isTransactionBoundWitness } from '@xyo-network/xl1-protocol-lib'\n\nimport {\n  TransactionDurationValidator,\n  TransactionElevationValidator, TransactionFromValidator, TransactionGasValidator, TransactionProtocolValidator,\n} from './validators/index.ts'\n\n/** Validates a hydrated transaction using built-in validators plus any additional validators provided. */\nexport async function validateTransaction(\n  context: HydratedTransactionValidationFunctionContext,\n  tx: HydratedTransactionWithHashMeta,\n  additionalValidators?: HydratedTransactionValidationFunction[],\n) {\n  try {\n    if (!isTransactionBoundWitness(tx[0])) {\n      return [new Error('failed isTransactionBoundWitness identity check')]\n    }\n\n    const validators: HydratedTransactionValidationFunction<HydratedTransactionValidationFunctionContext>[] = [\n      TransactionProtocolValidator,\n      TransactionDurationValidator,\n      TransactionFromValidator,\n      TransactionGasValidator,\n      TransactionElevationValidator,\n      ...(additionalValidators ?? []),\n    ]\n    return (await Promise.all(validators.map(v => v(context, tx)))).flat()\n  } catch (ex) {\n    return [(new Error(`Failed TransactionGasValidator: ${ex}`))]\n  }\n}\n","import { ZERO_HASH } from '@xylabs/sdk-js'\nimport type { HydratedTransactionValidationFunction } from '@xyo-network/xl1-protocol-lib'\nimport { HydratedTransactionValidationError } from '@xyo-network/xl1-protocol-lib'\n\n/** Validates that transaction timing fields (nbf and exp) are positive, correctly ordered, and within allowed duration limits. */\nexport const TransactionDurationValidator: HydratedTransactionValidationFunction = (\n  context,\n  tx,\n// eslint-disable-next-line complexity\n) => {\n  const errors: HydratedTransactionValidationError[] = []\n  try {\n    const { exp, nbf } = tx[0]\n    if (nbf < 0) errors.push(new HydratedTransactionValidationError(tx?.[0]?._hash ?? ZERO_HASH, tx, 'Transaction nbf must be positive'))\n\n    if (exp < 0) errors.push(new HydratedTransactionValidationError(tx?.[0]?._hash ?? ZERO_HASH, tx, 'Transaction exp must be positive'))\n    if (exp <= nbf) errors.push(new HydratedTransactionValidationError(tx?.[0]?._hash ?? ZERO_HASH, tx, 'Transaction exp must greater than nbf'))\n    if (exp - nbf > 10_000) errors.push(new HydratedTransactionValidationError(\n      tx?.[0]?._hash ?? ZERO_HASH,\n      tx,\n      'Transaction exp must not be too far in the future',\n    ))\n  } catch (ex) {\n    errors.push(new HydratedTransactionValidationError(\n      tx?.[0]?._hash ?? ZERO_HASH,\n      tx,\n      `Failed TransactionDurationValidator: ${ex}`,\n      ex,\n    ))\n  }\n\n  return errors\n}\n","import { ZERO_HASH } from '@xylabs/sdk-js'\nimport type { HydratedTransactionValidationFunction } from '@xyo-network/xl1-protocol-lib'\nimport { HydratedTransactionValidationError } from '@xyo-network/xl1-protocol-lib'\nimport { extractElevatedHashes } from '@xyo-network/xl1-protocol-sdk'\n\n/** Validates that a hydrated transaction includes all required elevated script hashes. */\nexport const TransactionElevationValidator: HydratedTransactionValidationFunction = (\n  context,\n  tx,\n) => {\n  const errors: HydratedTransactionValidationError[] = []\n  try {\n    try {\n      extractElevatedHashes(tx)\n    } catch {\n      errors.push(new HydratedTransactionValidationError(tx?.[0]?._hash ?? ZERO_HASH, tx, 'Hydrated transaction does not include all script hashes'))\n    }\n  } catch (ex) {\n    errors.push(new HydratedTransactionValidationError(\n      tx?.[0]?._hash ?? ZERO_HASH,\n      tx,\n      `Failed TransactionElevationValidator: ${ex}`,\n      ex,\n    ))\n  }\n  return errors\n}\n","import { asAddress, ZERO_HASH } from '@xylabs/sdk-js'\nimport { addressesContains } from '@xyo-network/sdk-js'\nimport type { HydratedTransactionValidationFunction } from '@xyo-network/xl1-protocol-lib'\nimport { HydratedTransactionValidationError } from '@xyo-network/xl1-protocol-lib'\n\n/** Validates that the transaction's from field is a valid address and is included in the BoundWitness addresses. */\nexport const TransactionFromValidator: HydratedTransactionValidationFunction = (\n  context,\n  tx,\n) => {\n  const errors: HydratedTransactionValidationError[] = []\n  try {\n    const from = asAddress(tx[0].from)\n    if (from === undefined)errors.push(new HydratedTransactionValidationError(\n      tx?.[0]?._hash ?? ZERO_HASH,\n      tx,\n      'Transaction from is not a valid address',\n    ))\n    else if (!addressesContains(tx[0], from)) errors.push(new HydratedTransactionValidationError(\n      tx?.[0]?._hash ?? ZERO_HASH,\n      tx,\n      'Transaction from address must be listed in addresses',\n    ))\n  } catch (ex) {\n    errors.push(new HydratedTransactionValidationError(\n      tx?.[0]?._hash ?? ZERO_HASH,\n      tx,\n      `Failed TransactionFromValidator: ${ex}`,\n      ex,\n    ))\n  }\n  return errors\n}\n","import { hexToBigInt, ZERO_HASH } from '@xylabs/sdk-js'\nimport type {\n  HydratedTransactionValidationFunction,\n  TransactionFeesBigInt, TransactionFeesHex,\n} from '@xyo-network/xl1-protocol-lib'\nimport {\n  AttoXL1,\n  HydratedTransactionValidationError,\n  minTransactionFees,\n} from '@xyo-network/xl1-protocol-lib'\n\n/** Validates that transaction fee fields (base, gasLimit, gasPrice, priority) are present and meet minimum requirements. */\nexport const TransactionGasValidator: HydratedTransactionValidationFunction = (\n  context,\n  tx,\n// eslint-disable-next-line complexity\n) => {\n  const errors: HydratedTransactionValidationError[] = []\n  try {\n    if (tx?.[0].fees === undefined) {\n      errors.push(new HydratedTransactionValidationError(\n        tx?.[0]?._hash ?? ZERO_HASH,\n        tx,\n        'Missing fees',\n      ))\n    } else {\n      const {\n        base, gasLimit, gasPrice, priority,\n      } = parseFees(tx[0].fees)\n\n      if (base === undefined) errors.push(new HydratedTransactionValidationError(\n        tx?.[0]?._hash ?? ZERO_HASH,\n        tx,\n        'fees.base must be defined and a valid number',\n      ))\n      else if (base < minTransactionFees.base) errors.push(new HydratedTransactionValidationError(\n        tx?.[0]?._hash ?? ZERO_HASH,\n        tx,\n        `fees.base must be >= ${minTransactionFees.base}`,\n      ))\n\n      if (gasLimit === undefined) errors.push(new HydratedTransactionValidationError(\n        tx?.[0]?._hash ?? ZERO_HASH,\n        tx,\n        'fees.gasLimit must be defined and a valid number',\n      ))\n      else if (gasLimit < minTransactionFees.gasLimit) errors.push(new HydratedTransactionValidationError(\n        tx?.[0]?._hash ?? ZERO_HASH,\n        tx,\n        `fees.gasLimit must be >= ${minTransactionFees.gasLimit}`,\n      ))\n\n      if (gasPrice === undefined) errors.push(\n        new HydratedTransactionValidationError(\n          tx?.[0]?._hash ?? ZERO_HASH,\n          tx,\n          'fees.gasPrice must be defined and a valid number',\n        ),\n      )\n      else if (gasPrice < minTransactionFees.gasPrice) errors.push(new HydratedTransactionValidationError(\n        tx?.[0]?._hash ?? ZERO_HASH,\n        tx,\n        `fees.gasPrice must be >= ${minTransactionFees.gasPrice}`,\n      ))\n\n      if (priority === undefined) errors.push(new HydratedTransactionValidationError(\n        tx?.[0]?._hash ?? ZERO_HASH,\n        tx,\n        'fees.priority must be defined and a valid number',\n      ))\n      else if (priority < minTransactionFees.priority) errors.push(new HydratedTransactionValidationError(\n        tx?.[0]?._hash ?? ZERO_HASH,\n        tx,\n        `fees.priority must be >= ${minTransactionFees.priority}`,\n      ))\n    }\n  } catch (ex) {\n    errors.push(new HydratedTransactionValidationError(\n      tx?.[0]?._hash ?? ZERO_HASH,\n      tx,\n      `Failed TransactionGasValidator: ${ex}`,\n      ex,\n    ))\n  }\n  return errors\n}\n\nconst parseFees = (fees: TransactionFeesHex): Partial<TransactionFeesBigInt> => {\n  const ret: Partial<TransactionFeesBigInt> = {}\n  const {\n    base, gasLimit, gasPrice, priority,\n  } = fees\n  if (base !== undefined) ret.base = AttoXL1(hexToBigInt(base))\n  if (gasLimit !== undefined) ret.gasLimit = AttoXL1(hexToBigInt(gasLimit))\n  if (gasPrice !== undefined) ret.gasPrice = AttoXL1(hexToBigInt(gasPrice))\n  if (priority !== undefined) ret.priority = AttoXL1(hexToBigInt(priority))\n  return ret\n}\n","import { ZERO_HASH } from '@xylabs/sdk-js'\nimport { PayloadBuilder } from '@xyo-network/sdk-js'\nimport type { HydratedTransactionValidationFunction, TransactionBoundWitness } from '@xyo-network/xl1-protocol-lib'\nimport { HydratedTransactionValidationError } from '@xyo-network/xl1-protocol-lib'\nimport { TransactionBoundWitnessJsonSchema } from '@xyo-network/xl1-schema'\nimport type { ValidateFunction } from 'ajv'\nimport { Ajv } from 'ajv'\n\nconst ajv = new Ajv({ allErrors: true, strict: true })\n\nlet validate: ValidateFunction<TransactionBoundWitness> | undefined\n\n/** Validates a transaction against the TransactionBoundWitness JSON schema using AJV. */\nexport const TransactionJsonSchemaValidator: HydratedTransactionValidationFunction = (\n  context,\n  tx,\n) => {\n  const errors: HydratedTransactionValidationError[] = []\n  try {\n    if (validate === undefined) validate = ajv.compile(TransactionBoundWitnessJsonSchema)\n    if (!validate(PayloadBuilder.omitStorageMeta(tx[0]))) {\n      const error = new HydratedTransactionValidationError(\n        tx?.[0]?._hash ?? ZERO_HASH,\n        tx,\n        `failed JSON schema validation: ${ajv.errorsText(validate.errors, { separator: '\\n' })}`,\n      )\n      error.cause = validate.errors\n      errors.push(error)\n    }\n  } catch (ex) {\n    errors.push(new HydratedTransactionValidationError(tx?.[0]?._hash ?? ZERO_HASH, tx, 'validation excepted', ex))\n  }\n  return errors\n}\n","import { ZERO_HASH } from '@xylabs/sdk-js'\nimport type {\n  ChainId,\n  HydratedTransactionValidationFunction,\n} from '@xyo-network/xl1-protocol-lib'\nimport { HydratedTransactionValidationError } from '@xyo-network/xl1-protocol-lib'\n\n/** Validates that the transaction's chain ID matches the expected chain ID from the validation context. */\nexport const TransactionProtocolValidator: HydratedTransactionValidationFunction = async (\n  context: { chainId?: ChainId },\n  tx,\n) => {\n  const errors: HydratedTransactionValidationError[] = []\n  try {\n    if (context?.chainId !== undefined && tx[0].chain !== context.chainId) {\n      errors.push(new HydratedTransactionValidationError(tx?.[0]?._hash ?? ZERO_HASH, tx, `invalid chain id [${context.chainId}, ${tx[0].chain}]`))\n    }\n  } catch (ex) {\n    errors.push(new HydratedTransactionValidationError(tx?.[0]?._hash ?? ZERO_HASH, tx, 'validation excepted', ex))\n  }\n  return await Promise.resolve(errors)\n}\n","import type { Address } from '@xylabs/sdk-js'\nimport { isDefined, isUndefined } from '@xylabs/sdk-js'\nimport type {\n  HydratedTransactionValidationFunction, StepIdentity,\n  Transfer,\n} from '@xyo-network/xl1-protocol-lib'\nimport { HydratedTransactionValidationError, isTransfer } from '@xyo-network/xl1-protocol-lib'\nimport {\n  completedStepRewardAddress, derivedReceiveAddress, elevatedPayloads,\n} from '@xyo-network/xl1-protocol-sdk'\n\n/** Function type that checks whether a signer is authorized to sign for a given signee address. */\nexport type SignerValidator = (signer: Address, signee: Address, context?: { address?: Address; scope?: string; step?: StepIdentity }) => boolean\n\n/** Maps addresses to their list of authorized signer addresses. */\nexport type SignerMapping = Map<Address, Address[]>\n\n/** A signer validator that only allows an address to sign for itself. */\nexport const SelfSignerValidator: SignerValidator = (signer: Address, signee: Address) => signer === signee\n\n/** Creates a signer validator that authorizes specified signers to sign for completed step reward addresses. */\nexport const CompletedStepRewardAddressValidatorFactory = (allowedSigners: Address[]): SignerValidator => (\n  signer: Address,\n  signee: Address,\n  context?: { step?: StepIdentity },\n) => {\n  const step = context?.step\n  if (isDefined(step)) {\n    const contextAddress = completedStepRewardAddress(step)\n    return allowedSigners.includes(signer) && signee === contextAddress\n  } else {\n    return false\n  }\n}\n\n/** Creates a signer validator that authorizes specified signers to sign for derived receive addresses within a given scope. */\nexport const DerivedReceiveAddressValidatorFactory = (allowedSigners: Address[], allowedScope: string): SignerValidator => (\n  signer: Address,\n  signee: Address,\n  context?: { address?: Address; scope?: string },\n) => {\n  const { address, scope } = context ?? {}\n  if (scope !== allowedScope) {\n    return false\n  }\n  if (isDefined(address)) {\n    const derivedAddress = derivedReceiveAddress(address, scope)\n    return allowedSigners.includes(signer) && signee === derivedAddress\n  } else {\n    return false\n  }\n}\n\n/** Creates a transaction validator that checks all transfers are authorized by the transaction signer. */\nexport function TransactionTransfersValidatorFactory(\n  signerValidators: SignerValidator[] = [SelfSignerValidator],\n): HydratedTransactionValidationFunction {\n  return async (\n    context,\n    hydratedTx,\n  ) => {\n    const errors: HydratedTransactionValidationError[] = []\n    const signer = hydratedTx[0].from\n    try {\n      const payloads = elevatedPayloads(hydratedTx)\n      const transfers = payloads.filter(isTransfer) as Transfer[]\n      for (const transfer of transfers) {\n        if (isUndefined(signerValidators.find(v => v(signer, transfer.from, transfer.context)))) {\n          errors.push(new HydratedTransactionValidationError(\n            hydratedTx[0]._hash,\n            hydratedTx,\n            `transfer from address ${transfer.from} is not authorized by signer ${signer}`,\n          ))\n        }\n      }\n    } catch (ex) {\n      errors.push(new HydratedTransactionValidationError(hydratedTx[0]._hash, hydratedTx, 'validation excepted', ex))\n    }\n    return await Promise.resolve(errors)\n  }\n}\n"],"mappings":"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","names":["ZERO_HASH","ZERO_HASH","ZERO_HASH","HydratedTransactionValidationError","ZERO_HASH","HydratedTransactionValidationError","hexToBigInt","ZERO_HASH","HydratedTransactionValidationError","ZERO_HASH","HydratedTransactionValidationError","ZERO_HASH","HydratedTransactionValidationError","HydratedTransactionValidationError","isTransfer"]}
+{"version":3,"sources":["../../src/block/validators/BlockCumulativeBalanceValidator.ts","../../src/boundwitness/validators/BoundWitnessReferences.ts","../../src/boundwitness/validators/BoundWitnessSignatures.ts","../../src/transaction/validateTransaction.ts","../../src/transaction/validators/TransactionDurationValidator.ts","../../src/transaction/validators/TransactionElevationValidator.ts","../../src/transaction/validators/TransactionFromValidator.ts","../../src/transaction/validators/TransactionGasValidator.ts","../../src/transaction/validators/TransactionJsonSchemaValidator.ts","../../src/transaction/validators/TransactionProtocolValidator.ts","../../src/transaction/validators/TransactionTransfersValidator.ts"],"sourcesContent":["import {\n  type Address, type Hex, hexToBigInt,\n} from '@xylabs/sdk-js'\nimport type {\n  HydratedBlockStateValidationFunction,\n  HydratedBlockWithHashMeta,\n  TransactionBoundWitnessWithHashMeta,\n} from '@xyo-network/xl1-protocol-lib'\nimport {\n  HydratedBlockStateValidationError,\n  isTransactionBoundWitnessWithHashMeta,\n  isTransfer,\n  XYO_ZERO_ADDRESS,\n} from '@xyo-network/xl1-protocol-lib'\n\n/** Compute the maximum fee commitment for a transaction (base + priority + gasLimit). */\nfunction maxTransactionFeeCost(tx: TransactionBoundWitnessWithHashMeta): bigint {\n  const {\n    base, gasLimit, priority,\n  } = tx.fees\n  return hexToBigInt(base) + hexToBigInt(priority) + hexToBigInt(gasLimit)\n}\n\n/** Accumulate outflows per address from fees and transfers in the given transactions. */\nexport function accumulateOutflows(\n  transactions: TransactionBoundWitnessWithHashMeta[],\n  payloads: HydratedBlockWithHashMeta[1],\n): Record<Address, bigint> {\n  const outflows: Record<Address, bigint> = {}\n\n  for (const tx of transactions) {\n    // Fee cost charged to the transaction sender\n    const feeCost = maxTransactionFeeCost(tx)\n    const feePayer = tx.from\n    outflows[feePayer] = (outflows[feePayer] ?? 0n) + feeCost\n\n    // Find transfer payloads belonging to this transaction\n    const txPayloadHashes = new Set(tx.payload_hashes)\n    for (const payload of payloads) {\n      if (!txPayloadHashes.has(payload._hash) || !isTransfer(payload)) continue\n      const { from } = payload\n      for (const [to, amount] of Object.entries(payload.transfers) as [Address, Hex][]) {\n        if (to === from) continue // self-transfers are not outflows\n        outflows[from] = (outflows[from] ?? 0n) + hexToBigInt(amount)\n      }\n    }\n  }\n\n  return outflows\n}\n\n/** Creates a block state validator that checks cumulative outflows per address do not exceed pre-block balances. */\nexport function BlockCumulativeBalanceValidatorFactory(): HydratedBlockStateValidationFunction {\n  return async (context, hydratedBlock) => {\n    const [blockBw, payloads] = hydratedBlock\n\n    // Find all transactions in the block\n    const transactions = payloads.filter(isTransactionBoundWitnessWithHashMeta)\n\n    if (transactions.length === 0) return []\n\n    const outflows = accumulateOutflows(transactions, payloads)\n\n    // Query pre-block balances for all addresses with outflows\n    const addresses = Object.keys(outflows) as Address[]\n    if (addresses.length === 0) return []\n\n    const balances = await context.accountBalance.accountBalances(addresses)\n\n    // Check each address\n    const chainId = await context.chainIdAtBlockNumber(blockBw.block)\n    const errors: HydratedBlockStateValidationError[] = []\n    for (const address of addresses) {\n      if (address === XYO_ZERO_ADDRESS) continue // Skip zero address as it's used for burn transactions and doesn't have a balance\n      // TODO: Add specific validation for block reward transfer\n      const balance = balances[address] ?? 0n\n      const totalOutflow = outflows[address]\n      if (totalOutflow > balance) {\n        errors.push(new HydratedBlockStateValidationError(\n          blockBw._hash,\n          chainId,\n          hydratedBlock,\n          `Cumulative outflow for address ${address} exceeds available balance: outflow ${totalOutflow} > balance ${balance}`,\n        ))\n      }\n    }\n\n    return errors\n  }\n}\n","import type { Hash, Promisable } from '@xylabs/sdk-js'\nimport { ZERO_HASH } from '@xylabs/sdk-js'\nimport type {\n  BoundWitness,\n  Payload,\n  Schema,\n  WithHashMeta,\n} from '@xyo-network/sdk-js'\nimport { isAnyPayload } from '@xyo-network/sdk-js'\nimport type { HydratedBoundWitnessValidationFunction, HydratedBoundWitnessWithHashMeta } from '@xyo-network/xl1-protocol-lib'\nimport { HydratedBoundWitnessValidationError } from '@xyo-network/xl1-protocol-lib'\n\nfunction getPayloadsFromPayloadArray(payloads: WithHashMeta<Payload>[], hashes: Hash[]): (WithHashMeta<Payload> | undefined)[] {\n  return hashes.map(hash => payloads.find(payload => payload._hash === hash || payload._dataHash === hash))\n}\n\n/** Creates a validator that checks all payload references in a BoundWitness are present, have matching schemas, and optionally conform to an allowed schema list. */\nexport const BoundWitnessReferencesValidator\n\n  = <T extends BoundWitness = BoundWitness>(allowedSchemas?: Schema[]): HydratedBoundWitnessValidationFunction<T> => (\n    [bw, payloadSet]: HydratedBoundWitnessWithHashMeta<T>,\n  // eslint-disable-next-line complexity\n  ): Promisable<HydratedBoundWitnessValidationError[]> => {\n    const errors: HydratedBoundWitnessValidationError[] = []\n    try {\n      const payloads = getPayloadsFromPayloadArray(payloadSet, bw.payload_hashes)\n      if (payloads.length !== bw.payload_hashes.length) {\n        errors.push(new HydratedBoundWitnessValidationError(bw?._hash ?? ZERO_HASH, [bw, payloadSet], 'unable to locate payloads'))\n      }\n\n      // check if payloads are valid and if their schemas match the declared schemas\n      for (let payload of payloads) {\n        if (isAnyPayload(payload)) {\n          const payloadHashIndex = bw.payload_hashes.indexOf(payload._hash)\n          const payloadDataHashIndex = bw.payload_hashes.indexOf(payload._dataHash)\n          const payloadIndex = Math.max(payloadHashIndex, payloadDataHashIndex)\n          if (payloadIndex === -1) {\n            errors.push(new HydratedBoundWitnessValidationError(bw?._hash ?? ZERO_HASH, [bw, payloadSet], 'payload hash not found'))\n          }\n\n          const declaredSchema = bw.payload_schemas[payloadIndex]\n          if (declaredSchema !== payload.schema) {\n            errors.push(new HydratedBoundWitnessValidationError(bw?._hash ?? ZERO_HASH, [bw, payloadSet], 'mismatched schema'))\n          }\n\n          if (allowedSchemas && !allowedSchemas.includes(payload.schema)) {\n            errors.push(new HydratedBoundWitnessValidationError(bw?._hash ?? ZERO_HASH, [bw, payloadSet], `disallowed schema [${payload.schema}]`))\n          }\n        } else {\n          errors.push(new HydratedBoundWitnessValidationError(bw?._hash ?? ZERO_HASH, [bw, payloadSet], 'invalid payload'))\n        }\n      }\n    } catch (ex) {\n      const error = new HydratedBoundWitnessValidationError(bw?._hash ?? ZERO_HASH, [bw, payloadSet], `validation excepted: ${ex}`, ex)\n      errors.push(error)\n    }\n    return errors\n  }\n","import { type Address, ZERO_HASH } from '@xylabs/sdk-js'\nimport { toArrayBuffer } from '@xylabs/sdk-js'\nimport type { BoundWitness, WithStorageMeta } from '@xyo-network/sdk-js'\nimport { BoundWitnessBuilder, BoundWitnessValidator } from '@xyo-network/sdk-js'\nimport type { BoundWitnessValidationFunction } from '@xyo-network/xl1-protocol-lib'\nimport { BoundWitnessValidationError } from '@xyo-network/xl1-protocol-lib'\n\n/** Validates that all signatures on a BoundWitness are cryptographically valid for their corresponding addresses. */\nexport const BoundWitnessSignaturesValidator: BoundWitnessValidationFunction = async (\n  bw: BoundWitness,\n) => {\n  const errors: BoundWitnessValidationError[] = []\n  try {\n    const dataHash = await BoundWitnessBuilder.dataHash(bw)\n    const results: [Address, Error[]][] = await Promise.all(bw.addresses.map(async (address, index) => {\n      return [address, await BoundWitnessValidator.validateSignature(\n        toArrayBuffer(dataHash),\n        toArrayBuffer(address),\n        toArrayBuffer(bw.$signatures[index] ?? undefined),\n      )]\n    }))\n    for (const [, bwErrors] of results) {\n      for (const bwError of bwErrors) {\n        errors.push(new BoundWitnessValidationError((bw as WithStorageMeta<BoundWitness>)?._hash ?? ZERO_HASH, bw, 'validation errors', bwError))\n      }\n    }\n  } catch (ex) {\n    errors.push(new BoundWitnessValidationError((bw as WithStorageMeta<BoundWitness>)?._hash ?? ZERO_HASH, bw, 'validation excepted', ex))\n  }\n  return errors\n}\n","import type {\n  HydratedTransactionValidationFunction,\n  HydratedTransactionValidationFunctionContext,\n  HydratedTransactionWithHashMeta,\n} from '@xyo-network/xl1-protocol-lib'\nimport { isTransactionBoundWitness } from '@xyo-network/xl1-protocol-lib'\n\nimport {\n  TransactionDurationValidator,\n  TransactionElevationValidator, TransactionFromValidator, TransactionGasValidator, TransactionProtocolValidator,\n} from './validators/index.ts'\n\n/** Validates a hydrated transaction using built-in validators plus any additional validators provided. */\nexport async function validateTransaction(\n  context: HydratedTransactionValidationFunctionContext,\n  tx: HydratedTransactionWithHashMeta,\n  additionalValidators?: HydratedTransactionValidationFunction[],\n) {\n  try {\n    if (!isTransactionBoundWitness(tx[0])) {\n      return [new Error('failed isTransactionBoundWitness identity check')]\n    }\n\n    const validators: HydratedTransactionValidationFunction<HydratedTransactionValidationFunctionContext>[] = [\n      TransactionProtocolValidator,\n      TransactionDurationValidator,\n      TransactionFromValidator,\n      TransactionGasValidator,\n      TransactionElevationValidator,\n      ...(additionalValidators ?? []),\n    ]\n    return (await Promise.all(validators.map(v => v(context, tx)))).flat()\n  } catch (ex) {\n    return [(new Error(`Failed TransactionGasValidator: ${ex}`))]\n  }\n}\n","import { ZERO_HASH } from '@xylabs/sdk-js'\nimport type { HydratedTransactionValidationFunction } from '@xyo-network/xl1-protocol-lib'\nimport { HydratedTransactionValidationError } from '@xyo-network/xl1-protocol-lib'\n\n/** Validates that transaction timing fields (nbf and exp) are positive, correctly ordered, and within allowed duration limits. */\nexport const TransactionDurationValidator: HydratedTransactionValidationFunction = (\n  context,\n  tx,\n// eslint-disable-next-line complexity\n) => {\n  const errors: HydratedTransactionValidationError[] = []\n  try {\n    const { exp, nbf } = tx[0]\n    if (nbf < 0) errors.push(new HydratedTransactionValidationError(tx?.[0]?._hash ?? ZERO_HASH, tx, 'Transaction nbf must be positive'))\n\n    if (exp < 0) errors.push(new HydratedTransactionValidationError(tx?.[0]?._hash ?? ZERO_HASH, tx, 'Transaction exp must be positive'))\n    if (exp <= nbf) errors.push(new HydratedTransactionValidationError(tx?.[0]?._hash ?? ZERO_HASH, tx, 'Transaction exp must greater than nbf'))\n    if (exp - nbf > 10_000) errors.push(new HydratedTransactionValidationError(\n      tx?.[0]?._hash ?? ZERO_HASH,\n      tx,\n      'Transaction exp must not be too far in the future',\n    ))\n  } catch (ex) {\n    errors.push(new HydratedTransactionValidationError(\n      tx?.[0]?._hash ?? ZERO_HASH,\n      tx,\n      `Failed TransactionDurationValidator: ${ex}`,\n      ex,\n    ))\n  }\n\n  return errors\n}\n","import { ZERO_HASH } from '@xylabs/sdk-js'\nimport type { HydratedTransactionValidationFunction } from '@xyo-network/xl1-protocol-lib'\nimport { HydratedTransactionValidationError } from '@xyo-network/xl1-protocol-lib'\nimport { extractElevatedHashes } from '@xyo-network/xl1-protocol-sdk'\n\n/** Validates that a hydrated transaction includes all required elevated script hashes. */\nexport const TransactionElevationValidator: HydratedTransactionValidationFunction = (\n  context,\n  tx,\n) => {\n  const errors: HydratedTransactionValidationError[] = []\n  try {\n    try {\n      extractElevatedHashes(tx)\n    } catch {\n      errors.push(new HydratedTransactionValidationError(tx?.[0]?._hash ?? ZERO_HASH, tx, 'Hydrated transaction does not include all script hashes'))\n    }\n  } catch (ex) {\n    errors.push(new HydratedTransactionValidationError(\n      tx?.[0]?._hash ?? ZERO_HASH,\n      tx,\n      `Failed TransactionElevationValidator: ${ex}`,\n      ex,\n    ))\n  }\n  return errors\n}\n","import { asAddress, ZERO_HASH } from '@xylabs/sdk-js'\nimport { addressesContains } from '@xyo-network/sdk-js'\nimport type { HydratedTransactionValidationFunction } from '@xyo-network/xl1-protocol-lib'\nimport { HydratedTransactionValidationError } from '@xyo-network/xl1-protocol-lib'\n\n/** Validates that the transaction's from field is a valid address and is included in the BoundWitness addresses. */\nexport const TransactionFromValidator: HydratedTransactionValidationFunction = (\n  context,\n  tx,\n) => {\n  const errors: HydratedTransactionValidationError[] = []\n  try {\n    const from = asAddress(tx[0].from)\n    if (from === undefined)errors.push(new HydratedTransactionValidationError(\n      tx?.[0]?._hash ?? ZERO_HASH,\n      tx,\n      'Transaction from is not a valid address',\n    ))\n    else if (!addressesContains(tx[0], from)) errors.push(new HydratedTransactionValidationError(\n      tx?.[0]?._hash ?? ZERO_HASH,\n      tx,\n      'Transaction from address must be listed in addresses',\n    ))\n  } catch (ex) {\n    errors.push(new HydratedTransactionValidationError(\n      tx?.[0]?._hash ?? ZERO_HASH,\n      tx,\n      `Failed TransactionFromValidator: ${ex}`,\n      ex,\n    ))\n  }\n  return errors\n}\n","import { hexToBigInt, ZERO_HASH } from '@xylabs/sdk-js'\nimport type {\n  HydratedTransactionValidationFunction,\n  TransactionFeesBigInt, TransactionFeesHex,\n} from '@xyo-network/xl1-protocol-lib'\nimport {\n  AttoXL1,\n  HydratedTransactionValidationError,\n  minTransactionFees,\n} from '@xyo-network/xl1-protocol-lib'\n\n/** Validates that transaction fee fields (base, gasLimit, gasPrice, priority) are present and meet minimum requirements. */\nexport const TransactionGasValidator: HydratedTransactionValidationFunction = (\n  context,\n  tx,\n// eslint-disable-next-line complexity\n) => {\n  const errors: HydratedTransactionValidationError[] = []\n  try {\n    if (tx?.[0].fees === undefined) {\n      errors.push(new HydratedTransactionValidationError(\n        tx?.[0]?._hash ?? ZERO_HASH,\n        tx,\n        'Missing fees',\n      ))\n    } else {\n      const {\n        base, gasLimit, gasPrice, priority,\n      } = parseFees(tx[0].fees)\n\n      if (base === undefined) errors.push(new HydratedTransactionValidationError(\n        tx?.[0]?._hash ?? ZERO_HASH,\n        tx,\n        'fees.base must be defined and a valid number',\n      ))\n      else if (base < minTransactionFees.base) errors.push(new HydratedTransactionValidationError(\n        tx?.[0]?._hash ?? ZERO_HASH,\n        tx,\n        `fees.base must be >= ${minTransactionFees.base}`,\n      ))\n\n      if (gasLimit === undefined) errors.push(new HydratedTransactionValidationError(\n        tx?.[0]?._hash ?? ZERO_HASH,\n        tx,\n        'fees.gasLimit must be defined and a valid number',\n      ))\n      else if (gasLimit < minTransactionFees.gasLimit) errors.push(new HydratedTransactionValidationError(\n        tx?.[0]?._hash ?? ZERO_HASH,\n        tx,\n        `fees.gasLimit must be >= ${minTransactionFees.gasLimit}`,\n      ))\n\n      if (gasPrice === undefined) errors.push(\n        new HydratedTransactionValidationError(\n          tx?.[0]?._hash ?? ZERO_HASH,\n          tx,\n          'fees.gasPrice must be defined and a valid number',\n        ),\n      )\n      else if (gasPrice < minTransactionFees.gasPrice) errors.push(new HydratedTransactionValidationError(\n        tx?.[0]?._hash ?? ZERO_HASH,\n        tx,\n        `fees.gasPrice must be >= ${minTransactionFees.gasPrice}`,\n      ))\n\n      if (priority === undefined) errors.push(new HydratedTransactionValidationError(\n        tx?.[0]?._hash ?? ZERO_HASH,\n        tx,\n        'fees.priority must be defined and a valid number',\n      ))\n      else if (priority < minTransactionFees.priority) errors.push(new HydratedTransactionValidationError(\n        tx?.[0]?._hash ?? ZERO_HASH,\n        tx,\n        `fees.priority must be >= ${minTransactionFees.priority}`,\n      ))\n    }\n  } catch (ex) {\n    errors.push(new HydratedTransactionValidationError(\n      tx?.[0]?._hash ?? ZERO_HASH,\n      tx,\n      `Failed TransactionGasValidator: ${ex}`,\n      ex,\n    ))\n  }\n  return errors\n}\n\nconst parseFees = (fees: TransactionFeesHex): Partial<TransactionFeesBigInt> => {\n  const ret: Partial<TransactionFeesBigInt> = {}\n  const {\n    base, gasLimit, gasPrice, priority,\n  } = fees\n  if (base !== undefined) ret.base = AttoXL1(hexToBigInt(base))\n  if (gasLimit !== undefined) ret.gasLimit = AttoXL1(hexToBigInt(gasLimit))\n  if (gasPrice !== undefined) ret.gasPrice = AttoXL1(hexToBigInt(gasPrice))\n  if (priority !== undefined) ret.priority = AttoXL1(hexToBigInt(priority))\n  return ret\n}\n","import { ZERO_HASH } from '@xylabs/sdk-js'\nimport { PayloadBuilder } from '@xyo-network/sdk-js'\nimport type { HydratedTransactionValidationFunction, TransactionBoundWitness } from '@xyo-network/xl1-protocol-lib'\nimport { HydratedTransactionValidationError } from '@xyo-network/xl1-protocol-lib'\nimport { TransactionBoundWitnessJsonSchema } from '@xyo-network/xl1-schema'\nimport type { ValidateFunction } from 'ajv'\nimport { Ajv } from 'ajv'\n\nconst ajv = new Ajv({ allErrors: true, strict: true })\n\nlet validate: ValidateFunction<TransactionBoundWitness> | undefined\n\n/** Validates a transaction against the TransactionBoundWitness JSON schema using AJV. */\nexport const TransactionJsonSchemaValidator: HydratedTransactionValidationFunction = (\n  context,\n  tx,\n) => {\n  const errors: HydratedTransactionValidationError[] = []\n  try {\n    if (validate === undefined) validate = ajv.compile(TransactionBoundWitnessJsonSchema)\n    if (!validate(PayloadBuilder.omitStorageMeta(tx[0]))) {\n      const error = new HydratedTransactionValidationError(\n        tx?.[0]?._hash ?? ZERO_HASH,\n        tx,\n        `failed JSON schema validation: ${ajv.errorsText(validate.errors, { separator: '\\n' })}`,\n        validate.errors,\n      )\n      errors.push(error)\n    }\n  } catch (ex) {\n    errors.push(new HydratedTransactionValidationError(tx?.[0]?._hash ?? ZERO_HASH, tx, 'validation excepted', ex))\n  }\n  return errors\n}\n","import { ZERO_HASH } from '@xylabs/sdk-js'\nimport type {\n  ChainId,\n  HydratedTransactionValidationFunction,\n} from '@xyo-network/xl1-protocol-lib'\nimport { HydratedTransactionValidationError } from '@xyo-network/xl1-protocol-lib'\n\n/** Validates that the transaction's chain ID matches the expected chain ID from the validation context. */\nexport const TransactionProtocolValidator: HydratedTransactionValidationFunction = async (\n  context: { chainId?: ChainId },\n  tx,\n) => {\n  const errors: HydratedTransactionValidationError[] = []\n  try {\n    if (context?.chainId !== undefined && tx[0].chain !== context.chainId) {\n      errors.push(new HydratedTransactionValidationError(tx?.[0]?._hash ?? ZERO_HASH, tx, `invalid chain id [${context.chainId}, ${tx[0].chain}]`))\n    }\n  } catch (ex) {\n    errors.push(new HydratedTransactionValidationError(tx?.[0]?._hash ?? ZERO_HASH, tx, 'validation excepted', ex))\n  }\n  return await Promise.resolve(errors)\n}\n","import type { Address } from '@xylabs/sdk-js'\nimport { isDefined, isUndefined } from '@xylabs/sdk-js'\nimport type {\n  HydratedTransactionValidationFunction, StepIdentity,\n  Transfer,\n} from '@xyo-network/xl1-protocol-lib'\nimport { HydratedTransactionValidationError, isTransfer } from '@xyo-network/xl1-protocol-lib'\nimport {\n  completedStepRewardAddress, derivedReceiveAddress, elevatedPayloads,\n} from '@xyo-network/xl1-protocol-sdk'\n\n/** Function type that checks whether a signer is authorized to sign for a given signee address. */\nexport type SignerValidator = (signer: Address, signee: Address, context?: { address?: Address; scope?: string; step?: StepIdentity }) => boolean\n\n/** Maps addresses to their list of authorized signer addresses. */\nexport type SignerMapping = Map<Address, Address[]>\n\n/** A signer validator that only allows an address to sign for itself. */\nexport const SelfSignerValidator: SignerValidator = (signer: Address, signee: Address) => signer === signee\n\n/** Creates a signer validator that authorizes specified signers to sign for completed step reward addresses. */\nexport const CompletedStepRewardAddressValidatorFactory = (allowedSigners: Address[]): SignerValidator => (\n  signer: Address,\n  signee: Address,\n  context?: { step?: StepIdentity },\n) => {\n  const step = context?.step\n  if (isDefined(step)) {\n    const contextAddress = completedStepRewardAddress(step)\n    return allowedSigners.includes(signer) && signee === contextAddress\n  } else {\n    return false\n  }\n}\n\n/** Creates a signer validator that authorizes specified signers to sign for derived receive addresses within a given scope. */\nexport const DerivedReceiveAddressValidatorFactory = (allowedSigners: Address[], allowedScope: string): SignerValidator => (\n  signer: Address,\n  signee: Address,\n  context?: { address?: Address; scope?: string },\n) => {\n  const { address, scope } = context ?? {}\n  if (scope !== allowedScope) {\n    return false\n  }\n  if (isDefined(address)) {\n    const derivedAddress = derivedReceiveAddress(address, scope)\n    return allowedSigners.includes(signer) && signee === derivedAddress\n  } else {\n    return false\n  }\n}\n\n/** Creates a transaction validator that checks all transfers are authorized by the transaction signer. */\nexport function TransactionTransfersValidatorFactory(\n  signerValidators: SignerValidator[] = [SelfSignerValidator],\n): HydratedTransactionValidationFunction {\n  return async (\n    context,\n    hydratedTx,\n  ) => {\n    const errors: HydratedTransactionValidationError[] = []\n    const signer = hydratedTx[0].from\n    try {\n      const payloads = elevatedPayloads(hydratedTx)\n      const transfers = payloads.filter(isTransfer) as Transfer[]\n      for (const transfer of transfers) {\n        if (isUndefined(signerValidators.find(v => v(signer, transfer.from, transfer.context)))) {\n          errors.push(new HydratedTransactionValidationError(\n            hydratedTx[0]._hash,\n            hydratedTx,\n            `transfer from address ${transfer.from} is not authorized by signer ${signer}`,\n          ))\n        }\n      }\n    } catch (ex) {\n      errors.push(new HydratedTransactionValidationError(hydratedTx[0]._hash, hydratedTx, 'validation excepted', ex))\n    }\n    return await Promise.resolve(errors)\n  }\n}\n"],"mappings":"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","names":["ZERO_HASH","ZERO_HASH","ZERO_HASH","HydratedTransactionValidationError","ZERO_HASH","HydratedTransactionValidationError","hexToBigInt","ZERO_HASH","HydratedTransactionValidationError","ZERO_HASH","HydratedTransactionValidationError","ZERO_HASH","HydratedTransactionValidationError","HydratedTransactionValidationError","isTransfer"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xyo-network/xl1-validation",
-  "version": "1.26.9",
+  "version": "1.26.11",
   "description": "XYO Layer One SDK Validation",
   "homepage": "https://xylabs.com",
   "bugs": {
@@ -38,9 +38,9 @@
     "!**/*.test.*"
   ],
   "dependencies": {
-    "@xyo-network/xl1-protocol-lib": "~1.26.9",
-    "@xyo-network/xl1-protocol-sdk": "~1.26.9",
-    "@xyo-network/xl1-schema": "~1.26.9"
+    "@xyo-network/xl1-protocol-lib": "~1.26.11",
+    "@xyo-network/xl1-protocol-sdk": "~1.26.11",
+    "@xyo-network/xl1-schema": "~1.26.11"
   },
   "devDependencies": {
     "@opentelemetry/api": "^1.9.1",

package/src/block/validators/BlockCumulativeBalanceValidator.ts

@@ -3,20 +3,50 @@ import {
 } from '@xylabs/sdk-js'
 import type {
   HydratedBlockStateValidationFunction,
+  HydratedBlockWithHashMeta,
   TransactionBoundWitnessWithHashMeta,
 } from '@xyo-network/xl1-protocol-lib'
 import {
   HydratedBlockStateValidationError,
   isTransactionBoundWitnessWithHashMeta,
   isTransfer,
+  XYO_ZERO_ADDRESS,
 } from '@xyo-network/xl1-protocol-lib'
 
-/** Compute the maximum fee commitment for a transaction (base + priority + gasLimit * gasPrice). */
-function transactionFeeCost(tx: TransactionBoundWitnessWithHashMeta): bigint {
+/** Compute the maximum fee commitment for a transaction (base + priority + gasLimit). */
+function maxTransactionFeeCost(tx: TransactionBoundWitnessWithHashMeta): bigint {
   const {
-    base, gasLimit, gasPrice, priority,
+    base, gasLimit, priority,
   } = tx.fees
-  return hexToBigInt(base) + hexToBigInt(priority) + (hexToBigInt(gasLimit) * hexToBigInt(gasPrice))
+  return hexToBigInt(base) + hexToBigInt(priority) + hexToBigInt(gasLimit)
+}
+
+/** Accumulate outflows per address from fees and transfers in the given transactions. */
+export function accumulateOutflows(
+  transactions: TransactionBoundWitnessWithHashMeta[],
+  payloads: HydratedBlockWithHashMeta[1],
+): Record<Address, bigint> {
+  const outflows: Record<Address, bigint> = {}
+
+  for (const tx of transactions) {
+    // Fee cost charged to the transaction sender
+    const feeCost = maxTransactionFeeCost(tx)
+    const feePayer = tx.from
+    outflows[feePayer] = (outflows[feePayer] ?? 0n) + feeCost
+
+    // Find transfer payloads belonging to this transaction
+    const txPayloadHashes = new Set(tx.payload_hashes)
+    for (const payload of payloads) {
+      if (!txPayloadHashes.has(payload._hash) || !isTransfer(payload)) continue
+      const { from } = payload
+      for (const [to, amount] of Object.entries(payload.transfers) as [Address, Hex][]) {
+        if (to === from) continue // self-transfers are not outflows
+        outflows[from] = (outflows[from] ?? 0n) + hexToBigInt(amount)
+      }
+    }
+  }
+
+  return outflows
 }
 
 /** Creates a block state validator that checks cumulative outflows per address do not exceed pre-block balances. */
@@ -29,25 +59,7 @@ export function BlockCumulativeBalanceValidatorFactory(): HydratedBlockStateVali
 
     if (transactions.length === 0) return []
 
-    // Accumulate outflows per address
-    const outflows: Record<Address, bigint> = {}
-
-    for (const tx of transactions) {
-      // Fee cost charged to the transaction sender
-      const feeCost = transactionFeeCost(tx)
-      const feePayer = tx.from
-      outflows[feePayer] = (outflows[feePayer] ?? 0n) + feeCost
-
-      // Find transfer payloads belonging to this transaction
-      const txPayloadHashes = new Set(tx.payload_hashes)
-      for (const payload of payloads) {
-        if (!txPayloadHashes.has(payload._hash) || !isTransfer(payload)) continue
-        const { from } = payload
-        for (const amount of Object.values(payload.transfers) as Hex[]) {
-          outflows[from] = (outflows[from] ?? 0n) + hexToBigInt(amount)
-        }
-      }
-    }
+    const outflows = accumulateOutflows(transactions, payloads)
 
     // Query pre-block balances for all addresses with outflows
     const addresses = Object.keys(outflows) as Address[]
@@ -59,6 +71,8 @@ export function BlockCumulativeBalanceValidatorFactory(): HydratedBlockStateVali
     const chainId = await context.chainIdAtBlockNumber(blockBw.block)
     const errors: HydratedBlockStateValidationError[] = []
     for (const address of addresses) {
+      if (address === XYO_ZERO_ADDRESS) continue // Skip zero address as it's used for burn transactions and doesn't have a balance
+      // TODO: Add specific validation for block reward transfer
       const balance = balances[address] ?? 0n
       const totalOutflow = outflows[address]
       if (totalOutflow > balance) {

package/src/boundwitness/validators/BoundWitnessReferences.ts

@@ -51,8 +51,7 @@ export const BoundWitnessReferencesValidator
         }
       }
     } catch (ex) {
-      const error = new HydratedBoundWitnessValidationError(bw?._hash ?? ZERO_HASH, [bw, payloadSet], `validation excepted: ${ex}`)
-      error.cause = ex
+      const error = new HydratedBoundWitnessValidationError(bw?._hash ?? ZERO_HASH, [bw, payloadSet], `validation excepted: ${ex}`, ex)
       errors.push(error)
     }
     return errors

package/src/transaction/validators/TransactionJsonSchemaValidator.ts

@@ -23,8 +23,8 @@ export const TransactionJsonSchemaValidator: HydratedTransactionValidationFuncti
         tx?.[0]?._hash ?? ZERO_HASH,
         tx,
         `failed JSON schema validation: ${ajv.errorsText(validate.errors, { separator: '\n' })}`,
+        validate.errors,
       )
-      error.cause = validate.errors
       errors.push(error)
     }
   } catch (ex) {