@aura-protocol/cli 0.1.0

package/dist/dashboard.js

@@ -0,0 +1,95 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text, useApp, useInput, render } from "ink";
+import React, { useEffect, useState } from "react";
+import { PublicKey } from "@solana/web3.js";
+import { formatTimestamp } from "./format.js";
+import { createTable } from "./output.js";
+import { getMessageApprovalState, parseCiphertextVerified, parseDecryptionReady, } from "./protocol.js";
+import { renderTreasurySections } from "./treasury-view.js";
+async function buildLivePanel(ctx, account) {
+    const pending = account.pending;
+    if (!pending) {
+        return undefined;
+    }
+    const table = createTable(["Live", "Value"]);
+    if (pending.policyOutputCiphertextAccount) {
+        const info = await ctx.connection.getAccountInfo(new PublicKey(pending.policyOutputCiphertextAccount), "confirmed");
+        table.push(["Policy output verified", parseCiphertextVerified(info) ? "Yes" : "No"]);
+    }
+    if (pending.decryptionRequest?.requestAccount) {
+        const info = await ctx.connection.getAccountInfo(new PublicKey(pending.decryptionRequest.requestAccount), "confirmed");
+        table.push(["Decryption ready", parseDecryptionReady(info) ? "Yes" : "No"]);
+    }
+    if (pending.signatureRequest?.messageApprovalAccount) {
+        const state = await getMessageApprovalState(ctx.connection, new PublicKey(pending.signatureRequest.messageApprovalAccount));
+        table.push(["Message approval", state]);
+    }
+    return table.length > 0 ? table.toString() : undefined;
+}
+async function readSnapshot(ctx, treasury) {
+    const account = await ctx.client.getTreasuryAccount(treasury);
+    return {
+        treasury,
+        account,
+        livePanel: await buildLivePanel(ctx, account),
+        refreshedAt: new Date(),
+    };
+}
+function Section(props) {
+    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: "cyan", paddingX: 1, marginBottom: 1, children: [_jsx(Text, { color: "cyanBright", children: props.title }), _jsx(Text, { children: props.body })] }));
+}
+function DashboardApp(props) {
+    const { exit } = useApp();
+    const [snapshot, setSnapshot] = useState(null);
+    const [error, setError] = useState(null);
+    const [refreshCount, setRefreshCount] = useState(0);
+    useEffect(() => {
+        let active = true;
+        let timer;
+        const refresh = async () => {
+            try {
+                const next = await readSnapshot(props.ctx, props.treasury);
+                if (!active) {
+                    return;
+                }
+                setSnapshot(next);
+                setError(null);
+            }
+            catch (nextError) {
+                if (!active) {
+                    return;
+                }
+                setError(nextError instanceof Error ? nextError.message : String(nextError));
+            }
+        };
+        void refresh();
+        timer = setInterval(() => {
+            void refresh();
+        }, props.intervalMs);
+        return () => {
+            active = false;
+            if (timer) {
+                clearInterval(timer);
+            }
+        };
+    }, [props.ctx, props.intervalMs, props.treasury, refreshCount]);
+    useInput((input, key) => {
+        if (input === "q" || key.escape || (key.ctrl && input === "c")) {
+            exit();
+            return;
+        }
+        if (input === "r") {
+            setRefreshCount((value) => value + 1);
+        }
+    });
+    if (!snapshot) {
+        return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: "cyanBright", children: "AURA Dashboard" }), _jsx(Text, { children: error ? `Loading failed: ${error}` : "Loading treasury state..." })] }));
+    }
+    const sections = renderTreasurySections(snapshot.treasury, snapshot.account);
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { marginBottom: 1, flexDirection: "column", children: [_jsx(Text, { color: "cyanBright", children: "AURA Dashboard" }), _jsxs(Text, { children: [snapshot.account.agentId, " | ", snapshot.treasury.toBase58(), " | refreshed", " ", formatTimestamp(Math.floor(snapshot.refreshedAt.getTime() / 1000))] }), _jsx(Text, { color: "gray", children: "Press r to refresh, q or Esc to quit." })] }), error ? (_jsx(Box, { marginBottom: 1, children: _jsxs(Text, { color: "red", children: ["Last refresh failed: ", error] }) })) : null, _jsx(Section, { title: "Overview", body: sections.overview }), _jsx(Section, { title: "Policy", body: sections.policy }), sections.confidential ? _jsx(Section, { title: "Confidential", body: sections.confidential }) : null, sections.pending ? _jsx(Section, { title: "Pending", body: sections.pending }) : null, snapshot.livePanel ? _jsx(Section, { title: "Live", body: snapshot.livePanel }) : null, sections.dwallets ? _jsx(Section, { title: "dWallets", body: sections.dwallets }) : null, sections.governance ? _jsx(Section, { title: "Governance", body: sections.governance }) : null] }));
+}
+export async function runDashboard(options) {
+    const app = render(_jsx(DashboardApp, { ctx: options.ctx, treasury: options.treasury, intervalMs: options.intervalMs }), { exitOnCtrlC: true });
+    await app.waitUntilExit();
+}
+//# sourceMappingURL=dashboard.js.map

