vacuum-sol 1.0.0

package/dist/utils/helpers.js

@@ -0,0 +1,116 @@
+import { LAMPORTS_PER_SOL, PublicKey } from '@solana/web3.js';
+/**
+ * Convert lamports to SOL with fixed decimal places
+ */
+export function lamportsToSol(lamports, decimals = 6) {
+    return Number((lamports / LAMPORTS_PER_SOL).toFixed(decimals));
+}
+/**
+ * Convert SOL to lamports
+ */
+export function solToLamports(sol) {
+    return Math.floor(sol * LAMPORTS_PER_SOL);
+}
+/**
+ * Format lamports as SOL string with symbol
+ */
+export function formatSol(lamports) {
+    return `${lamportsToSol(lamports)} SOL`;
+}
+/**
+ * Shorten a public key for display
+ */
+export function shortenPubkey(pubkey, chars = 4) {
+    const str = typeof pubkey === 'string' ? pubkey : pubkey.toBase58();
+    return `${str.slice(0, chars)}...${str.slice(-chars)}`;
+}
+/**
+ * Validate a public key string
+ */
+export function isValidPubkey(str) {
+    try {
+        new PublicKey(str);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Parse a public key string safely
+ */
+export function parsePubkey(str) {
+    try {
+        return new PublicKey(str);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Calculate rent for a given account size
+ * Based on Solana's rent calculation (approx 0.00089 SOL per byte per year for 2 years)
+ */
+export function calculateMinimumRent(dataSize) {
+    // Solana rent: 19.055441478439427 lamports per byte per epoch (2 days)
+    // Rent-exempt = 2 years = 365 epochs
+    // ~6.96 lamports per byte for rent-exempt
+    const LAMPORTS_PER_BYTE_YEAR = 3480;
+    const YEARS_FOR_EXEMPT = 2;
+    const ACCOUNT_HEADER_SIZE = 128; // Account metadata overhead
+    return ((dataSize + ACCOUNT_HEADER_SIZE) * LAMPORTS_PER_BYTE_YEAR * YEARS_FOR_EXEMPT);
+}
+/**
+ * Token Account size (165 bytes) minimum rent
+ */
+export const TOKEN_ACCOUNT_RENT = 2039280; // ~0.00204 SOL
+/**
+ * Sleep for a given duration
+ */
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Retry a function with exponential backoff
+ */
+export async function retry(fn, maxRetries = 3, baseDelayMs = 1000) {
+    let lastError;
+    for (let attempt = 0; attempt < maxRetries; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+            if (attempt < maxRetries - 1) {
+                const delay = baseDelayMs * Math.pow(2, attempt);
+                await sleep(delay);
+            }
+        }
+    }
+    throw lastError;
+}
+/**
+ * Format a date for display
+ */
+export function formatDate(date) {
+    return date.toISOString().replace('T', ' ').slice(0, 19);
+}
+/**
+ * Calculate days since a date
+ */
+export function daysSince(date) {
+    const now = new Date();
+    const diffMs = now.getTime() - date.getTime();
+    return Math.floor(diffMs / (1000 * 60 * 60 * 24));
+}
+/**
+ * Chunk an array into smaller arrays
+ */
+export function chunk(array, size) {
+    const chunks = [];
+    for (let i = 0; i < array.length; i += size) {
+        chunks.push(array.slice(i, i + size));
+    }
+    return chunks;
+}
+//# sourceMappingURL=helpers.js.map

package/dist/utils/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/utils/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAE7D;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,QAAQ,GAAG,CAAC;IAC1D,OAAO,MAAM,CAAC,CAAC,QAAQ,GAAG,gBAAgB,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAA;AAChE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,gBAAgB,CAAC,CAAA;AAC3C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,QAAgB;IACxC,OAAO,GAAG,aAAa,CAAC,QAAQ,CAAC,MAAM,CAAA;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,MAA0B,EAAE,KAAK,GAAG,CAAC;IACjE,MAAM,GAAG,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAA;IACnE,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,EAAE,CAAA;AACxD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,IAAI,CAAC;QACH,IAAI,SAAS,CAAC,GAAG,CAAC,CAAA;QAClB,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,IAAI,CAAC;QACH,OAAO,IAAI,SAAS,CAAC,GAAG,CAAC,CAAA;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAgB;IACnD,uEAAuE;IACvE,qCAAqC;IACrC,0CAA0C;IAC1C,MAAM,sBAAsB,GAAG,IAAI,CAAA;IACnC,MAAM,gBAAgB,GAAG,CAAC,CAAA;IAC1B,MAAM,mBAAmB,GAAG,GAAG,CAAA,CAAC,4BAA4B;IAE5D,OAAO,CACL,CAAC,QAAQ,GAAG,mBAAmB,CAAC,GAAG,sBAAsB,GAAG,gBAAgB,CAC7E,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,OAAO,CAAA,CAAC,eAAe;AAEzD;;GAEG;AACH,MAAM,UAAU,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAA;AAC1D,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CACzB,EAAoB,EACpB,UAAU,GAAG,CAAC,EACd,WAAW,GAAG,IAAI;IAElB,IAAI,SAA4B,CAAA;IAEhC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;QACtD,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAA;QACnB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAc,CAAA;YAC1B,IAAI,OAAO,GAAG,UAAU,GAAG,CAAC,EAAE,CAAC;gBAC7B,MAAM,KAAK,GAAG,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAA;gBAChD,MAAM,KAAK,CAAC,KAAK,CAAC,CAAA;YACpB,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,SAAS,CAAA;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,IAAU;IACnC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;AAC1D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,IAAU;IAClC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAA;IACtB,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAA;IAC7C,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAA;AACnD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,KAAK,CAAI,KAAU,EAAE,IAAY;IAC/C,MAAM,MAAM,GAAU,EAAE,CAAA;IACxB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAA;IACvC,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,14 @@
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'success';
+export declare function setLogLevel(level: LogLevel): void;
+export declare const logger: {
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+    success(message: string, ...args: unknown[]): void;
+    table(data: Record<string, unknown>[]): void;
+    box(title: string, content: string): void;
+    divider(): void;
+    newline(): void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAA;AAYtE,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAEjD;AAUD,eAAO,MAAM,MAAM;mBACF,MAAM,WAAW,OAAO,EAAE,GAAG,IAAI;kBAUlC,MAAM,WAAW,OAAO,EAAE,GAAG,IAAI;kBAMjC,MAAM,WAAW,OAAO,EAAE,GAAG,IAAI;mBAUhC,MAAM,WAAW,OAAO,EAAE,GAAG,IAAI;qBAU/B,MAAM,WAAW,OAAO,EAAE,GAAG,IAAI;gBAWtC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI;eAKjC,MAAM,WAAW,MAAM,GAAG,IAAI;eAe9B,IAAI;eAKJ,IAAI;CAGhB,CAAA"}

package/dist/utils/logger.js

@@ -0,0 +1,70 @@
+import chalk from 'chalk';
+const LOG_LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+    success: 1,
+};
+let currentLogLevel = 'info';
+export function setLogLevel(level) {
+    currentLogLevel = level;
+}
+function shouldLog(level) {
+    return LOG_LEVELS[level] >= LOG_LEVELS[currentLogLevel];
+}
+function formatTimestamp() {
+    return new Date().toISOString().slice(11, 19);
+}
+export const logger = {
+    debug(message, ...args) {
+        if (shouldLog('debug')) {
+            console.log(chalk.gray(`[${formatTimestamp()}] [DEBUG]`), message, ...args);
+        }
+    },
+    info(message, ...args) {
+        if (shouldLog('info')) {
+            console.log(chalk.blue(`[${formatTimestamp()}] [INFO]`), message, ...args);
+        }
+    },
+    warn(message, ...args) {
+        if (shouldLog('warn')) {
+            console.log(chalk.yellow(`[${formatTimestamp()}] [WARN]`), message, ...args);
+        }
+    },
+    error(message, ...args) {
+        if (shouldLog('error')) {
+            console.error(chalk.red(`[${formatTimestamp()}] [ERROR]`), message, ...args);
+        }
+    },
+    success(message, ...args) {
+        if (shouldLog('success')) {
+            console.log(chalk.green(`[${formatTimestamp()}] [SUCCESS]`), message, ...args);
+        }
+    },
+    // Special formatting for tables and reports
+    table(data) {
+        console.table(data);
+    },
+    // Box for important messages
+    box(title, content) {
+        const width = Math.max(title.length, ...content.split('\n').map((l) => l.length)) + 4;
+        const border = '─'.repeat(width);
+        console.log(chalk.cyan(`┌${border}┐`));
+        console.log(chalk.cyan(`│ ${chalk.bold(title.padEnd(width - 2))} │`));
+        console.log(chalk.cyan(`├${border}┤`));
+        for (const line of content.split('\n')) {
+            console.log(chalk.cyan(`│ ${line.padEnd(width - 2)} │`));
+        }
+        console.log(chalk.cyan(`└${border}┘`));
+    },
+    // Divider
+    divider() {
+        console.log(chalk.gray('─'.repeat(50)));
+    },
+    // Empty line
+    newline() {
+        console.log();
+    },
+};
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "vacuum-sol",
+  "version": "1.0.0",
+  "description": "Vacuum - Suck up forgotten rent from Solana accounts",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "vacuum": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx watch src/index.ts",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src --ext .ts",
+    "simulate": "tsx scripts/simulate.ts"
+  },
+  "keywords": [
+    "solana",
+    "rent",
+    "reclaim",
+    "automation",
+    "cli",
+    "bot",
+    "telegram",
+    "web3",
+    "token-accounts"
+  ],
+  "author": "Don-Vicks",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Don-Vicks/vaccum.git"
+  },
+  "homepage": "https://github.com/Don-Vicks/vaccum#readme",
+  "bugs": {
+    "url": "https://github.com/Don-Vicks/vaccum/issues"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@solana/spl-token": "^0.4.9",
+    "@solana/web3.js": "^1.98.0",
+    "better-sqlite3": "^11.7.0",
+    "chalk": "^5.4.1",
+    "commander": "^13.0.0",
+    "cors": "^2.8.6",
+    "dotenv": "^16.4.7",
+    "express": "^5.2.1",
+    "ora": "^8.1.1",
+    "telegraf": "^4.16.3"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.12",
+    "@types/cors": "^2.8.19",
+    "@types/express": "^5.0.6",
+    "@types/node": "^22.10.5",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.3",
+    "vitest": "^2.1.8"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}