@aura-protocol/cli 0.1.3 → 0.3.0

package/dist/core/runner.js

@@ -0,0 +1,219 @@
+/**
+ * The secure transaction pipeline shared by every command that writes
+ * on-chain. Given built instructions and some metadata it will, in order:
+ *
+ *   1. assemble the transaction (compute-budget + optional heap frame),
+ *   2. render a human preview of exactly what will be signed,
+ *   3. guard production (mainnet) writes behind an explicit confirmation,
+ *   4. confirm sensitive instructions (authority/governance/closures),
+ *   5. preflight-simulate and surface compute units + program logs,
+ *   6. sign, send, and confirm, printing the signature + explorer link.
+ *
+ * `--dry-run` stops after the preview and emits the serialized instructions.
+ * `--json` suppresses decorative output and returns structured data.
+ * `--yes` skips confirmations (for CI). `--no-simulate` skips preflight.
+ */
+import { confirm } from "@inquirer/prompts";
+import { ComputeBudgetProgram, Transaction, } from "@solana/web3.js";
+import { emitJson, printNote, printPanel, printSuccess, serializeInstruction, startSpinner, } from "../ui/output.js";
+import { block, style, symbol } from "../ui/theme.js";
+import { CliError } from "./errors.js";
+import { classifyInstructionRisk } from "./security.js";
+const DEFAULT_COMPUTE_UNIT_LIMIT = 600_000;
+function networkBadge(ctx) {
+    const { kind, label } = ctx.network;
+    if (kind === "mainnet")
+        return block(label.toUpperCase(), "danger");
+    if (kind === "devnet")
+        return block(label, "success");
+    if (kind === "localnet")
+        return block(label, "muted");
+    return block(label, "warn");
+}
+function explorerUrl(ctx, signature) {
+    const base = `https://explorer.solana.com/tx/${signature}`;
+    switch (ctx.network.kind) {
+        case "mainnet":
+            return base;
+        case "devnet":
+            return `${base}?cluster=devnet`;
+        case "testnet":
+            return `${base}?cluster=testnet`;
+        default:
+            return `${base}?cluster=custom&customUrl=${encodeURIComponent(ctx.network.rpcUrl)}`;
+    }
+}
+function renderPreview(ctx, instructions, meta) {
+    const lines = [];
+    lines.push(`${style.muted("network")}   ${networkBadge(ctx)} ${style.dim(ctx.network.rpcUrl)}`);
+    lines.push(`${style.muted("program")}   ${style.dim(ctx.programId.toBase58())}`);
+    if (ctx.wallet) {
+        lines.push(`${style.muted("payer")}     ${ctx.wallet.publicKey.toBase58()}`);
+    }
+    for (const [label, value] of meta.summary ?? []) {
+        lines.push(`${style.muted(label.padEnd(9))} ${value}`);
+    }
+    lines.push(style.muted("─".repeat(40)));
+    instructions.forEach((ix, index) => {
+        const signers = ix.keys.filter((k) => k.isSigner).length;
+        const writable = ix.keys.filter((k) => k.isWritable).length;
+        lines.push(`${style.bold(`#${index + 1}`)} ${style.dim(ix.programId.toBase58())} ` +
+            style.muted(`(${ix.keys.length} accts · ${signers} signer · ${writable} writable)`));
+    });
+    printPanel(ctx.output, `${meta.action}`, lines, ctx.network.isProduction ? "danger" : "primary");
+}
+async function confirmOrThrow(ctx, message) {
+    if (ctx.flags.yes) {
+        return true;
+    }
+    if (!process.stdout.isTTY) {
+        throw new CliError(`Confirmation required: ${message}`, {
+            code: "CONFIRMATION_REQUIRED",
+            tip: "Re-run with --yes to proceed non-interactively.",
+        });
+    }
+    return await confirm({ message, default: false });
+}
+async function preflightSimulate(ctx, tx) {
+    const spinner = startSpinner(ctx.output, "Simulating transaction...");
+    try {
+        const result = await ctx.connection.simulateTransaction(tx);
+        const units = result.value.unitsConsumed;
+        if (result.value.err) {
+            const logs = (result.value.logs ?? []).join("\n");
+            spinner.fail("Simulation failed");
+            throw new CliError(`Preflight simulation failed: ${JSON.stringify(result.value.err)}`, {
+                code: "SIMULATION_FAILED",
+                tip: "Inspect the program logs above. Use --no-simulate to skip this check, or --dry-run to inspect the instruction.",
+                details: logs || undefined,
+            });
+        }
+        spinner.succeed(units !== null && units !== undefined
+            ? `Simulation ok (${units.toLocaleString()} compute units)`
+            : "Simulation ok");
+    }
+    catch (error) {
+        if (error instanceof CliError) {
+            throw error;
+        }
+        spinner.fail("Simulation error");
+        throw new CliError(`Could not simulate transaction: ${error instanceof Error ? error.message : String(error)}`, {
+            code: "SIMULATION_ERROR",
+            tip: "Pass --no-simulate to skip the preflight check.",
+            cause: error,
+        });
+    }
+}
+/**
+ * Builds, previews, guards, simulates, signs, and sends `instructions`.
+ * Honors `--dry-run`, `--json`, `--yes`, `--no-simulate`, and `--compute-units`.
+ */
+export async function runInstructions(ctx, instructions, meta) {
+    if (!ctx.wallet) {
+        throw new CliError(`A wallet is required to ${meta.action.toLowerCase()}.`, {
+            code: "WALLET_REQUIRED",
+            tip: "Configure a wallet with `aura config init` or pass --wallet <path>.",
+        });
+    }
+    const computeUnits = ctx.flags.computeUnits ?? meta.computeUnits ?? DEFAULT_COMPUTE_UNIT_LIMIT;
+    const budgetIxns = [
+        ComputeBudgetProgram.setComputeUnitLimit({ units: computeUnits }),
+    ];
+    if (meta.heapFrameBytes) {
+        budgetIxns.unshift(ComputeBudgetProgram.requestHeapFrame({ bytes: meta.heapFrameBytes }));
+    }
+    renderPreview(ctx, instructions, meta);
+    // --- Dry run: stop before sending. ------------------------------------
+    if (ctx.dryRun) {
+        if (ctx.output.json) {
+            emitJson(ctx.output, {
+                action: meta.action,
+                dryRun: true,
+                network: ctx.network.label,
+                instructions: instructions.map(serializeInstruction),
+                ...meta.result,
+            });
+        }
+        else {
+            printNote(ctx.output, "Dry run — transaction was not sent.");
+        }
+        return { dryRun: true, aborted: false };
+    }
+    // --- Guard rails: confirmations. --------------------------------------
+    const risk = meta.instructionName
+        ? classifyInstructionRisk(meta.instructionName)
+        : { level: "normal" };
+    if (ctx.network.isProduction) {
+        printPanel(ctx.output, "Production network", [
+            style.danger(`${symbol.warn} You are about to send a transaction on MAINNET.`),
+            style.muted("This spends real funds and cannot be undone."),
+        ], "danger");
+        const ok = await confirmOrThrow(ctx, "Proceed on mainnet-beta?");
+        if (!ok) {
+            printNote(ctx.output, "Aborted.");
+            return { dryRun: false, aborted: true };
+        }
+    }
+    if (meta.confirm || risk.level !== "normal") {
+        const reason = risk.reason ? ` (${risk.reason})` : "";
+        const ok = await confirmOrThrow(ctx, `Confirm "${meta.action}"${reason}?`);
+        if (!ok) {
+            printNote(ctx.output, "Aborted.");
+            return { dryRun: false, aborted: true };
+        }
+    }
+    // --- Assemble + sign. -------------------------------------------------
+    const extraSigners = meta.extraSigners ?? [];
+    const tx = new Transaction().add(...budgetIxns, ...instructions);
+    tx.feePayer = ctx.wallet.publicKey;
+    const latest = await ctx.connection.getLatestBlockhash("confirmed");
+    tx.recentBlockhash = latest.blockhash;
+    tx.sign(ctx.wallet, ...extraSigners);
+    // --- Preflight simulation. --------------------------------------------
+    if (ctx.flags.simulate) {
+        await preflightSimulate(ctx, tx);
+    }
+    // --- Send + confirm. --------------------------------------------------
+    const spinner = startSpinner(ctx.output, `Sending: ${meta.action}...`);
+    let signature;
+    try {
+        signature = await ctx.connection.sendRawTransaction(tx.serialize(), {
+            preflightCommitment: "confirmed",
+        });
+        const confirmation = await ctx.connection.confirmTransaction({
+            signature,
+            blockhash: latest.blockhash,
+            lastValidBlockHeight: latest.lastValidBlockHeight,
+        }, "confirmed");
+        if (confirmation.value.err) {
+            spinner.fail("Transaction failed");
+            throw new CliError(`Transaction ${signature} failed on-chain.`, {
+                code: "TX_FAILED",
+                tip: "Re-run with --dry-run to inspect the instruction, or check the explorer link.",
+                details: explorerUrl(ctx, signature),
+            });
+        }
+        spinner.succeed(`${meta.action} confirmed`);
+    }
+    catch (error) {
+        if (error instanceof CliError)
+            throw error;
+        spinner.fail("Send failed");
+        throw new CliError(`Failed to send transaction: ${error instanceof Error ? error.message : String(error)}`, { code: "SEND_FAILED", cause: error });
+    }
+    if (ctx.output.json) {
+        emitJson(ctx.output, {
+            action: meta.action,
+            signature,
+            network: ctx.network.label,
+            explorer: explorerUrl(ctx, signature),
+            ...meta.result,
+        });
+    }
+    else {
+        printSuccess(ctx.output, `${meta.action} — ${signature}`);
+        printNote(ctx.output, explorerUrl(ctx, signature));
+    }
+    return { dryRun: false, aborted: false, signature };
+}
+//# sourceMappingURL=runner.js.map

