@getpara/react-sdk 1.8.0 → 2.0.0-alpha.3

package/dist/provider/hooks/mutations/index.d.ts

@@ -1,10 +1,25 @@
-export { useWaitForLoginAndSetup } from './useWaitForLoginAndSetup.js';
-export { useWaitForAccountCreation } from './useWaitForAccountCreation.js';
-export { useWaitForPasskeyAndCreateWallet } from './useWaitForPasskeyAndCreateWallet.js';
-export { useCreateUser } from './useCreateUser.js';
-export { useCheckIfUserExists } from './useCheckIfUserExists.js';
-export { useInitiateLogin } from './useInitiateLogin.js';
-export { useLogout } from './useLogout.js';
-export { useKeepSessionAlive } from './useKeepSessionAlive.js';
-export { useSignMessage } from './useSignMessage.js';
-export { useSignTransaction } from './useSignTransaction.js';
+export declare const useSignUpOrLogIn: () => import("../../types/utils.js").CoreMethodHook<"signUpOrLogIn">;
+export declare const useVerifyNewAccount: () => import("../../types/utils.js").CoreMethodHook<"verifyNewAccount">;
+export declare const useWaitForLogin: () => import("../../types/utils.js").CoreMethodHook<"waitForLogin">;
+export declare const useWaitForSignup: () => import("../../types/utils.js").CoreMethodHook<"waitForSignup">;
+export declare const useWaitForWalletCreation: () => import("../../types/utils.js").CoreMethodHook<"waitForWalletCreation">;
+export declare const useVerifyOAuth: () => import("../../types/utils.js").CoreMethodHook<"verifyOAuth">;
+export declare const useVerifyFarcaster: () => import("../../types/utils.js").CoreMethodHook<"verifyFarcaster">;
+export declare const useVerifyTelegram: () => import("../../types/utils.js").CoreMethodHook<"verifyTelegram">;
+export declare const useLoginExternalWallet: () => import("../../types/utils.js").CoreMethodHook<"loginExternalWallet">;
+export declare const useVerifyExternalWallet: () => import("../../types/utils.js").CoreMethodHook<"verifyExternalWallet">;
+export declare const useSetup2fa: () => import("../../types/utils.js").CoreMethodHook<"setup2fa">;
+export declare const useEnable2fa: () => import("../../types/utils.js").CoreMethodHook<"enable2fa">;
+export declare const useVerify2fa: () => import("../../types/utils.js").CoreMethodHook<"verify2fa">;
+export declare const useKeepSessionAlive: () => import("../../types/utils.js").CoreMethodHook<"keepSessionAlive">;
+export declare const useLogout: () => import("../../types/utils.js").CoreMethodHook<"logout">;
+export declare const useResendVerificationCode: () => import("../../types/utils.js").CoreMethodHook<"resendVerificationCode">;
+export declare const useCreateWallet: () => import("../../types/utils.js").CoreMethodHook<"createWallet">;
+export declare const useCreateWalletPerType: () => import("../../types/utils.js").CoreMethodHook<"createWalletPerType">;
+export declare const useCreatePregenWallet: () => import("../../types/utils.js").CoreMethodHook<"createPregenWallet">;
+export declare const useCreatePregenWalletPerType: () => import("../../types/utils.js").CoreMethodHook<"createPregenWalletPerType">;
+export declare const useClaimPregenWallets: () => import("../../types/utils.js").CoreMethodHook<"claimPregenWallets">;
+export declare const useHasPregenWallet: () => import("../../types/utils.js").CoreMethodHook<"hasPregenWallet">;
+export declare const useUpdatePregenWalletIdentifier: () => import("../../types/utils.js").CoreMethodHook<"updatePregenWalletIdentifier">;
+export declare const useSignMessage: () => import("../../types/utils.js").CoreMethodHook<"signMessage">;
+export declare const useSignTransaction: () => import("../../types/utils.js").CoreMethodHook<"signTransaction">;

package/dist/provider/hooks/mutations/utils.d.ts

