@truecarry/mcp 0.1.3 → 0.1.4

package/dist/tools/wallet.d.ts

@@ -1,138 +0,0 @@
-/**
- * Copyright (c) TonTech.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- *
- */
-/**
- * Wallet management MCP tools
- */
-import { z } from 'zod';
-import type { WalletService } from '../services/WalletService.js';
-export declare const createWalletSchema: z.ZodObject<{
-    name: z.ZodString;
-    version: z.ZodOptional<z.ZodEnum<["v5r1", "v4r2"]>>;
-    network: z.ZodOptional<z.ZodEnum<["mainnet", "testnet"]>>;
-}, "strip", z.ZodTypeAny, {
-    name: string;
-    version?: "v5r1" | "v4r2" | undefined;
-    network?: "mainnet" | "testnet" | undefined;
-}, {
-    name: string;
-    version?: "v5r1" | "v4r2" | undefined;
-    network?: "mainnet" | "testnet" | undefined;
-}>;
-export declare const importWalletSchema: z.ZodObject<{
-    name: z.ZodString;
-    mnemonic: z.ZodString;
-    version: z.ZodOptional<z.ZodEnum<["v5r1", "v4r2"]>>;
-    network: z.ZodOptional<z.ZodEnum<["mainnet", "testnet"]>>;
-}, "strip", z.ZodTypeAny, {
-    name: string;
-    mnemonic: string;
-    version?: "v5r1" | "v4r2" | undefined;
-    network?: "mainnet" | "testnet" | undefined;
-}, {
-    name: string;
-    mnemonic: string;
-    version?: "v5r1" | "v4r2" | undefined;
-    network?: "mainnet" | "testnet" | undefined;
-}>;
-export declare const removeWalletSchema: z.ZodObject<{
-    name: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    name: string;
-}, {
-    name: string;
-}>;
-export declare function createWalletTools(walletService: WalletService): {
-    create_wallet: {
-        description: string;
-        inputSchema: z.ZodObject<{
-            name: z.ZodString;
-            version: z.ZodOptional<z.ZodEnum<["v5r1", "v4r2"]>>;
-            network: z.ZodOptional<z.ZodEnum<["mainnet", "testnet"]>>;
-        }, "strip", z.ZodTypeAny, {
-            name: string;
-            version?: "v5r1" | "v4r2" | undefined;
-            network?: "mainnet" | "testnet" | undefined;
-        }, {
-            name: string;
-            version?: "v5r1" | "v4r2" | undefined;
-            network?: "mainnet" | "testnet" | undefined;
-        }>;
-        handler: (args: z.infer<typeof createWalletSchema>) => Promise<{
-            content: {
-                type: "text";
-                text: string;
-            }[];
-        }>;
-    };
-    import_wallet: {
-        description: string;
-        inputSchema: z.ZodObject<{
-            name: z.ZodString;
-            mnemonic: z.ZodString;
-            version: z.ZodOptional<z.ZodEnum<["v5r1", "v4r2"]>>;
-            network: z.ZodOptional<z.ZodEnum<["mainnet", "testnet"]>>;
-        }, "strip", z.ZodTypeAny, {
-            name: string;
-            mnemonic: string;
-            version?: "v5r1" | "v4r2" | undefined;
-            network?: "mainnet" | "testnet" | undefined;
-        }, {
-            name: string;
-            mnemonic: string;
-            version?: "v5r1" | "v4r2" | undefined;
-            network?: "mainnet" | "testnet" | undefined;
-        }>;
-        handler: (args: z.infer<typeof importWalletSchema>) => Promise<{
-            content: {
-                type: "text";
-                text: string;
-            }[];
-            isError: boolean;
-        } | {
-            content: {
-                type: "text";
-                text: string;
-            }[];
-            isError?: undefined;
-        }>;
-    };
-    list_wallets: {
-        description: string;
-        inputSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
-        handler: () => Promise<{
-            content: {
-                type: "text";
-                text: string;
-            }[];
-        }>;
-    };
-    remove_wallet: {
-        description: string;
-        inputSchema: z.ZodObject<{
-            name: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            name: string;
-        }, {
-            name: string;
-        }>;
-        handler: (args: z.infer<typeof removeWalletSchema>) => Promise<{
-            content: {
-                type: "text";
-                text: string;
-            }[];
-            isError: boolean;
-        } | {
-            content: {
-                type: "text";
-                text: string;
-            }[];
-            isError?: undefined;
-        }>;
-    };
-};
-//# sourceMappingURL=wallet.d.ts.map

