agentvault 1.0.1 → 1.0.5

package/dist/src/wallet/cross-chain-aggregator.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Cross-Chain Aggregator (Phase 5C)
+ *
+ * Executes multiple blockchain transactions in parallel.
+ * Supports independent execution (no atomic rollback) as per user preference.
+ */
+import type { WalletData, TransactionRequest, Transaction, ChainType } from './types.js';
+/**
+ * Multi-chain action
+ */
+export interface MultiChainAction {
+    walletId: string;
+    chain: ChainType;
+    request: TransactionRequest;
+    priority?: 'low' | 'normal' | 'high';
+}
+/**
+ * Cross-chain execution result
+ */
+export interface CrossChainResult {
+    action: MultiChainAction;
+    success: boolean;
+    txHash?: string;
+    error?: string;
+    executedAt: number;
+    duration?: number;
+}
+/**
+ * Aggregated execution results
+ */
+export interface AggregatedResults {
+    total: number;
+    succeeded: number;
+    failed: number;
+    results: CrossChainResult[];
+    duration: number;
+}
+/**
+ * Cross-chain aggregator options
+ */
+export interface AggregatorOptions {
+    maxConcurrency?: number;
+    timeout?: number;
+    continueOnError?: boolean;
+}
+/**
+ * Cross-chain aggregator
+ *
+ * Executes transactions across multiple blockchains in parallel.
+ * Independent execution: No rollback on partial failure.
+ */
+export declare class CrossChainAggregator {
+    private dispatcher;
+    private options;
+    constructor(options?: AggregatorOptions);
+    /**
+     * Execute multiple cross-chain actions
+     *
+     * @param actions - Array of multi-chain actions
+     * @returns Aggregated results
+     */
+    execute(actions: MultiChainAction[]): Promise<AggregatedResults>;
+    /**
+     * Execute actions in parallel with concurrency limit
+     */
+    private executeParallel;
+    /**
+     * Execute a single cross-chain action
+     */
+    private executeAction;
+    /**
+     * Split array into chunks
+     */
+    private chunkArray;
+    /**
+     * Get balances across multiple chains
+     *
+     * @param wallets - Array of wallets to query
+     * @returns Array of balances
+     */
+    getBalances(wallets: WalletData[]): Promise<Array<{
+        wallet: WalletData;
+        amount: string;
+        denomination: string;
+    }>>;
+    /**
+     * Get transaction history across multiple chains
+     *
+     * @param wallets - Array of wallets to query
+     * @param limit - Maximum transactions per wallet
+     * @returns Array of transactions
+     */
+    getMultiChainHistory(wallets: WalletData[], limit?: number): Promise<Transaction[]>;
+    /**
+     * Estimate fees across multiple chains
+     *
+     * @param actions - Array of actions to estimate
+     * @returns Array of fee estimates
+     */
+    estimateFees(actions: MultiChainAction[]): Promise<Array<{
+        action: MultiChainAction;
+        fee: string;
+    }>>;
+    /**
+     * Create cross-chain batch summary
+     *
+     * @param results - Aggregated execution results
+     * @returns Formatted summary
+     */
+    createSummary(results: AggregatedResults): string;
+}
+/**
+ * Create cross-chain aggregator
+ *
+ * @param options - Aggregator options
+ * @returns Cross-chain aggregator instance
+ */
+export declare function createCrossChainAggregator(options?: AggregatorOptions): CrossChainAggregator;
+//# sourceMappingURL=cross-chain-aggregator.d.ts.map

package/dist/src/wallet/cross-chain-aggregator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-chain-aggregator.d.ts","sourceRoot":"","sources":["../../../src/wallet/cross-chain-aggregator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAGzF;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,SAAS,CAAC;IACjB,OAAO,EAAE,kBAAkB,CAAC;IAC5B,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,gBAAgB,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;GAKG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,OAAO,CAAoB;gBAEvB,OAAO,CAAC,EAAE,iBAAiB;IASvC;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAmCtE;;OAEG;YACW,eAAe;IA6B7B;;OAEG;YACW,aAAa;IAyC3B;;OAEG;IACH,OAAO,CAAC,UAAU;IAUlB;;;;;OAKG;IACG,WAAW,CACf,OAAO,EAAE,UAAU,EAAE,GACpB,OAAO,CAAC,KAAK,CAAC;QAAE,MAAM,EAAE,UAAU,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IA0B/E;;;;;;OAMG;IACG,oBAAoB,CACxB,OAAO,EAAE,UAAU,EAAE,EACrB,KAAK,GAAE,MAAW,GACjB,OAAO,CAAC,WAAW,EAAE,CAAC;IAkBzB;;;;;OAKG;IACG,YAAY,CAChB,OAAO,EAAE,gBAAgB,EAAE,GAC1B,OAAO,CAAC,KAAK,CAAC;QAAE,MAAM,EAAE,gBAAgB,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAgC5D;;;;;OAKG;IACH,aAAa,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM;CAwBlD;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,CAAC,EAAE,iBAAiB,GAC1B,oBAAoB,CAEtB"}