@@ -0,0 +1,4 @@
+import { CoreMethodName, CoreMethodParams, CoreMethods } from '@getpara/web-sdk';
+import { CoreMethodHook } from '../../types/utils.js';
+import { CoreAction } from '../../actions/utils.js';
+export declare function generateHook<const method extends CoreMethodName & keyof CoreMethods>(method: method, action: CoreAction<method>, defaultParams?: CoreMethodParams<method>): () => CoreMethodHook<method>;

package/dist/provider/hooks/queries/index.d.ts

@@ -1,3 +1,2 @@
 export { useAccount } from './useAccount.js';
 export { useWallet } from './useWallet.js';
-export { useWalletBalance } from './useWalletBalance.js';

package/dist/provider/hooks/queries/useAccount.d.ts

@@ -2,9 +2,4 @@ export declare const ACCOUNT_BASE_KEY = "PARA_ACCOUNT";
 /**
  * Hook for retrieving a user account
  */
-export declare const useAccount: () => import("@tanstack/react-query").UseQueryResult<{
-    isConnected: boolean;
-    email: any;
-    phone: any;
-    wallets: any;
-}, Error>;
+export declare const useAccount: () => import("@tanstack/react-query").UseQueryResult<import("../../actions/getAccount.js").Account, Error>;

package/dist/provider/hooks/queries/useWallet.d.ts

@@ -2,4 +2,4 @@ export declare const WALLET_BASE_KEY = "PARA_WALLET";
 /**
  * Hook for retrieving the selected wallet
  */
-export declare const useWallet: () => import("@tanstack/react-query").UseQueryResult<Omit<import("@getpara/core-sdk").Wallet, "signer">, Error>;
+export declare const useWallet: () => import("@tanstack/react-query").UseQueryResult<Omit<import("@getpara/core-sdk").Wallet, "signer"> | null | undefined, Error>;

package/dist/provider/hooks/utils/useWalletState.d.ts

@@ -4,11 +4,12 @@ import { WalletType } from '@getpara/web-sdk';
  */
 export declare const useWalletState: () => {
     selectedWallet: {
-        id: string;
-        type: WalletType;
+        id: string | undefined;
+        type: WalletType | undefined;
     };
     setSelectedWallet: ({ id, type }: {
         id?: string;
         type?: WalletType;
     }) => void;
+    updateSelectedWallet: () => void;
 };

package/dist/provider/index.d.ts

@@ -1,3 +1,4 @@
 export { ParaProvider } from './ParaProvider.js';
 export * from './hooks/index.js';
 export * from './stores/getters.js';
+export * from './stores/setters.js';

package/dist/provider/providers/AuthProvider.d.ts

@@ -0,0 +1,31 @@
+import { BiometricHints } from '@getpara/react-common';
+import { PropsWithChildren } from 'react';
+import { AuthMethod, CoreMethodParams, AuthState, AuthStateSignup, AuthStateLogin } from '@getpara/web-sdk';
+import { ParaModalProps } from '../../modal//types/modalProps.js';
+import { TelegramAuthResponse, VerifiedAuth, VerifyExternalWalletParams } from '@getpara/user-management-client';
+type Value = {
+    signUpOrLogIn: [(_: VerifiedAuth) => void, boolean];
+    verifyNewAccount: [(_: string) => void, boolean, Error | null];
+    verifyOAuth: (_: CoreMethodParams<'verifyOAuth'>['method']) => void;
+    verifyFarcaster: () => void;
+    verifyTelegram: (_: TelegramAuthResponse) => void;
+    verifyExternalWallet: (_: VerifyExternalWalletParams) => void;
+    onNewAuthState: (_: AuthState) => void;
+    presentSignupUi: (_: AuthMethod, __: AuthStateSignup) => void;
+    presentLoginUi: (_: AuthMethod, __: AuthStateLogin) => void;
+    setup2fa: [boolean];
+    logout: () => void;
+    biometricHints?: BiometricHints;
+};
+type Props = PropsWithChildren<{
+    is2faEnabled?: boolean;
+    isRecoverySecretStepEnabled?: boolean;
+    overrides?: {
+        login?: ParaModalProps['loginTransitionOverride'];
+        createWallets?: ParaModalProps['createWalletOverride'];
+    };
+}>;
+export declare const AuthContext: import("react").Context<Value>;
+export declare function AuthProvider({ children, is2faEnabled, isRecoverySecretStepEnabled, overrides, }: Props): import("react/jsx-runtime").JSX.Element;
+export declare const useAuthActions: () => Value;
+export {};

