@usesigil/kit 0.1.0

package/dist/policies.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Kit-native policy engine for Sigil.
+ */
+import type { Address } from "@solana/kit";
+import * as Core from "./core/index.js";
+import { type Network } from "./types.js";
+export type { RateLimitConfig, PolicyCheckResult } from "./core/index.js";
+export { DEFAULT_POLICIES, parseSpendLimit } from "./core/index.js";
+/** Policy configuration for the Sigil wrapper (accepts Address or string) */
+export interface ShieldPolicies {
+    /** Maximum spend per rolling 24h window, per token. e.g. "500 USDC/day" or { mint, amount } */
+    maxSpend?: SpendLimit | SpendLimit[] | string | string[];
+    /** Maximum single transaction size in lamports-equivalent value */
+    maxTransactionSize?: bigint | string;
+    /** Allowed protocol program IDs. If set, only these + system programs are allowed. */
+    allowedProtocols?: (Address | string)[];
+    /** Allowed token mints for transfers. If set, only these tokens can be sent. */
+    allowedTokens?: (Address | string)[];
+    /** Block unknown (unregistered) program IDs. Default: true */
+    blockUnknownPrograms?: boolean;
+    /** Maximum transactions per time window */
+    rateLimit?: Core.RateLimitConfig;
+    /** Custom policy evaluation hook — runs AFTER built-in checks */
+    customCheck?: (analysis: TransactionAnalysis) => Core.PolicyCheckResult;
+}
+export interface SpendLimit {
+    /** SPL token mint address */
+    mint: Address | string;
+    /** Maximum amount in token's native decimals (e.g. 500_000_000 for 500 USDC) */
+    amount: bigint;
+    /** Window duration in milliseconds. Default: 86_400_000 (24h) */
+    windowMs?: number;
+}
+/** Analysis of a transaction's contents, passed to policy engine and custom checks */
+export interface TransactionAnalysis {
+    /** Program IDs invoked by the transaction */
+    programIds: Address[];
+    /** Token transfers detected in the transaction */
+    transfers: TokenTransfer[];
+    /** Total estimated value of outgoing transfers, in lamports-equivalent */
+    estimatedValueLamports: bigint;
+}
+export interface TokenTransfer {
+    mint: Address;
+    amount: bigint;
+    /** "outgoing" = tokens leaving the wallet, "incoming" = tokens arriving */
+    direction: "outgoing" | "incoming" | "unknown";
+    /** Destination account */
+    destination?: Address;
+}
+/** Internal resolved policy representation (extends core with customCheck) */
+export interface ResolvedPolicies extends Core.ResolvedPolicies {
+    customCheck: ((analysis: TransactionAnalysis) => Core.PolicyCheckResult) | undefined;
+}
+/**
+ * Normalize user-provided policies into a resolved internal format.
+ * Kit Address is already a string, so conversion is trivial.
+ */
+export declare function resolvePolicies(input?: ShieldPolicies): ResolvedPolicies;
+/**
+ * Convert wrapper TransactionAnalysis (Address-based) to core format (string-based).
+ * Trivial since Kit Address IS a string.
+ */
+export declare function toCoreAnalysis(analysis: TransactionAnalysis): Core.TransactionAnalysis;
+/**
+ * Validate that spend limit mints are recognized stablecoins.
+ * Returns warnings for unrecognized mints (does not throw).
+ */
+export declare function validateSpendLimitMints(resolved: ResolvedPolicies, network: Network): string[];
+//# sourceMappingURL=policies.d.ts.map