package/dist/src/wallet/cross-chain-aggregator.js

@@ -0,0 +1,235 @@
+/**
+ * Cross-Chain Aggregator (Phase 5C)
+ *
+ * Executes multiple blockchain transactions in parallel.
+ * Supports independent execution (no atomic rollback) as per user preference.
+ */
+import { ChainDispatcher } from './chain-dispatcher.js';
+/**
+ * Cross-chain aggregator
+ *
+ * Executes transactions across multiple blockchains in parallel.
+ * Independent execution: No rollback on partial failure.
+ */
+export class CrossChainAggregator {
+    dispatcher;
+    options;
+    constructor(options) {
+        this.dispatcher = new ChainDispatcher();
+        this.options = {
+            maxConcurrency: options?.maxConcurrency ?? 5,
+            timeout: options?.timeout ?? 30000,
+            continueOnError: options?.continueOnError ?? true,
+        };
+    }
+    /**
+     * Execute multiple cross-chain actions
+     *
+     * @param actions - Array of multi-chain actions
+     * @returns Aggregated results
+     */
+    async execute(actions) {
+        const startTime = Date.now();
+        if (actions.length === 0) {
+            return {
+                total: 0,
+                succeeded: 0,
+                failed: 0,
+                results: [],
+                duration: 0,
+            };
+        }
+        console.log(`Executing ${actions.length} cross-chain actions...`);
+        const results = await this.executeParallel(actions);
+        const succeeded = results.filter((r) => r.success).length;
+        const failed = results.filter((r) => !r.success).length;
+        const duration = Date.now() - startTime;
+        console.log(`Execution complete: ${succeeded} succeeded, ${failed} failed (${duration}ms)`);
+        return {
+            total: results.length,
+            succeeded,
+            failed,
+            results,
+            duration,
+        };
+    }
+    /**
+     * Execute actions in parallel with concurrency limit
+     */
+    async executeParallel(actions) {
+        const results = [];
+        const chunks = this.chunkArray(actions, this.options.maxConcurrency ?? 5);
+        for (const chunk of chunks) {
+            const chunkResults = await Promise.all(chunk.map((action) => this.executeAction(action)));
+            results.push(...chunkResults);
+            if (!this.options.continueOnError) {
+                const hasFailure = chunkResults.some((r) => !r.success);
+                if (hasFailure) {
+                    console.log('Stopping due to failure (continueOnError = false)');
+                    break;
+                }
+            }
+        }
+        return results;
+    }
+    /**
+     * Execute a single cross-chain action
+     */
+    async executeAction(action) {
+        const startTime = Date.now();
+        try {
+            const { getWallet } = await import('./wallet-manager.js');
+            const wallet = getWallet('', action.walletId);
+            if (!wallet) {
+                throw new Error(`Wallet not found: ${action.walletId}`);
+            }
+            const tx = await this.dispatcher.dispatchTransaction(wallet, action.request);
+            const duration = Date.now() - startTime;
+            return {
+                action,
+                success: true,
+                txHash: tx.hash,
+                executedAt: Date.now(),
+                duration,
+            };
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            return {
+                action,
+                success: false,
+                error: message,
+                executedAt: Date.now(),
+                duration,
+            };
+        }
+    }
+    /**
+     * Split array into chunks
+     */
+    chunkArray(array, size) {
+        const chunks = [];
+        for (let i = 0; i < array.length; i += size) {
+            chunks.push(array.slice(i, i + size));
+        }
+        return chunks;
+    }
+    /**
+     * Get balances across multiple chains
+     *
+     * @param wallets - Array of wallets to query
+     * @returns Array of balances
+     */
+    async getBalances(wallets) {
+        const results = await Promise.all(wallets.map(async (wallet) => {
+            try {
+                const balance = await this.dispatcher.getBalance(wallet);
+                return {
+                    wallet,
+                    amount: balance.amount,
+                    denomination: balance.denomination,
+                    success: true,
+                };
+            }
+            catch (error) {
+                return {
+                    wallet,
+                    amount: '0',
+                    denomination: 'N/A',
+                    success: false,
+                    error: error instanceof Error ? error.message : 'Unknown error',
+                };
+            }
+        }));
+        return results;
+    }
+    /**
+     * Get transaction history across multiple chains
+     *
+     * @param wallets - Array of wallets to query
+     * @param limit - Maximum transactions per wallet
+     * @returns Array of transactions
+     */
+    async getMultiChainHistory(wallets, limit = 20) {
+        const results = await Promise.all(wallets.map(async (wallet) => {
+            try {
+                return await this.dispatcher.getTransactionHistory(wallet, limit);
+            }
+            catch (error) {
+                console.error(`Failed to get history for ${wallet.id}:`, error);
+                return [];
+            }
+        }));
+        return results.flat().slice(0, wallets.length * limit);
+    }
+    /**
+     * Estimate fees across multiple chains
+     *
+     * @param actions - Array of actions to estimate
+     * @returns Array of fee estimates
+     */
+    async estimateFees(actions) {
+        const results = await Promise.all(actions.map(async (action) => {
+            try {
+                const { getWallet } = await import('./wallet-manager.js');
+                const wallet = getWallet('', action.walletId);
+                if (!wallet) {
+                    throw new Error(`Wallet not found: ${action.walletId}`);
+                }
+                const fee = await this.dispatcher.estimateFee(wallet, action.request);
+                return {
+                    action,
+                    fee,
+                    success: true,
+                };
+            }
+            catch (error) {
+                return {
+                    action,
+                    fee: 'N/A',
+                    success: false,
+                    error: error instanceof Error ? error.message : 'Unknown error',
+                };
+            }
+        }));
+        return results;
+    }
+    /**
+     * Create cross-chain batch summary
+     *
+     * @param results - Aggregated execution results
+     * @returns Formatted summary
+     */
+    createSummary(results) {
+        const lines = [];
+        lines.push('Cross-Chain Execution Summary');
+        lines.push('============================');
+        lines.push(`Total Actions:    ${results.total}`);
+        lines.push(`Succeeded:         ${results.succeeded}`);
+        lines.push(`Failed:            ${results.failed}`);
+        lines.push(`Success Rate:      ${results.total > 0 ? ((results.succeeded / results.total) * 100).toFixed(2) : 0}%`);
+        lines.push(`Total Duration:    ${results.duration}ms`);
+        if (results.failed > 0) {
+            lines.push('');
+            lines.push('Failed Actions:');
+            results.results
+                .filter((r) => !r.success)
+                .forEach((r) => {
+                lines.push(`  [${r.action.chain}] ${r.action.walletId}`);
+                lines.push(`    Error: ${r.error}`);
+            });
+        }
+        return lines.join('\n');
+    }
+}
+/**
+ * Create cross-chain aggregator
+ *
+ * @param options - Aggregator options
+ * @returns Cross-chain aggregator instance
+ */
+export function createCrossChainAggregator(options) {
+    return new CrossChainAggregator(options);
+}
+//# sourceMappingURL=cross-chain-aggregator.js.map

