@usesigil/kit 0.1.0

package/dist/presets.js

@@ -0,0 +1,110 @@
+/**
+ * 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 { FULL_PERMISSIONS, SWAP_ONLY, PERPS_FULL, PROTOCOL_MODE_ALL, PROTOCOL_MODE_ALLOWLIST, JUPITER_PROGRAM_ADDRESS, } from "./types.js";
+// ─── Protocol Addresses ──────────────────────────────────────────────────────
+const FLASH_TRADE_PROGRAM = "FLASH6Lo6h3iasJKWDs2F8TkW2UKf3s15C8PMGuVfgBn";
+const JUPITER_LEND_PROGRAM = "JLend2fEim9xUFcaHsyGePEoBzFLvkjMi3MnPcSuCdu";
+const KAMINO_LEND_PROGRAM = "KLend2g3cP87ber8CzRaqeECGwNvLFM9acPVcRkRHvM";
+// ─── Permission Helpers ──────────────────────────────────────────────────────
+/** Swap (0) + Deposit (5) + Withdraw (6) — lending use case */
+const LENDING_PERMISSIONS = SWAP_ONLY | (1n << 5n) | (1n << 6n);
+// ─── Presets ────────────────────────────────────────────────────────────────
+export const VAULT_PRESETS = {
+    "jupiter-swap-bot": {
+        label: "Jupiter Swap Bot",
+        description: "Simple swap bot using Jupiter. Swap permission only, conservative caps.",
+        permissions: SWAP_ONLY,
+        dailySpendingCapUsd: 500000000n, // $500
+        maxTransactionSizeUsd: 100000000n, // $100
+        maxSlippageBps: 200, // 2%
+        protocolMode: PROTOCOL_MODE_ALLOWLIST,
+        protocols: [JUPITER_PROGRAM_ADDRESS],
+        maxLeverageBps: 0,
+        maxConcurrentPositions: 0,
+    },
+    "perps-trader": {
+        label: "Perps Trader",
+        description: "Leveraged trading on Flash Trade and Jupiter. Full order management with position limits.",
+        permissions: PERPS_FULL | SWAP_ONLY,
+        dailySpendingCapUsd: 5000000000n, // $5,000
+        maxTransactionSizeUsd: 1000000000n, // $1,000
+        maxSlippageBps: 500, // 5%
+        protocolMode: PROTOCOL_MODE_ALLOWLIST,
+        protocols: [JUPITER_PROGRAM_ADDRESS, FLASH_TRADE_PROGRAM],
+        maxLeverageBps: 10_000, // 10x
+        maxConcurrentPositions: 5,
+    },
+    "lending-optimizer": {
+        label: "Lending Optimizer",
+        description: "Deposit and withdraw across lending protocols. Low slippage, moderate caps.",
+        permissions: LENDING_PERMISSIONS,
+        dailySpendingCapUsd: 2000000000n, // $2,000
+        maxTransactionSizeUsd: 500000000n, // $500
+        maxSlippageBps: 100, // 1%
+        protocolMode: PROTOCOL_MODE_ALLOWLIST,
+        protocols: [JUPITER_PROGRAM_ADDRESS, JUPITER_LEND_PROGRAM, KAMINO_LEND_PROGRAM],
+        maxLeverageBps: 0,
+        maxConcurrentPositions: 0,
+    },
+    "full-access": {
+        label: "Full Access",
+        description: "All permissions enabled, all protocols allowed. For experienced users who need maximum flexibility.",
+        permissions: FULL_PERMISSIONS,
+        dailySpendingCapUsd: 10000000000n, // $10,000
+        maxTransactionSizeUsd: 5000000000n, // $5,000
+        maxSlippageBps: 500, // 5%
+        protocolMode: PROTOCOL_MODE_ALL,
+        protocols: [],
+        maxLeverageBps: 20_000, // 20x
+        maxConcurrentPositions: 10,
+    },
+};
+// ─── Functions ──────────────────────────────────────────────────────────────
+/**
+ * Get a vault preset by name.
+ * @returns The preset, or undefined if name is not recognized.
+ */
+export function getPreset(name) {
+    if (!Object.prototype.hasOwnProperty.call(VAULT_PRESETS, name))
+        return undefined;
+    return VAULT_PRESETS[name];
+}
+/**
+ * List all available preset names.
+ */
+export function listPresets() {
+    return Object.keys(VAULT_PRESETS);
+}
+/**
+ * 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 function presetToCreateVaultFields(name) {
+    const preset = VAULT_PRESETS[name];
+    return {
+        permissions: preset.permissions,
+        dailySpendingCapUsd: preset.dailySpendingCapUsd,
+        maxTransactionSizeUsd: preset.maxTransactionSizeUsd,
+        maxSlippageBps: preset.maxSlippageBps,
+        protocolMode: preset.protocolMode,
+        protocols: [...preset.protocols],
+        maxLeverageBps: preset.maxLeverageBps,
+        maxConcurrentPositions: preset.maxConcurrentPositions,
+    };
+}
+//# sourceMappingURL=presets.js.map

package/dist/presets.js.map

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

package/dist/priority-fees.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Kit-native CU estimation + priority fee estimation.
+ *
+ * CU constants match the existing SDK values (measured via LiteSVM).
+ * 3-layer fallback: Helius → Kit RPC → static.
+ */
+import type { Instruction, Rpc, SolanaRpcApi } from "@solana/kit";
+export declare const CU_AGENT_TRANSFER = 200000;
+export declare const CU_JUPITER_SWAP = 600000;
+export declare const CU_JUPITER_MULTI_HOP = 900000;
+export declare const CU_FLASH_TRADE = 800000;
+export declare const CU_JUPITER_LEND = 400000;
+export declare const CU_DRIFT = 800000;
+export declare const CU_KAMINO_LEND = 400000;
+export declare const CU_DEFAULT_COMPOSED = 800000;
+export declare const CU_VAULT_CREATION = 400000;
+export declare const CU_OWNER_ACTION = 200000;
+/**
+ * Detect CU budget based on the DeFi instructions in a composed transaction.
+ * Uses `programAddress` (Kit convention, not `programId`).
+ */
+export declare function estimateComposedCU(defiInstructions: Instruction[]): number;
+export type PriorityLevel = "low" | "medium" | "high" | "very_high";
+export interface PriorityFeeConfig {
+    strategy?: "auto" | "helius" | "rpc" | "static";
+    cacheTtlMs?: number;
+    fallbackMicroLamports?: number;
+    defaultLevel?: PriorityLevel;
+    maxMicroLamports?: number;
+}
+/**
+ * Priority fee estimator with 3-layer fallback and caching.
+ *
+ * Layer 1: Helius getPriorityFeeEstimate (auto-detected from URL)
+ * Layer 2: Kit RPC getRecentPrioritizationFees + percentile
+ * Layer 3: Static fallback
+ */
+export declare class PriorityFeeEstimator {
+    private readonly rpcEndpoint;
+    private readonly rpc;
+    private readonly config;
+    private readonly cache;
+    private readonly isHelius;
+    constructor(rpcEndpoint: string, rpc: Rpc<SolanaRpcApi> | null, config?: PriorityFeeConfig);
+    estimate(level?: PriorityLevel): Promise<number>;
+    private estimateHelius;
+    private estimateRpc;
+}
+//# sourceMappingURL=priority-fees.d.ts.map

