@btc-vision/wallet-sdk 2.0.3 → 2.0.5

package/dist/index.d.ts

@@ -471,9 +471,17 @@ export declare class LocalWallet implements AbstractWallet {
      */
     exportPrivateKey(): string;
     /**
-     * Export the quantum private key
+     * Export the quantum private key WITH chain code (for backup/restore)
      */
     exportQuantumPrivateKey(): string;
+    /**
+     * Export the raw quantum private key WITHOUT chain code (for Wallet.fromWif)
+     */
+    exportRawQuantumPrivateKey(): string;
+    /**
+     * Export the chain code
+     */
+    exportChainCode(): Buffer;
     /**
      * Export WIF
      */
@@ -644,15 +652,21 @@ export declare class SimpleKeyring {
      */
     static generate(network?: Network, securityLevel?: MLDSASecurityLevel): SimpleKeyring;
     /**
-     * Import from WIF (Wallet Import Format) with mandatory quantum key
+     * Import from WIF (Wallet Import Format) with optional quantum key.
+     * If no quantum key is provided, the keyring will NOT have a quantum keypair.
+     * The quantum key must be explicitly set later via importQuantumKey() or generateFreshQuantumKey().
      */
     static fromWIF(wif: string, quantumPrivateKey: string | undefined, network?: Network, securityLevel?: MLDSASecurityLevel): SimpleKeyring;
     /**
-     * Import from hex private key with mandatory quantum key
+     * Import from hex private key with optional quantum key.
+     * If no quantum key is provided, the keyring will NOT have a quantum keypair.
+     * The quantum key must be explicitly set later via importQuantumKey() or generateFreshQuantumKey().
      */
     static fromPrivateKey(privateKeyHex: string, quantumPrivateKey: string | undefined, network?: Network, securityLevel?: MLDSASecurityLevel): SimpleKeyring;
     /**
-     * Import a private key (WIF or hex format)
+     * Import a private key (WIF or hex format).
+     * If no quantum key is provided, the keyring will NOT have a quantum keypair.
+     * The quantum key must be explicitly set later via importQuantumKey() or generateFreshQuantumKey().
      */
     importPrivateKey(privateKey: string, quantumPrivateKey?: string): void;
     /**
@@ -664,9 +678,21 @@ export declare class SimpleKeyring {
      */
     generateFreshQuantumKey(): void;
     /**
-     * Check if keyring has keys
+     * Check if keyring has both classical and quantum keys
      */
     hasKeys(): boolean;
+    /**
+     * Check if keyring has the classical keypair (may or may not have quantum key)
+     */
+    hasClassicalKey(): boolean;
+    /**
+     * Check if keyring has a quantum keypair
+     */
+    hasQuantumKey(): boolean;
+    /**
+     * Check if quantum migration is needed (has classical but no quantum key)
+     */
+    needsQuantumMigration(): boolean;
     /**
      * Get the classical public key
      */
@@ -679,6 +705,10 @@ export declare class SimpleKeyring {
      * Get the quantum public key hash (universal identifier)
      */
     getQuantumPublicKeyHash(): string;
+    /**
+     * Clear the quantum keypair (used for reverting failed imports)
+     */
+    clearQuantumKey(): void;
     /**
      * Get all accounts (returns array with single public key)
      */
@@ -696,9 +726,17 @@ export declare class SimpleKeyring {
      */
     exportPrivateKey(): string;
     /**
-     * Export the quantum private key with chain code
+     * Export the quantum private key with chain code (for backup/restore)
      */
     exportQuantumPrivateKey(): string;
+    /**
+     * Export the raw quantum private key WITHOUT chain code (for Wallet.fromWif)
+     */
+    exportRawQuantumPrivateKey(): string;
+    /**
+     * Export the chain code (for use with Wallet.fromWif separately)
+     */
+    exportChainCode(): Buffer;
     /**
      * Export WIF format
      */