package/dist/policies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policies.d.ts","sourceRoot":"","sources":["../src/policies.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AACxC,OAAO,EAAoB,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAG5D,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEpE,6EAA6E;AAC7E,MAAM,WAAW,cAAc;IAC7B,+FAA+F;IAC/F,QAAQ,CAAC,EAAE,UAAU,GAAG,UAAU,EAAE,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC;IACzD,mEAAmE;IACnE,kBAAkB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACrC,sFAAsF;IACtF,gBAAgB,CAAC,EAAE,CAAC,OAAO,GAAG,MAAM,CAAC,EAAE,CAAC;IACxC,gFAAgF;IAChF,aAAa,CAAC,EAAE,CAAC,OAAO,GAAG,MAAM,CAAC,EAAE,CAAC;IACrC,8DAA8D;IAC9D,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,2CAA2C;IAC3C,SAAS,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC;IACjC,iEAAiE;IACjE,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,mBAAmB,KAAK,IAAI,CAAC,iBAAiB,CAAC;CACzE;AAED,MAAM,WAAW,UAAU;IACzB,6BAA6B;IAC7B,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IACvB,gFAAgF;IAChF,MAAM,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,sFAAsF;AACtF,MAAM,WAAW,mBAAmB;IAClC,6CAA6C;IAC7C,UAAU,EAAE,OAAO,EAAE,CAAC;IACtB,kDAAkD;IAClD,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,0EAA0E;IAC1E,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,SAAS,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;IAC/C,0BAA0B;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,8EAA8E;AAC9E,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAAC,gBAAgB;IAC7D,WAAW,EACP,CAAC,CAAC,QAAQ,EAAE,mBAAmB,KAAK,IAAI,CAAC,iBAAiB,CAAC,GAC3D,SAAS,CAAC;CACf;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,CAAC,EAAE,cAAc,GAAG,gBAAgB,CAsBxE;AA2BD;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,mBAAmB,GAC5B,IAAI,CAAC,mBAAmB,CAW1B;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,EAAE,OAAO,GACf,MAAM,EAAE,CAYV"}

package/dist/policies.js

@@ -0,0 +1,87 @@
+/**
+ * Kit-native policy engine for Sigil.
+ */
+import * as Core from "./core/index.js";
+import { isStablecoinMint } from "./types.js";
+export { DEFAULT_POLICIES, parseSpendLimit } from "./core/index.js";
+/**
+ * Normalize user-provided policies into a resolved internal format.
+ * Kit Address is already a string, so conversion is trivial.
+ */
+export function resolvePolicies(input) {
+    const coreInput = input
+        ? {
+            maxSpend: input.maxSpend !== undefined
+                ? convertSpendLimits(input.maxSpend)
+                : undefined,
+            maxTransactionSize: input.maxTransactionSize,
+            // Address is already a string — direct pass-through
+            allowedProtocols: input.allowedProtocols?.map((p) => p),
+            allowedTokens: input.allowedTokens?.map((t) => t),
+            blockUnknownPrograms: input.blockUnknownPrograms,
+            rateLimit: input.rateLimit,
+        }
+        : undefined;
+    const coreResolved = Core.resolvePolicies(coreInput);
+    return {
+        ...coreResolved,
+        customCheck: input?.customCheck ?? undefined,
+    };
+}
+/** Convert SpendLimit (Address | string mint) to core SpendLimit (string mint) */
+function convertSpendLimits(input) {
+    if (typeof input === "string")
+        return input;
+    if (Array.isArray(input)) {
+        if (input.every((l) => typeof l === "string")) {
+            return input;
+        }
+        return input.map((l) => {
+            if (typeof l === "string")
+                return Core.parseSpendLimit(l);
+            return {
+                mint: l.mint,
+                amount: l.amount,
+                windowMs: l.windowMs,
+            };
+        });
+    }
+    return {
+        mint: input.mint,
+        amount: input.amount,
+        windowMs: input.windowMs,
+    };
+}
+/**
+ * Convert wrapper TransactionAnalysis (Address-based) to core format (string-based).
+ * Trivial since Kit Address IS a string.
+ */
+export function toCoreAnalysis(analysis) {
+    return {
+        programIds: analysis.programIds.map((p) => p),
+        transfers: analysis.transfers.map((t) => ({
+            mint: t.mint,
+            amount: t.amount,
+            direction: t.direction,
+            destination: t.destination,
+        })),
+        estimatedValueLamports: analysis.estimatedValueLamports,
+    };
+}
+/**
+ * Validate that spend limit mints are recognized stablecoins.
+ * Returns warnings for unrecognized mints (does not throw).
+ */
+export function validateSpendLimitMints(resolved, network) {
+    const warnings = [];
+    if (!resolved.spendLimits)
+        return warnings;
+    for (const limit of resolved.spendLimits) {
+        if (!isStablecoinMint(limit.mint, network)) {
+            warnings.push(`Spend limit mint ${limit.mint} is not a recognized stablecoin on ${network}. ` +
+                `On-chain enforcement uses stablecoin-only USD tracking.`);
+        }
+    }
+    return warnings;
+}
+//# sourceMappingURL=policies.js.map