package/dist/priority-fees.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"priority-fees.d.ts","sourceRoot":"","sources":["../src/priority-fees.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAYlE,eAAO,MAAM,iBAAiB,SAAU,CAAC;AACzC,eAAO,MAAM,eAAe,SAAU,CAAC;AACvC,eAAO,MAAM,oBAAoB,SAAU,CAAC;AAC5C,eAAO,MAAM,cAAc,SAAU,CAAC;AACtC,eAAO,MAAM,eAAe,SAAU,CAAC;AACvC,eAAO,MAAM,QAAQ,SAAU,CAAC;AAChC,eAAO,MAAM,cAAc,SAAU,CAAC;AACtC,eAAO,MAAM,mBAAmB,SAAU,CAAC;AAC3C,eAAO,MAAM,iBAAiB,SAAU,CAAC;AACzC,eAAO,MAAM,eAAe,SAAU,CAAC;AAEvC;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,gBAAgB,EAAE,WAAW,EAAE,GAAG,MAAM,CA2B1E;AAID,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAEpE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,CAAC;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,YAAY,CAAC,EAAE,aAAa,CAAC;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAqBD;;;;;;GAMG;AACH,qBAAa,oBAAoB;IAM7B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,GAAG;IANtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8B;IACrD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAwC;IAC9D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;gBAGhB,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,GAAG,CAAC,YAAY,CAAC,GAAG,IAAI,EAC9C,MAAM,CAAC,EAAE,iBAAiB;IAiBtB,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;YAmCxC,cAAc;YAqCd,WAAW;CAyB1B"}

