@token2chat/t2c 0.2.0-beta.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Token2Chat
+
+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,188 @@
+# t2c - Token2Chat CLI
+
+Pay-per-request LLM access via Cashu ecash.
+
+## Installation
+
+```bash
+npm install -g @token2chat/cli
+```
+
+## Quick Start
+
+```bash
+# 1. Run setup wizard
+t2c setup
+
+# 2. Start the proxy service
+t2c service start
+
+# 3. Add funds to your wallet
+t2c mint
+
+# 4. Configure your AI tool
+t2c config openclaw --apply  # For OpenClaw (auto-merge)
+t2c config cursor            # For Cursor
+t2c config env               # For other tools
+
+# 5. (Optional) Install as system service for auto-start
+t2c service install
+```
+
+## Commands
+
+### `t2c setup`
+Interactive setup wizard. Configures Gate URL, Mint URL, proxy port, and wallet path.
+
+### `t2c status`
+Show service status and wallet balance.
+
+```bash
+t2c status          # Pretty output
+t2c status --json   # JSON output
+```
+
+### `t2c service`
+Manage the local proxy service.
+
+```bash
+t2c service start           # Start as daemon
+t2c service start -f        # Run in foreground
+t2c service stop            # Stop the service
+t2c service restart         # Restart the service
+t2c service status          # Show detailed service status
+t2c service logs            # Show logs
+t2c service logs -f         # Follow logs
+
+# System service management (auto-start on login)
+t2c service install         # Install as launchd (macOS) or systemd (Linux)
+t2c service uninstall       # Uninstall system service
+```
+
+### `t2c mint`
+Add funds to your wallet.
+
+```bash
+t2c mint              # Show deposit address
+t2c mint --check      # Check for pending deposits
+t2c mint 1000         # Create Lightning invoice for 1000 sat
+```
+
+### `t2c config`
+Generate configuration for AI tools.
+
+```bash
+t2c config list             # List supported tools
+t2c config openclaw         # Show OpenClaw config
+t2c config openclaw --apply # Apply to openclaw.json (creates backup)
+t2c config openclaw --json  # Output raw JSON
+t2c config cursor           # Show Cursor config
+t2c config env              # Show environment variables
+```
+
+## Architecture
+
+```
+┌─────────────┐     ┌──────────────────┐     ┌──────────┐
+│  AI Tool    │────▶│  t2c proxy       │────▶│   Gate   │
+│  (OpenClaw, │     │  :10402 (ecash)   │     │          │
+│   Cursor,   │     └──────────────────┘     └──────────┘
+│   etc.)     │
+└─────────────┘
+```
+
+The proxy:
+1. Receives OpenAI-compatible requests from AI tools
+2. Selects ecash tokens from your local wallet
+3. Forwards requests to the Gate with payment
+4. Handles change/refund tokens automatically
+5. Returns the LLM response to your AI tool
+
+## Configuration
+
+Config is stored in `~/.t2c/config.json`:
+
+```json
+{
+  "gateUrl": "https://gate.token2chat.com",
+  "mintUrl": "https://mint.token2chat.com",
+  "walletPath": "~/.t2c/wallet.json",
+  "proxyPort": 10402,
+  "lowBalanceThreshold": 1000
+}
+```
+
+## System Service
+
+### macOS (launchd)
+
+```bash
+# Install
+t2c service install
+
+# Load manually
+launchctl load ~/Library/LaunchAgents/com.token2chat.proxy.plist
+
+# Uninstall
+t2c service uninstall
+```
+
+### Linux (systemd)
+
+```bash
+# Install
+t2c service install
+
+# Enable and start
+systemctl --user daemon-reload
+systemctl --user enable t2c-proxy.service
+systemctl --user start t2c-proxy.service
+
+# Uninstall
+t2c service uninstall
+```
+
+## Supported AI Tools
+
+| Tool | Command | Notes |
+|------|---------|-------|
+| OpenClaw | `t2c config openclaw --apply` | Auto-merges token2chat provider |
+| Cursor | `t2c config cursor` | OpenAI base URL config |
+| Generic | `t2c config env` | OPENAI_API_KEY + OPENAI_BASE_URL |
+
+Any tool that supports OpenAI-compatible APIs can use Token2Chat.
+
+## Error Handling
+
+The CLI handles various error conditions gracefully:
+
+- **No config**: Prompts to run `t2c setup`
+- **No wallet**: Creates one automatically
+- **Corrupted config**: Auto-recovers with backup
+- **Network timeout**: Retries with exponential backoff
+- **Insufficient balance**: Clear error message with balance info
+
+## Development
+
+```bash
+# Clone and install
+git clone https://github.com/token2chat/cli.git
+cd cli
+npm install
+
+# Build
+npm run build
+
+# Run tests
+npm test
+
+# Run with coverage
+npm run test:coverage
+
+# Link for local testing
+npm link
+```
+
+## License
+
+MIT

