@nirholas/bnbchain-mcp 1.0.0

package/build/vendors/payments/tools/get-tunnel-status.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @author Nich
+ * @website x.com/nichxbt
+ * @github github.com/nirholas
+ * @license MIT
+ */
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { GetTunnelStatusOutput } from '../types/index.js';
+import type { WebhookServer } from '../webhook-server.js';
+/**
+ * MCP Tool Definition: get_tunnel_status
+ */
+export declare const getTunnelStatusTool: Tool;
+/**
+ * Handler for get_tunnel_status tool
+ */
+export declare class GetTunnelStatusHandler {
+    private webhookServer;
+    constructor(webhookServer: WebhookServer | null);
+    handle(_args: Record<string, never>): Promise<GetTunnelStatusOutput>;
+}
+/**
+ * Factory function to create handler with webhook server reference
+ */
+export declare function getTunnelStatusHandler(webhookServer: WebhookServer | null): GetTunnelStatusHandler;
+//# sourceMappingURL=get-tunnel-status.d.ts.map

package/build/vendors/payments/tools/get-tunnel-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-tunnel-status.d.ts","sourceRoot":"","sources":["../../../../src/vendors/payments/tools/get-tunnel-status.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAM1D;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,IAyBjC,CAAC;AAEF;;GAEG;AACH,qBAAa,sBAAsB;IACrB,OAAO,CAAC,aAAa;gBAAb,aAAa,EAAE,aAAa,GAAG,IAAI;IAEjD,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAoG3E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,aAAa,EAAE,aAAa,GAAG,IAAI,GAClC,sBAAsB,CAExB"}

package/build/vendors/payments/tools/get-tunnel-status.js

