@waiaas/daemon 2.4.0-rc.2 → 2.4.0-rc.3

package/dist/services/signing-sdk/approval-channel-router.js

@@ -0,0 +1,147 @@
+/**
+ * ApprovalChannelRouter -- routes PENDING_APPROVAL transactions to the correct
+ * signing channel based on wallet's owner_approval_method.
+ *
+ * Routing logic:
+ *   1. Read wallet's owner_approval_method from DB
+ *   2. If set: route to that specific channel
+ *      - sdk_ntfy  -> NtfySigningChannel.sendRequest()
+ *      - sdk_telegram -> TelegramSigningChannel.sendRequest()
+ *      - walletconnect / telegram_bot / rest -> return method (no channel call)
+ *   3. If SDK method but signing_sdk.enabled=false: fall through to global fallback
+ *   4. Global fallback priority (CHAN-06):
+ *      SDK ntfy > SDK Telegram > WalletConnect > Telegram Bot > REST
+ *
+ * CHAN-07: When signing_sdk.enabled !== 'true', SDK channels are skipped entirely.
+ *
+ * @see internal/design/74-wallet-sdk-daemon-components.md
+ * @see .planning/phases/203-telegram-channel-routing-rest-admin/203-03-PLAN.md
+ */
+// ---------------------------------------------------------------------------
+// ApprovalChannelRouter
+// ---------------------------------------------------------------------------
+export class ApprovalChannelRouter {
+    sqlite;
+    settings;
+    ntfyChannel;
+    telegramChannel;
+    constructor(deps) {
+        this.sqlite = deps.sqlite;
+        this.settings = deps.settingsService;
+        this.ntfyChannel = deps.ntfyChannel;
+        this.telegramChannel = deps.telegramChannel;
+    }
+    // -------------------------------------------------------------------------
+    // route() -- determine and execute the appropriate signing channel
+    // -------------------------------------------------------------------------
+    /**
+     * Route a PENDING_APPROVAL transaction to the correct signing channel.
+     *
+     * @param walletId - The wallet ID to look up approval method for
+     * @param params - Transaction parameters for SDK channel sendRequest()
+     * @returns RouteResult with selected method and optional channel result
+     * @throws Error if wallet not found in DB
+     * @throws Error if SDK channel sendRequest() fails (propagated, no silent fallback)
+     */
+    async route(walletId, params) {
+        // 1. Read wallet's owner_approval_method from DB
+        const row = this.sqlite.prepare('SELECT owner_approval_method FROM wallets WHERE id = ?').get(walletId);
+        if (!row) {
+            throw new Error(`Wallet not found: ${walletId}`);
+        }
+        const explicitMethod = row.owner_approval_method;
+        // 2. If explicit method is set, try to use it
+        if (explicitMethod) {
+            const sdkEnabled = this.isSdkEnabled();
+            // Non-SDK methods: return immediately without channel call
+            if (explicitMethod === 'walletconnect') {
+                return { method: 'walletconnect', channelResult: null };
+            }
+            if (explicitMethod === 'telegram_bot') {
+                return { method: 'telegram_bot', channelResult: null };
+            }
+            if (explicitMethod === 'rest') {
+                return { method: 'rest', channelResult: null };
+            }
+            // SDK methods: only use if SDK is enabled, otherwise fall through to global fallback
+            if (explicitMethod === 'sdk_ntfy' && sdkEnabled && this.ntfyChannel) {
+                const result = await this.ntfyChannel.sendRequest(params);
+                return { method: 'sdk_ntfy', channelResult: { requestId: result.requestId } };
+            }
+            if (explicitMethod === 'sdk_telegram' && sdkEnabled && this.telegramChannel) {
+                const result = await this.telegramChannel.sendRequest(params);
+                return { method: 'sdk_telegram', channelResult: { requestId: result.requestId } };
+            }
+            // SDK method set but SDK disabled or channel not available -> fall through to global fallback
+        }
+        // 3. Global fallback priority (CHAN-06)
+        return this.globalFallback(params);
+    }
+    // -------------------------------------------------------------------------
+    // shutdown() -- clean up channels
+    // -------------------------------------------------------------------------
+    /**
+     * Shutdown all managed signing channels.
+     */
+    shutdown() {
+        this.ntfyChannel?.shutdown();
+        this.telegramChannel?.shutdown();
+    }
+    // -------------------------------------------------------------------------
+    // Private: global fallback logic (CHAN-06, CHAN-07)
+    // -------------------------------------------------------------------------
+    async globalFallback(params) {
+        const sdkEnabled = this.isSdkEnabled();
+        // Priority 1: SDK ntfy (if SDK enabled and channel available)
+        if (sdkEnabled && this.ntfyChannel) {
+            const result = await this.ntfyChannel.sendRequest(params);
+            return { method: 'sdk_ntfy', channelResult: { requestId: result.requestId } };
+        }
+        // Priority 2: SDK Telegram (if SDK enabled and channel available)
+        if (sdkEnabled && this.telegramChannel) {
+            const result = await this.telegramChannel.sendRequest(params);
+            return { method: 'sdk_telegram', channelResult: { requestId: result.requestId } };
+        }
+        // Priority 3: WalletConnect (if project_id configured)
+        if (this.isWalletConnectConfigured()) {
+            return { method: 'walletconnect', channelResult: null };
+        }
+        // Priority 4: Telegram Bot (if enabled and bot_token configured)
+        if (this.isTelegramBotConfigured()) {
+            return { method: 'telegram_bot', channelResult: null };
+        }
+        // Priority 5: REST (always available as final fallback)
+        return { method: 'rest', channelResult: null };
+    }
+    // -------------------------------------------------------------------------
+    // Private: setting checks
+    // -------------------------------------------------------------------------
+    isSdkEnabled() {
+        try {
+            return this.settings.get('signing_sdk.enabled') === 'true';
+        }
+        catch {
+            return false;
+        }
+    }
+    isWalletConnectConfigured() {
+        try {
+            const projectId = this.settings.get('walletconnect.project_id');
+            return !!projectId && projectId.trim().length > 0;
+        }
+        catch {
+            return false;
+        }
+    }
+    isTelegramBotConfigured() {
+        try {
+            const enabled = this.settings.get('telegram.enabled');
+            const botToken = this.settings.get('telegram.bot_token');
+            return enabled === 'true' && !!botToken && botToken.trim().length > 0;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=approval-channel-router.js.map

package/dist/services/signing-sdk/approval-channel-router.js.map

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

package/dist/services/signing-sdk/channels/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Signing SDK channel exports.
+ *
+ * @see internal/design/73-signing-protocol-v1.md
+ */
+export { NtfySigningChannel } from './ntfy-signing-channel.js';
+export type { NtfySigningChannelOpts, SendRequestParams, SendRequestResult, } from './ntfy-signing-channel.js';
+export { TelegramSigningChannel } from './telegram-signing-channel.js';
+export type { TelegramSigningChannelOpts } from './telegram-signing-channel.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/services/signing-sdk/channels/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/services/signing-sdk/channels/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,YAAY,EACV,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,YAAY,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/services/signing-sdk/channels/index.js

@@ -0,0 +1,8 @@
+/**
+ * Signing SDK channel exports.
+ *
+ * @see internal/design/73-signing-protocol-v1.md
+ */
+export { NtfySigningChannel } from './ntfy-signing-channel.js';
+export { TelegramSigningChannel } from './telegram-signing-channel.js';
+//# sourceMappingURL=index.js.map

package/dist/services/signing-sdk/channels/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/services/signing-sdk/channels/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAO/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/services/signing-sdk/channels/ntfy-signing-channel.d.ts

@@ -0,0 +1,66 @@
+/**
+ * NtfySigningChannel -- publishes SignRequests to ntfy and subscribes to responses via SSE.
+ *
+ * When a PENDING_APPROVAL transaction triggers a SignRequest:
+ *   1. Publishes the request to the wallet's ntfy request topic (JSON format per doc 73 Section 7.2)
+ *   2. Subscribes to the response topic via SSE
+ *   3. Parses incoming SignResponse messages (base64url in ntfy message field)
+ *   4. Delegates to SignResponseHandler for approval/rejection processing
+ *
+ * @see internal/design/73-signing-protocol-v1.md (Section 7.2, 7.3)
+ * @see internal/design/74-wallet-sdk-daemon-components.md
+ */
+import type { SignRequestBuilder, BuildRequestParams } from '../sign-request-builder.js';
+import type { SignResponseHandler } from '../sign-response-handler.js';
+import type { SettingsService } from '../../../infrastructure/settings/settings-service.js';
+export interface NtfySigningChannelOpts {
+    signRequestBuilder: SignRequestBuilder;
+    signResponseHandler: SignResponseHandler;
+    settingsService: SettingsService;
+}
+export interface SendRequestParams extends BuildRequestParams {
+    walletId: string;
+}
+export interface SendRequestResult {
+    requestId: string;
+    requestTopic: string;
+    responseTopic: string;
+}
+export declare class NtfySigningChannel {
+    private readonly signRequestBuilder;
+    private readonly signResponseHandler;
+    private readonly settings;
+    /** Active SSE subscriptions: requestId -> AbortController */
+    private readonly activeSubscriptions;
+    constructor(opts: NtfySigningChannelOpts);
+    /**
+     * Publish a SignRequest to ntfy request topic and subscribe to response topic.
+     *
+     * @param params - Transaction metadata + walletId for topic routing
+     * @returns requestId, requestTopic, responseTopic
+     */
+    sendRequest(params: SendRequestParams): Promise<SendRequestResult>;
+    /**
+     * Cancel a specific SSE subscription by requestId.
+     */
+    cancelSubscription(requestId: string): void;
+    /**
+     * Shutdown all active SSE subscriptions (daemon shutdown).
+     */
+    shutdown(): void;
+    private getNtfyServer;
+    private publishToNtfy;
+    private subscribeToResponseTopic;
+    private connectSse;
+    /**
+     * Parse an SSE stream into NtfyMessage objects.
+     *
+     * ntfy SSE format:
+     *   event: message
+     *   data: {"id":"...","time":...,"event":"message","topic":"...","message":"..."}
+     *
+     * We only care about `data:` lines containing JSON with a `message` field.
+     */
+    private parseSseStream;
+}
+//# sourceMappingURL=ntfy-signing-channel.d.ts.map

package/dist/services/signing-sdk/channels/ntfy-signing-channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ntfy-signing-channel.d.ts","sourceRoot":"","sources":["../../../../src/services/signing-sdk/channels/ntfy-signing-channel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACzF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sDAAsD,CAAC;AAc5F,MAAM,WAAW,sBAAsB;IACrC,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,eAAe,EAAE,eAAe,CAAC;CAClC;AAED,MAAM,WAAW,iBAAkB,SAAQ,kBAAkB;IAC3D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AAcD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAqB;IACxD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAsB;IAC1D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAE3C,6DAA6D;IAC7D,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAsC;gBAE9D,IAAI,EAAE,sBAAsB;IAUxC;;;;;OAKG;IACG,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAsCxE;;OAEG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAQ3C;;OAEG;IACH,QAAQ,IAAI,IAAI;IAWhB,OAAO,CAAC,aAAa;YAaP,aAAa;IAsC3B,OAAO,CAAC,wBAAwB;YAyBlB,UAAU;IAgFxB;;;;;;;;OAQG;YACY,cAAc;CAuC9B"}

package/dist/services/signing-sdk/channels/ntfy-signing-channel.js

@@ -0,0 +1,257 @@
+/**
+ * NtfySigningChannel -- publishes SignRequests to ntfy and subscribes to responses via SSE.
+ *
+ * When a PENDING_APPROVAL transaction triggers a SignRequest:
+ *   1. Publishes the request to the wallet's ntfy request topic (JSON format per doc 73 Section 7.2)
+ *   2. Subscribes to the response topic via SSE
+ *   3. Parses incoming SignResponse messages (base64url in ntfy message field)
+ *   4. Delegates to SignResponseHandler for approval/rejection processing
+ *
+ * @see internal/design/73-signing-protocol-v1.md (Section 7.2, 7.3)
+ * @see internal/design/74-wallet-sdk-daemon-components.md
+ */
+import { SignResponseSchema, } from '@waiaas/core';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const MAX_RECONNECT_ATTEMPTS = 3;
+const RECONNECT_DELAY_MS = 5_000;
+const DEFAULT_NTFY_SERVER = 'https://ntfy.sh';
+// ---------------------------------------------------------------------------
+// NtfySigningChannel
+// ---------------------------------------------------------------------------
+export class NtfySigningChannel {
+    signRequestBuilder;
+    signResponseHandler;
+    settings;
+    /** Active SSE subscriptions: requestId -> AbortController */
+    activeSubscriptions = new Map();
+    constructor(opts) {
+        this.signRequestBuilder = opts.signRequestBuilder;
+        this.signResponseHandler = opts.signResponseHandler;
+        this.settings = opts.settingsService;
+    }
+    // -------------------------------------------------------------------------
+    // sendRequest -- publish to ntfy + subscribe for response
+    // -------------------------------------------------------------------------
+    /**
+     * Publish a SignRequest to ntfy request topic and subscribe to response topic.
+     *
+     * @param params - Transaction metadata + walletId for topic routing
+     * @returns requestId, requestTopic, responseTopic
+     */
+    async sendRequest(params) {
+        // 1. Build SignRequest via SignRequestBuilder
+        const { request, universalLinkUrl, requestTopic } = this.signRequestBuilder.buildRequest(params);
+        // 2. Register request with SignResponseHandler for later matching
+        this.signResponseHandler.registerRequest(request);
+        // 3. Resolve ntfy server URL
+        const ntfyServer = this.getNtfyServer();
+        // 4. Publish to ntfy request topic (doc 73 Section 7.2)
+        await this.publishToNtfy(ntfyServer, requestTopic, request.displayMessage, universalLinkUrl);
+        // 5. Determine response topic
+        let responseTopic;
+        if (request.responseChannel.type === 'ntfy') {
+            responseTopic = request.responseChannel.responseTopic;
+        }
+        else {
+            // Fallback: construct response topic from request
+            const prefix = this.settings.get('signing_sdk.ntfy_response_topic_prefix');
+            responseTopic = `${prefix}-${request.requestId}`;
+        }
+        // 6. Subscribe to response topic via SSE (background, non-blocking)
+        this.subscribeToResponseTopic(ntfyServer, responseTopic, request.requestId, request.expiresAt);
+        return {
+            requestId: request.requestId,
+            requestTopic,
+            responseTopic,
+        };
+    }
+    // -------------------------------------------------------------------------
+    // Subscription management
+    // -------------------------------------------------------------------------
+    /**
+     * Cancel a specific SSE subscription by requestId.
+     */
+    cancelSubscription(requestId) {
+        const controller = this.activeSubscriptions.get(requestId);
+        if (controller) {
+            controller.abort();
+            this.activeSubscriptions.delete(requestId);
+        }
+    }
+    /**
+     * Shutdown all active SSE subscriptions (daemon shutdown).
+     */
+    shutdown() {
+        for (const [requestId, controller] of this.activeSubscriptions) {
+            controller.abort();
+            this.activeSubscriptions.delete(requestId);
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Private: ntfy server URL
+    // -------------------------------------------------------------------------
+    getNtfyServer() {
+        try {
+            const server = this.settings.get('notifications.ntfy_server');
+            return server || DEFAULT_NTFY_SERVER;
+        }
+        catch {
+            return DEFAULT_NTFY_SERVER;
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Private: publish to ntfy (doc 73 Section 7.2)
+    // -------------------------------------------------------------------------
+    async publishToNtfy(ntfyServer, requestTopic, displayMessage, universalLinkUrl) {
+        const url = `${ntfyServer}/${requestTopic}`;
+        const body = JSON.stringify({
+            topic: requestTopic,
+            message: displayMessage,
+            title: 'WAIaaS Sign Request',
+            priority: 5,
+            tags: ['waiaas', 'sign'],
+            actions: [
+                {
+                    action: 'view',
+                    label: 'Sign in wallet',
+                    url: universalLinkUrl,
+                },
+            ],
+            click: universalLinkUrl,
+        });
+        const res = await fetch(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body,
+        });
+        if (!res.ok) {
+            throw new Error(`Failed to publish sign request to ntfy: HTTP ${res.status}`);
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Private: subscribe to response topic via SSE
+    // -------------------------------------------------------------------------
+    subscribeToResponseTopic(ntfyServer, responseTopic, requestId, expiresAt) {
+        const abortController = new AbortController();
+        this.activeSubscriptions.set(requestId, abortController);
+        // Set timeout for request expiration
+        const expiresAtMs = new Date(expiresAt).getTime();
+        const timeoutMs = Math.max(0, expiresAtMs - Date.now());
+        const timer = setTimeout(() => {
+            this.cancelSubscription(requestId);
+        }, timeoutMs);
+        // Unref timer so it doesn't prevent process exit
+        if (typeof timer === 'object' && 'unref' in timer) {
+            timer.unref();
+        }
+        // Start SSE connection (non-blocking)
+        void this.connectSse(ntfyServer, responseTopic, requestId, abortController, timer);
+    }
+    async connectSse(ntfyServer, responseTopic, requestId, abortController, expirationTimer, reconnectAttempt = 0) {
+        if (abortController.signal.aborted) {
+            clearTimeout(expirationTimer);
+            return;
+        }
+        try {
+            const url = `${ntfyServer}/${responseTopic}/sse`;
+            const res = await fetch(url, {
+                signal: abortController.signal,
+            });
+            if (!res.ok || !res.body) {
+                throw new Error(`SSE connection failed: HTTP ${res.status}`);
+            }
+            const reader = res.body.getReader();
+            for await (const ntfyMsg of this.parseSseStream(reader, abortController.signal)) {
+                if (abortController.signal.aborted)
+                    break;
+                if (!ntfyMsg.message)
+                    continue;
+                // ntfy message field contains base64url-encoded SignResponse
+                try {
+                    const json = Buffer.from(ntfyMsg.message, 'base64url').toString('utf-8');
+                    const parsed = JSON.parse(json);
+                    const signResponse = SignResponseSchema.parse(parsed);
+                    // Only process responses for this requestId
+                    if (signResponse.requestId !== requestId)
+                        continue;
+                    // Delegate to SignResponseHandler
+                    await this.signResponseHandler.handle(signResponse);
+                    // Response processed -- close subscription
+                    this.cancelSubscription(requestId);
+                    clearTimeout(expirationTimer);
+                    return;
+                }
+                catch {
+                    // Ignore malformed messages or handler errors
+                }
+            }
+        }
+        catch (_err) {
+            // Don't reconnect if explicitly aborted
+            if (abortController.signal.aborted) {
+                clearTimeout(expirationTimer);
+                return;
+            }
+            // Reconnect logic: max 3 attempts, 5s delay
+            if (reconnectAttempt < MAX_RECONNECT_ATTEMPTS) {
+                await new Promise((resolve) => setTimeout(resolve, RECONNECT_DELAY_MS));
+                return this.connectSse(ntfyServer, responseTopic, requestId, abortController, expirationTimer, reconnectAttempt + 1);
+            }
+            // Max reconnects exceeded -- clean up
+            this.activeSubscriptions.delete(requestId);
+            clearTimeout(expirationTimer);
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Private: SSE stream parser
+    // -------------------------------------------------------------------------
+    /**
+     * Parse an SSE stream into NtfyMessage objects.
+     *
+     * ntfy SSE format:
+     *   event: message
+     *   data: {"id":"...","time":...,"event":"message","topic":"...","message":"..."}
+     *
+     * We only care about `data:` lines containing JSON with a `message` field.
+     */
+    async *parseSseStream(reader, signal) {
+        const decoder = new TextDecoder();
+        let buffer = '';
+        try {
+            while (!signal.aborted) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                buffer += decoder.decode(value, { stream: true });
+                const lines = buffer.split('\n');
+                // Keep the last incomplete line in buffer
+                buffer = lines.pop() ?? '';
+                for (const line of lines) {
+                    if (!line.startsWith('data: '))
+                        continue;
+                    const dataStr = line.slice(6).trim();
+                    if (!dataStr)
+                        continue;
+                    try {
+                        const msg = JSON.parse(dataStr);
+                        yield msg;
+                    }
+                    catch {
+                        // Ignore malformed JSON
+                    }
+                }
+            }
+        }
+        finally {
+            try {
+                reader.releaseLock();
+            }
+            catch {
+                // Reader may already be released
+            }
+        }
+    }
+}
+//# sourceMappingURL=ntfy-signing-channel.js.map

package/dist/services/signing-sdk/channels/ntfy-signing-channel.js.map

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

package/dist/services/signing-sdk/channels/telegram-signing-channel.d.ts

@@ -0,0 +1,56 @@
+/**
+ * TelegramSigningChannel -- sends SignRequests via Telegram inline button message.
+ *
+ * When a PENDING_APPROVAL transaction triggers a SignRequest:
+ *   1. Builds the SignRequest via SignRequestBuilder
+ *   2. Registers the request with SignResponseHandler for later matching
+ *   3. Sends a Telegram message to the admin chat with an inline "Open in Wallet"
+ *      button containing the universal link URL
+ *
+ * Unlike NtfySigningChannel, TelegramSigningChannel does NOT subscribe to a response
+ * topic. The response arrives via the /sign_response Telegram bot command, which
+ * delegates to SignResponseHandler. This is a one-way push channel.
+ *
+ * Implements ISigningChannel interface for consistent channel abstraction.
+ *
+ * @see internal/design/73-signing-protocol-v1.md (Section 7.2, 7.3)
+ * @see internal/design/74-wallet-sdk-daemon-components.md
+ */
+import type { SignRequestBuilder, BuildRequestParams } from '../sign-request-builder.js';
+import type { SignResponseHandler } from '../sign-response-handler.js';
+import type { SettingsService } from '../../../infrastructure/settings/settings-service.js';
+import type { TelegramApi } from '../../../infrastructure/telegram/telegram-api.js';
+export interface TelegramSigningChannelOpts {
+    signRequestBuilder: SignRequestBuilder;
+    signResponseHandler: SignResponseHandler;
+    settingsService: SettingsService;
+    telegramApi: TelegramApi;
+}
+export interface SendRequestParams extends BuildRequestParams {
+    walletId: string;
+}
+export interface SendRequestResult {
+    requestId: string;
+    requestTopic: string;
+    responseTopic: string;
+}
+export declare class TelegramSigningChannel {
+    private readonly signRequestBuilder;
+    private readonly signResponseHandler;
+    private readonly settings;
+    private readonly telegramApi;
+    constructor(opts: TelegramSigningChannelOpts);
+    /**
+     * Send a SignRequest via Telegram message with an inline "Open in Wallet" button.
+     *
+     * @param params - Transaction metadata + walletId
+     * @returns requestId, requestTopic (empty for Telegram), responseTopic (empty)
+     * @throws Error if telegram chat_id is not configured
+     */
+    sendRequest(params: SendRequestParams): Promise<SendRequestResult>;
+    /**
+     * Shutdown the channel. No-op for Telegram (no SSE subscriptions to clean up).
+     */
+    shutdown(): void;
+}
+//# sourceMappingURL=telegram-signing-channel.d.ts.map

package/dist/services/signing-sdk/channels/telegram-signing-channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram-signing-channel.d.ts","sourceRoot":"","sources":["../../../../src/services/signing-sdk/channels/telegram-signing-channel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACzF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sDAAsD,CAAC;AAC5F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kDAAkD,CAAC;AAOpF,MAAM,WAAW,0BAA0B;IACzC,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,eAAe,EAAE,eAAe,CAAC;IACjC,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAkB,SAAQ,kBAAkB;IAC3D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AAMD,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAqB;IACxD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAsB;IAC1D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;gBAE9B,IAAI,EAAE,0BAA0B;IAW5C;;;;;;OAMG;IACG,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA4CxE;;OAEG;IACH,QAAQ,IAAI,IAAI;CAGjB"}