@phantom/react-native-sdk 1.0.0-beta.2 → 1.0.0-beta.21

package/README.md

@@ -89,12 +89,9 @@ export default function App() {
   return (
     <PhantomProvider
       config={{
-        appId: "your-app-id",
+        appId: "your-app-id", // Get your app ID from phantom.com/portal
         scheme: "mywalletapp", // Must match app.json scheme
-        embeddedWalletType: "user-wallet",
         addressTypes: [AddressType.solana],
-        apiBaseUrl: "https://api.phantom.app/v1/wallets",
-        solanaProvider: "web3js",
         authOptions: {
           redirectUrl: "mywalletapp://phantom-auth-callback",
         },
@@ -117,8 +114,8 @@ import { useConnect, useAccounts, useSolana, useEthereum, useDisconnect } from "
 export function WalletScreen() {
   const { connect, isConnecting, error: connectError } = useConnect();
   const { addresses, isConnected } = useAccounts();
-  const solana = useSolana();
-  const ethereum = useEthereum();
+  const { solana } = useSolana();
+  const { ethereum } = useEthereum();
   const { disconnect } = useDisconnect();
 
   const handleConnect = async () => {
@@ -132,8 +129,10 @@ export function WalletScreen() {
 
   const handleSignSolanaMessage = async () => {
     try {
-      const signature = await solana.signMessage("Hello from Solana!");
-      Alert.alert("Solana Signed!", `Signature: ${signature.signature.slice(0, 10)}...`);
+      if (solana.isAvailable) {
+        const signature = await solana.solana.signMessage("Hello from Solana!");
+        Alert.alert("Solana Signed!", `Signature: ${signature.signature.slice(0, 10)}...`);
+      }
     } catch (error) {
       Alert.alert("Error", `Failed to sign: ${error.message}`);
     }
@@ -141,9 +140,11 @@ export function WalletScreen() {
 
   const handleSignEthereumMessage = async () => {
     try {
-      const accounts = await ethereum.getAccounts();
-      const signature = await ethereum.signPersonalMessage("Hello from Ethereum!", accounts[0]);
-      Alert.alert("Ethereum Signed!", `Signature: ${signature.signature.slice(0, 10)}...`);
+      if (ethereum.isAvailable) {
+        const accounts = await ethereum.ethereum.getAccounts();
+        const signature = await ethereum.ethereum.signPersonalMessage("Hello from Ethereum!", accounts[0]);
+        Alert.alert("Ethereum Signed!", `Signature: ${signature.slice(0, 10)}...`);
+      }
     } catch (error) {
       Alert.alert("Error", `Failed to sign: ${error.message}`);
     }
@@ -198,15 +199,17 @@ The main provider component that initializes the SDK and provides context to all
 ```typescript
 interface PhantomSDKConfig {
   scheme: string; // Custom URL scheme for your app
-  embeddedWalletType: "user-wallet" | "app-wallet";
+  appId: string; // Your app ID from phantom.com/portal (required)
   addressTypes: [AddressType, ...AddressType[]]; // e.g., [AddressType.solana]
-  apiBaseUrl: string; // e.g., "https://api.phantom.app/v1/wallets"
-  solanaProvider: "web3js" | "kit"; // Solana provider to use
+  
+  // Optional configuration
+  embeddedWalletType?: "user-wallet"; // optional, defaults to "user-wallet", currently the only supported type
+  apiBaseUrl?: string; // e.g., "https://api.phantom.app/v1/wallets" (optional, has default)
   authOptions?: {
     authUrl?: string; // Custom auth URL (optional)
     redirectUrl?: string; // Custom redirect URL (optional)
   };
-  autoConnect?: boolean; // Auto-connect to existing session on SDK instantiation (default: true)
+  autoConnect?: boolean; // Auto-connect to existing session on SDK instantiation (optional, defaults to true)
 }
 ```
 
@@ -242,16 +245,18 @@ const {
 Provides access to Solana-specific operations.
 
 ```typescript
-const solana = useSolana();
+const { solana, isAvailable } = useSolana();
 
-// Sign a message
-const signature = await solana.signMessage("Hello Solana!");
+if (isAvailable) {
+  // Sign a message
+  const signature = await solana.signMessage("Hello Solana!");
 
-// Sign a transaction (without sending)
-const signedTx = await solana.signTransaction(transaction);
+  // Sign a transaction (without sending)
+  const signedTx = await solana.signTransaction(transaction);
 
-// Sign and send a transaction
-const result = await solana.signAndSendTransaction(transaction);
+  // Sign and send a transaction
+  const result = await solana.signAndSendTransaction(transaction);
+}
 ```
 
 #### useEthereum
@@ -259,24 +264,56 @@ const result = await solana.signAndSendTransaction(transaction);
 Provides access to Ethereum-specific operations.
 
 ```typescript
-const ethereum = useEthereum();
+const { ethereum, isAvailable } = useEthereum();
+
+if (isAvailable) {
+  // Get accounts
+  const accounts = await ethereum.getAccounts();
 
-// Get accounts
-const accounts = await ethereum.getAccounts();
+  // Sign a personal message
+  const signature = await ethereum.signPersonalMessage("Hello Ethereum!", accounts[0]);
 
-// Sign a personal message
-const signature = await ethereum.signPersonalMessage("Hello Ethereum!", accounts[0]);
+  // Sign a transaction (without sending)
+  const signedTx = await ethereum.signTransaction(transactionData);
 
-// Sign a transaction (without sending)
-const signedTx = await ethereum.signTransaction(transactionData);
+  // Sign and send a transaction
+  const result = await ethereum.sendTransaction(transactionData);
 
-// Sign and send a transaction  
-const result = await ethereum.sendTransaction(transactionData);
+  // Switch to a different chain
+  await ethereum.switchChain(137); // Switch to Polygon
+  await ethereum.switchChain("0x89"); // Also accepts hex strings
 
-// Get current chain ID
-const chainId = await ethereum.getChainId();
+  // Get current chain ID
+  const chainId = await ethereum.getChainId();
+}
 ```
 
+**Available Methods:**
+
+- `getAccounts()` - Get connected Ethereum accounts
+- `signPersonalMessage(message, address)` - Sign personal message
+- `signTypedData(typedData, address)` - Sign EIP-712 typed data
+- `signTransaction(transaction)` - Sign transaction without sending
+- `sendTransaction(transaction)` - Sign and send transaction
+- `switchChain(chainId)` - Switch chains (accepts chain ID as number or hex string)
+- `getChainId()` - Get current chain ID
+- `isConnected()` - Check connection status
+
+**Supported EVM Networks:**
+
+| Network | Chain ID | Usage |
+|---------|----------|-------|
+| Ethereum Mainnet | `1` | `ethereum.switchChain(1)` |
+| Ethereum Sepolia | `11155111` | `ethereum.switchChain(11155111)` |
+| Polygon Mainnet | `137` | `ethereum.switchChain(137)` |
+| Polygon Amoy | `80002` | `ethereum.switchChain(80002)` |
+| Base Mainnet | `8453` | `ethereum.switchChain(8453)` |
+| Base Sepolia | `84532` | `ethereum.switchChain(84532)` |
+| Arbitrum One | `42161` | `ethereum.switchChain(42161)` |
+| Arbitrum Sepolia | `421614` | `ethereum.switchChain(421614)` |
+| Monad Mainnet | `143` | `ethereum.switchChain(143)` |
+| Monad Testnet | `10143` | `ethereum.switchChain(10143)` |
+
 #### useDisconnect
 
 Manages wallet disconnection.
@@ -336,11 +373,9 @@ import { PhantomProvider, AddressType } from "@phantom/react-native-sdk";
 
 <PhantomProvider
   config={{
-    appId: "app_123456789",
+    appId: "your-app-id",
     scheme: "myapp",
-    embeddedWalletType: "user-wallet",
     addressTypes: [AddressType.solana],
-    apiBaseUrl: "https://api.phantom.app/v1/wallets",
   }}
 >
   <App />
@@ -354,14 +389,10 @@ import { PhantomProvider, AddressType } from "@phantom/react-native-sdk";
 
 <PhantomProvider
   config={{
-    appId: "app_123456789",
+    appId: "your-app-id",
     scheme: "mycompany-wallet",
-    embeddedWalletType: "user-wallet",
     addressTypes: [AddressType.solana, AddressType.ethereum],
-    apiBaseUrl: "https://api.phantom.app/v1/wallets",
-    solanaProvider: "web3js",
     authOptions: {
-      authUrl: "https://connect.phantom.app",
       redirectUrl: "mycompany-wallet://auth/success",
     },
   }}
@@ -395,13 +426,9 @@ import { PhantomProvider, AddressType } from '@phantom/react-native-sdk';
 const testConfig = {
   appId: "test-app",
   scheme: "testapp",
-  embeddedWalletType: "app-wallet" as const,
   addressTypes: [AddressType.solana],
-  apiBaseUrl: "https://api.phantom.app/v1/wallets",
-
 };
 
-// Use app-wallet for testing (no OAuth required)
 <PhantomProvider config={testConfig}>
   <TestApp />
 </PhantomProvider>
@@ -426,7 +453,7 @@ adb shell am start -W -a android.intent.action.VIEW -d "myapp://phantom-auth-cal
    - Check `app.json` (Expo) or platform-specific configuration
 
 2. **"Authentication failed"**
-   - Verify your organization ID is correct
+   - Verify your app ID is correct
    - Check network connectivity
    - Ensure redirect URL matches your scheme
 
@@ -450,6 +477,7 @@ import { PhantomProvider, type PhantomSDKConfig, type PhantomDebugConfig } from
 function App() {
   // SDK configuration - static, won't change when debug settings change
   const config: PhantomSDKConfig = {
+    appId: "your-app-id",
     scheme: "mywalletapp",
     // ... other config
   };
@@ -475,11 +503,3 @@ interface PhantomDebugConfig {
 }
 ```
 
-## Support
-
-- **Documentation**: [phantom.app/docs](https://phantom.app/docs)
-- **GitHub Issues**: [github.com/phantom/wallet-sdk/issues](https://github.com/phantom/wallet-sdk/issues)
-
-## License
-
-MIT License - see [LICENSE](LICENSE) file for details.

package/dist/index.d.ts

@@ -2,8 +2,8 @@ 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, EmbeddedProvider, WalletAddress, ConnectResult } from '@phantom/embedded-provider-core';
-export { ConnectResult, SignAndSendTransactionParams, SignMessageParams, SignMessageResult, SignedTransaction, WalletAddress } from '@phantom/embedded-provider-core';
-import { ISolanaChain, IEthereumChain, EthTransactionRequest } from '@phantom/chains';
+export { ConnectErrorEventData, ConnectEventData, ConnectResult, ConnectStartEventData, DisconnectEventData, EmbeddedProviderEvent, EmbeddedProviderEventMap, EventCallback, SignAndSendTransactionParams, SignMessageParams, SignMessageResult, SignedTransaction, WalletAddress } from '@phantom/embedded-provider-core';
+import { ISolanaChain, IEthereumChain } from '@phantom/chain-interfaces';
 export { AddressType } from '@phantom/client';
 export { NetworkId } from '@phantom/constants';
 
@@ -11,15 +11,23 @@ interface PhantomDebugConfig {
     /** Enable debug logging */
     enabled?: boolean;
 }
-interface PhantomSDKConfig extends EmbeddedProviderConfig {
+interface PhantomSDKConfig extends Omit<EmbeddedProviderConfig, "apiBaseUrl" | "embeddedWalletType" | "authOptions"> {
     /** Custom URL scheme for your app (e.g., "myapp") */
     scheme: string;
     /** Enable auto-connect to existing sessions (default: true) */
     autoConnect?: boolean;
+    /** Base URL for Phantom API (default: "https://api.phantom.app/v1/wallets") */
+    apiBaseUrl?: string;
+    /** Authentication options */
+    embeddedWalletType?: "app-wallet" | "user-wallet";
+    authOptions?: {
+        authUrl?: string;
+        redirectUrl?: string;
+    };
 }
 interface ConnectOptions {
-    /** OAuth provider to use */
-    provider?: "google" | "apple" | "jwt";
+    /** OAuth provider to use (required) */
+    provider: "google" | "apple" | "jwt" | "phantom";
     /** JWT token for JWT authentication */
     jwtToken?: string;
     /** Custom authentication data */
@@ -27,13 +35,14 @@ interface ConnectOptions {
 }
 
 interface PhantomContextValue {
-    sdk: EmbeddedProvider | null;
+    sdk: EmbeddedProvider;
     isConnected: boolean;
     isConnecting: boolean;
     connectError: Error | null;
     addresses: WalletAddress[];
     walletId: string | null;
     setWalletId: (walletId: string | null) => void;
+    user: ConnectResult | null;
 }
 interface PhantomProviderProps {
     children: ReactNode;
@@ -44,7 +53,7 @@ declare function PhantomProvider({ children, config, debugConfig }: PhantomProvi
 declare function usePhantom(): PhantomContextValue;
 
 declare function useConnect(): {
-    connect: (_options?: ConnectOptions) => Promise<ConnectResult>;
+    connect: (options: ConnectOptions) => Promise<ConnectResult>;
     isConnecting: boolean;
     error: Error | null;
 };
@@ -64,51 +73,21 @@ declare function useAccounts(): {
 /**
  * Hook for Solana chain operations in React Native
  *
- * @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<{
-        signature: Uint8Array;
-        publicKey: string;
-    }>;
-    signTransaction: <T>(transaction: T) => Promise<T>;
-    signAndSendTransaction: <T>(transaction: T) => Promise<{
-        signature: string;
-    }>;
-    connect: (options?: {
-        onlyIfTrusted?: boolean;
-    }) => Promise<{
-        publicKey: string;
-    }>;
-    disconnect: () => Promise<void>;
-    switchNetwork: (network: "mainnet" | "devnet") => Promise<void | undefined>;
-    getPublicKey: () => Promise<string | null>;
+    solana: ISolanaChain;
     isAvailable: boolean;
-    isConnected: boolean;
 };
 
 /**
  * Hook for Ethereum chain operations in React Native
  *
- * @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>;
-    signTransaction: (transaction: EthTransactionRequest) => Promise<string>;
-    signTypedData: (typedData: any) => Promise<string>;
-    sendTransaction: (transaction: EthTransactionRequest) => Promise<string>;
-    switchChain: (chainId: number) => Promise<void>;
-    getChainId: () => Promise<number>;
-    getAccounts: () => Promise<string[]>;
+    ethereum: IEthereumChain;
     isAvailable: boolean;
-    isConnected: boolean;
 };
 
 export { ConnectOptions, PhantomDebugConfig, PhantomProvider, PhantomSDKConfig, useAccounts, useConnect, useDisconnect, useEthereum, usePhantom, useSolana };