@@ -0,0 +1,146 @@
+"use strict";
+/**
+ * @author Nich
+ * @website x.com/nichxbt
+ * @github github.com/nirholas
+ * @license MIT
+ */
+// MCP Tool: get_tunnel_status
+// Returns detailed status of the tunnel connection
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetTunnelStatusHandler = exports.getTunnelStatusTool = void 0;
+exports.getTunnelStatusHandler = getTunnelStatusHandler;
+const logger_js_1 = require("../utils/logger.js");
+const context_detector_js_1 = require("../tunnel/context-detector.js");
+const logger = (0, logger_js_1.getLogger)();
+/**
+ * MCP Tool Definition: get_tunnel_status
+ */
+exports.getTunnelStatusTool = {
+    name: 'get_tunnel_status',
+    description: `Get detailed status and diagnostics of the webhook tunnel connection.
+
+Returns comprehensive information about the tunnel provider, connection status, public URL, health monitoring, and execution context detection.
+
+Useful for:
+- Troubleshooting connectivity issues
+- Verifying tunnel is active before creating payments
+- Understanding which provider is being used (ngrok, zrok, or manual)
+- Checking if auto-reconnect is working
+- Seeing detected execution context (N8N, Opal, VPS, Docker, local)
+
+Connection statuses:
+- disconnected: Tunnel not started
+- connecting: Tunnel is initializing
+- connected: Tunnel is active and healthy
+- reconnecting: Tunnel lost connection and is attempting to reconnect
+- error: Tunnel failed after max reconnection attempts
+
+No input parameters required - returns current status immediately.`,
+    inputSchema: {
+        type: 'object',
+        properties: {},
+    },
+};
+/**
+ * Handler for get_tunnel_status tool
+ */
+class GetTunnelStatusHandler {
+    webhookServer;
+    constructor(webhookServer) {
+        this.webhookServer = webhookServer;
+    }
+    async handle(_args) {
+        const startTime = Date.now();
+        logger.info('get_tunnel_status called', {
+            operation: 'get_tunnel_status',
+        });
+        try {
+            // Check if webhook server exists
+            if (!this.webhookServer) {
+                return {
+                    enabled: false,
+                    provider: 'manual',
+                    status: 'disconnected',
+                    public_url: null,
+                    connected_at: null,
+                    last_error: 'Webhooks are not enabled',
+                    reconnect_attempts: 0,
+                    health_check_enabled: false,
+                };
+            }
+            // Get tunnel manager
+            const tunnelManager = this.webhookServer.getTunnelManager();
+            if (!tunnelManager) {
+                return {
+                    enabled: false,
+                    provider: 'manual',
+                    status: 'disconnected',
+                    public_url: null,
+                    connected_at: null,
+                    last_error: 'Tunnel is not enabled',
+                    reconnect_attempts: 0,
+                    health_check_enabled: false,
+                };
+            }
+            // Get tunnel info
+            const tunnelInfo = tunnelManager.getInfo();
+            if (!tunnelInfo) {
+                return {
+                    enabled: false,
+                    provider: 'manual',
+                    status: 'disconnected',
+                    public_url: null,
+                    connected_at: null,
+                    last_error: 'Tunnel info not available',
+                    reconnect_attempts: 0,
+                    health_check_enabled: false,
+                };
+            }
+            // Detect execution context
+            const contextDetection = (0, context_detector_js_1.detectContext)();
+            const duration = Date.now() - startTime;
+            logger.info('get_tunnel_status completed', {
+                provider: tunnelInfo.provider,
+                status: tunnelInfo.status,
+                hasPublicUrl: !!tunnelInfo.publicUrl,
+                duration,
+                operation: 'get_tunnel_status_complete',
+            });
+            return {
+                enabled: true,
+                provider: tunnelInfo.provider,
+                status: tunnelInfo.status,
+                public_url: tunnelInfo.publicUrl,
+                connected_at: tunnelInfo.connectedAt
+                    ? tunnelInfo.connectedAt.toISOString()
+                    : null,
+                last_error: tunnelInfo.lastError,
+                reconnect_attempts: tunnelInfo.reconnectAttempts,
+                health_check_enabled: tunnelInfo.healthCheckEnabled,
+                context_detected: {
+                    execution_context: contextDetection.context,
+                    confidence: contextDetection.confidence,
+                    suggested_provider: contextDetection.suggestedProvider,
+                    indicators: contextDetection.indicators,
+                },
+            };
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            logger.error('get_tunnel_status failed', error instanceof Error ? error : new Error(String(error)), {
+                duration,
+                operation: 'get_tunnel_status_error',
+            });
+            throw error;
+        }
+    }
+}
+exports.GetTunnelStatusHandler = GetTunnelStatusHandler;
+/**
+ * Factory function to create handler with webhook server reference
+ */
+function getTunnelStatusHandler(webhookServer) {
+    return new GetTunnelStatusHandler(webhookServer);
+}
+//# sourceMappingURL=get-tunnel-status.js.map

