@dynamic-labs-sdk/react-hooks 1.7.0 → 1.8.0

package/dist/index.cjs

@@ -7,7 +7,7 @@ let _dynamic_labs_sdk_client_core = require("@dynamic-labs-sdk/client/core");
 
 //#region package.json
 var name = "@dynamic-labs-sdk/react-hooks";
-var version = "1.7.0";
+var version = "1.8.0";
 
 //#endregion
 //#region src/modules/DynamicContext/DynamicContext.ts
@@ -385,6 +385,30 @@ const useBalanceForAddress = ({ queryParams, ...args }) => useBaseQuery({
 	queryParams
 });
 
+//#endregion
+//#region src/hooks/useCheckStepUpAuth/useCheckStepUpAuth.ts
+/**
+* Checks whether step-up authentication is required for a given scope and
+* returns the credentials available to satisfy it.
+*
+* Wraps `checkStepUpAuth` from `@dynamic-labs-sdk/client`. Use the returned
+* `isRequired` to decide whether to show a step-up UI before a sensitive
+* action (e.g. exporting a wallet).
+*
+* @example
+* ```tsx
+* const { data } = useCheckStepUpAuth({ scope: TokenScope.Walletexport });
+* if (data?.isRequired) {
+*   // render step-up UI using data.credentials
+* }
+* ```
+*/
+const useCheckStepUpAuth = ({ queryParams, ...args }) => useBaseQuery({
+	queryFn: (client) => (0, _dynamic_labs_sdk_client.checkStepUpAuth)(args, client),
+	queryKey: ["useCheckStepUpAuth", args],
+	queryParams
+});
+
 //#endregion
 //#region src/hooks/useCoinbaseBuyUrl/useCoinbaseBuyUrl.ts
 /**
@@ -401,6 +425,31 @@ const useCoinbaseBuyUrl = ({ queryParams, ...args }) => useBaseQuery({
 	queryParams
 });
 
+//#endregion
+//#region src/hooks/useCoinbaseOnrampOrderEventListener/useCoinbaseOnrampOrderEventListener.ts
+/**
+* Subscribes to Coinbase onramp order events for the duration of the component.
+*
+* Wraps `addCoinbaseOnrampOrderEventListener` from `@dynamic-labs-sdk/client`.
+* Uses a ref to always call the latest listener without re-subscribing, and
+* removes the listener on unmount.
+*
+* @example
+* ```tsx
+* useCoinbaseOnrampOrderEventListener({
+*   listener: ({ eventName, data }) => console.log(eventName, data),
+* });
+* ```
+*/
+const useCoinbaseOnrampOrderEventListener = ({ listener }) => {
+	const client = useDynamicClient();
+	const callbackRef = (0, react.useRef)(listener);
+	callbackRef.current = listener;
+	(0, react.useEffect)(() => (0, _dynamic_labs_sdk_client.addCoinbaseOnrampOrderEventListener)({ listener: (...args) => {
+		callbackRef.current(...args);
+	} }, client), [client]);
+};
+
 //#endregion
 //#region src/hooks/useCompleteDeviceRegistration/useCompleteDeviceRegistration.ts
 /**
@@ -451,6 +500,63 @@ const useConfirmTransaction = ({ mutateParams } = {}) => useBaseMutation({
 	mutationFn: ({ client, variables }) => (0, _dynamic_labs_sdk_client.confirmTransaction)(variables, client)
 });
 
+//#endregion
+//#region src/hooks/useConnectAndVerifyWithWalletProvider/useConnectAndVerifyWithWalletProvider.ts
+/**
+* Connects to a wallet provider and verifies ownership in a single step.
+*
+* Wraps `connectAndVerifyWithWalletProvider` from `@dynamic-labs-sdk/client`.
+* Call `mutate({ walletProviderKey })` to connect and prompt the user to sign
+* a verification message, adding the verified account to their profile.
+*
+* Throws `DeeplinkConnectAndVerifyUnsupportedError` on mobile with deeplink
+* wallet providers — there, use `useConnectWithWalletProvider` followed by
+* `useVerifyWalletAccount` from a fresh user gesture instead.
+*
+* @example
+* ```tsx
+* const { mutate: connectAndVerify, isPending } =
+*   useConnectAndVerifyWithWalletProvider();
+* <button
+*   onClick={() => connectAndVerify({ walletProviderKey: 'metamaskevm' })}
+*   disabled={isPending}
+* >
+*   Connect & verify
+* </button>
+* ```
+*/
+const useConnectAndVerifyWithWalletProvider = ({ mutateParams } = {}) => useBaseMutation({
+	mutateParams,
+	mutationFn: ({ client, variables }) => (0, _dynamic_labs_sdk_client.connectAndVerifyWithWalletProvider)(variables, client)
+});
+
+//#endregion
+//#region src/hooks/useConnectWithWalletProvider/useConnectWithWalletProvider.ts
+/**
+* Connects to a wallet provider and returns the connected wallet account.
+*
+* Wraps `connectWithWalletProvider` from `@dynamic-labs-sdk/client`. Call
+* `mutate({ walletProviderKey })` to trigger the connection — the wallet
+* provider will prompt the user via its native UI. The connected account is
+* not verified; pair with `useVerifyWalletAccount`, or use
+* `useConnectAndVerifyWithWalletProvider` to do both in one step.
+*
+* @example
+* ```tsx
+* const { mutate: connect, data, isPending } = useConnectWithWalletProvider();
+* <button
+*   onClick={() => connect({ walletProviderKey: 'metamaskevm' })}
+*   disabled={isPending}
+* >
+*   Connect
+* </button>
+* ```
+*/
+const useConnectWithWalletProvider = ({ mutateParams } = {}) => useBaseMutation({
+	mutateParams,
+	mutationFn: ({ client, variables }) => (0, _dynamic_labs_sdk_client.connectWithWalletProvider)(variables, client)
+});
+
 //#endregion
 //#region src/hooks/useConsumeMfaToken/useConsumeMfaToken.ts
 /**
@@ -816,6 +922,38 @@ const useMfaRecoveryCodes = ({ queryParams } = {}) => useBaseQuery({
 	queryParams
 });
 
+//#endregion
+//#region src/hooks/useMoonPayCurrencies/useMoonPayCurrencies.ts
+/**
+* Wraps `getMoonPayCurrencies` from `@dynamic-labs-sdk/client`. Returns the list of currencies MoonPay supports for the given parameters.
+*
+* @example
+* ```tsx
+* const { data: currencies, isLoading } = useMoonPayCurrencies(params);
+* ```
+*/
+const useMoonPayCurrencies = ({ queryParams, ...args }) => useBaseQuery({
+	queryFn: (client) => (0, _dynamic_labs_sdk_client.getMoonPayCurrencies)(args, client),
+	queryKey: ["useMoonPayCurrencies", args],
+	queryParams
+});
+
+//#endregion
+//#region src/hooks/useMoonPayUrl/useMoonPayUrl.ts
+/**
+* Wraps `getMoonPayUrl` from `@dynamic-labs-sdk/client`. Returns a MoonPay widget URL for the given parameters.
+*
+* @example
+* ```tsx
+* const { data: moonPayUrl, isLoading } = useMoonPayUrl(params);
+* ```
+*/
+const useMoonPayUrl = ({ queryParams, ...args }) => useBaseQuery({
+	queryFn: (client) => (0, _dynamic_labs_sdk_client.getMoonPayUrl)(args, client),
+	queryKey: ["useMoonPayUrl", args],
+	queryParams
+});
+
 //#endregion
 //#region src/hooks/useMultichainTokenBalances/useMultichainTokenBalances.ts
 /**
@@ -875,6 +1013,35 @@ const useNetworksData = () => useBaseState({
 	selector: (client) => (0, _dynamic_labs_sdk_client.getNetworksData)(client)
 });
 
+//#endregion
+//#region src/hooks/useOnceEvent/useOnceEvent.ts
+/**
+* Subscribes to a Dynamic client event for a single occurrence.
+*
+* Wraps `onceEvent` from `@dynamic-labs-sdk/client` — the one-shot sibling of
+* `useEvent`. The listener fires at most once. Uses a ref to always call the
+* latest listener, and cleans up the subscription on unmount or event change.
+*
+* @example
+* ```tsx
+* useOnceEvent({
+*   event: 'authFlowCancelled',
+*   listener: () => console.log('auth flow cancelled'),
+* });
+* ```
+*/
+const useOnceEvent = ({ event, listener }) => {
+	const client = useDynamicClient();
+	const callbackRef = (0, react.useRef)(listener);
+	callbackRef.current = listener;
+	(0, react.useEffect)(() => (0, _dynamic_labs_sdk_client.onceEvent)({
+		event,
+		listener: (...args) => {
+			callbackRef.current(...args);
+		}
+	}, client), [event, client]);
+};
+
 //#endregion
 //#region src/hooks/usePasskeys/usePasskeys.ts
 /**
@@ -1266,6 +1433,38 @@ const useSignMessage = ({ mutateParams } = {}) => useBaseMutation({
 	mutationFn: ({ client, variables }) => (0, _dynamic_labs_sdk_client.signMessage)(variables, client)
 });
 
+//#endregion
+//#region src/hooks/useSwapQuote/useSwapQuote.ts
+/**
+* Wraps `getSwapQuote` from `@dynamic-labs-sdk/client`. Returns a swap quote (including the signing payload consumed by {@link useExecuteSwapTransaction}).
+*
+* @example
+* ```tsx
+* const { data: quote, isLoading } = useSwapQuote(params);
+* ```
+*/
+const useSwapQuote = ({ queryParams, ...args }) => useBaseQuery({
+	queryFn: (client) => (0, _dynamic_labs_sdk_client.getSwapQuote)(args, client),
+	queryKey: ["useSwapQuote", args],
+	queryParams
+});
+
+//#endregion
+//#region src/hooks/useSwapStatus/useSwapStatus.ts
+/**
+* Wraps `getSwapStatus` from `@dynamic-labs-sdk/client`. Returns the current status of a previously submitted swap.
+*
+* @example
+* ```tsx
+* const { data: status, isLoading } = useSwapStatus(params);
+* ```
+*/
+const useSwapStatus = ({ queryParams, ...args }) => useBaseQuery({
+	queryFn: (client) => (0, _dynamic_labs_sdk_client.getSwapStatus)(args, client),
+	queryKey: ["useSwapStatus", args],
+	queryParams
+});
+
 //#endregion
 //#region src/hooks/useSwitchActiveNetwork/useSwitchActiveNetwork.ts
 /**
@@ -1552,6 +1751,76 @@ const useWalletAccounts = () => useBaseState({
 	selector: (client) => (0, _dynamic_labs_sdk_client.getWalletAccounts)(client)
 });
 
+//#endregion
+//#region src/hooks/useWalletConnectCatalog/useWalletConnectCatalog.ts
+/**
+* Returns the WalletConnect catalog (groups and wallets) used for displaying
+* wallet information and building mobile wallet deeplinks.
+*
+* Wraps `getWalletConnectCatalog` from `@dynamic-labs-sdk/client`.
+*
+* @example
+* ```tsx
+* const { data: catalog, isLoading } = useWalletConnectCatalog();
+* ```
+*/
+const useWalletConnectCatalog = ({ queryParams } = {}) => useBaseQuery({
+	queryFn: (client) => (0, _dynamic_labs_sdk_client.getWalletConnectCatalog)(client),
+	queryKey: ["useWalletConnectCatalog"],
+	queryParams
+});
+
+//#endregion
+//#region src/hooks/useWalletOptionsCatalogue/useWalletOptionsCatalogue.ts
+/**
+* Wraps `getWalletOptionsCatalogue` from `@dynamic-labs-sdk/client`. Returns the catalogue of wallet options the project supports.
+*
+* @example
+* ```tsx
+* const { data: catalogue, isLoading } = useWalletOptionsCatalogue();
+* ```
+*/
+const useWalletOptionsCatalogue = ({ queryParams, ...args } = {}) => useBaseQuery({
+	queryFn: (client) => (0, _dynamic_labs_sdk_client.getWalletOptionsCatalogue)(args, client),
+	queryKey: ["useWalletOptionsCatalogue", args],
+	queryParams
+});
+
+//#endregion
+//#region src/hooks/useWalletProviderEvent/useWalletProviderEvent.ts
+/**
+* Subscribes to an event emitted by a specific wallet provider.
+*
+* Wraps `onWalletProviderEvent` from `@dynamic-labs-sdk/client`. Uses a ref to
+* always call the latest callback without re-subscribing, and cleans up the
+* subscription on unmount or when `event` / `walletProviderKey` change.
+*
+* @example
+* ```tsx
+* useWalletProviderEvent({
+*   walletProviderKey: 'metamaskevm',
+*   event: 'accountsChanged',
+*   callback: ({ addresses }) => console.log(addresses),
+* });
+* ```
+*/
+const useWalletProviderEvent = ({ callback, event, walletProviderKey }) => {
+	const client = useDynamicClient();
+	const callbackRef = (0, react.useRef)(callback);
+	callbackRef.current = callback;
+	(0, react.useEffect)(() => (0, _dynamic_labs_sdk_client.onWalletProviderEvent)({
+		callback: ((...args) => {
+			callbackRef.current(...args);
+		}),
+		event,
+		walletProviderKey
+	}, client), [
+		event,
+		walletProviderKey,
+		client
+	]);
+};
+
 //#endregion
 //#region src/exports/index.ts
 (0, _dynamic_labs_sdk_assert_package_version.assertPackageVersion)(name, version);