package/dist/policies.js.map

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

package/dist/portfolio-analytics.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Portfolio analytics — cross-vault aggregation for the portfolio page.
+ *
+ * getPortfolioOverview() is the most expensive SDK call — it resolves ALL
+ * vaults for an owner. The dashboard caches this with 30s stale time.
+ */
+import type { Address, Rpc, SolanaRpcApi } from "@solana/kit";
+import type { ResolvedVaultState } from "./state-resolver.js";
+import { type VaultSummary } from "./vault-analytics.js";
+import { type Alert } from "./security-analytics.js";
+import type { Network } from "./types.js";
+export interface PortfolioOverview {
+    vaults: VaultSummary[];
+    totals: {
+        vaultCount: number;
+        activeVaultCount: number;
+        totalValueUsd: bigint;
+        totalAgents: number;
+        totalSpend24h: bigint;
+        totalVolume: bigint;
+        totalFeesCollected: bigint;
+        totalPnl: bigint;
+        totalDeposited: bigint;
+        totalWithdrawn: bigint;
+        overallPnlPercent: number;
+    };
+    topVaultByValue: Address | null;
+    topVaultBySpending: Address | null;
+    alerts: Alert[];
+}
+/** Aggregate VaultSummary[] into portfolio totals. Pure function. */
+export declare function aggregatePortfolio(vaults: VaultSummary[]): Omit<PortfolioOverview, "alerts">;
+/**
+ * Cross-vault aggregated analytics for the portfolio page.
+ * N+1 RPC calls: 1 discovery + N vault summaries (parallel).
+ */
+export declare function getPortfolioOverview(rpc: Rpc<SolanaRpcApi>, owner: Address, network?: Network): Promise<PortfolioOverview>;
+export interface CrossVaultAgentRanking {
+    agent: Address;
+    vaultAddress: Address;
+    vaultId: bigint;
+    spend24h: bigint;
+    lifetimeSpend: bigint;
+    capUtilization: number;
+    paused: boolean;
+    rank: number;
+}
+/**
+ * Rank all agents across all vaults by 24h spend.
+ * Aggregates what getAgentLeaderboard does per-vault into a portfolio-wide ranking.
+ */
+export declare function getCrossVaultAgentRanking(overview: PortfolioOverview): CrossVaultAgentRanking[];
+/**
+ * Rank agents across multiple pre-resolved vault states.
+ * Convenience wrapper when you have ResolvedVaultState[] but not a full PortfolioOverview.
+ *
+ * For the full portfolio pipeline, use getPortfolioOverview() + getCrossVaultAgentRanking().
+ */
+export declare function getAgentLeaderboardAcrossVaults(vaultStates: Array<{
+    address: Address;
+    state: ResolvedVaultState;
+}>): CrossVaultAgentRanking[];
+export interface PortfolioTimeSeries {
+    /** Aggregated spending per epoch across all vaults */
+    spendingByEpoch: Array<{
+        timestamp: number;
+        totalUsd: bigint;
+        vaultBreakdown: Map<Address, bigint>;
+    }>;
+    totalSpend24h: bigint;
+    totalCap24h: bigint;
+    utilization: number;
+}
+/**
+ * Aggregated spending time-series across all vaults for portfolio-level charts.
+ * Merges per-vault SpendTracker histories into one combined timeline.
+ */
+export declare function getPortfolioTimeSeries(vaultStates: Array<{
+    address: Address;
+    state: ResolvedVaultState;
+}>, nowUnix: bigint): PortfolioTimeSeries;
+//# sourceMappingURL=portfolio-analytics.d.ts.map