package/dist/adapters/aider.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Aider adapter - Generate config for Aider AI coding assistant
+ */
+import type { T2CConfig, AdapterConfigOptions } from "../config.js";
+export declare function aiderAdapter(t2cConfig: T2CConfig, opts: AdapterConfigOptions): Promise<void>;

package/dist/adapters/aider.js

@@ -0,0 +1,29 @@
+export async function aiderAdapter(t2cConfig, opts) {
+    const baseUrl = `http://127.0.0.1:${t2cConfig.proxyPort}/v1`;
+    const apiKey = opts.proxySecret ?? "t2c-local";
+    if (opts.json) {
+        console.log(JSON.stringify({
+            OPENAI_API_KEY: apiKey,
+            OPENAI_API_BASE: baseUrl,
+        }, null, 2));
+        return;
+    }
+    console.log("\n🎟️  Aider Configuration\n");
+    console.log("Option 1: Environment variables\n");
+    console.log(`  export OPENAI_API_KEY=${apiKey}`);
+    console.log(`  export OPENAI_API_BASE=${baseUrl}\n`);
+    console.log("  Then run:");
+    console.log("  aider --model openai/anthropic/claude-sonnet-4\n");
+    console.log("Option 2: Command line arguments\n");
+    console.log(`  aider --openai-api-key ${apiKey} \\`);
+    console.log(`        --openai-api-base ${baseUrl} \\`);
+    console.log("        --model openai/anthropic/claude-sonnet-4\n");
+    console.log("Option 3: .aider.conf.yml (project root)\n");
+    console.log("```yaml");
+    console.log(`openai-api-key: ${apiKey}`);
+    console.log(`openai-api-base: ${baseUrl}`);
+    console.log("model: openai/anthropic/claude-sonnet-4");
+    console.log("```\n");
+    console.log("Note: Aider uses 'openai/' prefix for OpenAI-compatible endpoints.");
+    console.log("Available models: openai/anthropic/claude-opus-4, openai/openai/gpt-4o, etc.\n");
+}

package/dist/adapters/cline.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Cline adapter - Generate config for Cline VS Code extension
+ */
+import type { T2CConfig, AdapterConfigOptions } from "../config.js";
+export declare function clineAdapter(t2cConfig: T2CConfig, opts: AdapterConfigOptions): Promise<void>;

package/dist/adapters/cline.js