@@ -1566,10 +1835,14 @@ exports.useAuthenticatePasskeyMfa = useAuthenticatePasskeyMfa;
 exports.useAuthenticateTotpMfaDevice = useAuthenticateTotpMfaDevice;
 exports.useAvailableWalletProvidersData = useAvailableWalletProvidersData;
 exports.useBalanceForAddress = useBalanceForAddress;
+exports.useCheckStepUpAuth = useCheckStepUpAuth;
 exports.useCoinbaseBuyUrl = useCoinbaseBuyUrl;
+exports.useCoinbaseOnrampOrderEventListener = useCoinbaseOnrampOrderEventListener;
 exports.useCompleteDeviceRegistration = useCompleteDeviceRegistration;
 exports.useCompleteSocialRedirect = useCompleteSocialRedirect;
 exports.useConfirmTransaction = useConfirmTransaction;
+exports.useConnectAndVerifyWithWalletProvider = useConnectAndVerifyWithWalletProvider;
+exports.useConnectWithWalletProvider = useConnectWithWalletProvider;
 exports.useConsumeMfaToken = useConsumeMfaToken;
 exports.useCreateCoinbaseOnrampOrder = useCreateCoinbaseOnrampOrder;
 exports.useCreateCryptoDotComPayment = useCreateCryptoDotComPayment;
