@nirholas/bnbchain-mcp 1.0.0

package/build/vendors/payments/utils/request-logger.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @author Nich
+ * @website x.com/nichxbt
+ * @github github.com/nirholas
+ * @license MIT
+ */
+export interface RequestLogContext {
+    requestId: string;
+    operation: string;
+    startTime: number;
+    toolName?: string;
+    userId?: string;
+}
+export declare class RequestLogger {
+    private static requestCounter;
+    /**
+     * Generate unique request ID
+     */
+    static generateRequestId(): string;
+    /**
+     * Log MCP tool request start
+     */
+    static logToolRequestStart(toolName: string, args?: unknown): RequestLogContext;
+    /**
+     * Log MCP tool request completion
+     */
+    static logToolRequestComplete(context: RequestLogContext, success: boolean, error?: unknown): void;
+    /**
+     * Log API request start
+     */
+    static logApiRequestStart(method: string, url: string, operation?: string): RequestLogContext;
+    /**
+     * Log API request completion
+     */
+    static logApiRequestComplete(context: RequestLogContext, statusCode: number, responseSize?: number, error?: unknown): void;
+    /**
+     * Mask sensitive information in URLs
+     */
+    private static maskSensitiveUrl;
+}
+export default RequestLogger;
+//# sourceMappingURL=request-logger.d.ts.map

package/build/vendors/payments/utils/request-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-logger.d.ts","sourceRoot":"","sources":["../../../../src/vendors/payments/utils/request-logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAC,cAAc,CAAK;IAElC;;OAEG;IACH,MAAM,CAAC,iBAAiB,IAAI,MAAM;IAOlC;;OAEG;IACH,MAAM,CAAC,mBAAmB,CACxB,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,OAAO,GACb,iBAAiB;IAoBpB;;OAEG;IACH,MAAM,CAAC,sBAAsB,CAC3B,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,OAAO,EAChB,KAAK,CAAC,EAAE,OAAO,GACd,IAAI;IAsBP;;OAEG;IACH,MAAM,CAAC,kBAAkB,CACvB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,SAAS,CAAC,EAAE,MAAM,GACjB,iBAAiB;IAmBpB;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAC1B,OAAO,EAAE,iBAAiB,EAC1B,UAAU,EAAE,MAAM,EAClB,YAAY,CAAC,EAAE,MAAM,EACrB,KAAK,CAAC,EAAE,OAAO,GACd,IAAI;IAyBP;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;CAkBhC;AAED,eAAe,aAAa,CAAC"}

package/build/vendors/payments/utils/request-logger.js

