sorokeep 1.0.0

package/dist/core/extension.js

@@ -0,0 +1,429 @@
+import { StellarRpcClient } from "../rpc/client.js";
+import { getAllContracts, getContract, getEntriesForContract, getExtensionPolicy, getChannelAccounts, recordExtension, upsertEntry, updateLastCheckedLedger, getAverageResourceUsage, getBudget, addBudgetSpent, countExtensionsInLastHour, } from "../db/repositories.js";
+import { ChannelAccountPool } from "./channels.js";
+import { getLogger } from "../logging/index.js";
+import { formatSecretKey } from "../utils/formatting.js";
+import { VaultResolver } from "./vault.js";
+import { loadConfig } from "../utils/config.js";
+const logger = getLogger().child({ component: "Extension" });
+// ─── Rate limiter ─────────────────────────────────────────────────────────────
+/**
+ * Maximum number of auto-extension transactions allowed per contract per hour.
+ * Prevents runaway fee submissions under extreme network load (issue #142).
+ */
+export const HOURLY_RATE_LIMIT = 5;
+/**
+ * Check whether the given contract has reached its hourly auto-extension rate limit.
+ *
+ * Queries `extension_history` for records within the last 60 minutes and
+ * compares the count against `limit` (default: HOURLY_RATE_LIMIT).
+ *
+ * @param db - The SQLite database connection.
+ * @param contractId - The contract to check.
+ * @param limit - Maximum allowed extensions per hour (defaults to HOURLY_RATE_LIMIT).
+ * @returns `true` when the contract is rate-limited; `false` otherwise.
+ */
+export function isRateLimited(db, contractId, limit = HOURLY_RATE_LIMIT) {
+    const count = countExtensionsInLastHour(db, contractId);
+    return count >= limit;
+}
+export async function simulateExtension(db, contractId, entryKeyXdrs, extendToLedgers, sourcePublicKey, rpcUrl) {
+    const contract = getContract(db, contractId);
+    if (!contract) {
+        return { success: false, contractId, entriesExtended: 0, error: "Contract not found" };
+    }
+    const client = new StellarRpcClient(contract.network, rpcUrl);
+    let sim;
+    try {
+        sim = await client.simulateExtension(entryKeyXdrs, extendToLedgers, sourcePublicKey);
+    }
+    catch (err) {
+        logger.warn(`Simulation warning for ${contractId}: ${err.message}`);
+        return {
+            success: false,
+            contractId,
+            entriesExtended: 0,
+            error: err.message,
+        };
+    }
+    return {
+        success: true,
+        contractId,
+        entriesExtended: entryKeyXdrs.length,
+        estimatedFee: sim.minResourceFee,
+        cpuInsns: sim.cpuInstructions,
+        memBytes: sim.memoryBytes,
+        readBytes: sim.readBytes,
+        writeBytes: sim.writeBytes,
+    };
+}
+export async function extendEntries(db, contractId, entryKeyXdrs, extendToLedgers, secretKey, rpcUrl, sponsorSecret) {
+    const contract = getContract(db, contractId);
+    if (!contract) {
+        return { success: false, contractId, entriesExtended: 0, error: "Contract not found" };
+    }
+    if (entryKeyXdrs.length === 0) {
+        return { success: false, contractId, entriesExtended: 0, error: "No entries to extend" };
+    }
+    const client = new StellarRpcClient(contract.network, rpcUrl);
+    logger.info(`Extending ${entryKeyXdrs.length} entries for ${contractId} to ${extendToLedgers} ledgers`);
+    const resolvedSponsorSecret = sponsorSecret ? await resolveSecretKey(sponsorSecret) : undefined;
+    if (sponsorSecret && !resolvedSponsorSecret) {
+        return {
+            success: false,
+            contractId,
+            entriesExtended: 0,
+            error: `Failed to resolve sponsor secret key from environment variable: ${sponsorSecret}`,
+        };
+    }
+    let txResult;
+    try {
+        txResult = resolvedSponsorSecret
+            ? await client.submitExtensionWithFeeBump(entryKeyXdrs, extendToLedgers, secretKey, resolvedSponsorSecret)
+            : await client.submitExtension(entryKeyXdrs, extendToLedgers, secretKey);
+    }
+    catch (err) {
+        logger.warn(`Simulation warning for ${contractId}: ${err.message}`);
+        return {
+            success: false,
+            contractId,
+            entriesExtended: 0,
+            error: err.message,
+        };
+    }
+    if (!txResult.success) {
+        logger.error(`Extension failed for ${contractId}: ${txResult.error}`);
+        return {
+            success: false,
+            contractId,
+            entriesExtended: 0,
+            txHash: txResult.txHash || undefined,
+            error: txResult.error,
+        };
+    }
+    let isAnomaly = false;
+    let anomalyDetails = undefined;
+    if (txResult.cpuInsns && txResult.memBytes) {
+        const baseline = getAverageResourceUsage(db, contractId, 10);
+        if (baseline && baseline.avg_cpu_insns > 0 && baseline.avg_mem_bytes > 0) {
+            const cpuRatio = txResult.cpuInsns / baseline.avg_cpu_insns;
+            const memRatio = txResult.memBytes / baseline.avg_mem_bytes;
+            if (cpuRatio >= 2.0 || memRatio >= 2.0) {
+                isAnomaly = true;
+                const details = [];
+                if (cpuRatio >= 2.0)
+                    details.push(`CPU usage is ${cpuRatio.toFixed(2)}x baseline`);
+                if (memRatio >= 2.0)
+                    details.push(`Memory usage is ${memRatio.toFixed(2)}x baseline`);
+                anomalyDetails = `Resource anomaly detected: ` + details.join(", ");
+            }
+        }
+    }
+    const freshTTLs = await client.getEntryTTLs(entryKeyXdrs);
+    const entries = getEntriesForContract(db, contractId);
+    const entryMap = new Map(entries.map(e => [e.entry_key_xdr, e]));
+    const updateDb = db.transaction(() => {
+        for (const freshEntry of freshTTLs.entries) {
+            const dbEntry = entryMap.get(freshEntry.entryKeyXdr);
+            if (!dbEntry)
+                continue;
+            const oldTTL = dbEntry.live_until_ledger
+                ? dbEntry.live_until_ledger - freshTTLs.latestLedger
+                : 0;
+            recordExtension(db, {
+                contract_id: contractId,
+                contract_entry_id: dbEntry.id,
+                old_ttl_ledgers: Math.max(0, oldTTL),
+                new_ttl_ledgers: freshEntry.remainingTTL,
+                tx_hash: txResult.txHash,
+                cpu_insns: txResult.cpuInsns,
+                mem_bytes: txResult.memBytes,
+                is_anomaly: isAnomaly,
+                executed_at_ledger: freshTTLs.latestLedger,
+            });
+            upsertEntry(db, {
+                contract_id: contractId,
+                entry_key_xdr: freshEntry.entryKeyXdr,
+                entry_type: dbEntry.entry_type,
+                label: dbEntry.label ?? undefined,
+                live_until_ledger: freshEntry.liveUntilLedgerSeq,
+                last_modified_ledger: freshEntry.lastModifiedLedgerSeq,
+                discovery_source: dbEntry.discovery_source,
+            });
+        }
+        updateLastCheckedLedger(db, contractId, freshTTLs.latestLedger);
+    });
+    updateDb();
+    return {
+        success: true,
+        contractId,
+        entriesExtended: entryKeyXdrs.length,
+        txHash: txResult.txHash,
+        ledger: txResult.ledger,
+        feeCharged: txResult.feeCharged,
+        cpuInsns: txResult.cpuInsns,
+        memBytes: txResult.memBytes,
+        isAnomaly,
+        anomalyDetails,
+    };
+}
+export async function runAutoExtensions(db, network, rpcUrl, sponsorSecret) {
+    const result = {
+        contractsChecked: 0,
+        contractsExtended: 0,
+        entriesExtended: 0,
+        errors: [],
+        extensions: [],
+    };
+    const contracts = getAllContracts(db).filter(c => c.network === network);
+    const eligibleContracts = contracts.filter(c => {
+        const p = getExtensionPolicy(db, c.id);
+        return p && p.enabled;
+    });
+    if (eligibleContracts.length === 0)
+        return result;
+    const client = new StellarRpcClient(network, rpcUrl);
+    const latestLedger = await client.getCurrentLedger();
+    const channelAccounts = getChannelAccounts(db, network);
+    const pool = channelAccounts.length > 0
+        ? new ChannelAccountPool(db, network)
+        : null;
+    result.contractsChecked = eligibleContracts.length;
+    await Promise.all(eligibleContracts.map(async (contract) => {
+        const policy = getExtensionPolicy(db, contract.id);
+        try {
+            const entries = getEntriesForContract(db, contract.id);
+            const needsExtension = entries.filter(e => {
+                if (!e.live_until_ledger)
+                    return false;
+                const remaining = e.live_until_ledger - latestLedger;
+                return remaining >= 0 && remaining < policy.extend_when_below_ledgers;
+            });
+            if (needsExtension.length === 0)
+                return;
+            // ── Rate limit check (issue #142) ────────────────────────────────
+            // Block auto-extension if the contract has already hit the maximum
+            // number of extension transactions allowed per hour.
+            if (isRateLimited(db, contract.id)) {
+                const count = countExtensionsInLastHour(db, contract.id);
+                const msg = `Contract ${contract.id}: rate limit reached — ${count}/${HOURLY_RATE_LIMIT} extensions in the last hour. Skipping.`;
+                logger.warn(msg);
+                result.errors.push(msg);
+                return;
+            }
+            // Resolve secret key: prefer channel pool, fall back to policy keypair
+            let secretKey = null;
+            let slot = null;
+            if (pool) {
+                slot = await pool.acquire();
+                secretKey = await resolveSecretKey(slot.keypairSource);
+                if (!secretKey) {
+                    pool.release(slot.publicKey);
+                    slot = null;
+                }
+            }
+            if (!secretKey) {
+                secretKey = await resolveSecretKey(policy.keypair_source);
+            }
+            if (!secretKey) {
+                result.errors.push(`Contract ${contract.id}: Cannot resolve keypair from source "${pool ? "channel pool" : formatSecretKey(policy.keypair_source)}"`);
+                return;
+            }
+            const entryKeys = needsExtension.map(e => e.entry_key_xdr);
+            logger.info(`Auto-extending ${entryKeys.length} entries for ${contract.id} ` +
+                `(below ${policy.extend_when_below_ledgers}, target ${policy.target_ttl_ledgers})`);
+            try {
+                const billingCycle = new Date().toISOString().slice(0, 7);
+                const budget = getBudget(db, contract.id, billingCycle);
+                let estimatedFeeXlm = 0;
+                if (budget) {
+                    const { Keypair } = await import("@stellar/stellar-sdk");
+                    const pubKey = Keypair.fromSecret(secretKey).publicKey();
+                    const simResult = await simulateExtension(db, contract.id, entryKeys, policy.target_ttl_ledgers, pubKey, rpcUrl);
+                    if (!simResult.success) {
+                        throw new Error(`Simulation failed: ${simResult.error}`);
+                    }
+                    estimatedFeeXlm = (simResult.estimatedFee || 0) / 10000000;
+                    if (budget.spent_xlm + estimatedFeeXlm > budget.limit_xlm) {
+                        throw new Error(`budget limit exceeded. Estimated cost: ${estimatedFeeXlm} XLM, Remaining: ${budget.limit_xlm - budget.spent_xlm} XLM`);
+                    }
+                }
+                const extResult = await extendEntries(db, contract.id, entryKeys, policy.target_ttl_ledgers, secretKey, rpcUrl, sponsorSecret);
+                if (extResult.success) {
+                    if (budget && estimatedFeeXlm > 0) {
+                        const actualFeeXlm = extResult.feeCharged !== undefined ? extResult.feeCharged / 10000000 : estimatedFeeXlm;
+                        addBudgetSpent(db, contract.id, billingCycle, actualFeeXlm);
+                    }
+                    if (!extResult.txHash || extResult.ledger == null) {
+                        result.errors.push(`Contract ${contract.id}: Extension succeeded but RPC returned no txHash or ledger`);
+                    }
+                    else {
+                        result.contractsExtended++;
+                        result.entriesExtended += extResult.entriesExtended;
+                        result.extensions.push({
+                            contractId: contract.id,
+                            txHash: extResult.txHash,
+                            entriesExtended: extResult.entriesExtended,
+                            ledger: extResult.ledger,
+                            isAnomaly: extResult.isAnomaly,
+                            anomalyDetails: extResult.anomalyDetails,
+                        });
+                    }
+                }
+                else {
+                    result.errors.push(`Contract ${contract.id}: Extension failed — ${extResult.error}`);
+                }
+            }
+            finally {
+                if (slot && pool)
+                    pool.release(slot.publicKey);
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            result.errors.push(`Contract ${contract.id}: ${message}`);
+            logger.error(`Auto-extension error for ${contract.id}: ${message}`, err);
+        }
+    }));
+    return result;
+}
+export async function simulateRestore(db, contractId, entryKeyXdrs, sourcePublicKey, rpcUrl) {
+    const contract = getContract(db, contractId);
+    if (!contract) {
+        return { success: false, contractId, entriesRestored: 0, error: "Contract not found" };
+    }
+    const client = new StellarRpcClient(contract.network, rpcUrl);
+    const sim = await client.simulateRestore(entryKeyXdrs, sourcePublicKey);
+    if (!sim.success) {
+        return { success: false, contractId, entriesRestored: 0, error: sim.error };
+    }
+    return {
+        success: true,
+        contractId,
+        entriesRestored: entryKeyXdrs.length,
+        estimatedFee: sim.minResourceFee,
+    };
+}
+export async function restoreEntries(db, contractId, entryKeyXdrs, secretKey, rpcUrl) {
+    const contract = getContract(db, contractId);
+    if (!contract) {
+        return { success: false, contractId, entriesRestored: 0, error: "Contract not found" };
+    }
+    if (entryKeyXdrs.length === 0) {
+        return { success: false, contractId, entriesRestored: 0, error: "No entries to restore" };
+    }
+    const client = new StellarRpcClient(contract.network, rpcUrl);
+    logger.info(`Restoring ${entryKeyXdrs.length} entries for ${contractId}`);
+    let txResult;
+    try {
+        txResult = await client.submitRestore(entryKeyXdrs, secretKey);
+    }
+    catch (err) {
+        logger.warn(`Simulation warning for ${contractId}: ${err.message}`);
+        return {
+            success: false,
+            contractId,
+            entriesRestored: 0,
+            error: err.message,
+        };
+    }
+    if (!txResult.success) {
+        logger.error(`Restore failed for ${contractId}: ${txResult.error}`);
+        return {
+            success: false,
+            contractId,
+            entriesRestored: 0,
+            txHash: txResult.txHash || undefined,
+            error: txResult.error,
+        };
+    }
+    const freshTTLs = await client.getEntryTTLs(entryKeyXdrs);
+    const entries = getEntriesForContract(db, contractId);
+    const entryMap = new Map(entries.map(e => [e.entry_key_xdr, e]));
+    let restored = 0;
+    const updateDb = db.transaction(() => {
+        for (const freshEntry of freshTTLs.entries) {
+            const dbEntry = entryMap.get(freshEntry.entryKeyXdr);
+            if (!dbEntry)
+                continue;
+            upsertEntry(db, {
+                contract_id: contractId,
+                entry_key_xdr: freshEntry.entryKeyXdr,
+                entry_type: dbEntry.entry_type,
+                label: dbEntry.label ?? undefined,
+                live_until_ledger: freshEntry.liveUntilLedgerSeq,
+                last_modified_ledger: freshEntry.lastModifiedLedgerSeq,
+                discovery_source: dbEntry.discovery_source,
+            });
+            restored++;
+        }
+        updateLastCheckedLedger(db, contractId, freshTTLs.latestLedger);
+    });
+    updateDb();
+    logger.info(`Restore successful for ${contractId}: tx=${txResult.txHash}, entries=${restored}`);
+    return {
+        success: true,
+        contractId,
+        entriesRestored: restored,
+        txHash: txResult.txHash,
+        ledger: txResult.ledger,
+        cpuInsns: txResult.cpuInsns,
+        memBytes: txResult.memBytes,
+        minResourceFee: txResult.minResourceFee,
+        feeCharged: txResult.feeCharged,
+    };
+}
+// ─── Private helpers ──────────────────────────────────────────────────────────
+/**
+ * Resolve a secret key from a keypair_source string.
+ * Supports:
+ *   - "env:VAR_NAME" — reads from environment variable
+ *   - "vault:<secret_path>" — reads from HashiCorp Vault (KV v1/v2)
+ *   - Direct secret key string starting with "S" (56 chars)
+ */
+export async function resolveSecretKey(source) {
+    if (!source)
+        return null;
+    if (source.startsWith("env:")) {
+        const envVar = source.slice(4);
+        const value = process.env[envVar];
+        if (!value) {
+            logger.warn(`Environment variable ${envVar} not set`);
+            return null;
+        }
+        return value;
+    }
+    if (source.startsWith("vault:")) {
+        const vaultPath = source.slice(6);
+        if (!vaultPath) {
+            logger.warn("Vault keypair_source is empty");
+            return null;
+        }
+        try {
+            const config = loadConfig();
+            if (!config.vault?.url || !config.vault?.token) {
+                logger.error("Vault resolver requested but vault configuration missing in config.yaml (vault.url / vault.token)");
+                return null;
+            }
+            const resolver = new VaultResolver({
+                url: config.vault.url,
+                token: config.vault.token,
+                namespace: config.vault.namespace,
+            });
+            const secret = await resolver.getSecret(vaultPath);
+            return secret;
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            logger.error(`Failed to resolve secret from Vault path "${vaultPath}": ${message}`);
+            return null;
+        }
+    }
+    // Direct secret key
+    if (source.startsWith("S") && source.length === 56) {
+        return source;
+    }
+    logger.warn(`Unknown keypair_source format: ${formatSecretKey(source)}`);
+    return null;
+}
+//# sourceMappingURL=extension.js.map

package/dist/core/extension.js.map

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

package/dist/core/inspect.d.ts

@@ -0,0 +1,62 @@
+import type Database from "better-sqlite3";
+import { xdr } from "@stellar/stellar-sdk";
+export interface InspectOptions {
+    entries?: string[];
+    network?: string;
+    rpcUrl?: string;
+}
+export interface DecodedScVal {
+    type: string;
+    value: any;
+}
+export interface InspectEntryInfo {
+    inputEntry: string;
+    entryKeyXdr: string;
+    type: "balance" | "raw";
+    found: boolean;
+    remainingTTL?: number | null;
+    approximateTimeRemaining?: string | null;
+    status?: string;
+    balance?: {
+        amount: bigint;
+        authorized: boolean;
+        clawback: boolean;
+    };
+    formattedBalance?: string;
+    decodedValue?: DecodedScVal;
+}
+export interface InspectResult {
+    success: boolean;
+    contractId: string;
+    contractName?: string | null;
+    network?: string;
+    isSac?: boolean;
+    decimals?: number;
+    results?: InspectEntryInfo[];
+    error?: string;
+}
+/**
+ * Format token balance in stroops/raw units to string representation with decimals.
+ */
+export declare function formatTokenBalance(amount: bigint | number | string, decimals: number): string;
+/**
+ * Custom parser for SAC balance map layout.
+ */
+export declare function parseSacBalance(scVal: xdr.ScVal | string): {
+    amount: bigint;
+    authorized: boolean;
+    clawback: boolean;
+};
+/**
+ * Build storage key XDR for a SAC address balance entry.
+ */
+export declare function buildSacBalanceKeyXdr(contractId: string, address: string): string;
+/**
+ * Inspect contract storage and token balances on SAC contracts.
+ */
+export declare function inspectContract(db: Database.Database, contractId: string, options?: InspectOptions): Promise<InspectResult>;
+/**
+ * Decode a base64 XDR ScVal string into a JSON-friendly structure.
+ */
+export declare function decodeScVal(scValBase64: string): DecodedScVal;
+//# sourceMappingURL=inspect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.d.ts","sourceRoot":"","sources":["../../src/core/inspect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,GAAG,EAAkC,MAAM,sBAAsB,CAAC;AAQ3E,MAAM,WAAW,cAAc;IAC3B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,GAAG,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,SAAS,GAAG,KAAK,CAAC;IACxB,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,wBAAwB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE;QACN,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,OAAO,CAAC;QACpB,QAAQ,EAAE,OAAO,CAAC;KACrB,CAAC;IACF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,YAAY,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAiB7F;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,GAAG,CAAC,KAAK,GAAG,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAgCrH;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAwBjF;AAED;;GAEG;AACH,wBAAsB,eAAe,CACjC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,cAAmB,GAC7B,OAAO,CAAC,aAAa,CAAC,CAuJxB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,CAO7D"}