package/dist/core/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../src/core/runner.ts"],"names":[],"mappings":"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"}

package/dist/core/security.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Security helpers: keypair file hygiene and instruction risk classification.
+ *
+ * These feed the runner's guard rails. None of them block legitimate use; they
+ * surface warnings and decide when an explicit confirmation is warranted.
+ */
+export type RiskLevel = "normal" | "caution" | "danger";
+export interface InstructionRisk {
+    level: RiskLevel;
+    /** Why the instruction is sensitive — shown in the confirmation prompt. */
+    reason?: string;
+}
+/**
+ * Classifies a (snake_case) instruction name by blast radius so the runner can
+ * decide whether to require confirmation. This is intentionally conservative:
+ * authority changes, recovery, shutdowns, and account closures all prompt.
+ */
+export declare function classifyInstructionRisk(name: string): InstructionRisk;
+export interface WalletHygiene {
+    /** A warning to surface, or null when the file looks fine / unchecked. */
+    warning: string | null;
+}
+/**
+ * Checks keypair file permissions on POSIX systems. A keypair readable by group
+ * or others is a credential-leak risk. No-ops on Windows, where POSIX mode bits
+ * do not apply.
+ */
+export declare function checkWalletFileHygiene(walletPath: string): WalletHygiene;

package/dist/core/security.js