package/dist/dashboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.js","sourceRoot":"","sources":["../src/dashboard.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC;AAC1D,OAAO,KAAK,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACnD,OAAO,EAAE,SAAS,EAAmC,MAAM,iBAAiB,CAAC;AAG7E,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAS5D,KAAK,UAAU,cAAc,CAC3B,GAAe,EACf,OAA8B;IAE9B,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAChC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAE7C,IAAI,OAAO,CAAC,6BAA6B,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC,cAAc,CAC9C,IAAI,SAAS,CAAC,OAAO,CAAC,6BAA6B,CAAC,EACpD,WAAW,CACZ,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,CAAC,wBAAwB,EAAE,uBAAuB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACvF,CAAC;IAED,IAAI,OAAO,CAAC,iBAAiB,EAAE,cAAc,EAAE,CAAC;QAC9C,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC,cAAc,CAC9C,IAAI,SAAS,CAAC,OAAO,CAAC,iBAAiB,CAAC,cAAc,CAAC,EACvD,WAAW,CACZ,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,CAAC,kBAAkB,EAAE,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9E,CAAC;IAED,IAAI,OAAO,CAAC,gBAAgB,EAAE,sBAAsB,EAAE,CAAC;QACrD,MAAM,KAAK,GAAG,MAAM,uBAAuB,CACzC,GAAG,CAAC,UAAU,EACd,IAAI,SAAS,CAAC,OAAO,CAAC,gBAAgB,CAAC,sBAAsB,CAAC,CAC/D,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AACzD,CAAC;AAED,KAAK,UAAU,YAAY,CACzB,GAAe,EACf,QAAuB;IAEvB,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAC9D,OAAO;QACL,QAAQ;QACR,OAAO;QACP,SAAS,EAAE,MAAM,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC;QAC7C,WAAW,EAAE,IAAI,IAAI,EAAE;KACxB,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,KAAsC;IACrD,OAAO,CACL,MAAC,GAAG,IAAC,aAAa,EAAC,QAAQ,EAAC,WAAW,EAAC,OAAO,EAAC,WAAW,EAAC,MAAM,EAAC,QAAQ,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,aAC7F,KAAC,IAAI,IAAC,KAAK,EAAC,YAAY,YAAE,KAAK,CAAC,KAAK,GAAQ,EAC7C,KAAC,IAAI,cAAE,KAAK,CAAC,IAAI,GAAQ,IACrB,CACP,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,KAIrB;IACC,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC;IAC1B,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAA2B,IAAI,CAAC,CAAC;IACzE,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IACxD,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAEpD,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,MAAM,GAAG,IAAI,CAAC;QAClB,IAAI,KAAiC,CAAC;QAEtC,MAAM,OAAO,GAAG,KAAK,IAAI,EAAE;YACzB,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;gBAC3D,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,OAAO;gBACT,CAAC;gBACD,WAAW,CAAC,IAAI,CAAC,CAAC;gBAClB,QAAQ,CAAC,IAAI,CAAC,CAAC;YACjB,CAAC;YAAC,OAAO,SAAS,EAAE,CAAC;gBACnB,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,OAAO;gBACT,CAAC;gBACD,QAAQ,CAAC,SAAS,YAAY,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;YAC/E,CAAC;QACH,CAAC,CAAC;QAEF,KAAK,OAAO,EAAE,CAAC;QACf,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;YACvB,KAAK,OAAO,EAAE,CAAC;QACjB,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;QAErB,OAAO,GAAG,EAAE;YACV,MAAM,GAAG,KAAK,CAAC;YACf,IAAI,KAAK,EAAE,CAAC;gBACV,aAAa,CAAC,KAAK,CAAC,CAAC;YACvB,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC;IAEhE,QAAQ,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QACtB,IAAI,KAAK,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,KAAK,KAAK,GAAG,CAAC,EAAE,CAAC;YAC/D,IAAI,EAAE,CAAC;YACP,OAAO;QACT,CAAC;QACD,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;YAClB,eAAe,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QACxC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,CACL,MAAC,GAAG,IAAC,aAAa,EAAC,QAAQ,aACzB,KAAC,IAAI,IAAC,KAAK,EAAC,YAAY,+BAAsB,EAC9C,KAAC,IAAI,cAAE,KAAK,CAAC,CAAC,CAAC,mBAAmB,KAAK,EAAE,CAAC,CAAC,CAAC,2BAA2B,GAAQ,IAC3E,CACP,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,sBAAsB,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IAE7E,OAAO,CACL,MAAC,GAAG,IAAC,aAAa,EAAC,QAAQ,aACzB,MAAC,GAAG,IAAC,YAAY,EAAE,CAAC,EAAE,aAAa,EAAC,QAAQ,aAC1C,KAAC,IAAI,IAAC,KAAK,EAAC,YAAY,+BAAsB,EAC9C,MAAC,IAAI,eACF,QAAQ,CAAC,OAAO,CAAC,OAAO,SAAK,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,kBAAc,GAAG,EAC1E,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC,IAC9D,EACP,KAAC,IAAI,IAAC,KAAK,EAAC,MAAM,sDAA6C,IAC3D,EAEL,KAAK,CAAC,CAAC,CAAC,CACP,KAAC,GAAG,IAAC,YAAY,EAAE,CAAC,YAClB,MAAC,IAAI,IAAC,KAAK,EAAC,KAAK,sCAAuB,KAAK,IAAQ,GACjD,CACP,CAAC,CAAC,CAAC,IAAI,EAER,KAAC,OAAO,IAAC,KAAK,EAAC,UAAU,EAAC,IAAI,EAAE,QAAQ,CAAC,QAAQ,GAAI,EACrD,KAAC,OAAO,IAAC,KAAK,EAAC,QAAQ,EAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,GAAI,EAChD,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,KAAC,OAAO,IAAC,KAAK,EAAC,cAAc,EAAC,IAAI,EAAE,QAAQ,CAAC,YAAY,GAAI,CAAC,CAAC,CAAC,IAAI,EAC5F,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,KAAC,OAAO,IAAC,KAAK,EAAC,SAAS,EAAC,IAAI,EAAE,QAAQ,CAAC,OAAO,GAAI,CAAC,CAAC,CAAC,IAAI,EAC7E,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,KAAC,OAAO,IAAC,KAAK,EAAC,MAAM,EAAC,IAAI,EAAE,QAAQ,CAAC,SAAS,GAAI,CAAC,CAAC,CAAC,IAAI,EAC9E,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAC,OAAO,IAAC,KAAK,EAAC,UAAU,EAAC,IAAI,EAAE,QAAQ,CAAC,QAAQ,GAAI,CAAC,CAAC,CAAC,IAAI,EAChF,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,KAAC,OAAO,IAAC,KAAK,EAAC,YAAY,EAAC,IAAI,EAAE,QAAQ,CAAC,UAAU,GAAI,CAAC,CAAC,CAAC,IAAI,IACnF,CACP,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAIlC;IACC,MAAM,GAAG,GAAG,MAAM,CAChB,KAAC,YAAY,IACX,GAAG,EAAE,OAAO,CAAC,GAAG,EAChB,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAC1B,UAAU,EAAE,OAAO,CAAC,UAAU,GAC9B,EACF,EAAE,WAAW,EAAE,IAAI,EAAE,CACtB,CAAC;IACF,MAAM,GAAG,CAAC,aAAa,EAAE,CAAC;AAC5B,CAAC"}

