@mcpsovereign/sdk 0.1.0 → 0.2.0

package/dist/wallet/types.js

@@ -0,0 +1,149 @@
+/**
+ * Wallet Types for mcpSovereign
+ *
+ * Lightning-first wallet setup and management
+ */
+export const WALLET_PROVIDERS = {
+    alby: {
+        id: 'alby',
+        name: 'Alby',
+        emoji: '🐝',
+        description: 'Browser extension with Lightning address. Best for agents!',
+        type: 'custodial',
+        platforms: ['web', 'desktop'],
+        supportsLNURL: true,
+        supportsLightningAddress: true,
+        setupUrl: 'https://getalby.com',
+        difficulty: 'easy',
+        recommended: true
+    },
+    walletofsatoshi: {
+        id: 'walletofsatoshi',
+        name: 'Wallet of Satoshi',
+        emoji: '🟠',
+        description: 'Simplest mobile wallet. Download, done.',
+        type: 'custodial',
+        platforms: ['ios', 'android'],
+        supportsLNURL: true,
+        supportsLightningAddress: true,
+        setupUrl: 'https://walletofsatoshi.com',
+        difficulty: 'easy',
+        recommended: true
+    },
+    phoenix: {
+        id: 'phoenix',
+        name: 'Phoenix',
+        emoji: '🔥',
+        description: 'Self-custodial mobile wallet. Your keys, your Bitcoin.',
+        type: 'non-custodial',
+        platforms: ['ios', 'android'],
+        supportsLNURL: true,
+        supportsLightningAddress: true,
+        setupUrl: 'https://phoenix.acinq.co',
+        difficulty: 'medium'
+    },
+    muun: {
+        id: 'muun',
+        name: 'Muun',
+        emoji: '🌙',
+        description: 'Non-custodial with on-chain and Lightning.',
+        type: 'non-custodial',
+        platforms: ['ios', 'android'],
+        supportsLNURL: false,
+        supportsLightningAddress: false,
+        setupUrl: 'https://muun.com',
+        difficulty: 'medium'
+    },
+    bluewallet: {
+        id: 'bluewallet',
+        name: 'BlueWallet',
+        emoji: '🔵',
+        description: 'Feature-rich wallet for mobile and desktop.',
+        type: 'non-custodial',
+        platforms: ['ios', 'android', 'desktop'],
+        supportsLNURL: true,
+        supportsLightningAddress: false,
+        setupUrl: 'https://bluewallet.io',
+        difficulty: 'medium'
+    },
+    breez: {
+        id: 'breez',
+        name: 'Breez',
+        emoji: '🌊',
+        description: 'Non-custodial Lightning with podcasting features.',
+        type: 'non-custodial',
+        platforms: ['ios', 'android'],
+        supportsLNURL: true,
+        supportsLightningAddress: false,
+        setupUrl: 'https://breez.technology',
+        difficulty: 'medium'
+    },
+    zeus: {
+        id: 'zeus',
+        name: 'Zeus',
+        emoji: '⚡',
+        description: 'Connect to your own Lightning node.',
+        type: 'self-hosted',
+        platforms: ['ios', 'android'],
+        supportsLNURL: true,
+        supportsLightningAddress: false,
+        setupUrl: 'https://zeusln.com',
+        difficulty: 'advanced'
+    },
+    custom: {
+        id: 'custom',
+        name: 'Custom / Other',
+        emoji: '🔧',
+        description: 'Use any wallet with a Lightning address.',
+        type: 'non-custodial',
+        platforms: ['web', 'ios', 'android', 'desktop'],
+        supportsLNURL: true,
+        supportsLightningAddress: true,
+        setupUrl: '',
+        difficulty: 'medium'
+    }
+};
+export const WALLET_SETUP_STEPS = [
+    {
+        id: 'intro',
+        title: 'Lightning Wallet Required',
+        description: 'mcpSovereign runs on Bitcoin Lightning. Let\'s set up your wallet.',
+        emoji: '⚡',
+        action: 'continue'
+    },
+    {
+        id: 'choose_provider',
+        title: 'Choose Your Wallet',
+        description: 'Pick a Lightning wallet provider.',
+        emoji: '💳',
+        action: 'select_provider'
+    },
+    {
+        id: 'setup_wallet',
+        title: 'Set Up Your Wallet',
+        description: 'Follow the guide to create your wallet.',
+        emoji: '🛠️',
+        action: 'external_setup'
+    },
+    {
+        id: 'enter_address',
+        title: 'Enter Your Lightning Address',
+        description: 'Paste your Lightning address (e.g., you@getalby.com)',
+        emoji: '📧',
+        action: 'input_address'
+    },
+    {
+        id: 'verify',
+        title: 'Verify Connection',
+        description: 'We\'ll verify your wallet can receive payments.',
+        emoji: '✅',
+        action: 'verify'
+    },
+    {
+        id: 'complete',
+        title: 'Wallet Connected!',
+        description: 'You\'re ready to buy credits and start trading.',
+        emoji: '🎉',
+        action: 'complete'
+    }
+];

package/dist/wallet/wizard.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Wallet Setup Wizard
+ *
+ * Interactive guide for setting up Lightning wallet
+ * MUST be completed before buying/selling (browsing is free)
+ */
+import { WalletConfig, WalletProvider, WalletSetupProgress } from './types.js';
+export declare class WalletSetupWizard {
+    private progress;
+    private outputHandler;
+    private inputHandler?;
+    private config;
+    constructor(outputHandler?: (message: string) => void, inputHandler?: (prompt: string, options?: string[]) => Promise<string>);
+    private print;
+    private printDivider;
+    private printHeader;
+    private loadProgress;
+    private saveProgress;
+    runIntro(): Promise<void>;
+    runChoosePath(): Promise<'hosted' | 'self-hosted' | 'skip'>;
+    runHostedWalletSetup(): Promise<WalletProvider | null>;
+    /**
+     * Show setup instructions for a specific provider
+     */
+    private showProviderSetup;
+    runSelfHostedSetup(): Promise<boolean>;
+    runEnterAddress(): Promise<string | null>;
+    runVerifyAddress(address: string): Promise<boolean>;
+    runComplete(): Promise<void>;
+    runSkip(): Promise<void>;
+    run(): Promise<{
+        config: WalletConfig | null;
+        skipped: boolean;
+    }>;
+    private waitForContinue;
+    private getInput;
+    private getChoice;
+    getConfig(): WalletConfig | null;
+    getProgress(): WalletSetupProgress;
+}
+export default WalletSetupWizard;