sorokeep 1.0.0

package/dist/commands/restore.js

@@ -0,0 +1,92 @@
+import chalk from "chalk";
+import ora from "ora";
+import { getDatabase } from "../db/database.js";
+import { getContract, getEntriesForContract } from "../db/repositories.js";
+import { restoreEntries } from "../core/extension.js";
+import { formatContractID } from "../utils/formatting.js";
+import { getLogger } from "../logging/index.js";
+const logger = getLogger().child({ component: "RestoreCommand" });
+export function registerRestoreCommand(program) {
+    program
+        .command("restore <contractId>")
+        .description("Restore archived entries for a contract")
+        .option("--keypair <secret>", "Stellar secret key for signing restore transactions")
+        .option("--keypair-env <var>", "Environment variable containing the secret key")
+        .option("--entry <keyXdr>", "Specific entry key XDR to restore (can be used multiple times)", collect, [])
+        .option("--all", "Restore all tracked entries for the contract")
+        .action(async (contractId, options) => {
+        try {
+            const db = getDatabase();
+            const contract = getContract(db, contractId);
+            if (!contract) {
+                console.error(chalk.red(`Contract ${formatContractID(contractId)} not found. Run 'sorokeep watch' first.`));
+                process.exit(1);
+            }
+            let secretKey;
+            if (options.keypairEnv) {
+                secretKey = process.env[options.keypairEnv];
+                if (!secretKey) {
+                    console.error(chalk.red(`Environment variable ${options.keypairEnv} is not set`));
+                    process.exit(1);
+                }
+            }
+            else if (options.keypair) {
+                secretKey = options.keypair;
+            }
+            if (!secretKey) {
+                console.error(chalk.red("--keypair or --keypair-env is required for restoration"));
+                process.exit(1);
+            }
+            let entryKeys;
+            if (options.all && options.entry && options.entry.length > 0) {
+                console.error(chalk.red("Use either --entry <keyXdr> or --all, not both"));
+                process.exit(1);
+            }
+            if (options.entry && options.entry.length > 0) {
+                entryKeys = options.entry;
+            }
+            else if (options.all) {
+                const entries = getEntriesForContract(db, contractId);
+                entryKeys = entries.map(e => e.entry_key_xdr);
+            }
+            else {
+                console.error(chalk.red("Specify --entry <keyXdr> or --all to select entries to restore"));
+                process.exit(1);
+            }
+            if (entryKeys.length === 0) {
+                console.log(chalk.yellow("No entries to restore"));
+                return;
+            }
+            const displayName = contract.name ?? formatContractID(contractId);
+            const spinner = ora(`Restoring ${entryKeys.length} entries for ${displayName}...`).start();
+            const result = await restoreEntries(db, contractId, entryKeys, secretKey);
+            if (result.success) {
+                spinner.succeed(chalk.green(`Restored ${result.entriesRestored} entries for ${displayName}`));
+                console.log(`  Tx hash:     ${result.txHash}`);
+                console.log(`  Ledger:      ${result.ledger}`);
+                if (result.feeCharged !== undefined) {
+                    const feeXlm = (result.feeCharged / 10_000_000).toFixed(7);
+                    console.log(`  Fee spent:   ${feeXlm} XLM (${result.feeCharged} stroops)`);
+                }
+                console.log(chalk.dim(`\n  Run 'sorokeep status ${formatContractID(contractId)}' to verify.`));
+            }
+            else {
+                spinner.fail(chalk.red(`Restore failed: ${result.error}`));
+                if (result.txHash) {
+                    console.log(`  Tx hash: ${result.txHash}`);
+                }
+                process.exit(1);
+            }
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            logger.error("Restore command failed", { error: msg });
+            console.error(chalk.red(`Error: ${msg}`));
+            process.exit(1);
+        }
+    });
+}
+function collect(value, previous) {
+    return previous.concat([value]);
+}
+//# sourceMappingURL=restore.js.map

package/dist/commands/restore.js.map

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

package/dist/commands/resume.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const registerResumeCommand: (program: Command) => void;
+//# sourceMappingURL=resume.d.ts.map

package/dist/commands/resume.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume.d.ts","sourceRoot":"","sources":["../../src/commands/resume.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpC,eAAO,MAAM,qBAAqB,GAAI,SAAS,OAAO,KAAG,IAwBxD,CAAC"}

package/dist/commands/resume.js