@@ -0,0 +1,136 @@
+"use strict";
+/**
+ * @author Nich
+ * @website x.com/nichxbt
+ * @github github.com/nirholas
+ * @license MIT
+ */
+// Request/response logging middleware for MCP operations
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequestLogger = void 0;
+const logger_js_1 = require("./logger.js");
+const logger = (0, logger_js_1.getLogger)();
+class RequestLogger {
+    static requestCounter = 0;
+    /**
+     * Generate unique request ID
+     */
+    static generateRequestId() {
+        const timestamp = Date.now().toString(36);
+        const counter = (++this.requestCounter).toString(36);
+        const random = Math.random().toString(36).substring(2, 6);
+        return `req_${timestamp}_${counter}_${random}`;
+    }
+    /**
+     * Log MCP tool request start
+     */
+    static logToolRequestStart(toolName, args) {
+        const requestId = this.generateRequestId();
+        const startTime = Date.now();
+        logger.info('MCP tool request started', {
+            requestId,
+            toolName,
+            operation: 'tool_request_start',
+            timestamp: new Date().toISOString(),
+            hasArgs: !!args,
+        });
+        return {
+            requestId,
+            operation: 'tool_request',
+            startTime,
+            toolName,
+        };
+    }
+    /**
+     * Log MCP tool request completion
+     */
+    static logToolRequestComplete(context, success, error) {
+        const duration = Date.now() - context.startTime;
+        if (success) {
+            logger.info('MCP tool request completed', {
+                requestId: context.requestId,
+                toolName: context.toolName,
+                operation: 'tool_request_complete',
+                duration,
+                timestamp: new Date().toISOString(),
+            });
+        }
+        else {
+            logger.error('MCP tool request failed', error, {
+                requestId: context.requestId,
+                toolName: context.toolName,
+                operation: 'tool_request_error',
+                duration,
+                timestamp: new Date().toISOString(),
+            });
+        }
+    }
+    /**
+     * Log API request start
+     */
+    static logApiRequestStart(method, url, operation) {
+        const requestId = this.generateRequestId();
+        const startTime = Date.now();
+        logger.info('API request started', {
+            requestId,
+            method: method.toUpperCase(),
+            url: this.maskSensitiveUrl(url),
+            operation: operation || 'api_request_start',
+            timestamp: new Date().toISOString(),
+        });
+        return {
+            requestId,
+            operation: operation || 'api_request',
+            startTime,
+        };
+    }
+    /**
+     * Log API request completion
+     */
+    static logApiRequestComplete(context, statusCode, responseSize, error) {
+        const duration = Date.now() - context.startTime;
+        const success = statusCode >= 200 && statusCode < 300;
+        if (success) {
+            logger.info('API request completed', {
+                requestId: context.requestId,
+                statusCode,
+                duration,
+                responseSize,
+                operation: 'api_request_complete',
+                timestamp: new Date().toISOString(),
+            });
+        }
+        else {
+            logger.warn('API request completed with error', {
+                requestId: context.requestId,
+                statusCode,
+                duration,
+                operation: 'api_request_error',
+                error: error ? String(error) : undefined,
+                timestamp: new Date().toISOString(),
+            });
+        }
+    }
+    /**
+     * Mask sensitive information in URLs
+     */
+    static maskSensitiveUrl(url) {
+        try {
+            const urlObj = new URL(url);
+            // Mask query parameters that might contain sensitive data
+            const sensitiveParams = ['key', 'token', 'secret', 'password', 'auth'];
+            sensitiveParams.forEach(param => {
+                if (urlObj.searchParams.has(param)) {
+                    urlObj.searchParams.set(param, '***');
+                }
+            });
+            return urlObj.toString();
+        }
+        catch {
+            return url; // Return original if URL parsing fails
+        }
+    }
+}
+exports.RequestLogger = RequestLogger;
+exports.default = RequestLogger;
+//# sourceMappingURL=request-logger.js.map

package/build/vendors/payments/utils/request-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-logger.js","sourceRoot":"","sources":["../../../../src/vendors/payments/utils/request-logger.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;AACH,yDAAyD;;;AAEzD,2CAAwC;AAExC,MAAM,MAAM,GAAG,IAAA,qBAAS,GAAE,CAAC;AAU3B,MAAa,aAAa;IAChB,MAAM,CAAC,cAAc,GAAG,CAAC,CAAC;IAElC;;OAEG;IACH,MAAM,CAAC,iBAAiB;QACtB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC1C,MAAM,OAAO,GAAG,CAAC,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QACrD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC1D,OAAO,OAAO,SAAS,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;IACjD,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,mBAAmB,CACxB,QAAgB,EAChB,IAAc;QAEd,MAAM,SAAS,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,MAAM,CAAC,IAAI,CAAC,0BAA0B,EAAE;YACtC,SAAS;YACT,QAAQ;YACR,SAAS,EAAE,oBAAoB;YAC/B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,OAAO,EAAE,CAAC,CAAC,IAAI;SAChB,CAAC,CAAC;QAEH,OAAO;YACL,SAAS;YACT,SAAS,EAAE,cAAc;YACzB,SAAS;YACT,QAAQ;SACT,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,sBAAsB,CAC3B,OAA0B,EAC1B,OAAgB,EAChB,KAAe;QAEf,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC;QAEhD,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,CAAC,IAAI,CAAC,4BAA4B,EAAE;gBACxC,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,SAAS,EAAE,uBAAuB;gBAClC,QAAQ;gBACR,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAc,EAAE;gBACtD,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,SAAS,EAAE,oBAAoB;gBAC/B,QAAQ;gBACR,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,kBAAkB,CACvB,MAAc,EACd,GAAW,EACX,SAAkB;QAElB,MAAM,SAAS,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,MAAM,CAAC,IAAI,CAAC,qBAAqB,EAAE;YACjC,SAAS;YACT,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE;YAC5B,GAAG,EAAE,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC;YAC/B,SAAS,EAAE,SAAS,IAAI,mBAAmB;YAC3C,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC,CAAC;QAEH,OAAO;YACL,SAAS;YACT,SAAS,EAAE,SAAS,IAAI,aAAa;YACrC,SAAS;SACV,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAC1B,OAA0B,EAC1B,UAAkB,EAClB,YAAqB,EACrB,KAAe;QAEf,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC;QAChD,MAAM,OAAO,GAAG,UAAU,IAAI,GAAG,IAAI,UAAU,GAAG,GAAG,CAAC;QAEtD,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,CAAC,IAAI,CAAC,uBAAuB,EAAE;gBACnC,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,UAAU;gBACV,QAAQ;gBACR,YAAY;gBACZ,SAAS,EAAE,sBAAsB;gBACjC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,kCAAkC,EAAE;gBAC9C,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,UAAU;gBACV,QAAQ;gBACR,SAAS,EAAE,mBAAmB;gBAC9B,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;gBACxC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,gBAAgB,CAAC,GAAW;QACzC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;YAE5B,0DAA0D;YAC1D,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;YAEvE,eAAe,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;gBAC9B,IAAI,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;oBACnC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;gBACxC,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,GAAG,CAAC,CAAC,uCAAuC;QACrD,CAAC;IACH,CAAC;;AAnJH,sCAoJC;AAED,kBAAe,aAAa,CAAC"}