package/dist/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/domain.js

@@ -0,0 +1,86 @@
+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" },
+];
+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/domain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.js","sourceRoot":"","sources":["../src/domain.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,GAAG;IACb,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;IAC9C,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE;IAChD,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE;IAC5C,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;IAC9C,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE;IAChD,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE;CACxC,CAAC;AAEX,MAAM,QAAQ,GAAG;IACf,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE;IAChD,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE;IAClD,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,iBAAiB,EAAE;IAC9D,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,cAAc,EAAE;IACxD,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,sBAAsB,EAAE,KAAK,EAAE,sBAAsB,EAAE;CAChE,CAAC;AAEX,MAAM,iBAAiB,GAAG;IACxB,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE;IAC9B,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,sBAAsB,EAAE;IAC1C,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,oBAAoB,EAAE;IACxC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE;IAC9B,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE;IAC5B,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE;IAC/B,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE;CACrB,CAAC;AAEX,MAAM,UAAU,GAAG;IACjB,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE;IAC1B,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE;IAClC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE;IACjC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,uBAAuB,EAAE;IAC3C,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE;IACjC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE;IACpC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,sBAAsB,EAAE;IAC1C,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,mBAAmB,EAAE;IACvC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE;IACjC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,mBAAmB,EAAE;IACvC,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,mBAAmB,EAAE;CAChC,CAAC;AAEX,SAAS,QAAQ,CACf,IAAY,EACZ,OAAkE;IAElE,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,SAAS,CAChB,KAAsB,EACtB,OAAkE,EAClE,IAAY;IAEZ,MAAM,UAAU,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC1F,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IAClC,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,EAAE,CAAC;QAC/E,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CACxB,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,UAAU,IAAI,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,UAAU,CACjF,CAAC;IACF,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,KAAK,CAAC,IAAI,CAAC;IACpB,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED,SAAS,QAAQ,CACf,IAAY,EACZ,OAAmD,EACnD,QAAgB;IAEhB,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,KAAK,IAAI,QAAQ,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAsB;IAC/C,OAAO,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,IAAI,GAAG,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAsB;IACzD,OAAO,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,kBAAkB,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,OAAO,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,YAAY,IAAI,GAAG,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,OAAO,QAAQ,CAAC,IAAI,EAAE,iBAAiB,EAAE,YAAY,IAAI,GAAG,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,YAAY,IAAI,GAAG,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,OAAO,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,IAAI,IAAI,WAAW,IAAI,EAAE,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,IAAY;IACvD,OAAO,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,IAAI,IAAI,WAAW,IAAI,EAAE,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,0BAA0B;IACxC,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AAC7E,CAAC"}

