@phantom/embedded-provider-core 1.0.0-beta.9 → 1.0.0

package/README.md

@@ -114,15 +114,15 @@ export class YourStorageAdapter implements EmbeddedStorage {
 Handles authentication flows:
 
 ```typescript
-import { AuthProvider, AuthResult, PhantomConnectOptions, JWTAuthOptions } from "@phantom/embedded-provider-core";
+import { AuthProvider, AuthResult, PhantomConnectOptions } from "@phantom/embedded-provider-core";
 
 export class YourAuthProvider implements AuthProvider {
-  async authenticate(options: PhantomConnectOptions | JWTAuthOptions): Promise<void | AuthResult> {
+  async authenticate(options: PhantomConnectOptions): Promise<void | AuthResult> {
     // Platform-specific authentication
     // Browser: window redirects, React Native: deep links
   }
 
-  resumeAuthFromRedirect?(): AuthResult | null {
+  resumeAuthFromRedirect?(provider: EmbeddedProviderAuthType): AuthResult | null {
     // Resume authentication after redirect/deep link
   }
 }
@@ -179,7 +179,6 @@ For server-side authenticated users:
 const authOptions = {
   provider: "jwt",
   jwtToken: "your-jwt-token",
-  customAuthData: { userId: "user123" },
 };
 
 const result = await provider.connect(authOptions);
@@ -193,7 +192,6 @@ For social login flows:
 // Google OAuth
 const authOptions = {
   provider: "google",
-  customAuthData: { referrer: "landing-page" },
 };
 
 await provider.connect(authOptions); // Will redirect/deep link

package/dist/index.d.mts

@@ -1,9 +1,56 @@
-import { StamperWithKeyManagement, Transaction, VersionedTransaction } from '@phantom/sdk-types';
-import { ClientSideSdkHeaders, NetworkId } from '@phantom/constants';
-import { AddressType } from '@phantom/client';
+import { AddressType, SpendingLimitError } from '@phantom/client';
+import { NetworkId, ClientSideSdkHeaders } from '@phantom/constants';
 import { ParsedSignatureResult, ParsedTransactionResult } from '@phantom/parsers';
+import { StamperWithKeyManagement, Transaction, VersionedTransaction } from '@phantom/sdk-types';
 import { ISolanaChain, IEthereumChain, EthTransactionRequest } from '@phantom/chain-interfaces';
 
+interface WalletAddress {
+    addressType: AddressType;
+    address: string;
+}
+interface ConnectResult {
+    walletId?: string;
+    addresses: WalletAddress[];
+    status?: "pending" | "completed";
+    authUserId?: string;
+    authProvider: EmbeddedProviderAuthType;
+}
+interface SignMessageParams {
+    message: string;
+    networkId: NetworkId;
+}
+interface SignTypedDataV4Params {
+    typedData: any;
+    networkId: NetworkId;
+}
+interface SignMessageResult extends ParsedSignatureResult {
+}
+interface SignTransactionParams {
+    transaction: any;
+    networkId: NetworkId;
+}
+interface SignAndSendTransactionParams {
+    transaction: any;
+    networkId: NetworkId;
+}
+interface SignedTransaction extends ParsedTransactionResult {
+}
+type EmbeddedProviderAuthType = "google" | "apple" | "phantom" | "device";
+interface AuthOptions {
+    provider: EmbeddedProviderAuthType;
+    customAuthData?: Record<string, any>;
+}
+interface EmbeddedProviderConfig {
+    apiBaseUrl: string;
+    appId: string;
+    authOptions: {
+        authUrl: string;
+        redirectUrl: string;
+    };
+    embeddedWalletType: "app-wallet" | "user-wallet" | (string & Record<never, never>);
+    addressTypes: AddressType[];
+}
+
 interface Keypair {
     publicKey: string;
     secretKey: string;
@@ -21,21 +68,22 @@ interface Session {
     appId: string;
     stamperInfo: StamperInfo;
     keypair?: Keypair;
-    authProvider?: string;
-    userInfo?: Record<string, any>;
+    authProvider: EmbeddedProviderAuthType;
     status: "pending" | "completed" | "failed";
     createdAt: number;
     lastUsed: number;
     authenticatorCreatedAt: number;
     authenticatorExpiresAt: number;
     lastRenewalAttempt?: number;
-    username: string;
     accountDerivationIndex?: number;
+    authUserId?: string;
 }
 interface EmbeddedStorage {
     getSession(): Promise<Session | null>;
     saveSession(session: Session): Promise<void>;
     clearSession(): Promise<void>;
+    getShouldClearPreviousSession(): Promise<boolean>;
+    setShouldClearPreviousSession(should: boolean): Promise<void>;
 }
 
 /**
@@ -60,34 +108,41 @@ interface URLParamsAccessor {
 
 interface AuthResult {
     walletId: string;
-    provider?: string;
-    userInfo?: Record<string, any>;
-    accountDerivationIndex?: number;
+    organizationId: string;
+    provider: EmbeddedProviderAuthType;
+    accountDerivationIndex: number;
+    expiresInMs: number;
+    authUserId?: string;
 }
 interface PhantomConnectOptions {
-    organizationId: string;
+    publicKey: string;
     appId: string;
-    provider?: "google" | "apple";
+    provider: EmbeddedProviderAuthType;
     redirectUrl?: string;
-    customAuthData?: Record<string, any>;
     authUrl?: string;
     sessionId: string;
+    clearPreviousSession?: boolean;
+    allowRefresh?: boolean;
+}
+interface AuthProvider {
+    authenticate(options: PhantomConnectOptions): Promise<void | AuthResult>;
+    resumeAuthFromRedirect?(provider: EmbeddedProviderAuthType): AuthResult | null;
 }
-interface JWTAuthOptions {
+interface PhantomAppAuthOptions {
+    publicKey: string;
     appId: string;
-    organizationId: string;
-    jwtToken: string;
-    customAuthData?: Record<string, any>;
+    sessionId: string;
 }
-interface AuthProvider {
-    authenticate(options: PhantomConnectOptions | JWTAuthOptions): Promise<void | AuthResult>;
-    resumeAuthFromRedirect?(): AuthResult | null;
+interface PhantomAppProvider {
+    authenticate(options: PhantomAppAuthOptions): Promise<AuthResult>;
+    isAvailable(): boolean;
 }
 
 interface PlatformAdapter {
     name: string;
     storage: EmbeddedStorage;
     authProvider: AuthProvider;
+    phantomAppProvider: PhantomAppProvider;
     urlParamsAccessor: URLParamsAccessor;
     stamper: StamperWithKeyManagement;
     analyticsHeaders?: Partial<ClientSideSdkHeaders>;
@@ -99,67 +154,52 @@ interface DebugLogger {
     log(category: string, message: string, data?: any): void;
 }
 
-interface WalletAddress {
-    addressType: AddressType;
-    address: string;
-}
-interface ConnectResult {
-    walletId?: string;
-    addresses: WalletAddress[];
-    status?: "pending" | "completed";
-}
-interface SignMessageParams {
-    message: string;
-    networkId: NetworkId;
-}
-interface SignMessageResult extends ParsedSignatureResult {
+type EmbeddedProviderEvent = "connect" | "connect_start" | "connect_error" | "disconnect" | "error" | "spending_limit_reached";
+interface ConnectEventData extends ConnectResult {
+    source: "auto-connect" | "manual-connect" | "manual-existing" | "existing-session" | "manual";
 }
-interface SignTransactionParams {
-    transaction: any;
-    networkId: NetworkId;
-}
-interface SignAndSendTransactionParams {
-    transaction: any;
-    networkId: NetworkId;
+interface ConnectStartEventData {
+    source: "auto-connect" | "manual-connect";
+    authOptions?: {
+        provider?: string;
+    };
 }
-interface SignedTransaction extends ParsedTransactionResult {
+interface ConnectErrorEventData {
+    error: string;
+    source: "auto-connect" | "manual-connect";
 }
-interface AuthOptions {
-    provider?: "google" | "apple" | "jwt";
-    jwtToken?: string;
-    customAuthData?: Record<string, any>;
+interface DisconnectEventData {
+    source: "manual";
 }
-interface EmbeddedProviderConfig {
-    apiBaseUrl: string;
-    appId: string;
-    authOptions: {
-        authUrl: string;
-        redirectUrl: string;
+interface EmbeddedProviderEventMap {
+    connect: ConnectEventData;
+    connect_start: ConnectStartEventData;
+    connect_error: ConnectErrorEventData;
+    disconnect: DisconnectEventData;
+    error: any;
+    spending_limit_reached: {
+        error: SpendingLimitError;
     };
-    embeddedWalletType: "app-wallet" | "user-wallet" | (string & Record<never, never>);
-    addressTypes: AddressType[];
 }
-
-type EmbeddedProviderEvent = "connect" | "connect_start" | "connect_error" | "disconnect" | "error";
-type EventCallback = (data?: any) => void;
+type EventCallback<T = any> = (data: T) => void;
 declare class EmbeddedProvider {
     private config;
     private platform;
     private storage;
     private authProvider;
+    private phantomAppProvider;
     private urlParamsAccessor;
     private stamper;
     private logger;
     private client;
     private walletId;
     private addresses;
-    private jwtAuth;
     readonly solana: ISolanaChain;
     readonly ethereum: IEthereumChain;
     private eventListeners;
     constructor(config: EmbeddedProviderConfig, platform: PlatformAdapter, logger: DebugLogger);
-    on(event: EmbeddedProviderEvent, callback: EventCallback): void;
-    off(event: EmbeddedProviderEvent, callback: EventCallback): void;
+    on<K extends EmbeddedProviderEvent>(event: K, callback: EventCallback<EmbeddedProviderEventMap[K]>): void;
+    off<K extends EmbeddedProviderEvent>(event: K, callback: EventCallback<EmbeddedProviderEventMap[K]>): void;
     private emit;
     /**
      * Get the appropriate address for a given network ID from available addresses
@@ -171,27 +211,25 @@ declare class EmbeddedProvider {
     private validateAuthOptions;
     private isSessionValid;
     autoConnect(): Promise<void>;
-    private createOrganizationAndStamper;
-    connect(authOptions?: AuthOptions): Promise<ConnectResult>;
-    disconnect(): Promise<void>;
+    private initializeStamper;
+    private createOrganizationForAppWallet;
+    connect(authOptions: AuthOptions): Promise<ConnectResult>;
+    disconnect(shouldClearPreviousSession?: boolean): Promise<void>;
     signMessage(params: SignMessageParams): Promise<ParsedSignatureResult>;
+    signEthereumMessage(params: SignMessageParams): Promise<ParsedSignatureResult>;
+    signTypedDataV4(params: SignTypedDataV4Params): Promise<ParsedSignatureResult>;
     signTransaction(params: SignTransactionParams): Promise<ParsedTransactionResult>;
     signAndSendTransaction(params: SignAndSendTransactionParams): Promise<ParsedTransactionResult>;
     getAddresses(): WalletAddress[];
     isConnected(): boolean;
     private handleAuthFlow;
-    private handleJWTAuth;
+    private handlePhantomAuth;
     private handleRedirectAuth;
     private completeAuthConnection;
     private ensureValidAuthenticator;
-    private renewAuthenticator;
     private initializeClientFromSession;
 }
 
-declare class JWTAuth {
-    authenticate(options: JWTAuthOptions): Promise<AuthResult>;
-}
-
 declare function generateSessionId(): string;
 
 declare function retryWithBackoff<T>(operation: () => Promise<T>, operationName: string, logger: DebugLogger, maxRetries?: number, baseDelay?: number): Promise<T>;
@@ -213,11 +251,11 @@ declare class EmbeddedSolanaChain implements ISolanaChain {
         signature: Uint8Array;
         publicKey: string;
     }>;
-    signTransaction(_transaction: Transaction | VersionedTransaction): Promise<Transaction | VersionedTransaction>;
+    signTransaction(transaction: Transaction | VersionedTransaction): Promise<Transaction | VersionedTransaction>;
     signAndSendTransaction(transaction: Transaction | VersionedTransaction): Promise<{
         signature: string;
     }>;
-    signAllTransactions(_transactions: (Transaction | VersionedTransaction)[]): Promise<(Transaction | VersionedTransaction)[]>;
+    signAllTransactions(transactions: (Transaction | VersionedTransaction)[]): Promise<(Transaction | VersionedTransaction)[]>;
     signAndSendAllTransactions(transactions: (Transaction | VersionedTransaction)[]): Promise<{
         signatures: string[];
     }>;
@@ -261,7 +299,7 @@ declare class EmbeddedEthereumChain implements IEthereumChain {
     signTypedData(typedData: any, address: string): Promise<string>;
     signTransaction(transaction: EthTransactionRequest): Promise<string>;
     sendTransaction(transaction: EthTransactionRequest): Promise<string>;
-    switchChain(chainId: number): Promise<void>;
+    switchChain(chainId: number | string): Promise<void>;
     getChainId(): Promise<number>;
     getAccounts(): Promise<string[]>;
     isConnected(): boolean;
@@ -273,9 +311,6 @@ declare class EmbeddedEthereumChain implements IEthereumChain {
     off(event: string, listener: (...args: any[]) => void): void;
 }
 
-/**
- * Constants for authenticator lifecycle management
- */
 /**
  * How long an authenticator is valid before it expires (in milliseconds)
  * Default: 7 days
@@ -288,5 +323,6 @@ declare const AUTHENTICATOR_EXPIRATION_TIME_MS: number;
  * For testing: Use smaller values like 2 * 60 * 1000 (2 minutes)
  */
 declare const AUTHENTICATOR_RENEWAL_WINDOW_MS: number;
+declare const EMBEDDED_PROVIDER_AUTH_TYPES: EmbeddedProviderAuthType[];
 
-export { AUTHENTICATOR_EXPIRATION_TIME_MS, AUTHENTICATOR_RENEWAL_WINDOW_MS, AuthOptions, AuthProvider, AuthResult, ConnectResult, DebugLogger, EmbeddedEthereumChain, EmbeddedProvider, EmbeddedProviderConfig, EmbeddedProviderEvent, EmbeddedSolanaChain, EmbeddedStorage, EventCallback, JWTAuth, JWTAuthOptions, Keypair, PhantomConnectOptions, PlatformAdapter, Session, SignAndSendTransactionParams, SignMessageParams, SignMessageResult, SignTransactionParams, SignedTransaction, StamperInfo, URLParamsAccessor, WalletAddress, generateSessionId, retryWithBackoff };
+export { AUTHENTICATOR_EXPIRATION_TIME_MS, AUTHENTICATOR_RENEWAL_WINDOW_MS, AuthOptions, AuthProvider, AuthResult, ConnectErrorEventData, ConnectEventData, ConnectResult, ConnectStartEventData, DebugLogger, DisconnectEventData, EMBEDDED_PROVIDER_AUTH_TYPES, EmbeddedEthereumChain, EmbeddedProvider, EmbeddedProviderAuthType, EmbeddedProviderConfig, EmbeddedProviderEvent, EmbeddedProviderEventMap, EmbeddedSolanaChain, EmbeddedStorage, EventCallback, Keypair, PhantomAppAuthOptions, PhantomAppProvider, PhantomConnectOptions, PlatformAdapter, Session, SignAndSendTransactionParams, SignMessageParams, SignMessageResult, SignTransactionParams, SignTypedDataV4Params, SignedTransaction, StamperInfo, URLParamsAccessor, WalletAddress, generateSessionId, retryWithBackoff };

package/dist/index.d.ts

@@ -1,9 +1,56 @@
-import { StamperWithKeyManagement, Transaction, VersionedTransaction } from '@phantom/sdk-types';
-import { ClientSideSdkHeaders, NetworkId } from '@phantom/constants';
-import { AddressType } from '@phantom/client';
+import { AddressType, SpendingLimitError } from '@phantom/client';
+import { NetworkId, ClientSideSdkHeaders } from '@phantom/constants';
 import { ParsedSignatureResult, ParsedTransactionResult } from '@phantom/parsers';
+import { StamperWithKeyManagement, Transaction, VersionedTransaction } from '@phantom/sdk-types';
 import { ISolanaChain, IEthereumChain, EthTransactionRequest } from '@phantom/chain-interfaces';
 
+interface WalletAddress {
+    addressType: AddressType;
+    address: string;
+}
+interface ConnectResult {
+    walletId?: string;
+    addresses: WalletAddress[];
+    status?: "pending" | "completed";
+    authUserId?: string;
+    authProvider: EmbeddedProviderAuthType;
+}
+interface SignMessageParams {
+    message: string;
+    networkId: NetworkId;
+}
+interface SignTypedDataV4Params {
+    typedData: any;
+    networkId: NetworkId;
+}
+interface SignMessageResult extends ParsedSignatureResult {
+}
+interface SignTransactionParams {
+    transaction: any;
+    networkId: NetworkId;
+}
+interface SignAndSendTransactionParams {
+    transaction: any;
+    networkId: NetworkId;
+}
+interface SignedTransaction extends ParsedTransactionResult {
+}
+type EmbeddedProviderAuthType = "google" | "apple" | "phantom" | "device";
+interface AuthOptions {
+    provider: EmbeddedProviderAuthType;
+    customAuthData?: Record<string, any>;
+}
+interface EmbeddedProviderConfig {
+    apiBaseUrl: string;
+    appId: string;
+    authOptions: {
+        authUrl: string;
+        redirectUrl: string;
+    };
+    embeddedWalletType: "app-wallet" | "user-wallet" | (string & Record<never, never>);
+    addressTypes: AddressType[];
+}
+
 interface Keypair {
     publicKey: string;
     secretKey: string;
@@ -21,21 +68,22 @@ interface Session {
     appId: string;
     stamperInfo: StamperInfo;
     keypair?: Keypair;
-    authProvider?: string;
-    userInfo?: Record<string, any>;
+    authProvider: EmbeddedProviderAuthType;
     status: "pending" | "completed" | "failed";
     createdAt: number;
     lastUsed: number;
     authenticatorCreatedAt: number;
     authenticatorExpiresAt: number;
     lastRenewalAttempt?: number;
-    username: string;
     accountDerivationIndex?: number;
+    authUserId?: string;
 }
 interface EmbeddedStorage {
     getSession(): Promise<Session | null>;
     saveSession(session: Session): Promise<void>;
     clearSession(): Promise<void>;
+    getShouldClearPreviousSession(): Promise<boolean>;
+    setShouldClearPreviousSession(should: boolean): Promise<void>;
 }
 
 /**
@@ -60,34 +108,41 @@ interface URLParamsAccessor {
 
 interface AuthResult {
     walletId: string;
-    provider?: string;
-    userInfo?: Record<string, any>;
-    accountDerivationIndex?: number;
+    organizationId: string;
+    provider: EmbeddedProviderAuthType;
+    accountDerivationIndex: number;
+    expiresInMs: number;
+    authUserId?: string;
 }
 interface PhantomConnectOptions {
-    organizationId: string;
+    publicKey: string;
     appId: string;
-    provider?: "google" | "apple";
+    provider: EmbeddedProviderAuthType;
     redirectUrl?: string;
-    customAuthData?: Record<string, any>;
     authUrl?: string;
     sessionId: string;
+    clearPreviousSession?: boolean;
+    allowRefresh?: boolean;
+}
+interface AuthProvider {
+    authenticate(options: PhantomConnectOptions): Promise<void | AuthResult>;
+    resumeAuthFromRedirect?(provider: EmbeddedProviderAuthType): AuthResult | null;
 }
-interface JWTAuthOptions {
+interface PhantomAppAuthOptions {
+    publicKey: string;
     appId: string;
-    organizationId: string;
-    jwtToken: string;
-    customAuthData?: Record<string, any>;
+    sessionId: string;
 }
-interface AuthProvider {
-    authenticate(options: PhantomConnectOptions | JWTAuthOptions): Promise<void | AuthResult>;
-    resumeAuthFromRedirect?(): AuthResult | null;
+interface PhantomAppProvider {
+    authenticate(options: PhantomAppAuthOptions): Promise<AuthResult>;
+    isAvailable(): boolean;
 }
 
 interface PlatformAdapter {
     name: string;
     storage: EmbeddedStorage;
     authProvider: AuthProvider;
+    phantomAppProvider: PhantomAppProvider;
     urlParamsAccessor: URLParamsAccessor;
     stamper: StamperWithKeyManagement;
     analyticsHeaders?: Partial<ClientSideSdkHeaders>;
@@ -99,67 +154,52 @@ interface DebugLogger {
     log(category: string, message: string, data?: any): void;
 }
 
-interface WalletAddress {
-    addressType: AddressType;
-    address: string;
-}
-interface ConnectResult {
-    walletId?: string;
-    addresses: WalletAddress[];
-    status?: "pending" | "completed";
-}
-interface SignMessageParams {
-    message: string;
-    networkId: NetworkId;
-}
-interface SignMessageResult extends ParsedSignatureResult {
+type EmbeddedProviderEvent = "connect" | "connect_start" | "connect_error" | "disconnect" | "error" | "spending_limit_reached";
+interface ConnectEventData extends ConnectResult {
+    source: "auto-connect" | "manual-connect" | "manual-existing" | "existing-session" | "manual";
 }
-interface SignTransactionParams {
-    transaction: any;
-    networkId: NetworkId;
-}
-interface SignAndSendTransactionParams {
-    transaction: any;
-    networkId: NetworkId;
+interface ConnectStartEventData {
+    source: "auto-connect" | "manual-connect";
+    authOptions?: {
+        provider?: string;
+    };
 }
-interface SignedTransaction extends ParsedTransactionResult {
+interface ConnectErrorEventData {
+    error: string;
+    source: "auto-connect" | "manual-connect";
 }
-interface AuthOptions {
-    provider?: "google" | "apple" | "jwt";
-    jwtToken?: string;
-    customAuthData?: Record<string, any>;
+interface DisconnectEventData {
+    source: "manual";
 }
-interface EmbeddedProviderConfig {
-    apiBaseUrl: string;
-    appId: string;
-    authOptions: {
-        authUrl: string;
-        redirectUrl: string;
+interface EmbeddedProviderEventMap {
+    connect: ConnectEventData;
+    connect_start: ConnectStartEventData;
+    connect_error: ConnectErrorEventData;
+    disconnect: DisconnectEventData;
+    error: any;
+    spending_limit_reached: {
+        error: SpendingLimitError;
     };
-    embeddedWalletType: "app-wallet" | "user-wallet" | (string & Record<never, never>);
-    addressTypes: AddressType[];
 }
-
-type EmbeddedProviderEvent = "connect" | "connect_start" | "connect_error" | "disconnect" | "error";
-type EventCallback = (data?: any) => void;
+type EventCallback<T = any> = (data: T) => void;
 declare class EmbeddedProvider {
     private config;
     private platform;
     private storage;
     private authProvider;
+    private phantomAppProvider;
     private urlParamsAccessor;
     private stamper;
     private logger;
     private client;
     private walletId;
     private addresses;
-    private jwtAuth;
     readonly solana: ISolanaChain;
     readonly ethereum: IEthereumChain;
     private eventListeners;
     constructor(config: EmbeddedProviderConfig, platform: PlatformAdapter, logger: DebugLogger);
-    on(event: EmbeddedProviderEvent, callback: EventCallback): void;
-    off(event: EmbeddedProviderEvent, callback: EventCallback): void;
+    on<K extends EmbeddedProviderEvent>(event: K, callback: EventCallback<EmbeddedProviderEventMap[K]>): void;
+    off<K extends EmbeddedProviderEvent>(event: K, callback: EventCallback<EmbeddedProviderEventMap[K]>): void;
     private emit;
     /**
      * Get the appropriate address for a given network ID from available addresses
@@ -171,27 +211,25 @@ declare class EmbeddedProvider {
     private validateAuthOptions;
     private isSessionValid;
     autoConnect(): Promise<void>;
-    private createOrganizationAndStamper;
-    connect(authOptions?: AuthOptions): Promise<ConnectResult>;
-    disconnect(): Promise<void>;
+    private initializeStamper;
+    private createOrganizationForAppWallet;
+    connect(authOptions: AuthOptions): Promise<ConnectResult>;
+    disconnect(shouldClearPreviousSession?: boolean): Promise<void>;
     signMessage(params: SignMessageParams): Promise<ParsedSignatureResult>;
+    signEthereumMessage(params: SignMessageParams): Promise<ParsedSignatureResult>;
+    signTypedDataV4(params: SignTypedDataV4Params): Promise<ParsedSignatureResult>;
     signTransaction(params: SignTransactionParams): Promise<ParsedTransactionResult>;
     signAndSendTransaction(params: SignAndSendTransactionParams): Promise<ParsedTransactionResult>;
     getAddresses(): WalletAddress[];
     isConnected(): boolean;
     private handleAuthFlow;
-    private handleJWTAuth;
+    private handlePhantomAuth;
     private handleRedirectAuth;
     private completeAuthConnection;
     private ensureValidAuthenticator;
-    private renewAuthenticator;
     private initializeClientFromSession;
 }
 
-declare class JWTAuth {
-    authenticate(options: JWTAuthOptions): Promise<AuthResult>;
-}
-
 declare function generateSessionId(): string;
 
 declare function retryWithBackoff<T>(operation: () => Promise<T>, operationName: string, logger: DebugLogger, maxRetries?: number, baseDelay?: number): Promise<T>;
@@ -213,11 +251,11 @@ declare class EmbeddedSolanaChain implements ISolanaChain {
         signature: Uint8Array;
         publicKey: string;
     }>;
-    signTransaction(_transaction: Transaction | VersionedTransaction): Promise<Transaction | VersionedTransaction>;
+    signTransaction(transaction: Transaction | VersionedTransaction): Promise<Transaction | VersionedTransaction>;
     signAndSendTransaction(transaction: Transaction | VersionedTransaction): Promise<{
         signature: string;
     }>;
-    signAllTransactions(_transactions: (Transaction | VersionedTransaction)[]): Promise<(Transaction | VersionedTransaction)[]>;
+    signAllTransactions(transactions: (Transaction | VersionedTransaction)[]): Promise<(Transaction | VersionedTransaction)[]>;
     signAndSendAllTransactions(transactions: (Transaction | VersionedTransaction)[]): Promise<{
         signatures: string[];
     }>;
@@ -261,7 +299,7 @@ declare class EmbeddedEthereumChain implements IEthereumChain {
     signTypedData(typedData: any, address: string): Promise<string>;
     signTransaction(transaction: EthTransactionRequest): Promise<string>;
     sendTransaction(transaction: EthTransactionRequest): Promise<string>;
-    switchChain(chainId: number): Promise<void>;
+    switchChain(chainId: number | string): Promise<void>;
     getChainId(): Promise<number>;
     getAccounts(): Promise<string[]>;
     isConnected(): boolean;
@@ -273,9 +311,6 @@ declare class EmbeddedEthereumChain implements IEthereumChain {
     off(event: string, listener: (...args: any[]) => void): void;
 }
 
-/**
- * Constants for authenticator lifecycle management
- */
 /**
  * How long an authenticator is valid before it expires (in milliseconds)
  * Default: 7 days
@@ -288,5 +323,6 @@ declare const AUTHENTICATOR_EXPIRATION_TIME_MS: number;
  * For testing: Use smaller values like 2 * 60 * 1000 (2 minutes)
  */
 declare const AUTHENTICATOR_RENEWAL_WINDOW_MS: number;
+declare const EMBEDDED_PROVIDER_AUTH_TYPES: EmbeddedProviderAuthType[];
 
-export { AUTHENTICATOR_EXPIRATION_TIME_MS, AUTHENTICATOR_RENEWAL_WINDOW_MS, AuthOptions, AuthProvider, AuthResult, ConnectResult, DebugLogger, EmbeddedEthereumChain, EmbeddedProvider, EmbeddedProviderConfig, EmbeddedProviderEvent, EmbeddedSolanaChain, EmbeddedStorage, EventCallback, JWTAuth, JWTAuthOptions, Keypair, PhantomConnectOptions, PlatformAdapter, Session, SignAndSendTransactionParams, SignMessageParams, SignMessageResult, SignTransactionParams, SignedTransaction, StamperInfo, URLParamsAccessor, WalletAddress, generateSessionId, retryWithBackoff };
+export { AUTHENTICATOR_EXPIRATION_TIME_MS, AUTHENTICATOR_RENEWAL_WINDOW_MS, AuthOptions, AuthProvider, AuthResult, ConnectErrorEventData, ConnectEventData, ConnectResult, ConnectStartEventData, DebugLogger, DisconnectEventData, EMBEDDED_PROVIDER_AUTH_TYPES, EmbeddedEthereumChain, EmbeddedProvider, EmbeddedProviderAuthType, EmbeddedProviderConfig, EmbeddedProviderEvent, EmbeddedProviderEventMap, EmbeddedSolanaChain, EmbeddedStorage, EventCallback, Keypair, PhantomAppAuthOptions, PhantomAppProvider, PhantomConnectOptions, PlatformAdapter, Session, SignAndSendTransactionParams, SignMessageParams, SignMessageResult, SignTransactionParams, SignTypedDataV4Params, SignedTransaction, StamperInfo, URLParamsAccessor, WalletAddress, generateSessionId, retryWithBackoff };