@@ -0,0 +1,31 @@
+import chalk from "chalk";
+import { getDatabase } from "../db/database.js";
+import { getContract, setContractActiveStatus } from "../db/repositories.js";
+import { formatContractID } from "../utils/formatting.js";
+import { getLogger } from "../logging/index.js";
+const logger = getLogger().child({ component: "ResumeCommand" });
+export const registerResumeCommand = (program) => {
+    program
+        .command("resume <contract-id>")
+        .description("Resume daemon polling and alerting for a paused contract")
+        .action(async (contractId) => {
+        try {
+            const db = getDatabase();
+            const contract = getContract(db, contractId);
+            if (!contract) {
+                console.log(chalk.red(`Contract ${formatContractID(contractId)} is not being watched.`));
+                process.exit(1);
+                return;
+            }
+            setContractActiveStatus(db, contractId, true);
+            console.log(chalk.green(`Successfully resumed monitoring for ${formatContractID(contractId)}.`));
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            logger.error("Resume command failed", { error: errorMessage });
+            console.log(chalk.red(`Failed to resume contract: ${errorMessage}`));
+            process.exit(1);
+        }
+    });
+};
+//# sourceMappingURL=resume.js.map

package/dist/commands/resume.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume.js","sourceRoot":"","sources":["../../src/commands/resume.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,eAAe,EAAE,CAAC,CAAC;AAEjE,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,OAAgB,EAAQ,EAAE;IAC5D,OAAO;SACF,OAAO,CAAC,sBAAsB,CAAC;SAC/B,WAAW,CAAC,0DAA0D,CAAC;SACvE,MAAM,CAAC,KAAK,EAAE,UAAkB,EAAE,EAAE;QACjC,IAAI,CAAC;YACD,MAAM,EAAE,GAAG,WAAW,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAG,WAAW,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;YAE7C,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACZ,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,gBAAgB,CAAC,UAAU,CAAC,wBAAwB,CAAC,CAAC,CAAC;gBACzF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAChB,OAAO;YACX,CAAC;YAED,uBAAuB,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;YAC9C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,uCAAuC,gBAAgB,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;QACrG,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YAClB,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5E,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;YAC/D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,8BAA8B,YAAY,EAAE,CAAC,CAAC,CAAC;YACrE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACL,CAAC,CAAC,CAAC;AACX,CAAC,CAAC"}

package/dist/commands/status.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function registerStatusCommand(program: Command): void;
+//# sourceMappingURL=status.d.ts.map

package/dist/commands/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmE5D"}

package/dist/commands/status.js

@@ -0,0 +1,63 @@
+import chalk from "chalk";
+import { getDatabase } from "../db/database.js";
+import { getContractStatus, ContractNotFoundError } from "../core/status.js";
+import { statusIndicator, formatContractID, } from "../utils/formatting.js";
+export function registerStatusCommand(program) {
+    program
+        .command("status <contractId>")
+        .description("Show TTL and storage health for a watched contract")
+        .option("--json", "Output machine-readable JSON")
+        .action((contractId, options = {}) => {
+        const db = getDatabase();
+        try {
+            const status = getContractStatus(db, contractId);
+            if (options.json) {
+                console.log(JSON.stringify(status, null, 2));
+                return;
+            }
+            const displayName = status.name ?? formatContractID(contractId);
+            console.log();
+            console.log(chalk.bold(`  ${displayName}`) + chalk.dim(` (${formatContractID(contractId)})`));
+            console.log(`  Network: ${chalk.cyan(status.network)}`);
+            if (status.lastCheckedLedger != null) {
+                console.log(chalk.dim(`  Last checked: ledger ${status.lastCheckedLedger.toLocaleString()}`));
+            }
+            console.log();
+            if (status.entries.length === 0) {
+                console.log(chalk.yellow("  No entries tracked for this contract."));
+                console.log();
+                return;
+            }
+            const maxLabelLen = Math.max(...status.entries.map((entry) => entry.label.length));
+            for (const entry of status.entries) {
+                const paddedLabel = entry.label.padEnd(maxLabelLen);
+                if (entry.status === "unknown") {
+                    console.log(`  ${paddedLabel}  TTL: ${chalk.dim("unknown")}`);
+                    continue;
+                }
+                console.log(`  ${paddedLabel}  TTL: ${entry.remainingTTL.toLocaleString().padStart(9)} ledgers (${entry.approximateTimeRemaining})  ${statusIndicator(entry.status)}`);
+            }
+            console.log();
+        }
+        catch (error) {
+            if (error instanceof ContractNotFoundError || (error instanceof Error && error.name === "ContractNotFoundError")) {
+                if (options.json) {
+                    console.log(JSON.stringify({
+                        success: false,
+                        error: "contract_not_found",
+                        contractId,
+                        message: `Contract ${formatContractID(contractId)} is not registered.`,
+                    }));
+                }
+                else {
+                    console.log(chalk.red(`Contract ${formatContractID(contractId)} is not registered.`));
+                    console.log(chalk.dim("Run 'sorokeep watch <contractId>' first."));
+                }
+                process.exit(1);
+                return;
+            }
+            throw error;
+        }
+    });
+}
+//# sourceMappingURL=status.js.map

