@phantom/browser-sdk 0.3.1 → 0.3.3

package/README.md

@@ -87,6 +87,12 @@ const sdk = new BrowserSDK({
     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
+  };
 }
 ```
 
@@ -662,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)**:
 
@@ -742,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.app/v1/wallets",
-  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

@@ -51,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;
@@ -60,20 +61,12 @@ 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>;
@@ -94,7 +87,6 @@ interface SwitchProviderOptions {
 
 declare class BrowserSDK {
     private providerManager;
-    private config;
     constructor(config: BrowserSDKConfig);
     /**
      * Connect to the wallet with optional provider switching
@@ -145,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>;
 }
 
 /**
@@ -186,4 +172,4 @@ declare function getPlatformName(): string;
  */
 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 };
+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

@@ -418,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", {
@@ -893,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");
@@ -1032,32 +1035,6 @@ 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

package/dist/index.mjs

@@ -371,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", {
@@ -846,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");
@@ -985,32 +988,6 @@ 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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phantom/browser-sdk",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "Browser SDK for Phantom Wallet with unified interface",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -30,11 +30,11 @@
   "dependencies": {
     "@phantom/base64url": "^0.1.0",
     "@phantom/browser-injected-sdk": "^0.0.9",
-    "@phantom/client": "^0.1.5",
+    "@phantom/client": "^0.1.7",
     "@phantom/constants": "^0.0.2",
-    "@phantom/embedded-provider-core": "^0.1.2",
-    "@phantom/indexed-db-stamper": "^0.1.1",
-    "@phantom/parsers": "^0.0.5",
+    "@phantom/embedded-provider-core": "^0.1.4",
+    "@phantom/indexed-db-stamper": "^0.1.3",
+    "@phantom/parsers": "^0.0.6",
     "axios": "^1.10.0",
     "bs58": "^6.0.0",
     "buffer": "^6.0.3",