@phantom/browser-sdk 1.0.0-beta.2 → 1.0.0-beta.4

package/README.md

@@ -44,8 +44,7 @@ import { BrowserSDK, AddressType } from "@phantom/browser-sdk";
 const sdk = new BrowserSDK({
   providerType: "embedded",
   addressTypes: [AddressType.solana, AddressType.ethereum],
-  apiBaseUrl: "https://api.phantom.app/v1/wallets",
-  appId: "your-app-id",
+  appId: "your-app-id", // Get your app ID from phantom.com/portal
 });
 
 const { addresses } = await sdk.connect();
@@ -190,48 +189,29 @@ Creates a non-custodial wallet embedded in your application. Requires API config
 const sdk = new BrowserSDK({
   providerType: "embedded",
   addressTypes: [AddressType.solana, AddressType.ethereum],
-  apiBaseUrl: "https://api.phantom.app/v1/wallets",
-  appId: "your-app-id",
-  embeddedWalletType: "app-wallet", // or 'user-wallet'
+  appId: "your-app-id", // Get your app ID from phantom.com/portal
   authOptions: {
-    authUrl: "https://auth.phantom.app", // optional, defaults to "https://connect.phantom.app"
+    authUrl: "https://connect.phantom.app/login", // optional, defaults to "https://connect.phantom.app/login"
     redirectUrl: "https://yourapp.com/callback", // optional, defaults to current page
   },
   autoConnect: true, // optional, auto-connect to existing session (default: true for embedded)
 });
 ```
 
-### Embedded Wallet Types
-
-#### App Wallet (`'app-wallet'`)
-
-- **New wallets** created per application
-- **Unfunded** by default - you need to fund them
-- **Independent** from user's existing Phantom wallet
-- **Perfect for**: Gaming, DeFi protocols, or apps that need fresh wallets
-
-```typescript
-const sdk = new BrowserSDK({
-  providerType: "embedded",
-  embeddedWalletType: "app-wallet",
-  addressTypes: [AddressType.solana],
-  // ... other config
-});
-```
+### Embedded Wallet Type
 
 #### User Wallet (`'user-wallet'`)
 
 - **Uses Phantom authentication** - user logs in with existing Phantom account
 - **Potentially funded** - brings in user's existing wallet balance
 - **Connected** to user's Phantom ecosystem
-- **Perfect for**: Trading platforms, NFT marketplaces, or apps needing funded wallets
+- **Perfect for**: All embedded wallet use cases
 
 ```typescript
 const sdk = new BrowserSDK({
   providerType: "embedded",
-  embeddedWalletType: "user-wallet",
+  appId: "your-app-id",
   addressTypes: [AddressType.solana, AddressType.ethereum],
-  // ... other config
 });
 ```
 
@@ -242,28 +222,6 @@ const sdk = new BrowserSDK({
 | `AddressType.solana`   | Solana Mainnet, Devnet, Testnet       |
 | `AddressType.ethereum` | Ethereum, Polygon, Arbitrum, and more |
 
-### Solana Provider Configuration
-
-When using `AddressType.solana`, you can choose between two Solana libraries:
-
-```typescript
-const sdk = new BrowserSDK({
-  providerType: "embedded",
-  addressTypes: [AddressType.solana],
-  solanaProvider: "web3js", // or 'kit'
-  // ... other config
-});
-```
-
-**Provider Options:**
-
-- `'web3js'` (default) - Uses `@solana/web3.js` library
-- `'kit'` - Uses `@solana/kit` library (modern, TypeScript-first)
-
-**When to use each:**
-
-- **@solana/web3.js**: Better ecosystem compatibility, wider community support
-- **@solana/kit**: Better TypeScript support, modern architecture, smaller bundle size
 
 ### Auto-Connect Feature
 
@@ -272,8 +230,8 @@ The SDK can automatically reconnect to existing sessions when instantiated, prov
 ```typescript
 const sdk = new BrowserSDK({
   providerType: "embedded",
+  appId: "your-app-id",
   addressTypes: [AddressType.solana],
-  // ... other config
   autoConnect: true, // Default: true for embedded, false for injected
 });
 