@@ -0,0 +1,32 @@
+export async function clineAdapter(t2cConfig, opts) {
+    const baseUrl = `http://127.0.0.1:${t2cConfig.proxyPort}/v1`;
+    const apiKey = opts.proxySecret ?? "t2c-local";
+    if (opts.json) {
+        console.log(JSON.stringify({
+            "cline.apiProvider": "openai-compatible",
+            "cline.openAiCompatibleApiBaseUrl": baseUrl,
+            "cline.openAiCompatibleApiKey": apiKey,
+            "cline.openAiCompatibleModelId": "anthropic/claude-sonnet-4",
+        }, null, 2));
+        return;
+    }
+    console.log("\n🎟️  Cline Configuration\n");
+    console.log("Add to your VS Code settings.json:\n");
+    console.log("  ~/.vscode/settings.json (global)");
+    console.log("  .vscode/settings.json (workspace)\n");
+    console.log("```json");
+    console.log("{");
+    console.log('  "cline.apiProvider": "openai-compatible",');
+    console.log(`  "cline.openAiCompatibleApiBaseUrl": "${baseUrl}",`);
+    console.log(`  "cline.openAiCompatibleApiKey": "${apiKey}",`);
+    console.log('  "cline.openAiCompatibleModelId": "anthropic/claude-sonnet-4"');
+    console.log("}");
+    console.log("```\n");
+    console.log("Or configure via Cline extension settings UI:\n");
+    console.log("  1. Open Cline settings (click gear icon)");
+    console.log('  2. Set API Provider to "OpenAI Compatible"');
+    console.log(`  3. Base URL: ${baseUrl}`);
+    console.log(`  4. API Key: ${apiKey}`);
+    console.log("  5. Model ID: anthropic/claude-sonnet-4\n");
+    console.log("Available models: anthropic/claude-opus-4, openai/gpt-4o, etc.\n");
+}

package/dist/adapters/continue.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Continue adapter - Generate config for Continue.dev VS Code extension
+ */
+import type { T2CConfig, AdapterConfigOptions } from "../config.js";
+export declare function continueAdapter(t2cConfig: T2CConfig, opts: AdapterConfigOptions): Promise<void>;

package/dist/adapters/continue.js

@@ -0,0 +1,45 @@
+export async function continueAdapter(t2cConfig, opts) {
+    const baseUrl = `http://127.0.0.1:${t2cConfig.proxyPort}/v1`;
+    const apiKey = opts.proxySecret ?? "t2c-local";
+    const modelConfig = {
+        title: "Token2Chat",
+        provider: "openai",
+        model: "anthropic/claude-sonnet-4",
+        apiBase: baseUrl,
+        apiKey,
+    };
+    if (opts.json) {
+        console.log(JSON.stringify({
+            models: [modelConfig],
+        }, null, 2));
+        return;
+    }
+    console.log("\n🎟️  Continue Configuration\n");
+    console.log("Add to ~/.continue/config.json:\n");
+    console.log("```json");
+    console.log("{");
+    console.log('  "models": [');
+    console.log("    {");
+    console.log('      "title": "Token2Chat",');
+    console.log('      "provider": "openai",');
+    console.log('      "model": "anthropic/claude-sonnet-4",');
+    console.log(`      "apiBase": "${baseUrl}",`);
+    console.log(`      "apiKey": "${apiKey}"`);
+    console.log("    }");
+    console.log("  ]");
+    console.log("}");
+    console.log("```\n");
+    console.log("For chat + autocomplete, add to tabAutocompleteModel as well:\n");
+    console.log("```json");
+    console.log("{");
+    console.log('  "tabAutocompleteModel": {');
+    console.log('    "title": "Token2Chat Autocomplete",');
+    console.log('    "provider": "openai",');
+    console.log('    "model": "anthropic/claude-sonnet-4",');
+    console.log(`    "apiBase": "${baseUrl}",`);
+    console.log('    "apiKey": "t2c-local"');
+    console.log("  }");
+    console.log("}");
+    console.log("```\n");
+    console.log("Available models: anthropic/claude-opus-4, openai/gpt-4o, etc.\n");
+}

package/dist/adapters/cursor.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Cursor adapter - Generate config for Cursor IDE
+ */
+import type { T2CConfig, AdapterConfigOptions } from "../config.js";
+export declare function cursorAdapter(t2cConfig: T2CConfig, opts: AdapterConfigOptions): Promise<void>;

package/dist/adapters/cursor.js

@@ -0,0 +1,23 @@
+export async function cursorAdapter(t2cConfig, opts) {
+    const baseUrl = `http://127.0.0.1:${t2cConfig.proxyPort}/v1`;
+    const apiKey = opts.proxySecret ?? "t2c-local";
+    if (opts.json) {
+        console.log(JSON.stringify({
+            openai: {
+                baseUrl,
+                apiKey,
+            },
+        }, null, 2));
+        return;
+    }
+    console.log("\n🎟️  Cursor Configuration\n");
+    console.log("In Cursor Settings (Cmd/Ctrl + ,), configure:\n");
+    console.log("  1. OpenAI Base URL:");
+    console.log(`     ${baseUrl}\n`);
+    console.log("  2. OpenAI API Key:");
+    console.log(`     ${apiKey}\n`);
+    console.log("  3. Model:");
+    console.log("     anthropic/claude-sonnet-4  (or any OpenRouter model)\n");
+    console.log("Note: Cursor uses OpenRouter-style model IDs (with /).");
+    console.log("Available models: anthropic/claude-opus-4, openai/gpt-4o, etc.\n");
+}

