@phantom/browser-sdk 0.2.3 → 0.3.2

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,13 +80,19 @@ 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: {
     authUrl: "https://auth.phantom.app", // optional, defaults to "https://connect.phantom.app"
     redirectUrl: "https://yourapp.com/callback", // optional, defaults to current page
   },
+  appName: "My DApp", // optional, for branding
+  appLogo: "https://myapp.com/logo.png", // optional, for branding
+  debug: {
+    enabled: true, // optional, enable debug logging
+    level: "info", // optional, debug level
+  },
 });
 ```
 
@@ -169,9 +175,11 @@ new BrowserSDK(config: BrowserSDKConfig)
 ```typescript
 interface BrowserSDKConfig {
   providerType: "injected" | "embedded";
+  appName?: string; // Optional app name for branding
+  appLogo?: string; // Optional app logo URL for branding
+  addressTypes?: AddressType[]; // Networks to enable (e.g., [AddressType.solana])
 
   // Required for embedded provider only
-  addressTypes?: AddressType[]; // Networks to enable
   apiBaseUrl?: string; // Phantom API base URL
   organizationId?: string; // Your organization ID
   authOptions?: {
@@ -180,6 +188,13 @@ interface BrowserSDKConfig {
   };
   embeddedWalletType?: "app-wallet" | "user-wallet"; // Wallet type
   solanaProvider?: "web3js" | "kit"; // Solana library choice (default: 'web3js')
+
+  // Debug options
+  debug?: {
+    enabled?: boolean; // Enable debug logging
+    level?: "info" | "warn" | "error"; // Debug level
+    callback?: (level: string, message: string, data?: any) => void; // Custom debug callback
+  };
 }
 ```
 
@@ -237,7 +252,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 +331,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 +585,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,
@@ -633,12 +677,12 @@ try {
 
 2. **Install dependencies based on enabled networks**:
 
-   | AddressType                 | Required Dependencies              | Bundle Size |
-   | --------------------------- | ---------------------------------- | ----------- |
-   | `AddressType.solana`        | `@solana/web3.js` OR `@solana/kit` | ~250KB      |
-   | `AddressType.ethereum`      | `viem`                             | ~300KB      |
-   | `AddressType.bitcoinSegwit` | `bitcoinjs-lib`                    | ~200KB      |
-   | `AddressType.sui`           | `@mysten/sui.js`                   | ~250KB      |
+   | AddressType                 | Required Dependencies              |
+   | --------------------------- | ---------------------------------- |
+   | `AddressType.solana`        | `@solana/web3.js` OR `@solana/kit` |
+   | `AddressType.ethereum`      | `viem`                             |
+   | `AddressType.bitcoinSegwit` | `bitcoinjs-lib`                    |
+   | `AddressType.sui`           | `@mysten/sui.js`                   |
 
    **Example package.json for Solana + Ethereum (using @solana/web3.js)**:
 
@@ -713,62 +757,3 @@ try {
      }
    }
    ```
-
-3. **Monitor bundle size**:
-   ```bash
-   # Analyze your bundle
-   npx webpack-bundle-analyzer dist/main.js
-   ```
-
-## Server Setup for Embedded Wallets
-
-For embedded wallets, you need to set up a backend endpoint. Add the `serverUrl` parameter to your SDK configuration:
-
-```typescript
-const sdk = new BrowserSDK({
-  providerType: "embedded",
-  addressTypes: [AddressType.solana],
-  apiBaseUrl: "https://api.phantom.com",
-  organizationId: "your-org-id",
-  serverUrl: "http://localhost:3000/api",
-});
-```
-
-### Required Backend Endpoint
-
-Your backend needs an endpoint that uses the server-sdk:
-
-```javascript
-// server.js
-const express = require("express");
-const { ServerSDK } = require("@phantom/server-sdk");
-
-const app = express();
-app.use(express.json());
-
-const serverSDK = new ServerSDK({
-  organizationId: process.env.ORGANIZATION_ID,
-  apiPrivateKey: process.env.PRIVATE_KEY,
-  apiBaseUrl: process.env.API_URL,
-});
-
-app.post("/api/organizations", async (req, res) => {
-  try {
-    const { userId } = req.body;
-
-    if (!userId) {
-      return res.status(400).json({ error: "userId is required" });
-    }
-
-    const organization = await serverSDK.getOrCreateChildOrganizationByTag({
-      tag: userId,
-    });
-
-    res.json({ organizationId: organization.id });
-  } catch (error) {
-    res.status(500).json({ error: "Failed to process request" });
-  }
-});
-
-app.listen(3000);
-```

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,
@@ -50,6 +51,7 @@ declare const DebugCategory: {
 interface BrowserSDKConfig {
     providerType: "injected" | "embedded" | (string & Record<never, never>);
     appName?: string;
+    appLogo?: string;
     addressTypes?: AddressType[];
     apiBaseUrl?: string;
     organizationId?: string;
@@ -59,25 +61,17 @@ interface BrowserSDKConfig {
     };
     embeddedWalletType?: "app-wallet" | "user-wallet" | (string & Record<never, never>);
     solanaProvider?: "web3js" | "kit";
-    serverUrl?: string;
     debug?: {
         enabled?: boolean;
         level?: DebugLevel;
         callback?: DebugCallback;
     };
 }
-interface CreateUserOrganizationParams {
-    userId: string;
-    [key: string]: any;
-}
-interface CreateUserOrganizationResult {
-    organizationId: string;
-}
 
 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;
@@ -93,7 +87,6 @@ interface SwitchProviderOptions {
 
 declare class BrowserSDK {
     private providerManager;
-    private config;
     constructor(config: BrowserSDKConfig);
     /**
      * Connect to the wallet with optional provider switching
@@ -125,7 +118,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
@@ -144,12 +137,6 @@ declare class BrowserSDK {
      * Get the current wallet ID (for embedded wallets)
      */
     getWalletId(): string | null;
-    /**
-     * Create a user organization via your backend API
-     * @param params - Parameters including userId and any additional options
-     * @returns Organization creation result with organizationId
-     */
-    createUserOrganization(params: CreateUserOrganizationParams): Promise<CreateUserOrganizationResult>;
 }
 
 /**
@@ -158,4 +145,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, 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 {
@@ -390,7 +418,11 @@ var BrowserAuthProvider = class {
         parent_organization_id: phantomOptions.parentOrganizationId,
         redirect_uri: phantomOptions.redirectUrl || (typeof window !== "undefined" ? window.location.href : ""),
         session_id: phantomOptions.sessionId,
-        clear_previous_session: true.toString()
+        clear_previous_session: true.toString(),
+        app_name: phantomOptions.appName || "",
+        // Optional app name
+        app_logo: phantomOptions.appLogo || ""
+        // Optional app logo URL
       });
       if (phantomOptions.provider) {
         debug.log(DebugCategory.PHANTOM_CONNECT_AUTH, "Provider specified, will skip selection", {
@@ -495,16 +527,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");
@@ -748,7 +897,6 @@ var BrowserSDK = class {
       );
     }
     config.embeddedWalletType = embeddedWalletType;
-    this.config = config;
     debug.log(DebugCategory.BROWSER_SDK, "Creating ProviderManager", { config });
     this.providerManager = new ProviderManager(config);
     debug.info(DebugCategory.BROWSER_SDK, "BrowserSDK initialized successfully");
@@ -841,7 +989,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 +1007,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
@@ -869,33 +1035,8 @@ var BrowserSDK = class {
   getWalletId() {
     return this.providerManager.getWalletId();
   }
-  /**
-   * Create a user organization via your backend API
-   * @param params - Parameters including userId and any additional options
-   * @returns Organization creation result with organizationId
-   */
-  async createUserOrganization(params) {
-    if (!this.config.serverUrl) {
-      throw new Error("serverUrl is required in config to create user organizations");
-    }
-    try {
-      const response = await fetch(`${this.config.serverUrl}/organizations`, {
-        method: "POST",
-        headers: {
-          "Content-Type": "application/json"
-        },
-        body: JSON.stringify(params)
-      });
-      if (!response.ok) {
-        throw new Error(`Failed to create organization: ${response.status} ${response.statusText}`);
-      }
-      const result = await response.json();
-      return result;
-    } catch (error) {
-      throw new Error(`Error creating user organization: ${error instanceof Error ? error.message : "Unknown error"}`);
-    }
-  }
 };
 
 // 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 {
@@ -357,7 +371,11 @@ var BrowserAuthProvider = class {
         parent_organization_id: phantomOptions.parentOrganizationId,
         redirect_uri: phantomOptions.redirectUrl || (typeof window !== "undefined" ? window.location.href : ""),
         session_id: phantomOptions.sessionId,
-        clear_previous_session: true.toString()
+        clear_previous_session: true.toString(),
+        app_name: phantomOptions.appName || "",
+        // Optional app name
+        app_logo: phantomOptions.appLogo || ""
+        // Optional app logo URL
       });
       if (phantomOptions.provider) {
         debug.log(DebugCategory.PHANTOM_CONNECT_AUTH, "Provider specified, will skip selection", {
@@ -462,16 +480,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");
@@ -715,7 +850,6 @@ var BrowserSDK = class {
       );
     }
     config.embeddedWalletType = embeddedWalletType;
-    this.config = config;
     debug.log(DebugCategory.BROWSER_SDK, "Creating ProviderManager", { config });
     this.providerManager = new ProviderManager(config);
     debug.info(DebugCategory.BROWSER_SDK, "BrowserSDK initialized successfully");
@@ -808,7 +942,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 +960,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
@@ -836,36 +988,11 @@ var BrowserSDK = class {
   getWalletId() {
     return this.providerManager.getWalletId();
   }
-  /**
-   * Create a user organization via your backend API
-   * @param params - Parameters including userId and any additional options
-   * @returns Organization creation result with organizationId
-   */
-  async createUserOrganization(params) {
-    if (!this.config.serverUrl) {
-      throw new Error("serverUrl is required in config to create user organizations");
-    }
-    try {
-      const response = await fetch(`${this.config.serverUrl}/organizations`, {
-        method: "POST",
-        headers: {
-          "Content-Type": "application/json"
-        },
-        body: JSON.stringify(params)
-      });
-      if (!response.ok) {
-        throw new Error(`Failed to create organization: ${response.status} ${response.statusText}`);
-      }
-      const result = await response.json();
-      return result;
-    } catch (error) {
-      throw new Error(`Error creating user organization: ${error instanceof Error ? error.message : "Unknown error"}`);
-    }
-  }
 };
 
 // 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 +1001,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.2",
   "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.6",
+    "@phantom/constants": "^0.0.2",
+    "@phantom/embedded-provider-core": "^0.1.3",
+    "@phantom/indexed-db-stamper": "^0.1.2",
+    "@phantom/parsers": "^0.0.6",
     "axios": "^1.10.0",
     "bs58": "^6.0.0",
     "buffer": "^6.0.3",