@phantom/react-native-sdk 0.1.1 → 0.1.3

package/README.md

@@ -94,9 +94,12 @@ export default function App() {
         embeddedWalletType: "user-wallet",
         addressTypes: [AddressType.solana],
         apiBaseUrl: "https://api.phantom.app/v1/wallets",
+        solanaProvider: "web3js",
         authOptions: {
           redirectUrl: "mywalletapp://phantom-auth-callback",
         },
+        appName: "My Wallet App", // Optional branding
+        debug: false, // Optional debug logging
       }}
     >
       <YourAppContent />
@@ -115,7 +118,7 @@ import { useConnect, useAccounts, useSignMessage, useDisconnect } from "@phantom
 
 export function WalletScreen() {
   const { connect, isConnecting, error: connectError } = useConnect();
-  const { addresses, isConnected, walletId } = useAccounts();
+  const { addresses, isConnected } = useAccounts();
   const { signMessage, isSigning } = useSignMessage();
   const { disconnect } = useDisconnect();
 
@@ -156,7 +159,6 @@ export function WalletScreen() {
   return (
     <View style={{ padding: 20 }}>
       <Text style={{ fontSize: 18, marginBottom: 10 }}>Wallet Connected</Text>
-      <Text>Wallet ID: {walletId}</Text>
       <Text>Address: {addresses[0]?.address}</Text>
 
       <Button
@@ -187,16 +189,20 @@ The main provider component that initializes the SDK and provides context to all
 #### Configuration Options
 
 ```typescript
-interface PhantomProviderConfig {
+interface PhantomSDKConfig {
   organizationId: string; // Your Phantom organization ID
   scheme: string; // Custom URL scheme for your app
   embeddedWalletType: "user-wallet" | "app-wallet";
-  addressTypes: AddressType[];
-  apiBaseUrl: "https://api.phantom.app/v1/wallets";
+  addressTypes: AddressType[]; // e.g., [AddressType.solana]
+  apiBaseUrl: string; // e.g., "https://api.phantom.app/v1/wallets"
+  solanaProvider: "web3js" | "kit"; // Solana provider to use
   authOptions?: {
     authUrl?: string; // Custom auth URL (optional)
     redirectUrl?: string; // Custom redirect URL (optional)
   };
+  appName?: string; // Optional app name for branding
+  appLogo?: string; // Optional app logo URL for branding
+  debug?: boolean; // Enable debug logging (optional)
 }
 ```
 

package/dist/index.d.ts

@@ -1,23 +1,17 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
 import * as _phantom_embedded_provider_core from '@phantom/embedded-provider-core';
-import { EmbeddedProviderConfig, AuthOptions, EmbeddedProvider, WalletAddress, ConnectResult, SignMessageParams, SignMessageResult, SignAndSendTransactionParams, SignedTransaction } from '@phantom/embedded-provider-core';
+import { EmbeddedProviderConfig, EmbeddedProvider, WalletAddress, ConnectResult, SignMessageParams, SignMessageResult, SignAndSendTransactionParams, SignedTransaction } from '@phantom/embedded-provider-core';
 export { ConnectResult, SignAndSendTransactionParams, SignMessageParams, SignMessageResult, SignedTransaction, WalletAddress } from '@phantom/embedded-provider-core';
 export { AddressType } from '@phantom/client';
 export { NetworkId } from '@phantom/constants';
 
-interface PhantomProviderConfig extends Omit<EmbeddedProviderConfig, "authOptions"> {
+interface PhantomSDKConfig extends EmbeddedProviderConfig {
     /** Custom URL scheme for your app (e.g., "myapp") */
     scheme: string;
-    /** Authentication options */
-    authOptions?: ReactNativeAuthOptions;
     /** Enable debug logging */
     debug?: boolean;
 }
-interface ReactNativeAuthOptions extends AuthOptions {
-    /** Custom redirect URL - defaults to {scheme}://phantom-auth-callback */
-    redirectUrl?: string;
-}
 interface ConnectOptions {
     /** OAuth provider to use */
     provider?: "google" | "apple" | "jwt";
@@ -38,7 +32,7 @@ interface PhantomContextValue {
 }
 interface PhantomProviderProps {
     children: ReactNode;
-    config: PhantomProviderConfig;
+    config: PhantomSDKConfig;
 }
 declare function PhantomProvider({ children, config }: PhantomProviderProps): react_jsx_runtime.JSX.Element;
 /**
@@ -78,4 +72,4 @@ declare function useSignAndSendTransaction(): {
     error: Error | null;
 };
 
-export { ConnectOptions, PhantomProvider, PhantomProviderConfig, ReactNativeAuthOptions, useAccounts, useConnect, useDisconnect, usePhantom, useSignAndSendTransaction, useSignMessage };
+export { ConnectOptions, PhantomProvider, PhantomSDKConfig, useAccounts, useConnect, useDisconnect, usePhantom, useSignAndSendTransaction, useSignMessage };

package/dist/index.js

@@ -103,7 +103,17 @@ var ExpoAuthProvider = class {
       return;
     }
     const phantomOptions = options;
-    const { authUrl, redirectUrl, organizationId, parentOrganizationId, sessionId, provider, customAuthData } = phantomOptions;
+    const {
+      authUrl,
+      redirectUrl,
+      organizationId,
+      parentOrganizationId,
+      sessionId,
+      provider,
+      customAuthData,
+      appName,
+      appLogo
+    } = phantomOptions;
     if (!redirectUrl) {
       throw new Error("redirectUrl is required for web browser authentication");
     }
@@ -117,7 +127,11 @@ var ExpoAuthProvider = class {
         parent_organization_id: parentOrganizationId,
         redirect_uri: redirectUrl,
         session_id: sessionId,
-        clear_previous_session: "true"
+        clear_previous_session: "true",
+        app_name: appName || "",
+        // Optional app name
+        app_logo: appLogo || ""
+        // Optional app logo URL
       });
       if (provider) {
         console.log("[ExpoAuthProvider] Provider specified, will skip selection", { provider });
@@ -279,9 +293,11 @@ var import_crypto = require("@phantom/crypto");
 var import_base64url = require("@phantom/base64url");
 var import_sdk_types = require("@phantom/sdk-types");
 var ReactNativeStamper = class {
+  // Optional for PKI, required for OIDC
   constructor(config = {}) {
     this.keyInfo = null;
     this.algorithm = import_sdk_types.Algorithm.ed25519;
+    this.type = "PKI";
     this.keyPrefix = config.keyPrefix || "phantom-rn-stamper";
     this.organizationId = config.organizationId || "default";
   }
@@ -318,12 +334,10 @@ var ReactNativeStamper = class {
   }
   /**
    * Create X-Phantom-Stamp header value using stored secret key
-   * @param data - Data to sign (Buffer)
+   * @param params - Parameters object with data to sign and optional override params
    * @returns Complete X-Phantom-Stamp header value
    */
-  async stamp({
-    data
-  }) {
+  async stamp(params) {
     if (!this.keyInfo) {
       throw new Error("Stamper not initialized. Call init() first.");
     }
@@ -332,7 +346,7 @@ var ReactNativeStamper = class {
       throw new Error("Secret key not found in secure storage");
     }
     const apiKeyStamper = new import_api_key_stamper.ApiKeyStamper({ apiSecretKey: storedSecretKey });
-    return await apiKeyStamper.stamp({ data });
+    return await apiKeyStamper.stamp(params);
   }
   /**
    * Clear all stored keys from SecureStore
@@ -416,7 +430,10 @@ function PhantomProvider({ children, config }) {
       },
       embeddedWalletType: config.embeddedWalletType,
       addressTypes: config.addressTypes,
-      solanaProvider: config.solanaProvider || "web3js"
+      solanaProvider: config.solanaProvider || "web3js",
+      appName: config.appName,
+      appLogo: config.appLogo
+      // Optional app logo URL
     };
     const storage = new ExpoSecureStorage();
     const authProvider = new ExpoAuthProvider();
@@ -453,6 +470,14 @@ function PhantomProvider({ children, config }) {
     } catch (err) {
       console.error("[PhantomProvider] Error updating connection state", err);
       setError(err);
+      try {
+        sdk.disconnect();
+        setIsConnected(false);
+        setAddresses([]);
+        setWalletId(null);
+      } catch (disconnectErr) {
+        console.error("[PhantomProvider] Error disconnecting after error", disconnectErr);
+      }
     }
   }, [sdk]);
   (0, import_react.useEffect)(() => {

package/dist/index.mjs

@@ -59,7 +59,17 @@ var ExpoAuthProvider = class {
       return;
     }
     const phantomOptions = options;
-    const { authUrl, redirectUrl, organizationId, parentOrganizationId, sessionId, provider, customAuthData } = phantomOptions;
+    const {
+      authUrl,
+      redirectUrl,
+      organizationId,
+      parentOrganizationId,
+      sessionId,
+      provider,
+      customAuthData,
+      appName,
+      appLogo
+    } = phantomOptions;
     if (!redirectUrl) {
       throw new Error("redirectUrl is required for web browser authentication");
     }
@@ -73,7 +83,11 @@ var ExpoAuthProvider = class {
         parent_organization_id: parentOrganizationId,
         redirect_uri: redirectUrl,
         session_id: sessionId,
-        clear_previous_session: "true"
+        clear_previous_session: "true",
+        app_name: appName || "",
+        // Optional app name
+        app_logo: appLogo || ""
+        // Optional app logo URL
       });
       if (provider) {
         console.log("[ExpoAuthProvider] Provider specified, will skip selection", { provider });
@@ -235,9 +249,11 @@ import { generateKeyPair } from "@phantom/crypto";
 import { base64urlEncode } from "@phantom/base64url";
 import { Algorithm } from "@phantom/sdk-types";
 var ReactNativeStamper = class {
+  // Optional for PKI, required for OIDC
   constructor(config = {}) {
     this.keyInfo = null;
     this.algorithm = Algorithm.ed25519;
+    this.type = "PKI";
     this.keyPrefix = config.keyPrefix || "phantom-rn-stamper";
     this.organizationId = config.organizationId || "default";
   }
@@ -274,12 +290,10 @@ var ReactNativeStamper = class {
   }
   /**
    * Create X-Phantom-Stamp header value using stored secret key
-   * @param data - Data to sign (Buffer)
+   * @param params - Parameters object with data to sign and optional override params
    * @returns Complete X-Phantom-Stamp header value
    */
-  async stamp({
-    data
-  }) {
+  async stamp(params) {
     if (!this.keyInfo) {
       throw new Error("Stamper not initialized. Call init() first.");
     }
@@ -288,7 +302,7 @@ var ReactNativeStamper = class {
       throw new Error("Secret key not found in secure storage");
     }
     const apiKeyStamper = new ApiKeyStamper({ apiSecretKey: storedSecretKey });
-    return await apiKeyStamper.stamp({ data });
+    return await apiKeyStamper.stamp(params);
   }
   /**
    * Clear all stored keys from SecureStore
@@ -372,7 +386,10 @@ function PhantomProvider({ children, config }) {
       },
       embeddedWalletType: config.embeddedWalletType,
       addressTypes: config.addressTypes,
-      solanaProvider: config.solanaProvider || "web3js"
+      solanaProvider: config.solanaProvider || "web3js",
+      appName: config.appName,
+      appLogo: config.appLogo
+      // Optional app logo URL
     };
     const storage = new ExpoSecureStorage();
     const authProvider = new ExpoAuthProvider();
@@ -409,6 +426,14 @@ function PhantomProvider({ children, config }) {
     } catch (err) {
       console.error("[PhantomProvider] Error updating connection state", err);
       setError(err);
+      try {
+        sdk.disconnect();
+        setIsConnected(false);
+        setAddresses([]);
+        setWalletId(null);
+      } catch (disconnectErr) {
+        console.error("[PhantomProvider] Error disconnecting after error", disconnectErr);
+      }
     }
   }, [sdk]);
   useEffect(() => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phantom/react-native-sdk",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Phantom Wallet SDK for React Native and Expo applications",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -45,13 +45,13 @@
     "directory": "packages/react-native-sdk"
   },
   "dependencies": {
-    "@phantom/api-key-stamper": "^0.1.2",
+    "@phantom/api-key-stamper": "^0.1.4",
     "@phantom/base64url": "^0.1.0",
-    "@phantom/client": "^0.1.5",
+    "@phantom/client": "^0.1.7",
     "@phantom/constants": "^0.0.2",
-    "@phantom/crypto": "^0.1.1",
-    "@phantom/embedded-provider-core": "^0.1.2",
-    "@phantom/sdk-types": "^0.1.1",
+    "@phantom/crypto": "^0.1.2",
+    "@phantom/embedded-provider-core": "^0.1.4",
+    "@phantom/sdk-types": "^0.1.3",
     "@types/bs58": "^5.0.0",
     "bs58": "^6.0.0",
     "buffer": "^6.0.3"