package/dist/adapters/env.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Environment adapter - Generate env vars for generic OpenAI-compatible tools
+ */
+import type { T2CConfig, AdapterConfigOptions } from "../config.js";
+export declare function envAdapter(t2cConfig: T2CConfig, opts: AdapterConfigOptions): Promise<void>;

package/dist/adapters/env.js

@@ -0,0 +1,25 @@
+export async function envAdapter(t2cConfig, opts) {
+    const baseUrl = `http://127.0.0.1:${t2cConfig.proxyPort}/v1`;
+    const apiKey = opts.proxySecret ?? "t2c-local";
+    if (opts.json) {
+        console.log(JSON.stringify({
+            OPENAI_API_KEY: apiKey,
+            OPENAI_BASE_URL: baseUrl,
+        }, null, 2));
+        return;
+    }
+    console.log("\n🎟️  Environment Variables\n");
+    console.log("For any OpenAI-compatible tool, set these environment variables:\n");
+    console.log(`  export OPENAI_API_KEY=${apiKey}`);
+    console.log(`  export OPENAI_BASE_URL=${baseUrl}\n`);
+    console.log("Or in a .env file:\n");
+    console.log(`  OPENAI_API_KEY=${apiKey}`);
+    console.log(`  OPENAI_BASE_URL=${baseUrl}\n`);
+    console.log("Model format: provider/model (e.g., anthropic/claude-sonnet-4)\n");
+    console.log("These work with tools like:");
+    console.log("  - LangChain");
+    console.log("  - LlamaIndex");
+    console.log("  - Continue.dev");
+    console.log("  - Aider");
+    console.log("  - Any OpenAI SDK-based application\n");
+}

package/dist/adapters/index.d.ts

@@ -0,0 +1,6 @@
+export { openclawAdapter } from "./openclaw.js";
+export { cursorAdapter } from "./cursor.js";
+export { envAdapter } from "./env.js";
+export { clineAdapter } from "./cline.js";
+export { continueAdapter } from "./continue.js";
+export { aiderAdapter } from "./aider.js";

package/dist/adapters/index.js

@@ -0,0 +1,6 @@
+export { openclawAdapter } from "./openclaw.js";
+export { cursorAdapter } from "./cursor.js";
+export { envAdapter } from "./env.js";
+export { clineAdapter } from "./cline.js";
+export { continueAdapter } from "./continue.js";
+export { aiderAdapter } from "./aider.js";

package/dist/adapters/openclaw.d.ts

@@ -0,0 +1,2 @@
+import type { T2CConfig, AdapterConfigOptions } from "../config.js";
+export declare function openclawAdapter(t2cConfig: T2CConfig, opts: AdapterConfigOptions): Promise<void>;

package/dist/adapters/openclaw.js