package/build/vendors/payments/utils/response-formatter.d.ts

@@ -0,0 +1,54 @@
+/**
+ * @author Nich
+ * @website x.com/nichxbt
+ * @github github.com/nirholas
+ * @license MIT
+ */
+import type { QrCodeData } from '../types/index.js';
+/**
+ * MCP Content Block types
+ */
+interface TextContentBlock {
+    type: 'text';
+    text: string;
+}
+interface ImageContentBlock {
+    type: 'image';
+    data: string;
+    mimeType: string;
+}
+export type ContentBlock = TextContentBlock | ImageContentBlock;
+interface PaymentResponse {
+    identifier: string;
+    address?: string;
+    payment_uri?: string;
+    web_url?: string;
+    qr_address?: QrCodeData;
+    qr_payment_uri?: QrCodeData;
+    qr_web_url?: QrCodeData;
+    qr_gateway_url?: QrCodeData;
+    [key: string]: any;
+}
+/**
+ * Format payment response for Claude Desktop
+ * Makes responses more readable by summarizing large data
+ */
+export declare function formatPaymentResponse(response: PaymentResponse): any;
+/**
+ * Format any response with potential large data
+ */
+export declare function formatMcpResponse(response: any): any;
+/**
+ * Extract QR codes from response and convert to image content blocks
+ */
+export declare function extractQrImages(response: any): ImageContentBlock[];
+/**
+ * Create content blocks for MCP response with separate image blocks
+ */
+export declare function createMcpContentBlocks(response: any, toolName: string): ContentBlock[];
+/**
+ * Create a user-friendly summary for Claude Desktop
+ */
+export declare function createResponseSummary(response: any, toolName: string): string;
+export {};
+//# sourceMappingURL=response-formatter.d.ts.map

package/build/vendors/payments/utils/response-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-formatter.d.ts","sourceRoot":"","sources":["../../../../src/vendors/payments/utils/response-formatter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;GAEG;AACH,UAAU,gBAAgB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,UAAU,iBAAiB;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,YAAY,GAAG,gBAAgB,GAAG,iBAAiB,CAAC;AAEhE,UAAU,eAAe;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,cAAc,CAAC,EAAE,UAAU,CAAC;IAC5B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,cAAc,CAAC,EAAE,UAAU,CAAC;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAgCD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,eAAe,GAAG,GAAG,CAyCpE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,GAAG,GAAG,GAAG,CAepD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,GAAG,GAAG,iBAAiB,EAAE,CAsClE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,GAAG,EACb,QAAQ,EAAE,MAAM,GACf,YAAY,EAAE,CA4BhB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAqD7E"}

package/build/vendors/payments/utils/response-formatter.js