package/dist/provider/providers/CosmosExternalWalletProvider.d.ts

@@ -0,0 +1,7 @@
+import { PropsWithChildren } from 'react';
+import { ExternalWalletProviderCommon, ParaCosmosProviderConfigNoWallets } from '../types/externalWalletProviders.js';
+import { ParaCosmosProviderProps } from '@getpara/cosmos-wallet-connectors';
+export declare function CosmosExternalWalletProvider({ children, isUsing, wallets: walletsFromProps, ...rest }: Omit<ParaCosmosProviderProps, 'config'> & {
+    config: ParaCosmosProviderConfigNoWallets;
+} & PropsWithChildren & ExternalWalletProviderCommon): string | number | boolean | Iterable<import("react").ReactNode> | import("react/jsx-runtime").JSX.Element | null | undefined;
+export declare const MemoizedCosmosExternalWalletProvider: import("react").MemoExoticComponent<typeof CosmosExternalWalletProvider>;

package/dist/provider/providers/EvmExternalWalletProvider.d.ts

@@ -0,0 +1,7 @@
+import { PropsWithChildren } from 'react';
+import { ParaEvmProviderProps } from '@getpara/evm-wallet-connectors';
+import { Chain, Transport } from 'viem';
+import { ExternalWalletProviderCommon, ParaEvmProviderConfigNoWallets } from '../types/externalWalletProviders.js';
+export declare function EvmExternalWalletProvider<const chains extends readonly [Chain, ...Chain[]], transports extends Record<chains[number]['id'], Transport>>({ children, isUsing, wallets: walletsFromProps, ...rest }: Omit<ParaEvmProviderProps<chains, transports>, 'config'> & {
+    config: ParaEvmProviderConfigNoWallets<chains, transports>;
+} & PropsWithChildren & ExternalWalletProviderCommon): string | number | boolean | Iterable<import("react").ReactNode> | import("react/jsx-runtime").JSX.Element | null | undefined;

package/dist/provider/providers/ExternalWalletProvider.d.ts

@@ -0,0 +1,73 @@
+import { PropsWithChildren } from 'react';
+import { CommonChain, CommonWallet } from '@getpara/react-common';
+import { VerifyExternalWalletParams } from '@getpara/user-management-client';
+export declare const defaultExternalWallet: {
+    wallets: never[];
+    chains: never[];
+    chainId: undefined;
+    wallet: undefined;
+    qrUri: undefined;
+    chainIdSwitchingTo: undefined;
+    walletDisplayHelpers: {
+        showExtension: boolean;
+        showMobile: boolean;
+        isSolanaMobileIOS: boolean;
+        isCosmosMobileWallet: boolean;
+    };
+    username: undefined;
+    avatar: undefined;
+    connectExternalWallet: () => Promise<void>;
+    disconnectExternalWallet: () => Promise<void>;
+    switchChain: () => Promise<void>;
+    setChainIdSwitchingTo: () => void;
+    connectEmbeddedToExternalConnectors: () => Promise<void>;
+    verifyWalletSignature: () => Promise<any>;
+    isExternalWalletVerifying: boolean;
+};
+export declare const ExternalWalletContext: import("react").Context<{
+    wallets: CommonWallet[];
+    chains: CommonChain[];
+    chainId?: string;
+    wallet?: CommonWallet;
+    qrUri?: string;
+    chainIdSwitchingTo?: string;
+    walletDisplayHelpers: {
+        showExtension: boolean;
+        showMobile: boolean;
+        isSolanaMobileIOS: boolean;
+        isCosmosMobileWallet: boolean;
+    };
+    username?: string;
+    avatar?: string;
+    connectExternalWallet: (wallet: CommonWallet, isMobile?: boolean, isManualWalletConnect?: boolean) => Promise<void>;
+    disconnectExternalWallet: () => Promise<void>;
+    switchChain: (chainId: string) => Promise<void>;
+    setChainIdSwitchingTo: (chainId?: string) => void;
+    connectEmbeddedToExternalConnectors: () => Promise<void>;
+    verifyWalletSignature: () => Promise<VerifyExternalWalletParams | undefined>;
+    isExernalWalletVerifying?: boolean;
+}>;
+export declare function ExternalWalletProvider({ children }: PropsWithChildren): import("react/jsx-runtime").JSX.Element;
+export declare const useExternalWallets: () => {
+    wallets: CommonWallet[];
+    chains: CommonChain[];
+    chainId?: string;
+    wallet?: CommonWallet;
+    qrUri?: string;
+    chainIdSwitchingTo?: string;
+    walletDisplayHelpers: {
+        showExtension: boolean;
+        showMobile: boolean;
+        isSolanaMobileIOS: boolean;
+        isCosmosMobileWallet: boolean;
+    };
+    username?: string;
+    avatar?: string;
+    connectExternalWallet: (wallet: CommonWallet, isMobile?: boolean, isManualWalletConnect?: boolean) => Promise<void>;
+    disconnectExternalWallet: () => Promise<void>;
+    switchChain: (chainId: string) => Promise<void>;
+    setChainIdSwitchingTo: (chainId?: string) => void;
+    connectEmbeddedToExternalConnectors: () => Promise<void>;
+    verifyWalletSignature: () => Promise<VerifyExternalWalletParams | undefined>;
+    isExernalWalletVerifying?: boolean;
+};