package/dist/commands/status.js.map

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

package/dist/commands/watch.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const registerWatchCommand: (program: Command) => void;
+//# sourceMappingURL=watch.d.ts.map

package/dist/commands/watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../src/commands/watch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkBpC,eAAO,MAAM,oBAAoB,GAAI,SAAS,OAAO,KAAG,IAqMvD,CAAC"}

package/dist/commands/watch.js

@@ -0,0 +1,163 @@
+import chalk from "chalk";
+import readline from "node:readline";
+import ora from "ora";
+import { getDatabase } from "../db/database.js";
+import { deleteContract, getContract } from "../db/repositories.js";
+import { getLogger } from "../logging/index.js";
+import { classifyTTL, formatContractID, formatTimeToCloseLedger, statusIndicator, } from "../utils/formatting.js";
+import { watchContract } from "../core/watch.js";
+import { loadWatchContractsFile } from "../utils/watch-config.js";
+const logger = getLogger().child({ component: "WatchCommand" });
+export const registerWatchCommand = (program) => {
+    program
+        .command("watch [contract-id]")
+        .description("Register and start watching a contract")
+        .option("-n, --name <name>", "A human-readable name for the contract")
+        .option("--network <network>", "The stellar network to use (testnet, mainnet)", "testnet")
+        .option("-r, --rpc-url <url>", "Custom RPC URL")
+        .option("--storage-keys <keys>", "Comma-separated base64 XDR storage keys to watch")
+        .option("--no-introspection", "Skip automatic contract introspection (WASM code fetching)")
+        .option("--from-file <path>", "Load multiple contract registrations from a YAML or JSON file")
+        .action(async (contractId, options) => {
+        try {
+            const db = getDatabase();
+            if (options.fromFile) {
+                const configs = loadWatchContractsFile(options.fromFile);
+                const results = [];
+                for (const config of configs) {
+                    const watchResult = await watchContract(db, {
+                        contractId: config.contractId,
+                        network: config.network,
+                        name: config.name,
+                        rpcUrl: config.rpcUrl,
+                        storageKeys: config.storageKeys,
+                        noIntrospection: config.noIntrospection,
+                    });
+                    results.push({
+                        contractId: config.contractId,
+                        name: config.name,
+                        network: config.network,
+                        status: watchResult.success ? "SUCCESS" : "FAILED",
+                        message: watchResult.success
+                            ? `Registered ${config.name ?? formatContractID(config.contractId)}`
+                            : watchResult.error,
+                    });
+                }
+                printBatchSummary(results);
+                if (results.some((result) => result.status === "FAILED")) {
+                    process.exit(1);
+                }
+                return;
+            }
+            if (!contractId) {
+                console.log(chalk.red("A contract ID is required unless --from-file is provided."));
+                process.exit(1);
+                return;
+            }
+            const displayId = formatContractID(contractId);
+            const spinner = ora(`Registering contract ${formatContractID(contractId)} and discovering entries...`).start();
+            const watchResult = await watchContract(db, {
+                contractId,
+                network: options.network,
+                name: options.name,
+                rpcUrl: options.rpcUrl,
+                storageKeys: options.storageKeys,
+                noIntrospection: options.noIntrospection,
+            });
+            if (!watchResult.success) {
+                spinner.fail(chalk.red(watchResult.error));
+                process.exit(1);
+                return;
+            }
+            spinner.succeed(chalk.green(`Contract ${options.name || displayId} registered successfully.`));
+            const entryCount = 1 +
+                (watchResult.wasm ? 1 : 0) +
+                (options.storageKeys ? options.storageKeys.split(",").length : 0);
+            console.log(`\n  Contract: ${chalk.cyan(options.name ?? displayId)} (${chalk.dim(displayId)})`);
+            console.log(`  Network:  ${chalk.cyan(options.network)}`);
+            console.log(`  Entries:  ${chalk.cyan(entryCount)} discovered`);
+            const instanceTTL = watchResult.instance.remainingTTL;
+            const instanceStatus = classifyTTL(instanceTTL);
+            console.log(`  Instance TTL: ${instanceTTL.toLocaleString()} ledgers (${formatTimeToCloseLedger(instanceTTL)})  ${statusIndicator(instanceStatus)}`);
+            if (watchResult.wasm) {
+                const wasmTTL = watchResult.wasm.remainingTTL;
+                const wasmStatus = classifyTTL(wasmTTL);
+                console.log(`  WASM Code TTL: ${wasmTTL.toLocaleString()} ledgers (${formatTimeToCloseLedger(wasmTTL)})  ${statusIndicator(wasmStatus)}`);
+            }
+            if (watchResult.wasmWarning) {
+                console.warn(chalk.yellow(`\n  ⚠ ${watchResult.wasmWarning}`));
+            }
+            console.log(chalk.dim("\n  Run 'sorokeep status " +
+                formatContractID(contractId) +
+                "' to check TTLs anytime."));
+            console.log(chalk.dim("  Run 'sorokeep guard " +
+                formatContractID(contractId) +
+                "' to enable auto-extension."));
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            logger.error("Watch command failed", { error: errorMessage });
+            console.log(chalk.red(`Failed to watch contract: ${errorMessage}`));
+            process.exit(1);
+        }
+    });
+    program
+        .command("unwatch <contract-id>")
+        .description("Remove a registered contract and clean up associated logs")
+        .option("-y, --yes", "Skip confirmation prompt")
+        .action(async (contractId, options) => {
+        try {
+            const db = getDatabase();
+            const contract = getContract(db, contractId);
+            if (!contract) {
+                console.log(chalk.red(`Contract ${formatContractID(contractId)} is not being watched.`));
+                process.exit(1);
+                return;
+            }
+            const proceedWithDeletion = async () => {
+                deleteContract(db, contractId);
+                console.log(chalk.green(`Successfully unwatched contract ${formatContractID(contractId)}.`));
+            };
+            if (options.yes) {
+                await proceedWithDeletion();
+            }
+            else {
+                const rl = readline.createInterface({
+                    input: process.stdin,
+                    output: process.stdout,
+                });
+                rl.question(chalk.yellow(`Are you sure you want to unwatch ${formatContractID(contractId)}? All associated logs, alerts, and policies will be permanently deleted. (y/N): `), async (answer) => {
+                    rl.close();
+                    if (answer.toLowerCase() === "y" || answer.toLowerCase() === "yes") {
+                        await proceedWithDeletion();
+                    }
+                    else {
+                        console.log("Unwatch cancelled.");
+                    }
+                });
+            }
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            logger.error("Unwatch command failed", { error: errorMessage });
+            console.log(chalk.red(`Failed to unwatch contract: ${errorMessage}`));
+            process.exit(1);
+        }
+    });
+};
+function printBatchSummary(results) {
+    const rows = results.map((result) => {
+        const label = result.name ?? formatContractID(result.contractId);
+        return `${result.status.padEnd(7)} | ${label.padEnd(18)} | ${result.network.padEnd(8)} | ${result.message}`;
+    });
+    const successCount = results.filter((result) => result.status === "SUCCESS").length;
+    const failureCount = results.length - successCount;
+    console.log("\nBatch registration summary");
+    console.log("STATUS  | CONTRACT           | NETWORK  | MESSAGE");
+    console.log("--------|--------------------|----------|--------");
+    for (const row of rows) {
+        console.log(row);
+    }
+    console.log(`\n${successCount} succeeded, ${failureCount} failed`);
+}
+//# sourceMappingURL=watch.js.map