package/build/vendors/payments/tools/get-tunnel-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-tunnel-status.js","sourceRoot":"","sources":["../../../../src/vendors/payments/tools/get-tunnel-status.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;AACH,8BAA8B;AAC9B,mDAAmD;;;AAuJnD,wDAIC;AAtJD,kDAA+C;AAC/C,uEAA8D;AAE9D,MAAM,MAAM,GAAG,IAAA,qBAAS,GAAE,CAAC;AAE3B;;GAEG;AACU,QAAA,mBAAmB,GAAS;IACvC,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE;;;;;;;;;;;;;;;;;;mEAkBoD;IACjE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;KACf;CACF,CAAC;AAEF;;GAEG;AACH,MAAa,sBAAsB;IACb;IAApB,YAAoB,aAAmC;QAAnC,kBAAa,GAAb,aAAa,CAAsB;IAAG,CAAC;IAE3D,KAAK,CAAC,MAAM,CAAC,KAA4B;QACvC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,MAAM,CAAC,IAAI,CAAC,0BAA0B,EAAE;YACtC,SAAS,EAAE,mBAAmB;SAC/B,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,iCAAiC;YACjC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;gBACxB,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,QAAQ,EAAE,QAAQ;oBAClB,MAAM,EAAE,cAAc;oBACtB,UAAU,EAAE,IAAI;oBAChB,YAAY,EAAE,IAAI;oBAClB,UAAU,EAAE,0BAA0B;oBACtC,kBAAkB,EAAE,CAAC;oBACrB,oBAAoB,EAAE,KAAK;iBAC5B,CAAC;YACJ,CAAC;YAED,qBAAqB;YACrB,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC,gBAAgB,EAAE,CAAC;YAE5D,IAAI,CAAC,aAAa,EAAE,CAAC;gBACnB,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,QAAQ,EAAE,QAAQ;oBAClB,MAAM,EAAE,cAAc;oBACtB,UAAU,EAAE,IAAI;oBAChB,YAAY,EAAE,IAAI;oBAClB,UAAU,EAAE,uBAAuB;oBACnC,kBAAkB,EAAE,CAAC;oBACrB,oBAAoB,EAAE,KAAK;iBAC5B,CAAC;YACJ,CAAC;YAED,kBAAkB;YAClB,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,EAAE,CAAC;YAE3C,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,QAAQ,EAAE,QAAQ;oBAClB,MAAM,EAAE,cAAc;oBACtB,UAAU,EAAE,IAAI;oBAChB,YAAY,EAAE,IAAI;oBAClB,UAAU,EAAE,2BAA2B;oBACvC,kBAAkB,EAAE,CAAC;oBACrB,oBAAoB,EAAE,KAAK;iBAC5B,CAAC;YACJ,CAAC;YAED,2BAA2B;YAC3B,MAAM,gBAAgB,GAAG,IAAA,mCAAa,GAAE,CAAC;YAEzC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YAExC,MAAM,CAAC,IAAI,CAAC,6BAA6B,EAAE;gBACzC,QAAQ,EAAE,UAAU,CAAC,QAAQ;gBAC7B,MAAM,EAAE,UAAU,CAAC,MAAM;gBACzB,YAAY,EAAE,CAAC,CAAC,UAAU,CAAC,SAAS;gBACpC,QAAQ;gBACR,SAAS,EAAE,4BAA4B;aACxC,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE,UAAU,CAAC,QAAQ;gBAC7B,MAAM,EAAE,UAAU,CAAC,MAAM;gBACzB,UAAU,EAAE,UAAU,CAAC,SAAS;gBAChC,YAAY,EAAE,UAAU,CAAC,WAAW;oBAClC,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,WAAW,EAAE;oBACtC,CAAC,CAAC,IAAI;gBACR,UAAU,EAAE,UAAU,CAAC,SAAS;gBAChC,kBAAkB,EAAE,UAAU,CAAC,iBAAiB;gBAChD,oBAAoB,EAAE,UAAU,CAAC,kBAAkB;gBACnD,gBAAgB,EAAE;oBAChB,iBAAiB,EAAE,gBAAgB,CAAC,OAAO;oBAC3C,UAAU,EAAE,gBAAgB,CAAC,UAAU;oBACvC,kBAAkB,EAAE,gBAAgB,CAAC,iBAAiB;oBACtD,UAAU,EAAE,gBAAgB,CAAC,UAAU;iBACxC;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YAExC,MAAM,CAAC,KAAK,CACV,0BAA0B,EAC1B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EACzD;gBACE,QAAQ;gBACR,SAAS,EAAE,yBAAyB;aACrC,CACF,CAAC;YAEF,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF;AAvGD,wDAuGC;AAED;;GAEG;AACH,SAAgB,sBAAsB,CACpC,aAAmC;IAEnC,OAAO,IAAI,sBAAsB,CAAC,aAAa,CAAC,CAAC;AACnD,CAAC"}