@@ -0,0 +1,83 @@
+/**
+ * Security helpers: keypair file hygiene and instruction risk classification.
+ *
+ * These feed the runner's guard rails. None of them block legitimate use; they
+ * surface warnings and decide when an explicit confirmation is warranted.
+ */
+import { statSync } from "node:fs";
+import { expandHome } from "./config.js";
+/**
+ * Classifies a (snake_case) instruction name by blast radius so the runner can
+ * decide whether to require confirmation. This is intentionally conservative:
+ * authority changes, recovery, shutdowns, and account closures all prompt.
+ */
+export function classifyInstructionRisk(name) {
+    const n = name.toLowerCase();
+    // Highest blast radius: emergency, ownership, recovery, kill-switches.
+    if (n.includes("emergency") || n.includes("shutdown")) {
+        return {
+            level: "danger",
+            reason: "emergency action affecting treasury availability",
+        };
+    }
+    if (n.startsWith("break_glass")) {
+        return { level: "danger", reason: "break-glass recovery override" };
+    }
+    if (n.includes("transfer_authority") ||
+        n.includes("ownership_handover") ||
+        n.startsWith("nominate_successor")) {
+        return { level: "danger", reason: "changes treasury ownership/authority" };
+    }
+    if (n.includes("dead_mans_switch")) {
+        return { level: "danger", reason: "triggers the dead-man's switch" };
+    }
+    if (n.includes("revoke") || n.includes("rotate")) {
+        return {
+            level: "danger",
+            reason: "revokes or rotates an authority/credential",
+        };
+    }
+    // Governance and recovery configuration: sensitive but routine.
+    if (n.includes("multisig") ||
+        n.includes("override") ||
+        n.includes("recovery_destination") ||
+        n.includes("guardian") ||
+        n.startsWith("configure_trust") ||
+        n.includes("operator_role")) {
+        return { level: "caution", reason: "modifies governance / access control" };
+    }
+    // Account closures (reclaim rent, drop state) and migrations.
+    if (n.startsWith("close_") ||
+        n.startsWith("remove_") ||
+        n.startsWith("migrate_") ||
+        n === "disable_confidential_guardrails") {
+        return { level: "caution", reason: "closes or removes on-chain state" };
+    }
+    return { level: "normal" };
+}
+/**
+ * Checks keypair file permissions on POSIX systems. A keypair readable by group
+ * or others is a credential-leak risk. No-ops on Windows, where POSIX mode bits
+ * do not apply.
+ */
+export function checkWalletFileHygiene(walletPath) {
+    if (process.platform === "win32") {
+        return { warning: null };
+    }
+    try {
+        const resolved = expandHome(walletPath);
+        const mode = statSync(resolved).mode & 0o777;
+        if ((mode & 0o077) !== 0) {
+            const octal = mode.toString(8).padStart(3, "0");
+            return {
+                warning: `Keypair ${resolved} is readable by group/others (mode ${octal}). Run: chmod 600 ${resolved}`,
+            };
+        }
+    }
+    catch {
+        // File missing or unreadable — surfaced elsewhere when actually loaded.
+        return { warning: null };
+    }
+    return { warning: null };
+}
+//# sourceMappingURL=security.js.map

