@0xsequence/provider 0.38.2 → 0.39.0

package/dist/0xsequence-provider.cjs.dev.js

@@ -1703,7 +1703,7 @@ const hexlifyTransaction = (transaction, allowExtra) => {
   return result;
 };
 
-const eip191prefix = ethers.ethers.utils.toUtf8Bytes("\x19Ethereum Signed Message:\n");
+const eip191prefix = ethers.ethers.utils.toUtf8Bytes('\x19Ethereum Signed Message:\n');
 const messageToBytes = message => {
   if (ethers.ethers.utils.isBytes(message) || ethers.ethers.utils.isHexString(message)) {
     return ethers.ethers.utils.arrayify(message);
@@ -1799,8 +1799,29 @@ const isWalletUpToDate = async (signer, chainId) => {
 
   const isUpToDate = config.isConfigEqual(authChainConfig, requiredChainConfig);
   return isDeployed && isUpToDate;
-}; // window.localstorage helper
+};
+class LocalStorage {
+  constructor() {}
+
+  static getInstance() {
+    if (!LocalStorage._instance) {
+      LocalStorage._instance = {
+        getItem: key => Promise.resolve(window.localStorage.getItem(key)),
+        setItem: (key, value) => Promise.resolve(window.localStorage.setItem(key, value)),
+        removeItem: key => Promise.resolve(window.localStorage.removeItem(key))
+      };
+    }
+
+    return this._instance;
+  }
+
+  static use(instance) {
+    LocalStorage._instance = instance;
+  }
 
+} // window.localstorage helper
+
+LocalStorage._instance = void 0;
 class LocalStore {
   constructor(key, def) {
     this.def = def;
@@ -1808,8 +1829,8 @@ class LocalStore {
     this.key = key;
   }
 
-  get() {
-    const val = window.localStorage.getItem(this.key);
+  async get() {
+    const val = await LocalStorage.getInstance().getItem(this.key);
 
     if (val === null) {
       return this.def;
@@ -1825,11 +1846,11 @@ class LocalStore {
   }
 
   set(val) {
-    val ? window.localStorage.setItem(this.key, JSON.stringify(val)) : window.localStorage.removeItem(this.key);
+    val ? LocalStorage.getInstance().setItem(this.key, JSON.stringify(val)) : LocalStorage.getInstance().removeItem(this.key);
   }
 
   del() {
-    window.localStorage.removeItem(this.key);
+    LocalStorage.getInstance().removeItem(this.key);
   }
 
 }
@@ -2052,11 +2073,11 @@ class BaseWalletTransport {
     };
 
     this.saveTransportSession = session => {
-      window.localStorage.setItem(TRANSPORT_SESSION_LS_KEY, JSON.stringify(session));
+      LocalStorage.getInstance().setItem(TRANSPORT_SESSION_LS_KEY, JSON.stringify(session));
     };
 
-    this.getCachedTransportSession = () => {
-      const session = window.localStorage.getItem(TRANSPORT_SESSION_LS_KEY);
+    this.getCachedTransportSession = async function () {
+      const session = await LocalStorage.getInstance().getItem(TRANSPORT_SESSION_LS_KEY);
 
       try {
         return session ? JSON.parse(session) : null;
@@ -2433,14 +2454,14 @@ class ProxyMessageHandler extends BaseWalletTransport {
     this._registered = true;
   } // note: we can't decide whether to restore the session within register(), because session info is
   // received asyncronously via EventType.OPEN after register() is executed.
-  // And in the case of a redirect/reload, EventType.OPEN is not sent at all, 
+  // And in the case of a redirect/reload, EventType.OPEN is not sent at all,
   // because the wallet is already open.
   //
   // call this method from wallet redirect hander when a session restore is needed
 
 
-  restoreSession() {
-    const cachedSession = this.getCachedTransportSession();
+  async restoreSession() {
+    const cachedSession = await this.getCachedTransportSession();
 
     if (cachedSession) {
       this.open(cachedSession);
@@ -2864,7 +2885,7 @@ class WindowMessageHandler extends BaseWalletTransport {
     this._init = exports.InitState.NIL;
   }
 
-  register(windowHref) {
+  async register(windowHref) {
     const isPopup = parent.window.opener !== null;
     this._isPopup = isPopup;
 
@@ -2882,7 +2903,7 @@ class WindowMessageHandler extends BaseWalletTransport {
     const isNewWindowSession = !!session.sessionId; // attempt to restore previous session in the case of a redirect or window reload
 
     if (!isNewWindowSession) {
-      session = this.getCachedTransportSession();
+      session = await this.getCachedTransportSession();
     }
 
     if (!session) {
@@ -3326,11 +3347,11 @@ class Wallet {
         }, true);
       }); // Load existing session from localStorage
 
-      const session = this.loadSession();
-
-      if (session) {
-        this.useSession(session, false);
-      }
+      this.loadSession().then(session => {
+        if (session) {
+          this.useSession(session, false);
+        }
+      });
     };
 
     this.connect = async function (options) {
@@ -3464,8 +3485,8 @@ class Wallet {
       this.transport.messageProvider.closeWallet();
     };
 
-    this.loadSession = () => {
-      const data = window.localStorage.getItem('@sequence.session');
+    this.loadSession = async function () {
+      const data = await LocalStorage.getInstance().getItem('@sequence.session');
 
       if (!data || data === '') {
         return undefined;
@@ -3483,7 +3504,7 @@ class Wallet {
     this.saveSession = session => {
       utils.logger.debug('wallet provider: saving session');
       const data = JSON.stringify(session);
-      window.localStorage.setItem('@sequence.session', data);
+      LocalStorage.getInstance().setItem('@sequence.session', data);
     };
 
     this.useSession = async function (session, autoSave = true) {
@@ -3530,6 +3551,10 @@ class Wallet {
       this.config.defaultNetworkId = 'mainnet';
     }
 
+    if (config != null && config.localStorage) {
+      LocalStorage.use(config.localStorage);
+    }
+
     this.transport = {};
     this.networks = [];
     this.providers = {};
@@ -3538,9 +3563,9 @@ class Wallet {
     this.init();
   }
 
-  addConnectedSite(origin) {
+  async addConnectedSite(origin) {
     origin = origin || window.location.origin;
-    const connectedSites = this.connectedSites.get();
+    const connectedSites = await this.connectedSites.get();
 
     if (connectedSites) {
       if (connectedSites.includes(origin)) {
@@ -3553,8 +3578,8 @@ class Wallet {
     }
   }
 
-  removeConnectedSite(origin) {
-    const authorized = this.connectedSites.get();
+  async removeConnectedSite(origin) {
+    const authorized = await this.connectedSites.get();
 
     if (authorized) {
       this.connectedSites.set(authorized.filter(domain => domain !== origin));
@@ -3565,8 +3590,8 @@ class Wallet {
     return this.connectedSites.get();
   }
 
-  isSiteConnected(origin) {
-    const authorized = this.connectedSites.get();
+  async isSiteConnected(origin) {
+    const authorized = await this.connectedSites.get();
     return !!authorized && authorized.includes(origin || window.location.origin);
   }
 
@@ -3730,7 +3755,7 @@ class Wallet {
     var _this$transport$cache;
 
     utils.logger.debug('wallet provider: clearing session');
-    window.localStorage.removeItem('@sequence.session');
+    LocalStorage.getInstance().removeItem('@sequence.session');
     this.session = undefined;
     this.networks = [];
     this.providers = {};
@@ -3759,6 +3784,7 @@ exports.DefaultProviderConfig = DefaultProviderConfig;
 exports.ErrSignedInRequired = ErrSignedInRequired;
 exports.ExtensionMessageHandler = ExtensionMessageHandler;
 exports.ExtensionMessageProvider = ExtensionMessageProvider;
+exports.LocalStorage = LocalStorage;
 exports.LocalStore = LocalStore;
 exports.LocalWeb3Provider = LocalWeb3Provider;
 exports.MuxMessageProvider = MuxMessageProvider;

package/dist/0xsequence-provider.cjs.prod.js

@@ -1703,7 +1703,7 @@ const hexlifyTransaction = (transaction, allowExtra) => {
   return result;
 };
 
-const eip191prefix = ethers.ethers.utils.toUtf8Bytes("\x19Ethereum Signed Message:\n");
+const eip191prefix = ethers.ethers.utils.toUtf8Bytes('\x19Ethereum Signed Message:\n');
 const messageToBytes = message => {
   if (ethers.ethers.utils.isBytes(message) || ethers.ethers.utils.isHexString(message)) {
     return ethers.ethers.utils.arrayify(message);
@@ -1799,8 +1799,29 @@ const isWalletUpToDate = async (signer, chainId) => {
 
   const isUpToDate = config.isConfigEqual(authChainConfig, requiredChainConfig);
   return isDeployed && isUpToDate;
-}; // window.localstorage helper
+};
+class LocalStorage {
+  constructor() {}
+
+  static getInstance() {
+    if (!LocalStorage._instance) {
+      LocalStorage._instance = {
+        getItem: key => Promise.resolve(window.localStorage.getItem(key)),
+        setItem: (key, value) => Promise.resolve(window.localStorage.setItem(key, value)),
+        removeItem: key => Promise.resolve(window.localStorage.removeItem(key))
+      };
+    }
+
+    return this._instance;
+  }
+
+  static use(instance) {
+    LocalStorage._instance = instance;
+  }
 
+} // window.localstorage helper
+
+LocalStorage._instance = void 0;
 class LocalStore {
   constructor(key, def) {
     this.def = def;
@@ -1808,8 +1829,8 @@ class LocalStore {
     this.key = key;
   }
 
-  get() {
-    const val = window.localStorage.getItem(this.key);
+  async get() {
+    const val = await LocalStorage.getInstance().getItem(this.key);
 
     if (val === null) {
       return this.def;
@@ -1825,11 +1846,11 @@ class LocalStore {
   }
 
   set(val) {
-    val ? window.localStorage.setItem(this.key, JSON.stringify(val)) : window.localStorage.removeItem(this.key);
+    val ? LocalStorage.getInstance().setItem(this.key, JSON.stringify(val)) : LocalStorage.getInstance().removeItem(this.key);
   }
 
   del() {
-    window.localStorage.removeItem(this.key);
+    LocalStorage.getInstance().removeItem(this.key);
   }
 
 }
@@ -2052,11 +2073,11 @@ class BaseWalletTransport {
     };
 
     this.saveTransportSession = session => {
-      window.localStorage.setItem(TRANSPORT_SESSION_LS_KEY, JSON.stringify(session));
+      LocalStorage.getInstance().setItem(TRANSPORT_SESSION_LS_KEY, JSON.stringify(session));
     };
 
-    this.getCachedTransportSession = () => {
-      const session = window.localStorage.getItem(TRANSPORT_SESSION_LS_KEY);
+    this.getCachedTransportSession = async function () {
+      const session = await LocalStorage.getInstance().getItem(TRANSPORT_SESSION_LS_KEY);
 
       try {
         return session ? JSON.parse(session) : null;
@@ -2433,14 +2454,14 @@ class ProxyMessageHandler extends BaseWalletTransport {
     this._registered = true;
   } // note: we can't decide whether to restore the session within register(), because session info is
   // received asyncronously via EventType.OPEN after register() is executed.
-  // And in the case of a redirect/reload, EventType.OPEN is not sent at all, 
+  // And in the case of a redirect/reload, EventType.OPEN is not sent at all,
   // because the wallet is already open.
   //
   // call this method from wallet redirect hander when a session restore is needed
 
 
-  restoreSession() {
-    const cachedSession = this.getCachedTransportSession();
+  async restoreSession() {
+    const cachedSession = await this.getCachedTransportSession();
 
     if (cachedSession) {
       this.open(cachedSession);
@@ -2864,7 +2885,7 @@ class WindowMessageHandler extends BaseWalletTransport {
     this._init = exports.InitState.NIL;
   }
 
-  register(windowHref) {
+  async register(windowHref) {
     const isPopup = parent.window.opener !== null;
     this._isPopup = isPopup;
 
@@ -2882,7 +2903,7 @@ class WindowMessageHandler extends BaseWalletTransport {
     const isNewWindowSession = !!session.sessionId; // attempt to restore previous session in the case of a redirect or window reload
 
     if (!isNewWindowSession) {
-      session = this.getCachedTransportSession();
+      session = await this.getCachedTransportSession();
     }
 
     if (!session) {
@@ -3326,11 +3347,11 @@ class Wallet {
         }, true);
       }); // Load existing session from localStorage
 
-      const session = this.loadSession();
-
-      if (session) {
-        this.useSession(session, false);
-      }
+      this.loadSession().then(session => {
+        if (session) {
+          this.useSession(session, false);
+        }
+      });
     };
 
     this.connect = async function (options) {
@@ -3464,8 +3485,8 @@ class Wallet {
       this.transport.messageProvider.closeWallet();
     };
 
-    this.loadSession = () => {
-      const data = window.localStorage.getItem('@sequence.session');
+    this.loadSession = async function () {
+      const data = await LocalStorage.getInstance().getItem('@sequence.session');
 
       if (!data || data === '') {
         return undefined;
@@ -3483,7 +3504,7 @@ class Wallet {
     this.saveSession = session => {
       utils.logger.debug('wallet provider: saving session');
       const data = JSON.stringify(session);
-      window.localStorage.setItem('@sequence.session', data);
+      LocalStorage.getInstance().setItem('@sequence.session', data);
     };
 
     this.useSession = async function (session, autoSave = true) {
@@ -3530,6 +3551,10 @@ class Wallet {
       this.config.defaultNetworkId = 'mainnet';
     }
 
+    if (config != null && config.localStorage) {
+      LocalStorage.use(config.localStorage);
+    }
+
     this.transport = {};
     this.networks = [];
     this.providers = {};
@@ -3538,9 +3563,9 @@ class Wallet {
     this.init();
   }
 
-  addConnectedSite(origin) {
+  async addConnectedSite(origin) {
     origin = origin || window.location.origin;
-    const connectedSites = this.connectedSites.get();
+    const connectedSites = await this.connectedSites.get();
 
     if (connectedSites) {
       if (connectedSites.includes(origin)) {
@@ -3553,8 +3578,8 @@ class Wallet {
     }
   }
 
-  removeConnectedSite(origin) {
-    const authorized = this.connectedSites.get();
+  async removeConnectedSite(origin) {
+    const authorized = await this.connectedSites.get();
 
     if (authorized) {
       this.connectedSites.set(authorized.filter(domain => domain !== origin));
@@ -3565,8 +3590,8 @@ class Wallet {
     return this.connectedSites.get();
   }
 
-  isSiteConnected(origin) {
-    const authorized = this.connectedSites.get();
+  async isSiteConnected(origin) {
+    const authorized = await this.connectedSites.get();
     return !!authorized && authorized.includes(origin || window.location.origin);
   }
 
@@ -3730,7 +3755,7 @@ class Wallet {
     var _this$transport$cache;
 
     utils.logger.debug('wallet provider: clearing session');
-    window.localStorage.removeItem('@sequence.session');
+    LocalStorage.getInstance().removeItem('@sequence.session');
     this.session = undefined;
     this.networks = [];
     this.providers = {};
@@ -3759,6 +3784,7 @@ exports.DefaultProviderConfig = DefaultProviderConfig;
 exports.ErrSignedInRequired = ErrSignedInRequired;
 exports.ExtensionMessageHandler = ExtensionMessageHandler;
 exports.ExtensionMessageProvider = ExtensionMessageProvider;
+exports.LocalStorage = LocalStorage;
 exports.LocalStore = LocalStore;
 exports.LocalWeb3Provider = LocalWeb3Provider;
 exports.MuxMessageProvider = MuxMessageProvider;

package/dist/0xsequence-provider.esm.js

@@ -1699,7 +1699,7 @@ const hexlifyTransaction = (transaction, allowExtra) => {
   return result;
 };
 
-const eip191prefix = ethers.utils.toUtf8Bytes("\x19Ethereum Signed Message:\n");
+const eip191prefix = ethers.utils.toUtf8Bytes('\x19Ethereum Signed Message:\n');
 const messageToBytes = message => {
   if (ethers.utils.isBytes(message) || ethers.utils.isHexString(message)) {
     return ethers.utils.arrayify(message);
@@ -1795,8 +1795,29 @@ const isWalletUpToDate = async (signer, chainId) => {
 
   const isUpToDate = isConfigEqual(authChainConfig, requiredChainConfig);
   return isDeployed && isUpToDate;
-}; // window.localstorage helper
+};
+class LocalStorage {
+  constructor() {}
+
+  static getInstance() {
+    if (!LocalStorage._instance) {
+      LocalStorage._instance = {
+        getItem: key => Promise.resolve(window.localStorage.getItem(key)),
+        setItem: (key, value) => Promise.resolve(window.localStorage.setItem(key, value)),
+        removeItem: key => Promise.resolve(window.localStorage.removeItem(key))
+      };
+    }
+
+    return this._instance;
+  }
+
+  static use(instance) {
+    LocalStorage._instance = instance;
+  }
 
+} // window.localstorage helper
+
+LocalStorage._instance = void 0;
 class LocalStore {
   constructor(key, def) {
     this.def = def;
@@ -1804,8 +1825,8 @@ class LocalStore {
     this.key = key;
   }
 
-  get() {
-    const val = window.localStorage.getItem(this.key);
+  async get() {
+    const val = await LocalStorage.getInstance().getItem(this.key);
 
     if (val === null) {
       return this.def;
@@ -1821,11 +1842,11 @@ class LocalStore {
   }
 
   set(val) {
-    val ? window.localStorage.setItem(this.key, JSON.stringify(val)) : window.localStorage.removeItem(this.key);
+    val ? LocalStorage.getInstance().setItem(this.key, JSON.stringify(val)) : LocalStorage.getInstance().removeItem(this.key);
   }
 
   del() {
-    window.localStorage.removeItem(this.key);
+    LocalStorage.getInstance().removeItem(this.key);
   }
 
 }
@@ -2048,11 +2069,11 @@ class BaseWalletTransport {
     };
 
     this.saveTransportSession = session => {
-      window.localStorage.setItem(TRANSPORT_SESSION_LS_KEY, JSON.stringify(session));
+      LocalStorage.getInstance().setItem(TRANSPORT_SESSION_LS_KEY, JSON.stringify(session));
     };
 
-    this.getCachedTransportSession = () => {
-      const session = window.localStorage.getItem(TRANSPORT_SESSION_LS_KEY);
+    this.getCachedTransportSession = async function () {
+      const session = await LocalStorage.getInstance().getItem(TRANSPORT_SESSION_LS_KEY);
 
       try {
         return session ? JSON.parse(session) : null;
@@ -2429,14 +2450,14 @@ class ProxyMessageHandler extends BaseWalletTransport {
     this._registered = true;
   } // note: we can't decide whether to restore the session within register(), because session info is
   // received asyncronously via EventType.OPEN after register() is executed.
-  // And in the case of a redirect/reload, EventType.OPEN is not sent at all, 
+  // And in the case of a redirect/reload, EventType.OPEN is not sent at all,
   // because the wallet is already open.
   //
   // call this method from wallet redirect hander when a session restore is needed
 
 
-  restoreSession() {
-    const cachedSession = this.getCachedTransportSession();
+  async restoreSession() {
+    const cachedSession = await this.getCachedTransportSession();
 
     if (cachedSession) {
       this.open(cachedSession);
@@ -2860,7 +2881,7 @@ class WindowMessageHandler extends BaseWalletTransport {
     this._init = InitState.NIL;
   }
 
-  register(windowHref) {
+  async register(windowHref) {
     const isPopup = parent.window.opener !== null;
     this._isPopup = isPopup;
 
@@ -2878,7 +2899,7 @@ class WindowMessageHandler extends BaseWalletTransport {
     const isNewWindowSession = !!session.sessionId; // attempt to restore previous session in the case of a redirect or window reload
 
     if (!isNewWindowSession) {
-      session = this.getCachedTransportSession();
+      session = await this.getCachedTransportSession();
     }
 
     if (!session) {
@@ -3322,11 +3343,11 @@ class Wallet {
         }, true);
       }); // Load existing session from localStorage
 
-      const session = this.loadSession();
-
-      if (session) {
-        this.useSession(session, false);
-      }
+      this.loadSession().then(session => {
+        if (session) {
+          this.useSession(session, false);
+        }
+      });
     };
 
     this.connect = async function (options) {
@@ -3460,8 +3481,8 @@ class Wallet {
       this.transport.messageProvider.closeWallet();
     };
 
-    this.loadSession = () => {
-      const data = window.localStorage.getItem('@sequence.session');
+    this.loadSession = async function () {
+      const data = await LocalStorage.getInstance().getItem('@sequence.session');
 
       if (!data || data === '') {
         return undefined;
@@ -3479,7 +3500,7 @@ class Wallet {
     this.saveSession = session => {
       logger.debug('wallet provider: saving session');
       const data = JSON.stringify(session);
-      window.localStorage.setItem('@sequence.session', data);
+      LocalStorage.getInstance().setItem('@sequence.session', data);
     };
 
     this.useSession = async function (session, autoSave = true) {
@@ -3526,6 +3547,10 @@ class Wallet {
       this.config.defaultNetworkId = 'mainnet';
     }
 
+    if (config != null && config.localStorage) {
+      LocalStorage.use(config.localStorage);
+    }
+
     this.transport = {};
     this.networks = [];
     this.providers = {};
@@ -3534,9 +3559,9 @@ class Wallet {
     this.init();
   }
 
-  addConnectedSite(origin) {
+  async addConnectedSite(origin) {
     origin = origin || window.location.origin;
-    const connectedSites = this.connectedSites.get();
+    const connectedSites = await this.connectedSites.get();
 
     if (connectedSites) {
       if (connectedSites.includes(origin)) {
@@ -3549,8 +3574,8 @@ class Wallet {
     }
   }
 
-  removeConnectedSite(origin) {
-    const authorized = this.connectedSites.get();
+  async removeConnectedSite(origin) {
+    const authorized = await this.connectedSites.get();
 
     if (authorized) {
       this.connectedSites.set(authorized.filter(domain => domain !== origin));
@@ -3561,8 +3586,8 @@ class Wallet {
     return this.connectedSites.get();
   }
 
-  isSiteConnected(origin) {
-    const authorized = this.connectedSites.get();
+  async isSiteConnected(origin) {
+    const authorized = await this.connectedSites.get();
     return !!authorized && authorized.includes(origin || window.location.origin);
   }
 
@@ -3726,7 +3751,7 @@ class Wallet {
     var _this$transport$cache;
 
     logger.debug('wallet provider: clearing session');
-    window.localStorage.removeItem('@sequence.session');
+    LocalStorage.getInstance().removeItem('@sequence.session');
     this.session = undefined;
     this.networks = [];
     this.providers = {};
@@ -3747,4 +3772,4 @@ const DefaultProviderConfig = {
   }
 };
 
-export { BaseInjectedTransport, BaseProviderTransport, BaseWalletTransport, CHANNEL_ID, DefaultProviderConfig, ErrSignedInRequired, EventType, ExtensionMessageHandler, ExtensionMessageProvider, InitState, LocalStore, LocalWeb3Provider, MuxMessageProvider, OpenState, PROVIDER_OPEN_TIMEOUT, ProviderError, ProxyMessageChannel, ProxyMessageChannelPort, ProxyMessageHandler, ProxyMessageProvider, Wallet, WalletRequestHandler, Web3Provider, Web3Signer, WindowMessageHandler, WindowMessageProvider, WindowSessionParams, isBrowserExtension, isSequenceProvider, isValidMessageSignature, isValidSignature, isValidTypedDataSignature, isWalletUpToDate, messageToBytes, nextMessageIdx, prefixEIP191Message, recoverWalletConfig };
+export { BaseInjectedTransport, BaseProviderTransport, BaseWalletTransport, CHANNEL_ID, DefaultProviderConfig, ErrSignedInRequired, EventType, ExtensionMessageHandler, ExtensionMessageProvider, InitState, LocalStorage, LocalStore, LocalWeb3Provider, MuxMessageProvider, OpenState, PROVIDER_OPEN_TIMEOUT, ProviderError, ProxyMessageChannel, ProxyMessageChannelPort, ProxyMessageHandler, ProxyMessageProvider, Wallet, WalletRequestHandler, Web3Provider, Web3Signer, WindowMessageHandler, WindowMessageProvider, WindowSessionParams, isBrowserExtension, isSequenceProvider, isValidMessageSignature, isValidSignature, isValidTypedDataSignature, isWalletUpToDate, messageToBytes, nextMessageIdx, prefixEIP191Message, recoverWalletConfig };

package/dist/declarations/src/transports/base-wallet-transport.d.ts

@@ -34,5 +34,5 @@ export declare abstract class BaseWalletTransport implements WalletTransport {
     private init;
     protected open: ({ sessionId, intent, networkId }: TransportSession) => Promise<boolean>;
     private saveTransportSession;
-    protected getCachedTransportSession: () => TransportSession | null;
+    protected getCachedTransportSession: () => Promise<TransportSession | null>;
 }

package/dist/declarations/src/transports/proxy-transport/proxy-message-handler.d.ts

@@ -6,7 +6,7 @@ export declare class ProxyMessageHandler extends BaseWalletTransport {
     private port;
     constructor(walletRequestHandler: WalletRequestHandler, port: ProxyMessageChannelPort);
     register(): void;
-    restoreSession(): void;
+    restoreSession(): Promise<void>;
     unregister(): void;
     sendMessage(message: ProviderMessage<any>): void;
 }

package/dist/declarations/src/transports/window-transport/window-message-handler.d.ts

@@ -5,7 +5,7 @@ export declare class WindowMessageHandler extends BaseWalletTransport {
     protected parentWindow: Window;
     private _isPopup;
     constructor(walletRequestHandler: WalletRequestHandler);
-    register(windowHref?: any): void;
+    register(windowHref?: any): Promise<void>;
     unregister(): void;
     private onWindowEvent;
     sendMessage(message: ProviderMessage<any>): void;

package/dist/declarations/src/utils.d.ts

@@ -19,11 +19,22 @@ export declare const isBrowserExtension: () => boolean;
  * @return {Promise<boolean>} Promise that returns true if the wallet is up to date, false otherwise
  */
 export declare const isWalletUpToDate: (signer: Signer, chainId: number) => Promise<boolean>;
+export interface ItemStore {
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    removeItem(key: string): Promise<void>;
+}
+export declare class LocalStorage {
+    private static _instance;
+    private constructor();
+    static getInstance(): ItemStore;
+    static use(instance: ItemStore): void;
+}
 export declare class LocalStore<T extends Object = string> {
     def?: T | undefined;
     readonly key: string;
     constructor(key: string, def?: T | undefined);
-    get(): T | undefined;
+    get(): Promise<T | undefined>;
     set(val: T | undefined): void;
     del(): void;
 }

package/dist/declarations/src/wallet.d.ts

@@ -3,6 +3,7 @@ import { WalletConfig, WalletState } from '@0xsequence/config';
 import { Web3Provider, Web3Signer } from './provider';
 import { ProxyMessageChannelPort } from './transports';
 import { WalletSession, ProviderEventTypes, ConnectOptions, OpenWalletIntent, ConnectDetails } from './types';
+import { ItemStore } from './utils';
 import { WalletUtils } from './utils/index';
 import { Runtime } from 'webextension-polyfill-ts';
 export interface WalletProvider {
@@ -39,9 +40,9 @@ export declare class Wallet implements WalletProvider {
     constructor(defaultNetworkId?: string | number, config?: Partial<ProviderConfig>);
     private init;
     connect: (options?: ConnectOptions | undefined) => Promise<ConnectDetails>;
-    addConnectedSite(origin: string | undefined): void;
-    removeConnectedSite(origin: string): void;
-    getConnectedSites(): string[] | undefined;
+    addConnectedSite(origin: string | undefined): Promise<void>;
+    removeConnectedSite(origin: string): Promise<void>;
+    getConnectedSites(): Promise<string[] | undefined>;
     private isSiteConnected;
     authorize: (options?: ConnectOptions | undefined) => Promise<ConnectDetails>;
     disconnect(): void;
@@ -77,6 +78,7 @@ export declare class Wallet implements WalletProvider {
     private clearSession;
 }
 export interface ProviderConfig {
+    localStorage?: ItemStore;
     walletAppURL: string;
     networks?: Partial<NetworkConfig>[];
     networkRpcUrl?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@0xsequence/provider",
-  "version": "0.38.2",
+  "version": "0.39.0",
   "description": "provider sub-package for Sequence",
   "repository": "https://github.com/0xsequence/sequence.js/tree/master/packages/provider",
   "source": "src/index.ts",
@@ -13,13 +13,13 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@0xsequence/abi": "^0.38.2",
-    "@0xsequence/auth": "^0.38.2",
-    "@0xsequence/config": "^0.38.2",
-    "@0xsequence/network": "^0.38.2",
-    "@0xsequence/transactions": "^0.38.2",
-    "@0xsequence/utils": "^0.38.2",
-    "@0xsequence/wallet": "^0.38.2",
+    "@0xsequence/abi": "^0.39.0",
+    "@0xsequence/auth": "^0.39.0",
+    "@0xsequence/config": "^0.39.0",
+    "@0xsequence/network": "^0.39.0",
+    "@0xsequence/transactions": "^0.39.0",
+    "@0xsequence/utils": "^0.39.0",
+    "@0xsequence/wallet": "^0.39.0",
     "@ethersproject/abstract-signer": "^5.5.0",
     "@ethersproject/hash": "^5.5.0",
     "@ethersproject/providers": "^5.5.1",

package/src/transports/base-wallet-transport.ts

@@ -21,7 +21,7 @@ import { logger, sanitizeAlphanumeric, sanitizeHost, sanitizeNumberString } from
 import { AuthorizationOptions } from '@0xsequence/auth'
 
 import { PROVIDER_OPEN_TIMEOUT } from './base-provider-transport'
-import { isBrowserExtension } from '../utils'
+import { isBrowserExtension, LocalStorage } from '../utils'
 
 const TRANSPORT_SESSION_LS_KEY = '@sequence.transportSession'
 
@@ -435,11 +435,11 @@ export abstract class BaseWalletTransport implements WalletTransport {
   }
 
   private saveTransportSession = (session: TransportSession) => {
-    window.localStorage.setItem(TRANSPORT_SESSION_LS_KEY, JSON.stringify(session))
+    LocalStorage.getInstance().setItem(TRANSPORT_SESSION_LS_KEY, JSON.stringify(session))
   }
 
-  protected getCachedTransportSession = (): TransportSession | null => {
-    const session = window.localStorage.getItem(TRANSPORT_SESSION_LS_KEY)
+  protected getCachedTransportSession = async (): Promise<TransportSession | null> => {
+    const session = await LocalStorage.getInstance().getItem(TRANSPORT_SESSION_LS_KEY)
 
     try {
       return session ? (JSON.parse(session) as TransportSession) : null

package/src/transports/proxy-transport/proxy-message-handler.ts

@@ -4,7 +4,6 @@ import { InitState, ProviderMessage } from '../../types'
 import { ProxyMessageChannelPort } from './proxy-message-channel'
 
 export class ProxyMessageHandler extends BaseWalletTransport {
-
   private port: ProxyMessageChannelPort
 
   constructor(walletRequestHandler: WalletRequestHandler, port: ProxyMessageChannelPort) {
@@ -22,12 +21,12 @@ export class ProxyMessageHandler extends BaseWalletTransport {
 
   // note: we can't decide whether to restore the session within register(), because session info is
   // received asyncronously via EventType.OPEN after register() is executed.
-  // And in the case of a redirect/reload, EventType.OPEN is not sent at all, 
+  // And in the case of a redirect/reload, EventType.OPEN is not sent at all,
   // because the wallet is already open.
   //
   // call this method from wallet redirect hander when a session restore is needed
-  restoreSession() {
-    const cachedSession = this.getCachedTransportSession()
+  async restoreSession() {
+    const cachedSession = await this.getCachedTransportSession()
     if (cachedSession) {
       this.open(cachedSession)
     }
@@ -42,5 +41,4 @@ export class ProxyMessageHandler extends BaseWalletTransport {
   sendMessage(message: ProviderMessage<any>) {
     this.port.sendMessage(message)
   }
-
 }

package/src/transports/window-transport/window-message-handler.ts

@@ -22,7 +22,7 @@ export class WindowMessageHandler extends BaseWalletTransport {
     this._init = InitState.NIL
   }
 
-  register(windowHref?: any) {
+  async register(windowHref?: any) {
     const isPopup = parent.window.opener !== null
     this._isPopup = isPopup
     if (isPopup !== true) {
@@ -39,7 +39,7 @@ export class WindowMessageHandler extends BaseWalletTransport {
 
     // attempt to restore previous session in the case of a redirect or window reload
     if (!isNewWindowSession) {
-      session = this.getCachedTransportSession()
+      session = await this.getCachedTransportSession()
     }
 
     if (!session) {
@@ -143,7 +143,8 @@ export class WindowMessageHandler extends BaseWalletTransport {
       this.parentWindow.postMessage(message, '*')
     } else {
       // open message transmission
-      if (this.appOrigin && this.appOrigin.length > 4) { // just above '.com'
+      if (this.appOrigin && this.appOrigin.length > 4) {
+        // just above '.com'
         this.parentWindow.postMessage(message, this.appOrigin)
       } else {
         logger.error('unable to postMessage as parentOrigin is invalid')

package/src/utils.ts

@@ -3,9 +3,9 @@ import { WalletContext } from '@0xsequence/network'
 import { WalletConfig, addressOf, DecodedSignature, isConfigEqual } from '@0xsequence/config'
 import { packMessageData, encodeMessageDigest, TypedData, encodeTypedDataDigest } from '@0xsequence/utils'
 import { Web3Provider } from './provider'
-import { isValidSignature as _isValidSignature, recoverConfig, Signer, isValidEIP712Signature, isValidEthSignSignature } from '@0xsequence/wallet'
+import { isValidSignature as _isValidSignature, recoverConfig, Signer } from '@0xsequence/wallet'
 
-const eip191prefix = ethers.utils.toUtf8Bytes("\x19Ethereum Signed Message:\n")
+const eip191prefix = ethers.utils.toUtf8Bytes('\x19Ethereum Signed Message:\n')
 
 export const messageToBytes = (message: BytesLike): Uint8Array => {
   if (ethers.utils.isBytes(message) || ethers.utils.isHexString(message)) {
@@ -17,11 +17,7 @@ export const messageToBytes = (message: BytesLike): Uint8Array => {
 
 export const prefixEIP191Message = (message: BytesLike): Uint8Array => {
   const messageBytes = messageToBytes(message)
-  return ethers.utils.concat([
-    eip191prefix,
-    ethers.utils.toUtf8Bytes(String(messageBytes.length)),
-    messageBytes
-  ])
+  return ethers.utils.concat([eip191prefix, ethers.utils.toUtf8Bytes(String(messageBytes.length)), messageBytes])
 }
 
 export const isValidSignature = async (
@@ -130,6 +126,33 @@ export const isWalletUpToDate = async (signer: Signer, chainId: number): Promise
   return isDeployed && isUpToDate
 }
 
+export interface ItemStore {
+  getItem(key: string): Promise<string | null>
+  setItem(key: string, value: string): Promise<void>
+  removeItem(key: string): Promise<void>
+}
+
+export class LocalStorage {
+  private static _instance: ItemStore
+
+  private constructor() {}
+
+  static getInstance(): ItemStore {
+    if (!LocalStorage._instance) {
+      LocalStorage._instance = {
+        getItem: (key: string) => Promise.resolve(window.localStorage.getItem(key)),
+        setItem: (key: string, value: string) => Promise.resolve(window.localStorage.setItem(key, value)),
+        removeItem: (key: string) => Promise.resolve(window.localStorage.removeItem(key))
+      }
+    }
+    return this._instance
+  }
+
+  static use(instance: ItemStore) {
+    LocalStorage._instance = instance
+  }
+}
+
 // window.localstorage helper
 export class LocalStore<T extends Object = string> {
   readonly key: string
@@ -138,8 +161,8 @@ export class LocalStore<T extends Object = string> {
     this.key = key
   }
 
-  get(): T | undefined {
-    const val = window.localStorage.getItem(this.key)
+  async get(): Promise<T | undefined> {
+    const val = await LocalStorage.getInstance().getItem(this.key)
 
     if (val === null) {
       return this.def
@@ -155,10 +178,10 @@ export class LocalStore<T extends Object = string> {
   }
 
   set(val: T | undefined) {
-    val ? window.localStorage.setItem(this.key, JSON.stringify(val)) : window.localStorage.removeItem(this.key)
+    val ? LocalStorage.getInstance().setItem(this.key, JSON.stringify(val)) : LocalStorage.getInstance().removeItem(this.key)
   }
 
   del() {
-    window.localStorage.removeItem(this.key)
+    LocalStorage.getInstance().removeItem(this.key)
   }
 }

package/src/wallet.ts

@@ -1,25 +1,18 @@
 import {
   NetworkConfig,
   WalletContext,
-  sequenceContext,
   ChainIdLike,
-  getChainId,
   JsonRpcSender,
   JsonRpcRouter,
   JsonRpcMiddleware,
   allowProviderMiddleware,
   CachedProvider,
-  PublicProvider,
   loggingProviderMiddleware,
   SigningProvider,
   EagerProvider,
   exceptionProviderMiddleware,
   networkProviderMiddleware,
-  JsonRpcExternalProvider,
-  JsonRpcHandlerFunc,
   JsonRpcRequest,
-  JsonRpcResponse,
-  JsonRpcResponseCallback,
   findNetworkConfig,
   updateNetworkConfig,
   ensureValidNetworks
@@ -32,7 +25,7 @@ import { MuxMessageProvider, WindowMessageProvider, ProxyMessageProvider, ProxyM
 import { WalletSession, ProviderEventTypes, ConnectOptions, OpenWalletIntent, ConnectDetails } from './types'
 import { ethers } from 'ethers'
 import { ExtensionMessageProvider } from './transports/extension-transport/extension-message-provider'
-import { LocalStore } from './utils'
+import { LocalStore, ItemStore, LocalStorage } from './utils'
 import { WalletUtils } from './utils/index'
 
 import { Runtime } from 'webextension-polyfill-ts'
@@ -111,6 +104,10 @@ export class Wallet implements WalletProvider {
       this.config.defaultNetworkId = 'mainnet'
     }
 
+    if (config?.localStorage) {
+      LocalStorage.use(config.localStorage)
+    }
+
     this.transport = {}
     this.networks = []
     this.providers = {}
@@ -233,10 +230,11 @@ export class Wallet implements WalletProvider {
     })
 
     // Load existing session from localStorage
-    const session = this.loadSession()
-    if (session) {
-      this.useSession(session, false)
-    }
+    this.loadSession().then(session => {
+      if (session) {
+        this.useSession(session, false)
+      }
+    })
   }
 
   connect = async (options?: ConnectOptions): Promise<ConnectDetails> => {
@@ -282,10 +280,10 @@ export class Wallet implements WalletProvider {
     return connectDetails
   }
 
-  addConnectedSite(origin: string | undefined) {
+  async addConnectedSite(origin: string | undefined) {
     origin = origin || window.location.origin
 
-    const connectedSites = this.connectedSites.get()
+    const connectedSites = await this.connectedSites.get()
 
     if (connectedSites) {
       if (connectedSites.includes(origin)) {
@@ -297,8 +295,8 @@ export class Wallet implements WalletProvider {
     }
   }
 
-  removeConnectedSite(origin: string) {
-    const authorized = this.connectedSites.get()
+  async removeConnectedSite(origin: string) {
+    const authorized = await this.connectedSites.get()
 
     if (authorized) {
       this.connectedSites.set(authorized.filter(domain => domain !== origin))
@@ -309,8 +307,8 @@ export class Wallet implements WalletProvider {
     return this.connectedSites.get()
   }
 
-  private isSiteConnected(origin: string | undefined): boolean {
-    const authorized = this.connectedSites.get()
+  private async isSiteConnected(origin: string | undefined): Promise<boolean> {
+    const authorized = await this.connectedSites.get()
 
     return !!authorized && authorized.includes(origin || window.location.origin)
   }
@@ -538,8 +536,8 @@ export class Wallet implements WalletProvider {
     this.transport.messageProvider!.once(event, fn)
   }
 
-  private loadSession = (): WalletSession | undefined => {
-    const data = window.localStorage.getItem('@sequence.session')
+  private loadSession = async (): Promise<WalletSession | undefined> => {
+    const data = await LocalStorage.getInstance().getItem('@sequence.session')
     if (!data || data === '') {
       return undefined
     }
@@ -555,7 +553,7 @@ export class Wallet implements WalletProvider {
   private saveSession = (session: WalletSession) => {
     logger.debug('wallet provider: saving session')
     const data = JSON.stringify(session)
-    window.localStorage.setItem('@sequence.session', data)
+    LocalStorage.getInstance().setItem('@sequence.session', data)
   }
 
   private useSession = async (session: WalletSession, autoSave: boolean = true) => {
@@ -631,7 +629,7 @@ export class Wallet implements WalletProvider {
 
   private clearSession(): void {
     logger.debug('wallet provider: clearing session')
-    window.localStorage.removeItem('@sequence.session')
+    LocalStorage.getInstance().removeItem('@sequence.session')
     this.session = undefined
     this.networks = []
     this.providers = {}
@@ -640,6 +638,10 @@ export class Wallet implements WalletProvider {
 }
 
 export interface ProviderConfig {
+  // The local storage dependency for the wallet provider, defaults to window.localStorage.
+  // For example, this option should be used when using React Native since window.localStorage is not available.
+  localStorage?: ItemStore
+
   // Sequence Wallet App URL, default: https://sequence.app
   walletAppURL: string