@truecarry/mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 TonTech
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,141 @@
+# @ton/mcp - TON MCP Server
+
+A Model Context Protocol (MCP) server for TON blockchain wallet operations. Built on top of `@ton/walletkit`.
+
+## Features
+
+- **Wallet Management**: Create, import, list, and remove TON wallets
+- **Balance Queries**: Check TON and Jetton balances
+- **Transfers**: Send TON and Jettons to any address
+- **Secure Storage**: Wallets stored locally with encryption-ready design
+
+## Installation
+
+```bash
+# In the monorepo
+pnpm install
+pnpm --filter @ton/mcp build
+```
+
+## Usage with MCP Clients
+
+### Claude Desktop / Cursor
+
+Add to your MCP configuration:
+
+```json
+{
+  "mcpServers": {
+    "ton": {
+      "command": "node",
+      "args": ["/path/to/kit/apps/mcp/dist/index.js"]
+    }
+  }
+}
+```
+
+## Available Tools
+
+### Wallet Management
+
+#### `create_wallet`
+Create a new TON wallet with a generated 24-word mnemonic.
+
+**Parameters:**
+- `name` (required): Unique name for the wallet
+- `version` (optional): Wallet version - `v5r1` (default, recommended) or `v4r2`
+
+**Returns:** Wallet address and mnemonic (save securely!)
+
+#### `import_wallet`
+Import an existing wallet using a mnemonic phrase.
+
+**Parameters:**
+- `name` (required): Unique name for the wallet
+- `mnemonic` (required): 24-word mnemonic phrase (space-separated)
+- `version` (optional): Wallet version - `v5r1` (default) or `v4r2`
+
+#### `list_wallets`
+List all stored wallets with their addresses and metadata.
+
+#### `remove_wallet`
+Remove a wallet from storage.
+
+**Parameters:**
+- `name` (required): Name of the wallet to remove
+
+### Balance Queries
+
+#### `get_balance`
+Get the TON balance for a wallet.
+
+**Parameters:**
+- `wallet` (required): Name of the wallet
+
+**Returns:** Balance in nanoTON and TON
+
+#### `get_jetton_balance`
+Get the balance of a specific Jetton.
+
+**Parameters:**
+- `wallet` (required): Name of the wallet
+- `jettonAddress` (required): Jetton master contract address
+
+#### `get_jettons`
+List all Jettons held by a wallet.
+
+**Parameters:**
+- `wallet` (required): Name of the wallet
+
+### Transfers
+
+#### `send_ton`
+Send TON to an address.
+
+**Parameters:**
+- `wallet` (required): Name of the wallet to send from
+- `toAddress` (required): Recipient TON address
+- `amount` (required): Amount in nanoTON (1 TON = 1,000,000,000 nanoTON)
+- `comment` (optional): Transaction comment/memo
+
+#### `send_jetton`
+Send Jettons to an address.
+
+**Parameters:**
+- `wallet` (required): Name of the wallet to send from
+- `toAddress` (required): Recipient TON address
+- `jettonAddress` (required): Jetton master contract address
+- `amount` (required): Amount in raw units (apply decimals yourself)
+- `comment` (optional): Transaction comment/memo
+
+## Storage
+
+Wallet data is stored in `~/.ton-mcp/wallets.json`.
+
+**Current Implementation:** Plaintext JSON storage
+
+**Security Note:** Mnemonics are currently stored in plaintext. The storage interface is designed to easily support encrypted storage in the future. Do not use this for production wallets with significant funds until encryption is implemented.
+
+## Development
+
+```bash
+# Build
+pnpm build
+
+# Watch mode
+pnpm dev
+
+# Run directly
+pnpm start
+```
+
+## Network
+
+The server uses TON Mainnet by default. This can be configured in the WalletService constructor.
+
+## License
+
+MIT
+
+
+

package/dist/adapters/InMemoryStorageAdapter.d.ts

