@aptos-labs/wallet-adapter-core 2.1.0 → 2.2.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @aptos-labs/wallet-adapter-core
 
+## 2.2.0
+
+### Minor Changes
+
+- 814939c: Add deeplink support
+
 ## 2.1.0
 
 ### Minor Changes

package/dist/index.d.ts

@@ -69,6 +69,9 @@ interface AdapterPluginProps<Name extends string = string> {
     icon: `data:image/${"svg+xml" | "webp" | "png" | "gif"};base64,${string}`;
     providerName?: string;
     provider: any;
+    deeplinkProvider?: (data: {
+        url: string;
+    }) => string;
     connect(): Promise<any>;
     disconnect: () => Promise<any>;
     network: () => Promise<any>;
@@ -208,4 +211,14 @@ declare class WalletCore extends EventEmitter<WalletCoreEvents> {
     signMessageAndVerify(message: SignMessagePayload): Promise<boolean>;
 }
 
-export { AccountInfo, AdapterPlugin, AdapterPluginEvents, AdapterPluginProps, AptosWalletErrorResult, NetworkInfo, NetworkName, PluginProvider, SignMessagePayload, SignMessageResponse, Wallet, WalletCore, WalletCoreEvents, WalletInfo, WalletName, WalletReadyState };
+declare function scopePollingDetectionStrategy(detect: () => boolean): void;
+
+declare function setLocalStorage(walletName: WalletName): void;
+declare function removeLocalStorage(): void;
+declare function getLocalStorage(): void;
+
+declare function isMobile(): boolean;
+declare function isInAppBrowser(): boolean;
+declare function isRedirectable(): boolean;
+
+export { AccountInfo, AdapterPlugin, AdapterPluginEvents, AdapterPluginProps, AptosWalletErrorResult, NetworkInfo, NetworkName, PluginProvider, SignMessagePayload, SignMessageResponse, Wallet, WalletCore, WalletCoreEvents, WalletInfo, WalletName, WalletReadyState, getLocalStorage, isInAppBrowser, isMobile, isRedirectable, removeLocalStorage, scopePollingDetectionStrategy, setLocalStorage };

package/dist/index.js

@@ -28,7 +28,14 @@ var src_exports = {};
 __export(src_exports, {
   NetworkName: () => NetworkName,
   WalletCore: () => WalletCore,
-  WalletReadyState: () => WalletReadyState
+  WalletReadyState: () => WalletReadyState,
+  getLocalStorage: () => getLocalStorage,
+  isInAppBrowser: () => isInAppBrowser,
+  isMobile: () => isMobile,
+  isRedirectable: () => isRedirectable,
+  removeLocalStorage: () => removeLocalStorage,
+  scopePollingDetectionStrategy: () => scopePollingDetectionStrategy,
+  setLocalStorage: () => setLocalStorage
 });
 module.exports = __toCommonJS(src_exports);
 
@@ -183,6 +190,30 @@ function setLocalStorage(walletName) {
 function removeLocalStorage() {
   localStorage.removeItem(LOCAL_STORAGE_ITEM_KEY);
 }
+function getLocalStorage() {
+  localStorage.getItem(LOCAL_STORAGE_ITEM_KEY);
+}
+
+// src/utils/helpers.ts
+function isMobile() {
+  return /Mobile|iP(hone|od|ad)|Android|BlackBerry|IEMobile|Kindle|NetFront|Silk-Accelerated|(hpw|web)OS|Fennec|Minimo|Opera M(obi|ini)|Blazer|Dolfin|Dolphin|Skyfire|Zune/i.test(
+    navigator.userAgent
+  );
+}
+function isInAppBrowser() {
+  const isIphone = /(iPhone|iPod|iPad).*AppleWebKit(?!.*Safari)/i.test(
+    navigator.userAgent
+  );
+  const isAndroid = /(Android).*Version\/[\d.]+.*Chrome\/[^\s]+ Mobile/i.test(
+    navigator.userAgent
+  );
+  return isIphone || isAndroid;
+}
+function isRedirectable() {
+  if (!navigator)
+    return false;
+  return isMobile() && !isInAppBrowser();
+}
 
 // src/ans.ts
 var ChainIdToAnsContractAddressMap = {
@@ -317,6 +348,15 @@ var WalletCore = class extends import_eventemitter3.default {
           return;
         await this.disconnect();
       }
+      if (isRedirectable()) {
+        if (selectedWallet.deeplinkProvider) {
+          const url = encodeURIComponent(window.location.href);
+          const location = selectedWallet.deeplinkProvider({ url });
+          window.location.href = location;
+        } else {
+          return;
+        }
+      }
       this._connecting = true;
       this.setWallet(selectedWallet);
       const account = await selectedWallet.connect();
@@ -496,5 +536,12 @@ var WalletCore = class extends import_eventemitter3.default {
 0 && (module.exports = {
   NetworkName,
   WalletCore,
-  WalletReadyState
+  WalletReadyState,
+  getLocalStorage,
+  isInAppBrowser,
+  isMobile,
+  isRedirectable,
+  removeLocalStorage,
+  scopePollingDetectionStrategy,
+  setLocalStorage
 });

package/dist/index.mjs

@@ -149,6 +149,30 @@ function setLocalStorage(walletName) {
 function removeLocalStorage() {
   localStorage.removeItem(LOCAL_STORAGE_ITEM_KEY);
 }
+function getLocalStorage() {
+  localStorage.getItem(LOCAL_STORAGE_ITEM_KEY);
+}
+
+// src/utils/helpers.ts
+function isMobile() {
+  return /Mobile|iP(hone|od|ad)|Android|BlackBerry|IEMobile|Kindle|NetFront|Silk-Accelerated|(hpw|web)OS|Fennec|Minimo|Opera M(obi|ini)|Blazer|Dolfin|Dolphin|Skyfire|Zune/i.test(
+    navigator.userAgent
+  );
+}
+function isInAppBrowser() {
+  const isIphone = /(iPhone|iPod|iPad).*AppleWebKit(?!.*Safari)/i.test(
+    navigator.userAgent
+  );
+  const isAndroid = /(Android).*Version\/[\d.]+.*Chrome\/[^\s]+ Mobile/i.test(
+    navigator.userAgent
+  );
+  return isIphone || isAndroid;
+}
+function isRedirectable() {
+  if (!navigator)
+    return false;
+  return isMobile() && !isInAppBrowser();
+}
 
 // src/ans.ts
 var ChainIdToAnsContractAddressMap = {
@@ -283,6 +307,15 @@ var WalletCore = class extends EventEmitter {
           return;
         await this.disconnect();
       }
+      if (isRedirectable()) {
+        if (selectedWallet.deeplinkProvider) {
+          const url = encodeURIComponent(window.location.href);
+          const location = selectedWallet.deeplinkProvider({ url });
+          window.location.href = location;
+        } else {
+          return;
+        }
+      }
       this._connecting = true;
       this.setWallet(selectedWallet);
       const account = await selectedWallet.connect();
@@ -461,5 +494,12 @@ var WalletCore = class extends EventEmitter {
 export {
   NetworkName,
   WalletCore,
-  WalletReadyState
+  WalletReadyState,
+  getLocalStorage,
+  isInAppBrowser,
+  isMobile,
+  isRedirectable,
+  removeLocalStorage,
+  scopePollingDetectionStrategy,
+  setLocalStorage
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aptos-labs/wallet-adapter-core",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "Aptos Wallet Adapter Core",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",

package/src/WalletCore.ts

@@ -34,6 +34,7 @@ import {
   removeLocalStorage,
   setLocalStorage,
   scopePollingDetectionStrategy,
+  isRedirectable,
 } from "./utils";
 import { getNameByAddress } from "./ans";
 
@@ -200,6 +201,16 @@ export class WalletCore extends EventEmitter<WalletCoreEvents> {
 
         await this.disconnect();
       }
+      if (isRedirectable()) {
+        // use wallet deep link
+        if (selectedWallet.deeplinkProvider) {
+          const url = encodeURIComponent(window.location.href);
+          const location = selectedWallet.deeplinkProvider({ url });
+          window.location.href = location;
+        } else {
+          return;
+        }
+      }
       this._connecting = true;
       this.setWallet(selectedWallet);
       const account = await selectedWallet.connect();

package/src/index.ts

@@ -1,3 +1,4 @@
 export { WalletCore } from "./WalletCore";
 export * from "./types";
 export * from "./constants";
+export * from "./utils";

package/src/types.ts

@@ -53,6 +53,7 @@ export interface AdapterPluginProps<Name extends string = string> {
   icon: `data:image/${"svg+xml" | "webp" | "png" | "gif"};base64,${string}`;
   providerName?: string;
   provider: any;
+  deeplinkProvider?: (data: { url: string }) => string;
   connect(): Promise<any>;
   disconnect: () => Promise<any>;
   network: () => Promise<any>;

package/src/utils/helpers.ts

@@ -0,0 +1,26 @@
+export function isMobile(): boolean {
+  return /Mobile|iP(hone|od|ad)|Android|BlackBerry|IEMobile|Kindle|NetFront|Silk-Accelerated|(hpw|web)OS|Fennec|Minimo|Opera M(obi|ini)|Blazer|Dolfin|Dolphin|Skyfire|Zune/i.test(
+    navigator.userAgent
+  );
+}
+
+export function isInAppBrowser(): boolean {
+  const isIphone = /(iPhone|iPod|iPad).*AppleWebKit(?!.*Safari)/i.test(
+    navigator.userAgent
+  );
+
+  const isAndroid = /(Android).*Version\/[\d.]+.*Chrome\/[^\s]+ Mobile/i.test(
+    navigator.userAgent
+  );
+
+  return isIphone || isAndroid;
+}
+
+export function isRedirectable(): boolean {
+  // SSR: return false
+  if (!navigator) return false;
+
+  // if we are on mobile and NOT in a in-app browser we will redirect to a wallet app
+
+  return isMobile() && !isInAppBrowser();
+}

package/src/utils/index.ts

@@ -1,2 +1,3 @@
 export { scopePollingDetectionStrategy } from "./scopePollingDetectionStrategy";
 export * from "./localStorage";
+export * from "./helpers";