torch-liquidation-bot 3.0.2 → 4.0.1

package/dist/config.d.ts

@@ -0,0 +1,13 @@
+/**
+ * config.ts — loads environment variables into a typed BotConfig.
+ *
+ * env vars:
+ *   SOLANA_RPC_URL    — solana RPC endpoint (required, fallback: RPC_URL)
+ *   VAULT_CREATOR     — vault creator pubkey (required)
+ *   SOLANA_PRIVATE_KEY — disposable controller keypair, base58 (optional)
+ *   SCAN_INTERVAL_MS  — ms between scan cycles (default 30000, min 5000)
+ *   LOG_LEVEL         — debug | info | warn | error (default info)
+ */
+import type { BotConfig } from './types';
+export declare const loadConfig: () => BotConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAY,MAAM,SAAS,CAAA;AAIlD,eAAO,MAAM,UAAU,QAAO,SAoB7B,CAAA"}

package/dist/config.js

@@ -0,0 +1,34 @@
+"use strict";
+/**
+ * config.ts — loads environment variables into a typed BotConfig.
+ *
+ * env vars:
+ *   SOLANA_RPC_URL    — solana RPC endpoint (required, fallback: RPC_URL)
+ *   VAULT_CREATOR     — vault creator pubkey (required)
+ *   SOLANA_PRIVATE_KEY — disposable controller keypair, base58 (optional)
+ *   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 });
+exports.loadConfig = void 0;
+const LOG_LEVELS = ['debug', 'info', 'warn', 'error'];
+const loadConfig = () => {
+    const rpcUrl = process.env.SOLANA_RPC_URL ?? process.env.RPC_URL;
+    if (!rpcUrl)
+        throw new Error('SOLANA_RPC_URL env var is required (fallback: RPC_URL)');
+    const vaultCreator = process.env.VAULT_CREATOR;
+    if (!vaultCreator)
+        throw new Error('VAULT_CREATOR env var is required (vault creator pubkey)');
+    const privateKey = process.env.SOLANA_PRIVATE_KEY ?? null;
+    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, vaultCreator, privateKey, scanIntervalMs, logLevel };
+};
+exports.loadConfig = loadConfig;
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;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,cAAc,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,CAAA;IAChE,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAA;IAEtF,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAA;IAC9C,IAAI,CAAC,YAAY;QAAE,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAA;IAE9F,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,IAAI,CAAA;IAEzD,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,UAAU,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAA;AACvE,CAAC,CAAA;AApBY,QAAA,UAAU,cAoBtB"}

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+/**
+ * torch-liquidation-bot — vault-based liquidation bot.
+ *
+ * generates an agent keypair in-process (or uses SOLANA_PRIVATE_KEY if provided).
+ * all operations route through a torch vault identified by VAULT_CREATOR.
+ *
+ * usage:
+ *   VAULT_CREATOR=<pubkey> SOLANA_RPC_URL=<rpc> npx tsx src/index.ts
+ *
+ * env:
+ *   SOLANA_RPC_URL    — solana RPC endpoint (required, fallback: RPC_URL)
+ *   VAULT_CREATOR     — vault creator pubkey (required)
+ *   SOLANA_PRIVATE_KEY — disposable controller keypair, base58 (optional)
+ *   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

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

package/dist/index.js

@@ -0,0 +1,148 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * torch-liquidation-bot — vault-based liquidation bot.
+ *
+ * generates an agent keypair in-process (or uses SOLANA_PRIVATE_KEY if provided).
+ * all operations route through a torch vault identified by VAULT_CREATOR.
+ *
+ * usage:
+ *   VAULT_CREATOR=<pubkey> SOLANA_RPC_URL=<rpc> npx tsx src/index.ts
+ *
+ * env:
+ *   SOLANA_RPC_URL    — solana RPC endpoint (required, fallback: RPC_URL)
+ *   VAULT_CREATOR     — vault creator pubkey (required)
+ *   SOLANA_PRIVATE_KEY — disposable controller keypair, base58 (optional)
+ *   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");
+const torchsdk_1 = require("torchsdk");
+const config_1 = require("./config");
+const utils_1 = require("./utils");
+// ---------------------------------------------------------------------------
+// scan & liquidate
+// ---------------------------------------------------------------------------
+const scanAndLiquidate = async (connection, log, vaultCreator, agentKeypair) => {
+    const { tokens } = await (0, utils_1.withTimeout)((0, torchsdk_1.getTokens)(connection, { status: 'migrated', sort: 'volume', limit: 50 }), 'getTokens');
+    log('debug', `discovered ${tokens.length} migrated tokens`);
+    for (const token of tokens) {
+        let positions;
+        try {
+            const result = await (0, utils_1.withTimeout)((0, torchsdk_1.getAllLoanPositions)(connection, token.mint), 'getAllLoanPositions');
+            positions = result.positions;
+        }
+        catch {
+            continue; // lending not enabled for this token
+        }
+        if (positions.length === 0)
+            continue;
+        log('debug', `${token.symbol} — ${positions.length} active loans`);
+        // positions are pre-sorted: liquidatable → at_risk → healthy
+        for (const position of positions) {
+            if (position.health !== 'liquidatable')
+                break; // sorted, so no more liquidatable after this
+            log('info', `LIQUIDATABLE | ${token.symbol} | borrower=${position.borrower.slice(0, 8)}... | ` +
+                `LTV=${position.current_ltv_bps != null ? (0, utils_1.bpsToPercent)(position.current_ltv_bps) : '?'} | ` +
+                `owed=${(0, utils_1.sol)(position.total_owed)} SOL`);
+            // build and execute liquidation through the vault
+            try {
+                const { transaction, message } = await (0, utils_1.withTimeout)((0, torchsdk_1.buildLiquidateTransaction)(connection, {
+                    mint: token.mint,
+                    liquidator: agentKeypair.publicKey.toBase58(),
+                    borrower: position.borrower,
+                    vault: vaultCreator,
+                }), 'buildLiquidateTransaction');
+                transaction.sign(agentKeypair);
+                const signature = await connection.sendRawTransaction(transaction.serialize());
+                await (0, utils_1.withTimeout)((0, torchsdk_1.confirmTransaction)(connection, signature, agentKeypair.publicKey.toBase58()), 'confirmTransaction');
+                log('info', `LIQUIDATED | ${token.symbol} | borrower=${position.borrower.slice(0, 8)}... | ` +
+                    `sig=${signature.slice(0, 16)}... | ${message}`);
+            }
+            catch (err) {
+                log('warn', `LIQUIDATION FAILED | ${token.symbol} | ${position.borrower.slice(0, 8)}... | ${err.message}`);
+            }
+        }
+    }
+};
+// ---------------------------------------------------------------------------
+// main — vault-routed liquidation loop
+// ---------------------------------------------------------------------------
+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');
+    // load or generate agent keypair
+    let agentKeypair;
+    if (config.privateKey) {
+        try {
+            const parsed = JSON.parse(config.privateKey);
+            if (Array.isArray(parsed)) {
+                agentKeypair = web3_js_1.Keypair.fromSecretKey(Uint8Array.from(parsed));
+            }
+            else {
+                throw new Error('SOLANA_PRIVATE_KEY JSON must be a byte array');
+            }
+        }
+        catch (e) {
+            if (e.message?.includes('byte array'))
+                throw e;
+            // not JSON — try base58
+            agentKeypair = web3_js_1.Keypair.fromSecretKey((0, utils_1.decodeBase58)(config.privateKey));
+        }
+        log('info', 'loaded keypair from SOLANA_PRIVATE_KEY');
+    }
+    else {
+        agentKeypair = web3_js_1.Keypair.generate();
+        log('info', 'generated fresh agent keypair');
+    }
+    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, utils_1.withTimeout)((0, torchsdk_1.getVault)(connection, config.vaultCreator), 'getVault');
+    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, utils_1.withTimeout)((0, torchsdk_1.getVaultForWallet)(connection, agentKeypair.publicKey.toBase58()), 'getVaultForWallet');
+    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);
+    }
+    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, agentKeypair);
+            log('debug', '--- scan cycle end ---');
+        }
+        catch (err) {
+            log('error', `scan cycle error: ${err.message}`);
+        }
+        await new Promise((resolve) => setTimeout(resolve, config.scanIntervalMs));
+    }
+};
+main().catch((err) => {
+    console.error('FATAL:', err.message ?? err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/types.d.ts

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

package/dist/types.d.ts.map

@@ -0,0 +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,SAAS;IACxB,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,cAAc,EAAE,MAAM,CAAA;IACtB,QAAQ,EAAE,QAAQ,CAAA;CACnB"}

package/dist/types.js

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

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/utils.d.ts

@@ -0,0 +1,10 @@
+/**
+ * utils.ts — shared helpers.
+ */
+import type { LogLevel } from './types';
+export declare const sol: (lamports: number) => string;
+export declare const bpsToPercent: (bps: number) => string;
+export declare const decodeBase58: (s: string) => Uint8Array;
+export declare function withTimeout<T>(promise: Promise<T>, label: string): Promise<T>;
+export declare function createLogger(minLevel: LogLevel): (level: LogLevel, msg: string) => void;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"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;AAKzE,eAAO,MAAM,YAAY,GAAI,GAAG,MAAM,KAAG,UAmBxC,CAAA;AAID,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAO7E;AAID,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,IAGzB,OAAO,QAAQ,EAAE,KAAK,MAAM,UAMjD"}