package/build/vendors/payments/tools/get-webhook-events.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @author Nich
+ * @website x.com/nichxbt
+ * @github github.com/nirholas
+ * @license MIT
+ */
+import type { GetWebhookEventsOutput } from '../types/index.js';
+/**
+ * Tool definition for MCP
+ */
+export declare const getWebhookEventsTool: {
+    readonly name: "get_webhook_events";
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly identifier: {
+                readonly type: "string";
+                readonly description: string;
+            };
+            readonly limit: {
+                readonly type: "number";
+                readonly description: "Maximum number of events to return (default: 50, max: 500)";
+                readonly minimum: 1;
+                readonly maximum: 500;
+            };
+            readonly validated_only: {
+                readonly type: "boolean";
+                readonly description: "Optional: If true, returns only events with valid HMAC signatures (default: false)";
+            };
+        };
+    };
+};
+/**
+ * Tool handler implementation
+ */
+export declare class GetWebhookEventsHandler {
+    constructor();
+    /**
+     * Handle get_webhook_events tool call
+     */
+    handle(args: unknown): Promise<GetWebhookEventsOutput>;
+}
+/**
+ * Create handler instance
+ */
+export declare function getWebhookEventsHandler(): GetWebhookEventsHandler;
+//# sourceMappingURL=get-webhook-events.d.ts.map

package/build/vendors/payments/tools/get-webhook-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-webhook-events.d.ts","sourceRoot":"","sources":["../../../../src/vendors/payments/tools/get-webhook-events.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EAEV,sBAAsB,EACvB,MAAM,mBAAmB,CAAC;AAI3B;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;CA8BvB,CAAC;AAWX;;GAEG;AACH,qBAAa,uBAAuB;;IAOlC;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,sBAAsB,CAAC;CAiG7D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,uBAAuB,CAEjE"}

package/build/vendors/payments/tools/get-webhook-events.js

