vacuum-sol 1.0.0

package/dist/services/reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../../src/services/reporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAKlD;;GAEG;AACH,qBAAa,QAAQ;IACnB;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,UAAU,CAAC;IAsB3C;;OAEG;IACH,YAAY,IAAI,IAAI;IAmBpB;;OAEG;IACH,YAAY,CAAC,KAAK,SAAK,GAAG,IAAI;IAwB9B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAuBnC;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;CAexE;AAGD,eAAO,MAAM,QAAQ,UAAiB,CAAA"}

package/dist/services/reporter.js

@@ -0,0 +1,107 @@
+import { getAccountStats, getReclaimHistory } from '../db/accounts.js';
+import { formatDate, formatSol, lamportsToSol } from '../utils/helpers.js';
+import { logger } from '../utils/logger.js';
+/**
+ * Generate comprehensive rent reports
+ */
+export class Reporter {
+    /**
+     * Generate a full rent report
+     */
+    async generateReport() {
+        const stats = getAccountStats();
+        return {
+            totalTrackedAccounts: stats.total,
+            activeAccounts: stats.active,
+            reclaimableAccounts: stats.reclaimable,
+            reclaimedAccounts: stats.reclaimed,
+            protectedAccounts: stats.protected,
+            totalRentLockedLamports: stats.totalRentLocked,
+            totalRentReclaimedLamports: stats.totalRentReclaimed,
+            reclaimableNowLamports: 0, // Will be calculated by detector
+            accountsByType: {
+                token_account: 0,
+                ata: 0,
+                pda: 0,
+                unknown: 0,
+            },
+            generatedAt: new Date(),
+        };
+    }
+    /**
+     * Print a summary report to console
+     */
+    printSummary() {
+        const stats = getAccountStats();
+        logger.newline();
+        logger.box('📊 Rent Reclaim Summary', `Total Accounts Tracked: ${stats.total}
+├─ Active:      ${stats.active}
+├─ Reclaimable: ${stats.reclaimable}
+├─ Reclaimed:   ${stats.reclaimed}
+└─ Protected:   ${stats.protected}
+
+💰 Rent Status
+├─ Locked:    ${formatSol(stats.totalRentLocked)}
+└─ Reclaimed: ${formatSol(stats.totalRentReclaimed)}`);
+        logger.newline();
+    }
+    /**
+     * Print recent reclaim history
+     */
+    printHistory(limit = 10) {
+        const history = getReclaimHistory(limit);
+        if (history.length === 0) {
+            logger.info('No reclaim history yet.');
+            return;
+        }
+        logger.newline();
+        logger.info('📜 Recent Reclaim History:');
+        logger.divider();
+        const tableData = history.map((entry) => ({
+            Account: entry.account_pubkey.slice(0, 8) + '...',
+            Amount: formatSol(entry.amount_reclaimed),
+            Reason: entry.reason,
+            Date: formatDate(new Date(entry.reclaimed_at)),
+            TX: entry.tx_signature.slice(0, 8) + '...',
+        }));
+        logger.table(tableData);
+        logger.newline();
+    }
+    /**
+     * Export report as JSON
+     */
+    async exportJson() {
+        const report = await this.generateReport();
+        const history = getReclaimHistory();
+        return JSON.stringify({
+            report: {
+                ...report,
+                totalRentLockedSol: lamportsToSol(report.totalRentLockedLamports),
+                totalRentReclaimedSol: lamportsToSol(report.totalRentReclaimedLamports),
+            },
+            history: history.map((h) => ({
+                ...h,
+                amount_sol: lamportsToSol(h.amount_reclaimed),
+            })),
+        }, null, 2);
+    }
+    /**
+     * Print alert-style message for significant findings
+     */
+    printAlert(type, message) {
+        const icons = {
+            warning: '⚠️',
+            success: '✅',
+            info: 'ℹ️',
+        };
+        const colors = {
+            warning: logger.warn,
+            success: logger.success,
+            info: logger.info,
+        };
+        colors[type](`${icons[type]} ${message}`);
+    }
+}
+// Export singleton instance
+export const reporter = new Reporter();
+//# sourceMappingURL=reporter.js.map

package/dist/services/reporter.js.map

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

package/dist/services/solana.d.ts