@@ -1590,9 +1863,12 @@ exports.useLogout = useLogout;
 exports.useMfaDevices = useMfaDevices;
 exports.useMfaMethods = useMfaMethods;
 exports.useMfaRecoveryCodes = useMfaRecoveryCodes;
+exports.useMoonPayCurrencies = useMoonPayCurrencies;
+exports.useMoonPayUrl = useMoonPayUrl;
 exports.useMultichainTokenBalances = useMultichainTokenBalances;
 exports.useNativeBalance = useNativeBalance;
 exports.useNetworksData = useNetworksData;
+exports.useOnceEvent = useOnceEvent;
 exports.usePasskeys = usePasskeys;
 exports.useProveWalletAccountOwnership = useProveWalletAccountOwnership;
 exports.useRefreshAuth = useRefreshAuth;
@@ -1612,6 +1888,8 @@ exports.useSignInWithPasskey = useSignInWithPasskey;
 exports.useSignInWithSocialPopUp = useSignInWithSocialPopUp;
 exports.useSignInWithSocialRedirect = useSignInWithSocialRedirect;
 exports.useSignMessage = useSignMessage;
+exports.useSwapQuote = useSwapQuote;
+exports.useSwapStatus = useSwapStatus;
 exports.useSwitchActiveNetwork = useSwitchActiveNetwork;
 exports.useTokenBalances = useTokenBalances;
 exports.useTransactionHistory = useTransactionHistory;
@@ -1624,4 +1902,7 @@ exports.useUserSocialAccounts = useUserSocialAccounts;
 exports.useVerifyOtp = useVerifyOtp;
 exports.useVerifyWalletAccount = useVerifyWalletAccount;
 exports.useWalletAccounts = useWalletAccounts;
+exports.useWalletConnectCatalog = useWalletConnectCatalog;
+exports.useWalletOptionsCatalogue = useWalletOptionsCatalogue;
+exports.useWalletProviderEvent = useWalletProviderEvent;
 //# sourceMappingURL=index.cjs.map