@@ -0,0 +1,49 @@
+/**
+ * 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.
+ *
+ */
+/**
+ * InMemoryStorageAdapter - Simple in-memory storage for testing and development
+ *
+ * Features:
+ * - Map-based storage
+ * - TTL support via setTimeout
+ * - Not persistent - data lost on restart
+ */
+import type { IStorageAdapter } from '../types/storage.js';
+/**
+ * In-memory storage adapter for testing and development.
+ * Data is not persistent and will be lost on process restart.
+ */
+export declare class InMemoryStorageAdapter implements IStorageAdapter {
+    private data;
+    private timers;
+    /**
+     * Get a value by key
+     */
+    get<T>(key: string): Promise<T | null>;
+    /**
+     * Set a value with optional TTL
+     */
+    set<T>(key: string, value: T, ttlSeconds?: number): Promise<void>;
+    /**
+     * Delete a key
+     */
+    delete(key: string): Promise<boolean>;
+    /**
+     * List keys matching prefix
+     */
+    list(prefix: string): Promise<string[]>;
+    /**
+     * Clear all data (useful for testing)
+     */
+    clear(): void;
+    /**
+     * Get the number of stored items (useful for testing)
+     */
+    size(): number;
+}
+//# sourceMappingURL=InMemoryStorageAdapter.d.ts.map

package/dist/adapters/InMemoryStorageAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryStorageAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/InMemoryStorageAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D;;;GAGG;AACH,qBAAa,sBAAuB,YAAW,eAAe;IAC1D,OAAO,CAAC,IAAI,CAAmC;IAC/C,OAAO,CAAC,MAAM,CAAyD;IAEvE;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAK5C;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBvE;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAW3C;;OAEG;IACG,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAU7C;;OAEG;IACH,KAAK,IAAI,IAAI;IASb;;OAEG;IACH,IAAI,IAAI,MAAM;CAGjB"}

package/dist/adapters/LocalSignerAdapter.d.ts

@@ -0,0 +1,107 @@
+/**
+ * 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.
+ *
+ */
+/**
+ * LocalSignerAdapter - Local signer using @ton/walletkit
+ *
+ * This adapter uses TonWalletKit for wallet operations.
+ * For production use with encryption, extend this class or implement
+ * your own ISignerAdapter with proper key encryption.
+ *
+ * Note: This is a reference implementation. For production custody,
+ * consider using HSM, KMS, or Vault-based signers.
+ */
+import { TonWalletKit } from '@ton/walletkit';
+import type { Wallet } from '@ton/walletkit';
+import type { ISignerAdapter, WalletInfo, CreateWalletParams, ImportWalletParams } from '../types/signer.js';
+/**
+ * Internal wallet data stored by the adapter
+ */
+interface StoredWallet {
+    walletId: string;
+    mnemonic: string[];
+    publicKey: string;
+    address: string;
+    network: 'mainnet' | 'testnet';
+    version: 'v5r1' | 'v4r2';
+    createdAt: string;
+}
+/**
+ * Local signer adapter using TonWalletKit.
+ *
+ * This implementation stores mnemonics in memory. For production use,
+ * implement encryption or use a secure key management system.
+ */
+export declare class LocalSignerAdapter implements ISignerAdapter {
+    private wallets;
+    private kit;
+    private loadedWallets;
+    /**
+     * Get Network instance from network name
+     */
+    private getNetwork;
+    /**
+     * Initialize or get TonWalletKit instance
+     */
+    private getKit;
+    /**
+     * Create wallet adapter from mnemonic
+     */
+    private createWalletAdapter;
+    /**
+     * Create a new wallet with generated mnemonic
+     */
+    createWallet(params: CreateWalletParams): Promise<WalletInfo>;
+    /**
+     * Import a wallet from mnemonic
+     */
+    importWallet(params: ImportWalletParams): Promise<WalletInfo>;
+    /**
+     * Get wallet info by ID
+     */
+    getWallet(walletId: string): Promise<WalletInfo | null>;
+    /**
+     * List all wallet IDs
+     */
+    listWalletIds(): Promise<string[]>;
+    /**
+     * Delete a wallet
+     */
+    deleteWallet(walletId: string): Promise<boolean>;
+    /**
+     * Get or load a wallet for signing
+     */
+    private getWalletForSigning;
+    /**
+     * Sign a transaction
+     */
+    signTransaction(_walletId: string, _unsignedBoc: string): Promise<string>;
+    /**
+     * Sign a message
+     */
+    signMessage(walletId: string, message: Buffer): Promise<Buffer>;
+    /**
+     * Close and cleanup
+     */
+    close(): Promise<void>;
+    /**
+     * Get TonWalletKit instance for direct wallet operations
+     * Used by WalletService for balance/transfer operations
+     */
+    getKitInstance(): Promise<TonWalletKit>;
+    /**
+     * Get a loaded wallet by ID for direct operations
+     * Used by WalletService for balance/transfer operations
+     */
+    getLoadedWallet(walletId: string): Promise<Wallet>;
+    /**
+     * Get stored wallet data (internal use only)
+     */
+    getStoredWallet(walletId: string): StoredWallet | undefined;
+}
+export {};
+//# sourceMappingURL=LocalSignerAdapter.d.ts.map