package/dist/src/wallet/cross-chain-aggregator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-chain-aggregator.js","sourceRoot":"","sources":["../../../src/wallet/cross-chain-aggregator.ts"],"names":[],"mappings":"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"}

package/dist/src/wallet/hsm/index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * HSM / TEE Keygen Module
+ *
+ * Exports the public API for hardware-backed key generation.
+ *
+ * Quick-start:
+ *
+ *   import { createHsmProvider, isHsmAvailable } from './hsm/index.js';
+ *
+ *   const available = await isHsmAvailable('ledger');
+ *   if (available) {
+ *     const provider = await createHsmProvider('ledger');
+ *     // provider.getPublicKey() never exposes private key material
+ *   }
+ */
+export type { HsmBackend, HsmCurve, HsmProvider, HsmPublicKeyResult, HsmSignatureResult, HsmWalletMetadata, } from './types.js';
+export { HsmError, HsmNotAvailableError, HsmCurveUnsupportedError, HsmOperationError, } from './types.js';
+export { LedgerHsmProvider, isLedgerAvailable } from './ledger-provider.js';
+export { SgxHsmProvider, isSgxAvailable } from './sgx-provider.js';
+import type { HsmBackend, HsmProvider } from './types.js';
+/**
+ * Probe whether the given HSM backend is reachable without fully opening it.
+ *
+ * @param backend - 'ledger' or 'sgx'
+ * @returns `true` if the backend appears available.
+ */
+export declare function isHsmAvailable(backend: HsmBackend): Promise<boolean>;
+/**
+ * Instantiate and open an HSM provider for the given backend.
+ *
+ * The returned provider is already open (open() has been called).
+ * The caller is responsible for calling close() when done.
+ *
+ * @param backend - Which hardware backend to use ('ledger' | 'sgx').
+ * @param options - Backend-specific options (socketPath, enclavePath, …).
+ * @throws {HsmNotAvailableError} when the backend cannot be opened.
+ */
+export declare function createHsmProvider(backend: HsmBackend, options?: Record<string, string>): Promise<HsmProvider>;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/wallet/hsm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/wallet/hsm/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,YAAY,EACV,UAAU,EACV,QAAQ,EACR,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAMnE,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAK1D;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAI1E;AAED;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,UAAU,EACnB,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACnC,OAAO,CAAC,WAAW,CAAC,CAatB"}

