torch-liquidation-bot 2.0.8 → 3.0.0

package/dist/config.d.ts

@@ -1,8 +1,9 @@
 /**
- * config.ts — loads environment variables into a typed ReadOnlyConfig.
+ * config.ts — loads environment variables into a typed BotConfig.
  *
- * no wallet loaded, no keypair decoded, no signing possible.
+ * the agent keypair is generated in-process. the user never provides a wallet.
+ * VAULT_CREATOR identifies which vault the bot operates through.
  */
-import type { ReadOnlyConfig } from './types';
-export declare function loadReadOnlyConfig(): ReadOnlyConfig;
+import type { BotConfig } from './types';
+export declare const loadConfig: () => BotConfig;
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAY,MAAM,SAAS,CAAA;AAIvD,wBAAgB,kBAAkB,IAAI,cAAc,CAUnD"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAY,MAAM,SAAS,CAAA;AAIlD,eAAO,MAAM,UAAU,QAAO,SAkB7B,CAAA"}

package/dist/config.js

@@ -1,20 +1,29 @@
 "use strict";
 /**
- * config.ts — loads environment variables into a typed ReadOnlyConfig.
+ * config.ts — loads environment variables into a typed BotConfig.
  *
- * no wallet loaded, no keypair decoded, no signing possible.
+ * the agent keypair is generated in-process. the user never provides a wallet.
+ * VAULT_CREATOR identifies which vault the bot operates through.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadReadOnlyConfig = loadReadOnlyConfig;
+exports.loadConfig = void 0;
 const LOG_LEVELS = ['debug', 'info', 'warn', 'error'];
-function loadReadOnlyConfig() {
+const loadConfig = () => {
     const rpcUrl = process.env.RPC_URL;
     if (!rpcUrl)
         throw new Error('RPC_URL env var is required');
+    const vaultCreator = process.env.VAULT_CREATOR;
+    if (!vaultCreator)
+        throw new Error('VAULT_CREATOR env var is required (vault creator pubkey)');
+    const scanIntervalMs = parseInt(process.env.SCAN_INTERVAL_MS ?? '30000', 10);
+    if (isNaN(scanIntervalMs) || scanIntervalMs < 5000) {
+        throw new Error('SCAN_INTERVAL_MS must be a number >= 5000');
+    }
     const logLevel = (process.env.LOG_LEVEL ?? 'info');
     if (!LOG_LEVELS.includes(logLevel)) {
         throw new Error(`LOG_LEVEL must be one of: ${LOG_LEVELS.join(', ')}`);
     }
-    return { rpcUrl, logLevel };
-}
+    return { rpcUrl, vaultCreator, scanIntervalMs, logLevel };
+};
+exports.loadConfig = loadConfig;
 //# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAMH,gDAUC;AAZD,MAAM,UAAU,GAAe,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAA;AAEjE,SAAgB,kBAAkB;IAChC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAA;IAClC,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAA;IAE3D,MAAM,QAAQ,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM,CAAa,CAAA;IAC9D,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,6BAA6B,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACvE,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAA;AAC7B,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAIH,MAAM,UAAU,GAAe,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAA;AAE1D,MAAM,UAAU,GAAG,GAAc,EAAE;IACxC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAA;IAClC,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAA;IAE3D,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAA;IAC9C,IAAI,CAAC,YAAY;QAAE,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAA;IAE9F,MAAM,cAAc,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,OAAO,EAAE,EAAE,CAAC,CAAA;IAC5E,IAAI,KAAK,CAAC,cAAc,CAAC,IAAI,cAAc,GAAG,IAAI,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAA;IAC9D,CAAC;IAED,MAAM,QAAQ,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM,CAAa,CAAA;IAC9D,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,6BAA6B,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACvE,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAA;AAC3D,CAAC,CAAA;AAlBY,QAAA,UAAU,cAkBtB"}

package/dist/index.d.ts

@@ -1,16 +1,18 @@
 #!/usr/bin/env node
 /**
- * torch-lending-monitor — read-only lending market scanner.
+ * torch-liquidation-bot — vault-based liquidation bot.
  *
- * displays lending parameters for tokens on Torch Market.
- * no wallet required. no signing. no state changes.
+ * generates an agent keypair in-process. all operations route through
+ * a torch vault identified by VAULT_CREATOR. the user never provides a wallet.
  *
  * usage:
- *   # show all migrated tokens with lending
- *   RPC_URL=<rpc> npx tsx src/index.ts
+ *   VAULT_CREATOR=<pubkey> RPC_URL=<rpc> npx tsx src/index.ts
  *
- *   # show lending info for one token
- *   MINT=<mint> RPC_URL=<rpc> npx tsx src/index.ts
+ * env:
+ *   RPC_URL           — solana RPC endpoint (required)
+ *   VAULT_CREATOR     — vault creator pubkey (required)
+ *   SCAN_INTERVAL_MS  — ms between scan cycles (default 30000, min 5000)
+ *   LOG_LEVEL         — debug | info | warn | error (default info)
  */
 export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;GAYG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;GAcG"}