package/dist/adapters/LocalSignerAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalSignerAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/LocalSignerAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;GASG;AAEH,OAAO,EACH,YAAY,EAOf,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE7G;;GAEG;AACH,UAAU,YAAY;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC;IAC/B,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,qBAAa,kBAAmB,YAAW,cAAc;IACrD,OAAO,CAAC,OAAO,CAAwC;IACvD,OAAO,CAAC,GAAG,CAA6B;IACxC,OAAO,CAAC,aAAa,CAAkC;IAEvD;;OAEG;IACH,OAAO,CAAC,UAAU;IAIlB;;OAEG;YACW,MAAM;IAcpB;;OAEG;YACW,mBAAmB;IAyBjC;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;IA4CnE;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;IAgDnE;;OAEG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAgB7D;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAIxC;;OAEG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAatD;;OAEG;YACW,mBAAmB;IA8BjC;;OAEG;IACG,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAc/E;;OAEG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAYrE;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ5B;;;OAGG;IACG,cAAc,IAAI,OAAO,CAAC,YAAY,CAAC;IAI7C;;;OAGG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIxD;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;CAG9D"}

package/dist/adapters/SqliteSignerAdapter.d.ts

@@ -0,0 +1,119 @@
+/**
+ * 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.
+ *
+ */
+import { TonWalletKit } from '@ton/walletkit';
+import type { Wallet } from '@ton/walletkit';
+import type { ISignerAdapter, WalletInfo, CreateWalletParams, ImportWalletParams } from '../types/signer.js';
+import type { SqliteDatabase } from './SqliteStorageAdapter.js';
+/**
+ * Configuration for SqliteSignerAdapter
+ */
+export interface SqliteSignerConfig {
+    /** SQLite database instance */
+    db: SqliteDatabase;
+    /** Encryption key (32-byte hex string or raw bytes) */
+    encryptionKey: string | Buffer;
+    /** Table name for wallets (default: 'wallets') */
+    tableName?: string;
+}
+/**
+ * SQLite-based signer adapter with encrypted mnemonic storage.
+ *
+ * Mnemonics are encrypted using AES-256-GCM before storage.
+ * The encryption key should be provided via environment variable.
+ */
+export declare class SqliteSignerAdapter implements ISignerAdapter {
+    private readonly db;
+    private readonly tableName;
+    private readonly encryptionKey;
+    private kit;
+    private loadedWallets;
+    constructor(config: SqliteSignerConfig);
+    /**
+     * Derive a 32-byte encryption key
+     */
+    private deriveKey;
+    /**
+     * Initialize the wallets table
+     */
+    private initializeTable;
+    /**
+     * Encrypt mnemonic using AES-256-GCM
+     */
+    private encryptMnemonic;
+    /**
+     * Decrypt mnemonic using AES-256-GCM
+     */
+    private decryptMnemonic;
+    /**
+     * Get Network instance from network name
+     */
+    private getNetwork;
+    /**
+     * Initialize or get TonWalletKit instance
+     */
+    private getKit;
+    /**
+     * Create wallet adapter from mnemonic
+     */
+    private createWalletAdapter;
+    /**
+     * Create a new wallet with generated mnemonic
+     */
+    createWallet(params: CreateWalletParams): Promise<WalletInfo>;
+    /**
+     * Import a wallet from mnemonic
+     */
+    importWallet(params: ImportWalletParams): Promise<WalletInfo>;
+    /**
+     * Get wallet info by ID
+     */
+    getWallet(walletId: string): Promise<WalletInfo | null>;
+    /**
+     * List all wallet IDs
+     */
+    listWalletIds(): Promise<string[]>;
+    /**
+     * Delete a wallet
+     */
+    deleteWallet(walletId: string): Promise<boolean>;
+    /**
+     * Get or load a wallet for signing
+     */
+    private getWalletForSigning;
+    /**
+     * Sign a transaction
+     */
+    signTransaction(_walletId: string, _unsignedBoc: string): Promise<string>;
+    /**
+     * Sign a message
+     */
+    signMessage(walletId: string, message: Buffer): Promise<Buffer>;
+    /**
+     * Close and cleanup
+     */
+    close(): Promise<void>;
+    /**
+     * Get TonWalletKit instance for direct wallet operations
+     * Used by WalletService for balance/transfer operations
+     */
+    getKitInstance(): Promise<TonWalletKit>;
+    /**
+     * Get a loaded wallet by ID for direct operations
+     * Used by WalletService for balance/transfer operations
+     */
+    getLoadedWallet(walletId: string): Promise<Wallet>;
+    /**
+     * Get stored wallet data (internal use only)
+     * Returns mnemonic for internal operations (like McpWalletService)
+     */
+    getStoredWallet(walletId: string): {
+        mnemonic: string[];
+        version: 'v5r1' | 'v4r2';
+    } | undefined;
+}
+//# sourceMappingURL=SqliteSignerAdapter.d.ts.map