package/dist/portfolio-analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portfolio-analytics.d.ts","sourceRoot":"","sources":["../src/portfolio-analytics.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAO9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAA2B,KAAK,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAC9E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAI1C,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,MAAM,EAAE;QACN,UAAU,EAAE,MAAM,CAAC;QACnB,gBAAgB,EAAE,MAAM,CAAC;QACzB,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,MAAM,CAAC;QACpB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,QAAQ,EAAE,MAAM,CAAC;QACjB,cAAc,EAAE,MAAM,CAAC;QACvB,cAAc,EAAE,MAAM,CAAC;QACvB,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF,eAAe,EAAE,OAAO,GAAG,IAAI,CAAC;IAChC,kBAAkB,EAAE,OAAO,GAAG,IAAI,CAAC;IACnC,MAAM,EAAE,KAAK,EAAE,CAAC;CACjB;AAID,qEAAqE;AACrE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CA0E5F;AAID;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,GAAG,CAAC,YAAY,CAAC,EACtB,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,OAAwB,GAChC,OAAO,CAAC,iBAAiB,CAAC,CAuB5B;AAID,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,iBAAiB,GAC1B,sBAAsB,EAAE,CAgD1B;AAID;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,WAAW,EAAE,KAAK,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,kBAAkB,CAAA;CAAE,CAAC,GAClE,sBAAsB,EAAE,CA8C1B;AAID,MAAM,WAAW,mBAAmB;IAClC,sDAAsD;IACtD,eAAe,EAAE,KAAK,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,cAAc,EAAE,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;KACtC,CAAC,CAAC;IACH,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,KAAK,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,kBAAkB,CAAA;CAAE,CAAC,EACnE,OAAO,EAAE,MAAM,GACd,mBAAmB,CA4CrB"}

package/dist/portfolio-analytics.js