package/dist/commands/watch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.js","sourceRoot":"","sources":["../../src/commands/watch.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,QAAQ,MAAM,eAAe,CAAC;AACrC,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,uBAAuB,EACvB,eAAe,GAChB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC,CAAC;AAEhE,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,OAAgB,EAAQ,EAAE;IAC7D,OAAO;SACJ,OAAO,CAAC,qBAAqB,CAAC;SAC9B,WAAW,CAAC,wCAAwC,CAAC;SACrD,MAAM,CAAC,mBAAmB,EAAE,wCAAwC,CAAC;SACrE,MAAM,CACL,qBAAqB,EACrB,+CAA+C,EAC/C,SAAS,CACV;SACA,MAAM,CAAC,qBAAqB,EAAE,gBAAgB,CAAC;SAC/C,MAAM,CACL,uBAAuB,EACvB,kDAAkD,CACnD;SACA,MAAM,CACL,oBAAoB,EACpB,4DAA4D,CAC7D;SACA,MAAM,CACL,oBAAoB,EACpB,+DAA+D,CAChE;SACA,MAAM,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE;QACpC,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,WAAW,EAAE,CAAC;YAEzB,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;gBACrB,MAAM,OAAO,GAAG,sBAAsB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;gBACzD,MAAM,OAAO,GAAG,EAMd,CAAC;gBAEH,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;oBAC7B,MAAM,WAAW,GAAG,MAAM,aAAa,CAAC,EAAE,EAAE;wBAC1C,UAAU,EAAE,MAAM,CAAC,UAAU;wBAC7B,OAAO,EAAE,MAAM,CAAC,OAAO;wBACvB,IAAI,EAAE,MAAM,CAAC,IAAI;wBACjB,MAAM,EAAE,MAAM,CAAC,MAAM;wBACrB,WAAW,EAAE,MAAM,CAAC,WAAW;wBAC/B,eAAe,EAAE,MAAM,CAAC,eAAe;qBACxC,CAAC,CAAC;oBAEH,OAAO,CAAC,IAAI,CAAC;wBACX,UAAU,EAAE,MAAM,CAAC,UAAU;wBAC7B,IAAI,EAAE,MAAM,CAAC,IAAI;wBACjB,OAAO,EAAE,MAAM,CAAC,OAAO;wBACvB,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ;wBAClD,OAAO,EAAE,WAAW,CAAC,OAAO;4BAC1B,CAAC,CAAC,cAAc,MAAM,CAAC,IAAI,IAAI,gBAAgB,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE;4BACpE,CAAC,CAAC,WAAW,CAAC,KAAK;qBACtB,CAAC,CAAC;gBACL,CAAC;gBAED,iBAAiB,CAAC,OAAO,CAAC,CAAC;gBAE3B,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,EAAE,CAAC;oBACzD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAClB,CAAC;gBACD,OAAO;YACT,CAAC;YAED,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,GAAG,CACP,2DAA2D,CAC5D,CACF,CAAC;gBACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAChB,OAAO;YACT,CAAC;YAED,MAAM,SAAS,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;YAC/C,MAAM,OAAO,GAAG,GAAG,CACjB,wBAAwB,gBAAgB,CAAC,UAAU,CAAC,6BAA6B,CAClF,CAAC,KAAK,EAAE,CAAC;YACV,MAAM,WAAW,GAAG,MAAM,aAAa,CAAC,EAAE,EAAE;gBAC1C,UAAU;gBACV,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,eAAe,EAAE,OAAO,CAAC,eAAe;aACzC,CAAC,CAAC;YACH,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;gBACzB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;gBAC3C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAChB,OAAO;YACT,CAAC;YACD,OAAO,CAAC,OAAO,CACb,KAAK,CAAC,KAAK,CACT,YAAY,OAAO,CAAC,IAAI,IAAI,SAAS,2BAA2B,CACjE,CACF,CAAC;YACF,MAAM,UAAU,GACd,CAAC;gBACD,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC1B,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAEpE,OAAO,CAAC,GAAG,CACT,iBAAiB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,SAAS,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CACnF,CAAC;YACF,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAC1D,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;YAEhE,MAAM,WAAW,GAAG,WAAW,CAAC,QAAQ,CAAC,YAAY,CAAC;YACtD,MAAM,cAAc,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC;YAChD,OAAO,CAAC,GAAG,CACT,mBAAmB,WAAW,CAAC,cAAc,EAAE,aAAa,uBAAuB,CAAC,WAAW,CAAC,MAAM,eAAe,CAAC,cAAc,CAAC,EAAE,CACxI,CAAC;YAEF,IAAI,WAAW,CAAC,IAAI,EAAE,CAAC;gBACrB,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC;gBAC9C,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;gBACxC,OAAO,CAAC,GAAG,CACT,oBAAoB,OAAO,CAAC,cAAc,EAAE,aAAa,uBAAuB,CAAC,OAAO,CAAC,MAAM,eAAe,CAAC,UAAU,CAAC,EAAE,CAC7H,CAAC;YACJ,CAAC;YAED,IAAI,WAAW,CAAC,WAAW,EAAE,CAAC;gBAC5B,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,WAAW,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;YACjE,CAAC;YAED,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,GAAG,CACP,2BAA2B;gBACzB,gBAAgB,CAAC,UAAU,CAAC;gBAC5B,0BAA0B,CAC7B,CACF,CAAC;YACF,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,GAAG,CACP,wBAAwB;gBACtB,gBAAgB,CAAC,UAAU,CAAC;gBAC5B,6BAA6B,CAChC,CACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACzD,MAAM,CAAC,KAAK,CAAC,sBAAsB,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;YAC9D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,6BAA6B,YAAY,EAAE,CAAC,CAAC,CAAC;YACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,uBAAuB,CAAC;SAChC,WAAW,CAAC,2DAA2D,CAAC;SACxE,MAAM,CAAC,WAAW,EAAE,0BAA0B,CAAC;SAC/C,MAAM,CAAC,KAAK,EAAE,UAAkB,EAAE,OAA0B,EAAE,EAAE;QAC/D,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,WAAW,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAG,WAAW,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;YAE7C,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,gBAAgB,CAAC,UAAU,CAAC,wBAAwB,CAAC,CAAC,CAAC;gBACzF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAChB,OAAO;YACT,CAAC;YAED,MAAM,mBAAmB,GAAG,KAAK,IAAmB,EAAE;gBACpD,cAAc,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;gBAC/B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,mCAAmC,gBAAgB,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;YAC/F,CAAC,CAAC;YAEF,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;gBAChB,MAAM,mBAAmB,EAAE,CAAC;YAC9B,CAAC;iBAAM,CAAC;gBACN,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC;oBAClC,KAAK,EAAE,OAAO,CAAC,KAAK;oBACpB,MAAM,EAAE,OAAO,CAAC,MAAM;iBACvB,CAAC,CAAC;gBAEH,EAAE,CAAC,QAAQ,CACT,KAAK,CAAC,MAAM,CAAC,oCAAoC,gBAAgB,CAAC,UAAU,CAAC,kFAAkF,CAAC,EAChK,KAAK,EAAE,MAAM,EAAE,EAAE;oBACf,EAAE,CAAC,KAAK,EAAE,CAAC;oBACX,IAAI,MAAM,CAAC,WAAW,EAAE,KAAK,GAAG,IAAI,MAAM,CAAC,WAAW,EAAE,KAAK,KAAK,EAAE,CAAC;wBACnE,MAAM,mBAAmB,EAAE,CAAC;oBAC9B,CAAC;yBAAM,CAAC;wBACN,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;oBACpC,CAAC;gBACH,CAAC,CACF,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5E,MAAM,CAAC,KAAK,CAAC,wBAAwB,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;YAChE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,+BAA+B,YAAY,EAAE,CAAC,CAAC,CAAC;YACtE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC,CAAC;AAEF,SAAS,iBAAiB,CACxB,OAME;IAEF,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QAClC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,IAAI,gBAAgB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACjE,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;IAC9G,CAAC,CAAC,CAAC;IAEH,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CACjC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,CACxC,CAAC,MAAM,CAAC;IACT,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,GAAG,YAAY,CAAC;IAEnD,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;IAC5C,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC;IACjE,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC;IACjE,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,KAAK,YAAY,eAAe,YAAY,SAAS,CAAC,CAAC;AACrE,CAAC"}