package/dist/utils.js

@@ -0,0 +1,56 @@
+"use strict";
+/**
+ * utils.ts — shared helpers.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decodeBase58 = exports.bpsToPercent = exports.sol = void 0;
+exports.withTimeout = withTimeout;
+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;
+// base58 decoder — avoids ESM-only bs58 dependency
+const B58 = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz';
+const decodeBase58 = (s) => {
+    const result = [];
+    for (let i = 0; i < s.length; i++) {
+        let carry = B58.indexOf(s[i]);
+        if (carry < 0)
+            throw new Error(`invalid base58 character: ${s[i]}`);
+        for (let j = 0; j < result.length; j++) {
+            carry += result[j] * 58;
+            result[j] = carry & 0xff;
+            carry >>= 8;
+        }
+        while (carry > 0) {
+            result.push(carry & 0xff);
+            carry >>= 8;
+        }
+    }
+    for (let i = 0; i < s.length && s[i] === '1'; i++) {
+        result.push(0);
+    }
+    return new Uint8Array(result.reverse());
+};
+exports.decodeBase58 = decodeBase58;
+const RPC_TIMEOUT_MS = 30000;
+function withTimeout(promise, label) {
+    return Promise.race([
+        promise,
+        new Promise((_, reject) => setTimeout(() => reject(new Error(`${label} timed out after ${RPC_TIMEOUT_MS}ms`)), RPC_TIMEOUT_MS)),
+    ]);
+}
+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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "torch-liquidation-bot",
-  "version": "3.0.2",
+  "version": "4.0.1",
   "description": "autonomous vault-based liquidation keeper for Torch Market lending on Solana using torchsdk",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -18,7 +18,7 @@
   },
   "dependencies": {
     "@solana/web3.js": "1.98.4",
-    "torchsdk": "3.2.3"
+    "torchsdk": "3.7.22"
   },
   "devDependencies": {
     "@types/node": "20.19.33",
@@ -28,7 +28,7 @@
   "peerDependencies": {
     "@solana/web3.js": "^1.98.0"
   },
-    "repository": {
+  "repository": {
     "type": "git",
     "url": "https://github.com/mrsirg97-rgb/torch-liquidation-kit"
   },

package/readme.md

@@ -1,13 +1,13 @@
-# torch-liquidation-bot v3.0.2 (Vault Mode)
+# torch-liquidation-bot v4.0.1 (Vault Mode)
 
 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.
 
-> **v3.0.0+ Breaking Change:** The bot now operates through the torchsdk v3.2.3+ 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.
+> **v3.0.0+ Breaking Change:** The bot now operates through the torchsdk v3.7.22 vault model. It generates a disposable agent keypair at startup, scans for underwater loan positions using the SDK's bulk loan scanner (`getAllLoanPositions`), and executes liquidations. The user never provides a wallet — only a vault creator pubkey and an RPC endpoint.
 
 ## Install
 
 ```bash
-npm install torch-liquidation-bot
+npm install torch-liquidation-bot@4.0.1
 ```
 
 ## Quick Start
@@ -30,11 +30,10 @@ This bot:
 
 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
+3. Scans migrated tokens with `getAllLoanPositions()` — one RPC call per token, positions pre-sorted liquidatable-first
+4. Executes `buildLiquidateTransaction()` for each liquidatable position
+5. Confirms the transaction via `confirmTransaction()`
+6. Repeats on a configurable interval
 
 All value flows through the vault. The agent wallet is a stateless controller.
 
@@ -50,7 +49,7 @@ All value flows through the vault. The agent wallet is a stateless controller.
 
 ## Vault Setup
 
-The bot uses the torchsdk v3.2.3 vault model:
+The bot uses the torchsdk v3.7.22 vault model:
 
 ```
 User (hardware wallet) → Creates vault, deposits SOL
@@ -69,9 +68,7 @@ The agent wallet needs minimal SOL for gas (~0.01 SOL). All liquidation value fl
 import { Connection, Keypair } from '@solana/web3.js'
 import {
   getTokens,
-  getLendingInfo,
-  getHolders,
-  getLoanPosition,
+  getAllLoanPositions,
   getVault,
   getVaultForWallet,
   buildLiquidateTransaction,
@@ -90,18 +87,15 @@ const link = await getVaultForWallet(connection, agent.publicKey.toBase58())
 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 { positions } = await getAllLoanPositions(connection, token.mint)
 
-  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
+  for (const pos of positions) {
+    if (pos.health !== 'liquidatable') break // pre-sorted, done
 
     const { transaction } = await buildLiquidateTransaction(connection, {
       mint: token.mint,
       liquidator: agent.publicKey.toBase58(),
-      borrower: holder.address,
+      borrower: pos.borrower,
       vault: vaultCreator,
     })
     transaction.sign(agent)
@@ -117,7 +111,7 @@ for (const token of tokens) {
 src/
 ├── types.ts    — BotConfig interface
 ├── config.ts   — loadConfig() (SOLANA_RPC_URL, VAULT_CREATOR, SOLANA_PRIVATE_KEY, SCAN_INTERVAL_MS, LOG_LEVEL)
-├── utils.ts    — sol(), bpsToPercent(), createLogger()
+├── utils.ts    — sol(), bpsToPercent(), withTimeout(), createLogger()
 └── index.ts    — vault-based liquidation loop
 ```
 
@@ -145,6 +139,7 @@ pnpm test
 - Agent keypair generated in-process with `Keypair.generate()` (or loaded from optional `SOLANA_PRIVATE_KEY`)
 - Vault model: agent is a stateless controller, all value stays in the vault
 - Authority can unlink the agent wallet instantly via `buildUnlinkWalletTransaction()`
+- All SDK calls wrapped with 30-second timeout — a hanging RPC cannot stall the bot indefinitely
 - Minimal dependencies: `@solana/web3.js` + `torchsdk` -- both pinned to exact versions
 - No post-install hooks, no remote code fetching
 - `disable-model-invocation: true` -- agents cannot invoke this skill autonomously