@dubsdotapp/expo 0.2.9 → 0.2.11

package/dist/index.d.mts

@@ -403,6 +403,7 @@ interface TokenStorage {
 declare const STORAGE_KEYS: {
     readonly MWA_AUTH_TOKEN: "dubs_mwa_auth_token";
     readonly JWT_TOKEN: "dubs_jwt_token";
+    readonly PHANTOM_SESSION: "dubs_phantom_session";
 };
 /**
  * Creates a TokenStorage backed by expo-secure-store.
@@ -438,12 +439,6 @@ interface WalletAdapter {
     connect?(): Promise<void>;
     /** Optional: Disconnect the wallet */
     disconnect?(): void | Promise<void>;
-    /**
-     * Optional: Connect and sign a message in one step.
-     * For MWA wallets, this runs authorize + signMessage in a single transact() session
-     * (avoids the double-open problem with Phantom on regular Android).
-     */
-    connectAndSignMessage?(message: Uint8Array): Promise<Uint8Array>;
 }
 
 interface RegistrationScreenProps {
@@ -515,8 +510,12 @@ interface DubsProviderProps {
     renderRegistration?: (props: RegistrationScreenProps) => React$1.ReactNode;
     /** Set to false to skip AuthGate and connect screen (headless/BYOA mode). Default: true. */
     managed?: boolean;
+    /** Deeplink redirect URI for Phantom wallet (required for iOS support). */
+    redirectUri?: string;
+    /** App URL shown in Phantom's connect screen. */
+    appUrl?: string;
 }
-declare function DubsProvider({ apiKey, children, appName, network, wallet: externalWallet, tokenStorage, baseUrl: baseUrlOverride, rpcUrl: rpcUrlOverride, renderConnectScreen, renderLoading, renderError, renderRegistration, managed, }: DubsProviderProps): react_jsx_runtime.JSX.Element | null;
+declare function DubsProvider({ apiKey, children, appName, network, wallet: externalWallet, tokenStorage, baseUrl: baseUrlOverride, rpcUrl: rpcUrlOverride, renderConnectScreen, renderLoading, renderError, renderRegistration, managed, redirectUri, appUrl, }: DubsProviderProps): react_jsx_runtime.JSX.Element | null;
 declare function useDubs(): DubsContextValue;
 declare function useAppConfig(): UiConfig;
 
@@ -568,13 +567,68 @@ declare class MwaWalletAdapter implements WalletAdapter {
     disconnect(): void;
     signTransaction(transaction: Transaction): Promise<Transaction>;
     signMessage(message: Uint8Array): Promise<Uint8Array>;
+    signAndSendTransaction(transaction: Transaction): Promise<string>;
+}
+
+/** Serializable session state — save this to restore without a deeplink round-trip. */
+interface PhantomSession {
+    /** Our x25519 public key (base58) */
+    dappPublicKey: string;
+    /** Our x25519 secret key (base58) */
+    dappSecretKey: string;
+    /** Phantom's x25519 public key (base58) */
+    phantomPublicKey: string;
+    /** Shared secret (base58) */
+    sharedSecret: string;
+    /** Phantom session token (opaque string) */
+    sessionToken: string;
+    /** User's wallet public key (base58) */
+    walletPublicKey: string;
+}
+interface PhantomDeeplinkAdapterConfig {
+    /** The deeplink redirect URI, e.g. "myapp://phantom-callback" */
+    redirectUri: string;
+    /** Shown in Phantom's connect screen */
+    appUrl?: string;
+    /** Solana cluster: 'devnet' | 'mainnet-beta' */
+    cluster?: string;
+    /** Deeplink round-trip timeout in ms (default 120000) */
+    timeout?: number;
+    /** Called when the Phantom session changes (save/clear for persistence) */
+    onSessionChange?: (session: PhantomSession | null) => void;
+}
+/**
+ * Phantom wallet adapter using deeplinks (works on iOS and Android).
+ * Uses x25519 encrypted communication per Phantom's deeplink protocol.
+ */
+declare class PhantomDeeplinkAdapter implements WalletAdapter {
+    private _publicKey;
+    private _connected;
+    private _dappKeyPair;
+    private _sharedSecret;
+    private _sessionToken;
+    private _phantomPublicKey;
+    private readonly config;
+    private readonly handler;
+    private readonly timeout;
+    constructor(config: PhantomDeeplinkAdapterConfig);
+    get publicKey(): PublicKey | null;
+    get connected(): boolean;
     /**
-     * Connect (authorize) and sign a message in a single MWA transact() session.
-     * This avoids the double-open problem with Phantom on regular Android where
-     * two rapid transact() calls cause the second one to be auto-declined.
+     * Restore a previously saved session without opening Phantom.
+     * Call this before connect() if you have persisted session state.
      */
-    connectAndSignMessage(message: Uint8Array): Promise<Uint8Array>;
+    restoreSession(saved: PhantomSession): void;
+    /** Serialize the current session for persistence. Returns null if not connected. */
+    getSession(): PhantomSession | null;
+    connect(): Promise<void>;
+    disconnect(): void;
+    signTransaction(transaction: Transaction): Promise<Transaction>;
     signAndSendTransaction(transaction: Transaction): Promise<string>;
+    signMessage(message: Uint8Array): Promise<Uint8Array>;
+    /** Remove the Linking event listener. Call when the adapter is no longer needed. */
+    destroy(): void;
+    private assertConnected;
 }
 
 declare function useEvents(params?: GetUpcomingEventsParams): QueryResult<{
@@ -813,4 +867,4 @@ declare function CreateCustomGameSheet({ visible, onDismiss, title, maxPlayers,
  */
 declare function signAndSendBase64Transaction(base64Tx: string, wallet: WalletAdapter): Promise<string>;
 
-export { AuthGate, type AuthGateProps, type AuthStatus, type AuthenticateParams, type AuthenticateResult, type Bettor, type BuildClaimParams, type BuildClaimResult, type CheckUsernameResult, type ClaimMutationResult, type ConfirmGameParams, type ConfirmGameResult, ConnectWalletScreen, type ConnectWalletScreenProps, type CreateCustomGameMutationResult, type CreateCustomGameParams, type CreateCustomGameResult, CreateCustomGameSheet, type CreateCustomGameSheetProps, type CreateGameMutationResult, type CreateGameParams, type CreateGameResult, DEFAULT_BASE_URL, DEFAULT_RPC_URL, DubsApiError, type DubsAppUser, DubsClient, type DubsClientConfig, type DubsContextValue, type DubsNetwork, DubsProvider, type DubsProviderProps, type DubsPublicUser, type DubsTheme, type DubsUser, type EsportsMatchDetail, type EsportsMatchOpponent, type EsportsMatchResult, type EventMedia, type EventMeta, type EventStream, type GameDetail, type GameListItem, type GameListOpponent, type GameMedia, GamePoster, type GamePosterProps, type GetGamesParams, type GetNetworkGamesParams, type GetUpcomingEventsParams, JoinGameButton, type JoinGameButtonProps, type JoinGameMutationResult, type JoinGameParams, type JoinGameResult, LivePoolsCard, type LivePoolsCardProps, type LiveScore, type LiveScoreCompetitor, type MutationResult, type MutationStatus, type MwaAdapterConfig, type MwaTransactFn, MwaWalletAdapter, NETWORK_CONFIG, type NonceResult, type Opponent, type Pagination, type ParsedError, PickWinnerCard, type PickWinnerCardProps, PlayersCard, type PlayersCardProps, type QueryResult, type RegisterParams, type RegisterResult, type RegistrationScreenProps, SOLANA_PROGRAM_ERRORS, STORAGE_KEYS, SettingsSheet, type SettingsSheetProps, type SolanaErrorCode, type TokenStorage, type UiConfig, type UnifiedEvent, type UseAuthResult, UserProfileCard, type UserProfileCardProps, type ValidateEventResult, type WalletAdapter, createSecureStoreStorage, mergeTheme, parseSolanaError, signAndSendBase64Transaction, useAppConfig, useAuth, useClaim, useCreateCustomGame, useCreateGame, useDubs, useDubsTheme, useEvents, useGame, useGames, useJoinGame, useNetworkGames };
+export { AuthGate, type AuthGateProps, type AuthStatus, type AuthenticateParams, type AuthenticateResult, type Bettor, type BuildClaimParams, type BuildClaimResult, type CheckUsernameResult, type ClaimMutationResult, type ConfirmGameParams, type ConfirmGameResult, ConnectWalletScreen, type ConnectWalletScreenProps, type CreateCustomGameMutationResult, type CreateCustomGameParams, type CreateCustomGameResult, CreateCustomGameSheet, type CreateCustomGameSheetProps, type CreateGameMutationResult, type CreateGameParams, type CreateGameResult, DEFAULT_BASE_URL, DEFAULT_RPC_URL, DubsApiError, type DubsAppUser, DubsClient, type DubsClientConfig, type DubsContextValue, type DubsNetwork, DubsProvider, type DubsProviderProps, type DubsPublicUser, type DubsTheme, type DubsUser, type EsportsMatchDetail, type EsportsMatchOpponent, type EsportsMatchResult, type EventMedia, type EventMeta, type EventStream, type GameDetail, type GameListItem, type GameListOpponent, type GameMedia, GamePoster, type GamePosterProps, type GetGamesParams, type GetNetworkGamesParams, type GetUpcomingEventsParams, JoinGameButton, type JoinGameButtonProps, type JoinGameMutationResult, type JoinGameParams, type JoinGameResult, LivePoolsCard, type LivePoolsCardProps, type LiveScore, type LiveScoreCompetitor, type MutationResult, type MutationStatus, type MwaAdapterConfig, type MwaTransactFn, MwaWalletAdapter, NETWORK_CONFIG, type NonceResult, type Opponent, type Pagination, type ParsedError, PhantomDeeplinkAdapter, type PhantomDeeplinkAdapterConfig, type PhantomSession, PickWinnerCard, type PickWinnerCardProps, PlayersCard, type PlayersCardProps, type QueryResult, type RegisterParams, type RegisterResult, type RegistrationScreenProps, SOLANA_PROGRAM_ERRORS, STORAGE_KEYS, SettingsSheet, type SettingsSheetProps, type SolanaErrorCode, type TokenStorage, type UiConfig, type UnifiedEvent, type UseAuthResult, UserProfileCard, type UserProfileCardProps, type ValidateEventResult, type WalletAdapter, createSecureStoreStorage, mergeTheme, parseSolanaError, signAndSendBase64Transaction, useAppConfig, useAuth, useClaim, useCreateCustomGame, useCreateGame, useDubs, useDubsTheme, useEvents, useGame, useGames, useJoinGame, useNetworkGames };

package/dist/index.d.ts

@@ -403,6 +403,7 @@ interface TokenStorage {
 declare const STORAGE_KEYS: {
     readonly MWA_AUTH_TOKEN: "dubs_mwa_auth_token";
     readonly JWT_TOKEN: "dubs_jwt_token";
+    readonly PHANTOM_SESSION: "dubs_phantom_session";
 };
 /**
  * Creates a TokenStorage backed by expo-secure-store.
@@ -438,12 +439,6 @@ interface WalletAdapter {
     connect?(): Promise<void>;
     /** Optional: Disconnect the wallet */
     disconnect?(): void | Promise<void>;
-    /**
-     * Optional: Connect and sign a message in one step.
-     * For MWA wallets, this runs authorize + signMessage in a single transact() session
-     * (avoids the double-open problem with Phantom on regular Android).
-     */
-    connectAndSignMessage?(message: Uint8Array): Promise<Uint8Array>;
 }
 
 interface RegistrationScreenProps {
@@ -515,8 +510,12 @@ interface DubsProviderProps {
     renderRegistration?: (props: RegistrationScreenProps) => React$1.ReactNode;
     /** Set to false to skip AuthGate and connect screen (headless/BYOA mode). Default: true. */
     managed?: boolean;
+    /** Deeplink redirect URI for Phantom wallet (required for iOS support). */
+    redirectUri?: string;
+    /** App URL shown in Phantom's connect screen. */
+    appUrl?: string;
 }
-declare function DubsProvider({ apiKey, children, appName, network, wallet: externalWallet, tokenStorage, baseUrl: baseUrlOverride, rpcUrl: rpcUrlOverride, renderConnectScreen, renderLoading, renderError, renderRegistration, managed, }: DubsProviderProps): react_jsx_runtime.JSX.Element | null;
+declare function DubsProvider({ apiKey, children, appName, network, wallet: externalWallet, tokenStorage, baseUrl: baseUrlOverride, rpcUrl: rpcUrlOverride, renderConnectScreen, renderLoading, renderError, renderRegistration, managed, redirectUri, appUrl, }: DubsProviderProps): react_jsx_runtime.JSX.Element | null;
 declare function useDubs(): DubsContextValue;
 declare function useAppConfig(): UiConfig;
 
@@ -568,13 +567,68 @@ declare class MwaWalletAdapter implements WalletAdapter {
     disconnect(): void;
     signTransaction(transaction: Transaction): Promise<Transaction>;
     signMessage(message: Uint8Array): Promise<Uint8Array>;
+    signAndSendTransaction(transaction: Transaction): Promise<string>;
+}
+
+/** Serializable session state — save this to restore without a deeplink round-trip. */
+interface PhantomSession {
+    /** Our x25519 public key (base58) */
+    dappPublicKey: string;
+    /** Our x25519 secret key (base58) */
+    dappSecretKey: string;
+    /** Phantom's x25519 public key (base58) */
+    phantomPublicKey: string;
+    /** Shared secret (base58) */
+    sharedSecret: string;
+    /** Phantom session token (opaque string) */
+    sessionToken: string;
+    /** User's wallet public key (base58) */
+    walletPublicKey: string;
+}
+interface PhantomDeeplinkAdapterConfig {
+    /** The deeplink redirect URI, e.g. "myapp://phantom-callback" */
+    redirectUri: string;
+    /** Shown in Phantom's connect screen */
+    appUrl?: string;
+    /** Solana cluster: 'devnet' | 'mainnet-beta' */
+    cluster?: string;
+    /** Deeplink round-trip timeout in ms (default 120000) */
+    timeout?: number;
+    /** Called when the Phantom session changes (save/clear for persistence) */
+    onSessionChange?: (session: PhantomSession | null) => void;
+}
+/**
+ * Phantom wallet adapter using deeplinks (works on iOS and Android).
+ * Uses x25519 encrypted communication per Phantom's deeplink protocol.
+ */
+declare class PhantomDeeplinkAdapter implements WalletAdapter {
+    private _publicKey;
+    private _connected;
+    private _dappKeyPair;
+    private _sharedSecret;
+    private _sessionToken;
+    private _phantomPublicKey;
+    private readonly config;
+    private readonly handler;
+    private readonly timeout;
+    constructor(config: PhantomDeeplinkAdapterConfig);
+    get publicKey(): PublicKey | null;
+    get connected(): boolean;
     /**
-     * Connect (authorize) and sign a message in a single MWA transact() session.
-     * This avoids the double-open problem with Phantom on regular Android where
-     * two rapid transact() calls cause the second one to be auto-declined.
+     * Restore a previously saved session without opening Phantom.
+     * Call this before connect() if you have persisted session state.
      */
-    connectAndSignMessage(message: Uint8Array): Promise<Uint8Array>;
+    restoreSession(saved: PhantomSession): void;
+    /** Serialize the current session for persistence. Returns null if not connected. */
+    getSession(): PhantomSession | null;
+    connect(): Promise<void>;
+    disconnect(): void;
+    signTransaction(transaction: Transaction): Promise<Transaction>;
     signAndSendTransaction(transaction: Transaction): Promise<string>;
+    signMessage(message: Uint8Array): Promise<Uint8Array>;
+    /** Remove the Linking event listener. Call when the adapter is no longer needed. */
+    destroy(): void;
+    private assertConnected;
 }
 
 declare function useEvents(params?: GetUpcomingEventsParams): QueryResult<{
@@ -813,4 +867,4 @@ declare function CreateCustomGameSheet({ visible, onDismiss, title, maxPlayers,
  */
 declare function signAndSendBase64Transaction(base64Tx: string, wallet: WalletAdapter): Promise<string>;
 
-export { AuthGate, type AuthGateProps, type AuthStatus, type AuthenticateParams, type AuthenticateResult, type Bettor, type BuildClaimParams, type BuildClaimResult, type CheckUsernameResult, type ClaimMutationResult, type ConfirmGameParams, type ConfirmGameResult, ConnectWalletScreen, type ConnectWalletScreenProps, type CreateCustomGameMutationResult, type CreateCustomGameParams, type CreateCustomGameResult, CreateCustomGameSheet, type CreateCustomGameSheetProps, type CreateGameMutationResult, type CreateGameParams, type CreateGameResult, DEFAULT_BASE_URL, DEFAULT_RPC_URL, DubsApiError, type DubsAppUser, DubsClient, type DubsClientConfig, type DubsContextValue, type DubsNetwork, DubsProvider, type DubsProviderProps, type DubsPublicUser, type DubsTheme, type DubsUser, type EsportsMatchDetail, type EsportsMatchOpponent, type EsportsMatchResult, type EventMedia, type EventMeta, type EventStream, type GameDetail, type GameListItem, type GameListOpponent, type GameMedia, GamePoster, type GamePosterProps, type GetGamesParams, type GetNetworkGamesParams, type GetUpcomingEventsParams, JoinGameButton, type JoinGameButtonProps, type JoinGameMutationResult, type JoinGameParams, type JoinGameResult, LivePoolsCard, type LivePoolsCardProps, type LiveScore, type LiveScoreCompetitor, type MutationResult, type MutationStatus, type MwaAdapterConfig, type MwaTransactFn, MwaWalletAdapter, NETWORK_CONFIG, type NonceResult, type Opponent, type Pagination, type ParsedError, PickWinnerCard, type PickWinnerCardProps, PlayersCard, type PlayersCardProps, type QueryResult, type RegisterParams, type RegisterResult, type RegistrationScreenProps, SOLANA_PROGRAM_ERRORS, STORAGE_KEYS, SettingsSheet, type SettingsSheetProps, type SolanaErrorCode, type TokenStorage, type UiConfig, type UnifiedEvent, type UseAuthResult, UserProfileCard, type UserProfileCardProps, type ValidateEventResult, type WalletAdapter, createSecureStoreStorage, mergeTheme, parseSolanaError, signAndSendBase64Transaction, useAppConfig, useAuth, useClaim, useCreateCustomGame, useCreateGame, useDubs, useDubsTheme, useEvents, useGame, useGames, useJoinGame, useNetworkGames };
+export { AuthGate, type AuthGateProps, type AuthStatus, type AuthenticateParams, type AuthenticateResult, type Bettor, type BuildClaimParams, type BuildClaimResult, type CheckUsernameResult, type ClaimMutationResult, type ConfirmGameParams, type ConfirmGameResult, ConnectWalletScreen, type ConnectWalletScreenProps, type CreateCustomGameMutationResult, type CreateCustomGameParams, type CreateCustomGameResult, CreateCustomGameSheet, type CreateCustomGameSheetProps, type CreateGameMutationResult, type CreateGameParams, type CreateGameResult, DEFAULT_BASE_URL, DEFAULT_RPC_URL, DubsApiError, type DubsAppUser, DubsClient, type DubsClientConfig, type DubsContextValue, type DubsNetwork, DubsProvider, type DubsProviderProps, type DubsPublicUser, type DubsTheme, type DubsUser, type EsportsMatchDetail, type EsportsMatchOpponent, type EsportsMatchResult, type EventMedia, type EventMeta, type EventStream, type GameDetail, type GameListItem, type GameListOpponent, type GameMedia, GamePoster, type GamePosterProps, type GetGamesParams, type GetNetworkGamesParams, type GetUpcomingEventsParams, JoinGameButton, type JoinGameButtonProps, type JoinGameMutationResult, type JoinGameParams, type JoinGameResult, LivePoolsCard, type LivePoolsCardProps, type LiveScore, type LiveScoreCompetitor, type MutationResult, type MutationStatus, type MwaAdapterConfig, type MwaTransactFn, MwaWalletAdapter, NETWORK_CONFIG, type NonceResult, type Opponent, type Pagination, type ParsedError, PhantomDeeplinkAdapter, type PhantomDeeplinkAdapterConfig, type PhantomSession, PickWinnerCard, type PickWinnerCardProps, PlayersCard, type PlayersCardProps, type QueryResult, type RegisterParams, type RegisterResult, type RegistrationScreenProps, SOLANA_PROGRAM_ERRORS, STORAGE_KEYS, SettingsSheet, type SettingsSheetProps, type SolanaErrorCode, type TokenStorage, type UiConfig, type UnifiedEvent, type UseAuthResult, UserProfileCard, type UserProfileCardProps, type ValidateEventResult, type WalletAdapter, createSecureStoreStorage, mergeTheme, parseSolanaError, signAndSendBase64Transaction, useAppConfig, useAuth, useClaim, useCreateCustomGame, useCreateGame, useDubs, useDubsTheme, useEvents, useGame, useGames, useJoinGame, useNetworkGames };