@@ -0,0 +1,212 @@
+"use strict";
+/**
+ * @author Nich
+ * @website x.com/nichxbt
+ * @github github.com/nirholas
+ * @license MIT
+ */
+// Utility to format MCP responses for better display in Claude Desktop
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatPaymentResponse = formatPaymentResponse;
+exports.formatMcpResponse = formatMcpResponse;
+exports.extractQrImages = extractQrImages;
+exports.createMcpContentBlocks = createMcpContentBlocks;
+exports.createResponseSummary = createResponseSummary;
+/**
+ * Format QR code data for Claude Desktop display
+ * Truncates base64 data to prevent overwhelming the UI
+ */
+function formatQrCodeData(qrData) {
+    if (!qrData || !qrData.data) {
+        return qrData;
+    }
+    const base64Data = qrData.data;
+    const isBase64DataUrl = base64Data.startsWith('data:image/');
+    if (isBase64DataUrl && base64Data.length > 100) {
+        // Extract just the prefix and show truncated version
+        const [prefix, base64Part] = base64Data.split(',');
+        const truncatedBase64 = base64Part
+            ? base64Part.substring(0, 32) + '...'
+            : '';
+        return {
+            ...qrData,
+            data: `${prefix},${truncatedBase64}`,
+            data_size: `${Math.round(base64Data.length / 1024)}KB`,
+            note: '✅ QR code generated successfully (data truncated for display)',
+        };
+    }
+    return qrData;
+}
+/**
+ * Format payment response for Claude Desktop
+ * Makes responses more readable by summarizing large data
+ */
+function formatPaymentResponse(response) {
+    const formatted = { ...response };
+    // Format QR codes if present
+    if (formatted.qr_address) {
+        formatted.qr_address = formatQrCodeData(formatted.qr_address);
+    }
+    if (formatted.qr_payment_uri) {
+        formatted.qr_payment_uri = formatQrCodeData(formatted.qr_payment_uri);
+    }
+    if (formatted.qr_web_url) {
+        formatted.qr_web_url = formatQrCodeData(formatted.qr_web_url);
+    }
+    if (formatted.qr_gateway_url) {
+        formatted.qr_gateway_url = formatQrCodeData(formatted.qr_gateway_url);
+    }
+    // Add helpful summary for Claude Desktop
+    const qrCount = [
+        formatted.qr_address,
+        formatted.qr_payment_uri,
+        formatted.qr_web_url,
+        formatted.qr_gateway_url,
+    ].filter(Boolean).length;
+    if (qrCount > 0) {
+        formatted._summary = {
+            payment_id: formatted.identifier,
+            qr_codes_generated: qrCount,
+            has_address: !!formatted.address,
+            has_payment_uri: !!formatted.payment_uri,
+            has_web_url: !!formatted.web_url,
+            status: '✅ Payment created successfully with QR codes',
+            note: 'QR codes are ready to display to customer. Base64 data truncated for readability.',
+        };
+    }
+    return formatted;
+}
+/**
+ * Format any response with potential large data
+ */
+function formatMcpResponse(response) {
+    if (!response || typeof response !== 'object') {
+        return response;
+    }
+    // Check if this looks like a payment response
+    if (response.identifier &&
+        (response.qr_address || response.qr_payment_uri || response.qr_web_url)) {
+        return formatPaymentResponse(response);
+    }
+    // Handle other response types
+    return response;
+}
+/**
+ * Extract QR codes from response and convert to image content blocks
+ */
+function extractQrImages(response) {
+    const images = [];
+    // Helper function to process QR code data
+    const processQrCode = (qrData, name) => {
+        if (!qrData || !qrData.data)
+            return;
+        // Extract base64 data from data URL
+        const dataUrl = qrData.data;
+        if (dataUrl.startsWith('data:image/')) {
+            const [header, base64Data] = dataUrl.split(',');
+            if (header && base64Data) {
+                const mimeType = header.match(/data:([^;]+)/)?.[1] || 'image/png';
+                images.push({
+                    type: 'image',
+                    data: base64Data,
+                    mimeType: mimeType,
+                });
+            }
+        }
+    };
+    // Check all possible QR code fields
+    if (response.qr_address) {
+        processQrCode(response.qr_address, 'Address QR');
+    }
+    if (response.qr_payment_uri) {
+        processQrCode(response.qr_payment_uri, 'Payment URI QR');
+    }
+    if (response.qr_web_url) {
+        processQrCode(response.qr_web_url, 'Web URL QR');
+    }
+    if (response.qr_gateway_url) {
+        processQrCode(response.qr_gateway_url, 'Gateway URL QR');
+    }
+    return images;
+}
+/**
+ * Create content blocks for MCP response with separate image blocks
+ */
+function createMcpContentBlocks(response, toolName) {
+    const contentBlocks = [];
+    // Add summary text (without trying to embed images in markdown)
+    const summary = createResponseSummary(response, toolName);
+    contentBlocks.push({
+        type: 'text',
+        text: summary,
+    });
+    // Extract QR images and add them as separate image content blocks
+    const qrImages = extractQrImages(response);
+    if (qrImages.length > 0) {
+        // Add each QR code as its own image block for proper rendering
+        qrImages.forEach((image) => {
+            contentBlocks.push(image);
+        });
+    }
+    // Add formatted JSON response (without the base64 QR data to avoid duplication)
+    const formattedResponse = formatMcpResponse(response);
+    contentBlocks.push({
+        type: 'text',
+        text: `\`\`\`json\n${JSON.stringify(formattedResponse, null, 2)}\n\`\`\``,
+    });
+    return contentBlocks;
+}
+/**
+ * Create a user-friendly summary for Claude Desktop
+ */
+function createResponseSummary(response, toolName) {
+    const formatted = formatMcpResponse(response);
+    switch (toolName) {
+        case 'create_payment_onchain':
+            return `✅ **Crypto Payment Created Successfully**
+
+💰 **Payment ID**: ${formatted.identifier}
+🏦 **Address**: ${formatted.address || 'Generated'}
+💳 **Payment URI**: ${formatted.payment_uri ? '✅ Available' : '❌ Not available'}
+📱 **QR Codes**: ${formatted._summary?.qr_codes_generated || 0} generated
+
+${formatted.qr_address ? '📸 **QR with Address**: Ready for customer scan' : ''}
+${formatted.qr_payment_uri ? '📸 **QR with Amount**: Ready for customer scan (includes amount)' : ''}
+
+🎯 **Next Steps**: Show the QR code(s) to your customer for payment.
+
+---
+*Full payment data available in JSON below (QR base64 truncated for display)*`;
+        case 'create_payment_link':
+            return `✅ **Payment Link Created Successfully**
+
+💰 **Payment ID**: ${formatted.identifier}
+🔗 **Payment Link**: ${formatted.web_url}
+📱 **QR Code**: ${formatted.qr_web_url ? '✅ Generated' : '❌ Not requested'}
+
+🎯 **Next Steps**: Share the payment link with your customer via WhatsApp, email, or social media.
+
+---
+*Full payment data available in JSON below*`;
+        case 'generate_payment_qr':
+            return `✅ **QR Codes Generated Successfully**
+
+💰 **Payment ID**: ${formatted.identifier}
+📱 **QR Codes Generated**: ${formatted._summary?.qr_codes_generated || 0}
+
+${formatted.qr_address ? '📸 **Address QR**: Ready for scan' : ''}
+${formatted.qr_payment_uri ? '📸 **Payment URI QR**: Ready for scan (with amount)' : ''}
+${formatted.qr_gateway_url ? '📸 **Gateway URL QR**: Ready for scan' : ''}
+
+🎯 **Next Steps**: Display the QR code(s) to your customer.
+
+---
+*Full QR data available in JSON below (base64 truncated for display)*`;
+        default:
+            return `✅ **${toolName} completed successfully**
+
+---
+*Response data available in JSON below*`;
+    }
+}
+//# sourceMappingURL=response-formatter.js.map