package/dist/provider/providers/SolanaExternalWalletProvider.d.ts

@@ -0,0 +1,7 @@
+import { PropsWithChildren } from 'react';
+import { ParaSolanaProviderProps } from '@getpara/solana-wallet-connectors';
+import { ExternalWalletProviderCommon, ParaSolanaProviderConfigNoWallets } from '../types/externalWalletProviders.js';
+export declare function SolanaExternalWalletProvider({ children, isUsing, wallets: walletsFromProps, ...rest }: Omit<ParaSolanaProviderProps, 'config'> & {
+    config: ParaSolanaProviderConfigNoWallets;
+} & PropsWithChildren & ExternalWalletProviderCommon): string | number | boolean | Iterable<import("react").ReactNode> | import("react/jsx-runtime").JSX.Element | null | undefined;
+export declare const MemoizedSolanaExternalWalletProvider: import("react").MemoExoticComponent<typeof SolanaExternalWalletProvider>;

package/dist/provider/stores/getters.d.ts

@@ -1,4 +1,4 @@
-export declare const getClient: () => import("@getpara/web-sdk").ParaWeb;
+export declare const getClient: () => import("@getpara/web-sdk").ParaWeb | undefined;
 export declare const getIsOpen: () => boolean;
-export declare const getSelectedWalletId: () => string;
-export declare const getSelectedWalletType: () => import("@getpara/user-management-client").WalletType;
+export declare const getSelectedWalletId: () => string | undefined;
+export declare const getSelectedWalletType: () => import("@getpara/user-management-client").WalletType | undefined;

package/dist/provider/stores/setters.d.ts

@@ -0,0 +1 @@
+export declare const setIsOpen: (isOpen: boolean) => void;

package/dist/provider/stores/slices/config.d.ts

@@ -0,0 +1,3 @@
+import { StateCreator } from 'zustand';
+import { ConfigSlice, Store } from '../types.js';
+export declare const createConfigSlice: StateCreator<Store, [], [], ConfigSlice>;

package/dist/provider/stores/slices/externalWallets.d.ts

@@ -0,0 +1,3 @@
+import { StateCreator } from 'zustand';
+import { ExternalWalletsSlice, Store } from '../types.js';
+export declare const createExternalWalletsSlice: StateCreator<Store, [], [], ExternalWalletsSlice>;

package/dist/provider/stores/slices/index.d.ts

@@ -1,3 +1,4 @@
 export * from './client.js';
 export * from './modal.js';
 export * from './wallet.js';
+export * from './externalWallets.js';

package/dist/provider/stores/types.d.ts

@@ -1,18 +1,61 @@
+import { Context, MutableRefObject } from 'react';
 import ParaWeb, { WalletType } from '@getpara/web-sdk';