@@ -0,0 +1,167 @@
+/**
+ * OpenClaw adapter - Generate config for OpenClaw
+ */
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+// Popular models available through the Gate
+const GATE_MODELS = [
+    // OpenAI
+    { id: "openai-gpt-4o-mini", name: "GPT-4o Mini", contextWindow: 128_000 },
+    { id: "openai-gpt-4o", name: "GPT-4o", contextWindow: 128_000 },
+    { id: "openai-gpt-5.2-pro", name: "GPT-5.2 Pro", contextWindow: 400_000 },
+    { id: "openai-o3-pro", name: "OpenAI o3 Pro", contextWindow: 200_000 },
+    // Anthropic
+    { id: "anthropic-claude-opus-4.5", name: "Claude Opus 4.5", contextWindow: 200_000 },
+    { id: "anthropic-claude-sonnet-4.5", name: "Claude Sonnet 4.5", contextWindow: 200_000 },
+    { id: "anthropic-claude-opus-4", name: "Claude Opus 4", contextWindow: 200_000 },
+    { id: "anthropic-claude-sonnet-4", name: "Claude Sonnet 4", contextWindow: 200_000 },
+    // Google
+    { id: "google-gemini-3-flash-preview", name: "Gemini 3 Flash", contextWindow: 1_000_000 },
+    { id: "google-gemini-2.5-pro-preview", name: "Gemini 2.5 Pro", contextWindow: 1_000_000 },
+    // Others
+    { id: "deepseek-deepseek-r1", name: "DeepSeek R1", contextWindow: 64_000 },
+    { id: "qwen-qwen3-coder-next", name: "Qwen3 Coder", contextWindow: 256_000 },
+    { id: "moonshotai-kimi-k2.5", name: "Kimi K2.5", contextWindow: 256_000 },
+];
+function generateOpenClawConfig(t2cConfig, apiKey) {
+    return {
+        models: {
+            mode: "merge",
+            providers: {
+                token2chat: {
+                    baseUrl: `http://127.0.0.1:${t2cConfig.proxyPort}/v1`,
+                    apiKey,
+                    api: "openai-completions",
+                    authHeader: false,
+                    models: GATE_MODELS.map((m) => ({
+                        id: m.id,
+                        name: m.name,
+                        reasoning: false,
+                        input: ["text"],
+                        cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+                        contextWindow: m.contextWindow,
+                        maxTokens: 16_384,
+                    })),
+                },
+            },
+        },
+    };
+}
+async function loadOpenClawConfig() {
+    const configPath = path.join(os.homedir(), ".openclaw", "openclaw.json");
+    try {
+        const raw = await fs.readFile(configPath, "utf-8");
+        return { config: JSON.parse(raw), path: configPath };
+    }
+    catch (e) {
+        // Distinguish between file not found and parse error
+        if (e.code === "ENOENT") {
+            return null;
+        }
+        // If file exists but is invalid JSON, throw with helpful message
+        throw new Error(`Failed to parse ${configPath}: ${e.message}`);
+    }
+}
+async function saveOpenClawConfig(config, configPath) {
+    // Create backup before modifying
+    const backupPath = `${configPath}.backup.${Date.now()}`;
+    try {
+        const existing = await fs.readFile(configPath, "utf-8");
+        await fs.writeFile(backupPath, existing);
+    }
+    catch {
+        // File may not exist yet
+    }
+    await fs.writeFile(configPath, JSON.stringify(config, null, 2));
+}
+function mergeDeep(target, source) {
+    const result = { ...target };
+    for (const key of Object.keys(source)) {
+        if (source[key] &&
+            typeof source[key] === "object" &&
+            !Array.isArray(source[key]) &&
+            target[key] &&
+            typeof target[key] === "object" &&
+            !Array.isArray(target[key])) {
+            result[key] = mergeDeep(target[key], source[key]);
+        }
+        else {
+            result[key] = source[key];
+        }
+    }
+    return result;
+}
+export async function openclawAdapter(t2cConfig, opts) {
+    const apiKey = opts.proxySecret ?? "t2c-local";
+    const patch = generateOpenClawConfig(t2cConfig, apiKey);
+    if (opts.json) {
+        console.log(JSON.stringify(patch, null, 2));
+        return;
+    }
+    if (opts.apply) {
+        let existing;
+        try {
+            existing = await loadOpenClawConfig();
+        }
+        catch (e) {
+            console.error(`Error reading OpenClaw config: ${e.message}`);
+            console.error("\nPossible fixes:");
+            console.error("  1. Fix the JSON syntax error in openclaw.json");
+            console.error("  2. Run 't2c config openclaw' (without --apply) to see the config to add manually");
+            process.exit(1);
+        }
+        if (!existing) {
+            console.error("OpenClaw config not found at ~/.openclaw/openclaw.json");
+            console.error("\nTo set up OpenClaw first:");
+            console.error("  openclaw onboard\n");
+            console.error("Or create the config manually and run this command again.");
+            process.exit(1);
+        }
+        // Check if token2chat provider already exists
+        const existingT2C = existing.config.models?.providers?.token2chat;
+        if (existingT2C) {
+            console.log("Token2Chat provider already configured in OpenClaw.");
+            console.log("Updating configuration...\n");
+        }
+        const merged = mergeDeep(existing.config, patch);
+        try {
+            await saveOpenClawConfig(merged, existing.path);
+        }
+        catch (e) {
+            console.error(`Failed to save config: ${e.message}`);
+            process.exit(1);
+        }
+        console.log("✅ OpenClaw config updated: ~/.openclaw/openclaw.json\n");
+        // Verify the saved config is valid JSON
+        try {
+            const verify = await fs.readFile(existing.path, "utf-8");
+            JSON.parse(verify);
+        }
+        catch {
+            console.error("⚠️  Warning: Config may be corrupted. Check ~/.openclaw/openclaw.json");
+            console.error("   A backup was created before modification.");
+        }
+        console.log("Token2Chat provider added. To use it:\n");
+        console.log("  1. Restart the gateway:");
+        console.log("     openclaw gateway restart\n");
+        console.log("  2. Set as default model (optional):");
+        console.log("     openclaw models set token2chat/anthropic-claude-sonnet-4\n");
+        console.log("  3. Or add to fallbacks in openclaw.json:");
+        console.log('     agents.defaults.model.fallbacks: ["token2chat/anthropic-claude-sonnet-4"]\n');
+        return;
+    }
+    // Default: show instructions
+    console.log("\n🎟️  OpenClaw Configuration\n");
+    console.log("Add this to your ~/.openclaw/openclaw.json:\n");
+    console.log("```json");
+    console.log(JSON.stringify(patch, null, 2));
+    console.log("```\n");
+    console.log("Or run with --apply to merge automatically:");
+    console.log("  t2c config openclaw --apply\n");
+    console.log("After updating config:\n");
+    console.log("  1. Restart the gateway:");
+    console.log("     openclaw gateway restart\n");
+    console.log("  2. Set as default or fallback model:");
+    console.log("     openclaw models set token2chat/anthropic-claude-sonnet-4\n");
+}