@@ -0,0 +1,59 @@
+import { AccountInfo, Connection, Keypair, ParsedAccountData, PublicKey } from '@solana/web3.js';
+import type { AccountType } from '../core/types.js';
+/**
+ * Get or create a Solana connection
+ */
+export declare function getConnection(): Connection;
+/**
+ * Get the operator keypair for signing transactions
+ */
+export declare function getOperatorKeypair(): Keypair;
+/**
+ * Get account info with retry logic
+ */
+export declare function getAccountInfo(pubkey: PublicKey): Promise<AccountInfo<Buffer> | null>;
+/**
+ * Get multiple accounts info
+ */
+export declare function getMultipleAccountsInfo(pubkeys: PublicKey[]): Promise<(AccountInfo<Buffer> | null)[]>;
+/**
+ * Check if an account exists (has lamports)
+ */
+export declare function accountExists(pubkey: PublicKey): Promise<boolean>;
+/**
+ * Get the type of account based on owner program
+ */
+export declare function detectAccountType(accountInfo: AccountInfo<Buffer>): AccountType;
+/**
+ * Get token account data (balance, owner, mint)
+ */
+export declare function getTokenAccountData(pubkey: PublicKey): Promise<{
+    mint: PublicKey;
+    owner: PublicKey;
+    amount: bigint;
+    lamports: number;
+} | null>;
+/**
+ * Close a token account and reclaim rent
+ */
+export declare function closeTokenAccount(tokenAccountPubkey: PublicKey, destinationPubkey: PublicKey, authorityKeypair: Keypair): Promise<string>;
+/**
+ * Get recent transactions for an account
+ */
+export declare function getRecentSignatures(pubkey: PublicKey, limit?: number): Promise<string[]>;
+/**
+ * Get all token accounts owned by operator
+ */
+export declare function getOperatorTokenAccounts(): Promise<{
+    pubkey: PublicKey;
+    account: AccountInfo<ParsedAccountData>;
+}[]>;
+/**
+ * Get current slot
+ */
+export declare function getCurrentSlot(): Promise<number>;
+/**
+ * Get rent exempt minimum for a given data size
+ */
+export declare function getRentExemptMinimum(dataSize: number): Promise<number>;
+//# sourceMappingURL=solana.d.ts.map

package/dist/services/solana.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"solana.d.ts","sourceRoot":"","sources":["../../src/services/solana.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,WAAW,EACX,UAAU,EACV,OAAO,EACP,iBAAiB,EACjB,SAAS,EAGV,MAAM,iBAAiB,CAAA;AAExB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAOnD;;GAEG;AACH,wBAAgB,aAAa,IAAI,UAAU,CAO1C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAQ5C;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,SAAS,GAChB,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAKrC;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,SAAS,EAAE,GACnB,OAAO,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,CAKzC;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAGvE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,GAC/B,WAAW,CAsBb;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;IACpE,IAAI,EAAE,SAAS,CAAA;IACf,KAAK,EAAE,SAAS,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;CACjB,GAAG,IAAI,CAAC,CAuBR;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,kBAAkB,EAAE,SAAS,EAC7B,iBAAiB,EAAE,SAAS,EAC5B,gBAAgB,EAAE,OAAO,GACxB,OAAO,CAAC,MAAM,CAAC,CA2CjB;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,SAAS,EACjB,KAAK,SAAK,GACT,OAAO,CAAC,MAAM,EAAE,CAAC,CAInB;AAED;;GAEG;AACH,wBAAsB,wBAAwB,IAAI,OAAO,CACvD;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,WAAW,CAAC,iBAAiB,CAAC,CAAA;CAAE,EAAE,CACjE,CASA;AAED;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAGtD;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAG5E"}

package/dist/services/solana.js