package/dist/src/wallet/hsm/index.js

@@ -0,0 +1,60 @@
+/**
+ * HSM / TEE Keygen Module
+ *
+ * Exports the public API for hardware-backed key generation.
+ *
+ * Quick-start:
+ *
+ *   import { createHsmProvider, isHsmAvailable } from './hsm/index.js';
+ *
+ *   const available = await isHsmAvailable('ledger');
+ *   if (available) {
+ *     const provider = await createHsmProvider('ledger');
+ *     // provider.getPublicKey() never exposes private key material
+ *   }
+ */
+export { HsmError, HsmNotAvailableError, HsmCurveUnsupportedError, HsmOperationError, } from './types.js';
+// Providers
+export { LedgerHsmProvider, isLedgerAvailable } from './ledger-provider.js';
+export { SgxHsmProvider, isSgxAvailable } from './sgx-provider.js';
+import { HsmNotAvailableError } from './types.js';
+import { LedgerHsmProvider, isLedgerAvailable } from './ledger-provider.js';
+import { SgxHsmProvider, isSgxAvailable } from './sgx-provider.js';
+/**
+ * Probe whether the given HSM backend is reachable without fully opening it.
+ *
+ * @param backend - 'ledger' or 'sgx'
+ * @returns `true` if the backend appears available.
+ */
+export async function isHsmAvailable(backend) {
+    if (backend === 'ledger')
+        return isLedgerAvailable();
+    if (backend === 'sgx')
+        return isSgxAvailable();
+    return false;
+}
+/**
+ * Instantiate and open an HSM provider for the given backend.
+ *
+ * The returned provider is already open (open() has been called).
+ * The caller is responsible for calling close() when done.
+ *
+ * @param backend - Which hardware backend to use ('ledger' | 'sgx').
+ * @param options - Backend-specific options (socketPath, enclavePath, …).
+ * @throws {HsmNotAvailableError} when the backend cannot be opened.
+ */
+export async function createHsmProvider(backend, options = {}) {
+    let provider;
+    if (backend === 'ledger') {
+        provider = new LedgerHsmProvider();
+    }
+    else if (backend === 'sgx') {
+        provider = new SgxHsmProvider(options);
+    }
+    else {
+        throw new HsmNotAvailableError(backend, `Unknown backend: ${backend}`);
+    }
+    await provider.open();
+    return provider;
+}
+//# sourceMappingURL=index.js.map

