@unicitylabs/sphere-sdk 0.12.0 → 0.13.0

package/dist/core/index.d.cts

@@ -7834,6 +7834,10 @@ declare class Sphere {
     private _masterKey;
     private _mnemonic;
     private _password;
+    /** True when the wallet was created/loaded/imported WITH a password. Distinguishes
+     *  "no password by design" (encrypt passes through) from "the password is gone" (encrypt
+     *  must throw rather than silently write plaintext over an encrypted record). */
+    private _passwordProtected;
     private _source;
     private _derivationMode;
     private _basePath;

package/dist/core/index.d.ts

@@ -7834,6 +7834,10 @@ declare class Sphere {
     private _masterKey;
     private _mnemonic;
     private _password;
+    /** True when the wallet was created/loaded/imported WITH a password. Distinguishes
+     *  "no password by design" (encrypt passes through) from "the password is gone" (encrypt
+     *  must throw rather than silently write plaintext over an encrypted record). */
+    private _passwordProtected;
     private _source;
     private _derivationMode;
     private _basePath;

package/dist/core/index.js

@@ -10754,6 +10754,7 @@ var PaymentsModule = class _PaymentsModule {
     this.spendQueue.destroy();
     this.reservationLedger.clear();
     this.parsedTokenCache.clear();
+    this.tokens.clear();
     this.unsubscribeStorageEvents();
   }
   // ===========================================================================
@@ -26707,6 +26708,10 @@ var Sphere = class _Sphere {
   _masterKey = null;
   _mnemonic = null;
   _password = null;
+  /** True when the wallet was created/loaded/imported WITH a password. Distinguishes
+   *  "no password by design" (encrypt passes through) from "the password is gone" (encrypt
+   *  must throw rather than silently write plaintext over an encrypted record). */
+  _passwordProtected = false;
   _source = "unknown";
   _derivationMode = "bip32";
   _basePath = DEFAULT_BASE_PATH;
@@ -27035,6 +27040,7 @@ var Sphere = class _Sphere {
       options.walletApi
     );
     sphere._password = options.password ?? null;
+    sphere._passwordProtected = sphere._password !== null;
     progress?.({ step: "storing_keys", message: "Storing wallet keys..." });
     await sphere.storeMnemonic(options.mnemonic, options.derivationPath);
     await sphere.initializeIdentityFromMnemonic(options.mnemonic, options.derivationPath);
@@ -27099,6 +27105,7 @@ var Sphere = class _Sphere {
       options.walletApi
     );
     sphere._password = options.password ?? null;
+    sphere._passwordProtected = sphere._password !== null;
     if (!options.storage.isConnected()) {
       await options.storage.connect();
     }
@@ -27170,6 +27177,7 @@ var Sphere = class _Sphere {
       options.walletApi
     );
     sphere._password = options.password ?? null;
+    sphere._passwordProtected = sphere._password !== null;
     progress?.({ step: "storing_keys", message: "Storing wallet keys..." });
     if (options.mnemonic) {
       if (!_Sphere.validateMnemonic(options.mnemonic)) {
@@ -27526,6 +27534,7 @@ var Sphere = class _Sphere {
    * Check if wallet has BIP32 master key for HD derivation
    */
   hasMasterKey() {
+    this.ensureReady();
     return this._masterKey !== null;
   }
   // ===========================================================================
@@ -27555,12 +27564,14 @@ var Sphere = class _Sphere {
    * Returns null if wallet was imported from file (masterKey only)
    */
   getMnemonic() {
+    this.ensureReady();
     return this._mnemonic;
   }
   /**
    * Get wallet info for backup/export purposes
    */
   getWalletInfo() {
+    this.ensureReady();
     let address0 = null;
     try {
       if (this._identity) {
@@ -29349,6 +29360,9 @@ var Sphere = class _Sphere {
     this._initialized = false;
     this._trackedAddressesLoaded = false;
     this._identity = null;
+    this._mnemonic = null;
+    this._masterKey = null;
+    this._password = null;
     this._trackedAddresses.clear();
     this._addressIdToIndex.clear();
     this._addressNametags.clear();
@@ -29834,7 +29848,12 @@ var Sphere = class _Sphere {
   // Private: Encryption
   // ===========================================================================
   encrypt(data) {
-    if (!this._password) return data;
+    if (!this._password) {
+      if (this._passwordProtected) {
+        throw new SphereError("Wallet password is not available", "NOT_INITIALIZED");
+      }
+      return data;
+    }
     return encryptSimple(data, this._password);
   }
   decrypt(encrypted) {