package/dist/index.js

@@ -1,17 +1,19 @@
 #!/usr/bin/env node
 "use strict";
 /**
- * torch-lending-monitor — read-only lending market scanner.
+ * torch-liquidation-bot — vault-based liquidation bot.
  *
- * displays lending parameters for tokens on Torch Market.
- * no wallet required. no signing. no state changes.
+ * generates an agent keypair in-process. all operations route through
+ * a torch vault identified by VAULT_CREATOR. the user never provides a wallet.
  *
  * usage:
- *   # show all migrated tokens with lending
- *   RPC_URL=<rpc> npx tsx src/index.ts
+ *   VAULT_CREATOR=<pubkey> RPC_URL=<rpc> npx tsx src/index.ts
  *
- *   # show lending info for one token
- *   MINT=<mint> RPC_URL=<rpc> npx tsx src/index.ts
+ * env:
+ *   RPC_URL           — solana RPC endpoint (required)
+ *   VAULT_CREATOR     — vault creator pubkey (required)
+ *   SCAN_INTERVAL_MS  — ms between scan cycles (default 30000, min 5000)
+ *   LOG_LEVEL         — debug | info | warn | error (default info)
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 const web3_js_1 = require("@solana/web3.js");
@@ -19,56 +21,130 @@ const torchsdk_1 = require("torchsdk");
 const config_1 = require("./config");
 const utils_1 = require("./utils");
 // ---------------------------------------------------------------------------
-// read-only info display
+// bootstrap — generate agent keypair in-process
 // ---------------------------------------------------------------------------
-async function showLendingInfo(connection, mint) {
-    const token = await (0, torchsdk_1.getToken)(connection, mint);
-    const lending = await (0, torchsdk_1.getLendingInfo)(connection, mint);
-    console.log(`\n=== lending info: ${token.name} (${token.symbol}) ===`);
-    console.log(`status:                ${token.status}`);
-    console.log(`token price:           ${(0, utils_1.sol)(token.price_sol)} SOL`);
-    console.log(`interest rate:         ${(0, utils_1.bpsToPercent)(lending.interest_rate_bps)}`);
-    console.log(`max LTV:               ${(0, utils_1.bpsToPercent)(lending.max_ltv_bps)}`);
-    console.log(`liquidation threshold: ${(0, utils_1.bpsToPercent)(lending.liquidation_threshold_bps)}`);
-    console.log(`liquidation bonus:     ${(0, utils_1.bpsToPercent)(lending.liquidation_bonus_bps)}`);
-    console.log(`treasury SOL avail:    ${(0, utils_1.sol)(lending.treasury_sol_available)} SOL`);
-    console.log(`total SOL lent:        ${lending.total_sol_lent ? (0, utils_1.sol)(lending.total_sol_lent) : (0, utils_1.sol)(0)} SOL`);
-    console.log(`active loans:          ${lending.active_loans}`);
-}
-async function showAllLending(connection) {
-    console.log('=== torch lending monitor ===\n');
-    console.log('no MINT specified — showing all migrated tokens with lending\n');
+const agentKeypair = web3_js_1.Keypair.generate();
+// ---------------------------------------------------------------------------
+// scan & liquidate
+// ---------------------------------------------------------------------------
+const scanAndLiquidate = async (connection, log, vaultCreator) => {
     const { tokens } = await (0, torchsdk_1.getTokens)(connection, {
         status: 'migrated',
         sort: 'volume',
-        limit: 10,
+        limit: 50,
     });
-    for (const t of tokens) {
+    log('debug', `discovered ${tokens.length} migrated tokens`);
+    for (const token of tokens) {
+        let lending;
+        try {
+            lending = await (0, torchsdk_1.getLendingInfo)(connection, token.mint);
+        }
+        catch {
+            continue; // lending not enabled for this token
+        }
+        if (!lending.active_loans || lending.active_loans === 0)
+            continue;
+        log('debug', `${token.symbol} — ${lending.active_loans} active loans, ` +
+            `threshold: ${(0, utils_1.bpsToPercent)(lending.liquidation_threshold_bps)}, ` +
+            `bonus: ${(0, utils_1.bpsToPercent)(lending.liquidation_bonus_bps)}`);
+        // get holders as potential borrowers
+        let holders;
         try {
-            const lending = await (0, torchsdk_1.getLendingInfo)(connection, t.mint);
-            console.log(`${t.symbol.padEnd(10)} | ` +
-                `rate: ${(0, utils_1.bpsToPercent)(lending.interest_rate_bps).padEnd(7)} | ` +
-                `loans: ${String(lending.active_loans).padEnd(4)} | ` +
-                `avail: ${(0, utils_1.sol)(lending.treasury_sol_available)} SOL`);
+            const result = await (0, torchsdk_1.getHolders)(connection, token.mint);
+            holders = result.holders;
         }
         catch {
-            // token may not have lending enabled yet
+            log('debug', `${token.symbol} — could not fetch holders, skipping`);
+            continue;
+        }
+        for (const holder of holders) {
+            let position;
+            try {
+                position = await (0, torchsdk_1.getLoanPosition)(connection, token.mint, holder.address);
+            }
+            catch {
+                continue; // no loan position for this holder
+            }
+            // SDK provides health status directly — skip non-liquidatable positions
+            if (position.health !== 'liquidatable')
+                continue;
+            log('info', `LIQUIDATABLE | ${token.symbol} | borrower=${holder.address.slice(0, 8)}... | ` +
+                `LTV=${position.current_ltv_bps != null ? (0, utils_1.bpsToPercent)(position.current_ltv_bps) : '?'} > ` +
+                `threshold=${(0, utils_1.bpsToPercent)(lending.liquidation_threshold_bps)} | ` +
+                `owed=${(0, utils_1.sol)(position.total_owed)} SOL`);
+            // build and execute liquidation through the vault
+            try {
+                const { transaction, message } = await (0, torchsdk_1.buildLiquidateTransaction)(connection, {
+                    mint: token.mint,
+                    liquidator: agentKeypair.publicKey.toBase58(),
+                    borrower: holder.address,
+                    vault: vaultCreator,
+                });
+                transaction.sign(agentKeypair);
+                const signature = await connection.sendRawTransaction(transaction.serialize());
+                await (0, torchsdk_1.confirmTransaction)(connection, signature, agentKeypair.publicKey.toBase58());
+                log('info', `LIQUIDATED | ${token.symbol} | borrower=${holder.address.slice(0, 8)}... | ` +
+                    `sig=${signature.slice(0, 16)}... | ${message}`);
+            }
+            catch (err) {
+                log('warn', `LIQUIDATION FAILED | ${token.symbol} | ${holder.address.slice(0, 8)}... | ${err.message}`);
+            }
         }
     }
-}
+};
 // ---------------------------------------------------------------------------
-// main — read-only only
+// main — vault-routed liquidation loop
 // ---------------------------------------------------------------------------
-async function main() {
-    const config = (0, config_1.loadReadOnlyConfig)();
+const main = async () => {
+    const config = (0, config_1.loadConfig)();
+    const log = (0, utils_1.createLogger)(config.logLevel);
     const connection = new web3_js_1.Connection(config.rpcUrl, 'confirmed');
-    const MINT = process.env.MINT;
-    if (MINT) {
-        await showLendingInfo(connection, MINT);
+    console.log('=== torch liquidation bot ===');
+    console.log(`agent wallet: ${agentKeypair.publicKey.toBase58()}`);
+    console.log(`vault creator: ${config.vaultCreator}`);
+    console.log(`scan interval: ${config.scanIntervalMs}ms`);
+    console.log();
+    // verify vault exists
+    const vault = await (0, torchsdk_1.getVault)(connection, config.vaultCreator);
+    if (!vault) {
+        throw new Error(`vault not found for creator ${config.vaultCreator}`);
+    }
+    log('info', `vault found — authority=${vault.authority}`);
+    // verify agent wallet is linked to vault
+    const link = await (0, torchsdk_1.getVaultForWallet)(connection, agentKeypair.publicKey.toBase58());
+    if (!link) {
+        console.log();
+        console.log('--- ACTION REQUIRED ---');
+        console.log('agent wallet is NOT linked to the vault.');
+        console.log('link it by running (from your authority wallet):');
+        console.log();
+        console.log(`  buildLinkWalletTransaction(connection, {`);
+        console.log(`    authority: "<your-authority-pubkey>",`);
+        console.log(`    vault_creator: "${config.vaultCreator}",`);
+        console.log(`    wallet_to_link: "${agentKeypair.publicKey.toBase58()}"`);
+        console.log(`  })`);
+        console.log();
+        console.log('then restart the bot.');
+        console.log('-----------------------');
+        process.exit(1);
     }
-    else {
-        await showAllLending(connection);
+    log('info', 'agent wallet linked to vault — starting scan loop');
+    log('info', `treasury: ${(0, utils_1.sol)(vault.sol_balance ?? 0)} SOL`);
+    // scan loop
+    while (true) {
+        try {
+            log('debug', '--- scan cycle start ---');
+            await scanAndLiquidate(connection, log, config.vaultCreator);
+            log('debug', '--- scan cycle end ---');
+        }
+        catch (err) {
+            log('error', `scan cycle error: ${err.message}`);
+        }
+        await new Promise((resolve) => setTimeout(resolve, config.scanIntervalMs));
     }
-}
-main();
+};
+main().catch((err) => {
+    console.error('FATAL:', err.message ?? err);
+    process.exit(1);
+});
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/types.d.ts

@@ -1,9 +1,11 @@
 /**
- * types.ts — interfaces for the read-only lending scanner.
+ * types.ts — interfaces for the vault-based liquidation bot.
  */
 export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