package/dist/src/wallet/hsm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/wallet/hsm/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAYH,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB,YAAY;AACZ,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAOnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnE;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAmB;IACtD,IAAI,OAAO,KAAK,QAAQ;QAAE,OAAO,iBAAiB,EAAE,CAAC;IACrD,IAAI,OAAO,KAAK,KAAK;QAAE,OAAO,cAAc,EAAE,CAAC;IAC/C,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAmB,EACnB,UAAkC,EAAE;IAEpC,IAAI,QAAqB,CAAC;IAE1B,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzB,QAAQ,GAAG,IAAI,iBAAiB,EAAE,CAAC;IACrC,CAAC;SAAM,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;QAC7B,QAAQ,GAAG,IAAI,cAAc,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,oBAAoB,CAAC,OAAqB,EAAE,oBAAoB,OAAO,EAAE,CAAC,CAAC;IACvF,CAAC;IAED,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IACtB,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/src/wallet/hsm/ledger-provider.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Ledger Hardware Wallet HSM Provider
+ *
+ * Offloads key generation and signing to a Ledger hardware wallet over USB HID.
+ * The device generates keys internally from its BIP39 seed phrase, which is
+ * entered on the physical keypad and NEVER transmitted to the host machine.
+ *
+ * Security properties:
+ *   - Private key is generated inside the Secure Element and never leaves it.
+ *   - BIP39 mnemonic is air-gapped on the device (entered via physical buttons).
+ *   - The host receives ONLY the derived public key and chain address.
+ *   - Transaction signing: the host sends an unsigned digest; the device returns
+ *     only the signature bytes.
+ *   - RAM dumps of the host process contain zero key material.
+ *
+ * Supported chains / apps (Ledger app must be open on device):
+ *   secp256k1: Ethereum app  → ckETH, Polkadot (ECDSA mode)
+ *   ed25519:   Solana app    → Solana, ICP, Arweave
+ *
+ * Dependencies (optional peer deps, dynamically imported):
+ *   @ledgerhq/hw-transport-node-hid  – USB HID transport
+ *   @ledgerhq/hw-app-eth             – Ethereum APDU client
+ *   @ledgerhq/hw-app-solana          – Solana APDU client
+ *
+ * Install with:
+ *   npm install @ledgerhq/hw-transport-node-hid @ledgerhq/hw-app-eth @ledgerhq/hw-app-solana
+ */
+import type { HsmProvider, HsmBackend, HsmCurve, HsmPublicKeyResult, HsmSignatureResult } from './types.js';
+/**
+ * HSM provider that delegates all key operations to a connected Ledger device.
+ *
+ * Usage:
+ * ```ts
+ * const ledger = new LedgerHsmProvider();
+ * await ledger.open();                          // connects over USB HID
+ * const { address } = await ledger.getPublicKey("m/44'/60'/0'/0/0", 'secp256k1');
+ * await ledger.close();
+ * ```
+ */
+export declare class LedgerHsmProvider implements HsmProvider {
+    readonly name = "Ledger Hardware Wallet";
+    readonly backend: HsmBackend;
+    readonly supportedCurves: ReadonlyArray<HsmCurve>;
+    private _transport;
+    private _deviceProduct;
+    private _deviceSerial;
+    open(): Promise<void>;
+    close(): Promise<void>;
+    getPublicKey(derivationPath: string, curve: HsmCurve): Promise<HsmPublicKeyResult>;
+    /**
+     * Retrieve secp256k1 public key from the Ledger Ethereum app.
+     * The device derives the key at `path` from its internal seed and returns
+     * only the public key + EIP-55 address.  No private key is transmitted.
+     */
+    private _getEthPublicKey;
+    /**
+     * Retrieve Ed25519 public key from the Ledger Solana app.
+     * Works for Solana, ICP, and Arweave (all use Ed25519).
+     * The host receives only the 32-byte public key; the private key stays sealed.
+     */
+    private _getSolanaPublicKey;
+    signDigest(derivationPath: string, digestHex: string, curve: HsmCurve): Promise<HsmSignatureResult>;
+    private _signEth;
+    private _signSolana;
+    deviceId(): Promise<string>;
+    private _assertOpen;
+}
+/**
+ * Quick check: is a Ledger device currently connected and unlocked?
+ *
+ * @returns `true` if at least one HID device is enumerable, `false` otherwise.
+ *          Does NOT verify that any particular Ledger app is open.
+ */
+export declare function isLedgerAvailable(): Promise<boolean>;
+//# sourceMappingURL=ledger-provider.d.ts.map

package/dist/src/wallet/hsm/ledger-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger-provider.d.ts","sourceRoot":"","sources":["../../../../src/wallet/hsm/ledger-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EACV,QAAQ,EACR,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAsCpB;;;;;;;;;;GAUG;AACH,qBAAa,iBAAkB,YAAW,WAAW;IACnD,QAAQ,CAAC,IAAI,4BAA4B;IACzC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAY;IACxC,QAAQ,CAAC,eAAe,EAAE,aAAa,CAAC,QAAQ,CAAC,CAA4B;IAE7E,OAAO,CAAC,UAAU,CAAgC;IAClD,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,aAAa,CAAuB;IAMtC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAgDrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAWtB,YAAY,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAqBxF;;;;OAIG;YACW,gBAAgB;IA0B9B;;;;OAIG;YACW,mBAAmB;IAiC3B,UAAU,CACd,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,QAAQ,GACd,OAAO,CAAC,kBAAkB,CAAC;YAqBhB,QAAQ;YAuBR,WAAW;IAuBnB,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;IASjC,OAAO,CAAC,WAAW;CAQpB;AAMD;;;;;GAKG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC,CAS1D"}