package/dist/priority-fees.js

@@ -0,0 +1,175 @@
+/**
+ * Kit-native CU estimation + priority fee estimation.
+ *
+ * CU constants match the existing SDK values (measured via LiteSVM).
+ * 3-layer fallback: Helius → Kit RPC → static.
+ */
+// ─── Known Protocol Program Addresses ────────────────────────────────────────
+const JUPITER_PROGRAM = "JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4";
+const JUPITER_LEND_PROGRAM = "JLend2fEim9xUFcaHsyGePEoBzFLvkjMi3MnPcSuCdu";
+const FLASH_TRADE_PROGRAM = "FLASH6Lo6h3iasJKWDs2F8TkW2UKf3s15C8PMGuVfgBn";
+const DRIFT_PROGRAM = "dRiftyHA39MWEi3m9aunc5MzRF1JYuBsbn6VPcn33UH";
+const KAMINO_LEND_PROGRAM = "KLend2g3cP87ber8CzRaqeECGwNvLFM9acPVcRkRHvM";
+// ─── CU Budget Defaults ─────────────────────────────────────────────────────
+export const CU_AGENT_TRANSFER = 200_000;
+export const CU_JUPITER_SWAP = 600_000;
+export const CU_JUPITER_MULTI_HOP = 900_000;
+export const CU_FLASH_TRADE = 800_000;
+export const CU_JUPITER_LEND = 400_000;
+export const CU_DRIFT = 800_000;
+export const CU_KAMINO_LEND = 400_000;
+export const CU_DEFAULT_COMPOSED = 800_000;
+export const CU_VAULT_CREATION = 400_000;
+export const CU_OWNER_ACTION = 200_000;
+/**
+ * Detect CU budget based on the DeFi instructions in a composed transaction.
+ * Uses `programAddress` (Kit convention, not `programId`).
+ */
+export function estimateComposedCU(defiInstructions) {
+    if (defiInstructions.length === 0)
+        return CU_AGENT_TRANSFER;
+    const programAddresses = defiInstructions.map((ix) => ix.programAddress);
+    const hasJupiter = programAddresses.some((id) => id === JUPITER_PROGRAM);
+    const hasJupiterLend = programAddresses.some((id) => id === JUPITER_LEND_PROGRAM);
+    const hasFlashTrade = programAddresses.some((id) => id === FLASH_TRADE_PROGRAM);
+    const hasDrift = programAddresses.some((id) => id === DRIFT_PROGRAM);
+    const hasKaminoLend = programAddresses.some((id) => id === KAMINO_LEND_PROGRAM);
+    if (hasJupiter && defiInstructions.length > 2)
+        return CU_JUPITER_MULTI_HOP;
+    if (hasJupiter)
+        return CU_JUPITER_SWAP;
+    if (hasJupiterLend)
+        return CU_JUPITER_LEND;
+    if (hasFlashTrade)
+        return CU_FLASH_TRADE;
+    if (hasDrift)
+        return CU_DRIFT;
+    if (hasKaminoLend)
+        return CU_KAMINO_LEND;
+    return CU_DEFAULT_COMPOSED;
+}
+const LEVEL_PERCENTILES = {
+    low: 25,
+    medium: 50,
+    high: 75,
+    very_high: 95,
+};
+const HELIUS_LEVELS = {
+    low: "Low",
+    medium: "Medium",
+    high: "High",
+    very_high: "VeryHigh",
+};
+/**
+ * Priority fee estimator with 3-layer fallback and caching.
+ *
+ * Layer 1: Helius getPriorityFeeEstimate (auto-detected from URL)
+ * Layer 2: Kit RPC getRecentPrioritizationFees + percentile
+ * Layer 3: Static fallback
+ */
+export class PriorityFeeEstimator {
+    rpcEndpoint;
+    rpc;
+    config;
+    cache = new Map();
+    isHelius;
+    constructor(rpcEndpoint, rpc, config) {
+        this.rpcEndpoint = rpcEndpoint;
+        this.rpc = rpc;
+        this.config = {
+            strategy: config?.strategy ?? "auto",
+            cacheTtlMs: config?.cacheTtlMs ?? 10_000,
+            fallbackMicroLamports: config?.fallbackMicroLamports ?? 10_000,
+            defaultLevel: config?.defaultLevel ?? "high",
+            maxMicroLamports: config?.maxMicroLamports ?? 1_000_000,
+        };
+        if (this.config.strategy === "auto") {
+            this.isHelius = /helius/i.test(this.rpcEndpoint);
+        }
+        else {
+            this.isHelius = this.config.strategy === "helius";
+        }
+    }
+    async estimate(level) {
+        const targetLevel = level ?? this.config.defaultLevel;
+        const cached = this.cache.get(targetLevel);
+        if (cached && cached.expiresAt > Date.now()) {
+            return cached.microLamports;
+        }
+        let fee = null;
+        // Layer 1: Helius
+        if (this.isHelius) {
+            fee = await this.estimateHelius(targetLevel);
+        }
+        // Layer 2: Standard RPC
+        if (fee === null && this.rpc) {
+            fee = await this.estimateRpc(targetLevel);
+        }
+        // Layer 3: Static
+        if (fee === null) {
+            fee = this.config.fallbackMicroLamports;
+        }
+        fee = Math.min(fee, this.config.maxMicroLamports);
+        this.cache.set(targetLevel, {
+            microLamports: fee,
+            expiresAt: Date.now() + this.config.cacheTtlMs,
+        });
+        return fee;
+    }
+    async estimateHelius(level) {
+        try {
+            const body = {
+                jsonrpc: "2.0",
+                id: "sigil-fee-estimate",
+                method: "getPriorityFeeEstimate",
+                params: [
+                    {
+                        options: {
+                            recommended: true,
+                            priorityLevel: HELIUS_LEVELS[level],
+                        },
+                    },
+                ],
+            };
+            const response = await fetch(this.rpcEndpoint, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify(body),
+                signal: AbortSignal.timeout(5_000),
+            });
+            if (!response.ok)
+                return null;
+            const json = (await response.json());
+            const estimate = json?.result?.priorityFeeEstimate;
+            if (typeof estimate === "number" && estimate >= 0) {
+                return Math.ceil(estimate);
+            }
+            return null;
+        }
+        catch {
+            return null;
+        }
+    }
+    async estimateRpc(level) {
+        try {
+            if (!this.rpc)
+                return null;
+            const fees = await this.rpc.getRecentPrioritizationFees().send();
+            if (!fees || fees.length === 0)
+                return null;
+            const sorted = fees
+                .map((f) => Number(f.prioritizationFee))
+                .filter((f) => f > 0)
+                .sort((a, b) => a - b);
+            if (sorted.length === 0)
+                return this.config.fallbackMicroLamports;
+            const percentile = LEVEL_PERCENTILES[level];
+            const index = Math.min(Math.ceil((percentile / 100) * sorted.length) - 1, sorted.length - 1);
+            return sorted[index];
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=priority-fees.js.map

package/dist/priority-fees.js.map

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

package/dist/protocol-analytics.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Protocol analytics — per-protocol spending breakdown and cross-vault usage.
+ *
+ * getProtocolBreakdown(): Pure function — donut chart data for spending by protocol.
+ * getProtocolUsageAcrossVaults(): Async — aggregated protocol usage across all vaults.
+ */
+import type { Address, Rpc, SolanaRpcApi } from "@solana/kit";
+import type { ResolvedVaultState } from "./state-resolver.js";
+import type { Network } from "./types.js";
+export interface ProtocolBreakdownItem {
+    protocol: Address;
+    protocolName: string;
+    spent24h: bigint;
+    cap: bigint | null;
+    utilization: number;
+    /** This protocol's share of total vault spending (0-100%) */
+    percentOfTotalSpend: number;
+}
+export interface PlatformProtocolUsage {
+    protocol: Address;
+    protocolName: string;
+    vaultCount: number;
+    totalSpend24h: bigint;
+}
+/**
+ * Per-protocol spending breakdown for a single vault.
+ * Used for the Spending tab donut chart.
+ */
+export declare function getProtocolBreakdown(state: ResolvedVaultState): ProtocolBreakdownItem[];
+/**
+ * Protocol usage across all of an owner's vaults.
+ * Parallel RPC — N vaults resolved concurrently.
+ */
+export declare function getProtocolUsageAcrossVaults(rpc: Rpc<SolanaRpcApi>, owner: Address, network?: Network): Promise<PlatformProtocolUsage[]>;
+//# sourceMappingURL=protocol-analytics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-analytics.d.ts","sourceRoot":"","sources":["../src/protocol-analytics.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAG9D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAI1C,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB;AAID;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,kBAAkB,GACxB,qBAAqB,EAAE,CAgBzB;AAID;;;GAGG;AACH,wBAAsB,4BAA4B,CAChD,GAAG,EAAE,GAAG,CAAC,YAAY,CAAC,EACtB,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,OAAwB,GAChC,OAAO,CAAC,qBAAqB,EAAE,CAAC,CA6ClC"}

package/dist/protocol-analytics.js

@@ -0,0 +1,64 @@
+/**
+ * Protocol analytics — per-protocol spending breakdown and cross-vault usage.
+ *
+ * getProtocolBreakdown(): Pure function — donut chart data for spending by protocol.
+ * getProtocolUsageAcrossVaults(): Async — aggregated protocol usage across all vaults.
+ */
+import { findVaultsByOwner, resolveVaultStateForOwner } from "./state-resolver.js";
+import { resolveProtocolName } from "./protocol-names.js";
+// ─── getProtocolBreakdown ────────────────────────────────────────────────────
+/**
+ * Per-protocol spending breakdown for a single vault.
+ * Used for the Spending tab donut chart.
+ */
+export function getProtocolBreakdown(state) {
+    const { protocolBudgets, globalBudget } = state;
+    const totalSpend = globalBudget.spent24h;
+    return protocolBudgets.map((pb) => ({
+        protocol: pb.protocol,
+        protocolName: resolveProtocolName(pb.protocol),
+        spent24h: pb.spent24h,
+        cap: pb.cap > 0n ? pb.cap : null,
+        utilization: pb.cap > 0n ? Number((pb.spent24h * 10000n) / pb.cap) / 100 : 0,
+        percentOfTotalSpend: totalSpend > 0n
+            ? Number((pb.spent24h * 10000n) / totalSpend) / 100
+            : 0,
+    }));
+}
+// ─── getProtocolUsageAcrossVaults ────────────────────────────────────────────
+/**
+ * Protocol usage across all of an owner's vaults.
+ * Parallel RPC — N vaults resolved concurrently.
+ */
+export async function getProtocolUsageAcrossVaults(rpc, owner, network = "mainnet-beta") {
+    const discovered = await findVaultsByOwner(rpc, owner);
+    // Use allSettled so one failed vault doesn't kill the entire query
+    const results = await Promise.allSettled(discovered.map((v) => resolveVaultStateForOwner(rpc, v.vaultAddress, undefined, network)));
+    const states = results
+        .filter((r) => r.status === "fulfilled")
+        .map((r) => r.value);
+    const protocolMap = new Map();
+    for (const state of states) {
+        for (const pb of state.protocolBudgets) {
+            const existing = protocolMap.get(pb.protocol) ?? {
+                vaultCount: 0,
+                totalSpend: 0n,
+            };
+            existing.vaultCount++;
+            existing.totalSpend += pb.spent24h;
+            protocolMap.set(pb.protocol, existing);
+        }
+    }
+    const usage = [];
+    for (const [protocol, data] of protocolMap) {
+        usage.push({
+            protocol: protocol,
+            protocolName: resolveProtocolName(protocol),
+            vaultCount: data.vaultCount,
+            totalSpend24h: data.totalSpend,
+        });
+    }
+    usage.sort((a, b) => b.totalSpend24h > a.totalSpend24h ? 1 : b.totalSpend24h < a.totalSpend24h ? -1 : 0);
+    return usage;
+}
+//# sourceMappingURL=protocol-analytics.js.map

package/dist/protocol-analytics.js.map

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

package/dist/protocol-names.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Shared protocol name resolution — used by event-analytics and spending-analytics.
+ *
+ * Extracted per ANALYTICS-IMPLEMENTATION-GUIDE-PT2 Bug #6 recommendation
+ * to avoid duplicate maps that drift independently.
+ */
+export declare const PROTOCOL_NAMES: Record<string, string>;
+export declare function resolveProtocolName(protocol: string): string;
+//# sourceMappingURL=protocol-names.d.ts.map

package/dist/protocol-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-names.d.ts","sourceRoot":"","sources":["../src/protocol-names.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAMjD,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE5D"}

package/dist/protocol-names.js

@@ -0,0 +1,18 @@
+/**
+ * Shared protocol name resolution — used by event-analytics and spending-analytics.
+ *
+ * Extracted per ANALYTICS-IMPLEMENTATION-GUIDE-PT2 Bug #6 recommendation
+ * to avoid duplicate maps that drift independently.
+ */
+import { formatAddress } from "./formatting.js";
+export const PROTOCOL_NAMES = {
+    JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4: "Jupiter",
+    FLASH6Lo6h3iasJKWDs2F8TkW2UKf3s15C8PMGuVfgBn: "Flash Trade",
+    dRiftyHA39MWEi3m9aunc5MzRF1JYuBsbn6VPcn33UH: "Drift",
+    KLend2g3cP87ber8CzRaqeECGwNvLFM9acPVcRkRHvM: "Kamino",
+    JLend2fEim9xUFcaHsyGePEoBzFLvkjMi3MnPcSuCdu: "Jupiter Lend",
+};
+export function resolveProtocolName(protocol) {
+    return PROTOCOL_NAMES[protocol] ?? formatAddress(protocol);
+}
+//# sourceMappingURL=protocol-names.js.map

package/dist/protocol-names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-names.js","sourceRoot":"","sources":["../src/protocol-names.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,MAAM,CAAC,MAAM,cAAc,GAA2B;IACpD,2CAA2C,EAAE,SAAS;IACtD,4CAA4C,EAAE,aAAa;IAC3D,2CAA2C,EAAE,OAAO;IACpD,2CAA2C,EAAE,QAAQ;IACrD,2CAA2C,EAAE,cAAc;CAC5D,CAAC;AAEF,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IAClD,OAAO,cAAc,CAAC,QAAQ,CAAC,IAAI,aAAa,CAAC,QAAQ,CAAC,CAAC;AAC7D,CAAC"}

package/dist/protocol-resolver.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Protocol Resolver — Kit-native
+ *
+ * Determines protocol tier for allowlist/constraint enforcement:
+ *   KNOWN: Program is in the known protocols registry
+ *   DEFAULT: Passthrough with on-chain constraints
+ *   NOT_ALLOWED: Blocked by policy
+ */
+import type { Address } from "@solana/kit";
+export declare enum ProtocolTier {
+    KNOWN = 1,
+    DEFAULT = 2,
+    NOT_ALLOWED = 3
+}
+export interface ProtocolResolution {
+    tier: ProtocolTier;
+    protocolId: string;
+    programId: Address;
+    displayName: string;
+    reason: string;
+    constraintsConfigured?: boolean;
+    escalation?: EscalationInfo;
+}
+export interface EscalationInfo {
+    type: "not_in_allowlist" | "no_handler_no_constraints" | "no_handler_has_constraints" | "not_in_allowlist_and_no_handler";
+    message: string;
+    requiredActions: string[];
+}
+/**
+ * Check if a program is in the vault's protocol allowlist/denylist.
+ *
+ * @param programId - Program address to check
+ * @param policy - Vault policy with protocolMode and protocols list
+ * @returns true if the program is allowed by the policy
+ */
+export declare function isProtocolAllowed(programId: Address, policy: {
+    protocolMode: number;
+    protocols: Address[];
+}): boolean;
+/**
+ * Resolve the tier and escalation info for a given protocol.
+ *
+ * Resolution logic:
+ * 1. Known program + in allowlist -> KNOWN
+ * 2. Known program + NOT in allowlist -> NOT_ALLOWED
+ * 3. Unknown program + in allowlist + constraints -> DEFAULT (passthrough)
+ * 4. Unknown program + in allowlist + NO constraints -> NOT_ALLOWED (escalation)
+ * 5. Unknown program + NOT in allowlist -> NOT_ALLOWED (escalation)
+ */
+export declare function resolveProtocol(programId: Address, policy: {
+    protocolMode: number;
+    protocols: Address[];
+}, constraintsConfigured: boolean): ProtocolResolution;
+//# sourceMappingURL=protocol-resolver.d.ts.map

package/dist/protocol-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-resolver.d.ts","sourceRoot":"","sources":["../src/protocol-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAO3C,oBAAY,YAAY;IACtB,KAAK,IAAI;IACT,OAAO,IAAI;IACX,WAAW,IAAI;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,YAAY,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,UAAU,CAAC,EAAE,cAAc,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EACA,kBAAkB,GAClB,2BAA2B,GAC3B,4BAA4B,GAC5B,iCAAiC,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAMD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,OAAO,EAClB,MAAM,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,EAAE,CAAA;CAAE,GACrD,OAAO,CAKT;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,OAAO,EAClB,MAAM,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,EAAE,CAAA;CAAE,EACtD,qBAAqB,EAAE,OAAO,GAC7B,kBAAkB,CAkFpB"}