package/dist/core/security.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"security.js","sourceRoot":"","sources":["../../src/core/security.ts"],"names":[],"mappings":"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"}

package/dist/core/wallet.d.ts

@@ -0,0 +1,2 @@
+import { Keypair } from "@solana/web3.js";
+export declare function loadKeypair(walletPath: string): Keypair;

package/dist/core/wallet.js

@@ -0,0 +1,21 @@
+import { readFileSync } from "node:fs";
+import { Keypair } from "@solana/web3.js";
+import { expandHome } from "./config.js";
+export function loadKeypair(walletPath) {
+    const resolvedPath = expandHome(walletPath);
+    let secret;
+    try {
+        secret = new Uint8Array(JSON.parse(readFileSync(resolvedPath, "utf8")));
+    }
+    catch {
+        throw new Error(`Could not load wallet keypair from ${resolvedPath}. ` +
+            `Run 'aura config init' or pass --wallet /path/to/id.json.`);
+    }
+    try {
+        return Keypair.fromSecretKey(secret);
+    }
+    catch {
+        throw new Error(`Wallet file at ${resolvedPath} is not a valid Solana keypair JSON array.`);
+    }
+}
+//# sourceMappingURL=wallet.js.map

package/dist/core/wallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.js","sourceRoot":"","sources":["../../src/core/wallet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE1C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,WAAW,CAAC,UAAkB;IAC5C,MAAM,YAAY,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;IAE5C,IAAI,MAAkB,CAAC;IACvB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,UAAU,CACrB,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAa,CAC3D,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,sCAAsC,YAAY,IAAI;YACpD,2DAA2D,CAC9D,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,OAAO,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,kBAAkB,YAAY,4CAA4C,CAC3E,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/index.js