package/dist/cashu-store.d.ts

@@ -0,0 +1,52 @@
+import { type Proof } from "@cashu/cashu-ts";
+export interface CashuStoreData {
+    mint: string;
+    unit: string;
+    proofs: Proof[];
+}
+export declare class CashuStore {
+    private path;
+    private data;
+    private wallet;
+    private mutex;
+    constructor(path: string, data: CashuStoreData);
+    get mint(): string;
+    get balance(): number;
+    get proofCount(): number;
+    /** Load from file, or create new empty store */
+    static load(path: string, mint?: string): Promise<CashuStore>;
+    /** Persist to file */
+    save(): Promise<void>;
+    /** Return a deep copy of the store data */
+    exportData(): CashuStoreData;
+    /** Returns true if balance is below threshold */
+    needsFunding(threshold: number): boolean;
+    /**
+     * Select proofs totalling at least `amount` sat,
+     * encode as a Cashu V4 token, and remove them from the store.
+     */
+    selectAndEncode(amount: number): Promise<string>;
+    /**
+     * Import proofs directly into the store.
+     * No mint swap — caller is responsible for proof validity.
+     */
+    importProofs(proofs: Proof[]): Promise<number>;
+    /** Get or init CashuWallet (lazy, connects to mint) */
+    private getCashuWallet;
+    /**
+     * Receive an encoded Cashu token — swap at mint for fresh proofs.
+     * Used for change/refund tokens from the Gate.
+     */
+    receiveToken(encodedToken: string): Promise<number>;
+    /**
+     * Create a mint quote (Lightning invoice) for funding.
+     */
+    createMintQuote(amount: number): Promise<{
+        quote: string;
+        request: string;
+    }>;
+    /**
+     * Check and mint tokens from a paid quote.
+     */
+    mintFromQuote(quoteId: string, amount: number): Promise<number>;
+}