package/dist/core/aws_secrets.d.ts

@@ -0,0 +1,13 @@
+export interface AWSSecretsResolverConfig {
+    region?: string;
+    profile?: string;
+}
+export declare class AWSSecretsResolver {
+    private region;
+    private profile?;
+    private clientPromise?;
+    constructor(config?: AWSSecretsResolverConfig);
+    private getClient;
+    resolveKey(secretId: string): Promise<string>;
+}
+//# sourceMappingURL=aws_secrets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"aws_secrets.d.ts","sourceRoot":"","sources":["../../src/core/aws_secrets.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,wBAAwB;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,kBAAkB;IAC3B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,aAAa,CAAC,CAAe;gBAEzB,MAAM,GAAE,wBAA6B;YAKnC,SAAS;IAiBV,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAa7D"}

package/dist/core/aws_secrets.js

@@ -0,0 +1,34 @@
+export class AWSSecretsResolver {
+    region;
+    profile;
+    clientPromise;
+    constructor(config = {}) {
+        this.region = config.region || "us-east-1";
+        this.profile = config.profile;
+    }
+    async getClient() {
+        if (!this.clientPromise) {
+            this.clientPromise = (async () => {
+                const { SecretsManagerClient } = await import("@aws-sdk/client-secrets-manager");
+                const clientConfig = { region: this.region };
+                if (this.profile) {
+                    const { fromIni } = await import("@aws-sdk/credential-providers");
+                    clientConfig.credentials = fromIni({ profile: this.profile });
+                }
+                return new SecretsManagerClient(clientConfig);
+            })();
+        }
+        return this.clientPromise;
+    }
+    async resolveKey(secretId) {
+        const client = await this.getClient();
+        const { GetSecretValueCommand } = await import("@aws-sdk/client-secrets-manager");
+        const command = new GetSecretValueCommand({ SecretId: secretId });
+        const response = await client.send(command);
+        if (!response.SecretString) {
+            throw new Error(`SecretString is empty for secret: ${secretId}`);
+        }
+        return response.SecretString;
+    }
+}
+//# sourceMappingURL=aws_secrets.js.map

