@phantom/browser-sdk 0.2.3 → 0.3.1

package/README.md

@@ -37,7 +37,7 @@ import { BrowserSDK, AddressType, NetworkId } from "@phantom/browser-sdk";
 const sdk = new BrowserSDK({
   providerType: "embedded",
   addressTypes: [AddressType.solana, AddressType.ethereum],
-  apiBaseUrl: "https://api.phantom.com",
+  apiBaseUrl: "https://api.phantom.app/v1/wallets",
   organizationId: "your-org-id",
 });
 
@@ -80,7 +80,7 @@ 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.com",
+  apiBaseUrl: "https://api.phantom.app/v1/wallets",
   organizationId: "your-org-id",
   embeddedWalletType: "app-wallet", // or 'user-wallet'
   authOptions: {
@@ -237,7 +237,6 @@ const result = await sdk.connect({
 **Authentication Flow Types:**
 
 1. **Phantom Connect (Redirect-based)**: Used when `provider` is undefined, `"google"`, or `"apple"`
-
    - Redirects to `https://connect.phantom.app` (or custom `authOptions.authUrl` from config)
    - Handles OAuth flow with selected provider
    - Returns to your app with authentication result using `authOptions.redirectUrl` or current page
@@ -317,17 +316,35 @@ npm install @solana/web3.js
 ```
 
 ```typescript
-import { Transaction, SystemProgram, PublicKey, LAMPORTS_PER_SOL } from "@solana/web3.js";
+import {
+  VersionedTransaction,
+  TransactionMessage,
+  SystemProgram,
+  PublicKey,
+  LAMPORTS_PER_SOL,
+  Connection,
+} from "@solana/web3.js";
 import { BrowserSDK, NetworkId } from "@phantom/browser-sdk";
 
-// Create native Solana transaction
-const transaction = new Transaction().add(
-  SystemProgram.transfer({
-    fromPubkey: new PublicKey(fromAddress),
-    toPubkey: new PublicKey(toAddress),
-    lamports: 0.001 * LAMPORTS_PER_SOL,
-  }),
-);
+// Get recent blockhash
+const connection = new Connection("https://api.mainnet-beta.solana.com");
+const { blockhash } = await connection.getLatestBlockhash();
+
+// Create transfer instruction
+const transferInstruction = SystemProgram.transfer({
+  fromPubkey: new PublicKey(fromAddress),
+  toPubkey: new PublicKey(toAddress),
+  lamports: 0.001 * LAMPORTS_PER_SOL,
+});
+
+// Create VersionedTransaction
+const messageV0 = new TransactionMessage({
+  payerKey: new PublicKey(fromAddress),
+  recentBlockhash: blockhash,
+  instructions: [transferInstruction],
+}).compileToV0Message();
+
+const transaction = new VersionedTransaction(messageV0);
 
 // Send native transaction object - no encoding needed!
 const result = await sdk.signAndSendTransaction({
@@ -553,19 +570,31 @@ import { BrowserSDK, AddressType } from "@phantom/browser-sdk";
 
 const sdk = new BrowserSDK({
   addressTypes: [AddressType.solana, AddressType.ethereum, AddressType.sui],
-  apiBaseUrl: "https://api.phantom.com",
+  apiBaseUrl: "https://api.phantom.app/v1/wallets",
   organizationId: "your-org-id",
 });
 
 class MultiChainWallet {
   async sendSolana(amount: number, recipient: string) {
-    const transaction = new Transaction().add(
-      SystemProgram.transfer({
-        fromPubkey: new PublicKey(this.solanaAddress),
-        toPubkey: new PublicKey(recipient),
-        lamports: amount * LAMPORTS_PER_SOL,
-      }),
-    );
+    // Get recent blockhash
+    const connection = new Connection("https://api.mainnet-beta.solana.com");
+    const { blockhash } = await connection.getLatestBlockhash();
+
+    // Create transfer instruction
+    const transferInstruction = SystemProgram.transfer({
+      fromPubkey: new PublicKey(this.solanaAddress),
+      toPubkey: new PublicKey(recipient),
+      lamports: amount * LAMPORTS_PER_SOL,
+    });
+
+    // Create VersionedTransaction
+    const messageV0 = new TransactionMessage({
+      payerKey: new PublicKey(this.solanaAddress),
+      recentBlockhash: blockhash,
+      instructions: [transferInstruction],
+    }).compileToV0Message();
+
+    const transaction = new VersionedTransaction(messageV0);
 
     return await sdk.signAndSendTransaction({
       networkId: NetworkId.SOLANA_MAINNET,
@@ -728,7 +757,7 @@ For embedded wallets, you need to set up a backend endpoint. Add the `serverUrl`
 const sdk = new BrowserSDK({
   providerType: "embedded",
   addressTypes: [AddressType.solana],
-  apiBaseUrl: "https://api.phantom.com",
+  apiBaseUrl: "https://api.phantom.app/v1/wallets",
   organizationId: "your-org-id",
   serverUrl: "http://localhost:3000/api",
 });

package/dist/index.d.ts

@@ -1,7 +1,8 @@
 import { AddressType } from '@phantom/client';
-export { AddressType, NetworkId } from '@phantom/client';
-import { AuthOptions, ConnectResult, SignMessageParams, SignAndSendTransactionParams, SignedTransaction, WalletAddress } from '@phantom/embedded-provider-core';
-export { AuthOptions, ConnectResult, SignAndSendTransactionParams, SignMessageParams, SignedTransaction, WalletAddress } from '@phantom/embedded-provider-core';
+export { AddressType } from '@phantom/client';
+import { AuthOptions, ConnectResult, SignMessageParams, SignMessageResult, SignAndSendTransactionParams, SignedTransaction, WalletAddress } from '@phantom/embedded-provider-core';
+export { AuthOptions, ConnectResult, SignAndSendTransactionParams, SignMessageParams, SignMessageResult, SignedTransaction, WalletAddress } from '@phantom/embedded-provider-core';
+export { NetworkId } from '@phantom/constants';
 
 declare enum DebugLevel {
     ERROR = 0,
@@ -77,7 +78,7 @@ interface CreateUserOrganizationResult {
 interface Provider {
     connect(authOptions?: AuthOptions): Promise<ConnectResult>;
     disconnect(): Promise<void>;
-    signMessage(params: SignMessageParams): Promise<string>;
+    signMessage(params: SignMessageParams): Promise<SignMessageResult>;
     signAndSendTransaction(params: SignAndSendTransactionParams): Promise<SignedTransaction>;
     getAddresses(): WalletAddress[];
     isConnected(): boolean;
@@ -125,7 +126,7 @@ declare class BrowserSDK {
      * @param networkId - Network identifier
      * @returns Signature string
      */
-    signMessage(params: SignMessageParams): Promise<string>;
+    signMessage(params: SignMessageParams): Promise<SignMessageResult>;
     /**
      * Sign and send a transaction
      * @param params - Transaction parameters with native transaction object
@@ -158,4 +159,31 @@ declare class BrowserSDK {
 declare const DEFAULT_AUTH_URL = "https://connect.phantom.app";
 declare const DEFAULT_WALLET_API_URL = "https://api.phantom.app/v1/wallets";
 
-export { BrowserSDK, BrowserSDKConfig, CreateUserOrganizationParams, CreateUserOrganizationResult, DEFAULT_AUTH_URL, DEFAULT_WALLET_API_URL, DebugCallback, DebugCategory, DebugLevel, DebugMessage, Provider, debug };
+/**
+ * Browser detection utility to identify browser name and version
+ */
+interface BrowserInfo {
+    name: string;
+    version: string;
+}
+/**
+ * Parse browser information from a user agent string
+ * This is the core parsing logic that can be unit tested independently
+ */
+declare function parseBrowserFromUserAgent(userAgent: string, hasBraveAPI?: boolean): BrowserInfo;
+/**
+ * Detect the current browser and version from the user agent string
+ */
+declare function detectBrowser(): BrowserInfo;
+/**
+ * Get a formatted platform name for use in authenticator names
+ * Format: "browsername-v123" (e.g., "chrome-v120", "firefox-v119")
+ */
+declare function getPlatformName(): string;
+/**
+ * Get detailed browser information as a string
+ * Format: "Chrome 120.0" or "Firefox 119.0"
+ */
+declare function getBrowserDisplayName(): string;
+
+export { BrowserInfo, BrowserSDK, BrowserSDKConfig, CreateUserOrganizationParams, CreateUserOrganizationResult, DEFAULT_AUTH_URL, DEFAULT_WALLET_API_URL, DebugCallback, DebugCategory, DebugLevel, DebugMessage, Provider, debug, detectBrowser, getBrowserDisplayName, getPlatformName, parseBrowserFromUserAgent };

package/dist/index.js

@@ -1,7 +1,9 @@
 "use strict";
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -15,6 +17,14 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
@@ -26,8 +36,12 @@ __export(src_exports, {
   DEFAULT_WALLET_API_URL: () => DEFAULT_WALLET_API_URL,
   DebugCategory: () => DebugCategory,
   DebugLevel: () => DebugLevel,
-  NetworkId: () => import_client2.NetworkId,
-  debug: () => debug
+  NetworkId: () => import_constants3.NetworkId,
+  debug: () => debug,
+  detectBrowser: () => detectBrowser,
+  getBrowserDisplayName: () => getBrowserDisplayName,
+  getPlatformName: () => getPlatformName,
+  parseBrowserFromUserAgent: () => parseBrowserFromUserAgent
 });
 module.exports = __toCommonJS(src_exports);
 
@@ -112,6 +126,9 @@ var DebugCategory = {
 };
 
 // src/providers/injected/index.ts
+var import_base64url = require("@phantom/base64url");
+var import_constants = require("@phantom/constants");
+var import_bs58 = __toESM(require("bs58"));
 var InjectedProvider = class {
   constructor(config) {
     this.connected = false;
@@ -210,18 +227,24 @@ var InjectedProvider = class {
       throw new Error("Wallet not connected");
     }
     const networkPrefix = params.networkId.split(":")[0].toLowerCase();
+    let signatureResult;
     if (networkPrefix === "solana") {
       const { signature } = await this.phantom.solana.signMessage(new TextEncoder().encode(params.message));
-      return Array.from(signature).map((b) => b.toString(16).padStart(2, "0")).join("");
+      signatureResult = import_bs58.default.encode(signature);
     } else if (networkPrefix === "ethereum" || networkPrefix === "polygon" || networkPrefix === "eip155") {
       const address = this.addresses.find((addr) => addr.addressType === import_client.AddressType.ethereum)?.address;
       if (!address) {
         throw new Error("No address available");
       }
       const signature = await this.phantom.ethereum.signPersonalMessage(params.message, address);
-      return signature;
+      signatureResult = signature;
+    } else {
+      throw new Error(`Network ${params.networkId} is not supported for injected wallets`);
     }
-    throw new Error(`Network ${params.networkId} is not supported for injected wallets`);
+    return {
+      signature: signatureResult,
+      rawSignature: (0, import_base64url.base64urlEncode)(signatureResult)
+    };
   }
   async signAndSendTransaction(params) {
     if (!this.connected) {
@@ -232,7 +255,9 @@ var InjectedProvider = class {
       const transaction = params.transaction;
       const result = await this.phantom.solana.signAndSendTransaction(transaction);
       return {
-        rawTransaction: result.signature
+        hash: result.signature,
+        rawTransaction: (0, import_base64url.base64urlEncode)(result.signature),
+        blockExplorer: (0, import_constants.getExplorerUrl)(params.networkId, "transaction", result.signature)
       };
     } else if (networkPrefix === "ethereum" || networkPrefix === "polygon" || networkPrefix === "eip155") {
       const toHex = (value) => {
@@ -255,7 +280,9 @@ var InjectedProvider = class {
       };
       const txHash = await this.phantom.ethereum.sendTransaction(txRequest);
       return {
-        rawTransaction: txHash
+        hash: txHash,
+        rawTransaction: (0, import_base64url.base64urlEncode)(txHash),
+        blockExplorer: (0, import_constants.getExplorerUrl)(params.networkId, "transaction", txHash)
       };
     }
     throw new Error(`Network ${params.networkId} is not supported for injected wallets`);
@@ -270,6 +297,7 @@ var InjectedProvider = class {
 
 // src/providers/embedded/index.ts
 var import_embedded_provider_core = require("@phantom/embedded-provider-core");
+var import_indexed_db_stamper = require("@phantom/indexed-db-stamper");
 
 // src/providers/embedded/adapters/storage.ts
 var BrowserStorage = class {
@@ -495,16 +523,133 @@ var BrowserLogger = class {
   }
 };
 
+// src/utils/browser-detection.ts
+function parseBrowserFromUserAgent(userAgent, hasBraveAPI) {
+  let name = "unknown";
+  let version = "unknown";
+  if (!userAgent || typeof userAgent !== "string") {
+    return { name, version };
+  }
+  try {
+    if (userAgent.includes("Edg/")) {
+      name = "edge";
+      const match = userAgent.match(/Edg\/([0-9]+(?:\.[0-9]+)*)/);
+      if (match)
+        version = match[1].split(".")[0];
+    } else if (userAgent.includes("OPR/") || userAgent.includes("Opera/")) {
+      name = "opera";
+      const match = userAgent.match(/(?:OPR|Opera)\/([0-9]+(?:\.[0-9]+)*)/);
+      if (match)
+        version = match[1].split(".")[0];
+    } else if (userAgent.includes("SamsungBrowser/")) {
+      name = "samsung";
+      const match = userAgent.match(/SamsungBrowser\/([0-9]+(?:\.[0-9]+)*)/);
+      if (match)
+        version = match[1].split(".")[0];
+    } else if (userAgent.includes("DuckDuckGo/")) {
+      name = "duckduckgo";
+      const match = userAgent.match(/DuckDuckGo\/([0-9]+(?:\.[0-9]+)*)/);
+      if (match)
+        version = match[1].split(".")[0];
+    } else if (userAgent.includes("Chrome/") && hasBraveAPI) {
+      name = "brave";
+      const match = userAgent.match(/Chrome\/([0-9]+(?:\.[0-9]+)*)/);
+      if (match)
+        version = match[1].split(".")[0];
+    } else if (userAgent.includes("Mobile/") || userAgent.includes("Android")) {
+      if (userAgent.includes("Chrome/")) {
+        name = "chrome-mobile";
+        const match = userAgent.match(/Chrome\/([0-9]+(?:\.[0-9]+)*)/);
+        if (match)
+          version = match[1].split(".")[0];
+      } else if (userAgent.includes("Firefox/")) {
+        name = "firefox-mobile";
+        const match = userAgent.match(/Firefox\/([0-9]+(?:\.[0-9]+)*)/);
+        if (match)
+          version = match[1].split(".")[0];
+      } else if (userAgent.includes("Safari/") && userAgent.includes("Mobile/")) {
+        name = "safari-mobile";
+        const match = userAgent.match(/Version\/([0-9]+(?:\.[0-9]+)*)/);
+        if (match)
+          version = match[1].split(".")[0];
+      } else {
+        name = "mobile";
+      }
+    } else if (userAgent.includes("Chrome/")) {
+      name = "chrome";
+      const match = userAgent.match(/Chrome\/([0-9]+(?:\.[0-9]+)*)/);
+      if (match)
+        version = match[1].split(".")[0];
+    } else if (userAgent.includes("Firefox/")) {
+      name = "firefox";
+      const match = userAgent.match(/Firefox\/([0-9]+(?:\.[0-9]+)*)/);
+      if (match)
+        version = match[1].split(".")[0];
+    } else if (userAgent.includes("Safari/") && !userAgent.includes("Chrome/")) {
+      name = "safari";
+      const match = userAgent.match(/Version\/([0-9]+(?:\.[0-9]+)*)/);
+      if (match)
+        version = match[1].split(".")[0];
+    }
+    if (name === "unknown") {
+      const patterns = [
+        { regex: /Chrome\/([0-9]+)/, name: "chrome" },
+        { regex: /Firefox\/([0-9]+)/, name: "firefox" },
+        { regex: /Safari\/([0-9]+)/, name: "safari" },
+        { regex: /Edge\/([0-9]+)/, name: "edge" },
+        { regex: /Opera\/([0-9]+)/, name: "opera" }
+      ];
+      for (const pattern of patterns) {
+        const match = userAgent.match(pattern.regex);
+        if (match) {
+          name = pattern.name;
+          version = match[1];
+          break;
+        }
+      }
+    }
+  } catch (error) {
+  }
+  return { name, version };
+}
+function detectBrowser() {
+  if (typeof window === "undefined" || !window.navigator?.userAgent) {
+    return { name: "unknown", version: "unknown" };
+  }
+  const userAgent = window.navigator.userAgent;
+  const hasBraveAPI = !!navigator.brave;
+  return parseBrowserFromUserAgent(userAgent, hasBraveAPI);
+}
+function getPlatformName() {
+  const { name, version } = detectBrowser();
+  return version !== "unknown" ? `${name}-v${version}` : name;
+}
+function getBrowserDisplayName() {
+  const { name, version } = detectBrowser();
+  const capitalizedName = name.charAt(0).toUpperCase() + name.slice(1);
+  return version !== "unknown" ? `${capitalizedName} ${version}` : capitalizedName;
+}
+
 // src/providers/embedded/index.ts
 var EmbeddedProvider = class extends import_embedded_provider_core.EmbeddedProvider {
   constructor(config) {
     debug.log(DebugCategory.EMBEDDED_PROVIDER, "Initializing Browser EmbeddedProvider", { config });
     const urlParamsAccessor = new BrowserURLParamsAccessor();
+    const stamper = new import_indexed_db_stamper.IndexedDbStamper({
+      dbName: `phantom-embedded-sdk-${config.organizationId}`,
+      storeName: "crypto-keys",
+      keyName: "signing-key"
+    });
+    const platformName = getPlatformName();
     const platform = {
       storage: new BrowserStorage(),
       authProvider: new BrowserAuthProvider(urlParamsAccessor),
-      urlParamsAccessor
+      urlParamsAccessor,
+      stamper,
+      name: platformName
+      // Use detected browser name and version for identification
     };
+    debug.log(DebugCategory.EMBEDDED_PROVIDER, "Detected platform", { platformName });
     const logger = new BrowserLogger();
     super(config, platform, logger);
     debug.info(DebugCategory.EMBEDDED_PROVIDER, "Browser EmbeddedProvider initialized");
@@ -841,7 +986,17 @@ var BrowserSDK = class {
    * @returns Signature string
    */
   async signMessage(params) {
-    return this.providerManager.signMessage(params);
+    debug.info(DebugCategory.BROWSER_SDK, "Signing message", {
+      message: params.message,
+      networkId: params.networkId
+    });
+    const result = await this.providerManager.signMessage(params);
+    debug.info(DebugCategory.BROWSER_SDK, "Message signed successfully", {
+      message: params.message,
+      networkId: params.networkId,
+      result
+    });
+    return result;
   }
   /**
    * Sign and send a transaction
@@ -849,7 +1004,15 @@ var BrowserSDK = class {
    * @returns Transaction result
    */
   async signAndSendTransaction(params) {
-    return this.providerManager.signAndSendTransaction(params);
+    debug.info(DebugCategory.BROWSER_SDK, "Signing and sending transaction", {
+      networkId: params.networkId
+    });
+    const result = await this.providerManager.signAndSendTransaction(params);
+    debug.info(DebugCategory.BROWSER_SDK, "Transaction signed and sent successfully", {
+      networkId: params.networkId,
+      result
+    });
+    return result;
   }
   /**
    * Get wallet addresses
@@ -898,4 +1061,5 @@ var BrowserSDK = class {
 };
 
 // src/index.ts
+var import_constants3 = require("@phantom/constants");
 var import_client2 = require("@phantom/client");

package/dist/index.mjs

@@ -79,6 +79,9 @@ var DebugCategory = {
 };
 
 // src/providers/injected/index.ts
+import { base64urlEncode } from "@phantom/base64url";
+import { getExplorerUrl } from "@phantom/constants";
+import bs58 from "bs58";
 var InjectedProvider = class {
   constructor(config) {
     this.connected = false;
@@ -177,18 +180,24 @@ var InjectedProvider = class {
       throw new Error("Wallet not connected");
     }
     const networkPrefix = params.networkId.split(":")[0].toLowerCase();
+    let signatureResult;
     if (networkPrefix === "solana") {
       const { signature } = await this.phantom.solana.signMessage(new TextEncoder().encode(params.message));
-      return Array.from(signature).map((b) => b.toString(16).padStart(2, "0")).join("");
+      signatureResult = bs58.encode(signature);
     } else if (networkPrefix === "ethereum" || networkPrefix === "polygon" || networkPrefix === "eip155") {
       const address = this.addresses.find((addr) => addr.addressType === AddressType.ethereum)?.address;
       if (!address) {
         throw new Error("No address available");
       }
       const signature = await this.phantom.ethereum.signPersonalMessage(params.message, address);
-      return signature;
+      signatureResult = signature;
+    } else {
+      throw new Error(`Network ${params.networkId} is not supported for injected wallets`);
     }
-    throw new Error(`Network ${params.networkId} is not supported for injected wallets`);
+    return {
+      signature: signatureResult,
+      rawSignature: base64urlEncode(signatureResult)
+    };
   }
   async signAndSendTransaction(params) {
     if (!this.connected) {
@@ -199,7 +208,9 @@ var InjectedProvider = class {
       const transaction = params.transaction;
       const result = await this.phantom.solana.signAndSendTransaction(transaction);
       return {
-        rawTransaction: result.signature
+        hash: result.signature,
+        rawTransaction: base64urlEncode(result.signature),
+        blockExplorer: getExplorerUrl(params.networkId, "transaction", result.signature)
       };
     } else if (networkPrefix === "ethereum" || networkPrefix === "polygon" || networkPrefix === "eip155") {
       const toHex = (value) => {
@@ -222,7 +233,9 @@ var InjectedProvider = class {
       };
       const txHash = await this.phantom.ethereum.sendTransaction(txRequest);
       return {
-        rawTransaction: txHash
+        hash: txHash,
+        rawTransaction: base64urlEncode(txHash),
+        blockExplorer: getExplorerUrl(params.networkId, "transaction", txHash)
       };
     }
     throw new Error(`Network ${params.networkId} is not supported for injected wallets`);
@@ -237,6 +250,7 @@ var InjectedProvider = class {
 
 // src/providers/embedded/index.ts
 import { EmbeddedProvider as CoreEmbeddedProvider } from "@phantom/embedded-provider-core";
+import { IndexedDbStamper } from "@phantom/indexed-db-stamper";
 
 // src/providers/embedded/adapters/storage.ts
 var BrowserStorage = class {
@@ -462,16 +476,133 @@ var BrowserLogger = class {
   }
 };
 
+// src/utils/browser-detection.ts
+function parseBrowserFromUserAgent(userAgent, hasBraveAPI) {
+  let name = "unknown";
+  let version = "unknown";
+  if (!userAgent || typeof userAgent !== "string") {
+    return { name, version };
+  }
+  try {
+    if (userAgent.includes("Edg/")) {
+      name = "edge";
+      const match = userAgent.match(/Edg\/([0-9]+(?:\.[0-9]+)*)/);
+      if (match)
+        version = match[1].split(".")[0];
+    } else if (userAgent.includes("OPR/") || userAgent.includes("Opera/")) {
+      name = "opera";
+      const match = userAgent.match(/(?:OPR|Opera)\/([0-9]+(?:\.[0-9]+)*)/);
+      if (match)
+        version = match[1].split(".")[0];
+    } else if (userAgent.includes("SamsungBrowser/")) {
+      name = "samsung";
+      const match = userAgent.match(/SamsungBrowser\/([0-9]+(?:\.[0-9]+)*)/);
+      if (match)
+        version = match[1].split(".")[0];
+    } else if (userAgent.includes("DuckDuckGo/")) {
+      name = "duckduckgo";
+      const match = userAgent.match(/DuckDuckGo\/([0-9]+(?:\.[0-9]+)*)/);
+      if (match)
+        version = match[1].split(".")[0];
+    } else if (userAgent.includes("Chrome/") && hasBraveAPI) {
+      name = "brave";
+      const match = userAgent.match(/Chrome\/([0-9]+(?:\.[0-9]+)*)/);
+      if (match)
+        version = match[1].split(".")[0];
+    } else if (userAgent.includes("Mobile/") || userAgent.includes("Android")) {
+      if (userAgent.includes("Chrome/")) {
+        name = "chrome-mobile";
+        const match = userAgent.match(/Chrome\/([0-9]+(?:\.[0-9]+)*)/);
+        if (match)
+          version = match[1].split(".")[0];
+      } else if (userAgent.includes("Firefox/")) {
+        name = "firefox-mobile";
+        const match = userAgent.match(/Firefox\/([0-9]+(?:\.[0-9]+)*)/);
+        if (match)
+          version = match[1].split(".")[0];
+      } else if (userAgent.includes("Safari/") && userAgent.includes("Mobile/")) {
+        name = "safari-mobile";
+        const match = userAgent.match(/Version\/([0-9]+(?:\.[0-9]+)*)/);
+        if (match)
+          version = match[1].split(".")[0];
+      } else {
+        name = "mobile";
+      }
+    } else if (userAgent.includes("Chrome/")) {
+      name = "chrome";
+      const match = userAgent.match(/Chrome\/([0-9]+(?:\.[0-9]+)*)/);
+      if (match)
+        version = match[1].split(".")[0];
+    } else if (userAgent.includes("Firefox/")) {
+      name = "firefox";
+      const match = userAgent.match(/Firefox\/([0-9]+(?:\.[0-9]+)*)/);
+      if (match)
+        version = match[1].split(".")[0];
+    } else if (userAgent.includes("Safari/") && !userAgent.includes("Chrome/")) {
+      name = "safari";
+      const match = userAgent.match(/Version\/([0-9]+(?:\.[0-9]+)*)/);
+      if (match)
+        version = match[1].split(".")[0];
+    }
+    if (name === "unknown") {
+      const patterns = [
+        { regex: /Chrome\/([0-9]+)/, name: "chrome" },
+        { regex: /Firefox\/([0-9]+)/, name: "firefox" },
+        { regex: /Safari\/([0-9]+)/, name: "safari" },
+        { regex: /Edge\/([0-9]+)/, name: "edge" },
+        { regex: /Opera\/([0-9]+)/, name: "opera" }
+      ];
+      for (const pattern of patterns) {
+        const match = userAgent.match(pattern.regex);
+        if (match) {
+          name = pattern.name;
+          version = match[1];
+          break;
+        }
+      }
+    }
+  } catch (error) {
+  }
+  return { name, version };
+}
+function detectBrowser() {
+  if (typeof window === "undefined" || !window.navigator?.userAgent) {
+    return { name: "unknown", version: "unknown" };
+  }
+  const userAgent = window.navigator.userAgent;
+  const hasBraveAPI = !!navigator.brave;
+  return parseBrowserFromUserAgent(userAgent, hasBraveAPI);
+}
+function getPlatformName() {
+  const { name, version } = detectBrowser();
+  return version !== "unknown" ? `${name}-v${version}` : name;
+}
+function getBrowserDisplayName() {
+  const { name, version } = detectBrowser();
+  const capitalizedName = name.charAt(0).toUpperCase() + name.slice(1);
+  return version !== "unknown" ? `${capitalizedName} ${version}` : capitalizedName;
+}
+
 // src/providers/embedded/index.ts
 var EmbeddedProvider = class extends CoreEmbeddedProvider {
   constructor(config) {
     debug.log(DebugCategory.EMBEDDED_PROVIDER, "Initializing Browser EmbeddedProvider", { config });
     const urlParamsAccessor = new BrowserURLParamsAccessor();
+    const stamper = new IndexedDbStamper({
+      dbName: `phantom-embedded-sdk-${config.organizationId}`,
+      storeName: "crypto-keys",
+      keyName: "signing-key"
+    });
+    const platformName = getPlatformName();
     const platform = {
       storage: new BrowserStorage(),
       authProvider: new BrowserAuthProvider(urlParamsAccessor),
-      urlParamsAccessor
+      urlParamsAccessor,
+      stamper,
+      name: platformName
+      // Use detected browser name and version for identification
     };
+    debug.log(DebugCategory.EMBEDDED_PROVIDER, "Detected platform", { platformName });
     const logger = new BrowserLogger();
     super(config, platform, logger);
     debug.info(DebugCategory.EMBEDDED_PROVIDER, "Browser EmbeddedProvider initialized");
@@ -808,7 +939,17 @@ var BrowserSDK = class {
    * @returns Signature string
    */
   async signMessage(params) {
-    return this.providerManager.signMessage(params);
+    debug.info(DebugCategory.BROWSER_SDK, "Signing message", {
+      message: params.message,
+      networkId: params.networkId
+    });
+    const result = await this.providerManager.signMessage(params);
+    debug.info(DebugCategory.BROWSER_SDK, "Message signed successfully", {
+      message: params.message,
+      networkId: params.networkId,
+      result
+    });
+    return result;
   }
   /**
    * Sign and send a transaction
@@ -816,7 +957,15 @@ var BrowserSDK = class {
    * @returns Transaction result
    */
   async signAndSendTransaction(params) {
-    return this.providerManager.signAndSendTransaction(params);
+    debug.info(DebugCategory.BROWSER_SDK, "Signing and sending transaction", {
+      networkId: params.networkId
+    });
+    const result = await this.providerManager.signAndSendTransaction(params);
+    debug.info(DebugCategory.BROWSER_SDK, "Transaction signed and sent successfully", {
+      networkId: params.networkId,
+      result
+    });
+    return result;
   }
   /**
    * Get wallet addresses
@@ -865,7 +1014,8 @@ var BrowserSDK = class {
 };
 
 // src/index.ts
-import { NetworkId, AddressType as AddressType2 } from "@phantom/client";
+import { NetworkId } from "@phantom/constants";
+import { AddressType as AddressType2 } from "@phantom/client";
 export {
   AddressType2 as AddressType,
   BrowserSDK,
@@ -874,5 +1024,9 @@ export {
   DebugCategory,
   DebugLevel,
   NetworkId,
-  debug
+  debug,
+  detectBrowser,
+  getBrowserDisplayName,
+  getPlatformName,
+  parseBrowserFromUserAgent
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phantom/browser-sdk",
-  "version": "0.2.3",
+  "version": "0.3.1",
   "description": "Browser SDK for Phantom Wallet with unified interface",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -24,15 +24,17 @@
     "test": "jest",
     "test:watch": "jest --watch",
     "lint": "tsc --noEmit && eslint --cache . --ext .ts,.tsx",
+    "check-types": "tsc --noEmit",
     "prettier": "prettier --write \"src/**/*.{ts,tsx}\""
   },
   "dependencies": {
-    "@phantom/api-key-stamper": "^0.1.1",
     "@phantom/base64url": "^0.1.0",
     "@phantom/browser-injected-sdk": "^0.0.9",
-    "@phantom/client": "^0.1.3",
-    "@phantom/embedded-provider-core": "^0.1.1",
-    "@phantom/parsers": "^0.0.4",
+    "@phantom/client": "^0.1.5",
+    "@phantom/constants": "^0.0.2",
+    "@phantom/embedded-provider-core": "^0.1.2",
+    "@phantom/indexed-db-stamper": "^0.1.1",
+    "@phantom/parsers": "^0.0.5",
     "axios": "^1.10.0",
     "bs58": "^6.0.0",
     "buffer": "^6.0.3",