@xylabs/aries 0.1.1

package/dist/commands/xyoCommand.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/actions/xyo/transaction/validateTransactions.ts","../../src/commands/xyoTxValidateCommand.ts","../../src/commands/xyoTxCommand.ts","../../src/commands/xyoCommand.ts"],"sourcesContent":["import FS, { existsSync } from 'node:fs'\nimport path from 'node:path'\n\nimport type { Payload } from '@xyo-network/sdk-js'\nimport { PayloadBuilder } from '@xyo-network/sdk-js'\nimport type { HydratedTransactionWithHashMeta } from '@xyo-network/xl1-sdk'\nimport {\n  isHydratedTransaction,\n  isTransactionBoundWitness,\n  validateTransaction,\n} from '@xyo-network/xl1-sdk'\nimport chalk from 'chalk'\n\nexport interface ValidateTransactionsOptions {\n  data?: string\n  detail?: boolean\n}\n\ninterface ValidationResult {\n  errors: string[]\n  index: number\n  source: string\n  valid: boolean\n}\n\ntype RawTuple = [unknown, unknown[]]\n\nfunction isRawTuple(value: unknown): value is RawTuple {\n  return Array.isArray(value) && value.length === 2 && Array.isArray(value[1])\n}\n\nfunction parseSingleOrBatch(raw: string, source: string): [RawTuple, string][] {\n  const parsed: unknown = JSON.parse(raw)\n  if (isRawTuple(parsed)) {\n    return [[parsed, source]]\n  }\n  if (Array.isArray(parsed) && parsed.length > 0 && parsed.every(isRawTuple)) {\n    return parsed.map((tx, i) => [tx, `${source}[${i}]`])\n  }\n  throw new Error(`${source}: expected a transaction tuple [bw, payloads[]] or array of tuples`)\n}\n\nfunction parseJsonl(raw: string, source: string): [RawTuple, string][] {\n  const results: [RawTuple, string][] = []\n  for (const [i, rawLine] of raw.split('\\n').entries()) {\n    const line = rawLine?.trim()\n    if (!line) continue\n    let parsed: unknown\n    try {\n      parsed = JSON.parse(line)\n    } catch (error) {\n      const msg = error instanceof Error ? error.message : String(error)\n      throw new Error(`${source} line ${i + 1}: invalid JSON (${msg})`, { cause: error })\n    }\n    if (!isRawTuple(parsed)) {\n      throw new Error(`${source} line ${i + 1}: expected a transaction tuple [bw, payloads[]]`)\n    }\n    results.push([parsed, `${source}:${i + 1}`])\n  }\n  return results\n}\n\nfunction parseInput(data: string): [RawTuple, string][] {\n  const absolute = path.resolve(data)\n  if (existsSync(absolute)) {\n    const raw = FS.readFileSync(absolute, 'utf8')\n    const ext = path.extname(absolute).toLowerCase()\n    if (ext === '.jsonl' || ext === '.ndjson') {\n      return parseJsonl(raw, data)\n    }\n    return parseSingleOrBatch(raw, data)\n  }\n  return parseSingleOrBatch(data, '<inline>')\n}\n\nasync function readStdin(): Promise<string> {\n  return new Promise((resolve, reject) => {\n    let buf = ''\n    process.stdin.setEncoding('utf8')\n    process.stdin.on('data', (chunk: string) => {\n      buf += chunk\n    })\n    process.stdin.on('end', () => resolve(buf))\n    process.stdin.on('error', reject)\n  })\n}\n\nasync function validateOne(raw: RawTuple, source: string, index: number): Promise<ValidationResult> {\n  const [bwRaw, payloadsRaw] = raw\n  const errors: string[] = []\n\n  if (!isTransactionBoundWitness(bwRaw)) {\n    return {\n      errors: ['not a valid transaction BoundWitness'],\n      index,\n      source,\n      valid: false,\n    }\n  }\n\n  try {\n    const bwWithMeta = await PayloadBuilder.addHashMeta(bwRaw as Payload)\n    const payloadsWithMeta = await Promise.all(\n      (payloadsRaw as Payload[]).map(p => PayloadBuilder.addHashMeta(p)),\n    )\n    const tx = [bwWithMeta, payloadsWithMeta] as unknown as HydratedTransactionWithHashMeta\n\n    if (isHydratedTransaction(tx)) {\n      const chainId = bwRaw.chain as string\n      const txErrors = await validateTransaction({ chainId } as never, tx)\n      for (const err of txErrors) {\n        errors.push(String(err))\n      }\n    } else {\n      errors.push('transaction failed structural shape check (isHydratedTransaction)')\n    }\n  } catch (ex) {\n    errors.push(`Validation threw: ${ex instanceof Error ? ex.message : String(ex)}`)\n  }\n\n  return {\n    errors,\n    index,\n    source,\n    valid: errors.length === 0,\n  }\n}\n\nexport async function validateTransactions(options: ValidateTransactionsOptions): Promise<void> {\n  let rawTransactions: [RawTuple, string][]\n\n  if (options.data !== undefined) {\n    rawTransactions = parseInput(options.data)\n  } else if (process.stdin.isTTY) {\n    console.error(chalk.red('No input: provide a file path, inline JSON, or pipe data to stdin.'))\n    process.exitCode = 1\n    return\n  } else {\n    const stdin = await readStdin()\n    rawTransactions = parseSingleOrBatch(stdin.trim(), '<stdin>')\n  }\n\n  const results = await Promise.all(rawTransactions.map(([tx, source], i) => validateOne(tx, source, i)))\n\n  const validCount = results.filter(r => r.valid).length\n  const invalidCount = results.filter(r => !r.valid).length\n\n  console.log(`Total:   ${results.length}`)\n  console.log(chalk.green(`Valid:   ${validCount}`))\n  if (invalidCount > 0) {\n    console.log(chalk.red(`Invalid: ${invalidCount}`))\n  }\n\n  if (options.detail === true || invalidCount > 0) {\n    for (const result of results.filter(r => !r.valid)) {\n      console.log(chalk.red(`\\n[${result.index}] ${result.source}`))\n      for (const err of result.errors) {\n        console.log(chalk.red(`  - ${err}`))\n      }\n    }\n  }\n\n  if (invalidCount > 0) {\n    process.exitCode = 1\n  }\n}\n","import type { CommandModule } from 'yargs'\n\nimport { validateTransactions } from '../actions/xyo/index.ts'\n\nexport const xyoTxValidateCommand: CommandModule = {\n  command: 'validate [data]',\n  describe: 'Validate one or more XL1 transactions (file, inline JSON, or stdin)',\n  builder: yargs =>\n    yargs\n      .positional('data', {\n        type: 'string',\n        describe: 'Path to a .json/.jsonl file, or an inline transaction JSON tuple [bw, payloads[]]',\n      })\n      .option('detail', {\n        alias: 'd',\n        type: 'boolean',\n        default: false,\n        describe: 'Print per-transaction error details (always shown for invalid transactions)',\n      })\n      .example(\n        '$0 xyo tx validate ./tx.json',\n        'Validate a single signed transaction from a file',\n      )\n      .example(\n        '$0 xyo tx validate ./txs.jsonl',\n        'Validate a batch of transactions, one per line',\n      )\n      .example(\n        'cat txs.jsonl | $0 xyo tx validate',\n        'Validate transactions piped from stdin',\n      ),\n  handler: async (argv) => {\n    await validateTransactions({\n      data: argv.data as string | undefined,\n      detail: argv.detail as boolean,\n    })\n  },\n}\n","import type { CommandModule } from 'yargs'\n\nimport { xyoTxValidateCommand } from './xyoTxValidateCommand.ts'\n\nexport const xyoTxCommand: CommandModule = {\n  command: 'tx',\n  describe: 'XL1 transaction utilities',\n  builder: yargs =>\n    yargs\n      .command(xyoTxValidateCommand)\n      .demandCommand(1)\n      .strictCommands(),\n  // eslint-disable-next-line @typescript-eslint/no-empty-function\n  handler: () => {},\n}\n","import type { CommandModule } from 'yargs'\n\nimport { xyoTxCommand } from './xyoTxCommand.ts'\n\nexport const xyoCommand: CommandModule = {\n  command: 'xyo',\n  describe: 'XYO protocol utilities',\n  builder: yargs =>\n    yargs\n      .command(xyoTxCommand)\n      .demandCommand(1)\n      .strictCommands(),\n  // eslint-disable-next-line @typescript-eslint/no-empty-function\n  handler: () => {},\n}\n"],"mappings":"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","names":[]}

package/dist/commands/xyoTxCommand.mjs

@@ -0,0 +1,178 @@
+// src/actions/xyo/transaction/validateTransactions.ts
+import FS, { existsSync } from "fs";
+import path from "path";
+import { PayloadBuilder } from "@xyo-network/sdk-js";
+import {
+  isHydratedTransaction,
+  isTransactionBoundWitness,
+  validateTransaction
+} from "@xyo-network/xl1-sdk";
+import chalk from "chalk";
+function isRawTuple(value) {
+  return Array.isArray(value) && value.length === 2 && Array.isArray(value[1]);
+}
+function parseSingleOrBatch(raw, source) {
+  const parsed = JSON.parse(raw);
+  if (isRawTuple(parsed)) {
+    return [[parsed, source]];
+  }
+  if (Array.isArray(parsed) && parsed.length > 0 && parsed.every(isRawTuple)) {
+    return parsed.map((tx, i) => [tx, `${source}[${i}]`]);
+  }
+  throw new Error(`${source}: expected a transaction tuple [bw, payloads[]] or array of tuples`);
+}
+function parseJsonl(raw, source) {
+  const results = [];
+  for (const [i, rawLine] of raw.split("\n").entries()) {
+    const line = rawLine?.trim();
+    if (!line) continue;
+    let parsed;
+    try {
+      parsed = JSON.parse(line);
+    } catch (error) {
+      const msg = error instanceof Error ? error.message : String(error);
+      throw new Error(`${source} line ${i + 1}: invalid JSON (${msg})`, { cause: error });
+    }
+    if (!isRawTuple(parsed)) {
+      throw new Error(`${source} line ${i + 1}: expected a transaction tuple [bw, payloads[]]`);
+    }
+    results.push([parsed, `${source}:${i + 1}`]);
+  }
+  return results;
+}
+function parseInput(data) {
+  const absolute = path.resolve(data);
+  if (existsSync(absolute)) {
+    const raw = FS.readFileSync(absolute, "utf8");
+    const ext = path.extname(absolute).toLowerCase();
+    if (ext === ".jsonl" || ext === ".ndjson") {
+      return parseJsonl(raw, data);
+    }
+    return parseSingleOrBatch(raw, data);
+  }
+  return parseSingleOrBatch(data, "<inline>");
+}
+async function readStdin() {
+  return new Promise((resolve, reject) => {
+    let buf = "";
+    process.stdin.setEncoding("utf8");
+    process.stdin.on("data", (chunk) => {
+      buf += chunk;
+    });
+    process.stdin.on("end", () => resolve(buf));
+    process.stdin.on("error", reject);
+  });
+}
+async function validateOne(raw, source, index) {
+  const [bwRaw, payloadsRaw] = raw;
+  const errors = [];
+  if (!isTransactionBoundWitness(bwRaw)) {
+    return {
+      errors: ["not a valid transaction BoundWitness"],
+      index,
+      source,
+      valid: false
+    };
+  }
+  try {
+    const bwWithMeta = await PayloadBuilder.addHashMeta(bwRaw);
+    const payloadsWithMeta = await Promise.all(
+      payloadsRaw.map((p) => PayloadBuilder.addHashMeta(p))
+    );
+    const tx = [bwWithMeta, payloadsWithMeta];
+    if (isHydratedTransaction(tx)) {
+      const chainId = bwRaw.chain;
+      const txErrors = await validateTransaction({ chainId }, tx);
+      for (const err of txErrors) {
+        errors.push(String(err));
+      }
+    } else {
+      errors.push("transaction failed structural shape check (isHydratedTransaction)");
+    }
+  } catch (ex) {
+    errors.push(`Validation threw: ${ex instanceof Error ? ex.message : String(ex)}`);
+  }
+  return {
+    errors,
+    index,
+    source,
+    valid: errors.length === 0
+  };
+}
+async function validateTransactions(options) {
+  let rawTransactions;
+  if (options.data !== void 0) {
+    rawTransactions = parseInput(options.data);
+  } else if (process.stdin.isTTY) {
+    console.error(chalk.red("No input: provide a file path, inline JSON, or pipe data to stdin."));
+    process.exitCode = 1;
+    return;
+  } else {
+    const stdin = await readStdin();
+    rawTransactions = parseSingleOrBatch(stdin.trim(), "<stdin>");
+  }
+  const results = await Promise.all(rawTransactions.map(([tx, source], i) => validateOne(tx, source, i)));
+  const validCount = results.filter((r) => r.valid).length;
+  const invalidCount = results.filter((r) => !r.valid).length;
+  console.log(`Total:   ${results.length}`);
+  console.log(chalk.green(`Valid:   ${validCount}`));
+  if (invalidCount > 0) {
+    console.log(chalk.red(`Invalid: ${invalidCount}`));
+  }
+  if (options.detail === true || invalidCount > 0) {
+    for (const result of results.filter((r) => !r.valid)) {
+      console.log(chalk.red(`
+[${result.index}] ${result.source}`));
+      for (const err of result.errors) {
+        console.log(chalk.red(`  - ${err}`));
+      }
+    }
+  }
+  if (invalidCount > 0) {
+    process.exitCode = 1;
+  }
+}
+
+// src/commands/xyoTxValidateCommand.ts
+var xyoTxValidateCommand = {
+  command: "validate [data]",
+  describe: "Validate one or more XL1 transactions (file, inline JSON, or stdin)",
+  builder: (yargs) => yargs.positional("data", {
+    type: "string",
+    describe: "Path to a .json/.jsonl file, or an inline transaction JSON tuple [bw, payloads[]]"
+  }).option("detail", {
+    alias: "d",
+    type: "boolean",
+    default: false,
+    describe: "Print per-transaction error details (always shown for invalid transactions)"
+  }).example(
+    "$0 xyo tx validate ./tx.json",
+    "Validate a single signed transaction from a file"
+  ).example(
+    "$0 xyo tx validate ./txs.jsonl",
+    "Validate a batch of transactions, one per line"
+  ).example(
+    "cat txs.jsonl | $0 xyo tx validate",
+    "Validate transactions piped from stdin"
+  ),
+  handler: async (argv) => {
+    await validateTransactions({
+      data: argv.data,
+      detail: argv.detail
+    });
+  }
+};
+
+// src/commands/xyoTxCommand.ts
+var xyoTxCommand = {
+  command: "tx",
+  describe: "XL1 transaction utilities",
+  builder: (yargs) => yargs.command(xyoTxValidateCommand).demandCommand(1).strictCommands(),
+  // eslint-disable-next-line @typescript-eslint/no-empty-function
+  handler: () => {
+  }
+};
+export {
+  xyoTxCommand
+};
+//# sourceMappingURL=xyoTxCommand.mjs.map

package/dist/commands/xyoTxCommand.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/actions/xyo/transaction/validateTransactions.ts","../../src/commands/xyoTxValidateCommand.ts","../../src/commands/xyoTxCommand.ts"],"sourcesContent":["import FS, { existsSync } from 'node:fs'\nimport path from 'node:path'\n\nimport type { Payload } from '@xyo-network/sdk-js'\nimport { PayloadBuilder } from '@xyo-network/sdk-js'\nimport type { HydratedTransactionWithHashMeta } from '@xyo-network/xl1-sdk'\nimport {\n  isHydratedTransaction,\n  isTransactionBoundWitness,\n  validateTransaction,\n} from '@xyo-network/xl1-sdk'\nimport chalk from 'chalk'\n\nexport interface ValidateTransactionsOptions {\n  data?: string\n  detail?: boolean\n}\n\ninterface ValidationResult {\n  errors: string[]\n  index: number\n  source: string\n  valid: boolean\n}\n\ntype RawTuple = [unknown, unknown[]]\n\nfunction isRawTuple(value: unknown): value is RawTuple {\n  return Array.isArray(value) && value.length === 2 && Array.isArray(value[1])\n}\n\nfunction parseSingleOrBatch(raw: string, source: string): [RawTuple, string][] {\n  const parsed: unknown = JSON.parse(raw)\n  if (isRawTuple(parsed)) {\n    return [[parsed, source]]\n  }\n  if (Array.isArray(parsed) && parsed.length > 0 && parsed.every(isRawTuple)) {\n    return parsed.map((tx, i) => [tx, `${source}[${i}]`])\n  }\n  throw new Error(`${source}: expected a transaction tuple [bw, payloads[]] or array of tuples`)\n}\n\nfunction parseJsonl(raw: string, source: string): [RawTuple, string][] {\n  const results: [RawTuple, string][] = []\n  for (const [i, rawLine] of raw.split('\\n').entries()) {\n    const line = rawLine?.trim()\n    if (!line) continue\n    let parsed: unknown\n    try {\n      parsed = JSON.parse(line)\n    } catch (error) {\n      const msg = error instanceof Error ? error.message : String(error)\n      throw new Error(`${source} line ${i + 1}: invalid JSON (${msg})`, { cause: error })\n    }\n    if (!isRawTuple(parsed)) {\n      throw new Error(`${source} line ${i + 1}: expected a transaction tuple [bw, payloads[]]`)\n    }\n    results.push([parsed, `${source}:${i + 1}`])\n  }\n  return results\n}\n\nfunction parseInput(data: string): [RawTuple, string][] {\n  const absolute = path.resolve(data)\n  if (existsSync(absolute)) {\n    const raw = FS.readFileSync(absolute, 'utf8')\n    const ext = path.extname(absolute).toLowerCase()\n    if (ext === '.jsonl' || ext === '.ndjson') {\n      return parseJsonl(raw, data)\n    }\n    return parseSingleOrBatch(raw, data)\n  }\n  return parseSingleOrBatch(data, '<inline>')\n}\n\nasync function readStdin(): Promise<string> {\n  return new Promise((resolve, reject) => {\n    let buf = ''\n    process.stdin.setEncoding('utf8')\n    process.stdin.on('data', (chunk: string) => {\n      buf += chunk\n    })\n    process.stdin.on('end', () => resolve(buf))\n    process.stdin.on('error', reject)\n  })\n}\n\nasync function validateOne(raw: RawTuple, source: string, index: number): Promise<ValidationResult> {\n  const [bwRaw, payloadsRaw] = raw\n  const errors: string[] = []\n\n  if (!isTransactionBoundWitness(bwRaw)) {\n    return {\n      errors: ['not a valid transaction BoundWitness'],\n      index,\n      source,\n      valid: false,\n    }\n  }\n\n  try {\n    const bwWithMeta = await PayloadBuilder.addHashMeta(bwRaw as Payload)\n    const payloadsWithMeta = await Promise.all(\n      (payloadsRaw as Payload[]).map(p => PayloadBuilder.addHashMeta(p)),\n    )\n    const tx = [bwWithMeta, payloadsWithMeta] as unknown as HydratedTransactionWithHashMeta\n\n    if (isHydratedTransaction(tx)) {\n      const chainId = bwRaw.chain as string\n      const txErrors = await validateTransaction({ chainId } as never, tx)\n      for (const err of txErrors) {\n        errors.push(String(err))\n      }\n    } else {\n      errors.push('transaction failed structural shape check (isHydratedTransaction)')\n    }\n  } catch (ex) {\n    errors.push(`Validation threw: ${ex instanceof Error ? ex.message : String(ex)}`)\n  }\n\n  return {\n    errors,\n    index,\n    source,\n    valid: errors.length === 0,\n  }\n}\n\nexport async function validateTransactions(options: ValidateTransactionsOptions): Promise<void> {\n  let rawTransactions: [RawTuple, string][]\n\n  if (options.data !== undefined) {\n    rawTransactions = parseInput(options.data)\n  } else if (process.stdin.isTTY) {\n    console.error(chalk.red('No input: provide a file path, inline JSON, or pipe data to stdin.'))\n    process.exitCode = 1\n    return\n  } else {\n    const stdin = await readStdin()\n    rawTransactions = parseSingleOrBatch(stdin.trim(), '<stdin>')\n  }\n\n  const results = await Promise.all(rawTransactions.map(([tx, source], i) => validateOne(tx, source, i)))\n\n  const validCount = results.filter(r => r.valid).length\n  const invalidCount = results.filter(r => !r.valid).length\n\n  console.log(`Total:   ${results.length}`)\n  console.log(chalk.green(`Valid:   ${validCount}`))\n  if (invalidCount > 0) {\n    console.log(chalk.red(`Invalid: ${invalidCount}`))\n  }\n\n  if (options.detail === true || invalidCount > 0) {\n    for (const result of results.filter(r => !r.valid)) {\n      console.log(chalk.red(`\\n[${result.index}] ${result.source}`))\n      for (const err of result.errors) {\n        console.log(chalk.red(`  - ${err}`))\n      }\n    }\n  }\n\n  if (invalidCount > 0) {\n    process.exitCode = 1\n  }\n}\n","import type { CommandModule } from 'yargs'\n\nimport { validateTransactions } from '../actions/xyo/index.ts'\n\nexport const xyoTxValidateCommand: CommandModule = {\n  command: 'validate [data]',\n  describe: 'Validate one or more XL1 transactions (file, inline JSON, or stdin)',\n  builder: yargs =>\n    yargs\n      .positional('data', {\n        type: 'string',\n        describe: 'Path to a .json/.jsonl file, or an inline transaction JSON tuple [bw, payloads[]]',\n      })\n      .option('detail', {\n        alias: 'd',\n        type: 'boolean',\n        default: false,\n        describe: 'Print per-transaction error details (always shown for invalid transactions)',\n      })\n      .example(\n        '$0 xyo tx validate ./tx.json',\n        'Validate a single signed transaction from a file',\n      )\n      .example(\n        '$0 xyo tx validate ./txs.jsonl',\n        'Validate a batch of transactions, one per line',\n      )\n      .example(\n        'cat txs.jsonl | $0 xyo tx validate',\n        'Validate transactions piped from stdin',\n      ),\n  handler: async (argv) => {\n    await validateTransactions({\n      data: argv.data as string | undefined,\n      detail: argv.detail as boolean,\n    })\n  },\n}\n","import type { CommandModule } from 'yargs'\n\nimport { xyoTxValidateCommand } from './xyoTxValidateCommand.ts'\n\nexport const xyoTxCommand: CommandModule = {\n  command: 'tx',\n  describe: 'XL1 transaction utilities',\n  builder: yargs =>\n    yargs\n      .command(xyoTxValidateCommand)\n      .demandCommand(1)\n      .strictCommands(),\n  // eslint-disable-next-line @typescript-eslint/no-empty-function\n  handler: () => {},\n}\n"],"mappings":"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","names":[]}

package/dist/commands/xyoTxValidateCommand.mjs

@@ -0,0 +1,168 @@
+// src/actions/xyo/transaction/validateTransactions.ts
+import FS, { existsSync } from "fs";
+import path from "path";
+import { PayloadBuilder } from "@xyo-network/sdk-js";
+import {
+  isHydratedTransaction,
+  isTransactionBoundWitness,
+  validateTransaction
+} from "@xyo-network/xl1-sdk";
+import chalk from "chalk";
+function isRawTuple(value) {
+  return Array.isArray(value) && value.length === 2 && Array.isArray(value[1]);
+}
+function parseSingleOrBatch(raw, source) {
+  const parsed = JSON.parse(raw);
+  if (isRawTuple(parsed)) {
+    return [[parsed, source]];
+  }
+  if (Array.isArray(parsed) && parsed.length > 0 && parsed.every(isRawTuple)) {
+    return parsed.map((tx, i) => [tx, `${source}[${i}]`]);
+  }
+  throw new Error(`${source}: expected a transaction tuple [bw, payloads[]] or array of tuples`);
+}
+function parseJsonl(raw, source) {
+  const results = [];
+  for (const [i, rawLine] of raw.split("\n").entries()) {
+    const line = rawLine?.trim();
+    if (!line) continue;
+    let parsed;
+    try {
+      parsed = JSON.parse(line);
+    } catch (error) {
+      const msg = error instanceof Error ? error.message : String(error);
+      throw new Error(`${source} line ${i + 1}: invalid JSON (${msg})`, { cause: error });
+    }
+    if (!isRawTuple(parsed)) {
+      throw new Error(`${source} line ${i + 1}: expected a transaction tuple [bw, payloads[]]`);
+    }
+    results.push([parsed, `${source}:${i + 1}`]);
+  }
+  return results;
+}
+function parseInput(data) {
+  const absolute = path.resolve(data);
+  if (existsSync(absolute)) {
+    const raw = FS.readFileSync(absolute, "utf8");
+    const ext = path.extname(absolute).toLowerCase();
+    if (ext === ".jsonl" || ext === ".ndjson") {
+      return parseJsonl(raw, data);
+    }
+    return parseSingleOrBatch(raw, data);
+  }
+  return parseSingleOrBatch(data, "<inline>");
+}
+async function readStdin() {
+  return new Promise((resolve, reject) => {
+    let buf = "";
+    process.stdin.setEncoding("utf8");
+    process.stdin.on("data", (chunk) => {
+      buf += chunk;
+    });
+    process.stdin.on("end", () => resolve(buf));
+    process.stdin.on("error", reject);
+  });
+}
+async function validateOne(raw, source, index) {
+  const [bwRaw, payloadsRaw] = raw;
+  const errors = [];
+  if (!isTransactionBoundWitness(bwRaw)) {
+    return {
+      errors: ["not a valid transaction BoundWitness"],
+      index,
+      source,
+      valid: false
+    };
+  }
+  try {
+    const bwWithMeta = await PayloadBuilder.addHashMeta(bwRaw);
+    const payloadsWithMeta = await Promise.all(
+      payloadsRaw.map((p) => PayloadBuilder.addHashMeta(p))
+    );
+    const tx = [bwWithMeta, payloadsWithMeta];
+    if (isHydratedTransaction(tx)) {
+      const chainId = bwRaw.chain;
+      const txErrors = await validateTransaction({ chainId }, tx);
+      for (const err of txErrors) {
+        errors.push(String(err));
+      }
+    } else {
+      errors.push("transaction failed structural shape check (isHydratedTransaction)");
+    }
+  } catch (ex) {
+    errors.push(`Validation threw: ${ex instanceof Error ? ex.message : String(ex)}`);
+  }
+  return {
+    errors,
+    index,
+    source,
+    valid: errors.length === 0
+  };
+}
+async function validateTransactions(options) {
+  let rawTransactions;
+  if (options.data !== void 0) {
+    rawTransactions = parseInput(options.data);
+  } else if (process.stdin.isTTY) {
+    console.error(chalk.red("No input: provide a file path, inline JSON, or pipe data to stdin."));
+    process.exitCode = 1;
+    return;
+  } else {
+    const stdin = await readStdin();
+    rawTransactions = parseSingleOrBatch(stdin.trim(), "<stdin>");
+  }
+  const results = await Promise.all(rawTransactions.map(([tx, source], i) => validateOne(tx, source, i)));
+  const validCount = results.filter((r) => r.valid).length;
+  const invalidCount = results.filter((r) => !r.valid).length;
+  console.log(`Total:   ${results.length}`);
+  console.log(chalk.green(`Valid:   ${validCount}`));
+  if (invalidCount > 0) {
+    console.log(chalk.red(`Invalid: ${invalidCount}`));
+  }
+  if (options.detail === true || invalidCount > 0) {
+    for (const result of results.filter((r) => !r.valid)) {
+      console.log(chalk.red(`
+[${result.index}] ${result.source}`));
+      for (const err of result.errors) {
+        console.log(chalk.red(`  - ${err}`));
+      }
+    }
+  }
+  if (invalidCount > 0) {
+    process.exitCode = 1;
+  }
+}
+
+// src/commands/xyoTxValidateCommand.ts
+var xyoTxValidateCommand = {
+  command: "validate [data]",
+  describe: "Validate one or more XL1 transactions (file, inline JSON, or stdin)",
+  builder: (yargs) => yargs.positional("data", {
+    type: "string",
+    describe: "Path to a .json/.jsonl file, or an inline transaction JSON tuple [bw, payloads[]]"
+  }).option("detail", {
+    alias: "d",
+    type: "boolean",
+    default: false,
+    describe: "Print per-transaction error details (always shown for invalid transactions)"
+  }).example(
+    "$0 xyo tx validate ./tx.json",
+    "Validate a single signed transaction from a file"
+  ).example(
+    "$0 xyo tx validate ./txs.jsonl",
+    "Validate a batch of transactions, one per line"
+  ).example(
+    "cat txs.jsonl | $0 xyo tx validate",
+    "Validate transactions piped from stdin"
+  ),
+  handler: async (argv) => {
+    await validateTransactions({
+      data: argv.data,
+      detail: argv.detail
+    });
+  }
+};
+export {
+  xyoTxValidateCommand
+};
+//# sourceMappingURL=xyoTxValidateCommand.mjs.map

package/dist/commands/xyoTxValidateCommand.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/actions/xyo/transaction/validateTransactions.ts","../../src/commands/xyoTxValidateCommand.ts"],"sourcesContent":["import FS, { existsSync } from 'node:fs'\nimport path from 'node:path'\n\nimport type { Payload } from '@xyo-network/sdk-js'\nimport { PayloadBuilder } from '@xyo-network/sdk-js'\nimport type { HydratedTransactionWithHashMeta } from '@xyo-network/xl1-sdk'\nimport {\n  isHydratedTransaction,\n  isTransactionBoundWitness,\n  validateTransaction,\n} from '@xyo-network/xl1-sdk'\nimport chalk from 'chalk'\n\nexport interface ValidateTransactionsOptions {\n  data?: string\n  detail?: boolean\n}\n\ninterface ValidationResult {\n  errors: string[]\n  index: number\n  source: string\n  valid: boolean\n}\n\ntype RawTuple = [unknown, unknown[]]\n\nfunction isRawTuple(value: unknown): value is RawTuple {\n  return Array.isArray(value) && value.length === 2 && Array.isArray(value[1])\n}\n\nfunction parseSingleOrBatch(raw: string, source: string): [RawTuple, string][] {\n  const parsed: unknown = JSON.parse(raw)\n  if (isRawTuple(parsed)) {\n    return [[parsed, source]]\n  }\n  if (Array.isArray(parsed) && parsed.length > 0 && parsed.every(isRawTuple)) {\n    return parsed.map((tx, i) => [tx, `${source}[${i}]`])\n  }\n  throw new Error(`${source}: expected a transaction tuple [bw, payloads[]] or array of tuples`)\n}\n\nfunction parseJsonl(raw: string, source: string): [RawTuple, string][] {\n  const results: [RawTuple, string][] = []\n  for (const [i, rawLine] of raw.split('\\n').entries()) {\n    const line = rawLine?.trim()\n    if (!line) continue\n    let parsed: unknown\n    try {\n      parsed = JSON.parse(line)\n    } catch (error) {\n      const msg = error instanceof Error ? error.message : String(error)\n      throw new Error(`${source} line ${i + 1}: invalid JSON (${msg})`, { cause: error })\n    }\n    if (!isRawTuple(parsed)) {\n      throw new Error(`${source} line ${i + 1}: expected a transaction tuple [bw, payloads[]]`)\n    }\n    results.push([parsed, `${source}:${i + 1}`])\n  }\n  return results\n}\n\nfunction parseInput(data: string): [RawTuple, string][] {\n  const absolute = path.resolve(data)\n  if (existsSync(absolute)) {\n    const raw = FS.readFileSync(absolute, 'utf8')\n    const ext = path.extname(absolute).toLowerCase()\n    if (ext === '.jsonl' || ext === '.ndjson') {\n      return parseJsonl(raw, data)\n    }\n    return parseSingleOrBatch(raw, data)\n  }\n  return parseSingleOrBatch(data, '<inline>')\n}\n\nasync function readStdin(): Promise<string> {\n  return new Promise((resolve, reject) => {\n    let buf = ''\n    process.stdin.setEncoding('utf8')\n    process.stdin.on('data', (chunk: string) => {\n      buf += chunk\n    })\n    process.stdin.on('end', () => resolve(buf))\n    process.stdin.on('error', reject)\n  })\n}\n\nasync function validateOne(raw: RawTuple, source: string, index: number): Promise<ValidationResult> {\n  const [bwRaw, payloadsRaw] = raw\n  const errors: string[] = []\n\n  if (!isTransactionBoundWitness(bwRaw)) {\n    return {\n      errors: ['not a valid transaction BoundWitness'],\n      index,\n      source,\n      valid: false,\n    }\n  }\n\n  try {\n    const bwWithMeta = await PayloadBuilder.addHashMeta(bwRaw as Payload)\n    const payloadsWithMeta = await Promise.all(\n      (payloadsRaw as Payload[]).map(p => PayloadBuilder.addHashMeta(p)),\n    )\n    const tx = [bwWithMeta, payloadsWithMeta] as unknown as HydratedTransactionWithHashMeta\n\n    if (isHydratedTransaction(tx)) {\n      const chainId = bwRaw.chain as string\n      const txErrors = await validateTransaction({ chainId } as never, tx)\n      for (const err of txErrors) {\n        errors.push(String(err))\n      }\n    } else {\n      errors.push('transaction failed structural shape check (isHydratedTransaction)')\n    }\n  } catch (ex) {\n    errors.push(`Validation threw: ${ex instanceof Error ? ex.message : String(ex)}`)\n  }\n\n  return {\n    errors,\n    index,\n    source,\n    valid: errors.length === 0,\n  }\n}\n\nexport async function validateTransactions(options: ValidateTransactionsOptions): Promise<void> {\n  let rawTransactions: [RawTuple, string][]\n\n  if (options.data !== undefined) {\n    rawTransactions = parseInput(options.data)\n  } else if (process.stdin.isTTY) {\n    console.error(chalk.red('No input: provide a file path, inline JSON, or pipe data to stdin.'))\n    process.exitCode = 1\n    return\n  } else {\n    const stdin = await readStdin()\n    rawTransactions = parseSingleOrBatch(stdin.trim(), '<stdin>')\n  }\n\n  const results = await Promise.all(rawTransactions.map(([tx, source], i) => validateOne(tx, source, i)))\n\n  const validCount = results.filter(r => r.valid).length\n  const invalidCount = results.filter(r => !r.valid).length\n\n  console.log(`Total:   ${results.length}`)\n  console.log(chalk.green(`Valid:   ${validCount}`))\n  if (invalidCount > 0) {\n    console.log(chalk.red(`Invalid: ${invalidCount}`))\n  }\n\n  if (options.detail === true || invalidCount > 0) {\n    for (const result of results.filter(r => !r.valid)) {\n      console.log(chalk.red(`\\n[${result.index}] ${result.source}`))\n      for (const err of result.errors) {\n        console.log(chalk.red(`  - ${err}`))\n      }\n    }\n  }\n\n  if (invalidCount > 0) {\n    process.exitCode = 1\n  }\n}\n","import type { CommandModule } from 'yargs'\n\nimport { validateTransactions } from '../actions/xyo/index.ts'\n\nexport const xyoTxValidateCommand: CommandModule = {\n  command: 'validate [data]',\n  describe: 'Validate one or more XL1 transactions (file, inline JSON, or stdin)',\n  builder: yargs =>\n    yargs\n      .positional('data', {\n        type: 'string',\n        describe: 'Path to a .json/.jsonl file, or an inline transaction JSON tuple [bw, payloads[]]',\n      })\n      .option('detail', {\n        alias: 'd',\n        type: 'boolean',\n        default: false,\n        describe: 'Print per-transaction error details (always shown for invalid transactions)',\n      })\n      .example(\n        '$0 xyo tx validate ./tx.json',\n        'Validate a single signed transaction from a file',\n      )\n      .example(\n        '$0 xyo tx validate ./txs.jsonl',\n        'Validate a batch of transactions, one per line',\n      )\n      .example(\n        'cat txs.jsonl | $0 xyo tx validate',\n        'Validate transactions piped from stdin',\n      ),\n  handler: async (argv) => {\n    await validateTransactions({\n      data: argv.data as string | undefined,\n      detail: argv.detail as boolean,\n    })\n  },\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+declare const aries: () => Promise<void>;
+
+export { aries };