+import { EvmExternalWalletContextType, ParaEvmProvider, WalletList as EvmWalletList } from '@getpara/evm-wallet-connectors';
+import { CosmosExternalWalletContextType, ParaCosmosProvider, WalletList as CosmosWalletList } from '@getpara/cosmos-wallet-connectors';
+import { ParaSolanaProvider, SolanaExternalWalletContextType, WalletList as SolanaWalletList } from '@getpara/solana-wallet-connectors';
+import { ParaModalProps, TExternalWallet } from '../../modal/index.js';
+import { OAuthLogoVariantType } from '../../modal/types/modalProps.js';
 export interface ClientSlice {
     client?: ParaWeb;
     setClient: (_: ParaWeb) => void;
 }
+export interface ConfigSlice {
+    appName: string;
+    setAppName: (_: string) => void;
+}
 export interface ModalSlice {
+    modalConfig?: ParaModalProps;
+    setModalConfig: (_?: ParaModalProps) => void;
+    isDarkTheme: boolean;
+    oAuthLogoVariant: OAuthLogoVariantType;
     isOpen: boolean;
     setIsOpen: (_: boolean) => void;
 }
 export interface WalletSlice {
-    rpcUrl?: string;
-    setRpcUrl: (_?: string) => void;
     selectedWalletId?: string;
     selectedWalletType?: WalletType;
     setSelectedWallet: (_?: string, __?: WalletType) => void;
     clearSelectedWallet: () => void;
 }
-export type Store = ClientSlice & ModalSlice & WalletSlice;
+export interface ExternalWalletsSlice {
+    externalWallets: TExternalWallet[];
+    setExternalWallets: (_: TExternalWallet[]) => void;
+    externalWalletsWithFullAuth: TExternalWallet[];
+    setExternalWalletsWithFullAuth: (_: TExternalWallet[]) => void;
+    evmContext: Context<EvmExternalWalletContextType>;
+    setEvmContext: (_: Context<EvmExternalWalletContextType>) => void;
+    EvmProvider?: typeof ParaEvmProvider;
+    setEvmProvider: (_: typeof ParaEvmProvider) => void;
+    evmWallets: EvmWalletList;
+    setEvmWallets: (_: EvmWalletList) => void;
+    isLoadingEvmLib: boolean;
+    setIsLoadingEvmLib: (_: boolean) => void;
+    cosmosContext: Context<CosmosExternalWalletContextType>;
+    setCosmosContext: (_: Context<CosmosExternalWalletContextType>) => void;
+    CosmosProvider?: typeof ParaCosmosProvider;
+    setCosmosProvider: (_: typeof ParaCosmosProvider) => void;
+    cosmosWallets: CosmosWalletList;
+    setCosmosWallets: (_: CosmosWalletList) => void;
+    isLoadingCosmosLib: boolean;
+    setIsLoadingCosmosLib: (_: boolean) => void;
+    solanaContext: Context<SolanaExternalWalletContextType>;
+    setSolanaContext: (_: Context<SolanaExternalWalletContextType>) => void;
+    SolanaProvider?: typeof ParaSolanaProvider;
+    setSolanaProvider: (_: typeof ParaSolanaProvider) => void;
+    solanaWallets: SolanaWalletList;
+    setSolanaWallets: (_: SolanaWalletList) => void;
+    isLoadingSolanaLib: boolean;
+    setIsLoadingSolanaLib: (_: boolean) => void;
+    onLoginRef: MutableRefObject<(() => Promise<void>) | null>;
+}
+export type Store = ClientSlice & ModalSlice & WalletSlice & ExternalWalletsSlice & ConfigSlice;

package/dist/provider/types/externalWalletProviders.d.ts

