@aura-protocol/cli 0.1.2 → 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":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAUzC;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAE7B,uEAAuE;IACvE,IAAI,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACtD,OAAO;YACL,KAAK,EAAE,QAAQ;YACf,MAAM,EAAE,kDAAkD;SAC3D,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAChC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,+BAA+B,EAAE,CAAC;IACtE,CAAC;IACD,IACE,CAAC,CAAC,QAAQ,CAAC,oBAAoB,CAAC;QAChC,CAAC,CAAC,QAAQ,CAAC,oBAAoB,CAAC;QAChC,CAAC,CAAC,UAAU,CAAC,oBAAoB,CAAC,EAClC,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,sCAAsC,EAAE,CAAC;IAC7E,CAAC;IACD,IAAI,CAAC,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACnC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,gCAAgC,EAAE,CAAC;IACvE,CAAC;IACD,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjD,OAAO;YACL,KAAK,EAAE,QAAQ;YACf,MAAM,EAAE,4CAA4C;SACrD,CAAC;IACJ,CAAC;IAED,gEAAgE;IAChE,IACE,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC;QACtB,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC;QACtB,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC;QAClC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC;QACtB,CAAC,CAAC,UAAU,CAAC,iBAAiB,CAAC;QAC/B,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC,EAC3B,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,sCAAsC,EAAE,CAAC;IAC9E,CAAC;IAED,8DAA8D;IAC9D,IACE,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC;QACtB,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC;QACvB,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC;QACxB,CAAC,KAAK,iCAAiC,EACvC,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,kCAAkC,EAAE,CAAC;IAC1E,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AAC7B,CAAC;AAOD;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,UAAkB;IACvD,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IACD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;QACxC,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC;QAC7C,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YAChD,OAAO;gBACL,OAAO,EAAE,WAAW,QAAQ,sCAAsC,KAAK,qBAAqB,QAAQ,EAAE;aACvG,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,wEAAwE;QACxE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC3B,CAAC"}

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/ika.d.ts

@@ -40,15 +40,6 @@ export declare function encryptU64(value: number | bigint, authorized: PublicKey
  * Returns one pubkey per input value in the same order.
  */
 export declare function encryptU64Batch(values: (number | bigint)[], authorized: PublicKey, grpcUrl?: string): Promise<PublicKey[]>;
-/**
- * Encrypts an EUint64Vector input through the Ika Encrypt gRPC service.
- *
- * Arithmetic vectors are exactly 8,192 bytes. Values are written into leading
- * u64 lanes and the remaining lanes are zero-filled. Passing an empty values
- * list creates a verified zero vector, which is useful as a pre-allocated graph
- * output account.
- */
-export declare function encryptU64Vector(values: (number | bigint)[], authorized: PublicKey, grpcUrl?: string): Promise<PublicKey>;
 /**
  * Reads a decrypted ciphertext value from the Encrypt network.
  *

package/dist/ika.js

@@ -17,10 +17,6 @@ export { ENCRYPT_GRPC_URL, IKA_GRPC_URL };
  * FHE type for u64 values — matches `ENCRYPT_FHE_UINT64` in the Rust program.
  */
 const FHE_TYPE_UINT64 = 4;
-/**
- * FHE type for EUint64Vector values — matches `ENCRYPT_FHE_VECTOR_U64`.
- */
-const FHE_TYPE_UINT64_VECTOR = 35;
 const U64_MAX = (1n << 64n) - 1n;
 /**
  * The 32-byte network encryption public key used by the pre-alpha Encrypt service.
@@ -113,50 +109,6 @@ export async function encryptU64Batch(values, authorized, grpcUrl = ENCRYPT_GRPC
         client.close();
     }
 }
-/**
- * Encrypts an EUint64Vector input through the Ika Encrypt gRPC service.
- *
- * Arithmetic vectors are exactly 8,192 bytes. Values are written into leading
- * u64 lanes and the remaining lanes are zero-filled. Passing an empty values
- * list creates a verified zero vector, which is useful as a pre-allocated graph
- * output account.
- */
-export async function encryptU64Vector(values, authorized, grpcUrl = ENCRYPT_GRPC_URL) {
-    if (values.length * 8 > 8192) {
-        throw new Error("encryptU64Vector values exceed the 8,192-byte EUint64Vector payload");
-    }
-    const client = createEncryptClient(grpcUrl);
-    try {
-        const ciphertextBytes = Buffer.alloc(8192);
-        values.forEach((value, index) => {
-            const bigintValue = BigInt(value);
-            if (bigintValue < 0n || bigintValue > U64_MAX) {
-                throw new Error("encryptU64Vector values must fit in u64");
-            }
-            ciphertextBytes.writeBigUInt64LE(bigintValue, index * 8);
-        });
-        const result = await client.createInput({
-            chain: EncryptChain.Solana,
-            inputs: [
-                {
-                    ciphertextBytes,
-                    fheType: FHE_TYPE_UINT64_VECTOR,
-                },
-            ],
-            proof: Buffer.alloc(0),
-            authorized: authorized.toBuffer(),
-            networkEncryptionPublicKey: ENCRYPT_NETWORK_KEY,
-        });
-        const id = result.ciphertextIdentifiers[0];
-        if (!id || id.length !== 32) {
-            throw new Error("Encrypt service returned an invalid vector ciphertext identifier");
-        }
-        return new PublicKey(id);
-    }
-    finally {
-        client.close();
-    }
-}
 /**
  * Reads a decrypted ciphertext value from the Encrypt network.
  *

package/dist/ika.js.map

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

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;
+}[];