package/dist/adapters/SqliteSignerAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqliteSignerAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/SqliteSignerAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAeH,OAAO,EACH,YAAY,EAOf,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7G,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAehE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,+BAA+B;IAC/B,EAAE,EAAE,cAAc,CAAC;IACnB,uDAAuD;IACvD,aAAa,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,qBAAa,mBAAoB,YAAW,cAAc;IACtD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAiB;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,GAAG,CAA6B;IACxC,OAAO,CAAC,aAAa,CAAkC;gBAE3C,MAAM,EAAE,kBAAkB;IAOtC;;OAEG;IACH,OAAO,CAAC,SAAS;IAiBjB;;OAEG;IACH,OAAO,CAAC,eAAe;IAoBvB;;OAEG;IACH,OAAO,CAAC,eAAe;IAYvB;;OAEG;IACH,OAAO,CAAC,eAAe;IAavB;;OAEG;IACH,OAAO,CAAC,UAAU;IAIlB;;OAEG;YACW,MAAM;IAcpB;;OAEG;YACW,mBAAmB;IAyBjC;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;IA0CnE;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;IA8CnE;;OAEG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAmB7D;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKxC;;OAEG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQtD;;OAEG;YACW,mBAAmB;IAkCjC;;OAEG;IACG,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI/E;;OAEG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAgBrE;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ5B;;;OAGG;IACG,cAAc,IAAI,OAAO,CAAC,YAAY,CAAC;IAI7C;;;OAGG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIxD;;;OAGG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAAG,SAAS;CAclG"}

package/dist/adapters/SqliteStorageAdapter.d.ts

@@ -0,0 +1,81 @@
+/**
+ * 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.
+ *
+ */
+/**
+ * SqliteStorageAdapter - SQLite-based persistent storage
+ *
+ * Features:
+ * - Persistent key-value storage using SQLite
+ * - TTL support with automatic cleanup
+ * - Thread-safe operations via better-sqlite3
+ */
+import type { IStorageAdapter } from '../types/storage.js';
+/**
+ * Database interface for SQLite operations.
+ * This allows injecting a better-sqlite3 database instance.
+ */
+export interface SqliteDatabase {
+    prepare(sql: string): {
+        run(...params: unknown[]): {
+            changes: number;
+        };
+        get(...params: unknown[]): unknown;
+        all(...params: unknown[]): unknown[];
+    };
+    exec(sql: string): void;
+}
+/**
+ * Configuration for SqliteStorageAdapter
+ */
+export interface SqliteStorageConfig {
+    /** SQLite database instance */
+    db: SqliteDatabase;
+    /** Table name for storage (default: 'storage') */
+    tableName?: string;
+}
+/**
+ * SQLite-based storage adapter for persistent key-value storage.
+ * Uses better-sqlite3 for synchronous, thread-safe operations.
+ */
+export declare class SqliteStorageAdapter implements IStorageAdapter {
+    private readonly db;
+    private readonly tableName;
+    constructor(config: SqliteStorageConfig);
+    /**
+     * Initialize the storage table
+     */
+    private initializeTable;
+    /**
+     * Clean up expired entries
+     */
+    private cleanupExpired;
+    /**
+     * Get a value by key
+     */
+    get<T>(key: string): Promise<T | null>;
+    /**
+     * Set a value with optional TTL
+     */
+    set<T>(key: string, value: T, ttlSeconds?: number): Promise<void>;
+    /**
+     * Delete a key
+     */
+    delete(key: string): Promise<boolean>;
+    /**
+     * List keys matching prefix
+     */
+    list(prefix: string): Promise<string[]>;
+    /**
+     * Clear all data (useful for testing)
+     */
+    clear(): void;
+    /**
+     * Get the number of stored items
+     */
+    size(): number;
+}
+//# sourceMappingURL=SqliteStorageAdapter.d.ts.map