@@ -1,50 +1,93 @@
+import { createRequire } from "node:module";
 import { Command } from "commander";
-import chalk from "chalk";
 import { registerConfidentialCommands } from "./commands/confidential.js";
 import { registerConfigCommands } from "./commands/config.js";
 import { registerDashboardCommand } from "./commands/dashboard.js";
 import { registerDwalletCommands } from "./commands/dwallet.js";
 import { registerExecutionCommands } from "./commands/execution.js";
 import { registerFeatureCommands } from "./commands/features.js";
+import { registerGeneratedCommands } from "./commands/generated.js";
 import { registerGovernanceCommands } from "./commands/governance.js";
-import { registerInstructionCommands } from "./commands/instructions.js";
+import { registerInstructionCommands } from "./commands/instruction.js";
 import { registerPdaCommands } from "./commands/pda.js";
 import { registerTreasuryCommands } from "./commands/treasury.js";
-import { ACTIVE_DEVELOPMENT_WARNING, printError } from "./output.js";
+import { resolveGlobalConfig } from "./core/context.js";
+import { renderError } from "./core/errors.js";
+import { checkWalletFileHygiene } from "./core/security.js";
+import { ACTIVE_DEVELOPMENT_WARNING, printWarn } from "./ui/output.js";
+import { block, setColorEnabled } from "./ui/theme.js";
+// Read the version from package.json at runtime so it can never drift from the
+// published package. Resolves to the package root from both dist/ and src/.
+const require = createRequire(import.meta.url);
+const VERSION = require("../package.json").version;
 export function createProgram() {
     const program = new Command();
     program
         .name("aura")
-        .description("Production-grade CLI for the AURA autonomous treasury program")
-        .version("0.1.0")
+        .description("Production-grade CLI for the AURA autonomous treasury program on Solana")
+        .version(VERSION, "-v, --version", "print the CLI version")
         .showHelpAfterError()
         .showSuggestionAfterError()
-        .option("--rpc-url <url>", "override RPC endpoint")
-        .option("--wallet <path>", "override keypair file path")
-        .option("--program-id <id>", "override AURA program ID")
+        .option("--rpc-url <url>", "override the RPC endpoint")
+        .option("--wallet <path>", "override the keypair file path")
+        .option("--program-id <id>", "override the AURA program ID")
         .option("--cluster <name>", "cluster label for display")
         .option("--json", "output machine-readable JSON")
         .option("--quiet", "suppress non-error terminal output")
-        .option("--dry-run", "build and display the instruction without sending")
-        .addHelpText("afterAll", `\n${chalk.yellow.bold("warning")}: ${ACTIVE_DEVELOPMENT_WARNING}`);
+        .option("--dry-run", "build and preview the transaction without sending")
+        .option("-y, --yes", "skip confirmation prompts (non-interactive)")
+        .option("--no-simulate", "skip the preflight simulation before sending")
+        .option("--no-color", "disable colored output")
+        .option("--compute-units <n>", "override the compute-unit limit", (value) => Number(value))
+        .addHelpText("afterAll", () => `\n${block("WARNING", "warn")} ${ACTIVE_DEVELOPMENT_WARNING}`);
+    // Best-effort keypair hygiene warning before any command runs.
+    program.hook("preAction", (thisCommand) => {
+        const opts = thisCommand.opts();
+        if (opts.json === true || opts.quiet === true) {
+            return;
+        }
+        try {
+            const { config } = resolveGlobalConfig(thisCommand);
+            const hygiene = checkWalletFileHygiene(config.walletPath);
+            if (hygiene.warning) {
+                printWarn({ json: false, quiet: false }, hygiene.warning);
+            }
+        }
+        catch {
+            // Never let a preflight warning block a command.
+        }
+    });
     registerConfigCommands(program);
     registerTreasuryCommands(program);
     registerDwalletCommands(program);
     registerConfidentialCommands(program);
     registerExecutionCommands(program);
-    registerFeatureCommands(program);
-    registerInstructionCommands(program);
     registerGovernanceCommands(program);
+    registerFeatureCommands(program);
     registerPdaCommands(program);
     registerDashboardCommand(program);
+    registerInstructionCommands(program);
+    // Generated per-domain instruction commands provide complete coverage of
+    // every program instruction. Registered last so they merge into the
+    // ergonomic command groups above without clobbering their friendly verbs.
+    registerGeneratedCommands(program);
     return program;
 }