package/dist/core/aws_secrets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aws_secrets.js","sourceRoot":"","sources":["../../src/core/aws_secrets.ts"],"names":[],"mappings":"AAKA,MAAM,OAAO,kBAAkB;IACnB,MAAM,CAAS;IACf,OAAO,CAAU;IACjB,aAAa,CAAgB;IAErC,YAAY,SAAmC,EAAE;QAC7C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,WAAW,CAAC;QAC3C,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAClC,CAAC;IAEO,KAAK,CAAC,SAAS;QACnB,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACtB,IAAI,CAAC,aAAa,GAAG,CAAC,KAAK,IAAI,EAAE;gBAC7B,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC,iCAAiC,CAAC,CAAC;gBAEjF,MAAM,YAAY,GAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;gBAClD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;oBACf,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,+BAA+B,CAAC,CAAC;oBAClE,YAAY,CAAC,WAAW,GAAG,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;gBAClE,CAAC;gBAED,OAAO,IAAI,oBAAoB,CAAC,YAAY,CAAC,CAAC;YAClD,CAAC,CAAC,EAAE,CAAC;QACT,CAAC;QACD,OAAO,IAAI,CAAC,aAAa,CAAC;IAC9B,CAAC;IAEM,KAAK,CAAC,UAAU,CAAC,QAAgB;QACpC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACtC,MAAM,EAAE,qBAAqB,EAAE,GAAG,MAAM,MAAM,CAAC,iCAAiC,CAAC,CAAC;QAElF,MAAM,OAAO,GAAG,IAAI,qBAAqB,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;QAClE,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAE5C,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,qCAAqC,QAAQ,EAAE,CAAC,CAAC;QACrE,CAAC;QAED,OAAO,QAAQ,CAAC,YAAY,CAAC;IACjC,CAAC;CACJ"}