package/build/vendors/payments/utils/response-formatter.js.map

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

package/build/vendors/payments/utils/retry.d.ts

@@ -0,0 +1,88 @@
+/**
+ * @author Nich
+ * @website x.com/nichxbt
+ * @github github.com/nirholas
+ * @license MIT
+ */
+export interface RetryOptions {
+    maxRetries: number;
+    baseDelay: number;
+    maxDelay: number;
+    backoffFactor: number;
+    jitter: boolean;
+}
+export interface RetryContext {
+    attempt: number;
+    totalAttempts: number;
+    lastError?: Error;
+    totalDelay: number;
+}
+export declare class RetryableError extends Error {
+    readonly retryAfter?: number | undefined;
+    constructor(message: string, retryAfter?: number | undefined);
+}
+export declare class RetryExhaustedError extends Error {
+    readonly attempts: number;
+    readonly lastError?: Error | undefined;
+    constructor(message: string, attempts: number, lastError?: Error | undefined);
+}
+export declare class RetryManager {
+    private options;
+    private readonly defaultOptions;
+    constructor(options?: Partial<RetryOptions>);
+    /**
+     * Execute function with retry logic
+     */
+    executeWithRetry<T>(operation: (context: RetryContext) => Promise<T>, operationName?: string): Promise<T>;
+    /**
+     * Calculate delay for next retry attempt
+     */
+    private calculateDelay;
+    /**
+     * Check if an error should trigger a retry
+     */
+    private isRetryableError;
+    /**
+     * Sleep for specified milliseconds
+     */
+    private sleep;
+    /**
+     * Create retry-specific error for rate limiting
+     */
+    static createRateLimitError(retryAfterMs?: number): RetryableError;
+    /**
+     * Create retry-specific error for service unavailable
+     */
+    static createServiceUnavailableError(retryAfterMs?: number): RetryableError;
+}
+export declare class RateLimiter {
+    private maxRequests;
+    private timeWindowMs;
+    private requests;
+    constructor(maxRequests: number, timeWindowMs: number);
+    /**
+     * Check if request is allowed under rate limit
+     */
+    isAllowed(): boolean;
+    /**
+     * Get time until next request is allowed
+     */
+    getRetryAfter(): number;
+    /**
+     * Reset rate limiter
+     */
+    reset(): void;
+    /**
+     * Get current usage statistics
+     */
+    getStats(): {
+        currentRequests: number;
+        maxRequests: number;
+        timeWindowMs: number;
+        nextResetMs: number;
+    };
+}
+export declare function createRetryManager(options?: Partial<RetryOptions>): RetryManager;
+export declare function createRateLimiter(maxRequests: number, timeWindowMs: number): RateLimiter;
+export default RetryManager;
+//# sourceMappingURL=retry.d.ts.map