+/** Disables color early (before help/preview render) for --no-color / --json / NO_COLOR. */
+function configureColor(argv) {
+    if (argv.includes("--no-color") ||
+        argv.includes("--json") ||
+        process.env.NO_COLOR !== undefined) {
+        setColorEnabled(false);
+    }
+}
 export async function main(argv = process.argv) {
+    configureColor(argv);
     try {
         await createProgram().parseAsync(argv);
     }
     catch (error) {
-        printError(error);
+        renderError(error);
         process.exitCode = 1;
     }
 }

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,0BAA0B,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAErE,MAAM,UAAU,aAAa;IAC3B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,MAAM,CAAC;SACZ,WAAW,CAAC,+DAA+D,CAAC;SAC5E,OAAO,CAAC,OAAO,CAAC;SAChB,kBAAkB,EAAE;SACpB,wBAAwB,EAAE;SAC1B,MAAM,CAAC,iBAAiB,EAAE,uBAAuB,CAAC;SAClD,MAAM,CAAC,iBAAiB,EAAE,4BAA4B,CAAC;SACvD,MAAM,CAAC,mBAAmB,EAAE,0BAA0B,CAAC;SACvD,MAAM,CAAC,kBAAkB,EAAE,2BAA2B,CAAC;SACvD,MAAM,CAAC,QAAQ,EAAE,8BAA8B,CAAC;SAChD,MAAM,CAAC,SAAS,EAAE,oCAAoC,CAAC;SACvD,MAAM,CAAC,WAAW,EAAE,mDAAmD,CAAC;SACxE,WAAW,CACV,UAAU,EACV,KAAK,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,0BAA0B,EAAE,CACnE,CAAC;IAEJ,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChC,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAClC,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACjC,4BAA4B,CAAC,OAAO,CAAC,CAAC;IACtC,yBAAyB,CAAC,OAAO,CAAC,CAAC;IACnC,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACjC,2BAA2B,CAAC,OAAO,CAAC,CAAC;IACrC,0BAA0B,CAAC,OAAO,CAAC,CAAC;IACpC,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC7B,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAElC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI;IAC5C,IAAI,CAAC;QACH,MAAM,aAAa,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,UAAU,CAAC,KAAK,CAAC,CAAC;QAClB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/lib/domain.d.ts

@@ -0,0 +1,16 @@
+export declare function parseChain(input: string | number): number;
+export declare function formatChain(code: number): string;
+export declare function parseTransactionType(input: string | number): number;
+export declare function formatTransactionType(code: number): string;
+export declare function formatProposalStatus(code: number): string;
+export declare function formatViolation(code: number): string;
+export declare function chainNameForDigest(code: number): string;
+export declare function transactionTypeNameForDigest(code: number): string;
+export declare function listChainChoices(): {
+    name: string;
+    value: number;
+}[];
+export declare function listTransactionTypeChoices(): {
+    name: string;
+    value: number;
+}[];

package/dist/lib/domain.js