@@ -0,0 +1,12 @@
+import { ParaCosmosProviderConfig } from '@getpara/cosmos-wallet-connectors';
+import { TExternalWallet } from '../../modal/index.js';
+import { ParaSolanaProviderConfig } from '@getpara/solana-wallet-connectors';
+import { Chain, Transport } from 'viem';
+import { ParaEvmProviderConfig } from '@getpara/evm-wallet-connectors';
+export type ExternalWalletProviderCommon = {
+    isUsing: boolean;
+    wallets: TExternalWallet[];
+};
+export type ParaEvmProviderConfigNoWallets<chains extends readonly [Chain, ...Chain[]], transports extends Record<chains[number]['id'], Transport>> = Omit<ParaEvmProviderConfig<chains, transports>, 'wallets'>;
+export type ParaCosmosProviderConfigNoWallets = Omit<ParaCosmosProviderConfig, 'wallets'>;
+export type ParaSolanaProviderConfigNoWallets = Omit<ParaSolanaProviderConfig, 'wallets'>;

package/dist/provider/types/provider.d.ts

@@ -1,5 +1,10 @@
+import { ParaWagmiProviderProps } from '@getpara/evm-wallet-connectors';
 import ParaWeb, { AccountCreationEvent, AccountSetupEvent, ConstructorOpts, Environment, ExternalWalletChangeEvent, LoginEvent, LogoutEvent, PregenWalletClaimedEvent, SignMessageEvent, SignTransactionEvent, WalletCreatedEvent, WalletsChangeEvent } from '@getpara/web-sdk';
 import { PropsWithChildren } from 'react';