package/dist/core/budget.d.ts

@@ -0,0 +1,10 @@
+import Database from "better-sqlite3";
+export interface SpendProgress {
+    limit: number;
+    spend: number;
+    percentage: number;
+}
+export declare function setContractBudget(db: Database.Database, contractId: string, limit: number): void;
+export declare function getContractBudget(db: Database.Database, contractId: string): number | null;
+export declare function getMonthlySpendProgress(db: Database.Database, contractId: string): SpendProgress | null;
+//# sourceMappingURL=budget.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../../src/core/budget.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAGtC,MAAM,WAAW,aAAa;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAQhG;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM1F;AAED,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAcvG"}

package/dist/core/budget.js

@@ -0,0 +1,31 @@
+import { getContractCostSummary } from "../db/repositories.js";
+export function setContractBudget(db, contractId, limit) {
+    db.prepare(`
+        INSERT INTO contract_budgets (contract_id, monthly_limit_xlm, updated_at)
+        VALUES (?, ?, CURRENT_TIMESTAMP)
+        ON CONFLICT(contract_id) DO UPDATE SET
+            monthly_limit_xlm = excluded.monthly_limit_xlm,
+            updated_at = CURRENT_TIMESTAMP
+    `).run(contractId, limit);
+}
+export function getContractBudget(db, contractId) {
+    const row = db.prepare(`
+        SELECT monthly_limit_xlm FROM contract_budgets WHERE contract_id = ?
+    `).get(contractId);
+    return row ? row.monthly_limit_xlm : null;
+}
+export function getMonthlySpendProgress(db, contractId) {
+    const limit = getContractBudget(db, contractId);
+    if (limit === null)
+        return null;
+    // Use past 30 days as a proxy for monthly spend
+    const summary = getContractCostSummary(db, contractId, 30);
+    const spend = summary.total_cost_xlm;
+    const percentage = limit > 0 ? (spend / limit) * 100 : 0;
+    return {
+        limit,
+        spend,
+        percentage
+    };
+}
+//# sourceMappingURL=budget.js.map