package/dist/format.d.ts

@@ -0,0 +1,9 @@
+import { PublicKey } from "@solana/web3.js";
+export declare function formatUsd(value: unknown): string;
+export declare function formatPercentBps(value: unknown): string;
+export declare function formatPubkey(value: PublicKey | string | null | undefined, options?: {
+    shorten?: boolean;
+}): string;
+export declare function formatTimestamp(value: unknown): string;
+export declare function formatRelativeSeconds(targetSeconds: unknown): string;
+export declare function formatNullable(value: unknown): string;

package/dist/format.js

@@ -0,0 +1,92 @@
+import BN from "bn.js";
+import { PublicKey } from "@solana/web3.js";
+const usdFormatter = new Intl.NumberFormat("en-US", {
+    style: "currency",
+    currency: "USD",
+    minimumFractionDigits: 2,
+    maximumFractionDigits: 2,
+});
+function asBigInt(value) {
+    if (value === null || value === undefined) {
+        return null;
+    }
+    if (typeof value === "bigint") {
+        return value;
+    }
+    if (typeof value === "number") {
+        return BigInt(Math.trunc(value));
+    }
+    if (typeof value === "string" && value.trim().length > 0) {
+        return BigInt(value);
+    }
+    if (BN.isBN(value)) {
+        return BigInt(value.toString());
+    }
+    return null;
+}
+export function formatUsd(value) {
+    const normalized = asBigInt(value);
+    if (normalized === null) {
+        return "—";
+    }
+    return usdFormatter.format(Number(normalized));
+}
+export function formatPercentBps(value) {
+    const normalized = asBigInt(value);
+    if (normalized === null) {
+        return "—";
+    }
+    return `${(Number(normalized) / 100).toFixed(2)}%`;
+}
+export function formatPubkey(value, options = {}) {
+    if (!value) {
+        return "—";
+    }
+    const base58 = value instanceof PublicKey ? value.toBase58() : value;
+    if (options.shorten === false || base58.length <= 12) {
+        return base58;
+    }
+    return `${base58.slice(0, 4)}…${base58.slice(-4)}`;
+}
+export function formatTimestamp(value) {
+    const normalized = asBigInt(value);
+    if (normalized === null) {
+        return "—";
+    }
+    const millis = Number(normalized) * 1000;
+    return new Date(millis).toLocaleString("en-US", {
+        year: "numeric",
+        month: "short",
+        day: "2-digit",
+        hour: "2-digit",
+        minute: "2-digit",
+        second: "2-digit",
+    });
+}
+export function formatRelativeSeconds(targetSeconds) {
+    const normalized = asBigInt(targetSeconds);
+    if (normalized === null) {
+        return "—";
+    }
+    const diff = Number(normalized) - Math.floor(Date.now() / 1000);
+    const abs = Math.abs(diff);
+    const hours = Math.floor(abs / 3600);
+    const minutes = Math.floor((abs % 3600) / 60);
+    const seconds = abs % 60;
+    const parts = [
+        hours > 0 ? `${hours}h` : null,
+        minutes > 0 ? `${minutes}m` : null,
+        `${seconds}s`,
+    ].filter(Boolean);
+    return diff >= 0 ? `in ${parts.join(" ")}` : `${parts.join(" ")} ago`;
+}
+export function formatNullable(value) {
+    if (value === null || value === undefined || value === "") {
+        return "—";
+    }
+    if (typeof value === "boolean") {
+        return value ? "Yes" : "No";
+    }
+    return String(value);
+}
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

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