+import { Chain, Transport } from 'viem';
+import { ParaModalProps, TExternalWallet } from '../../modal/index.js';
+import { ParaGrazProviderProps } from '@getpara/cosmos-wallet-connectors';
+import { ParaCosmosProviderConfigNoWallets, ParaEvmProviderConfigNoWallets, ParaSolanaProviderConfigNoWallets } from './externalWalletProviders.js';
 export type Callbacks = {
     onLogout?: (event: LogoutEvent) => void;
     onLogin?: (event: LoginEvent) => void;
@@ -13,26 +18,124 @@ export type Callbacks = {
     onPregenWalletClaimed?: (event: PregenWalletClaimedEvent) => void;
 };
 export type ParaProviderConfig = {
+    /**
+     * The name of your app, used throughout the modal and any configured external wallets.
+     */
+    appName: string;
+    /**
+     * Disables the automatic session keep alive that's provided by ParaProvider.
+     */
     disableAutoSessionKeepAlive?: boolean;
+    /**
+     * Disables the ParaModal that's provided by ParaProvider. Use this is you're providing a separate modal in another location in your app.
+     */
+    disableEmbeddedModal?: boolean;
 };
-interface ParaProviderPropsBase extends PropsWithChildren {
-    paraClientConfig?: {
+export type ExternalWalletConfig<chains extends readonly [Chain, ...Chain[]], transports extends Record<chains[number]['id'], Transport>> = {
+    /**
+     * A description of your app, displayed in some external wallets.
+     */
+    appDescription?: string;
+    /**
+     * A URL for your app, displayed in some external wallets.
+     */
+    appUrl?: string;
+    /**
+     * An icon for your app, displayed in some external wallets.
+     */
+    appIcon?: string;
+    /**
+     * Config for the EVM external wallets connector using Wagmi.
+     *
+     * NOTE: In addition to this config, you MUST also have the `@getpara/evm-wallet-connectors` package installed.
+     */
+    evmConnector?: {
+        /**
+         * Config for the Para EVM external wallets connector.
+         */
+        config: Omit<ParaEvmProviderConfigNoWallets<chains, transports>, 'appName' | 'appDescription' | 'appUrl' | 'appIcon' | 'projectId'>;
+        /**
+         * Config for the Wagmi provider.
+         */
+        wagmiProviderProps?: ParaWagmiProviderProps;
+    };
+    /**
+     * Config for the Cosmos external wallets connector using Graz.
+     *
+     * NOTE: In addition to this config, you MUST also have the `@getpara/cosmos-wallet-connectors` package installed.
+     */
+    cosmosConnector?: {
+        /**
+         * Config for the Para Cosmos external wallets connector.
+         */
+        config: ParaCosmosProviderConfigNoWallets;
+        /**
+         * Config for the Graz provider.
+         */
+        grazProviderProps?: ParaGrazProviderProps;
+    };
+    /**
+     * Config for the Solana external wallets connector using @solana/wallet-adapter-react.
+     *
+     * NOTE: In addition to this config, you MUST also have the `@getpara/solana-wallet-connectors` package installed.
+     */
+    solanaConnector?: {
+        /**
+         * Config for the Para Solana external wallets connector.
+         */
+        config: Omit<ParaSolanaProviderConfigNoWallets, 'appIdentity'> & Pick<Partial<ParaSolanaProviderConfigNoWallets>, 'appIdentity'>;
+    };
+    /**
+     * Config for any connectors that use Wallet Connect.
+     */
+    walletConnect?: {
+        /**
+         * Your Wallet Connect project ID.
+         */
+        projectId: string;
+    };
+    /**
+     * Which external wallets to show and in what order they should be displayed.
+     *
+     * NOTE: Any wallets that are detected as installed will be sorted first, followed by those that are not detected or not installed.
+     */
+    wallets: TExternalWallet[];
+    /**
+     * Which external wallets will include full verification and Para auth.
+     */
+    walletsWithParaAuth?: TExternalWallet[];
+};
+export interface ParaProviderProps<chains extends readonly [Chain, ...Chain[]], transports extends Record<chains[number]['id'], Transport>> extends PropsWithChildren {
+    /**
+     * Arguments to setup a new Para instance, or a Para instance you have already instantiated.
+     */
+    paraClientConfig: {
+        /**
+         * Environment for your Para instance.
+         */
         env: Environment;
+        /**
+         * API key for you Para instance.
+         *
+         * NOTE: Be sure this key matches the environment.
+         */
         apiKey: string;
         opts?: ConstructorOpts;
-    };
+    } | ParaWeb;
+    /**
+     * Configuration used for the Para modal.
+     */
+    paraModalConfig?: ParaModalProps;
+    /**
+     * Callbacks fired for events from the Para instance.
+     */
     callbacks?: Callbacks;
-    config?: ParaProviderConfig;
+    /**
+     * Config for the ParaProvider.
+     */
+    config: ParaProviderConfig;
+    /**
+     * Config for any external wallets.
+     */
+    externalWalletConfig?: ExternalWalletConfig<chains, transports>;
 }
-export type ParaProviderProps = ({
-    config: ParaProviderConfig & {
-        paraClientOverride: ParaWeb;
-    };
-    paraClientConfig?: never;
-} & ParaProviderPropsBase) | ({
-    config?: ParaProviderConfig & {
-        paraClientOverride?: never;
-    };
-    paraClientConfig: ParaProviderPropsBase['paraClientConfig'];
-} & ParaProviderPropsBase);
-export {};

package/dist/provider/types/utils.d.ts

@@ -1,6 +1,22 @@
+import { CoreMethodName, CoreMethodParams, CoreMethodResponse, CoreMethods } from '@getpara/web-sdk';
+import { UseMutationReturnType } from './query.js';
+import { UseMutateFunction, UseMutateAsyncFunction } from '@tanstack/react-query';
 export type Compute<type> = {
     [key in keyof type]: type[key];
 } & unknown;
 /** Strict version of built-in Omit type */
 export type StrictOmit<type, keys extends keyof type> = Pick<type, Exclude<keyof type, keys>>;
 export type UnionStrictOmit<type, keys extends keyof type> = type extends any ? StrictOmit<type, keys> : never;
+export type ChangeFields<T, R> = Omit<T, keyof R> & R;
+type SyncHook<method extends CoreMethodName & keyof CoreMethods> = {
+    mutate: UseMutateFunction<Awaited<CoreMethodResponse<method>>, Error, CoreMethodParams<method> | void, unknown>;
+} & {
+    [K in method]: UseMutateFunction<Awaited<CoreMethodResponse<method>>, Error, CoreMethodParams<method> | void, unknown>;
+};
+type AsyncHook<method extends CoreMethodName & keyof CoreMethods> = {
+    mutateAsync: UseMutateAsyncFunction<CoreMethodResponse<method>, Error, CoreMethodParams<method> | void, unknown>;
+} & {
+    [K in `${method}Async`]: UseMutateAsyncFunction<CoreMethodResponse<method>, Error, CoreMethodParams<method> | void, unknown>;
+};
+export type CoreMethodHook<method extends CoreMethodName & keyof CoreMethods> = Compute<UseMutationReturnType<CoreMethods[method]['response'], Error, CoreMethods[method]['params'] | void, unknown> & SyncHook<method> & AsyncHook<method>>;
+export {};

package/dist/provider/utils/paraConfigTypeGuards.d.ts

@@ -0,0 +1,7 @@
+import ParaWeb, { ConstructorOpts, Environment } from '@getpara/web-sdk';
+export declare function isConfigType(obj: any): obj is {
+    env: Environment;
+    apiKey: string;
+    opts?: ConstructorOpts;
+};
+export declare function isParaWeb(obj: any): obj is ParaWeb;

package/dist/provider/utils/renameMutations.d.ts

@@ -1,2 +1,5 @@
+import { CoreMethodName, CoreMethodParams, CoreMethodResponse, CoreMethods } from '@getpara/web-sdk';
 import { DefaultError, UseMutationResult } from '@tanstack/react-query';
+import { CoreMethodHook } from '../types/utils.js';
 export declare function renameMutations<TResp = unknown, TData = unknown, TError = DefaultError, TVariables = void, TContext = unknown>(mutationObj: UseMutationResult<TData, TError, TVariables, TContext>, name: string): TResp;
+export declare function renameCoreMutations<method extends CoreMethodName & keyof CoreMethods>(mutationObj: UseMutationResult<CoreMethodResponse<method>, Error, CoreMethodParams<method> | undefined, unknown>, name: method): CoreMethodHook<method>;

package/package.json

@@ -1,9 +1,12 @@
 {
   "name": "@getpara/react-sdk",
-  "version": "1.8.0",
+  "version": "2.0.0-alpha.3",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "bin": {
+    "setup-para": "dist/cli/cli.mjs"
+  },
   "exports": {
     ".": "./dist/index.js",
     "./styles.css": "./dist/css/modal.css"
@@ -12,9 +15,9 @@
     "*.css"
   ],
   "dependencies": {
-    "@getpara/react-common": "1.8.0",
-    "@getpara/react-components": "1.8.0",
-    "@getpara/web-sdk": "1.8.0",
+    "@getpara/react-common": "2.0.0-alpha.3",
+    "@getpara/react-components": "2.0.0-alpha.3",
+    "@getpara/web-sdk": "2.0.0-alpha.3",
     "@tanstack/react-query": "^5.0.0",
     "date-fns": "^3.6.0",
     "framer-motion": "11.3.28",
@@ -27,17 +30,26 @@
     "post-build": "./scripts/post-build.sh",
     "build": "rm -rf dist && yarn typegen && node ./scripts/build.mjs && yarn post-build",
     "typegen": "tsc --emitDeclarationOnly",
-    "test": "vitest run --coverage"
+    "test": "vitest run --coverage",
+    "cli": "node ./dist/cli/cli.mjs"
   },
   "devDependencies": {
+    "@getpara/cosmos-wallet-connectors": "2.0.0-alpha.3",
+    "@getpara/evm-wallet-connectors": "2.0.0-alpha.3",
+    "@getpara/solana-wallet-connectors": "2.0.0-alpha.3",
     "@testing-library/dom": "^10.1.0",
     "@testing-library/react": "^16.0.0",
     "@types/chrome": "^0.0.237",
     "@types/react": "^18.0.31",
     "@types/react-dom": "^18.2.7",
-    "typescript": "^5.4.3"
+    "typescript": "^5.4.3",
+    "viem": "2.x",
+    "wagmi": "2.x"
   },
   "peerDependencies": {
+    "@getpara/cosmos-wallet-connectors": "^2.0.0-alpha.0",
+    "@getpara/evm-wallet-connectors": "^2.0.0-alpha.0",
+    "@getpara/solana-wallet-connectors": "^2.0.0-alpha.0",
     "react": "*",
     "react-dom": "*"
   },
@@ -49,5 +61,5 @@
   "resolutions": {
     "styled-components": "^6"
   },
-  "gitHead": "ef96e79558695ccbe148d25a8e3611c4596d1954"
+  "gitHead": "77a1e04b06258842ca9c81e3db2a2b0092517659"
 }