@phantom/react-sdk 1.0.0-beta.0 → 1.0.0-beta.10

package/README.md

@@ -94,10 +94,8 @@ function App() {
     <PhantomProvider
       config={{
         providerType: "embedded",
-        embeddedWalletType: "app-wallet", // or 'user-wallet'
+        appId: "your-app-id", // Get your app ID from phantom.com/portal
         addressTypes: [AddressType.solana, AddressType.ethereum],
-        apiBaseUrl: "https://api.phantom.app/v1/wallets",
-        organizationId: "your-org-id",
       }}
     >
       <YourApp />
@@ -153,7 +151,7 @@ await connect({
   },
 });
 
-// Apple authentication (skips provider selection) 
+// Apple authentication (skips provider selection)
 await connect({
   authOptions: {
     provider: "apple",
@@ -182,27 +180,7 @@ Uses the Phantom browser extension installed by the user.
 
 Creates non-custodial wallets embedded in your application.
 
-#### App Wallet (Recommended for most apps)
-
-- **New wallets** created per application
-- **Unfunded** by default - you need to fund them
-- **Independent** from user's existing Phantom wallet
-
-```tsx
-<PhantomProvider
-  config={{
-    providerType: "embedded",
-    embeddedWalletType: "app-wallet",
-    addressTypes: [AddressType.solana],
-    apiBaseUrl: "https://api.phantom.app/v1/wallets",
-    organizationId: "your-org-id",
-  }}
->
-  <YourApp />
-</PhantomProvider>
-```
-
-#### User Wallet (For existing Phantom users)
+#### User Wallet
 
 - **Uses Phantom authentication** - user logs in with existing account
 - **Potentially funded** - brings existing wallet balance
@@ -212,43 +190,14 @@ Creates non-custodial wallets embedded in your application.
 <PhantomProvider
   config={{
     providerType: "embedded",
-    embeddedWalletType: "user-wallet",
+    appId: "your-app-id",
     addressTypes: [AddressType.solana, AddressType.ethereum],
-    apiBaseUrl: "https://api.phantom.app/v1/wallets",
-    organizationId: "your-org-id",
-  }}
->
-  <YourApp />
-</PhantomProvider>
-```
-
-## Solana Provider Configuration
-
-When using `AddressType.solana`, you can choose between two Solana libraries:
-
-```tsx
-<PhantomProvider
-  config={{
-    providerType: "embedded",
-    addressTypes: [AddressType.solana],
-    solanaProvider: "web3js", // or 'kit'
-    apiBaseUrl: "https://api.phantom.app/v1/wallets",
-    organizationId: "your-org-id",
   }}
 >
   <YourApp />
 </PhantomProvider>
 ```
 
-**Provider Options:**
-
-- `'web3js'` (default) - Uses `@solana/web3.js` library
-- `'kit'` - Uses `@solana/kit` library (modern, TypeScript-first)
-
-**When to use each:**
-
-- **@solana/web3.js**: Better ecosystem compatibility, wider community support
-- **@solana/kit**: Better TypeScript support, modern architecture, smaller bundle size
 
 ## Available Hooks
 
@@ -378,7 +327,7 @@ function SolanaOperations() {
     // Create transaction
     const connection = new Connection("https://api.mainnet-beta.solana.com");
     const { blockhash } = await connection.getLatestBlockhash();
-    
+
     const fromAddress = await solana.getPublicKey();
     const transferInstruction = SystemProgram.transfer({
       fromPubkey: new PublicKey(fromAddress),
@@ -396,11 +345,11 @@ function SolanaOperations() {
 
     // Sign and send
     const result = await solana.signAndSendTransaction(transaction);
-    console.log("Transaction sent:", result.hash);
+    console.log("Transaction sent:", result.signature);
   };
 
   const switchNetwork = async () => {
-    await solana.switchNetwork('devnet');
+    await solana.switchNetwork("devnet");
   };
 
   return (
@@ -408,13 +357,14 @@ function SolanaOperations() {
       <button onClick={signMessage}>Sign Message</button>
       <button onClick={signAndSendTransaction}>Send Transaction</button>
       <button onClick={switchNetwork}>Switch to Devnet</button>
-      <p>Connected: {solana.isConnected ? 'Yes' : 'No'}</p>
+      <p>Connected: {solana.isConnected ? "Yes" : "No"}</p>
     </div>
   );
 }
 ```
 
 **Available methods:**
+
 - `signMessage(message)` - Sign a message
 - `signTransaction(transaction)` - Sign without sending
 - `signAndSendTransaction(transaction)` - Sign and send
@@ -447,32 +397,42 @@ function EthereumOperations() {
           { name: "name", type: "string" },
           { name: "version", type: "string" },
           { name: "chainId", type: "uint256" },
-          { name: "verifyingContract", type: "address" }
+          { name: "verifyingContract", type: "address" },
         ],
         Mail: [
           { name: "from", type: "string" },
           { name: "to", type: "string" },
-          { name: "contents", type: "string" }
-        ]
+          { name: "contents", type: "string" },
+        ],
       },
       primaryType: "Mail",
       domain: {
         name: "Ether Mail",
         version: "1",
         chainId: 1,
-        verifyingContract: "0xCcCCccccCCCCcCCCCCCcCcCccCcCCCcCcccccccC"
+        verifyingContract: "0xCcCCccccCCCCcCCCCCCcCcCccCcCCCcCcccccccC",
       },
       message: {
         from: "Alice",
         to: "Bob",
-        contents: "Hello!"
-      }
+        contents: "Hello!",
+      },
     };
 
     const signature = await ethereum.signTypedData(typedData);
     console.log("Typed data signature:", signature);
   };
 