@@ -0,0 +1,232 @@
+/**
+ * Portfolio analytics — cross-vault aggregation for the portfolio page.
+ *
+ * getPortfolioOverview() is the most expensive SDK call — it resolves ALL
+ * vaults for an owner. The dashboard caches this with 30s stale time.
+ */
+import { findVaultsByOwner, bytesToAddress, getSpendingHistory, } from "./state-resolver.js";
+import { getVaultSummary } from "./vault-analytics.js";
+import { evaluateAlertConditions } from "./security-analytics.js";
+// ─── Helpers (exported for testing) ──────────────────────────────────────────
+/** Aggregate VaultSummary[] into portfolio totals. Pure function. */
+export function aggregatePortfolio(vaults) {
+    if (vaults.length === 0) {
+        return {
+            vaults: [],
+            totals: {
+                vaultCount: 0, activeVaultCount: 0, totalValueUsd: 0n, totalAgents: 0,
+                totalSpend24h: 0n, totalVolume: 0n, totalFeesCollected: 0n,
+                totalPnl: 0n, totalDeposited: 0n, totalWithdrawn: 0n, overallPnlPercent: 0,
+            },
+            topVaultByValue: null,
+            topVaultBySpending: null,
+        };
+    }
+    let totalValueUsd = 0n;
+    let totalAgents = 0;
+    let totalSpend24h = 0n;
+    let totalVolume = 0n;
+    let totalFeesCollected = 0n;
+    let totalPnl = 0n;
+    let totalDeposited = 0n;
+    let totalWithdrawn = 0n;
+    let activeVaultCount = 0;
+    let topValueAddr = null;
+    let topValue = 0n;
+    let topSpendAddr = null;
+    let topSpend = 0n;
+    for (const v of vaults) {
+        totalValueUsd += v.totalValueUsd;
+        totalAgents += v.health.agentCount;
+        totalSpend24h += v.state.globalBudget.spent24h;
+        totalVolume += v.stats.totalVolume;
+        totalFeesCollected += v.stats.totalFeesCollected;
+        totalPnl += v.pnl.pnl;
+        totalDeposited += v.pnl.totalDeposited;
+        totalWithdrawn += v.pnl.totalWithdrawn;
+        if (v.health.status === "Active")
+            activeVaultCount++;
+        if (v.totalValueUsd > topValue) {
+            topValue = v.totalValueUsd;
+            topValueAddr = v.address;
+        }
+        if (v.state.globalBudget.spent24h > topSpend) {
+            topSpend = v.state.globalBudget.spent24h;
+            topSpendAddr = v.address;
+        }
+    }
+    const netInvestment = totalDeposited - totalWithdrawn;
+    const overallPnlPercent = netInvestment > 0n
+        ? Number((totalPnl * 10000n) / netInvestment) / 100
+        : 0;
+    return {
+        vaults,
+        totals: {
+            vaultCount: vaults.length,
+            activeVaultCount,
+            totalValueUsd,
+            totalAgents,
+            totalSpend24h,
+            totalVolume,
+            totalFeesCollected,
+            totalPnl,
+            totalDeposited,
+            totalWithdrawn,
+            overallPnlPercent,
+        },
+        topVaultByValue: topValueAddr,
+        topVaultBySpending: topSpendAddr,
+    };
+}
+// ─── getPortfolioOverview ────────────────────────────────────────────────────
+/**
+ * Cross-vault aggregated analytics for the portfolio page.
+ * N+1 RPC calls: 1 discovery + N vault summaries (parallel).
+ */
+export async function getPortfolioOverview(rpc, owner, network = "mainnet-beta") {
+    const discovered = await findVaultsByOwner(rpc, owner);
+    if (discovered.length === 0) {
+        return { ...aggregatePortfolio([]), alerts: [] };
+    }
+    // Use allSettled so one failed vault doesn't kill the entire portfolio
+    const results = await Promise.allSettled(discovered.map((v) => getVaultSummary(rpc, v.vaultAddress, network)));
+    const vaults = results
+        .filter((r) => r.status === "fulfilled")
+        .map((r) => r.value);
+    const portfolio = aggregatePortfolio(vaults);
+    const allAlerts = [];
+    for (const v of vaults) {
+        allAlerts.push(...evaluateAlertConditions(v.state, v.address));
+    }
+    return { ...portfolio, alerts: allAlerts };
+}
+/**
+ * Rank all agents across all vaults by 24h spend.
+ * Aggregates what getAgentLeaderboard does per-vault into a portfolio-wide ranking.
+ */
+export function getCrossVaultAgentRanking(overview) {
+    const allAgents = [];
+    for (const vault of overview.vaults) {
+        for (const [agentAddr, budget] of vault.state.allAgentBudgets) {
+            const agentEntry = vault.state.vault.agents.find((a) => a.pubkey === agentAddr);
+            if (!agentEntry)
+                continue;
+            let lifetimeSpend = 0n;
+            if (vault.state.overlay) {
+                const slotIdx = vault.state.overlay.entries.findIndex((e) => {
+                    try {
+                        return bytesToAddress(e.agent) === agentAddr;
+                    }
+                    catch {
+                        return false;
+                    }
+                });
+                if (slotIdx >= 0 && slotIdx < vault.state.overlay.lifetimeSpend.length) {
+                    lifetimeSpend = vault.state.overlay.lifetimeSpend[slotIdx];
+                }
+            }
+            allAgents.push({
+                agent: agentAddr,
+                vaultAddress: vault.address,
+                vaultId: vault.vaultId,
+                spend24h: budget.spent24h,
+                lifetimeSpend,
+                capUtilization: budget.cap > 0n
+                    ? Number((budget.spent24h * 10000n) / budget.cap) / 100
+                    : 0,
+                paused: agentEntry.paused,
+                rank: 0,
+            });
+        }
+    }
+    allAgents.sort((a, b) => b.spend24h > a.spend24h ? 1 : b.spend24h < a.spend24h ? -1 : 0);
+    allAgents.forEach((a, i) => {
+        a.rank = i + 1;
+    });
+    return allAgents;
+}
+// ─── getAgentLeaderboardAcrossVaults ─────────────────────────────────────────
+/**
+ * Rank agents across multiple pre-resolved vault states.
+ * Convenience wrapper when you have ResolvedVaultState[] but not a full PortfolioOverview.
+ *
+ * For the full portfolio pipeline, use getPortfolioOverview() + getCrossVaultAgentRanking().
+ */
+export function getAgentLeaderboardAcrossVaults(vaultStates) {
+    const allAgents = [];
+    for (const { address: vaultAddress, state } of vaultStates) {
+        for (const [agentAddr, budget] of state.allAgentBudgets) {
+            const agentEntry = state.vault.agents.find((a) => a.pubkey === agentAddr);
+            if (!agentEntry)
+                continue;
+            let lifetimeSpend = 0n;
+            if (state.overlay) {
+                const slotIdx = state.overlay.entries.findIndex((e) => {
+                    try {
+                        return bytesToAddress(e.agent) === agentAddr;
+                    }
+                    catch {
+                        return false;
+                    }
+                });
+                if (slotIdx >= 0 && slotIdx < state.overlay.lifetimeSpend.length) {
+                    lifetimeSpend = state.overlay.lifetimeSpend[slotIdx];
+                }
+            }
+            allAgents.push({
+                agent: agentAddr,
+                vaultAddress,
+                vaultId: state.vault.vaultId,
+                spend24h: budget.spent24h,
+                lifetimeSpend,
+                capUtilization: budget.cap > 0n
+                    ? Number((budget.spent24h * 10000n) / budget.cap) / 100
+                    : 0,
+                paused: agentEntry.paused,
+                rank: 0,
+            });
+        }
+    }
+    allAgents.sort((a, b) => b.spend24h > a.spend24h ? 1 : b.spend24h < a.spend24h ? -1 : 0);
+    allAgents.forEach((a, i) => {
+        a.rank = i + 1;
+    });
+    return allAgents;
+}
+/**
+ * Aggregated spending time-series across all vaults for portfolio-level charts.
+ * Merges per-vault SpendTracker histories into one combined timeline.
+ */
+export function getPortfolioTimeSeries(vaultStates, nowUnix) {
+    const epochMap = new Map();
+    let totalSpend24h = 0n;
+    let totalCap24h = 0n;
+    for (const { address, state } of vaultStates) {
+        totalSpend24h += state.globalBudget.spent24h;
+        totalCap24h += state.globalBudget.cap;
+        if (!state.tracker)
+            continue;
+        const history = getSpendingHistory(state.tracker, nowUnix);
+        for (const epoch of history) {
+            const existing = epochMap.get(epoch.timestamp) ?? {
+                totalUsd: 0n,
+                vaultBreakdown: new Map(),
+            };
+            existing.totalUsd += epoch.usdAmount;
+            existing.vaultBreakdown.set(address, (existing.vaultBreakdown.get(address) ?? 0n) + epoch.usdAmount);
+            epochMap.set(epoch.timestamp, existing);
+        }
+    }
+    const spendingByEpoch = Array.from(epochMap.entries())
+        .map(([timestamp, data]) => ({
+        timestamp,
+        totalUsd: data.totalUsd,
+        vaultBreakdown: data.vaultBreakdown,
+    }))
+        .sort((a, b) => a.timestamp - b.timestamp);
+    const utilization = totalCap24h > 0n
+        ? Number((totalSpend24h * 10000n) / totalCap24h) / 100
+        : 0;
+    return { spendingByEpoch, totalSpend24h, totalCap24h, utilization };
+}
+//# sourceMappingURL=portfolio-analytics.js.map