package/build/vendors/payments/utils/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../../../src/vendors/payments/utils/retry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,KAAK,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,cAAe,SAAQ,KAAK;aAGrB,UAAU,CAAC,EAAE,MAAM;gBADnC,OAAO,EAAE,MAAM,EACC,UAAU,CAAC,EAAE,MAAM,YAAA;CAKtC;AAED,qBAAa,mBAAoB,SAAQ,KAAK;aAG1B,QAAQ,EAAE,MAAM;aAChB,SAAS,CAAC,EAAE,KAAK;gBAFjC,OAAO,EAAE,MAAM,EACC,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,KAAK,YAAA;CAKpC;AAED,qBAAa,YAAY;IASX,OAAO,CAAC,OAAO;IAR3B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAM7B;gBAEkB,OAAO,GAAE,OAAO,CAAC,YAAY,CAAM;IAIvD;;OAEG;IACG,gBAAgB,CAAC,CAAC,EACtB,SAAS,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,CAAC,CAAC,EAChD,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,CAAC,CAAC;IA2Eb;;OAEG;IACH,OAAO,CAAC,cAAc;IA6BtB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA4CxB;;OAEG;IACH,OAAO,CAAC,KAAK;IAIb;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,cAAc;IAIlE;;OAEG;IACH,MAAM,CAAC,6BAA6B,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,cAAc;CAG5E;AAGD,qBAAa,WAAW;IAIpB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,YAAY;IAJtB,OAAO,CAAC,QAAQ,CAAgB;gBAGtB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM;IAG9B;;OAEG;IACH,SAAS,IAAI,OAAO;IAgBpB;;OAEG;IACH,aAAa,IAAI,MAAM;IAWvB;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,QAAQ,IAAI;QACV,eAAe,EAAE,MAAM,CAAC;QACxB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;KACrB;CAeF;AAGD,wBAAgB,kBAAkB,CAChC,OAAO,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAC9B,YAAY,CAEd;AAED,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,WAAW,CAEb;AAED,eAAe,YAAY,CAAC"}