sorokeep 1.0.0

package/dist/core/channels.js

@@ -0,0 +1,136 @@
+import { StellarRpcClient } from "../rpc/client.js";
+import { getChannelAccounts, updateChannelBalance, insertChannelAccount, markChannelFunded, } from "../db/repositories.js";
+import { getLogger } from "../logging/index.js";
+const logger = getLogger().child({ component: "ChannelAccountPool" });
+/**
+ * Pool of channel accounts for concurrent TTL extensions.
+ *
+ * Each account tracks its own sequence number on Stellar, so concurrent
+ * transactions submitted through different accounts avoid sequence conflicts.
+ * acquire() hands out a slot in round-robin order, blocking callers until
+ * a slot is free. release() returns the slot and unblocks the next waiter.
+ */
+export class ChannelAccountPool {
+    db;
+    network;
+    accounts;
+    /** Tracks which publicKeys are currently in use. */
+    inUse = new Set();
+    /** Queue of resolve callbacks waiting for the next free slot. */
+    waiters = [];
+    /** Round-robin cursor. */
+    cursor = 0;
+    constructor(db, network) {
+        this.db = db;
+        this.network = network;
+        this.accounts = getChannelAccounts(db, network);
+    }
+    /** Number of registered channel accounts. */
+    size() {
+        return this.accounts.length;
+    }
+    /**
+     * Acquire an available channel account slot.
+     * If all slots are in use, waits until one is released.
+     */
+    acquire() {
+        const slot = this.nextFreeSlot();
+        if (slot) {
+            this.inUse.add(slot.publicKey);
+            return Promise.resolve(slot);
+        }
+        // All slots busy — queue the caller
+        return new Promise(resolve => {
+            this.waiters.push(resolve);
+        });
+    }
+    /**
+     * Release a slot back to the pool.
+     * Unblocks the oldest waiting acquire() call if any.
+     */
+    release(publicKey) {
+        this.inUse.delete(publicKey);
+        if (this.waiters.length > 0) {
+            const slot = this.nextFreeSlot();
+            if (slot) {
+                this.inUse.add(slot.publicKey);
+                this.waiters.shift()(slot);
+            }
+        }
+    }
+    /**
+     * Returns current balance information for all accounts in the pool.
+     * Reads from the DB — does not call the RPC.
+     */
+    getBalances() {
+        return getChannelAccounts(this.db, this.network).map(a => ({
+            publicKey: a.public_key,
+            balanceXlm: a.balance_xlm,
+            balanceCheckedAt: a.balance_checked_at,
+        }));
+    }
+    /**
+     * Fetch native XLM balances for all accounts from the RPC and persist them.
+     * Errors per-account are logged and swallowed — does not throw.
+     */
+    async refreshBalances(rpcUrl) {
+        if (this.accounts.length === 0)
+            return;
+        const client = new StellarRpcClient(this.network, rpcUrl);
+        await Promise.all(this.accounts.map(async (account) => {
+            try {
+                const response = await client.getAccount(account.public_key);
+                const nativeBalance = response.balances?.find((b) => b.asset_type === "native");
+                const xlm = nativeBalance ? parseFloat(nativeBalance.balance) : 0;
+                updateChannelBalance(this.db, account.public_key, xlm);
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                logger.warn(`Failed to refresh balance for ${account.public_key}: ${msg}`);
+            }
+        }));
+    }
+    // ─── Private ─────────────────────────────────────────────────────────────
+    /**
+     * Find the next free account in round-robin order.
+     * Returns undefined if all accounts are in use.
+     */
+    nextFreeSlot() {
+        const n = this.accounts.length;
+        for (let i = 0; i < n; i++) {
+            const idx = (this.cursor + i) % n;
+            const account = this.accounts[idx];
+            if (!this.inUse.has(account.public_key)) {
+                this.cursor = (idx + 1) % n;
+                return { publicKey: account.public_key, keypairSource: account.keypair_source };
+            }
+        }
+        return undefined;
+    }
+}
+export function addChannel(db, publicKey, network, label) {
+    insertChannelAccount(db, { public_key: publicKey, network, label });
+}
+export function listChannels(db, network) {
+    return getChannelAccounts(db, network);
+}
+export async function fundChannels(db, masterSecretKey, amountXlm, network, rpcUrl) {
+    const accounts = getChannelAccounts(db, network);
+    if (accounts.length === 0) {
+        return { funded: 0, txHash: "", errors: [] };
+    }
+    const client = new StellarRpcClient(network, rpcUrl);
+    const destinations = accounts.map((a) => ({
+        publicKey: a.public_key,
+        amountXlm,
+    }));
+    const result = await client.sendPayments(destinations, masterSecretKey);
+    if (!result.success) {
+        return { funded: 0, txHash: result.txHash, errors: [result.error ?? "Transaction failed"] };
+    }
+    for (const account of accounts) {
+        markChannelFunded(db, account.public_key);
+    }
+    return { funded: accounts.length, txHash: result.txHash, errors: [] };
+}
+//# sourceMappingURL=channels.js.map

