@noves/noves-mcp-server/dist/handlers/wallet-handlers.js

MCP server that wraps Noves Intent service for natural language blockchain data

import { GetWalletSummarySchema, AnalyzeWalletSchema, } from '../schemas/index.js';
/**
 * Wallet analysis tool handlers
 */
export class WalletHandlers {
    constructor(provider) {
        this.provider = provider;
    }
    /**
     * Handle getting wallet summary (comprehensive overview)
     */
    async handleGetWalletSummary(args) {
        const { chain, walletAddress, limit = 10 } = GetWalletSummarySchema.parse(args);
        const transactions = await this.provider.getRecentTxs(chain, walletAddress);
        const limitedTransactions = transactions.slice(0, limit);
        // Analyze transaction patterns
        const transactionTypes = transactions.reduce((acc, tx) => {
            const type = tx.classificationData.type;
            acc[type] = (acc[type] || 0) + 1;
            return acc;
        }, {});
        const mostCommonType = Object.entries(transactionTypes)
            .sort(([, a], [, b]) => b - a)[0];
        const summary = `**Comprehensive Wallet Summary**

**Wallet:** ${walletAddress}
**Chain:** ${chain}
**Analysis of ${limitedTransactions.length} Recent Transactions**

**Quick Stats:**
- Total Recent Transactions: ${transactions.length}
- Most Common Activity: ${mostCommonType ? `${mostCommonType[0]} (${mostCommonType[1]}x)` : 'None'}
- Transaction Types: ${Object.keys(transactionTypes).length}

**Recent Activity:**
${limitedTransactions.map((tx, index) => `${index + 1}. ${tx.classificationData.description}`).join('\n')}

**Activity Breakdown:**
${Object.entries(transactionTypes)
            .sort(([, a], [, b]) => b - a)
            .slice(0, 5)
            .map(([type, count]) => `- ${type}: ${count} transactions`)
            .join('\n')}`;
        return {
            content: [
                {
                    type: 'text',
                    text: summary,
                },
            ],
        };
    }
    /**
     * Handle wallet analysis
     */
    async handleAnalyzeWallet(args) {
        const { chain, walletAddress, timeframe = '30d' } = AnalyzeWalletSchema.parse(args);
        const transactions = await this.provider.getRecentTxs(chain, walletAddress);
        // Basic analysis
        const totalTransactions = transactions.length;
        const transactionTypes = transactions.reduce((acc, tx) => {
            const type = tx.classificationData.type;
            acc[type] = (acc[type] || 0) + 1;
            return acc;
        }, {});
        const uniqueTypes = Object.keys(transactionTypes);
        const mostCommonType = Object.entries(transactionTypes)
            .sort(([, a], [, b]) => b - a)[0];
        const analysis = `**Wallet Analysis for ${walletAddress}**

**Summary:**
- Total Recent Transactions: ${totalTransactions}
- Unique Transaction Types: ${uniqueTypes.length}
- Most Common Activity: ${mostCommonType ? `${mostCommonType[0]} (${mostCommonType[1]} times)` : 'None'}
- Chain: ${chain}
- Analysis Period: ${timeframe}

**Transaction Type Breakdown:**
${Object.entries(transactionTypes)
            .sort(([, a], [, b]) => b - a)
            .map(([type, count]) => `- ${type}: ${count} transactions`)
            .join('\n')}

**Recent Activity Sample:**
${transactions.slice(0, 3).map((tx, index) => `${index + 1}. ${tx.classificationData.description}`).join('\n')}`;
        return {
            content: [
                {
                    type: 'text',
                    text: analysis,
                },
            ],
        };
    }
}