@phantom/browser-sdk 1.0.0-beta.21 → 1.0.0-beta.24

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { EmbeddedProviderConfig, AuthOptions, ConnectResult, WalletAddress, EmbeddedProviderEvent, EventCallback } from '@phantom/embedded-provider-core';
-export { AuthOptions, ConnectErrorEventData, ConnectEventData, ConnectResult, ConnectStartEventData, DisconnectEventData, EmbeddedProviderEvent, EmbeddedProviderEventMap, EventCallback, SignAndSendTransactionParams, SignMessageParams, SignMessageResult, SignedTransaction, WalletAddress } from '@phantom/embedded-provider-core';
+import { EmbeddedProviderConfig, EmbeddedProviderAuthType, ConnectResult as ConnectResult$1, WalletAddress, EmbeddedProviderEvent, EventCallback } from '@phantom/embedded-provider-core';
+export { ConnectErrorEventData, ConnectEventData, ConnectStartEventData, DisconnectEventData, EmbeddedProviderEvent, EmbeddedProviderEventMap, EventCallback, SignAndSendTransactionParams, SignMessageParams, SignMessageResult, SignedTransaction, WalletAddress } from '@phantom/embedded-provider-core';
 import { ISolanaChain, IEthereumChain } from '@phantom/chain-interfaces';
 export { EthTransactionRequest, IEthereumChain, ISolanaChain } from '@phantom/chain-interfaces';
 import { AddressType } from '@phantom/client';
@@ -52,9 +52,6 @@ declare const DebugCategory: {
     readonly SESSION: "Session";
 };
 