@@ -0,0 +1,162 @@
+import { TOKEN_PROGRAM_ID, TokenAccountNotFoundError, TokenInvalidAccountOwnerError, createCloseAccountInstruction, getAccount, } from '@solana/spl-token';
+import { Connection, Keypair, PublicKey, Transaction, sendAndConfirmTransaction, } from '@solana/web3.js';
+import { getConfig, loadOperatorKeypair } from '../config.js';
+import { retry } from '../utils/helpers.js';
+import { logger } from '../utils/logger.js';
+let connection = null;
+let operatorKeypair = null;
+/**
+ * Get or create a Solana connection
+ */
+export function getConnection() {
+    if (!connection) {
+        const config = getConfig();
+        connection = new Connection(config.rpcUrl, 'confirmed');
+        logger.debug(`Connected to Solana RPC: ${config.rpcUrl}`);
+    }
+    return connection;
+}
+/**
+ * Get the operator keypair for signing transactions
+ */
+export function getOperatorKeypair() {
+    if (!operatorKeypair) {
+        const config = getConfig();
+        const secretKey = loadOperatorKeypair(config.operatorKeypairPath);
+        operatorKeypair = Keypair.fromSecretKey(secretKey);
+        logger.debug(`Operator address: ${operatorKeypair.publicKey.toBase58()}`);
+    }
+    return operatorKeypair;
+}
+/**
+ * Get account info with retry logic
+ */
+export async function getAccountInfo(pubkey) {
+    const conn = getConnection();
+    return retry(async () => {
+        return conn.getAccountInfo(pubkey);
+    });
+}
+/**
+ * Get multiple accounts info
+ */
+export async function getMultipleAccountsInfo(pubkeys) {
+    const conn = getConnection();
+    return retry(async () => {
+        return conn.getMultipleAccountsInfo(pubkeys);
+    });
+}
+/**
+ * Check if an account exists (has lamports)
+ */
+export async function accountExists(pubkey) {
+    const info = await getAccountInfo(pubkey);
+    return info !== null && info.lamports > 0;
+}
+/**
+ * Get the type of account based on owner program
+ */
+export function detectAccountType(accountInfo) {
+    const owner = accountInfo.owner;
+    if (owner.equals(TOKEN_PROGRAM_ID)) {
+        return 'token_account';
+    }
+    // Check for Associated Token Program
+    const ASSOCIATED_TOKEN_PROGRAM_ID = new PublicKey('ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL');
+    if (owner.equals(ASSOCIATED_TOKEN_PROGRAM_ID)) {
+        return 'ata';
+    }
+    // If owned by a program (not system), it's likely a PDA
+    const SYSTEM_PROGRAM_ID = new PublicKey('11111111111111111111111111111111');
+    if (!owner.equals(SYSTEM_PROGRAM_ID)) {
+        return 'pda';
+    }
+    return 'unknown';
+}
+/**
+ * Get token account data (balance, owner, mint)
+ */
+export async function getTokenAccountData(pubkey) {
+    try {
+        const conn = getConnection();
+        const account = await getAccount(conn, pubkey);
+        const info = await getAccountInfo(pubkey);
+        const lamports = info?.lamports || 0;
+        return {
+            mint: account.mint,
+            owner: account.owner,
+            amount: account.amount,
+            lamports,
+        };
+    }
+    catch (error) {
+        if (error instanceof TokenAccountNotFoundError ||
+            error instanceof TokenInvalidAccountOwnerError) {
+            return null;
+        }
+        throw error;
+    }
+}
+/**
+ * Close a token account and reclaim rent
+ */
+export async function closeTokenAccount(tokenAccountPubkey, destinationPubkey, authorityKeypair) {
+    const conn = getConnection();
+    // Verify the token account has zero balance
+    const tokenData = await getTokenAccountData(tokenAccountPubkey);
+    if (!tokenData) {
+        throw new Error(`Token account not found: ${tokenAccountPubkey.toBase58()}`);
+    }
+    if (tokenData.amount > 0n) {
+        throw new Error(`Cannot close token account with non-zero balance: ${tokenData.amount}`);
+    }
+    // Verify authority matches
+    if (!tokenData.owner.equals(authorityKeypair.publicKey)) {
+        throw new Error(`Authority mismatch. Account owner: ${tokenData.owner.toBase58()}, ` +
+            `provided authority: ${authorityKeypair.publicKey.toBase58()}`);
+    }
+    // Build close instruction
+    const closeInstruction = createCloseAccountInstruction(tokenAccountPubkey, destinationPubkey, authorityKeypair.publicKey);
+    const transaction = new Transaction().add(closeInstruction);
+    // Send and confirm transaction
+    const signature = await sendAndConfirmTransaction(conn, transaction, [
+        authorityKeypair,
+    ]);
+    logger.success(`Closed token account ${tokenAccountPubkey.toBase58()}, ` +
+        `reclaimed ${tokenData.lamports} lamports. TX: ${signature}`);
+    return signature;
+}
+/**
+ * Get recent transactions for an account
+ */
+export async function getRecentSignatures(pubkey, limit = 10) {
+    const conn = getConnection();
+    const signatures = await conn.getSignaturesForAddress(pubkey, { limit });
+    return signatures.map((s) => s.signature);
+}
+/**
+ * Get all token accounts owned by operator
+ */
+export async function getOperatorTokenAccounts() {
+    const conn = getConnection();
+    const operator = getOperatorKeypair();
+    const result = await conn.getParsedTokenAccountsByOwner(operator.publicKey, {
+        programId: TOKEN_PROGRAM_ID,
+    });
+    return result.value;
+}
+/**
+ * Get current slot
+ */
+export async function getCurrentSlot() {
+    const conn = getConnection();
+    return conn.getSlot();
+}
+/**
+ * Get rent exempt minimum for a given data size
+ */
+export async function getRentExemptMinimum(dataSize) {
+    const conn = getConnection();
+    return conn.getMinimumBalanceForRentExemption(dataSize);
+}
+//# sourceMappingURL=solana.js.map