@@ -295,8 +253,8 @@ if (sdk.isConnected()) {
 ```typescript
 const sdk = new BrowserSDK({
   providerType: "embedded",
+  appId: "your-app-id",
   addressTypes: [AddressType.solana],
-  // ... other config
   autoConnect: false, // Disable auto-connect
 });
 
@@ -320,15 +278,16 @@ interface BrowserSDKConfig {
   addressTypes?: [AddressType, ...AddressType[]]; // Networks to enable (e.g., [AddressType.solana])
 
   // Required for embedded provider only
-  apiBaseUrl?: string; // Phantom API base URL
-  appId?: string; // Your app ID (required for embedded provider)
+  appId?: string; // Your app ID from phantom.com/portal (required for embedded provider)
+  
+  // Optional configuration
+  apiBaseUrl?: string; // Phantom API base URL (optional, has default)
   authOptions?: {
-    authUrl?: string; // Custom auth URL (default: "https://connect.phantom.app")
-    redirectUrl?: string; // Custom redirect URL after authentication
+    authUrl?: string; // Custom auth URL (optional, defaults to "https://connect.phantom.app/login")
+    redirectUrl?: string; // Custom redirect URL after authentication (optional)
   };
-  embeddedWalletType?: "app-wallet" | "user-wallet"; // Wallet type
-  solanaProvider?: "web3js" | "kit"; // Solana library choice (default: 'web3js')
-  autoConnect?: boolean; // Enable auto-connect to existing sessions (default: true)
+  embeddedWalletType?: "user-wallet"; // Wallet type (optional, defaults to "user-wallet", currently the only supported type)
+  autoConnect?: boolean; // Enable auto-connect to existing sessions (optional, defaults to true for embedded)
 }
 ```
 
@@ -748,7 +707,7 @@ import { BrowserSDK, DebugLevel } from "@phantom/browser-sdk";
 
 const sdk = new BrowserSDK({
   providerType: "embedded",
-  // ... other config
+  appId: "your-app-id",
 });
 
 // Store debug messages
@@ -815,7 +774,6 @@ import { BrowserSDK, AddressType } from "@phantom/browser-sdk";
 const sdk = new BrowserSDK({
   providerType: "injected",
   addressTypes: [AddressType.solana],
-  solanaProvider: "web3js",
 });
 
 await sdk.connect();
@@ -869,7 +827,6 @@ import { BrowserSDK, AddressType } from "@phantom/browser-sdk";
 const sdk = new BrowserSDK({
   providerType: "injected",
   addressTypes: [AddressType.solana],
-  solanaProvider: "kit",
 });
 
 await sdk.connect();

package/dist/index.d.ts

@@ -57,13 +57,17 @@ interface DebugConfig {
     level?: DebugLevel;
     callback?: DebugCallback;
 }
-interface BrowserSDKConfig extends Partial<EmbeddedProviderConfig> {
+interface BrowserSDKConfig extends Partial<Omit<EmbeddedProviderConfig, "authOptions">> {
     providerType: "injected" | "embedded" | (string & Record<never, never>);
     addressTypes: [AddressType, ...AddressType[]];
     apiBaseUrl?: string;
     appId?: string;
     embeddedWalletType?: "app-wallet" | "user-wallet" | (string & Record<never, never>);
     autoConnect?: boolean;
+    authOptions?: {
+        authUrl?: string;
+        redirectUrl?: string;
+    };
 }
 
 interface Provider {
@@ -205,18 +209,13 @@ declare class BrowserSDK {
     getSupportedAutoConfirmChains(): Promise<AutoConfirmSupportedChainsResult>;
 }
 
-/**
- * Constants used throughout the browser SDK
- */
-declare const DEFAULT_AUTH_URL = "https://connect.phantom.app";
-declare const DEFAULT_WALLET_API_URL = "https://api.phantom.app/v1/wallets";
-
 /**
  * Browser detection utility to identify browser name and version
  */
 interface BrowserInfo {
     name: string;
     version: string;
+    userAgent: string;
 }
 /**
  * Parse browser information from a user agent string
@@ -237,6 +236,18 @@ declare function getPlatformName(): string;
  * Format: "Chrome 120.0" or "Firefox 119.0"
  */
 declare function getBrowserDisplayName(): string;
+/**
+ * Detect if the current device is a mobile device
+ * Checks user agent for mobile indicators and screen size
+ */
+declare function isMobileDevice(): boolean;
+
+/**
+ * Generates a deeplink URL to open the current page in Phantom mobile app
+ * @param ref Optional referrer parameter
+ * @returns Phantom mobile app deeplink URL
+ */
+declare function getDeeplinkToPhantom(ref?: string): string;
 
 /**
  * Wait for Phantom extension to be available with retry logic
@@ -256,4 +267,4 @@ declare function getBrowserDisplayName(): string;
  */
 declare function waitForPhantomExtension(timeoutMs?: number): Promise<boolean>;
 
-export { BrowserInfo, BrowserSDK, BrowserSDKConfig, DEFAULT_AUTH_URL, DEFAULT_WALLET_API_URL, DebugCallback, DebugCategory, DebugConfig, DebugLevel, DebugMessage, Provider, debug, detectBrowser, getBrowserDisplayName, getPlatformName, parseBrowserFromUserAgent, waitForPhantomExtension };
+export { BrowserInfo, BrowserSDK, BrowserSDKConfig, DebugCallback, DebugCategory, DebugConfig, DebugLevel, DebugMessage, Provider, debug, detectBrowser, getBrowserDisplayName, getDeeplinkToPhantom, getPlatformName, isMobileDevice, parseBrowserFromUserAgent, waitForPhantomExtension };

package/dist/index.js

@@ -22,15 +22,15 @@ var src_exports = {};
 __export(src_exports, {
   AddressType: () => import_client5.AddressType,
   BrowserSDK: () => BrowserSDK,
-  DEFAULT_AUTH_URL: () => DEFAULT_AUTH_URL,
-  DEFAULT_WALLET_API_URL: () => DEFAULT_WALLET_API_URL,
   DebugCategory: () => DebugCategory,
   DebugLevel: () => DebugLevel,
-  NetworkId: () => import_constants2.NetworkId,
+  NetworkId: () => import_constants5.NetworkId,
   debug: () => debug,
   detectBrowser: () => detectBrowser,
   getBrowserDisplayName: () => getBrowserDisplayName,
+  getDeeplinkToPhantom: () => getDeeplinkToPhantom,
   getPlatformName: () => getPlatformName,
+  isMobileDevice: () => isMobileDevice,
   parseBrowserFromUserAgent: () => parseBrowserFromUserAgent,
   waitForPhantomExtension: () => waitForPhantomExtension
 });
@@ -178,8 +178,27 @@ var InjectedSolanaChain = class {
     const result = await this.phantom.solana.signAndSendTransaction(transaction);
     return { signature: result.signature };
   }
-  signAllTransactions(_transactions) {
-    return Promise.reject(new Error("Sign-only transactions not supported by injected provider"));
+  async signAllTransactions(transactions) {
+    if (!this.callbacks.isConnected()) {
+      return Promise.reject(new Error("Provider not connected. Call provider connect first."));
+    }
+    try {
+      const result = await this.phantom.solana.signAllTransactions(transactions);
+      return result;
+    } catch (error) {
+      return Promise.reject(error);
+    }
+  }
+  async signAndSendAllTransactions(transactions) {
+    if (!this.callbacks.isConnected()) {
+      return Promise.reject(new Error("Provider not connected. Call provider connect first."));
+    }
+    try {
+      const result = await this.phantom.solana.signAndSendAllTransactions(transactions);
+      return { signatures: result.signatures };
+    } catch (error) {
+      return Promise.reject(error);
+    }
   }
   switchNetwork(_network) {
     return Promise.resolve();
@@ -808,15 +827,19 @@ var BrowserURLParamsAccessor = class {
 };
 var browserUrlParamsAccessor = new BrowserURLParamsAccessor();
 
-// src/constants.ts
-var DEFAULT_AUTH_URL = "https://connect.phantom.app";
-var DEFAULT_WALLET_API_URL = "https://api.phantom.app/v1/wallets";
-
 // src/providers/embedded/adapters/auth.ts
+var import_constants = require("@phantom/constants");
 var BrowserAuthProvider = class {
   constructor(urlParamsAccessor) {
     this.urlParamsAccessor = urlParamsAccessor;
   }
+  getValidatedCurrentUrl() {
+    const currentUrl = window.location.href;
+    if (!currentUrl.startsWith("http:") && !currentUrl.startsWith("https:")) {
+      throw new Error("Invalid URL protocol - only HTTP/HTTPS URLs are supported");
+    }
+    return currentUrl;
+  }
   authenticate(options) {
     return new Promise((resolve) => {
       if ("jwtToken" in options) {
@@ -831,13 +854,13 @@ var BrowserAuthProvider = class {
         authUrl: phantomOptions.authUrl,
         hasCustomData: !!phantomOptions.customAuthData
       });
-      const baseUrl = phantomOptions.authUrl || DEFAULT_AUTH_URL;
+      const baseUrl = phantomOptions.authUrl || import_constants.DEFAULT_AUTH_URL;
       debug.log(DebugCategory.PHANTOM_CONNECT_AUTH, "Using auth URL", { baseUrl });
       const params = new URLSearchParams({
         organization_id: phantomOptions.organizationId,
         parent_organization_id: phantomOptions.parentOrganizationId,
         app_id: phantomOptions.appId,
-        redirect_uri: phantomOptions.redirectUrl || (typeof window !== "undefined" ? window.location.href : ""),
+        redirect_uri: phantomOptions.redirectUrl || (typeof window !== "undefined" ? this.getValidatedCurrentUrl() : ""),
         session_id: phantomOptions.sessionId,
         clear_previous_session: true.toString()
       });
@@ -865,6 +888,9 @@ var BrowserAuthProvider = class {
       debug.log(DebugCategory.PHANTOM_CONNECT_AUTH, "Stored auth context in session storage", { authContext });
       const authUrl = `${baseUrl}?${params.toString()}`;
       debug.info(DebugCategory.PHANTOM_CONNECT_AUTH, "Redirecting to Phantom Connect", { authUrl });
+      if (!authUrl.startsWith("https:")) {
+        throw new Error("Invalid auth URL - only HTTPS URLs are allowed for authentication");
+      }
       window.location.href = authUrl;
       resolve();
     });
@@ -953,7 +979,7 @@ function parseBrowserFromUserAgent(userAgent, hasBraveAPI) {
   let name = "unknown";
   let version = "unknown";
   if (!userAgent || typeof userAgent !== "string") {
-    return { name, version };
+    return { name, version, userAgent: "unknown" };
   }
   try {
     if (userAgent.includes("Edg/")) {
@@ -1035,11 +1061,11 @@ function parseBrowserFromUserAgent(userAgent, hasBraveAPI) {
     }
   } catch (error) {
   }
-  return { name, version };
+  return { name, version, userAgent };
 }
 function detectBrowser() {
   if (typeof window === "undefined" || !window.navigator?.userAgent) {
-    return { name: "unknown", version: "unknown" };
+    return { name: "unknown", version: "unknown", userAgent: "unknown" };
   }
   const userAgent = window.navigator.userAgent;
   const hasBraveAPI = !!navigator.brave;
@@ -1054,8 +1080,41 @@ function getBrowserDisplayName() {
   const capitalizedName = name.charAt(0).toUpperCase() + name.slice(1);
   return version !== "unknown" ? `${capitalizedName} ${version}` : capitalizedName;
 }
+function isMobileDevice() {
+  if (typeof window === "undefined" || !window.navigator?.userAgent) {
+    return false;
+  }
+  const userAgent = window.navigator.userAgent.toLowerCase();
+  const mobilePatterns = [
+    /android/,
+    /iphone|ipad|ipod/,
+    /blackberry/,
+    /windows phone/,
+    /mobile/,
+    /tablet/,
+    /silk/,
+    /kindle/,
+    /opera mini/,
+    /opera mobi/
+  ];
+  const isMobileUA = mobilePatterns.some((pattern) => pattern.test(userAgent));
+  let isSmallScreen = false;
+  try {
+    isSmallScreen = window.screen.width <= 768 || window.screen.height <= 768;
+  } catch (error) {
+    isSmallScreen = false;
+  }
+  let isTouchDevice = false;
+  try {
+    isTouchDevice = "ontouchstart" in window || navigator.maxTouchPoints > 0;
+  } catch (error) {
+    isTouchDevice = false;
+  }
+  return isMobileUA || isSmallScreen && isTouchDevice;
+}
 
 // src/providers/embedded/index.ts
+var import_constants2 = require("@phantom/constants");
 var EmbeddedProvider = class extends import_embedded_provider_core.EmbeddedProvider {
   constructor(config) {
     debug.log(DebugCategory.EMBEDDED_PROVIDER, "Initializing Browser EmbeddedProvider", { config });
@@ -1066,13 +1125,25 @@ var EmbeddedProvider = class extends import_embedded_provider_core.EmbeddedProvi
       keyName: "signing-key"
     });
     const platformName = getPlatformName();
+    const { name: browserName, version } = detectBrowser();
     const platform = {
       storage: new BrowserStorage(),
       authProvider: new BrowserAuthProvider(urlParamsAccessor),
       urlParamsAccessor,
       stamper,
-      name: platformName
+      name: platformName,
       // Use detected browser name and version for identification
+      analyticsHeaders: {
+        [import_constants2.ANALYTICS_HEADERS.SDK_TYPE]: "browser",
+        [import_constants2.ANALYTICS_HEADERS.PLATFORM]: browserName,
+        // firefox, chrome, safari, etc.
+        [import_constants2.ANALYTICS_HEADERS.PLATFORM_VERSION]: version,
+        // Full user agent for more detailed info
+        [import_constants2.ANALYTICS_HEADERS.APP_ID]: config.appId,
+        [import_constants2.ANALYTICS_HEADERS.WALLET_TYPE]: config.embeddedWalletType,
+        [import_constants2.ANALYTICS_HEADERS.SDK_VERSION]: "1.0.0-beta.4"
+        // Replaced at build time
+      }
     };
     debug.log(DebugCategory.EMBEDDED_PROVIDER, "Detected platform", { platformName });
     const logger = new BrowserLogger();
@@ -1082,6 +1153,7 @@ var EmbeddedProvider = class extends import_embedded_provider_core.EmbeddedProvi
 };
 
 // src/ProviderManager.ts
+var import_constants3 = require("@phantom/constants");
 var ProviderManager = class {
   // Track which providers have forwarding set up
   constructor(config) {
@@ -1100,6 +1172,15 @@ var ProviderManager = class {
       currentProviderKey: this.currentProviderKey
     });
   }
+  getValidatedCurrentUrl() {
+    if (typeof window === "undefined")
+      return "";
+    const currentUrl = window.location.href;
+    if (!currentUrl.startsWith("http:") && !currentUrl.startsWith("https:")) {
+      throw new Error("Invalid URL protocol - only HTTP/HTTPS URLs are supported");
+    }
+    return currentUrl;
+  }
   /**
    * Switch to a different provider type
    */
@@ -1131,7 +1212,8 @@ var ProviderManager = class {
   getCurrentProviderInfo() {
     if (!this.currentProviderKey)
       return null;
-    const [type, embeddedWalletType] = this.currentProviderKey.split("-");
+    const parts = this.currentProviderKey.split("-");
+    const [type, embeddedWalletType] = parts;
     return {
       type,
       embeddedWalletType
@@ -1277,7 +1359,7 @@ var ProviderManager = class {
    */
   setDefaultProvider() {
     const defaultType = this.config.providerType || "embedded";
-    const defaultEmbeddedType = this.config.embeddedWalletType || "app-wallet";
+    const defaultEmbeddedType = this.config.embeddedWalletType || "user-wallet";
     this.createProvider(defaultType, defaultEmbeddedType);
     this.switchProvider(defaultType, { embeddedWalletType: defaultEmbeddedType });
   }
@@ -1291,22 +1373,28 @@ var ProviderManager = class {
     let provider;
     if (type === "injected") {
       provider = new InjectedProvider({
-        solanaProvider: this.config.solanaProvider || "web3js",
         addressTypes: this.config.addressTypes
       });
-    } else {
-      if (!this.config.apiBaseUrl || !this.config.appId) {
-        throw new Error("apiBaseUrl and appId are required for embedded provider");
+    } else if (type === "embedded") {
+      if (!this.config.appId) {
+        throw new Error("appId is required for embedded provider");
       }
+      const apiBaseUrl = this.config.apiBaseUrl || import_constants3.DEFAULT_WALLET_API_URL;
+      const authUrl = this.config.authOptions?.authUrl || import_constants3.DEFAULT_AUTH_URL;
       provider = new EmbeddedProvider({
-        apiBaseUrl: this.config.apiBaseUrl,
+        apiBaseUrl,
         organizationId: this.config.appId,
         appId: this.config.appId,
-        authOptions: this.config.authOptions,
-        embeddedWalletType: embeddedWalletType || "app-wallet",
-        addressTypes: this.config.addressTypes,
-        solanaProvider: this.config.solanaProvider || "web3js"
+        authOptions: {
+          ...this.config.authOptions || {},
+          authUrl,
+          redirectUrl: this.config.authOptions?.redirectUrl || this.getValidatedCurrentUrl()
+        },
+        embeddedWalletType: embeddedWalletType || import_constants3.DEFAULT_EMBEDDED_WALLET_TYPE,
+        addressTypes: this.config.addressTypes
       });
+    } else {
+      throw new Error(`Unsupported provider type: ${type}`);
     }
     this.providers.set(key, provider);
   }
@@ -1316,8 +1404,10 @@ var ProviderManager = class {
   getProviderKey(type, embeddedWalletType) {
     if (type === "injected") {
       return "injected";
+    } else if (type === "embedded") {
+      return `embedded-${embeddedWalletType || "app-wallet"}`;
     }
-    return `embedded-${embeddedWalletType || "app-wallet"}`;
+    throw new Error(`Unsupported provider type: ${type}`);
   }
   /**
    * Save provider preference to localStorage
@@ -1378,6 +1468,7 @@ async function waitForPhantomExtension(timeoutMs = 3e3) {
 }
 
 // src/BrowserSDK.ts
+var import_constants4 = require("@phantom/constants");
 var BrowserSDK = class {
   constructor(config) {
     debug.info(DebugCategory.BROWSER_SDK, "Initializing BrowserSDK", {
@@ -1389,7 +1480,7 @@ var BrowserSDK = class {
       debug.error(DebugCategory.BROWSER_SDK, "Invalid providerType", { providerType: config.providerType });
       throw new Error(`Invalid providerType: ${config.providerType}. Must be "injected" or "embedded".`);
     }
-    const embeddedWalletType = config.embeddedWalletType || "app-wallet";
+    const embeddedWalletType = config.embeddedWalletType || import_constants4.DEFAULT_EMBEDDED_WALLET_TYPE;
     if (config.providerType === "embedded" && !["app-wallet", "user-wallet"].includes(embeddedWalletType)) {
       debug.error(DebugCategory.BROWSER_SDK, "Invalid embeddedWalletType", {
         embeddedWalletType: config.embeddedWalletType
@@ -1677,6 +1768,16 @@ var BrowserSDK = class {
 // src/types.ts
 var import_client4 = require("@phantom/client");
 
+// src/utils/deeplink.ts
+function getDeeplinkToPhantom(ref) {
+  if (!window.location.href.startsWith("http:") && !window.location.href.startsWith("https:")) {
+    throw new Error("Invalid URL protocol - only HTTP/HTTPS URLs are supported for deeplinks");
+  }
+  const currentUrl = encodeURIComponent(window.location.href);
+  const refParam = ref ? `?ref=${encodeURIComponent(ref)}` : "";
+  return `https://phantom.app/ul/browse/${currentUrl}${refParam}`;
+}
+
 // src/index.ts
-var import_constants2 = require("@phantom/constants");
+var import_constants5 = require("@phantom/constants");
 var import_client5 = require("@phantom/client");

package/dist/index.mjs

@@ -142,8 +142,27 @@ var InjectedSolanaChain = class {
     const result = await this.phantom.solana.signAndSendTransaction(transaction);
     return { signature: result.signature };
   }
-  signAllTransactions(_transactions) {
-    return Promise.reject(new Error("Sign-only transactions not supported by injected provider"));
+  async signAllTransactions(transactions) {
+    if (!this.callbacks.isConnected()) {
+      return Promise.reject(new Error("Provider not connected. Call provider connect first."));
+    }
+    try {
+      const result = await this.phantom.solana.signAllTransactions(transactions);
+      return result;
+    } catch (error) {
+      return Promise.reject(error);
+    }
+  }
+  async signAndSendAllTransactions(transactions) {
+    if (!this.callbacks.isConnected()) {
+      return Promise.reject(new Error("Provider not connected. Call provider connect first."));
+    }
+    try {
+      const result = await this.phantom.solana.signAndSendAllTransactions(transactions);
+      return { signatures: result.signatures };
+    } catch (error) {
+      return Promise.reject(error);
+    }
   }
   switchNetwork(_network) {
     return Promise.resolve();
@@ -772,15 +791,19 @@ var BrowserURLParamsAccessor = class {
 };
 var browserUrlParamsAccessor = new BrowserURLParamsAccessor();
 
-// src/constants.ts
-var DEFAULT_AUTH_URL = "https://connect.phantom.app";
-var DEFAULT_WALLET_API_URL = "https://api.phantom.app/v1/wallets";
-
 // src/providers/embedded/adapters/auth.ts
+import { DEFAULT_AUTH_URL } from "@phantom/constants";
 var BrowserAuthProvider = class {
   constructor(urlParamsAccessor) {
     this.urlParamsAccessor = urlParamsAccessor;
   }
+  getValidatedCurrentUrl() {
+    const currentUrl = window.location.href;
+    if (!currentUrl.startsWith("http:") && !currentUrl.startsWith("https:")) {
+      throw new Error("Invalid URL protocol - only HTTP/HTTPS URLs are supported");
+    }
+    return currentUrl;
+  }
   authenticate(options) {
     return new Promise((resolve) => {
       if ("jwtToken" in options) {
@@ -801,7 +824,7 @@ var BrowserAuthProvider = class {
         organization_id: phantomOptions.organizationId,
         parent_organization_id: phantomOptions.parentOrganizationId,
         app_id: phantomOptions.appId,
-        redirect_uri: phantomOptions.redirectUrl || (typeof window !== "undefined" ? window.location.href : ""),
+        redirect_uri: phantomOptions.redirectUrl || (typeof window !== "undefined" ? this.getValidatedCurrentUrl() : ""),
         session_id: phantomOptions.sessionId,
         clear_previous_session: true.toString()
       });
@@ -829,6 +852,9 @@ var BrowserAuthProvider = class {
       debug.log(DebugCategory.PHANTOM_CONNECT_AUTH, "Stored auth context in session storage", { authContext });
       const authUrl = `${baseUrl}?${params.toString()}`;
       debug.info(DebugCategory.PHANTOM_CONNECT_AUTH, "Redirecting to Phantom Connect", { authUrl });
+      if (!authUrl.startsWith("https:")) {
+        throw new Error("Invalid auth URL - only HTTPS URLs are allowed for authentication");
+      }
       window.location.href = authUrl;
       resolve();
     });
@@ -917,7 +943,7 @@ function parseBrowserFromUserAgent(userAgent, hasBraveAPI) {
   let name = "unknown";
   let version = "unknown";
   if (!userAgent || typeof userAgent !== "string") {
-    return { name, version };
+    return { name, version, userAgent: "unknown" };
   }
   try {
     if (userAgent.includes("Edg/")) {
@@ -999,11 +1025,11 @@ function parseBrowserFromUserAgent(userAgent, hasBraveAPI) {
     }
   } catch (error) {
   }
-  return { name, version };
+  return { name, version, userAgent };
 }
 function detectBrowser() {
   if (typeof window === "undefined" || !window.navigator?.userAgent) {
-    return { name: "unknown", version: "unknown" };
+    return { name: "unknown", version: "unknown", userAgent: "unknown" };
   }
   const userAgent = window.navigator.userAgent;
   const hasBraveAPI = !!navigator.brave;
@@ -1018,8 +1044,41 @@ function getBrowserDisplayName() {
   const capitalizedName = name.charAt(0).toUpperCase() + name.slice(1);
   return version !== "unknown" ? `${capitalizedName} ${version}` : capitalizedName;
 }
+function isMobileDevice() {
+  if (typeof window === "undefined" || !window.navigator?.userAgent) {
+    return false;
+  }
+  const userAgent = window.navigator.userAgent.toLowerCase();
+  const mobilePatterns = [
+    /android/,
+    /iphone|ipad|ipod/,
+    /blackberry/,
+    /windows phone/,
+    /mobile/,
+    /tablet/,
+    /silk/,
+    /kindle/,
+    /opera mini/,
+    /opera mobi/
+  ];
+  const isMobileUA = mobilePatterns.some((pattern) => pattern.test(userAgent));
+  let isSmallScreen = false;
+  try {
+    isSmallScreen = window.screen.width <= 768 || window.screen.height <= 768;
+  } catch (error) {
+    isSmallScreen = false;
+  }
+  let isTouchDevice = false;
+  try {
+    isTouchDevice = "ontouchstart" in window || navigator.maxTouchPoints > 0;
+  } catch (error) {
+    isTouchDevice = false;
+  }
+  return isMobileUA || isSmallScreen && isTouchDevice;
+}
 
 // src/providers/embedded/index.ts
+import { ANALYTICS_HEADERS } from "@phantom/constants";
 var EmbeddedProvider = class extends CoreEmbeddedProvider {
   constructor(config) {
     debug.log(DebugCategory.EMBEDDED_PROVIDER, "Initializing Browser EmbeddedProvider", { config });
@@ -1030,13 +1089,25 @@ var EmbeddedProvider = class extends CoreEmbeddedProvider {
       keyName: "signing-key"
     });
     const platformName = getPlatformName();
+    const { name: browserName, version } = detectBrowser();
     const platform = {
       storage: new BrowserStorage(),
       authProvider: new BrowserAuthProvider(urlParamsAccessor),
       urlParamsAccessor,
       stamper,
-      name: platformName
+      name: platformName,
       // Use detected browser name and version for identification
+      analyticsHeaders: {
+        [ANALYTICS_HEADERS.SDK_TYPE]: "browser",
+        [ANALYTICS_HEADERS.PLATFORM]: browserName,
+        // firefox, chrome, safari, etc.
+        [ANALYTICS_HEADERS.PLATFORM_VERSION]: version,
+        // Full user agent for more detailed info
+        [ANALYTICS_HEADERS.APP_ID]: config.appId,
+        [ANALYTICS_HEADERS.WALLET_TYPE]: config.embeddedWalletType,
+        [ANALYTICS_HEADERS.SDK_VERSION]: "1.0.0-beta.4"
+        // Replaced at build time
+      }
     };
     debug.log(DebugCategory.EMBEDDED_PROVIDER, "Detected platform", { platformName });
     const logger = new BrowserLogger();
@@ -1046,6 +1117,7 @@ var EmbeddedProvider = class extends CoreEmbeddedProvider {
 };
 
 // src/ProviderManager.ts
+import { DEFAULT_WALLET_API_URL, DEFAULT_EMBEDDED_WALLET_TYPE, DEFAULT_AUTH_URL as DEFAULT_AUTH_URL2 } from "@phantom/constants";
 var ProviderManager = class {
   // Track which providers have forwarding set up
   constructor(config) {
@@ -1064,6 +1136,15 @@ var ProviderManager = class {
       currentProviderKey: this.currentProviderKey
     });
   }
+  getValidatedCurrentUrl() {
+    if (typeof window === "undefined")
+      return "";
+    const currentUrl = window.location.href;
+    if (!currentUrl.startsWith("http:") && !currentUrl.startsWith("https:")) {
+      throw new Error("Invalid URL protocol - only HTTP/HTTPS URLs are supported");
+    }
+    return currentUrl;
+  }
   /**
    * Switch to a different provider type
    */
@@ -1095,7 +1176,8 @@ var ProviderManager = class {
   getCurrentProviderInfo() {
     if (!this.currentProviderKey)
       return null;
-    const [type, embeddedWalletType] = this.currentProviderKey.split("-");
+    const parts = this.currentProviderKey.split("-");
+    const [type, embeddedWalletType] = parts;
     return {
       type,
       embeddedWalletType
@@ -1241,7 +1323,7 @@ var ProviderManager = class {
    */
   setDefaultProvider() {
     const defaultType = this.config.providerType || "embedded";
-    const defaultEmbeddedType = this.config.embeddedWalletType || "app-wallet";
+    const defaultEmbeddedType = this.config.embeddedWalletType || "user-wallet";
     this.createProvider(defaultType, defaultEmbeddedType);
     this.switchProvider(defaultType, { embeddedWalletType: defaultEmbeddedType });
   }
@@ -1255,22 +1337,28 @@ var ProviderManager = class {
     let provider;
     if (type === "injected") {
       provider = new InjectedProvider({
-        solanaProvider: this.config.solanaProvider || "web3js",
         addressTypes: this.config.addressTypes
       });
-    } else {
-      if (!this.config.apiBaseUrl || !this.config.appId) {
-        throw new Error("apiBaseUrl and appId are required for embedded provider");
+    } else if (type === "embedded") {
+      if (!this.config.appId) {
+        throw new Error("appId is required for embedded provider");
       }
+      const apiBaseUrl = this.config.apiBaseUrl || DEFAULT_WALLET_API_URL;
+      const authUrl = this.config.authOptions?.authUrl || DEFAULT_AUTH_URL2;
       provider = new EmbeddedProvider({
-        apiBaseUrl: this.config.apiBaseUrl,
+        apiBaseUrl,
         organizationId: this.config.appId,
         appId: this.config.appId,
-        authOptions: this.config.authOptions,
-        embeddedWalletType: embeddedWalletType || "app-wallet",
-        addressTypes: this.config.addressTypes,
-        solanaProvider: this.config.solanaProvider || "web3js"
+        authOptions: {
+          ...this.config.authOptions || {},
+          authUrl,
+          redirectUrl: this.config.authOptions?.redirectUrl || this.getValidatedCurrentUrl()
+        },
+        embeddedWalletType: embeddedWalletType || DEFAULT_EMBEDDED_WALLET_TYPE,
+        addressTypes: this.config.addressTypes
       });
+    } else {
+      throw new Error(`Unsupported provider type: ${type}`);
     }
     this.providers.set(key, provider);
   }
@@ -1280,8 +1368,10 @@ var ProviderManager = class {
   getProviderKey(type, embeddedWalletType) {
     if (type === "injected") {
       return "injected";
+    } else if (type === "embedded") {
+      return `embedded-${embeddedWalletType || "app-wallet"}`;
     }
-    return `embedded-${embeddedWalletType || "app-wallet"}`;
+    throw new Error(`Unsupported provider type: ${type}`);
   }
   /**
    * Save provider preference to localStorage
@@ -1342,6 +1432,7 @@ async function waitForPhantomExtension(timeoutMs = 3e3) {
 }
 
 // src/BrowserSDK.ts
+import { DEFAULT_EMBEDDED_WALLET_TYPE as DEFAULT_EMBEDDED_WALLET_TYPE2 } from "@phantom/constants";
 var BrowserSDK = class {
   constructor(config) {
     debug.info(DebugCategory.BROWSER_SDK, "Initializing BrowserSDK", {
@@ -1353,7 +1444,7 @@ var BrowserSDK = class {
       debug.error(DebugCategory.BROWSER_SDK, "Invalid providerType", { providerType: config.providerType });
       throw new Error(`Invalid providerType: ${config.providerType}. Must be "injected" or "embedded".`);
     }
-    const embeddedWalletType = config.embeddedWalletType || "app-wallet";
+    const embeddedWalletType = config.embeddedWalletType || DEFAULT_EMBEDDED_WALLET_TYPE2;
     if (config.providerType === "embedded" && !["app-wallet", "user-wallet"].includes(embeddedWalletType)) {
       debug.error(DebugCategory.BROWSER_SDK, "Invalid embeddedWalletType", {
         embeddedWalletType: config.embeddedWalletType
@@ -1641,21 +1732,31 @@ var BrowserSDK = class {
 // src/types.ts
 import { AddressType as AddressType4 } from "@phantom/client";
 
+// src/utils/deeplink.ts
+function getDeeplinkToPhantom(ref) {
+  if (!window.location.href.startsWith("http:") && !window.location.href.startsWith("https:")) {
+    throw new Error("Invalid URL protocol - only HTTP/HTTPS URLs are supported for deeplinks");
+  }
+  const currentUrl = encodeURIComponent(window.location.href);
+  const refParam = ref ? `?ref=${encodeURIComponent(ref)}` : "";
+  return `https://phantom.app/ul/browse/${currentUrl}${refParam}`;
+}
+
 // src/index.ts
 import { NetworkId } from "@phantom/constants";
 import { AddressType as AddressType5 } from "@phantom/client";
 export {
   AddressType5 as AddressType,
   BrowserSDK,
-  DEFAULT_AUTH_URL,
-  DEFAULT_WALLET_API_URL,
   DebugCategory,
   DebugLevel,
   NetworkId,
   debug,
   detectBrowser,
   getBrowserDisplayName,
+  getDeeplinkToPhantom,
   getPlatformName,
+  isMobileDevice,
   parseBrowserFromUserAgent,
   waitForPhantomExtension
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phantom/browser-sdk",
-  "version": "1.0.0-beta.2",
+  "version": "1.0.0-beta.4",
   "description": "Browser SDK for Phantom Wallet",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -28,14 +28,15 @@
     "prettier": "prettier --write \"src/**/*.{ts,tsx}\""
   },
   "dependencies": {
-    "@phantom/base64url": "^1.0.0-beta.2",
-    "@phantom/browser-injected-sdk": "^1.0.0-beta.2",
-    "@phantom/chains": "^1.0.0-beta.2",
-    "@phantom/client": "^1.0.0-beta.2",
-    "@phantom/constants": "^1.0.0-beta.2",
-    "@phantom/embedded-provider-core": "^1.0.0-beta.2",
+    "@phantom/base64url": "^1.0.0-beta.4",
+    "@phantom/browser-injected-sdk": "^1.0.0-beta.3",
+    "@phantom/chains": "^1.0.0-beta.4",
+    "@phantom/client": "^1.0.0-beta.4",
+    "@phantom/constants": "^1.0.0-beta.4",
+    "@phantom/embedded-provider-core": "^1.0.0-beta.4",
     "@phantom/indexed-db-stamper": "^1.0.0-beta.1",
-    "@phantom/parsers": "^1.0.0-beta.2",
+    "@phantom/parsers": "^1.0.0-beta.4",
+    "@phantom/sdk-types": "^1.0.0-beta.4",
     "axios": "^1.10.0",
     "bs58": "^6.0.0",
     "buffer": "^6.0.3",