-/**
- * Phantom extension app.login API types
- */
 interface PhantomAppLoginOptions {
     publicKey: string;
     appId: string;
@@ -95,34 +92,37 @@ interface DebugConfig {
     level?: DebugLevel;
     callback?: DebugCallback;
 }
-type BrowserSDKConfig = Prettify<(ExtendedEmbeddedProviderConfig | ExtendedInjectedProviderConfig) & {
-    autoConnect?: boolean;
-}>;
-type Prettify<T> = {
-    [K in keyof T]: T[K];
-} & {};
-interface ExtendedEmbeddedProviderConfig extends Omit<EmbeddedProviderConfig, "authOptions" | "apiBaseUrl" | "embeddedWalletType"> {
-    providerType: "embedded";
+type BrowserSDKConfig = Prettify<Omit<EmbeddedProviderConfig, "authOptions" | "apiBaseUrl" | "embeddedWalletType" | "appId"> & InjectedProviderConfig & {
+    providers: AuthProviderType[];
+    appId?: string;
     apiBaseUrl?: string;
     embeddedWalletType?: "app-wallet" | "user-wallet";
     authOptions?: {
         authUrl?: string;
         redirectUrl?: string;
     };
-}
-interface ExtendedInjectedProviderConfig extends InjectedProviderConfig {
-    providerType: "injected";
-    appId?: never;
-    authOptions?: never;
-    embeddedWalletType?: never;
-}
+}>;
+type Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+type AuthProviderType = EmbeddedProviderAuthType | "injected";
+type AuthOptions = {
+    provider: AuthProviderType;
+    walletId?: string;
+    customAuthData?: Record<string, any>;
+};
+type ConnectResult = Omit<ConnectResult$1, "authProvider"> & {
+    authProvider?: AuthProviderType | undefined;
+    walletId?: string | undefined;
+};
 
 interface Provider {
-    connect(authOptions?: AuthOptions): Promise<ConnectResult>;
+    connect(authOptions: AuthOptions): Promise<ConnectResult>;
     disconnect(): Promise<void>;
     getAddresses(): WalletAddress[];
     isConnected(): boolean;
     autoConnect(): Promise<void>;
+    getEnabledAddressTypes(): AddressType[];
     solana: ISolanaChain;
     ethereum: IEthereumChain;
 }
@@ -132,22 +132,30 @@ interface ProviderPreference {
     embeddedWalletType?: "app-wallet" | "user-wallet";
 }
 
-/**
- * Browser SDK with chain-specific API
- *
- * Usage:
- * ```typescript
- * const sdk = new BrowserSDK({ providerType: 'embedded', appId: 'your-app-id' });
- * await sdk.connect();
- *
- * // Chain-specific operations
- * await sdk.solana.signMessage(message);
- * await sdk.ethereum.signPersonalMessage(message, address);
- * ```
- */
+type InjectedWalletId = string;
+interface WalletProviders {
+    /** EIP-6963 Ethereum provider (window.ethereum-like) */
+    ethereum?: IEthereumChain;
+    /** Wallet Standard Solana wallet object */
+    solana?: ISolanaChain;
+}
+interface InjectedWalletInfo {
+    id: InjectedWalletId;
+    name: string;
+    icon?: string;
+    addressTypes: AddressType[];
+    providers?: WalletProviders;
+    /** Reverse DNS identifier from EIP-6963 (for potential future matching with Wallet Standard) */
+    rdns?: string;
+}
+
 declare class BrowserSDK {
     private providerManager;
+    private walletRegistry;
+    private config;
+    isLoading: boolean;
     constructor(config: BrowserSDKConfig);
+    discoverWallets(): Promise<void>;
     /**
      * Access Solana chain operations
      */
@@ -177,9 +185,12 @@ declare class BrowserSDK {
      */
     getCurrentProviderInfo(): ProviderPreference | null;
     /**
-     * Check if Phantom extension is installed
+     * Get enabled address types for the current provider
+     * - For embedded provider: returns config.addressTypes
+     * - For Phantom injected: returns config.addressTypes
+     * - For discovered wallets: returns the wallet's addressTypes from registry
      */
-    static isPhantomInstalled(timeoutMs?: number): Promise<boolean>;
+    getEnabledAddressTypes(): AddressType[];
     /**
      * Add event listener for provider events (connect, connect_start, connect_error, disconnect, error)
      * Works with both embedded and injected providers
@@ -196,29 +207,10 @@ declare class BrowserSDK {
      * Tries embedded provider first, then injected provider as fallback
      */
     autoConnect(): Promise<void>;
-    /**
-     * Debug configuration methods
-     * These allow dynamic debug configuration without SDK reinstantiation
-     */
-    /**
-     * Enable debug logging
-     */
     enableDebug(): void;
-    /**
-     * Disable debug logging
-     */
     disableDebug(): void;
-    /**
-     * Set debug level
-     */
     setDebugLevel(level: DebugLevel): void;
-    /**
-     * Set debug callback function
-     */
     setDebugCallback(callback: DebugCallback): void;
-    /**
-     * Configure debug settings all at once
-     */
     configureDebug(config: {
         enabled?: boolean;
         level?: DebugLevel;
@@ -244,6 +236,7 @@ declare class BrowserSDK {
      * Only available for injected providers
      */
     getSupportedAutoConfirmChains(): Promise<AutoConfirmSupportedChainsResult>;
+    getDiscoveredWallets(): InjectedWalletInfo[];
 }
 
 /**
@@ -317,13 +310,8 @@ declare function waitForPhantomExtension(timeoutMs?: number): Promise<boolean>;
  * Usage:
  * ```typescript
  * const isAvailable = await isPhantomLoginAvailable();
- * if (isAvailable) {
- *   console.log("Phantom Login is available!");
- * } else {
- *   console.log("Phantom Login is not available");
- * }
  * ```
  */
 declare function isPhantomLoginAvailable(timeoutMs?: number): Promise<boolean>;
 
-export { BrowserInfo, BrowserSDK, BrowserSDKConfig, DebugCallback, DebugCategory, DebugConfig, DebugLevel, DebugMessage, Provider, debug, detectBrowser, getBrowserDisplayName, getDeeplinkToPhantom, getPlatformName, isMobileDevice, isPhantomLoginAvailable, parseBrowserFromUserAgent, waitForPhantomExtension };
+export { AuthOptions, AuthProviderType, BrowserInfo, BrowserSDK, BrowserSDKConfig, ConnectResult, DebugCallback, DebugCategory, DebugConfig, DebugLevel, DebugMessage, InjectedWalletId, InjectedWalletInfo, Provider, debug, detectBrowser, getBrowserDisplayName, getDeeplinkToPhantom, getPlatformName, isMobileDevice, isPhantomLoginAvailable, parseBrowserFromUserAgent, waitForPhantomExtension };