torch-liquidation-bot 3.0.0 → 3.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/config.d.ts +6 -2
- package/dist/config.d.ts.map +1 -1
- package/dist/config.js +10 -5
- package/dist/config.js.map +1 -1
- package/dist/index.d.ts +5 -4
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +31 -10
- package/dist/index.js.map +1 -1
- package/dist/types.d.ts +1 -0
- package/dist/types.d.ts.map +1 -1
- package/dist/utils.d.ts +1 -0
- package/dist/utils.d.ts.map +1 -1
- package/dist/utils.js +25 -1
- package/dist/utils.js.map +1 -1
- package/package.json +1 -1
- package/readme.md +14 -12
package/dist/config.d.ts
CHANGED
|
@@ -1,8 +1,12 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* config.ts — loads environment variables into a typed BotConfig.
|
|
3
3
|
*
|
|
4
|
-
*
|
|
5
|
-
*
|
|
4
|
+
* env vars:
|
|
5
|
+
* SOLANA_RPC_URL — solana RPC endpoint (required, fallback: RPC_URL)
|
|
6
|
+
* VAULT_CREATOR — vault creator pubkey (required)
|
|
7
|
+
* SOLANA_PRIVATE_KEY — disposable controller keypair, base58 (optional)
|
|
8
|
+
* SCAN_INTERVAL_MS — ms between scan cycles (default 30000, min 5000)
|
|
9
|
+
* LOG_LEVEL — debug | info | warn | error (default info)
|
|
6
10
|
*/
|
|
7
11
|
import type { BotConfig } from './types';
|
|
8
12
|
export declare const loadConfig: () => BotConfig;
|
package/dist/config.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA
|
|
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
CHANGED
|
@@ -2,19 +2,24 @@
|
|
|
2
2
|
/**
|
|
3
3
|
* config.ts — loads environment variables into a typed BotConfig.
|
|
4
4
|
*
|
|
5
|
-
*
|
|
6
|
-
*
|
|
5
|
+
* env vars:
|
|
6
|
+
* SOLANA_RPC_URL — solana RPC endpoint (required, fallback: RPC_URL)
|
|
7
|
+
* VAULT_CREATOR — vault creator pubkey (required)
|
|
8
|
+
* SOLANA_PRIVATE_KEY — disposable controller keypair, base58 (optional)
|
|
9
|
+
* SCAN_INTERVAL_MS — ms between scan cycles (default 30000, min 5000)
|
|
10
|
+
* LOG_LEVEL — debug | info | warn | error (default info)
|
|
7
11
|
*/
|
|
8
12
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
9
13
|
exports.loadConfig = void 0;
|
|
10
14
|
const LOG_LEVELS = ['debug', 'info', 'warn', 'error'];
|
|
11
15
|
const loadConfig = () => {
|
|
12
|
-
const rpcUrl = process.env.RPC_URL;
|
|
16
|
+
const rpcUrl = process.env.SOLANA_RPC_URL ?? process.env.RPC_URL;
|
|
13
17
|
if (!rpcUrl)
|
|
14
|
-
throw new Error('
|
|
18
|
+
throw new Error('SOLANA_RPC_URL env var is required (fallback: RPC_URL)');
|
|
15
19
|
const vaultCreator = process.env.VAULT_CREATOR;
|
|
16
20
|
if (!vaultCreator)
|
|
17
21
|
throw new Error('VAULT_CREATOR env var is required (vault creator pubkey)');
|
|
22
|
+
const privateKey = process.env.SOLANA_PRIVATE_KEY ?? null;
|
|
18
23
|
const scanIntervalMs = parseInt(process.env.SCAN_INTERVAL_MS ?? '30000', 10);
|
|
19
24
|
if (isNaN(scanIntervalMs) || scanIntervalMs < 5000) {
|
|
20
25
|
throw new Error('SCAN_INTERVAL_MS must be a number >= 5000');
|
|
@@ -23,7 +28,7 @@ const loadConfig = () => {
|
|
|
23
28
|
if (!LOG_LEVELS.includes(logLevel)) {
|
|
24
29
|
throw new Error(`LOG_LEVEL must be one of: ${LOG_LEVELS.join(', ')}`);
|
|
25
30
|
}
|
|
26
|
-
return { rpcUrl, vaultCreator, scanIntervalMs, logLevel };
|
|
31
|
+
return { rpcUrl, vaultCreator, privateKey, scanIntervalMs, logLevel };
|
|
27
32
|
};
|
|
28
33
|
exports.loadConfig = loadConfig;
|
|
29
34
|
//# sourceMappingURL=config.js.map
|
package/dist/config.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";AAAA
|
|
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
CHANGED
|
@@ -2,15 +2,16 @@
|
|
|
2
2
|
/**
|
|
3
3
|
* torch-liquidation-bot — vault-based liquidation bot.
|
|
4
4
|
*
|
|
5
|
-
* generates an agent keypair in-process
|
|
6
|
-
* a torch vault identified by VAULT_CREATOR.
|
|
5
|
+
* generates an agent keypair in-process (or uses SOLANA_PRIVATE_KEY if provided).
|
|
6
|
+
* all operations route through a torch vault identified by VAULT_CREATOR.
|
|
7
7
|
*
|
|
8
8
|
* usage:
|
|
9
|
-
* VAULT_CREATOR=<pubkey>
|
|
9
|
+
* VAULT_CREATOR=<pubkey> SOLANA_RPC_URL=<rpc> npx tsx src/index.ts
|
|
10
10
|
*
|
|
11
11
|
* env:
|
|
12
|
-
*
|
|
12
|
+
* SOLANA_RPC_URL — solana RPC endpoint (required, fallback: RPC_URL)
|
|
13
13
|
* VAULT_CREATOR — vault creator pubkey (required)
|
|
14
|
+
* SOLANA_PRIVATE_KEY — disposable controller keypair, base58 (optional)
|
|
14
15
|
* SCAN_INTERVAL_MS — ms between scan cycles (default 30000, min 5000)
|
|
15
16
|
* LOG_LEVEL — debug | info | warn | error (default info)
|
|
16
17
|
*/
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;GAeG"}
|
package/dist/index.js
CHANGED
|
@@ -3,15 +3,16 @@
|
|
|
3
3
|
/**
|
|
4
4
|
* torch-liquidation-bot — vault-based liquidation bot.
|
|
5
5
|
*
|
|
6
|
-
* generates an agent keypair in-process
|
|
7
|
-
* a torch vault identified by VAULT_CREATOR.
|
|
6
|
+
* generates an agent keypair in-process (or uses SOLANA_PRIVATE_KEY if provided).
|
|
7
|
+
* all operations route through a torch vault identified by VAULT_CREATOR.
|
|
8
8
|
*
|
|
9
9
|
* usage:
|
|
10
|
-
* VAULT_CREATOR=<pubkey>
|
|
10
|
+
* VAULT_CREATOR=<pubkey> SOLANA_RPC_URL=<rpc> npx tsx src/index.ts
|
|
11
11
|
*
|
|
12
12
|
* env:
|
|
13
|
-
*
|
|
13
|
+
* SOLANA_RPC_URL — solana RPC endpoint (required, fallback: RPC_URL)
|
|
14
14
|
* VAULT_CREATOR — vault creator pubkey (required)
|
|
15
|
+
* SOLANA_PRIVATE_KEY — disposable controller keypair, base58 (optional)
|
|
15
16
|
* SCAN_INTERVAL_MS — ms between scan cycles (default 30000, min 5000)
|
|
16
17
|
* LOG_LEVEL — debug | info | warn | error (default info)
|
|
17
18
|
*/
|
|
@@ -21,13 +22,9 @@ const torchsdk_1 = require("torchsdk");
|
|
|
21
22
|
const config_1 = require("./config");
|
|
22
23
|
const utils_1 = require("./utils");
|
|
23
24
|
// ---------------------------------------------------------------------------
|
|
24
|
-
// bootstrap — generate agent keypair in-process
|
|
25
|
-
// ---------------------------------------------------------------------------
|
|
26
|
-
const agentKeypair = web3_js_1.Keypair.generate();
|
|
27
|
-
// ---------------------------------------------------------------------------
|
|
28
25
|
// scan & liquidate
|
|
29
26
|
// ---------------------------------------------------------------------------
|
|
30
|
-
const scanAndLiquidate = async (connection, log, vaultCreator) => {
|
|
27
|
+
const scanAndLiquidate = async (connection, log, vaultCreator, agentKeypair) => {
|
|
31
28
|
const { tokens } = await (0, torchsdk_1.getTokens)(connection, {
|
|
32
29
|
status: 'migrated',
|
|
33
30
|
sort: 'volume',
|
|
@@ -99,6 +96,30 @@ const main = async () => {
|
|
|
99
96
|
const config = (0, config_1.loadConfig)();
|
|
100
97
|
const log = (0, utils_1.createLogger)(config.logLevel);
|
|
101
98
|
const connection = new web3_js_1.Connection(config.rpcUrl, 'confirmed');
|
|
99
|
+
// load or generate agent keypair
|
|
100
|
+
let agentKeypair;
|
|
101
|
+
if (config.privateKey) {
|
|
102
|
+
try {
|
|
103
|
+
const parsed = JSON.parse(config.privateKey);
|
|
104
|
+
if (Array.isArray(parsed)) {
|
|
105
|
+
agentKeypair = web3_js_1.Keypair.fromSecretKey(Uint8Array.from(parsed));
|
|
106
|
+
}
|
|
107
|
+
else {
|
|
108
|
+
throw new Error('SOLANA_PRIVATE_KEY JSON must be a byte array');
|
|
109
|
+
}
|
|
110
|
+
}
|
|
111
|
+
catch (e) {
|
|
112
|
+
if (e.message?.includes('byte array'))
|
|
113
|
+
throw e;
|
|
114
|
+
// not JSON — try base58
|
|
115
|
+
agentKeypair = web3_js_1.Keypair.fromSecretKey((0, utils_1.decodeBase58)(config.privateKey));
|
|
116
|
+
}
|
|
117
|
+
log('info', 'loaded keypair from SOLANA_PRIVATE_KEY');
|
|
118
|
+
}
|
|
119
|
+
else {
|
|
120
|
+
agentKeypair = web3_js_1.Keypair.generate();
|
|
121
|
+
log('info', 'generated fresh agent keypair');
|
|
122
|
+
}
|
|
102
123
|
console.log('=== torch liquidation bot ===');
|
|
103
124
|
console.log(`agent wallet: ${agentKeypair.publicKey.toBase58()}`);
|
|
104
125
|
console.log(`vault creator: ${config.vaultCreator}`);
|
|
@@ -134,7 +155,7 @@ const main = async () => {
|
|
|
134
155
|
while (true) {
|
|
135
156
|
try {
|
|
136
157
|
log('debug', '--- scan cycle start ---');
|
|
137
|
-
await scanAndLiquidate(connection, log, config.vaultCreator);
|
|
158
|
+
await scanAndLiquidate(connection, log, config.vaultCreator, agentKeypair);
|
|
138
159
|
log('debug', '--- scan cycle end ---');
|
|
139
160
|
}
|
|
140
161
|
catch (err) {
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;AACA
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
package/dist/types.d.ts
CHANGED
package/dist/types.d.ts.map
CHANGED
|
@@ -1 +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,SAAS;IACxB,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,MAAM,CAAA;IACpB,cAAc,EAAE,MAAM,CAAA;IACtB,QAAQ,EAAE,QAAQ,CAAA;CACnB"}
|
|
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/utils.d.ts
CHANGED
|
@@ -4,5 +4,6 @@
|
|
|
4
4
|
import type { LogLevel } from './types';
|
|
5
5
|
export declare const sol: (lamports: number) => string;
|
|
6
6
|
export declare const bpsToPercent: (bps: number) => string;
|
|
7
|
+
export declare const decodeBase58: (s: string) => Uint8Array;
|
|
7
8
|
export declare function createLogger(minLevel: LogLevel): (level: LogLevel, msg: string) => void;
|
|
8
9
|
//# sourceMappingURL=utils.d.ts.map
|
package/dist/utils.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
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;
|
|
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,YAAY,CAAC,QAAQ,EAAE,QAAQ,IAGzB,OAAO,QAAQ,EAAE,KAAK,MAAM,UAMjD"}
|
package/dist/utils.js
CHANGED
|
@@ -3,13 +3,37 @@
|
|
|
3
3
|
* utils.ts — shared helpers.
|
|
4
4
|
*/
|
|
5
5
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
6
|
-
exports.bpsToPercent = exports.sol = void 0;
|
|
6
|
+
exports.decodeBase58 = exports.bpsToPercent = exports.sol = void 0;
|
|
7
7
|
exports.createLogger = createLogger;
|
|
8
8
|
const torchsdk_1 = require("torchsdk");
|
|
9
9
|
const sol = (lamports) => (lamports / torchsdk_1.LAMPORTS_PER_SOL).toFixed(4);
|
|
10
10
|
exports.sol = sol;
|
|
11
11
|
const bpsToPercent = (bps) => (bps / 100).toFixed(2) + '%';
|
|
12
12
|
exports.bpsToPercent = bpsToPercent;
|
|
13
|
+
// base58 decoder — avoids ESM-only bs58 dependency
|
|
14
|
+
const B58 = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz';
|
|
15
|
+
const decodeBase58 = (s) => {
|
|
16
|
+
const result = [];
|
|
17
|
+
for (let i = 0; i < s.length; i++) {
|
|
18
|
+
let carry = B58.indexOf(s[i]);
|
|
19
|
+
if (carry < 0)
|
|
20
|
+
throw new Error(`invalid base58 character: ${s[i]}`);
|
|
21
|
+
for (let j = 0; j < result.length; j++) {
|
|
22
|
+
carry += result[j] * 58;
|
|
23
|
+
result[j] = carry & 0xff;
|
|
24
|
+
carry >>= 8;
|
|
25
|
+
}
|
|
26
|
+
while (carry > 0) {
|
|
27
|
+
result.push(carry & 0xff);
|
|
28
|
+
carry >>= 8;
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
for (let i = 0; i < s.length && s[i] === '1'; i++) {
|
|
32
|
+
result.push(0);
|
|
33
|
+
}
|
|
34
|
+
return new Uint8Array(result.reverse());
|
|
35
|
+
};
|
|
36
|
+
exports.decodeBase58 = decodeBase58;
|
|
13
37
|
const LEVEL_ORDER = ['debug', 'info', 'warn', 'error'];
|
|
14
38
|
function createLogger(minLevel) {
|
|
15
39
|
const minIdx = LEVEL_ORDER.indexOf(minLevel);
|
package/dist/utils.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":";AAAA;;GAEG;;;
|
|
1
|
+
{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAmCH,oCASC;AA1CD,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,mDAAmD;AACnD,MAAM,GAAG,GAAG,4DAA4D,CAAA;AAEjE,MAAM,YAAY,GAAG,CAAC,CAAS,EAAc,EAAE;IACpD,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,IAAI,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QAC7B,IAAI,KAAK,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;QACnE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACvC,KAAK,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,CAAA;YACvB,MAAM,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,IAAI,CAAA;YACxB,KAAK,KAAK,CAAC,CAAA;QACb,CAAC;QACD,OAAO,KAAK,GAAG,CAAC,EAAE,CAAC;YACjB,MAAM,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,CAAA;YACzB,KAAK,KAAK,CAAC,CAAA;QACb,CAAC;IACH,CAAC;IACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAClD,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAChB,CAAC;IACD,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAA;AACzC,CAAC,CAAA;AAnBY,QAAA,YAAY,gBAmBxB;AAED,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
CHANGED
package/readme.md
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
|
-
# torch-liquidation-bot v3.0.
|
|
1
|
+
# torch-liquidation-bot v3.0.1 (Vault Mode)
|
|
2
2
|
|
|
3
3
|
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.
|
|
4
4
|
|
|
5
|
-
> **v3.0.0 Breaking Change:** The bot now operates through the torchsdk
|
|
5
|
+
> **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.
|
|
6
6
|
|
|
7
7
|
## Install
|
|
8
8
|
|
|
@@ -14,7 +14,7 @@ npm install torch-liquidation-bot
|
|
|
14
14
|
|
|
15
15
|
```bash
|
|
16
16
|
# 1. start the bot — it prints its agent wallet on startup
|
|
17
|
-
VAULT_CREATOR=<your-vault-creator-pubkey>
|
|
17
|
+
VAULT_CREATOR=<your-vault-creator-pubkey> SOLANA_RPC_URL=<rpc> npx torch-liquidation-bot
|
|
18
18
|
|
|
19
19
|
# 2. link the printed agent wallet to your vault (one-time, from your authority wallet)
|
|
20
20
|
# the bot will print the exact instructions if the wallet is not yet linked
|
|
@@ -42,14 +42,15 @@ All value flows through the vault. The agent wallet is a stateless controller.
|
|
|
42
42
|
|
|
43
43
|
| Variable | Required | Default | Description |
|
|
44
44
|
|----------|----------|---------|-------------|
|
|
45
|
-
| `
|
|
45
|
+
| `SOLANA_RPC_URL` | yes | -- | Solana RPC endpoint (fallback: `RPC_URL`) |
|
|
46
46
|
| `VAULT_CREATOR` | yes | -- | Vault creator pubkey (identifies which vault to use) |
|
|
47
|
+
| `SOLANA_PRIVATE_KEY` | no | -- | Disposable controller keypair (base58 or JSON byte array). If omitted, generates fresh keypair on startup |
|
|
47
48
|
| `SCAN_INTERVAL_MS` | no | `30000` | Milliseconds between scan cycles (min 5000) |
|
|
48
49
|
| `LOG_LEVEL` | no | `info` | `debug`, `info`, `warn`, `error` |
|
|
49
50
|
|
|
50
51
|
## Vault Setup
|
|
51
52
|
|
|
52
|
-
The bot uses the torchsdk
|
|
53
|
+
The bot uses the torchsdk v3.2.3 vault model:
|
|
53
54
|
|
|
54
55
|
```
|
|
55
56
|
User (hardware wallet) → Creates vault, deposits SOL
|
|
@@ -81,7 +82,8 @@ const connection = new Connection('<rpc>', 'confirmed')
|
|
|
81
82
|
const agent = Keypair.generate()
|
|
82
83
|
|
|
83
84
|
// verify vault and link
|
|
84
|
-
const
|
|
85
|
+
const vaultCreator = '<vault-creator-pubkey>'
|
|
86
|
+
const vault = await getVault(connection, vaultCreator)
|
|
85
87
|
const link = await getVaultForWallet(connection, agent.publicKey.toBase58())
|
|
86
88
|
|
|
87
89
|
// scan and liquidate
|
|
@@ -100,6 +102,7 @@ for (const token of tokens) {
|
|
|
100
102
|
mint: token.mint,
|
|
101
103
|
liquidator: agent.publicKey.toBase58(),
|
|
102
104
|
borrower: holder.address,
|
|
105
|
+
vault: vaultCreator,
|
|
103
106
|
})
|
|
104
107
|
transaction.sign(agent)
|
|
105
108
|
const sig = await connection.sendRawTransaction(transaction.serialize())
|
|
@@ -113,7 +116,7 @@ for (const token of tokens) {
|
|
|
113
116
|
```
|
|
114
117
|
src/
|
|
115
118
|
├── types.ts — BotConfig interface
|
|
116
|
-
├── config.ts — loadConfig() (
|
|
119
|
+
├── config.ts — loadConfig() (SOLANA_RPC_URL, VAULT_CREATOR, SOLANA_PRIVATE_KEY, SCAN_INTERVAL_MS, LOG_LEVEL)
|
|
117
120
|
├── utils.ts — sol(), bpsToPercent(), createLogger()
|
|
118
121
|
└── index.ts — vault-based liquidation loop
|
|
119
122
|
```
|
|
@@ -139,19 +142,18 @@ pnpm test
|
|
|
139
142
|
|
|
140
143
|
## Security
|
|
141
144
|
|
|
142
|
-
- Agent keypair generated in-process
|
|
143
|
-
- No user wallet or private key imported from environment
|
|
145
|
+
- Agent keypair generated in-process with `Keypair.generate()` (or loaded from optional `SOLANA_PRIVATE_KEY`)
|
|
144
146
|
- Vault model: agent is a stateless controller, all value stays in the vault
|
|
145
147
|
- Authority can unlink the agent wallet instantly via `buildUnlinkWalletTransaction()`
|
|
146
|
-
-
|
|
147
|
-
- Minimal dependencies: `@solana/web3.js` + `torchsdk`
|
|
148
|
+
- Minimal dependencies: `@solana/web3.js` + `torchsdk` -- both pinned to exact versions
|
|
148
149
|
- No post-install hooks, no remote code fetching
|
|
150
|
+
- SDK contacts three external services (SAID Protocol, CoinGecko, Irys) -- all read-only, no credentials sent
|
|
149
151
|
|
|
150
152
|
## Links
|
|
151
153
|
|
|
152
154
|
- [torchsdk](https://github.com/mrsirg97-rgb/torchsdk) -- the SDK powering this bot
|
|
153
155
|
- [Torch Market](https://torch.market) -- the protocol
|
|
154
|
-
- [ClawHub](https://clawhub.ai/mrsirg97-rgb/
|
|
156
|
+
- [ClawHub](https://clawhub.ai/mrsirg97-rgb/torch-liquidation-bot) -- skill registry
|
|
155
157
|
|
|
156
158
|
## License
|
|
157
159
|
|