package/dist/services/solana.js.map

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

package/dist/services/telegram.d.ts

@@ -0,0 +1,20 @@
+import { Telegraf } from 'telegraf';
+declare let bot: Telegraf | null;
+/**
+ * Initialize the Telegram bot
+ */
+export declare function initTelegramBot(token: string, chatId?: string): Telegraf;
+/**
+ * Send a notification message
+ */
+export declare function sendNotification(message: string): Promise<void>;
+/**
+ * Send reclaim alert
+ */
+export declare function sendReclaimAlert(amount: number, accounts: number, txSignatures: string[]): Promise<void>;
+/**
+ * Start the Telegram bot (polling mode)
+ */
+export declare function startBot(token: string, chatId?: string): Promise<void>;
+export { bot };
+//# sourceMappingURL=telegram.d.ts.map

package/dist/services/telegram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram.d.ts","sourceRoot":"","sources":["../../src/services/telegram.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AASnC,QAAA,IAAI,GAAG,EAAE,QAAQ,GAAG,IAAW,CAAA;AAG/B;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAsMxE;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAarE;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC,IAAI,CAAC,CAYf;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAS5E;AAED,OAAO,EAAE,GAAG,EAAE,CAAA"}

package/dist/services/telegram.js

@@ -0,0 +1,213 @@
+import { Telegraf } from 'telegraf';
+import { detector } from '../core/detector.js';
+import { monitor } from '../core/monitor.js';
+import { reclaimer } from '../core/reclaimer.js';
+import { getAccountStats, getReclaimHistory } from '../db/accounts.js';
+import { initDatabase } from '../db/index.js';
+import { formatSol, shortenPubkey } from '../utils/helpers.js';
+import { logger } from '../utils/logger.js';
+let bot = null;
+let authorizedChatId = null;
+/**
+ * Initialize the Telegram bot
+ */
+export function initTelegramBot(token, chatId) {
+    if (bot)
+        return bot;
+    bot = new Telegraf(token);
+    authorizedChatId = chatId || null;
+    // Initialize database
+    initDatabase();
+    // Middleware to check authorization
+    bot.use(async (ctx, next) => {
+        if (authorizedChatId && ctx.chat?.id.toString() !== authorizedChatId) {
+            await ctx.reply('⛔ Unauthorized. This bot is private.');
+            return;
+        }
+        return next();
+    });
+    // Start command
+    bot.command('start', async (ctx) => {
+        await ctx.reply(`🧹 *Vacuum - Solana Rent Reclaim Bot*\n\n` +
+            `Available commands:\n` +
+            `/status - Show rent summary\n` +
+            `/scan - Scan for new accounts\n` +
+            `/check - Find reclaimable accounts\n` +
+            `/reclaim - Reclaim rent (dry-run)\n` +
+            `/reclaim\\_execute - Actually reclaim\n` +
+            `/history - Show reclaim history\n` +
+            `/help - Show this message`, { parse_mode: 'Markdown' });
+    });
+    // Help command
+    bot.command('help', async (ctx) => {
+        await ctx.reply(`🔧 *Commands*\n\n` +
+            `/status - Current rent status\n` +
+            `/scan - Scan operator token accounts\n` +
+            `/check - Check for reclaimable\n` +
+            `/reclaim - Preview reclaim (safe)\n` +
+            `/reclaim\\_execute - Execute reclaim\n` +
+            `/history - Recent reclaims`, { parse_mode: 'Markdown' });
+    });
+    // Status command
+    bot.command('status', async (ctx) => {
+        try {
+            const stats = getAccountStats();
+            await ctx.reply(`📊 *Rent Status*\n\n` +
+                `Total Tracked: ${stats.total}\n` +
+                `├ Active: ${stats.active}\n` +
+                `├ Reclaimable: ${stats.reclaimable}\n` +
+                `├ Reclaimed: ${stats.reclaimed}\n` +
+                `└ Protected: ${stats.protected}\n\n` +
+                `💰 *Rent*\n` +
+                `├ Locked: ${formatSol(stats.totalRentLocked)}\n` +
+                `└ Reclaimed: ${formatSol(stats.totalRentReclaimed)}`, { parse_mode: 'Markdown' });
+        }
+        catch (error) {
+            await ctx.reply(`❌ Error: ${error}`);
+        }
+    });
+    // Scan command
+    bot.command('scan', async (ctx) => {
+        try {
+            await ctx.reply('🔍 Scanning for accounts...');
+            const accounts = await monitor.scanOperatorAccounts();
+            await ctx.reply(`✅ Found ${accounts.length} token accounts\n` +
+                `Total rent: ${formatSol(accounts.reduce((s, a) => s + a.rentLamports, 0))}`);
+        }
+        catch (error) {
+            await ctx.reply(`❌ Scan failed: ${error}`);
+        }
+    });
+    // Check command
+    bot.command('check', async (ctx) => {
+        try {
+            await ctx.reply('🔍 Checking for reclaimable accounts...');
+            const results = await detector.findSafeReclaimable();
+            if (results.length === 0) {
+                await ctx.reply('✅ No accounts ready for reclaim.');
+                return;
+            }
+            const totalLamports = results.reduce((s, r) => s + r.reclaimableLamports, 0);
+            let message = `💰 *${results.length} accounts reclaimable*\n\n`;
+            for (const r of results.slice(0, 10)) {
+                message += `• ${shortenPubkey(r.account.pubkey)} - ${formatSol(r.reclaimableLamports)}\n`;
+            }
+            if (results.length > 10) {
+                message += `\n... and ${results.length - 10} more\n`;
+            }
+            message += `\n*Total: ${formatSol(totalLamports)}*`;
+            message += `\n\nUse /reclaim to preview or /reclaim\\_execute to reclaim.`;
+            await ctx.reply(message, { parse_mode: 'Markdown' });
+        }
+        catch (error) {
+            await ctx.reply(`❌ Check failed: ${error}`);
+        }
+    });
+    // Reclaim dry-run
+    bot.command('reclaim', async (ctx) => {
+        try {
+            await ctx.reply('🔍 Finding reclaimable accounts...');
+            const results = await detector.findSafeReclaimable();
+            if (results.length === 0) {
+                await ctx.reply('✅ Nothing to reclaim.');
+                return;
+            }
+            const preview = await reclaimer.previewReclaim(results);
+            await ctx.reply(`🔍 *DRY RUN Preview*\n\n` +
+                `Accounts: ${preview.accounts.length}\n` +
+                `Total: ${preview.totalSol}\n\n` +
+                `Use /reclaim\\_execute to actually reclaim.`, { parse_mode: 'Markdown' });
+        }
+        catch (error) {
+            await ctx.reply(`❌ Error: ${error}`);
+        }
+    });
+    // Reclaim execute (actual)
+    bot.command('reclaim_execute', async (ctx) => {
+        try {
+            await ctx.reply('⏳ Finding and reclaiming accounts...');
+            const results = await detector.findSafeReclaimable();
+            if (results.length === 0) {
+                await ctx.reply('✅ Nothing to reclaim.');
+                return;
+            }
+            const reclaimResults = await reclaimer.batchReclaim(results, {
+                dryRun: false,
+                maxAccounts: 10,
+            });
+            const successful = reclaimResults.filter((r) => r.success);
+            const totalReclaimed = successful.reduce((s, r) => s + r.amountReclaimed, 0);
+            await ctx.reply(`✅ *Reclaim Complete*\n\n` +
+                `Successful: ${successful.length}/${reclaimResults.length}\n` +
+                `Total Reclaimed: ${formatSol(totalReclaimed)}`, { parse_mode: 'Markdown' });
+        }
+        catch (error) {
+            await ctx.reply(`❌ Reclaim failed: ${error}`);
+        }
+    });
+    // History command
+    bot.command('history', async (ctx) => {
+        try {
+            const history = getReclaimHistory(5);
+            if (history.length === 0) {
+                await ctx.reply('📜 No reclaim history yet.');
+                return;
+            }
+            let message = '📜 *Recent Reclaims*\n\n';
+            for (const h of history) {
+                message += `• ${formatSol(h.amount_reclaimed)} - ${h.reason}\n`;
+                message += `  ${h.reclaimed_at.slice(0, 16)}\n\n`;
+            }
+            await ctx.reply(message, { parse_mode: 'Markdown' });
+        }
+        catch (error) {
+            await ctx.reply(`❌ Error: ${error}`);
+        }
+    });
+    logger.info('Telegram bot initialized');
+    return bot;
+}
+/**
+ * Send a notification message
+ */
+export async function sendNotification(message) {
+    if (!bot || !authorizedChatId) {
+        logger.warn('Telegram bot not configured, skipping notification');
+        return;
+    }
+    try {
+        await bot.telegram.sendMessage(authorizedChatId, message, {
+            parse_mode: 'Markdown',
+        });
+    }
+    catch (error) {
+        logger.error('Failed to send Telegram notification:', error);
+    }
+}
+/**
+ * Send reclaim alert
+ */
+export async function sendReclaimAlert(amount, accounts, txSignatures) {
+    const message = `✅ *Rent Reclaimed*\n\n` +
+        `Amount: ${formatSol(amount)}\n` +
+        `Accounts: ${accounts}\n\n` +
+        `Transactions:\n` +
+        txSignatures
+            .slice(0, 3)
+            .map((tx) => `• ${shortenPubkey(tx)}`)
+            .join('\n');
+    await sendNotification(message);
+}
+/**
+ * Start the Telegram bot (polling mode)
+ */
+export async function startBot(token, chatId) {
+    const telegramBot = initTelegramBot(token, chatId);
+    logger.info('Starting Telegram bot...');
+    await telegramBot.launch();
+    // Graceful shutdown
+    process.once('SIGINT', () => telegramBot.stop('SIGINT'));
+    process.once('SIGTERM', () => telegramBot.stop('SIGTERM'));
+}
+export { bot };
+//# sourceMappingURL=telegram.js.map