package/dist/ika.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Thin wrappers around the Ika Encrypt and dWallet gRPC clients.
+ *
+ * Both clients are pre-alpha — data is public plaintext on-chain, no real
+ * FHE or MPC security yet. The interfaces match the Rust smoke tests in
+ * smoke/aura-devnet/ so the full confidential + execution flow works end-to-end.
+ *
+ * Encrypt gRPC: pre-alpha-dev-1.encrypt.ika-network.net:443
+ * dWallet gRPC: pre-alpha-dev-1.ika.ika-network.net:443
+ */
+import { PublicKey } from "@solana/web3.js";
+import { DEVNET_PRE_ALPHA_GRPC_URL as ENCRYPT_GRPC_URL } from "./vendor/encrypt/grpc.js";
+declare const IKA_GRPC_URL = "pre-alpha-dev-1.ika.ika-network.net:443";
+export { ENCRYPT_GRPC_URL, IKA_GRPC_URL };
+/**
+ * The 32-byte network encryption public key used by the pre-alpha Encrypt service.
+ * Matches `ENCRYPT_NETWORK_KEY` in the Rust smoke tests.
+ */
+export declare const ENCRYPT_NETWORK_KEY: Buffer<ArrayBuffer>;
+/**
+ * Encrypts a single u64 value via the Ika Encrypt gRPC service and returns
+ * the on-chain ciphertext account pubkey.
+ *
+ * In pre-alpha mode the value is stored as plaintext — no real FHE yet.
+ * The returned pubkey is the `handlePda` that must be verified on-chain
+ * before it can be used in a confidential proposal.
+ *
+ * @param value       The u64 value to encrypt (as a number or bigint).
+ * @param authorized  The Solana pubkey authorized to use this ciphertext
+ *                    (typically the AURA program ID).
+ * @param grpcUrl     Override the gRPC endpoint (defaults to devnet pre-alpha).
+ */
+export declare function encryptU64(value: number | bigint, authorized: PublicKey, grpcUrl?: string): Promise<PublicKey>;
+/**
+ * Encrypts multiple u64 values in a single gRPC call (more efficient than
+ * calling `encryptU64` separately for each value).
+ *
+ * Returns one pubkey per input value in the same order.
+ */
+export declare function encryptU64Batch(values: (number | bigint)[], authorized: PublicKey, grpcUrl?: string): Promise<PublicKey[]>;
+/**
+ * Reads a decrypted ciphertext value from the Encrypt network.
+ *
+ * In pre-alpha mode this returns the plaintext directly.
+ * The returned buffer contains the raw bytes (8 bytes for u64 LE).
+ *
+ * @param ciphertextId  The on-chain ciphertext account pubkey.
+ * @param signer        The pubkey authorized to read this ciphertext.
+ * @param grpcUrl       Override the gRPC endpoint.
+ */
+export declare function readCiphertext(ciphertextId: PublicKey, signer: PublicKey, grpcUrl?: string): Promise<{
+    value: Buffer;
+    fheType: number;
+    digest: Buffer;
+}>;
+/**
+ * Reads a u64 ciphertext and returns the decoded value.
+ * Convenience wrapper around `readCiphertext` for u64 values.
+ */
+export declare function readU64Ciphertext(ciphertextId: PublicKey, signer: PublicKey, grpcUrl?: string): Promise<bigint>;
+/**
+ * Drives the dWallet presign + sign flow via the Ika dWallet gRPC service.
+ *
+ * This is called after `execute_pending` creates the `MessageApproval` account
+ * on-chain. The dWallet network processes the presign and sign requests and
+ * writes the signature back to the `MessageApproval` account.
+ *
+ * @param senderPubkey  The Solana pubkey of the transaction sender (payer).
+ * @param dwalletAddr   The on-chain dWallet account pubkey (32 bytes).
+ * @param message       The message bytes to sign (keccak256 digest of the proposal).
+ * @param txSignature   The Solana transaction signature from `execute_pending`
+ *                      (used as the approval proof).
+ * @param grpcUrl       Override the gRPC endpoint.
+ * @returns The dWallet signature bytes.
+ */
+export declare function requestDwalletSign(senderPubkey: PublicKey, dwalletAddr: PublicKey, message: Buffer, txSignature: Buffer, grpcUrl?: string): Promise<Buffer>;