-export interface ReadOnlyConfig {
+export interface BotConfig {
     rpcUrl: string;
+    vaultCreator: string;
+    scanIntervalMs: number;
     logLevel: LogLevel;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;AAE1D,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,QAAQ,CAAA;CACnB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;AAE1D,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,MAAM,CAAA;IACpB,cAAc,EAAE,MAAM,CAAA;IACtB,QAAQ,EAAE,QAAQ,CAAA;CACnB"}

package/dist/types.js

@@ -1,6 +1,6 @@
 "use strict";
 /**
- * types.ts — interfaces for the read-only lending scanner.
+ * types.ts — interfaces for the vault-based liquidation bot.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=types.js.map

package/dist/utils.d.ts

@@ -1,6 +1,8 @@
 /**
  * utils.ts — shared helpers.
  */
-export declare function sol(lamports: number): string;
-export declare function bpsToPercent(bps: number): string;
+import type { LogLevel } from './types';
+export declare const sol: (lamports: number) => string;
+export declare const bpsToPercent: (bps: number) => string;
+export declare function createLogger(minLevel: LogLevel): (level: LogLevel, msg: string) => void;
 //# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,wBAAgB,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAEvC,eAAO,MAAM,GAAG,GAAI,UAAU,MAAM,WAA6C,CAAA;AAEjF,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,WAAiC,CAAA;AAIzE,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,IAGzB,OAAO,QAAQ,EAAE,KAAK,MAAM,UAMjD"}

package/dist/utils.js

@@ -3,13 +3,22 @@
  * utils.ts — shared helpers.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.bpsToPercent = exports.sol = void 0;
+exports.createLogger = createLogger;
+const torchsdk_1 = require("torchsdk");
+const sol = (lamports) => (lamports / torchsdk_1.LAMPORTS_PER_SOL).toFixed(4);
 exports.sol = sol;
+const bpsToPercent = (bps) => (bps / 100).toFixed(2) + '%';
 exports.bpsToPercent = bpsToPercent;
-const torchsdk_1 = require("torchsdk");
-function sol(lamports) {
-    return (lamports / torchsdk_1.LAMPORTS_PER_SOL).toFixed(4);
-}
-function bpsToPercent(bps) {
-    return (bps / 100).toFixed(2) + '%';
+const LEVEL_ORDER = ['debug', 'info', 'warn', 'error'];
+function createLogger(minLevel) {
+    const minIdx = LEVEL_ORDER.indexOf(minLevel);
+    return function log(level, msg) {
+        if (LEVEL_ORDER.indexOf(level) < minIdx)
+            return;
+        const ts = new Date().toISOString().substr(11, 12);
+        const tag = level.toUpperCase().padEnd(5);
+        console.log(`[${ts}] ${tag} ${msg}`);
+    };
 }
 //# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAIH,kBAEC;AAED,oCAEC;AARD,uCAA2C;AAE3C,SAAgB,GAAG,CAAC,QAAgB;IAClC,OAAO,CAAC,QAAQ,GAAG,2BAAgB,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;AACjD,CAAC;AAED,SAAgB,YAAY,CAAC,GAAW;IACtC,OAAO,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG,CAAA;AACrC,CAAC"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAWH,oCASC;AAlBD,uCAA2C;AAGpC,MAAM,GAAG,GAAG,CAAC,QAAgB,EAAE,EAAE,CAAC,CAAC,QAAQ,GAAG,2BAAgB,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;AAApE,QAAA,GAAG,OAAiE;AAE1E,MAAM,YAAY,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG,CAAA;AAA5D,QAAA,YAAY,gBAAgD;AAEzE,MAAM,WAAW,GAAe,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAA;AAElE,SAAgB,YAAY,CAAC,QAAkB;IAC7C,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;IAE5C,OAAO,SAAS,GAAG,CAAC,KAAe,EAAE,GAAW;QAC9C,IAAI,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM;YAAE,OAAM;QAC/C,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAA;QAClD,MAAM,GAAG,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;QACzC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI,GAAG,EAAE,CAAC,CAAA;IACtC,CAAC,CAAA;AACH,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "torch-liquidation-bot",
-  "version": "2.0.8",
-  "description": "read-only lending market scanner for Torch Market on Solana",
+  "version": "3.0.0",
+  "description": "autonomous vault-based liquidation keeper for Torch Market lending on Solana using torchsdk",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "bin": {
@@ -13,12 +13,12 @@
   "scripts": {
     "build": "tsc",
     "clean": "rm -rf dist",
-    "test": "npx tsx tests/test_readonly.ts",
+    "test": "npx tsx tests/test_e2e.ts",
     "format": "prettier --write src/ tests/"
   },
   "dependencies": {
     "@solana/web3.js": "1.98.4",
-    "torchsdk": "2.0.0"
+    "torchsdk": "3.2.3"
   },
   "devDependencies": {
     "@types/node": "20.19.33",
@@ -30,7 +30,7 @@
   },
     "repository": {
     "type": "git",
-    "url": "https://github.com/mrsirg97-rgb/torch-liquidation-bot-ro"
+    "url": "https://github.com/mrsirg97-rgb/torch-liquidation-kit"
   },
   "license": "MIT",
   "packageManager": "pnpm@9.10.0+sha512.73a29afa36a0d092ece5271de5177ecbf8318d454ecd701343131b8ebc0c1a91c487da46ab77c8e596d6acf1461e3594ced4becedf8921b074fbd8653ed7051c"

package/readme.md

@@ -1,8 +1,8 @@
-# torch-liquidation-bot v2.0.7 (Read-Only)
+# torch-liquidation-bot v3.0.0 (Vault Mode)
 
-Read-only lending market scanner for [Torch Market](https://torch.market) on Solana. No wallet required. Only an RPC endpoint is needed.
+Vault-based liquidation bot for [Torch Market](https://torch.market) on Solana. Generates an agent keypair in-process — no user wallet required. All operations route through a Torch Vault.
 
-> **v2.0.0 Breaking Change:** All wallet-dependent code (bot mode, watch mode, transaction signing) was removed. The source tree contains only read-only code. No wallet, no keypair, no signing.
+> **v3.0.0 Breaking Change:** The bot now operates through the torchsdk v2.1.0 vault model. It generates a disposable agent keypair at startup, scans for underwater loan positions, and executes liquidations. The user never provides a wallet — only a vault creator pubkey and an RPC endpoint.
 
 ## Install
 
@@ -13,48 +13,98 @@ npm install torch-liquidation-bot
 ## Quick Start
 
 ```bash
-# show lending info for all migrated tokens
-RPC_URL=<rpc> npx torch-liquidation-bot
+# 1. start the bot — it prints its agent wallet on startup
+VAULT_CREATOR=<your-vault-creator-pubkey> RPC_URL=<rpc> npx torch-liquidation-bot
 
-# show lending info for a specific token
-MINT=<mint> RPC_URL=<rpc> npx torch-liquidation-bot
+# 2. link the printed agent wallet to your vault (one-time, from your authority wallet)
+#    the bot will print the exact instructions if the wallet is not yet linked
+
+# 3. restart the bot — it will begin scanning and liquidating
 ```
 
 ## What It Does
 
-Every migrated token on Torch has a built-in lending market. This skill discovers those markets and displays their parameters — interest rates, LTV thresholds, treasury balances, and active loan counts.
+Every migrated token on Torch has a built-in lending market. Borrowers lock tokens as collateral and borrow SOL. When a position's LTV exceeds the liquidation threshold, anyone can liquidate it and earn the liquidation bonus.
+
+This bot:
 
-That's it. No wallet loaded. No transactions built. No state changes.
+1. Generates a disposable `Keypair` in-process (no private key leaves the process)
+2. Verifies the vault exists and the agent wallet is linked
+3. Scans migrated tokens for active loans
+4. Checks each borrower's position health via `getLoanPosition()`
+5. Executes `buildLiquidateTransaction()` for any position with `health === 'liquidatable'`
+6. Confirms the transaction via `confirmTransaction()`
+7. Repeats on a configurable interval
+
+All value flows through the vault. The agent wallet is a stateless controller.
 
 ## Configuration
 
 | Variable | Required | Default | Description |
 |----------|----------|---------|-------------|
-| `RPC_URL` | yes | -- | Solana RPC endpoint. If your provider embeds an API key in the URL, use a read-only key or a public endpoint. |
-| `MINT` | no | -- | Token mint address (omit to show all tokens) |
+| `RPC_URL` | yes | -- | Solana RPC endpoint |
+| `VAULT_CREATOR` | yes | -- | Vault creator pubkey (identifies which vault to use) |
+| `SCAN_INTERVAL_MS` | no | `30000` | Milliseconds between scan cycles (min 5000) |
 | `LOG_LEVEL` | no | `info` | `debug`, `info`, `warn`, `error` |
 
-No `WALLET`, no `MODE`, no bot-specific config.
+## Vault Setup
+
+The bot uses the torchsdk v2.1.0 vault model:
+
+```
+User (hardware wallet) → Creates vault, deposits SOL
+                       → Links bot's agent wallet
+Bot  (disposable)      → Scans for liquidatable positions
+                       → Executes liquidations using vault funds
+                       → All proceeds return to vault
+User                   → Withdraws from vault (authority only)
+```
+
+The agent wallet needs minimal SOL for gas (~0.01 SOL). All liquidation value flows through the vault.
 
 ## Programmatic Usage
 
 ```typescript
-import { loadReadOnlyConfig } from 'torch-liquidation-bot/config'
-import { Connection } from '@solana/web3.js'
-import { getTokens, getLendingInfo } from 'torchsdk'
-
-const config = loadReadOnlyConfig()
-const connection = new Connection(config.rpcUrl, 'confirmed')
-
-const { tokens } = await getTokens(connection, {
-  status: 'migrated',
-  sort: 'volume',
-  limit: 50,
-})
-
-for (const t of tokens) {
-  const lending = await getLendingInfo(connection, t.mint)
-  console.log(`${t.symbol}: ${lending.active_loans} active loans`)
+import { Connection, Keypair } from '@solana/web3.js'
+import {
+  getTokens,
+  getLendingInfo,
+  getHolders,
+  getLoanPosition,
+  getVault,
+  getVaultForWallet,
+  buildLiquidateTransaction,
+  confirmTransaction,
+} from 'torchsdk'
+
+const connection = new Connection('<rpc>', 'confirmed')
+const agent = Keypair.generate()
+
+// verify vault and link
+const vault = await getVault(connection, '<vault-creator-pubkey>')
+const link = await getVaultForWallet(connection, agent.publicKey.toBase58())
+
+// scan and liquidate
+const { tokens } = await getTokens(connection, { status: 'migrated', sort: 'volume', limit: 50 })
+
+for (const token of tokens) {
+  const lending = await getLendingInfo(connection, token.mint)
+  if (!lending.active_loans) continue
+
+  const { holders } = await getHolders(connection, token.mint)
+  for (const holder of holders) {
+    const pos = await getLoanPosition(connection, token.mint, holder.address)
+    if (pos.health !== 'liquidatable') continue
+
+    const { transaction } = await buildLiquidateTransaction(connection, {
+      mint: token.mint,
+      liquidator: agent.publicKey.toBase58(),
+      borrower: holder.address,
+    })
+    transaction.sign(agent)
+    const sig = await connection.sendRawTransaction(transaction.serialize())
+    await confirmTransaction(connection, sig, agent.publicKey.toBase58())
+  }
 }
 ```
 
@@ -62,10 +112,10 @@ for (const t of tokens) {
 
 ```
 src/
-├── types.ts    — ReadOnlyConfig interface
-├── config.ts   — loadReadOnlyConfig()
-├── utils.ts    — sol() + bpsToPercent() helpers
-└── index.ts    — read-only entry point
+├── types.ts    — BotConfig interface
+├── config.ts   — loadConfig() (RPC_URL, VAULT_CREATOR, SCAN_INTERVAL_MS, LOG_LEVEL)
+├── utils.ts    — sol(), bpsToPercent(), createLogger()
+└── index.ts    — vault-based liquidation loop
 ```
 
 ## Lending Parameters
@@ -84,21 +134,22 @@ Requires [Surfpool](https://github.com/nicholasgasior/surfpool) running a mainne
 
 ```bash
 surfpool start --network mainnet --no-tui
-pnpm test    # read-only test
+pnpm test
 ```
 
 ## Security
 
-- No wallet loaded, no keypair decoded, no private key in memory
-- No transaction building, no signing, no state changes
+- Agent keypair generated in-process — never serialized, never leaves the process
+- No user wallet or private key imported from environment
+- Vault model: agent is a stateless controller, all value stays in the vault
+- Authority can unlink the agent wallet instantly via `buildUnlinkWalletTransaction()`
 - Outbound connections: Solana RPC only
 - Minimal dependencies: `@solana/web3.js` + `torchsdk`
 - No post-install hooks, no remote code fetching
-- RPC_URL is used only for read-only RPC calls — never logged, transmitted externally, or stored
 
 ## Links
 
-- [torchsdk](https://github.com/mrsirg97-rgb/torchsdk) -- the SDK this skill reads from
+- [torchsdk](https://github.com/mrsirg97-rgb/torchsdk) -- the SDK powering this bot
 - [Torch Market](https://torch.market) -- the protocol
 - [ClawHub](https://clawhub.ai/mrsirg97-rgb/torchliquidationbot) -- skill registry