@@ -0,0 +1,88 @@
+const CHAINS = [
+    { code: 0, name: "bitcoin", label: "Bitcoin" },
+    { code: 1, name: "ethereum", label: "Ethereum" },
+    { code: 2, name: "solana", label: "Solana" },
+    { code: 3, name: "polygon", label: "Polygon" },
+    { code: 4, name: "arbitrum", label: "Arbitrum" },
+    { code: 5, name: "optimism", label: "Optimism" },
+];
+const TX_TYPES = [
+    { code: 0, name: "transfer", label: "Transfer" },
+    { code: 1, name: "defi_swap", label: "DeFi Swap" },
+    { code: 2, name: "lending_deposit", label: "Lending Deposit" },
+    { code: 3, name: "nft_purchase", label: "NFT Purchase" },
+    { code: 4, name: "contract_interaction", label: "Contract Interaction" },
+];
+const PROPOSAL_STATUSES = [
+    { code: 0, label: "Proposed" },
+    { code: 1, label: "Decryption Requested" },
+    { code: 2, label: "Awaiting Signature" },
+    { code: 3, label: "Executed" },
+    { code: 4, label: "Denied" },
+    { code: 5, label: "Cancelled" },
+    { code: 6, label: "Expired" },
+    { code: 7, label: "Policy Computed" },
+];
+const VIOLATIONS = [
+    { code: 0, label: "none" },
+    { code: 1, label: "per-tx limit" },
+    { code: 2, label: "daily limit" },
+    { code: 3, label: "bitcoin manual review" },
+    { code: 4, label: "time window" },
+    { code: 5, label: "velocity limit" },
+    { code: 6, label: "protocol not allowed" },
+    { code: 7, label: "slippage exceeded" },
+    { code: 8, label: "quote stale" },
+    { code: 9, label: "counterparty risk" },
+    { code: 10, label: "shared pool limit" },
+];
+function entryFor(code, entries) {
+    return entries.find((entry) => entry.code === code);
+}
+function parseCode(input, entries, kind) {
+    const normalized = typeof input === "number" ? String(input) : input.trim().toLowerCase();
+    const direct = Number(normalized);
+    if (Number.isInteger(direct) &&
+        entries.some((entry) => entry.code === direct)) {
+        return direct;
+    }
+    const match = entries.find((entry) => entry.name === normalized || entry.label.toLowerCase() === normalized);
+    if (match) {
+        return match.code;
+    }
+    throw new Error(`Unknown ${kind}: ${input}`);
+}
+function labelFor(code, entries, fallback) {
+    return entries.find((entry) => entry.code === code)?.label ?? fallback;
+}
+export function parseChain(input) {
+    return parseCode(input, CHAINS, "chain");
+}
+export function formatChain(code) {
+    return labelFor(code, CHAINS, `Unknown (${code})`);
+}
+export function parseTransactionType(input) {
+    return parseCode(input, TX_TYPES, "transaction type");
+}
+export function formatTransactionType(code) {
+    return labelFor(code, TX_TYPES, `Unknown (${code})`);
+}
+export function formatProposalStatus(code) {
+    return labelFor(code, PROPOSAL_STATUSES, `Unknown (${code})`);
+}
+export function formatViolation(code) {
+    return labelFor(code, VIOLATIONS, `unknown (${code})`);
+}
+export function chainNameForDigest(code) {
+    return entryFor(code, CHAINS)?.name ?? `unknown_${code}`;
+}
+export function transactionTypeNameForDigest(code) {
+    return entryFor(code, TX_TYPES)?.name ?? `unknown_${code}`;
+}
+export function listChainChoices() {
+    return CHAINS.map((entry) => ({ name: entry.label, value: entry.code }));
+}
+export function listTransactionTypeChoices() {
+    return TX_TYPES.map((entry) => ({ name: entry.label, value: entry.code }));
+}
+//# sourceMappingURL=domain.js.map

package/dist/lib/domain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.js","sourceRoot":"","sources":["../../src/lib/domain.ts"],"names":[],"mappings":"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"}