package/dist/tools/wallet.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"wallet.d.ts","sourceRoot":"","sources":["../../src/tools/wallet.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAElE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;EAU7B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;EAW7B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;EAE7B,CAAC;AAEH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,aAAa;;;;;;;;;;;;;;;;wBAM5B,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;wBA8BlC,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBA0ElC,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC;;;;;;;;;;;;;;EA8BnE"}

package/dist/types/signer.d.ts

@@ -1,120 +0,0 @@
-/**
- * Copyright (c) TonTech.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- *
- */
-/**
- * ISignerAdapter - Interface for secure key management and signing operations
- *
- * Critical: This adapter NEVER returns private keys or seed phrases.
- * Seed phrases are accepted as input but stored securely by the adapter implementation.
- */
-/**
- * Wallet information returned by signer operations.
- * Contains only public data - no private keys or seed phrases.
- */
-export interface WalletInfo {
-    /** Internal wallet ID (may be user-prefixed internally by the adapter) */
-    walletId: string;
-    /** Hex-encoded public key */
-    publicKey: string;
-    /** TON address (user-friendly format) */
-    address: string;
-    /** Network the wallet is configured for */
-    network: 'mainnet' | 'testnet';
-    /** Wallet contract version */
-    version: 'v5r1' | 'v4r2';
-    /** ISO timestamp when wallet was created */
-    createdAt: string;
-}
-/**
- * Parameters for creating a new wallet
- */
-export interface CreateWalletParams {
-    /** Unique wallet ID (should be user-scoped externally) */
-    walletId: string;
-    /** Wallet contract version */
-    version: 'v5r1' | 'v4r2';
-    /** Network to create the wallet on */
-    network: 'mainnet' | 'testnet';
-}
-/**
- * Parameters for importing a wallet from mnemonic
- */
-export interface ImportWalletParams {
-    /** Unique wallet ID (should be user-scoped externally) */
-    walletId: string;
-    /** 24-word mnemonic phrase (stored securely, never returned) */
-    mnemonic: string[];
-    /** Wallet contract version */
-    version: 'v5r1' | 'v4r2';
-    /** Network to import the wallet on */
-    network: 'mainnet' | 'testnet';
-}
-/**
- * Interface for secure key management and signing operations.
- *
- * Implementations should:
- * - Store keys encrypted (e.g., AES-256-GCM with master key derived via PBKDF2/Argon2)
- * - Never expose private keys or seed phrases through any method
- * - Support user isolation if operating in multi-tenant mode
- */
-export interface ISignerAdapter {
-    /**
-     * Create a new wallet with generated keys.
-     * The mnemonic is generated and stored securely - NEVER returned.
-     *
-     * @param params - Wallet creation parameters
-     * @returns Wallet info (address, public key) - NO private data
-     */
-    createWallet(params: CreateWalletParams): Promise<WalletInfo>;
-    /**
-     * Import a wallet from mnemonic.
-     * The mnemonic is stored securely by the adapter - NEVER returned.
-     *
-     * @param params - Import parameters including mnemonic
-     * @returns Wallet info (address, public key) - NO private data
-     */
-    importWallet(params: ImportWalletParams): Promise<WalletInfo>;
-    /**
-     * Get wallet info by ID.
-     *
-     * @param walletId - The wallet ID
-     * @returns Wallet info or null if not found
-     */
-    getWallet(walletId: string): Promise<WalletInfo | null>;
-    /**
-     * List all wallet IDs managed by this adapter.
-     * For user isolation, the wrapper should filter by user prefix.
-     *
-     * @returns Array of wallet IDs
-     */
-    listWalletIds(): Promise<string[]>;
-    /**
-     * Delete a wallet and its keys.
-     *
-     * @param walletId - The wallet ID to delete
-     * @returns true if deleted, false if not found
-     */
-    deleteWallet(walletId: string): Promise<boolean>;
-    /**
-     * Sign a transaction.
-     * The adapter loads the private key internally and signs.
-     *
-     * @param walletId - The wallet ID to sign with
-     * @param unsignedBoc - Base64-encoded unsigned transaction BOC
-     * @returns Base64-encoded signed transaction BOC
-     */
-    signTransaction(walletId: string, unsignedBoc: string): Promise<string>;
-    /**
-     * Sign an arbitrary message.
-     *
-     * @param walletId - The wallet ID to sign with
-     * @param message - The message bytes to sign
-     * @returns The signature bytes
-     */
-    signMessage(walletId: string, message: Buffer): Promise<Buffer>;
-}
-//# sourceMappingURL=signer.d.ts.map

