torch-liquidation-agent 1.0.0

package/dist/wallet-profiler.js

@@ -0,0 +1,135 @@
+"use strict";
+/**
+ * wallet-profiler.ts — assesses wallet risk using SAID reputation + trade history.
+ *
+ * checks each borrower's trust tier and analyzes their trade messages
+ * to determine if they tend to lose money (higher liquidation risk).
+ *
+ * profiles are cached in-memory with a cooldown to avoid hammering RPC.
+ *
+ * uses the torch agent kit for trade messages and calls the SAID API
+ * directly for wallet reputation verification.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WalletProfiler = void 0;
+const solana_agent_kit_torch_market_1 = require("solana-agent-kit-torch-market");
+const utils_1 = require("./utils");
+const PROFILE_COOLDOWN_MS = 5 * 60 * 1000; // refresh profiles every 5 min
+const MAX_CACHE_AGE_MS = 30 * 60 * 1000; // evict entries older than 30 min
+const MAX_CACHE_SIZE = 1000; // hard cap on cache entries
+const SAID_API_URL = 'https://api.saidprotocol.com/api';
+async function verifySaid(address) {
+    try {
+        const res = await fetch(`${SAID_API_URL}/verify/${address}`);
+        if (!res.ok)
+            return { verified: false, trustTier: null };
+        const data = (await res.json());
+        return {
+            verified: data.verified ?? false,
+            trustTier: data.trust_tier ?? null,
+        };
+    }
+    catch {
+        return { verified: false, trustTier: null };
+    }
+}
+class WalletProfiler {
+    constructor(log) {
+        this.cache = new Map();
+        this.log = log;
+    }
+    async profile(agent, address, mint) {
+        this.evictStale();
+        const cached = this.cache.get(address);
+        if (cached && Date.now() - cached.lastUpdated < PROFILE_COOLDOWN_MS) {
+            return cached;
+        }
+        this.log.debug(`profiling wallet ${address.slice(0, 8)}...`);
+        // SAID reputation
+        const said = await verifySaid(address);
+        // trade history from messages
+        const tradeStats = await this.analyzeTradeHistory(agent, mint, address);
+        // compute wallet risk score (0-100)
+        const riskScore = this.computeWalletRisk(said.trustTier, tradeStats);
+        const profile = {
+            address,
+            saidVerified: said.verified,
+            trustTier: said.trustTier,
+            tradeStats,
+            riskScore,
+            lastUpdated: Date.now(),
+        };
+        this.cache.set(address, profile);
+        return profile;
+    }
+    async analyzeTradeHistory(agent, mint, address) {
+        try {
+            const messages = await (0, solana_agent_kit_torch_market_1.torchGetMessages)(agent, mint, 50);
+            // filter messages from this wallet and analyze buy/sell patterns
+            const walletMsgs = messages.filter((m) => m.sender === address);
+            let wins = 0;
+            let losses = 0;
+            let netPnlSol = 0;
+            for (const msg of walletMsgs) {
+                const m = msg;
+                if (m.pnl_sol !== undefined) {
+                    if (m.pnl_sol > 0)
+                        wins++;
+                    else
+                        losses++;
+                    netPnlSol += m.pnl_sol;
+                }
+            }
+            const totalTrades = wins + losses;
+            return {
+                totalTrades,
+                wins,
+                losses,
+                winRate: totalTrades > 0 ? wins / totalTrades : 0.5,
+                netPnlSol,
+            };
+        }
+        catch {
+            // if we can't get trade history, assume neutral
+            return { totalTrades: 0, wins: 0, losses: 0, winRate: 0.5, netPnlSol: 0 };
+        }
+    }
+    computeWalletRisk(trustTier, stats) {
+        // base risk from trust tier
+        const tierRisk = {
+            high: 10,
+            medium: 40,
+            low: 70,
+        };
+        let risk = tierRisk[trustTier ?? ''] ?? 50; // unverified = 50
+        // modifier from trade history: bad traders are riskier
+        if (stats.totalTrades > 0) {
+            // low win rate increases risk, high win rate decreases it
+            const winRateModifier = (0.5 - stats.winRate) * 40; // -20 to +20
+            risk += winRateModifier;
+            // net losses increase risk
+            if (stats.netPnlSol < 0) {
+                risk += Math.min(Math.abs(stats.netPnlSol) * 5, 20); // up to +20
+            }
+        }
+        return (0, utils_1.clamp)(Math.round(risk), 0, 100);
+    }
+    evictStale() {
+        const now = Date.now();
+        for (const [key, profile] of this.cache) {
+            if (now - profile.lastUpdated > MAX_CACHE_AGE_MS) {
+                this.cache.delete(key);
+            }
+        }
+        // hard cap: if still too large, evict oldest entries
+        if (this.cache.size > MAX_CACHE_SIZE) {
+            const sorted = [...this.cache.entries()].sort((a, b) => a[1].lastUpdated - b[1].lastUpdated);
+            const toEvict = sorted.slice(0, this.cache.size - MAX_CACHE_SIZE);
+            for (const [key] of toEvict) {
+                this.cache.delete(key);
+            }
+        }
+    }
+}
+exports.WalletProfiler = WalletProfiler;
+//# sourceMappingURL=wallet-profiler.js.map

package/dist/wallet-profiler.js.map

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

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "torch-liquidation-agent",
+  "version": "1.0.0",
+  "description": "lending position monitor and auto-liquidation skill using the torch-agent-kit",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "torch-liquidation-agent": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "test": "npx tsx tests/test_lending.ts",
+    "test:bot": "npx tsx tests/test_bot.ts",
+    "format": "prettier --write src/ tests/"
+  },
+  "dependencies": {
+    "@coral-xyz/anchor": "^0.32.1",
+    "@solana/spl-token": "^0.4.14",
+    "@solana/web3.js": "^1.98.4",
+    "bs58": "^6.0.0",
+    "solana-agent-kit": "^2.0.0",
+    "solana-agent-kit-torch-market": "^3.0.6"
+  },
+  "devDependencies": {
+    "@types/node": "^20",
+    "prettier": "^3.5.3",
+    "torchsdk": "^1.0.5",
+    "typescript": "^5"
+  },
+  "peerDependencies": {
+    "@solana/web3.js": "^1.98.0"
+  },
+  "license": "MIT",
+  "packageManager": "pnpm@9.10.0+sha512.73a29afa36a0d092ece5271de5177ecbf8318d454ecd701343131b8ebc0c1a91c487da46ab77c8e596d6acf1461e3594ced4becedf8921b074fbd8653ed7051c"
+}

package/readme.md

@@ -0,0 +1,152 @@
+# torch-liquidation-agent
+
+Multi-token liquidation bot for [Torch Market](https://torch.market) lending on Solana, built on [solana-agent-kit](https://github.com/sendaifun/solana-agent-kit) + [solana-agent-kit-torch-market](https://www.npmjs.com/package/solana-agent-kit-torch-market).
+
+Same functionality as [`torch-liquidation-bot`](../bot/) but uses the Torch Agent Kit plugin instead of raw torchsdk — making it compatible with AI agent frameworks (LangChain, Vercel AI, OpenAI tools).
+
+## Install
+
+```bash
+npm install torch-liquidation-agent
+```
+
+## How It Works
+
+Every migrated token on Torch has a built-in lending market. Holders borrow SOL against their tokens. When a borrower's loan-to-value ratio exceeds 65%, anyone can liquidate the position and collect a 10% bonus on the collateral.
+
+This bot finds those opportunities before other bots do by **predicting** which positions will go underwater:
+
+1. **Scan** -- discovers all tokens with active lending markets
+2. **Profile** -- checks each borrower's SAID reputation and trade history
+3. **Score** -- rates every loan on a 4-factor risk model (0-100)
+4. **Liquidate** -- executes when a position crosses the threshold and the profit exceeds your minimum
+
+## Quick Start
+
+```bash
+MODE=bot WALLET=<base58-private-key> RPC_URL=<rpc-endpoint> npx torch-liquidation-agent
+```
+
+## Modes
+
+### `bot` (default) -- full liquidation bot
+
+Runs two concurrent loops:
+- **Scan loop** (every 60s) -- finds tokens with active lending, snapshots prices
+- **Score loop** (every 15s) -- profiles borrowers, scores loans, executes liquidations
+
+```bash
+MODE=bot WALLET=<key> RPC_URL=<rpc> npx torch-liquidation-agent
+```
+
+### `info` -- display lending parameters
+
+```bash
+# all migrated tokens with lending
+MODE=info RPC_URL=<rpc> npx torch-liquidation-agent
+
+# specific token
+MODE=info MINT=<mint> RPC_URL=<rpc> npx torch-liquidation-agent
+```
+
+### `watch` -- monitor your own loan health
+
+```bash
+MODE=watch MINT=<mint> WALLET=<key> RPC_URL=<rpc> npx torch-liquidation-agent
+
+# with auto-repay if your position becomes liquidatable
+MODE=watch MINT=<mint> WALLET=<key> AUTO_REPAY=true RPC_URL=<rpc> npx torch-liquidation-agent
+```
+
+## Risk Scoring
+
+Every loan gets a composite score from four weighted factors:
+
+| Factor | Weight | What It Measures |
+|--------|--------|------------------|
+| LTV proximity | 40% | How close to the 65% liquidation threshold |
+| Price momentum | 30% | Collateral price trend (linear regression on recent snapshots) |
+| Wallet risk | 20% | SAID trust tier + trade win/loss ratio |
+| Interest burden | 10% | Accrued interest relative to collateral value |
+
+Positions above the risk threshold (default: 60) are flagged and watched closely. Liquidatable positions with profit above your minimum are executed immediately, highest profit first.
+
+## Configuration
+
+| Variable | Required | Default | Description |
+|----------|----------|---------|-------------|
+| `RPC_URL` | yes | -- | Solana RPC endpoint |
+| `WALLET` | bot/watch | -- | Base58 private key |
+| `MODE` | no | `bot` | `bot`, `info`, or `watch` |
+| `MINT` | info/watch | -- | Token mint address |
+| `SCAN_INTERVAL_MS` | no | `60000` | Token discovery interval |
+| `SCORE_INTERVAL_MS` | no | `15000` | Position scoring interval |
+| `MIN_PROFIT_SOL` | no | `0.01` | Minimum profit to execute liquidation |
+| `RISK_THRESHOLD` | no | `60` | Risk score cutoff for close monitoring |
+| `PRICE_HISTORY` | no | `20` | Price snapshots to keep for momentum |
+| `LOG_LEVEL` | no | `info` | `debug`, `info`, `warn`, `error` |
+
+## Architecture
+
+```
+src/
+├── types.ts            — interfaces and contracts
+├── config.ts           — env vars → SolanaAgentKit + typed config
+├── logger.ts           — structured logging
+├── utils.ts            — shared helpers
+├── scanner.ts          — discovers tokens with active lending
+├── wallet-profiler.ts  — SAID reputation + trade history
+├── risk-scorer.ts      — 4-factor risk model
+├── liquidator.ts       — executes liquidation txs via agent kit
+├── monitor.ts          — scan + score orchestration
+└── index.ts            — entry point
+```
+
+### Differences from `torch-liquidation-bot`
+
+| | `bot` (torchsdk) | `agent` (agent kit) |
+|---|---|---|
+| SDK | `torchsdk` direct | `solana-agent-kit-torch-market` plugin |
+| Transaction signing | Manual (`sendAndConfirmTransaction`) | Handled by `SolanaAgentKit` |
+| Holder discovery | `torchsdk.getHolders()` | Solana RPC `getTokenLargestAccounts` |
+| SAID verification | `torchsdk.verifySaid()` | Direct SAID API call |
+| AI agent compatible | No | Yes (LangChain, Vercel AI, OpenAI tools) |
+
+## Lending Parameters
+
+| Parameter | Value |
+|-----------|-------|
+| Max LTV | 50% |
+| Liquidation threshold | 65% LTV |
+| Interest rate | 2% per epoch (~7 days) |
+| Liquidation bonus | 10% of collateral |
+| Min borrow | 0.1 SOL |
+
+## Testing
+
+Requires [Surfpool](https://github.com/nicholasgasior/surfpool) running a mainnet fork:
+
+```bash
+surfpool start --network mainnet --no-tui
+pnpm test        # lending lifecycle test
+pnpm test:bot    # bot module test (scanner, profiler, scorer, liquidator)
+```
+
+## Security
+
+- Private keys loaded from env, never logged or transmitted
+- All transactions signed by `SolanaAgentKit` via `KeypairWallet` -- keys never leave your environment
+- Minimum profit threshold prevents unprofitable executions
+- Graceful shutdown on SIGINT
+
+## Links
+
+- [solana-agent-kit](https://github.com/sendaifun/solana-agent-kit) -- the agent framework
+- [solana-agent-kit-torch-market](https://www.npmjs.com/package/solana-agent-kit-torch-market) -- Torch Market plugin
+- [torch-liquidation-bot](../bot/) -- the torchsdk-based version
+- [Torch Market](https://torch.market) -- the protocol
+- [SAID Protocol](https://saidprotocol.com) -- wallet reputation layer
+
+## License
+
+MIT