agentvault 1.0.1 → 1.0.5

package/dist/src/wallet/wallet-manager.d.ts

@@ -0,0 +1,222 @@
+/**
+ * Wallet Manager
+ *
+ * Main wallet management module.
+ * Handles wallet creation, storage, and retrieval with per-agent isolation.
+ * Phase 5A: Added canister sync functionality.
+ */
+import type { WalletData, WalletCreationOptions, WalletStorageOptions, HsmWalletCreationOptions } from './types.js';
+/**
+ * Create a new wallet
+ *
+ * @param options - Wallet creation options
+ * @param storageOptions - Storage options
+ * @returns Created wallet data
+ */
+export declare function createWallet(options: WalletCreationOptions, storageOptions?: WalletStorageOptions): WalletData;
+/**
+ * Import wallet from private key
+ *
+ * @param agentId - Agent ID
+ * @param chain - Blockchain type
+ * @param privateKey - Private key (hex)
+ * @param storageOptions - Storage options
+ * @returns Imported wallet data
+ */
+export declare function importWalletFromPrivateKey(agentId: string, chain: string, privateKey: string, storageOptions?: WalletStorageOptions, chainMetadata?: Record<string, unknown>): WalletData;
+/**
+ * Import wallet from seed phrase
+ *
+ * @param agentId - Agent ID
+ * @param chain - Blockchain type
+ * @param seedPhrase - BIP39 seed phrase
+ * @param derivationPath - Optional custom derivation path
+ * @param storageOptions - Storage options
+ * @returns Imported wallet data
+ */
+export declare function importWalletFromSeed(agentId: string, chain: string, seedPhrase: string, derivationPath?: string, storageOptions?: WalletStorageOptions, chainMetadata?: Record<string, unknown>): WalletData;
+/**
+ * Import wallet from mnemonic
+ *
+ * @param agentId - Agent ID
+ * @param chain - Blockchain type
+ * @param mnemonic - BIP39 mnemonic phrase
+ * @param derivationPath - Optional custom derivation path
+ * @param storageOptions - Storage options
+ * @returns Imported wallet data
+ */
+export declare function importWalletFromMnemonic(agentId: string, chain: string, mnemonic: string, derivationPath?: string, storageOptions?: WalletStorageOptions, chainMetadata?: Record<string, unknown>): WalletData;
+/**
+ * Generate new wallet
+ *
+ * @param agentId - Agent ID
+ * @param chain - Blockchain type
+ * @param storageOptions - Storage options
+ * @returns Generated wallet data
+ */
+export declare function generateWallet(agentId: string, chain: string, storageOptions?: WalletStorageOptions): WalletData;
+/**
+ * Get wallet by ID
+ *
+ * @param agentId - Agent ID
+ * @param walletId - Wallet ID
+ * @param storageOptions - Storage options
+ * @returns Wallet data or null if not found
+ */
+export declare function getWallet(agentId: string, walletId: string, storageOptions?: WalletStorageOptions): WalletData | null;
+/**
+ * List all wallets for an agent
+ *
+ * @param agentId - Agent ID
+ * @param storageOptions - Storage options
+ * @returns Array of wallet IDs
+ */
+export declare function listAgentWallets(agentId: string, storageOptions?: WalletStorageOptions): string[];
+/**
+ * Check if wallet exists
+ *
+ * @param agentId - Agent ID
+ * @param walletId - Wallet ID
+ * @param storageOptions - Storage options
+ * @returns True if wallet exists
+ */
+export declare function hasWallet(agentId: string, walletId: string, storageOptions?: WalletStorageOptions): boolean;
+/**
+ * Remove wallet
+ *
+ * @param agentId - Agent ID
+ * @param walletId - Wallet ID
+ * @param storageOptions - Storage options
+ */
+export declare function removeWallet(agentId: string, walletId: string, storageOptions?: WalletStorageOptions): void;
+/**
+ * Clear all wallets for an agent
+ *
+ * @param agentId - Agent ID
+ * @param storageOptions - Storage options
+ */
+export declare function clearAgentWallets(agentId: string, storageOptions?: WalletStorageOptions): void;
+/**
+ * Cache wallet connection
+ *
+ * @param agentId - Agent ID
+ * @param walletId - Wallet ID
+ * @param provider - Provider instance
+ */
+export declare function cacheWalletConnection(agentId: string, walletId: string, provider: any): void;
+/**
+ * Get cached wallet connection
+ *
+ * @param agentId - Agent ID
+ * @param walletId - Wallet ID
+ * @returns Cached provider or undefined
+ */
+export declare function getCachedConnection(agentId: string, walletId: string): any;
+/**
+ * Clear wallet connection cache
+ *
+ * @param agentId - Agent ID
+ * @param walletId - Wallet ID
+ */
+export declare function clearCachedConnection(agentId: string, walletId: string): void;
+/**
+ * Validate seed phrase
+ *
+ * @param seedPhrase - Seed phrase to validate
+ * @returns True if valid
+ */
+export declare function validateSeedPhraseWrapper(seedPhrase: string): boolean;
+/**
+ * Create a wallet whose private key is generated and permanently stored inside
+ * a hardware secure element (Ledger) or Trusted Execution Environment (SGX).
+ *
+ * Security guarantees:
+ *   - The private key is generated inside the secure boundary.
+ *   - The BIP39 mnemonic never exists in this process (Ledger) or is sealed
+ *     inside the enclave (SGX).
+ *   - Only the public key and chain address cross the hardware boundary.
+ *   - The returned WalletData has privateKey=undefined and mnemonic=undefined.
+ *
+ * @param options        - HSM-specific wallet creation options.
+ * @param storageOptions - Where / how to persist the wallet metadata.
+ * @returns WalletData with address/publicKey populated, secrets absent.
+ *
+ * @throws {HsmNotAvailableError}   when device / daemon is unreachable.
+ * @throws {HsmCurveUnsupportedError} when the chain's curve is unsupported.
+ * @throws {HsmOperationError}      on device-level failures.
+ */
+export declare function createWalletWithHsm(options: HsmWalletCreationOptions, storageOptions?: WalletStorageOptions): Promise<WalletData>;
+/**
+ * Sync wallet to canister (register wallet metadata)
+ *
+ * @param agentId - Agent ID
+ * @param walletId - Wallet ID
+ * @param canisterId - Canister ID to sync to
+ * @returns Sync result
+ */
+export declare function syncWalletToCanister(agentId: string, walletId: string, canisterId: string): Promise<{
+    success: boolean;
+    error?: string;
+    registeredAt?: number;
+}>;
+/**
+ * Sync all wallets for an agent to canister
+ *
+ * @param agentId - Agent ID
+ * @param canisterId - Canister ID to sync to
+ * @returns Sync results
+ */
+export declare function syncAgentWallets(agentId: string, canisterId: string): Promise<{
+    synced: string[];
+    failed: {
+        walletId: string;
+        error: string;
+    }[];
+}>;
+/**
+ * Get wallet sync status
+ *
+ * @param agentId - Agent ID
+ * @param walletId - Wallet ID
+ * @param canisterId - Canister ID
+ * @returns Wallet sync status
+ */
+export declare function getWalletSyncStatus(agentId: string, walletId: string, canisterId: string): Promise<{
+    walletId: string;
+    inCanister: boolean;
+    canisterStatus?: any;
+    localExists: boolean;
+    synced: boolean;
+}>;
+/**
+ * List wallets from canister
+ *
+ * @param agentId - Agent ID
+ * @param canisterId - Canister ID
+ * @returns Array of canister wallet info
+ */
+export declare function listCanisterWallets(agentId: string, canisterId: string): Promise<any[]>;
+/**
+ * Deregister wallet from canister
+ *
+ * @param walletId - Wallet ID
+ * @param canisterId - Canister ID
+ * @returns Deregistration result
+ */
+export declare function deregisterWalletFromCanister(walletId: string, canisterId: string): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+/**
+ * Update wallet status in canister
+ *
+ * @param walletId - Wallet ID
+ * @param status - New status
+ * @param canisterId - Canister ID
+ * @returns Update result
+ */
+export declare function updateCanisterWalletStatus(walletId: string, status: 'active' | 'inactive' | 'revoked', canisterId: string): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+//# sourceMappingURL=wallet-manager.d.ts.map

package/dist/src/wallet/wallet-manager.d.ts.map

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