package/dist/adapters/SqliteStorageAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqliteStorageAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/SqliteStorageAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC3B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG;QAClB,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG;YAAE,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC;QAC/C,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QACnC,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC;KACxC,CAAC;IACF,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,+BAA+B;IAC/B,EAAE,EAAE,cAAc,CAAC;IACnB,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,qBAAa,oBAAqB,YAAW,eAAe;IACxD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAiB;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,MAAM,EAAE,mBAAmB;IAMvC;;OAEG;IACH,OAAO,CAAC,eAAe;IAiBvB;;OAEG;IACH,OAAO,CAAC,cAAc;IAKtB;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAwB5C;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASvE;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK3C;;OAEG;IACG,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAU7C;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,IAAI,IAAI,MAAM;CAKjB"}

package/dist/adapters/TelegramUserContextProvider.d.ts

@@ -0,0 +1,70 @@
+/**
+ * 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.
+ *
+ */
+/**
+ * TelegramUserContextProvider - Extract user ID from Telegram bot context
+ *
+ * This provider extracts the Telegram user ID from:
+ * 1. x-telegram-user-id header
+ * 2. metadata.telegramUserId field
+ *
+ * For use with Telegram bot integrations.
+ */
+import type { IUserContextProvider, RequestContext } from '../types/user-context.js';
+/**
+ * Configuration for TelegramUserContextProvider
+ */
+export interface TelegramUserContextConfig {
+    /**
+     * Header name to extract user ID from
+     * @default 'x-telegram-user-id'
+     */
+    headerName?: string;
+    /**
+     * Metadata key to extract user ID from
+     * @default 'telegramUserId'
+     */
+    metadataKey?: string;
+    /**
+     * Optional prefix to add to user IDs
+     * @default 'tg:'
+     */
+    userIdPrefix?: string;
+}
+/**
+ * User context provider for Telegram bot integrations.
+ * Extracts user ID from headers or metadata.
+ */
+export declare class TelegramUserContextProvider implements IUserContextProvider {
+    private readonly headerName;
+    private readonly metadataKey;
+    private readonly userIdPrefix;
+    constructor(config?: TelegramUserContextConfig);
+    /**
+     * Extract user ID from request context
+     */
+    getUserId(context: RequestContext): Promise<string | null>;
+    /**
+     * Get user metadata (optional)
+     */
+    getUserMetadata(userId: string): Promise<Record<string, unknown> | null>;
+    /**
+     * Validate user ID format
+     */
+    private isValidUserId;
+}
+/**
+ * Simple user context provider that always returns a fixed user ID.
+ * Useful for single-user CLI applications or testing.
+ */
+export declare class StaticUserContextProvider implements IUserContextProvider {
+    private readonly userId;
+    constructor(userId: string);
+    getUserId(): Promise<string>;
+    getUserMetadata(): Promise<Record<string, unknown> | null>;
+}
+//# sourceMappingURL=TelegramUserContextProvider.d.ts.map

package/dist/adapters/TelegramUserContextProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TelegramUserContextProvider.d.ts","sourceRoot":"","sources":["../../src/adapters/TelegramUserContextProvider.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAErF;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACtC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,qBAAa,2BAA4B,YAAW,oBAAoB;IACpE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAE1B,MAAM,CAAC,EAAE,yBAAyB;IAM9C;;OAEG;IACG,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAuBhE;;OAEG;IACG,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAU9E;;OAEG;IACH,OAAO,CAAC,aAAa;CAIxB;AAED;;;GAGG;AACH,qBAAa,yBAA0B,YAAW,oBAAoB;IAClE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,MAAM,EAAE,MAAM;IAIpB,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC;IAI5B,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAMnE"}

package/dist/adapters/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 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.
+ *
+ */
+/**
+ * Example adapter exports
+ */
+export { InMemoryStorageAdapter } from './InMemoryStorageAdapter.js';
+export { SqliteStorageAdapter } from './SqliteStorageAdapter.js';
+export type { SqliteDatabase, SqliteStorageConfig } from './SqliteStorageAdapter.js';
+export { LocalSignerAdapter } from './LocalSignerAdapter.js';
+export { SqliteSignerAdapter } from './SqliteSignerAdapter.js';
+export type { SqliteSignerConfig } from './SqliteSignerAdapter.js';
+export { TelegramUserContextProvider, StaticUserContextProvider } from './TelegramUserContextProvider.js';
+export type { TelegramUserContextConfig } from './TelegramUserContextProvider.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AAGH,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAGrF,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,YAAY,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAGnE,OAAO,EAAE,2BAA2B,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAC1G,YAAY,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 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.
+ *
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}