package/dist/types/signer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"signer.d.ts","sourceRoot":"","sources":["../../src/types/signer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,WAAW,UAAU;IACvB,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC;IAC/B,8BAA8B;IAC9B,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,sCAAsC;IACtC,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,sCAAsC;IACtC,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC;CAClC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC3B;;;;;;OAMG;IACH,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAE9D;;;;;;OAMG;IACH,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAE9D;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAExD;;;;;OAKG;IACH,aAAa,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAEnC;;;;;OAKG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEjD;;;;;;;OAOG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAExE;;;;;;OAMG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACnE"}

package/dist/types/storage.d.ts

@@ -1,41 +0,0 @@
-/**
- * Copyright (c) TonTech.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- *
- */
-/**
- * IStorageAdapter - Interface for persistent key-value storage
- *
- * Purpose: Store wallet metadata, contacts, transaction history, pending transactions.
- * Does NOT store: private keys, seed phrases (that's ISignerAdapter's responsibility)
- */
-export interface IStorageAdapter {
-    /**
-     * Get a value by key
-     * @param key - The storage key
-     * @returns The stored value or null if not found
-     */
-    get<T>(key: string): Promise<T | null>;
-    /**
-     * Set a value with optional TTL
-     * @param key - The storage key
-     * @param value - The value to store
-     * @param ttlSeconds - Optional time-to-live in seconds (for pending transactions, etc.)
-     */
-    set<T>(key: string, value: T, ttlSeconds?: number): Promise<void>;
-    /**
-     * Delete a key
-     * @param key - The storage key
-     * @returns true if the key existed and was deleted, false otherwise
-     */
-    delete(key: string): Promise<boolean>;
-    /**
-     * List all keys matching a prefix
-     * @param prefix - The key prefix to match
-     * @returns Array of matching keys
-     */
-    list(prefix: string): Promise<string[]>;
-}
-//# sourceMappingURL=storage.d.ts.map

package/dist/types/storage.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/types/storage.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC5B;;;;OAIG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAEvC;;;;;OAKG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElE;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEtC;;;;OAIG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAC3C"}

package/dist/types/user-context.d.ts

@@ -1,48 +0,0 @@
-/**
- * Copyright (c) TonTech.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- *
- */
-/**
- * IUserContextProvider - Interface for extracting authenticated user identity
- *
- * Purpose: Identify the current user from MCP request context.
- * Returns null if user cannot be authenticated (request should be rejected).
- */
-/**
- * Request context passed to the user context provider.
- * Contains headers and metadata from the MCP request.
- */
-export interface RequestContext {
-    /** HTTP headers (e.g., x-telegram-user-id, authorization) */
-    headers?: Record<string, string>;
-    /** Additional metadata from the transport */
-    metadata?: Record<string, unknown>;
-}
-/**
- * Interface for extracting user identity from request context.
- *
- * Implementations should:
- * - Extract user ID from appropriate header or metadata
- * - Return null if user cannot be authenticated
- * - Optionally provide user metadata for auditing
- */
-export interface IUserContextProvider {
-    /**
-     * Extract user ID from request context.
-     *
-     * @param context - The request context with headers and metadata
-     * @returns User ID string or null if unauthenticated
-     */
-    getUserId(context: RequestContext): Promise<string | null>;
-    /**
-     * Optional: Get additional user metadata for logging/auditing.
-     *
-     * @param userId - The user ID
-     * @returns User metadata or null if not available
-     */
-    getUserMetadata?(userId: string): Promise<Record<string, unknown> | null>;
-}
-//# sourceMappingURL=user-context.d.ts.map

package/dist/types/user-context.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"user-context.d.ts","sourceRoot":"","sources":["../../src/types/user-context.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC3B,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAoB;IACjC;;;;;OAKG;IACH,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAE3D;;;;;OAKG;IACH,eAAe,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;CAC7E"}