@@ -0,0 +1,151 @@
+"use strict";
+/**
+ * @author Nich
+ * @website x.com/nichxbt
+ * @github github.com/nirholas
+ * @license MIT
+ */
+// MCP Tool: get_webhook_events
+// Retrieves webhook events stored in the event store
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetWebhookEventsHandler = exports.getWebhookEventsTool = void 0;
+exports.getWebhookEventsHandler = getWebhookEventsHandler;
+const zod_1 = require("zod");
+const webhook_events_js_1 = require("../storage/webhook-events.js");
+const logger_js_1 = require("../utils/logger.js");
+const logger = (0, logger_js_1.getLogger)();
+/**
+ * Tool definition for MCP
+ */
+exports.getWebhookEventsTool = {
+    name: 'get_webhook_events',
+    description: 'Retrieve webhook events received from Bitnovo Pay. ' +
+        'Useful for checking payment status updates in real-time. ' +
+        'Can filter by payment identifier or retrieve recent events. ' +
+        'Only available when webhook server is enabled.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            identifier: {
+                type: 'string',
+                description: 'Optional: Filter events by payment identifier (UUID). ' +
+                    'If provided, returns only events for this specific payment.',
+            },
+            limit: {
+                type: 'number',
+                description: 'Maximum number of events to return (default: 50, max: 500)',
+                minimum: 1,
+                maximum: 500,
+            },
+            validated_only: {
+                type: 'boolean',
+                description: 'Optional: If true, returns only events with valid HMAC signatures (default: false)',
+            },
+        },
+    },
+};
+/**
+ * Input validation schema
+ */
+const GetWebhookEventsInputSchema = zod_1.z.object({
+    identifier: zod_1.z.string().uuid().optional(),
+    limit: zod_1.z.number().int().min(1).max(500).default(50).optional(),
+    validated_only: zod_1.z.boolean().default(false).optional(),
+});
+/**
+ * Tool handler implementation
+ */
+class GetWebhookEventsHandler {
+    constructor() {
+        logger.debug('GetWebhookEventsHandler initialized', {
+            operation: 'get_webhook_events_handler_init',
+        });
+    }
+    /**
+     * Handle get_webhook_events tool call
+     */
+    async handle(args) {
+        const startTime = Date.now();
+        logger.info('Processing get_webhook_events request', {
+            operation: 'get_webhook_events_start',
+        });
+        try {
+            // Validate input
+            const input = GetWebhookEventsInputSchema.parse(args);
+            logger.debug('Input validated', {
+                hasIdentifier: !!input.identifier,
+                limit: input.limit,
+                validatedOnly: input.validated_only,
+                operation: 'get_webhook_events_validated',
+            });
+            // Get event store
+            const eventStore = (0, webhook_events_js_1.getEventStore)();
+            // Retrieve events based on filters
+            let events;
+            if (input.identifier) {
+                // Get events for specific payment
+                events = eventStore.getByIdentifier(input.identifier);
+            }
+            else if (input.validated_only) {
+                // Get only validated events
+                events = eventStore.getValidated(input.limit || 50);
+            }
+            else {
+                // Get recent events
+                events = eventStore.getRecent(input.limit || 50);
+            }
+            // Format response
+            const output = {
+                events: events.map(event => ({
+                    event_id: event.eventId,
+                    identifier: event.identifier,
+                    status: event.status,
+                    received_at: event.receivedAt.toISOString(),
+                    validated: event.validated,
+                    payload: event.payload,
+                })),
+                total_count: events.length,
+            };
+            const duration = Date.now() - startTime;
+            logger.info('Webhook events retrieved successfully', {
+                eventsCount: output.total_count,
+                hasIdentifier: !!input.identifier,
+                validatedOnly: input.validated_only,
+                duration,
+                operation: 'get_webhook_events_success',
+            });
+            return output;
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            if (error instanceof zod_1.z.ZodError) {
+                logger.warn('Invalid input for get_webhook_events', {
+                    errors: error.errors,
+                    duration,
+                    operation: 'get_webhook_events_invalid_input',
+                });
+                throw new Error(`Invalid input: ${error.errors.map(e => `${e.path.join('.')}: ${e.message}`).join(', ')}`);
+            }
+            if (error instanceof Error && error.message.includes('not initialized')) {
+                logger.error('Event store not initialized', error, {
+                    duration,
+                    operation: 'get_webhook_events_store_not_initialized',
+                });
+                throw new Error('Webhook event store not initialized. Ensure webhooks are enabled (WEBHOOK_ENABLED=true).');
+            }
+            logger.error('Error retrieving webhook events', error, {
+                duration,
+                operation: 'get_webhook_events_error',
+            });
+            throw new Error(`Failed to retrieve webhook events: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+}
+exports.GetWebhookEventsHandler = GetWebhookEventsHandler;
+/**
+ * Create handler instance
+ */
+function getWebhookEventsHandler() {
+    return new GetWebhookEventsHandler();
+}
+//# sourceMappingURL=get-webhook-events.js.map

package/build/vendors/payments/tools/get-webhook-events.js.map

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

package/build/vendors/payments/tools/get-webhook-url.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @author Nich
+ * @website x.com/nichxbt
+ * @github github.com/nirholas
+ * @license MIT
+ */
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { GetWebhookUrlInput, GetWebhookUrlOutput } from '../types/index.js';
+import type { WebhookServer } from '../webhook-server.js';
+/**
+ * MCP Tool Definition: get_webhook_url
+ */
+export declare const getWebhookUrlTool: Tool;
+/**
+ * Handler for get_webhook_url tool
+ */
+export declare class GetWebhookUrlHandler {
+    private webhookServer;
+    constructor(webhookServer: WebhookServer | null);
+    handle(args: GetWebhookUrlInput): Promise<GetWebhookUrlOutput>;
+}
+/**
+ * Factory function to create handler with webhook server reference
+ */
+export declare function getWebhookUrlHandler(webhookServer: WebhookServer | null): GetWebhookUrlHandler;
+//# sourceMappingURL=get-webhook-url.d.ts.map

package/build/vendors/payments/tools/get-webhook-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-webhook-url.d.ts","sourceRoot":"","sources":["../../../../src/vendors/payments/tools/get-webhook-url.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACjF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAK1D;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,IA6B/B,CAAC;AAEF;;GAEG;AACH,qBAAa,oBAAoB;IACnB,OAAO,CAAC,aAAa;gBAAb,aAAa,EAAE,aAAa,GAAG,IAAI;IAEjD,MAAM,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAsIrE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,aAAa,EAAE,aAAa,GAAG,IAAI,GAClC,oBAAoB,CAEtB"}

package/build/vendors/payments/tools/get-webhook-url.js

@@ -0,0 +1,173 @@
+"use strict";
+/**
+ * @author Nich
+ * @website x.com/nichxbt
+ * @github github.com/nirholas
+ * @license MIT
+ */
+// MCP Tool: get_webhook_url
+// Returns the public webhook URL for configuring in Bitnovo Dashboard
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetWebhookUrlHandler = exports.getWebhookUrlTool = void 0;
+exports.getWebhookUrlHandler = getWebhookUrlHandler;
+const logger_js_1 = require("../utils/logger.js");
+const logger = (0, logger_js_1.getLogger)();
+/**
+ * MCP Tool Definition: get_webhook_url
+ */
+exports.getWebhookUrlTool = {
+    name: 'get_webhook_url',
+    description: `Get the public webhook URL for configuring in Bitnovo Pay Dashboard.
+
+Returns the complete webhook URL that should be configured as the notification_url in your Bitnovo device settings. This URL includes the tunnel provider information (ngrok, zrok, or manual).
+
+The webhook URL is automatically generated based on your execution context:
+- Local development: Uses ngrok or zrok tunnel with persistent URL
+- N8N/Opal/VPS: Uses the configured WEBHOOK_PUBLIC_URL
+- Server environments: Auto-detects and provides appropriate URL
+
+**Important**: After receiving this URL, configure it in Bitnovo Dashboard:
+1. Log into https://pay.bitnovo.com
+2. Navigate to: Settings → Merchant → Devices
+3. Select your device
+4. Set "notification_url" to the returned webhook_url
+
+Optional validation check ensures the URL is publicly accessible.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            validate: {
+                type: 'boolean',
+                description: 'If true, performs a health check on the URL to verify it is publicly accessible (default: false)',
+                default: false,
+            },
+        },
+    },
+};
+/**
+ * Handler for get_webhook_url tool
+ */
+class GetWebhookUrlHandler {
+    webhookServer;
+    constructor(webhookServer) {
+        this.webhookServer = webhookServer;
+    }
+    async handle(args) {
+        const startTime = Date.now();
+        logger.info('get_webhook_url called', {
+            validate: args.validate,
+            operation: 'get_webhook_url',
+        });
+        try {
+            // Check if webhook server exists
+            if (!this.webhookServer) {
+                throw new Error('Webhooks are not enabled. Set WEBHOOK_ENABLED=true to use webhooks.');
+            }
+            // Get webhook URL
+            const webhookUrl = this.webhookServer.getWebhookUrl();
+            if (!webhookUrl) {
+                throw new Error('Webhook URL not available. Tunnel may not be started or configured properly.');
+            }
+            // Get tunnel info
+            const tunnelManager = this.webhookServer.getTunnelManager();
+            const tunnelInfo = tunnelManager?.getInfo();
+            const provider = tunnelInfo?.provider || 'manual';
+            let validated = false;
+            let instructions;
+            // Validate URL if requested
+            if (args.validate) {
+                try {
+                    const response = await fetch(webhookUrl.replace(this.webhookServer.getConfig().path, '/health'), {
+                        method: 'GET',
+                        signal: AbortSignal.timeout(5000),
+                    });
+                    validated = response.ok;
+                    if (!validated) {
+                        logger.warn('Webhook URL validation failed', {
+                            status: response.status,
+                            statusText: response.statusText,
+                            operation: 'validate_webhook_url',
+                        });
+                    }
+                }
+                catch (error) {
+                    logger.warn('Webhook URL validation error', {
+                        error: error instanceof Error ? error.message : 'Unknown error',
+                        operation: 'validate_webhook_url',
+                    });
+                    validated = false;
+                }
+            }
+            // Generate provider-specific instructions
+            switch (provider) {
+                case 'ngrok':
+                    instructions = `✅ ngrok tunnel active with persistent URL.
+
+Configuration steps:
+1. Copy this webhook URL: ${webhookUrl}
+2. Log into https://pay.bitnovo.com
+3. Go to: Settings → Merchant → Devices
+4. Select your device
+5. Set "notification_url" to: ${webhookUrl}
+
+Note: This ngrok URL is persistent and will not change between restarts${tunnelInfo?.['ngrokDomain']
+                        ? ' (using custom domain)'
+                        : ' (using free static domain)'}.`;
+                    break;
+                case 'zrok':
+                    instructions = `✅ zrok tunnel active with persistent URL.
+
+Configuration steps:
+1. Copy this webhook URL: ${webhookUrl}
+2. Log into https://pay.bitnovo.com
+3. Go to: Settings → Merchant → Devices
+4. Select your device
+5. Set "notification_url" to: ${webhookUrl}
+
+Note: This zrok URL is persistent (reserved share) and will not change between restarts.`;
+                    break;
+                case 'manual':
+                    instructions = `✅ Manual configuration (server with public IP).
+
+Configuration steps:
+1. Copy this webhook URL: ${webhookUrl}
+2. Log into https://pay.bitnovo.com
+3. Go to: Settings → Merchant → Devices
+4. Select your device
+5. Set "notification_url" to: ${webhookUrl}
+
+Note: This is your server's public URL. Ensure your firewall allows inbound HTTPS traffic.`;
+                    break;
+            }
+            const duration = Date.now() - startTime;
+            logger.info('get_webhook_url completed', {
+                provider,
+                validated: args.validate ? validated : 'not_checked',
+                duration,
+                operation: 'get_webhook_url_complete',
+            });
+            return {
+                webhook_url: webhookUrl,
+                provider,
+                validated,
+                instructions,
+            };
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            logger.error('get_webhook_url failed', error instanceof Error ? error : new Error(String(error)), {
+                duration,
+                operation: 'get_webhook_url_error',
+            });
+            throw error;
+        }
+    }
+}
+exports.GetWebhookUrlHandler = GetWebhookUrlHandler;
+/**
+ * Factory function to create handler with webhook server reference
+ */
+function getWebhookUrlHandler(webhookServer) {
+    return new GetWebhookUrlHandler(webhookServer);
+}
+//# sourceMappingURL=get-webhook-url.js.map

package/build/vendors/payments/tools/get-webhook-url.js.map

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

package/build/vendors/payments/tools/list-currencies-catalog.d.ts

@@ -0,0 +1,58 @@
+/**
+ * @author Nich
+ * @website x.com/nichxbt
+ * @github github.com/nirholas
+ * @license MIT
+ */
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { CurrencyService } from '../services/currency-service.js';
+export declare const listCurrenciesCatalogTool: Tool;
+export interface CurrencyInfo {
+    name: string;
+    min_amount: number;
+    max_amount: number | null;
+    image: string;
+    original_symbol: string;
+    original_blockchain: string;
+    requires_memo: boolean;
+    decimals: number;
+    is_active: boolean;
+    features: string[];
+}
+export declare class ListCurrenciesCatalogHandler {
+    private readonly currencyService;
+    constructor(currencyService: CurrencyService);
+    handle(args: unknown): Promise<{
+        currencies: CurrencyInfo[];
+        total_count: number;
+        filtered_count: number;
+        filter_applied: boolean;
+        filter_amount?: number;
+        network_groups?: Record<string, string[]>;
+        cache_info: {
+            cached: boolean;
+            age: number;
+            valid: boolean;
+        };
+    }>;
+    /**
+     * Get feature list for a currency
+     * Uses original_symbol and original_blockchain for user-friendly features
+     */
+    private getCurrencyFeatures;
+    /**
+     * Group currencies by base symbol to identify multi-network variants
+     * Example: USDC_ETH, USDC_TRON, USDC_POLYGON -> { "USDC": ["USDC_ETH", "USDC_TRON", "USDC_POLYGON"] }
+     */
+    private groupCurrenciesByNetwork;
+    /**
+     * Check if currency is a stablecoin
+     */
+    private isStablecoin;
+    /**
+     * Check if currency is in the popular list
+     */
+    private isPopularCurrency;
+}
+export declare function listCurrenciesCatalogHandler(currencyService: CurrencyService): ListCurrenciesCatalogHandler;
+//# sourceMappingURL=list-currencies-catalog.d.ts.map