+  const signTransaction = async () => {
+    const signedTx = await ethereum.signTransaction({
+      to: "0x742d35Cc6634C0532925a3b8D4C8db86fB5C4A7E",
+      value: "1000000000000000000", // 1 ETH in wei
+      gas: "21000",
+    });
+    console.log("Transaction signed:", signedTx);
+    // Transaction is signed but not sent - you can broadcast it later
+  };
+
   const sendTransaction = async () => {
     const result = await ethereum.sendTransaction({
       to: "0x742d35Cc6634C0532925a3b8D4C8db86fB5C4A7E",
@@ -490,19 +450,22 @@ function EthereumOperations() {
     <div>
       <button onClick={signPersonalMessage}>Sign Personal Message</button>
       <button onClick={signTypedData}>Sign Typed Data</button>
-      <button onClick={sendTransaction}>Send Transaction</button>
+      <button onClick={signTransaction}>Sign Transaction</button>
+      <button onClick={sendTransaction}>Sign & Send Transaction</button>
       <button onClick={switchChain}>Switch to Polygon</button>
-      <p>Connected: {ethereum.isConnected ? 'Yes' : 'No'}</p>
+      <p>Connected: {ethereum.isConnected ? "Yes" : "No"}</p>
     </div>
   );
 }
 ```
 
 **Available methods:**
+
 - `request(args)` - EIP-1193 requests
 - `signPersonalMessage(message, address)` - Sign personal message
 - `signTypedData(typedData)` - Sign EIP-712 typed data
-- `sendTransaction(transaction)` - Send transaction
+- `signTransaction(transaction)` - Sign transaction without sending
+- `sendTransaction(transaction)` - Sign and send transaction
 - `switchChain(chainId)` - Switch chains
 - `getChainId()` - Get current chain ID
 - `getAccounts()` - Get connected accounts
@@ -521,21 +484,13 @@ Hook for managing auto-confirm functionality with the Phantom extension. Auto-co
 import { useAutoConfirm, NetworkId } from "@phantom/react-sdk";
 
 function AutoConfirmControls() {
-  const {
-    enable,
-    disable, 
-    status,
-    supportedChains,
-    isLoading,
-    error,
-    refetch,
-  } = useAutoConfirm();
+  const { enable, disable, status, supportedChains, isLoading, error, refetch } = useAutoConfirm();
 
   const handleEnable = async () => {
     try {
       // Enable auto-confirm for specific chains
       const result = await enable({
-        chains: [NetworkId.SOLANA_DEVNET, NetworkId.ETHEREUM_MAINNET]
+        chains: [NetworkId.SOLANA_DEVNET, NetworkId.ETHEREUM_MAINNET],
       });
       console.log("Auto-confirm enabled:", result);
     } catch (err) {
@@ -563,14 +518,14 @@ function AutoConfirmControls() {
   return (
     <div>
       <h3>Auto-Confirm Settings</h3>
-      
+
       <div>
         <strong>Status:</strong> {status?.enabled ? "Enabled" : "Disabled"}
         {status?.chains && (
           <div>
             <strong>Active Chains:</strong>
             <ul>
-              {status.chains.map((chain) => (
+              {status.chains.map(chain => (
                 <li key={chain}>{chain}</li>
               ))}
             </ul>
@@ -582,7 +537,7 @@ function AutoConfirmControls() {
         <strong>Supported Chains:</strong>
         {supportedChains?.chains && (
           <ul>
-            {supportedChains.chains.map((chain) => (
+            {supportedChains.chains.map(chain => (
               <li key={chain}>{chain}</li>
             ))}
           </ul>
@@ -635,7 +590,7 @@ interface AutoConfirmSupportedChainsResult {
 **Available Methods:**
 
 - `enable(params)` - Enable auto-confirm for specific chains
-- `disable()` - Disable auto-confirm completely  
+- `disable()` - Disable auto-confirm completely
 - `refetch()` - Refresh status and supported chains from extension
 - `status` - Current auto-confirm status (enabled/disabled and active chains)
 - `supportedChains` - List of chains that support auto-confirm
@@ -685,7 +640,7 @@ function SolanaExample() {
 
     // Sign and send using chain-specific hook
     const result = await solana.signAndSendTransaction(transaction);
-    console.log("Transaction sent:", result.hash);
+    console.log("Transaction sent:", result.signature);
   };
 
   return <button onClick={sendTransaction}>Send SOL</button>;
@@ -724,7 +679,7 @@ function SolanaKitExample() {
 
     // Sign and send using chain-specific hook
     const result = await solana.signAndSendTransaction(transaction);
-    console.log("Transaction sent:", result.hash);
+    console.log("Transaction sent:", result.signature);
   };
 
   return <button onClick={sendTransaction}>Send SOL</button>;
@@ -778,36 +733,35 @@ function EthereumExample() {
 
 Quick reference of all available hooks:
 
-| Hook                        | Purpose                    | Returns                                        |
-| --------------------------- | -------------------------- | ---------------------------------------------- |
-| `useConnect`                | Connect to wallet          | `{ connect, isConnecting, error }`             |
-| `useAccounts`               | Get wallet addresses       | `WalletAddress[]` or `null`                    |
-| `useIsExtensionInstalled`   | Check extension status     | `{ isLoading, isInstalled }`                   |
-| `useDisconnect`             | Disconnect from wallet     | `{ disconnect, isDisconnecting }`              |
-| `useAutoConfirm`            | Auto-confirm management (injected only) | `{ enable, disable, status, supportedChains, ... }` |
-| `useSolana`                 | Solana chain operations    | `{ signMessage, signAndSendTransaction, ... }` |
-| `useEthereum`               | Ethereum chain operations  | `{ signPersonalMessage, sendTransaction, ... }`|
-| `usePhantom`                | Get provider context       | `{ isConnected, isReady }`                     |
+| Hook                      | Purpose                                 | Returns                                             |
+| ------------------------- | --------------------------------------- | --------------------------------------------------- |
+| `useConnect`              | Connect to wallet                       | `{ connect, isConnecting, error }`                  |
+| `useAccounts`             | Get wallet addresses                    | `WalletAddress[]` or `null`                         |
+| `useIsExtensionInstalled` | Check extension status                  | `{ isLoading, isInstalled }`                        |
+| `useDisconnect`           | Disconnect from wallet                  | `{ disconnect, isDisconnecting }`                   |
+| `useAutoConfirm`          | Auto-confirm management (injected only) | `{ enable, disable, status, supportedChains, ... }` |
+| `useSolana`               | Solana chain operations                 | `{ signMessage, signAndSendTransaction, ... }`      |
+| `useEthereum`             | Ethereum chain operations               | `{ signPersonalMessage, sendTransaction, ... }`     |
+| `usePhantom`              | Get provider context                    | `{ isConnected, isReady }`                          |
 
 ## Configuration Reference
 
 ```typescript
 interface PhantomSDKConfig {
   providerType: "injected" | "embedded";
-  appName?: string; // Optional app name for branding
-  appLogo?: string; // Optional app logo URL for branding
   addressTypes?: [AddressType, ...AddressType[]]; // Networks to enable (e.g., [AddressType.solana])
 
   // Required for embedded provider only
-  apiBaseUrl?: string; // Phantom API base URL
-  organizationId?: string; // Your organization ID
+  appId: string; // Your app ID from phantom.com/portal (required for embedded provider)
+  
+  // Optional configuration
+  apiBaseUrl?: string; // Phantom API base URL (optional, has default)
   authOptions?: {
-    authUrl?: string; // Custom auth URL (optional)
-    redirectUrl?: string; // Custom redirect URL (optional)
+    authUrl?: string; // Custom auth URL (optional, defaults to "https://connect.phantom.app/login")
+    redirectUrl?: string; // Custom redirect URL after authentication (optional)
   };
-  embeddedWalletType?: "app-wallet" | "user-wallet"; // Wallet type
-  solanaProvider?: "web3js" | "kit"; // Solana library choice (default: 'web3js')
-  autoConnect?: boolean; // Auto-connect to existing session on SDK instantiation (default: true for embedded, false for injected)
+  embeddedWalletType?: "user-wallet"; // Wallet type (optional, defaults to "user-wallet", currently the only supported type)
+  autoConnect?: boolean; // Auto-connect to existing session on SDK instantiation (optional, defaults to true for embedded, false for injected)
 }
 ```
 
@@ -819,8 +773,8 @@ The React SDK supports separate debug configuration that can be changed without
 
 ```typescript
 interface PhantomDebugConfig {
-  enabled?: boolean;     // Enable debug logging
-  level?: DebugLevel;    // Debug level (ERROR, WARN, INFO, DEBUG)
+  enabled?: boolean; // Enable debug logging
+  level?: DebugLevel; // Debug level (ERROR, WARN, INFO, DEBUG)
   callback?: DebugCallback; // Custom debug message handler
 }
 ```
@@ -839,7 +793,7 @@ function App() {
   // SDK configuration - static, won't change when debug settings change
   const config: PhantomSDKConfig = {
     providerType: "embedded",
-    organizationId: "your-org-id",
+    appId: "your-app-id",
     // ... other config
   };
 
@@ -866,12 +820,12 @@ Debug callbacks receive a `DebugMessage` object:
 
 ```typescript
 interface DebugMessage {
-  timestamp: number;     // Unix timestamp
-  level: DebugLevel;     // Message level
-  category: string;      // Component category
-  message: string;       // Debug message text
-  data?: any;           // Additional debug data (optional)
+  timestamp: number; // Unix timestamp
+  level: DebugLevel; // Message level
+  category: string; // Component category
+  message: string; // Debug message text
+  data?: any; // Additional debug data (optional)
 }
 ```
 
-For more details and examples, see the [@phantom/browser-sdk documentation](../browser-sdk/README.md).
+For more details and examples, see the [@phantom/browser-sdk documentation](../browser-sdk/README.md).

package/dist/index.d.ts

@@ -3,12 +3,9 @@ import { ReactNode } from 'react';
 import { BrowserSDKConfig, DebugConfig, AuthOptions, BrowserSDK, WalletAddress, AutoConfirmEnableParams, AutoConfirmResult, AutoConfirmSupportedChainsResult } from '@phantom/browser-sdk';
 export { AddressType, AutoConfirmEnableParams, AutoConfirmResult, AutoConfirmSupportedChainsResult, DebugLevel, DebugMessage, NetworkId, SignedTransaction, WalletAddress, debug } from '@phantom/browser-sdk';
 import * as _phantom_embedded_provider_core from '@phantom/embedded-provider-core';
-import * as _phantom_parsers from '@phantom/parsers';
-import { ISolanaChain, IEthereumChain, EthTransactionRequest } from '@phantom/chains';
-export { EthTransactionRequest, IEthereumChain, ISolanaChain } from '@phantom/chains';
+export { EthTransactionRequest, IEthereumChain, ISolanaChain } from '@phantom/chain-interfaces';
 
-interface PhantomSDKConfig extends BrowserSDKConfig {
-}
+type PhantomSDKConfig = BrowserSDKConfig;
 interface PhantomDebugConfig extends DebugConfig {
 }
 interface ConnectOptions {
@@ -25,6 +22,7 @@ interface PhantomContextValue {
     walletId: string | null;
     currentProviderType: "injected" | "embedded" | null;
     isPhantomAvailable: boolean;
+    isClient: boolean;
 }
 interface PhantomProviderProps {
     children: ReactNode;
@@ -50,6 +48,10 @@ declare function useDisconnect(): {
 
 declare function useAccounts(): _phantom_embedded_provider_core.WalletAddress[] | null;
 
+/**
+ * React hook to check if Phantom extension is installed
+ * Uses waitForPhantomExtension for proper detection with retry logic
+ */
 declare function useIsExtensionInstalled(): {
     isLoading: boolean;
     isInstalled: boolean;
@@ -69,45 +71,21 @@ declare function useAutoConfirm(): UseAutoConfirmResult;
 /**
  * Hook for Solana chain operations
  *
- * @returns Solana chain interface and convenient methods
+ * @returns Solana chain interface with connection enforcement
  */
 declare function useSolana(): {
-    solana: ISolanaChain | null;
-    signMessage: (message: string | Uint8Array) => Promise<_phantom_parsers.ParsedSignatureResult>;
-    signTransaction: <T>(transaction: T) => Promise<T>;
-    signAndSendTransaction: <T>(transaction: T) => Promise<_phantom_parsers.ParsedTransactionResult>;
-    connect: (options?: {
-        onlyIfTrusted?: boolean;
-    }) => Promise<{
-        publicKey: string;
-    }>;
-    disconnect: () => Promise<void>;
-    switchNetwork: (network: "mainnet" | "devnet") => Promise<void>;
-    getPublicKey: () => Promise<string | null>;
+    solana: any;
     isAvailable: boolean;
-    isConnected: boolean;
 };
 
 /**
  * Hook for Ethereum chain operations
  *
- * @returns Ethereum chain interface and convenient methods
+ * @returns Ethereum chain interface with connection enforcement
  */
 declare function useEthereum(): {
-    ethereum: IEthereumChain | null;
-    request: <T = any>(args: {
-        method: string;
-        params?: unknown[];
-    }) => Promise<T>;
-    signPersonalMessage: (message: string, address: string) => Promise<string>;
-    signMessage: (message: string) => Promise<string>;
-    signTypedData: (typedData: any) => Promise<string>;
-    sendTransaction: (transaction: EthTransactionRequest) => Promise<_phantom_parsers.ParsedTransactionResult>;
-    switchChain: (chainId: number) => Promise<void>;
-    getChainId: () => Promise<number>;
-    getAccounts: () => Promise<string[]>;
+    ethereum: any;
     isAvailable: boolean;
-    isConnected: boolean;
 };
 
 type ProviderType = "injected" | "embedded";