package/dist/core/channels.js.map

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

package/dist/core/check.d.ts

@@ -0,0 +1,25 @@
+export interface CheckEntry {
+    entryKeyXdr: string;
+    entryType: "instance" | "wasm";
+    liveUntilLedger: number;
+    remainingTTL: number;
+}
+export interface CheckResult {
+    contractId: string;
+    network: string;
+    threshold: number;
+    latestLedger: number;
+    minimumTTL: number;
+    passed: boolean;
+    entries: CheckEntry[];
+    error?: string;
+}
+/**
+ * One-shot, stateless TTL check for a Soroban contract.
+ *
+ * Queries the Stellar RPC directly — no local DB required.
+ * Checks both the contract instance and its WASM code entry (when present).
+ * Returns `passed: true` when minimumTTL >= threshold.
+ */
+export declare function checkContractTTL(contractId: string, network: string, threshold: number, rpcUrl?: string): Promise<CheckResult>;
+//# sourceMappingURL=check.d.ts.map

package/dist/core/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../src/core/check.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,UAAU;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,UAAU,GAAG,MAAM,CAAC;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAClC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,WAAW,CAAC,CAgFtB"}

package/dist/core/check.js

@@ -0,0 +1,85 @@
+import { StellarRpcClient } from "../rpc/client.js";
+import { getLogger } from "../logging/index.js";
+const logger = getLogger().child({ component: "CheckCommand" });
+/**
+ * One-shot, stateless TTL check for a Soroban contract.
+ *
+ * Queries the Stellar RPC directly — no local DB required.
+ * Checks both the contract instance and its WASM code entry (when present).
+ * Returns `passed: true` when minimumTTL >= threshold.
+ */
+export async function checkContractTTL(contractId, network, threshold, rpcUrl) {
+    const client = new StellarRpcClient(network, rpcUrl);
+    const entries = [];
+    try {
+        const instanceEntry = await client.getContractInstanceEntry(contractId);
+        if (!instanceEntry) {
+            return {
+                contractId,
+                network,
+                threshold,
+                latestLedger: 0,
+                minimumTTL: 0,
+                passed: false,
+                entries: [],
+                error: `Contract ${contractId} not found on ${network}`,
+            };
+        }
+        entries.push({
+            entryKeyXdr: instanceEntry.entryKeyXdr,
+            entryType: "instance",
+            liveUntilLedger: instanceEntry.liveUntilLedgerSeq,
+            remainingTTL: instanceEntry.remainingTTL,
+        });
+        if (instanceEntry.wasmHash) {
+            const wasmEntry = await client.getWasmCodeEntry(instanceEntry.wasmHash);
+            if (wasmEntry) {
+                entries.push({
+                    entryKeyXdr: wasmEntry.entryKeyXdr,
+                    entryType: "wasm",
+                    liveUntilLedger: wasmEntry.liveUntilLedgerSeq,
+                    remainingTTL: wasmEntry.remainingTTL,
+                });
+            }
+            else {
+                return {
+                    contractId,
+                    network,
+                    threshold,
+                    latestLedger: instanceEntry.latestLedger,
+                    minimumTTL: 0,
+                    passed: false,
+                    entries,
+                    error: `WASM code entry (hash: ${instanceEntry.wasmHash.substring(0, 10)}...) not found`,
+                };
+            }
+        }
+        const minimumTTL = Math.min(...entries.map(e => e.remainingTTL));
+        const passed = minimumTTL >= threshold;
+        logger.debug(`TTL check — contract: ${contractId}, minimumTTL: ${minimumTTL}, threshold: ${threshold}, passed: ${passed}`);
+        return {
+            contractId,
+            network,
+            threshold,
+            latestLedger: instanceEntry.latestLedger,
+            minimumTTL,
+            passed,
+            entries,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.error(`TTL check failed for ${contractId}: ${message}`);
+        return {
+            contractId,
+            network,
+            threshold,
+            latestLedger: 0,
+            minimumTTL: 0,
+            passed: false,
+            entries: [],
+            error: message,
+        };
+    }
+}
+//# sourceMappingURL=check.js.map

package/dist/core/check.js.map

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

package/dist/core/completion.d.ts

@@ -0,0 +1,9 @@
+import type Database from "better-sqlite3";
+export declare const TOP_LEVEL_COMMANDS: string[];
+export declare const ALERTS_SUBCOMMANDS: string[];
+export declare const CHANNELS_SUBCOMMANDS: string[];
+export declare const STATUS_CONTRACT_COMMANDS: string[];
+export declare function getCompletionSuggestions(db: Database.Database, words: string[], cursorIndex: number): string[];
+export declare function renderBashCompletionScript(): string;
+export declare function renderZshCompletionScript(): string;
+//# sourceMappingURL=completion.d.ts.map

package/dist/core/completion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.d.ts","sourceRoot":"","sources":["../../src/core/completion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAG3C,eAAO,MAAM,kBAAkB,UAY9B,CAAC;AAEF,eAAO,MAAM,kBAAkB,UAA+C,CAAC;AAC/E,eAAO,MAAM,oBAAoB,UAA0B,CAAC;AAC5D,eAAO,MAAM,wBAAwB,UAAgE,CAAC;AAEtG,wBAAgB,wBAAwB,CACtC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,MAAM,EAAE,EACf,WAAW,EAAE,MAAM,GAClB,MAAM,EAAE,CAsBV;AAED,wBAAgB,0BAA0B,IAAI,MAAM,CAYnD;AAED,wBAAgB,yBAAyB,IAAI,MAAM,CAgBlD"}

package/dist/core/completion.js

@@ -0,0 +1,68 @@
+import { getAllContracts } from "../db/repositories.js";
+export const TOP_LEVEL_COMMANDS = [
+    "watch",
+    "status",
+    "check",
+    "daemon",
+    "alerts",
+    "guard",
+    "costs",
+    "resources",
+    "restore",
+    "channels",
+    "completion",
+];
+export const ALERTS_SUBCOMMANDS = ["add", "list", "remove", "test", "history"];
+export const CHANNELS_SUBCOMMANDS = ["add", "list", "fund"];
+export const STATUS_CONTRACT_COMMANDS = ["status", "check", "resources", "costs", "guard", "restore"];
+export function getCompletionSuggestions(db, words, cursorIndex) {
+    if (words.length <= 1 || cursorIndex <= 1) {
+        return TOP_LEVEL_COMMANDS;
+    }
+    const normalizedWords = words.slice(1, cursorIndex + 1);
+    const firstCommand = normalizedWords[0];
+    if (firstCommand === "alerts") {
+        if (cursorIndex === 2) {
+            return ALERTS_SUBCOMMANDS;
+        }
+        return [];
+    }
+    if (firstCommand && STATUS_CONTRACT_COMMANDS.includes(firstCommand) && cursorIndex === 2) {
+        const contracts = getAllContracts(db)
+            .map((contract) => contract.id)
+            .filter((id) => typeof id === "string");
+        return contracts;
+    }
+    return TOP_LEVEL_COMMANDS.filter((cmd) => cmd.startsWith(normalizedWords[0] ?? ""));
+}
+export function renderBashCompletionScript() {
+    return `#!/usr/bin/env bash
+_sorokeep_complete() {
+  local cur prev words cword
+  _init_completion -n : || return
+
+  local suggestions
+  suggestions=$(sorokeep completion --query --cursor "$cword" "\${words[@]}" 2>/dev/null)
+  COMPREPLY=( $(compgen -W "$suggestions" -- "$cur") )
+}
+complete -F _sorokeep_complete sorokeep
+`;
+}
+export function renderZshCompletionScript() {
+    return [
+        "#compdef sorokeep",
+        "",
+        "_sorokeep() {",
+        "  local -a suggestions",
+        "  local -a words",
+        "",
+        '  local current_word=${words[CURRENT]}',
+        '  suggestions=( ${(f)"$(sorokeep completion --query --cursor "$CURRENT" "${words[@]}")"} )',
+        "  _describe 'values' suggestions",
+        "}",
+        "",
+        "compdef _sorokeep sorokeep",
+        "",
+    ].join("\n");
+}
+//# sourceMappingURL=completion.js.map

package/dist/core/completion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.js","sourceRoot":"","sources":["../../src/core/completion.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,OAAO;IACP,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,OAAO;IACP,WAAW;IACX,SAAS;IACT,UAAU;IACV,YAAY;CACb,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;AAC/E,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAC5D,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;AAEtG,MAAM,UAAU,wBAAwB,CACtC,EAAqB,EACrB,KAAe,EACf,WAAmB;IAEnB,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,IAAI,WAAW,IAAI,CAAC,EAAE,CAAC;QAC1C,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IACH,MAAM,eAAe,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,GAAG,CAAC,CAAC,CAAC;IACtD,MAAM,YAAY,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;IAExC,IAAI,YAAY,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,WAAW,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,kBAAkB,CAAC;QAC5B,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAEF,IAAI,YAAY,IAAI,wBAAwB,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,WAAW,KAAK,CAAC,EAAE,CAAC;QACxF,MAAM,SAAS,GAAG,eAAe,CAAC,EAAE,CAAC;aAClC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;aAC9B,MAAM,CAAC,CAAC,EAAE,EAAgB,EAAE,CAAC,OAAO,EAAE,KAAK,QAAQ,CAAC,CAAC;QACxD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AACtF,CAAC;AAED,MAAM,UAAU,0BAA0B;IACxC,OAAO;;;;;;;;;;CAUR,CAAC;AACF,CAAC;AAED,MAAM,UAAU,yBAAyB;IACvC,OAAO;QACL,mBAAmB;QACnB,EAAE;QACF,eAAe;QACf,wBAAwB;QACxB,kBAAkB;QAClB,EAAE;QACF,wCAAwC;QACxC,4FAA4F;QAC5F,kCAAkC;QAClC,GAAG;QACH,EAAE;QACF,4BAA4B;QAC5B,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/core/costs.d.ts

@@ -0,0 +1,90 @@
+import type Database from "better-sqlite3";
+import type { FeeStatsResult } from "../rpc/client.js";
+export interface EntryTypeCostBreakdown {
+    count: number;
+    costXlm: number;
+}
+export interface ExtensionCostDetail {
+    executedAt: string;
+    entryLabel: string;
+    entryType: string;
+    oldTtlLedgers: number;
+    newTtlLedgers: number;
+    oldTtlFormatted: string;
+    newTtlFormatted: string;
+    costXlm: number | null;
+    txHash: string;
+    executedAtLedger: number;
+}
+export interface CostProjection {
+    estimated30DayCostXlm: number;
+    basisDays: number;
+    formula: string;
+}
+export interface ExtensionCostsResult {
+    contract: {
+        id: string;
+        name: string | null;
+        network: string;
+    };
+    period: {
+        days: number | null;
+        label: string;
+    };
+    summary: {
+        totalExtensions: number;
+        totalCostXlm: number;
+    };
+    byEntryType: Record<string, EntryTypeCostBreakdown>;
+    recentExtensions: ExtensionCostDetail[];
+    projection?: CostProjection;
+    message?: string;
+}
+export type GetExtensionCostsError = {
+    success: false;
+    error: "contract_not_found";
+    contractId: string;
+} | {
+    success: false;
+    error: "invalid_period";
+    period: number;
+};
+export type GetExtensionCostsResponse = {
+    success: true;
+    data: ExtensionCostsResult;
+} | GetExtensionCostsError;
+export declare function getExtensionCosts(db: Database.Database, contractId: string, options?: {
+    period?: number;
+    all?: boolean;
+}): GetExtensionCostsResponse;
+export interface PeriodCostSummary {
+    days: number;
+    totalExtensions: number;
+    totalCostXlm: number;
+}
+export interface MultiPeriodCostsData {
+    contract: {
+        id: string;
+        name: string | null;
+        network: string;
+    };
+    periods: PeriodCostSummary[];
+    projection: FeeAdjustedProjection;
+}
+export type GetMultiPeriodCostsResponse = {
+    success: true;
+    data: MultiPeriodCostsData;
+} | {
+    success: false;
+    error: "contract_not_found";
+    contractId: string;
+};
+export declare function getMultiPeriodCosts(db: Database.Database, contractId: string, feeStats?: Pick<FeeStatsResult, "baseFeeStroops" | "surgePricingMultiplier">): GetMultiPeriodCostsResponse;
+export interface FeeAdjustedProjection {
+    baseProjectedCostXlm: number;
+    adjustedProjectedCostXlm: number;
+    baseFeeMultiplier: number;
+    surgePricingMultiplier: number;
+}
+export declare function calculateFeeAdjustedProjection(totalCostXlm: number, periodDays: number, feeStats?: Pick<FeeStatsResult, "baseFeeStroops" | "surgePricingMultiplier">): FeeAdjustedProjection;
+//# sourceMappingURL=costs.d.ts.map

package/dist/core/costs.d.ts.map

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

package/dist/core/costs.js

@@ -0,0 +1,147 @@
+import { getContract, getEntriesForContract, getExtensionHistory, } from "../db/repositories.js";
+import { formatTimeToCloseLedger } from "../utils/formatting.js";
+const DEFAULT_PERIOD_DAYS = 30;
+export function getExtensionCosts(db, contractId, options) {
+    const contract = getContract(db, contractId);
+    if (!contract) {
+        return {
+            success: false,
+            error: "contract_not_found",
+            contractId,
+        };
+    }
+    const allTime = options?.all === true;
+    const period = allTime ? undefined : (options?.period ?? DEFAULT_PERIOD_DAYS);
+    if (period !== undefined && (!Number.isInteger(period) || period <= 0)) {
+        return {
+            success: false,
+            error: "invalid_period",
+            period,
+        };
+    }
+    const history = getExtensionHistory(db, contractId, period);
+    const periodLabel = allTime ? "all time" : `last ${period} days`;
+    if (history.length === 0) {
+        return {
+            success: true,
+            data: {
+                contract: {
+                    id: contract.id,
+                    name: contract.name,
+                    network: contract.network,
+                },
+                period: {
+                    days: period ?? null,
+                    label: periodLabel,
+                },
+                summary: {
+                    totalExtensions: 0,
+                    totalCostXlm: 0,
+                },
+                byEntryType: {},
+                recentExtensions: [],
+                message: "No extensions recorded for this period.",
+            },
+        };
+    }
+    const entries = getEntriesForContract(db, contractId);
+    const entryMap = new Map(entries.map((entry) => [entry.id, entry]));
+    let totalCostXlm = 0;
+    const byEntryType = {};
+    for (const record of history) {
+        const cost = record.cost_xlm ?? 0;
+        totalCostXlm += cost;
+        const entry = entryMap.get(record.contract_entry_id);
+        const entryType = entry?.entry_type ?? "unknown";
+        if (!byEntryType[entryType]) {
+            byEntryType[entryType] = { count: 0, costXlm: 0 };
+        }
+        byEntryType[entryType].count++;
+        byEntryType[entryType].costXlm += cost;
+    }
+    const recentExtensions = history.map((record) => {
+        const entry = entryMap.get(record.contract_entry_id);
+        const entryLabel = entry?.label ?? entry?.entry_type ?? "unknown";
+        const entryType = entry?.entry_type ?? "unknown";
+        return {
+            executedAt: record.executed_at,
+            entryLabel,
+            entryType,
+            oldTtlLedgers: record.old_ttl_ledgers,
+            newTtlLedgers: record.new_ttl_ledgers,
+            oldTtlFormatted: formatTimeToCloseLedger(record.old_ttl_ledgers),
+            newTtlFormatted: formatTimeToCloseLedger(record.new_ttl_ledgers),
+            costXlm: record.cost_xlm,
+            txHash: record.tx_hash,
+            executedAtLedger: record.executed_at_ledger,
+        };
+    });
+    return {
+        success: true,
+        data: {
+            contract: {
+                id: contract.id,
+                name: contract.name,
+                network: contract.network,
+            },
+            period: {
+                days: period ?? null,
+                label: periodLabel,
+            },
+            summary: {
+                totalExtensions: history.length,
+                totalCostXlm,
+            },
+            byEntryType,
+            recentExtensions,
+            ...(period !== undefined
+                ? {
+                    projection: {
+                        estimated30DayCostXlm: (totalCostXlm / period) * 30,
+                        basisDays: period,
+                        formula: "linear extrapolation from period average",
+                    },
+                }
+                : {}),
+        },
+    };
+}
+const MULTI_PERIOD_WINDOWS = [7, 30, 90];
+export function getMultiPeriodCosts(db, contractId, feeStats) {
+    const contract = getContract(db, contractId);
+    if (!contract) {
+        return { success: false, error: "contract_not_found", contractId };
+    }
+    const periods = MULTI_PERIOD_WINDOWS.map((days) => {
+        const history = getExtensionHistory(db, contractId, days);
+        let totalCostXlm = 0;
+        for (const record of history) {
+            totalCostXlm += record.cost_xlm ?? 0;
+        }
+        return { days, totalExtensions: history.length, totalCostXlm };
+    });
+    const thirtyDay = periods.find((p) => p.days === 30);
+    const projection = calculateFeeAdjustedProjection(thirtyDay.totalCostXlm, 30, feeStats);
+    return {
+        success: true,
+        data: {
+            contract: { id: contract.id, name: contract.name, network: contract.network },
+            periods,
+            projection,
+        },
+    };
+}
+const DEFAULT_BASE_FEE_STROOPS = 100;
+export function calculateFeeAdjustedProjection(totalCostXlm, periodDays, feeStats) {
+    const baseProjectedCostXlm = (totalCostXlm / periodDays) * 30;
+    const liveBaseFee = feeStats?.baseFeeStroops ?? DEFAULT_BASE_FEE_STROOPS;
+    const baseFeeMultiplier = Math.max(liveBaseFee / DEFAULT_BASE_FEE_STROOPS, 0);
+    const surgePricingMultiplier = Math.max(feeStats?.surgePricingMultiplier ?? 1, 1);
+    return {
+        baseProjectedCostXlm,
+        adjustedProjectedCostXlm: baseProjectedCostXlm * baseFeeMultiplier * surgePricingMultiplier,
+        baseFeeMultiplier,
+        surgePricingMultiplier,
+    };
+}
+//# sourceMappingURL=costs.js.map

package/dist/core/costs.js.map

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

package/dist/core/decoder.d.ts

@@ -0,0 +1,7 @@
+export interface DecodedLedgerKey {
+    contractId: string;
+    symbol: any;
+    durability: string;
+}
+export declare function decodeLedgerKey(base64Key: string): DecodedLedgerKey;
+//# sourceMappingURL=decoder.d.ts.map

package/dist/core/decoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decoder.d.ts","sourceRoot":"","sources":["../../src/core/decoder.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,GAAG,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,CAqCnE"}

package/dist/core/decoder.js

@@ -0,0 +1,38 @@
+import { xdr, Address, scValToNative } from '@stellar/stellar-sdk';
+export function decodeLedgerKey(base64Key) {
+    const buf = Buffer.from(base64Key, 'base64');
+    const key = xdr.LedgerKey.fromXDR(buf);
+    if (key.switch() !== xdr.LedgerEntryType.contractData()) {
+        throw new Error('Unsupported ledger entry type');
+    }
+    const contractData = key.contractData();
+    const contractAddress = Address.fromScAddress(contractData.contract());
+    const contractId = contractAddress.toString();
+    const scValKey = contractData.key();
+    let symbol;
+    if (scValKey.switch() === xdr.ScValType.scvLedgerKeyContractInstance()) {
+        symbol = 'ContractInstance';
+    }
+    else {
+        try {
+            symbol = scValToNative(scValKey);
+        }
+        catch {
+            symbol = 'Unknown';
+        }
+    }
+    const durabilityType = contractData.durability();
+    let durability = 'Unknown';
+    if (durabilityType.value === xdr.ContractDataDurability.persistent().value) {
+        durability = 'Persistent';
+    }
+    else if (durabilityType.value === xdr.ContractDataDurability.temporary().value) {
+        durability = 'Temporary';
+    }
+    return {
+        contractId,
+        symbol,
+        durability
+    };
+}
+//# sourceMappingURL=decoder.js.map