package/dist/portfolio-analytics.js.map

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

package/dist/presets.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Vault creation presets — safe defaults for common use cases.
+ *
+ * Presets provide the policy/permission fields for CreateVaultOptions.
+ * Runtime fields (rpc, network, owner, agent, feeDestination, vaultId)
+ * are NOT included — the caller supplies those.
+ *
+ * Dashboard "Create Vault" wizard uses these as "Quick Setup" cards
+ * before the custom configuration step.
+ */
+import type { Address } from "@solana/kit";
+import type { CreateVaultOptions } from "./create-vault.js";
+/** Policy fields from CreateVaultOptions that a preset configures. */
+export interface VaultPreset {
+    /** Human-readable label for UI display. */
+    label: string;
+    /** One-sentence description for the wizard card. */
+    description: string;
+    /** Agent permission bitmask (21 bits). */
+    permissions: bigint;
+    /** Rolling 24h spending cap in USD base units (6 decimals). */
+    dailySpendingCapUsd: bigint;
+    /** Max single transaction size in USD base units. */
+    maxTransactionSizeUsd: bigint;
+    /** Max slippage in basis points. */
+    maxSlippageBps: number;
+    /** Protocol mode: 0 = all, 1 = allowlist, 2 = denylist. */
+    protocolMode: number;
+    /** Allowed/denied protocol addresses (empty if mode = all). */
+    protocols: Address[];
+    /** Max leverage in basis points (0 = no leverage). */
+    maxLeverageBps: number;
+    /** Max concurrent open positions. */
+    maxConcurrentPositions: number;
+}
+export declare const VAULT_PRESETS: {
+    readonly "jupiter-swap-bot": {
+        readonly label: "Jupiter Swap Bot";
+        readonly description: "Simple swap bot using Jupiter. Swap permission only, conservative caps.";
+        readonly permissions: bigint;
+        readonly dailySpendingCapUsd: 500000000n;
+        readonly maxTransactionSizeUsd: 100000000n;
+        readonly maxSlippageBps: 200;
+        readonly protocolMode: 1;
+        readonly protocols: [Address];
+        readonly maxLeverageBps: 0;
+        readonly maxConcurrentPositions: 0;
+    };
+    readonly "perps-trader": {
+        readonly label: "Perps Trader";
+        readonly description: "Leveraged trading on Flash Trade and Jupiter. Full order management with position limits.";
+        readonly permissions: bigint;
+        readonly dailySpendingCapUsd: 5000000000n;
+        readonly maxTransactionSizeUsd: 1000000000n;
+        readonly maxSlippageBps: 500;
+        readonly protocolMode: 1;
+        readonly protocols: [Address, Address];
+        readonly maxLeverageBps: 10000;
+        readonly maxConcurrentPositions: 5;
+    };
+    readonly "lending-optimizer": {
+        readonly label: "Lending Optimizer";
+        readonly description: "Deposit and withdraw across lending protocols. Low slippage, moderate caps.";
+        readonly permissions: bigint;
+        readonly dailySpendingCapUsd: 2000000000n;
+        readonly maxTransactionSizeUsd: 500000000n;
+        readonly maxSlippageBps: 100;
+        readonly protocolMode: 1;
+        readonly protocols: [Address, Address, Address];
+        readonly maxLeverageBps: 0;
+        readonly maxConcurrentPositions: 0;
+    };
+    readonly "full-access": {
+        readonly label: "Full Access";
+        readonly description: "All permissions enabled, all protocols allowed. For experienced users who need maximum flexibility.";
+        readonly permissions: bigint;
+        readonly dailySpendingCapUsd: 10000000000n;
+        readonly maxTransactionSizeUsd: 5000000000n;
+        readonly maxSlippageBps: 500;
+        readonly protocolMode: 0;
+        readonly protocols: [];
+        readonly maxLeverageBps: 20000;
+        readonly maxConcurrentPositions: 10;
+    };
+};
+export type PresetName = keyof typeof VAULT_PRESETS;
+/**
+ * Get a vault preset by name.
+ * @returns The preset, or undefined if name is not recognized.
+ */
+export declare function getPreset(name: string): VaultPreset | undefined;
+/**
+ * List all available preset names.
+ */
+export declare function listPresets(): PresetName[];
+/**
+ * Convert a preset into CreateVaultOptions fields (without runtime fields).
+ * Merge with your own rpc, network, owner, agent to get a complete CreateVaultOptions.
+ *
+ * @example
+ * ```typescript
+ * const preset = presetToCreateVaultFields("jupiter-swap-bot");
+ * const opts: CreateVaultOptions = { rpc, network: "devnet", owner, agent, ...preset };
+ * const result = await createVault(opts);
+ * ```
+ */
+export declare function presetToCreateVaultFields(name: PresetName): Pick<CreateVaultOptions, "permissions" | "dailySpendingCapUsd" | "maxTransactionSizeUsd" | "maxSlippageBps" | "protocolMode" | "protocols" | "maxLeverageBps" | "maxConcurrentPositions">;
+//# sourceMappingURL=presets.d.ts.map

package/dist/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../src/presets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AA0B5D,sEAAsE;AACtE,MAAM,WAAW,WAAW;IAC1B,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,mBAAmB,EAAE,MAAM,CAAC;IAC5B,qDAAqD;IACrD,qBAAqB,EAAE,MAAM,CAAC;IAC9B,oCAAoC;IACpC,cAAc,EAAE,MAAM,CAAC;IACvB,2DAA2D;IAC3D,YAAY,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,SAAS,EAAE,OAAO,EAAE,CAAC;IACrB,sDAAsD;IACtD,cAAc,EAAE,MAAM,CAAC;IACvB,qCAAqC;IACrC,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAID,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqDsB,CAAC;AAEjD,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,aAAa,CAAC;AAIpD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAG/D;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,UAAU,EAAE,CAE1C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,UAAU,GACf,IAAI,CACL,kBAAkB,EAChB,aAAa,GACb,qBAAqB,GACrB,uBAAuB,GACvB,gBAAgB,GAChB,cAAc,GACd,WAAW,GACX,gBAAgB,GAChB,wBAAwB,CAC3B,CAYA"}