package/dist/ika.js

@@ -0,0 +1,178 @@
+/**
+ * Thin wrappers around the Ika Encrypt and dWallet gRPC clients.
+ *
+ * Both clients are pre-alpha — data is public plaintext on-chain, no real
+ * FHE or MPC security yet. The interfaces match the Rust smoke tests in
+ * smoke/aura-devnet/ so the full confidential + execution flow works end-to-end.
+ *
+ * Encrypt gRPC: pre-alpha-dev-1.encrypt.ika-network.net:443
+ * dWallet gRPC: pre-alpha-dev-1.ika.ika-network.net:443
+ */
+import { PublicKey } from "@solana/web3.js";
+import { createEncryptClient, encodeReadCiphertextMessage, Chain as EncryptChain, DEVNET_PRE_ALPHA_GRPC_URL as ENCRYPT_GRPC_URL, } from "./vendor/encrypt/grpc.js";
+import { createIkaClient, } from "./vendor/ika/grpc.js";
+const IKA_GRPC_URL = "pre-alpha-dev-1.ika.ika-network.net:443";
+export { ENCRYPT_GRPC_URL, IKA_GRPC_URL };
+/**
+ * FHE type for u64 values — matches `ENCRYPT_FHE_UINT64` in the Rust program.
+ * In pre-alpha mode the Encrypt executor accepts any value here.
+ */
+const FHE_TYPE_UINT64 = 0;
+/**
+ * The 32-byte network encryption public key used by the pre-alpha Encrypt service.
+ * Matches `ENCRYPT_NETWORK_KEY` in the Rust smoke tests.
+ */
+export const ENCRYPT_NETWORK_KEY = Buffer.alloc(32, 0x55);
+/**
+ * Encrypts a single u64 value via the Ika Encrypt gRPC service and returns
+ * the on-chain ciphertext account pubkey.
+ *
+ * In pre-alpha mode the value is stored as plaintext — no real FHE yet.
+ * The returned pubkey is the `handlePda` that must be verified on-chain
+ * before it can be used in a confidential proposal.
+ *
+ * @param value       The u64 value to encrypt (as a number or bigint).
+ * @param authorized  The Solana pubkey authorized to use this ciphertext
+ *                    (typically the AURA program ID).
+ * @param grpcUrl     Override the gRPC endpoint (defaults to devnet pre-alpha).
+ */
+export async function encryptU64(value, authorized, grpcUrl = ENCRYPT_GRPC_URL) {
+    const client = createEncryptClient(grpcUrl);
+    try {
+        // Encode the value as 8 little-endian bytes (u64 LE)
+        const valueBuf = Buffer.alloc(8);
+        valueBuf.writeBigUInt64LE(BigInt(value), 0);
+        const result = await client.createInput({
+            chain: EncryptChain.Solana,
+            inputs: [
+                {
+                    ciphertextBytes: valueBuf,
+                    fheType: FHE_TYPE_UINT64,
+                },
+            ],
+            proof: Buffer.alloc(0),
+            authorized: authorized.toBuffer(),
+            networkEncryptionPublicKey: ENCRYPT_NETWORK_KEY,
+        });
+        if (!result.ciphertextIdentifiers[0] || result.ciphertextIdentifiers[0].length !== 32) {
+            throw new Error("Encrypt service returned an invalid ciphertext identifier");
+        }
+        return new PublicKey(result.ciphertextIdentifiers[0]);
+    }
+    finally {
+        client.close();
+    }
+}
+/**
+ * Encrypts multiple u64 values in a single gRPC call (more efficient than
+ * calling `encryptU64` separately for each value).
+ *
+ * Returns one pubkey per input value in the same order.
+ */
+export async function encryptU64Batch(values, authorized, grpcUrl = ENCRYPT_GRPC_URL) {
+    if (values.length === 0) {
+        return [];
+    }
+    const client = createEncryptClient(grpcUrl);
+    try {
+        const inputs = values.map((value) => {
+            const valueBuf = Buffer.alloc(8);
+            valueBuf.writeBigUInt64LE(BigInt(value), 0);
+            return { ciphertextBytes: valueBuf, fheType: FHE_TYPE_UINT64 };
+        });
+        const result = await client.createInput({
+            chain: EncryptChain.Solana,
+            inputs,
+            proof: Buffer.alloc(0),
+            authorized: authorized.toBuffer(),
+            networkEncryptionPublicKey: ENCRYPT_NETWORK_KEY,
+        });
+        if (result.ciphertextIdentifiers.length !== values.length) {
+            throw new Error(`Encrypt service returned ${result.ciphertextIdentifiers.length} identifiers for ${values.length} inputs`);
+        }
+        return result.ciphertextIdentifiers.map((id) => {
+            if (!id || id.length !== 32) {
+                throw new Error("Encrypt service returned an invalid ciphertext identifier");
+            }
+            return new PublicKey(id);
+        });
+    }
+    finally {
+        client.close();
+    }
+}
+/**
+ * Reads a decrypted ciphertext value from the Encrypt network.
+ *
+ * In pre-alpha mode this returns the plaintext directly.
+ * The returned buffer contains the raw bytes (8 bytes for u64 LE).
+ *
+ * @param ciphertextId  The on-chain ciphertext account pubkey.
+ * @param signer        The pubkey authorized to read this ciphertext.
+ * @param grpcUrl       Override the gRPC endpoint.
+ */
+export async function readCiphertext(ciphertextId, signer, grpcUrl = ENCRYPT_GRPC_URL) {
+    const client = createEncryptClient(grpcUrl);
+    try {
+        // Build a BCS-encoded ReadCiphertextMessage
+        // In pre-alpha, signature and reencryption key can be zero-filled
+        const message = encodeReadCiphertextMessage(0, // chain = Solana
+        ciphertextId.toBuffer(), Buffer.alloc(32), // zero reencryption key (pre-alpha: plaintext returned directly)
+        1n);
+        const result = await client.readCiphertext({
+            message,
+            signature: Buffer.alloc(64), // zero signature (pre-alpha: not validated)
+            signer: signer.toBuffer(),
+        });
+        return {
+            value: result.value,
+            fheType: result.fheType,
+            digest: result.digest,
+        };
+    }
+    finally {
+        client.close();
+    }
+}
+/**
+ * Reads a u64 ciphertext and returns the decoded value.
+ * Convenience wrapper around `readCiphertext` for u64 values.
+ */
+export async function readU64Ciphertext(ciphertextId, signer, grpcUrl = ENCRYPT_GRPC_URL) {
+    const { value } = await readCiphertext(ciphertextId, signer, grpcUrl);
+    if (value.length < 8) {
+        throw new Error(`Expected 8 bytes for u64, got ${value.length}`);
+    }
+    return value.readBigUInt64LE(0);
+}
+/**
+ * Drives the dWallet presign + sign flow via the Ika dWallet gRPC service.
+ *
+ * This is called after `execute_pending` creates the `MessageApproval` account
+ * on-chain. The dWallet network processes the presign and sign requests and
+ * writes the signature back to the `MessageApproval` account.
+ *
+ * @param senderPubkey  The Solana pubkey of the transaction sender (payer).
+ * @param dwalletAddr   The on-chain dWallet account pubkey (32 bytes).
+ * @param message       The message bytes to sign (keccak256 digest of the proposal).
+ * @param txSignature   The Solana transaction signature from `execute_pending`
+ *                      (used as the approval proof).
+ * @param grpcUrl       Override the gRPC endpoint.
+ * @returns The dWallet signature bytes.
+ */
+export async function requestDwalletSign(senderPubkey, dwalletAddr, message, txSignature, grpcUrl = IKA_GRPC_URL) {
+    const client = createIkaClient(grpcUrl);
+    try {
+        const senderBytes = senderPubkey.toBuffer();
+        const dwalletBytes = dwalletAddr.toBuffer();
+        // Step 1: request presign
+        const presignId = await client.requestPresign(senderBytes, dwalletBytes);
+        // Step 2: request sign with the presign ID and approval proof
+        const signature = await client.requestSign(senderBytes, dwalletBytes, message, presignId, txSignature);
+        return Buffer.from(signature);
+    }
+    finally {
+        client.close();
+    }
+}
+//# sourceMappingURL=ika.js.map

package/dist/ika.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function createProgram(): Command;
+export declare function main(argv?: string[]): Promise<void>;

package/dist/index.js

@@ -0,0 +1,43 @@
+import { Command } from "commander";
+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 { registerGovernanceCommands } from "./commands/governance.js";
+import { registerTreasuryCommands } from "./commands/treasury.js";
+import { printError } from "./output.js";
+export function createProgram() {
+    const program = new Command();
+    program
+        .name("aura")
+        .description("Production-grade CLI for the AURA autonomous treasury program")
+        .version("0.1.0")
+        .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("--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");
+    registerConfigCommands(program);
+    registerTreasuryCommands(program);
+    registerDwalletCommands(program);
+    registerConfidentialCommands(program);
+    registerExecutionCommands(program);
+    registerGovernanceCommands(program);
+    registerDashboardCommand(program);
+    return program;
+}
+export async function main(argv = process.argv) {
+    try {
+        await createProgram().parseAsync(argv);
+    }
+    catch (error) {
+        printError(error);
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,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,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,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,CAAC;IAE5E,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,0BAA0B,CAAC,OAAO,CAAC,CAAC;IACpC,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"}