package/dist/core/budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.js","sourceRoot":"","sources":["../../src/core/budget.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAQ/D,MAAM,UAAU,iBAAiB,CAAC,EAAqB,EAAE,UAAkB,EAAE,KAAa;IACtF,EAAE,CAAC,OAAO,CAAC;;;;;;KAMV,CAAC,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,EAAqB,EAAE,UAAkB;IACvE,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC;;KAEtB,CAAC,CAAC,GAAG,CAAC,UAAU,CAA8C,CAAC;IAEhE,OAAO,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,EAAqB,EAAE,UAAkB;IAC7E,MAAM,KAAK,GAAG,iBAAiB,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IAChD,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAEhC,gDAAgD;IAChD,MAAM,OAAO,GAAG,sBAAsB,CAAC,EAAE,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC;IAC3D,MAAM,KAAK,GAAG,OAAO,CAAC,cAAc,CAAC;IACrC,MAAM,UAAU,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAEzD,OAAO;QACH,KAAK;QACL,KAAK;QACL,UAAU;KACb,CAAC;AACN,CAAC"}

package/dist/core/channels.d.ts

@@ -0,0 +1,67 @@
+import type Database from "better-sqlite3";
+import { type ChannelAccount } from "../db/repositories.js";
+export interface ChannelSlot {
+    publicKey: string;
+    keypairSource: string | null;
+}
+export interface ChannelBalance {
+    publicKey: string;
+    balanceXlm: number | null;
+    balanceCheckedAt: string | null;
+}
+/**
+ * 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 declare class ChannelAccountPool {
+    private readonly db;
+    private readonly network;
+    private readonly accounts;
+    /** Tracks which publicKeys are currently in use. */
+    private readonly inUse;
+    /** Queue of resolve callbacks waiting for the next free slot. */
+    private readonly waiters;
+    /** Round-robin cursor. */
+    private cursor;
+    constructor(db: Database.Database, network: string);
+    /** Number of registered channel accounts. */
+    size(): number;
+    /**
+     * Acquire an available channel account slot.
+     * If all slots are in use, waits until one is released.
+     */
+    acquire(): Promise<ChannelSlot>;
+    /**
+     * Release a slot back to the pool.
+     * Unblocks the oldest waiting acquire() call if any.
+     */
+    release(publicKey: string): void;
+    /**
+     * Returns current balance information for all accounts in the pool.
+     * Reads from the DB — does not call the RPC.
+     */
+    getBalances(): ChannelBalance[];
+    /**
+     * Fetch native XLM balances for all accounts from the RPC and persist them.
+     * Errors per-account are logged and swallowed — does not throw.
+     */
+    refreshBalances(rpcUrl?: string): Promise<void>;
+    /**
+     * Find the next free account in round-robin order.
+     * Returns undefined if all accounts are in use.
+     */
+    private nextFreeSlot;
+}
+export interface FundChannelsResult {
+    funded: number;
+    txHash: string;
+    errors: string[];
+}
+export declare function addChannel(db: Database.Database, publicKey: string, network: string, label?: string): void;
+export declare function listChannels(db: Database.Database, network: string): ChannelAccount[];
+export declare function fundChannels(db: Database.Database, masterSecretKey: string, amountXlm: string, network: string, rpcUrl?: string): Promise<FundChannelsResult>;
+//# sourceMappingURL=channels.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"channels.d.ts","sourceRoot":"","sources":["../../src/core/channels.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAKH,KAAK,cAAc,EACtB,MAAM,uBAAuB,CAAC;AAK/B,MAAM,WAAW,WAAW;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,cAAc;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED;;;;;;;GAOG;AACH,qBAAa,kBAAkB;IAC3B,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAoB;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAC5C,oDAAoD;IACpD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,iEAAiE;IACjE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0C;IAClE,0BAA0B;IAC1B,OAAO,CAAC,MAAM,CAAK;gBAEP,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM;IAMlD,6CAA6C;IAC7C,IAAI,IAAI,MAAM;IAId;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,WAAW,CAAC;IAa/B;;;OAGG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAYhC;;;OAGG;IACH,WAAW,IAAI,cAAc,EAAE;IAQ/B;;;OAGG;IACG,eAAe,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBrD;;;OAGG;IACH,OAAO,CAAC,YAAY;CAYvB;AAED,MAAM,WAAW,kBAAkB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,wBAAgB,UAAU,CACtB,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,GACf,IAAI,CAEN;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,EAAE,CAErF;AAED,wBAAsB,YAAY,CAC9B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,kBAAkB,CAAC,CAuB7B"}