package/dist/services/telegram.js.map

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

package/dist/utils/helpers.d.ts

@@ -0,0 +1,55 @@
+import { PublicKey } from '@solana/web3.js';
+/**
+ * Convert lamports to SOL with fixed decimal places
+ */
+export declare function lamportsToSol(lamports: number, decimals?: number): number;
+/**
+ * Convert SOL to lamports
+ */
+export declare function solToLamports(sol: number): number;
+/**
+ * Format lamports as SOL string with symbol
+ */
+export declare function formatSol(lamports: number): string;
+/**
+ * Shorten a public key for display
+ */
+export declare function shortenPubkey(pubkey: PublicKey | string, chars?: number): string;
+/**
+ * Validate a public key string
+ */
+export declare function isValidPubkey(str: string): boolean;
+/**
+ * Parse a public key string safely
+ */
+export declare function parsePubkey(str: string): PublicKey | 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 declare function calculateMinimumRent(dataSize: number): number;
+/**
+ * Token Account size (165 bytes) minimum rent
+ */
+export declare const TOKEN_ACCOUNT_RENT = 2039280;
+/**
+ * Sleep for a given duration
+ */
+export declare function sleep(ms: number): Promise<void>;
+/**
+ * Retry a function with exponential backoff
+ */
+export declare function retry<T>(fn: () => Promise<T>, maxRetries?: number, baseDelayMs?: number): Promise<T>;
+/**
+ * Format a date for display
+ */
+export declare function formatDate(date: Date): string;
+/**
+ * Calculate days since a date
+ */
+export declare function daysSince(date: Date): number;
+/**
+ * Chunk an array into smaller arrays
+ */
+export declare function chunk<T>(array: T[], size: number): T[][];
+//# sourceMappingURL=helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/utils/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAE7D;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,MAAM,CAEpE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,EAAE,KAAK,SAAI,GAAG,MAAM,CAG3E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOlD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAMzD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAW7D;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,UAAU,CAAA;AAEzC;;GAEG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED;;GAEG;AACH,wBAAsB,KAAK,CAAC,CAAC,EAC3B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,UAAU,SAAI,EACd,WAAW,SAAO,GACjB,OAAO,CAAC,CAAC,CAAC,CAgBZ;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE7C;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAI5C;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,EAAE,EAAE,CAMxD"}