thirdweb 5.78.0 → 5.79.0-nightly-f91f6310e9396918d0ffc5217eeb4a44cef0b8c8-20241215000412

package/dist/types/react/web/ui/prebuilt/Wallet/icon.d.ts

@@ -0,0 +1,81 @@
+import { type UseQueryOptions } from "@tanstack/react-query";
+import type { JSX } from "react";
+import type { WalletId } from "../../../../../wallets/wallet-types.js";
+export interface WalletIconProps extends Omit<React.ImgHTMLAttributes<HTMLImageElement>, "src"> {
+    /**
+     * This component will be shown while the icon of the wallet is being fetched
+     * If not passed, the component will return `null`.
+     *
+     * You can/should pass a loading sign or spinner to this prop.
+     * @example
+     * ```tsx
+     * <WalletIcon loadingComponent={<Spinner />} />
+     * ```
+     */
+    loadingComponent?: JSX.Element;
+    /**
+     * This component will be shown if the icon fails to be retreived
+     * If not passed, the component will return `null`.
+     *
+     * You can/should pass a descriptive text/component to this prop, indicating that the
+     * icon was not fetched succesfully
+     * @example
+     * ```tsx
+     * <WalletIcon fallbackComponent={<span>Failed to load</span>}
+     * />
+     * ```
+     */
+    fallbackComponent?: JSX.Element;
+    /**
+     * Optional `useQuery` params
+     */
+    queryOptions?: Omit<UseQueryOptions<string>, "queryFn" | "queryKey">;
+}
+/**
+ * This component tries to resolve the icon of a given wallet, then return an image.
+ * @returns an <img /> with the src of the wallet icon
+ *
+ * @example
+ * ### Basic usage
+ * ```tsx
+ * import { WalletProvider, WalletIcon } from "thirdweb/react";
+ *
+ * <WalletProvider id="io.metamask">
+ *   <WalletIcon />
+ * </WalletProvider>
+ * ```
+ *
+ * Result: An <img /> component with the src of the icon
+ * ```html
+ * <img src="metamask-icon.png" />
+ * ```
+ *
+ * ### Show a loading sign while the icon is being loaded
+ * ```tsx
+ * <WalletIcon loadingComponent={<Spinner />} />
+ * ```
+ *
+ * ### Fallback to a dummy image if the wallet icon fails to resolve
+ * ```tsx
+ * <WalletIcon fallbackComponent={<img src="blank-image.png" />} />
+ * ```
+ *
+ * ### Usage with queryOptions
+ * WalletIcon uses useQuery() from tanstack query internally.
+ * It allows you to pass a custom queryOptions of your choice for more control of the internal fetching logic
+ * ```tsx
+ * <WalletIcon queryOptions={{ enabled: someLogic, retry: 3, }} />
+ * ```
+ *
+ * @component
+ * @wallet
+ * @beta
+ */
+export declare function WalletIcon({ loadingComponent, fallbackComponent, queryOptions, ...restProps }: WalletIconProps): import("react/jsx-runtime.js").JSX.Element | null;
+/**
+ * @internal Exported for tests only
+ */
+export declare function fetchWalletImage(props: {
+    id: WalletId;
+}): Promise<string>;
+//# sourceMappingURL=icon.d.ts.map

package/dist/types/react/web/ui/prebuilt/Wallet/icon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon.d.ts","sourceRoot":"","sources":["../../../../../../../src/react/web/ui/prebuilt/Wallet/icon.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,eAAe,EAAY,MAAM,uBAAuB,CAAC;AACvE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAEjC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wCAAwC,CAAC;AAGvE,MAAM,WAAW,eACf,SAAQ,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,EAAE,KAAK,CAAC;IAC9D;;;;;;;;;OASG;IACH,gBAAgB,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC;IAC/B;;;;;;;;;;;OAWG;IACH,iBAAiB,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC;IAChC;;OAEG;IACH,YAAY,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,UAAU,CAAC,CAAC;CACtE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,UAAU,CAAC,EACzB,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,GAAG,SAAS,EACb,EAAE,eAAe,qDASjB;AAiBD;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE;IAC5C,EAAE,EAAE,QAAQ,CAAC;CACd,mBAGA"}

package/dist/types/react/web/ui/prebuilt/Wallet/name.d.ts

@@ -0,0 +1,111 @@
+import { type UseQueryOptions } from "@tanstack/react-query";
+import type { JSX } from "react";
+import type { WalletId } from "../../../../../wallets/wallet-types.js";
+/**
+ * Props for the WalletName component
+ * @component
+ * @wallet
+ */
+export interface WalletNameProps extends Omit<React.HTMLAttributes<HTMLSpanElement>, "children"> {
+    /**
+     * This component will be shown while the name of the wallet name is being fetched
+     * If not passed, the component will return `null`.
+     *
+     * You can/should pass a loading sign or spinner to this prop.
+     * @example
+     * ```tsx
+     * <WalletName loadingComponent={<Spinner />} />
+     * ```
+     */
+    loadingComponent?: JSX.Element;
+    /**
+     * This component will be shown if the name fails to be retreived
+     * If not passed, the component will return `null`.
+     *
+     * You can/should pass a descriptive text/component to this prop, indicating that the
+     * name was not fetched succesfully
+     * @example
+     * ```tsx
+     * <WalletName fallbackComponent={<span>Failed to load</span>}
+     * />
+     * ```
+     */
+    fallbackComponent?: JSX.Element;
+    /**
+     * Optional `useQuery` params
+     */
+    queryOptions?: Omit<UseQueryOptions<string>, "queryFn" | "queryKey">;
+    /**
+     * A function to format the name's display value
+     * ```tsx
+     * <WalletName formatFn={(str: string) => doSomething()} />
+     * ```
+     */
+    formatFn?: (str: string) => string;
+}
+/**
+ * This component fetches then shows the name of a wallet.
+ * It inherits all the attributes of a HTML <span> component, hence you can style it just like how you would style a normal <span>
+ *
+ * @example
+ * ### Basic usage
+ * ```tsx
+ * import { WalletProvider, WalletName } from "thirdweb/react";
+ *
+ * <WalletProvider id="io.metamask">
+ *   <WalletName  />
+ * </WalletProvider>
+ * ```
+ * Result:
+ * ```html
+ * <span>MetaMask</span>
+ * ```
+ *
+ * ### Show a loading sign when the name is being fetched
+ * ```tsx
+ * import { WalletProvider, WalletName } from "thirdweb/react";
+ *
+ * <WalletProvider {...props}>
+ *   <WalletName loadingComponent={<Spinner />} />
+ * </WalletProvider>
+ * ```
+ *
+ * ### Fallback to something when the name fails to resolve
+ * ```tsx
+ * <WalletProvider {...props}>
+ *   <WalletName fallbackComponent={<span>Failed to load</span>} />
+ * </WalletProvider>
+ * ```
+ *
+ * ### Custom query options for useQuery
+ * This component uses `@tanstack-query`'s useQuery internally.
+ * You can use the `queryOptions` prop for more fine-grained control
+ * ```tsx
+ * <WalletName
+ *   queryOptions={{
+ *     enabled: isEnabled,
+ *     retry: 4,
+ *   }}
+ * />
+ * @component
+ * @beta
+ * @wallet
+ */
+export declare function WalletName({ loadingComponent, fallbackComponent, queryOptions, formatFn, ...restProps }: WalletNameProps): import("react/jsx-runtime.js").JSX.Element | null;
+/**
+ * @internal Exported for tests only
+ */
+export declare function getQueryKeys(props: {
+    id: WalletId;
+    formatFn?: (str: string) => string;
+}): readonly ["walletName", WalletId] | readonly ["walletName", WalletId, {
+    readonly resolver: string;
+}];
+/**
+ * @internal Exported for tests only
+ */
+export declare function fetchWalletName(props: {
+    id: WalletId;
+    formatFn?: (str: string) => string;
+}): Promise<string>;
+//# sourceMappingURL=name.d.ts.map

package/dist/types/react/web/ui/prebuilt/Wallet/name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"name.d.ts","sourceRoot":"","sources":["../../../../../../../src/react/web/ui/prebuilt/Wallet/name.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,eAAe,EAAY,MAAM,uBAAuB,CAAC;AACvE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAGjC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wCAAwC,CAAC;AAGvE;;;;GAIG;AACH,MAAM,WAAW,eACf,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,eAAe,CAAC,EAAE,UAAU,CAAC;IAC/D;;;;;;;;;OASG;IACH,gBAAgB,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC;IAC/B;;;;;;;;;;;OAWG;IACH,iBAAiB,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC;IAChC;;OAEG;IACH,YAAY,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,UAAU,CAAC,CAAC;IACrE;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,wBAAgB,UAAU,CAAC,EACzB,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,QAAQ,EACR,GAAG,SAAS,EACb,EAAE,eAAe,qDASjB;AAkBD;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE;IAClC,EAAE,EAAE,QAAQ,CAAC;IACb,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;CACpC;;GASA;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE;IAC3C,EAAE,EAAE,QAAQ,CAAC;IACb,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;CACpC,mBAMA"}

package/dist/types/react/web/ui/prebuilt/Wallet/provider.d.ts

@@ -0,0 +1,41 @@
+import type React from "react";
+import type { WalletId } from "../../../../../wallets/wallet-types.js";
+/**
+ * Props for the WalletProvider component
+ * @component
+ * @wallet
+ */
+export type WalletProviderProps = {
+    id: WalletId;
+};
+/**
+ * @internal Exported for tests only
+ */
+export declare const WalletProviderContext: React.Context<WalletProviderProps | undefined>;
+/**
+/**
+ * A React context provider component that supplies Wallet-related data to its child components.
+ *
+ * This component serves as a wrapper around the `WalletProviderContext.Provider` and passes
+ * the provided wallet data down to all of its child components through the context API.
+ *
+ * @example
+ * ### Basic usage
+ * ```tsx
+ * import { WalletProvider, WalletIcon, WalletName } from "thirdweb/react";
+ *
+ * <WalletProvider id="io.metamask">
+ *   <WalletIcon />
+ *   <WalletName />
+ * </WalletProvider>
+ * ```
+ * @beta
+ * @component
+ * @wallet
+ */
+export declare function WalletProvider(props: React.PropsWithChildren<WalletProviderProps>): import("react/jsx-runtime.js").JSX.Element;
+/**
+ * @internal
+ */
+export declare function useWalletContext(): WalletProviderProps;
+//# sourceMappingURL=provider.d.ts.map

package/dist/types/react/web/ui/prebuilt/Wallet/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../../../../../src/react/web/ui/prebuilt/Wallet/provider.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wCAAwC,CAAC;AAEvE;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,QAAQ,CAAC;CACd,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,gDAEtB,CAAC;AAEb;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,KAAK,CAAC,iBAAiB,CAAC,mBAAmB,CAAC,8CAOpD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,wBAQ/B"}

package/dist/types/version.d.ts

@@ -1,2 +1,2 @@
-export declare const version = "5.78.0";
+export declare const version = "5.79.0-nightly-f91f6310e9396918d0ffc5217eeb4a44cef0b8c8-20241215000412";
 //# sourceMappingURL=version.d.ts.map

package/dist/types/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,WAAW,CAAC"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,2EAA2E,CAAC"}

package/dist/types/wallets/in-app/core/wallet/types.d.ts

@@ -1,6 +1,7 @@
 import type { Chain } from "../../../../chains/types.js";
 import type { ThirdwebClient } from "../../../../client/client.js";
 import type { SupportedSmsCountry } from "../../../../react/web/wallets/in-app/supported-sms-countries.js";
+import type { Prettify } from "../../../../utils/type-utils.js";
 import type { SmartWalletOptions } from "../../../smart/types.js";
 import type { AuthOption, OAuthOption, SocialAuthOption } from "../../../types.js";
 import type { EcosystemWalletId } from "../../../wallet-types.js";
@@ -10,11 +11,10 @@ export type Ecosystem = {
     id: EcosystemWalletId;
     partnerId?: string;
 };
-export type InAppWalletConnectionOptions = (MultiStepAuthArgsType | SingleStepAuthArgsType) & {
+export type InAppWalletConnectionOptions = Prettify<(MultiStepAuthArgsType | SingleStepAuthArgsType) & {
     client: ThirdwebClient;
     chain?: Chain;
-    redirect?: boolean;
-};
+}>;
 export type InAppWalletAutoConnectOptions = {
     client: ThirdwebClient;
     authResult?: AuthStoredTokenWithCookieReturnType;

package/dist/types/wallets/in-app/core/wallet/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/wallets/in-app/core/wallet/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iEAAiE,CAAC;AAC3G,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EACX,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EACV,mCAAmC,EACnC,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,MAAM,MAAM,SAAS,GAAG;IACtB,EAAE,EAAE,iBAAiB,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG,CACvC,qBAAqB,GACrB,sBAAsB,CACzB,GAAG;IACF,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,MAAM,EAAE,cAAc,CAAC;IACvB,UAAU,CAAC,EAAE,mCAAmC,CAAC;IACjD,KAAK,CAAC,EAAE,KAAK,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC;AAEpC,MAAM,MAAM,qBAAqB,GAAG,gBAAgB,CAAC;AACrD,MAAM,MAAM,gBAAgB,GAAG,WAAW,CAAC;AAC3C,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC;AAEzC,MAAM,MAAM,0BAA0B,GAClC;IACE,IAAI,CAAC,EAAE;QACL;;WAEG;QACH,OAAO,EAAE,eAAe,EAAE,CAAC;QAC3B;;WAEG;QACH,IAAI,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAC;QACvC;;WAEG;QACH,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB;;WAEG;QACH,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB;;WAEG;QACH,qBAAqB,CAAC,EAAE,mBAAmB,CAAC;KAC7C,CAAC;IACF;;OAEG;IACH,QAAQ,CAAC,EAAE;QACT,KAAK,CAAC,EAAE;YACN,GAAG,EAAE,MAAM,CAAC;YACZ,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,GAAG,CAAC,EAAE,MAAM,CAAC;SACd,CAAC;KACH,CAAC;IACF;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;QAEI;IACJ,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC;;OAEG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC,GACD,SAAS,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/wallets/in-app/core/wallet/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iEAAiE,CAAC;AAC3G,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EACX,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EACV,mCAAmC,EACnC,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,MAAM,MAAM,SAAS,GAAG;IACtB,EAAE,EAAE,iBAAiB,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG,QAAQ,CACjD,CAAC,qBAAqB,GAAG,sBAAsB,CAAC,GAAG;IACjD,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf,CACF,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,MAAM,EAAE,cAAc,CAAC;IACvB,UAAU,CAAC,EAAE,mCAAmC,CAAC;IACjD,KAAK,CAAC,EAAE,KAAK,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC;AAEpC,MAAM,MAAM,qBAAqB,GAAG,gBAAgB,CAAC;AACrD,MAAM,MAAM,gBAAgB,GAAG,WAAW,CAAC;AAC3C,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC;AAEzC,MAAM,MAAM,0BAA0B,GAClC;IACE,IAAI,CAAC,EAAE;QACL;;WAEG;QACH,OAAO,EAAE,eAAe,EAAE,CAAC;QAC3B;;WAEG;QACH,IAAI,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAC;QACvC;;WAEG;QACH,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB;;WAEG;QACH,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB;;WAEG;QACH,qBAAqB,CAAC,EAAE,mBAAmB,CAAC;KAC7C,CAAC;IACF;;OAEG;IACH,QAAQ,CAAC,EAAE;QACT,KAAK,CAAC,EAAE;YACN,GAAG,EAAE,MAAM,CAAC;YACZ,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,GAAG,CAAC,EAAE,MAAM,CAAC;SACd,CAAC;KACH,CAAC;IACF;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;QAEI;IACJ,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC;;OAEG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC,GACD,SAAS,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "thirdweb",
-  "version": "5.78.0",
+  "version": "5.79.0-nightly-f91f6310e9396918d0ffc5217eeb4a44cef0b8c8-20241215000412",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/thirdweb-dev/js.git#main"
@@ -340,6 +340,7 @@
     "size-limit": "11.1.6",
     "storybook": "8.4.7",
     "typedoc": "0.27.4",
+    "typedoc-better-json": "0.9.4",
     "typescript": "5.7.2",
     "vite": "6.0.3",
     "vitest": "2.1.8"
@@ -368,7 +369,7 @@
     "test:ui": "vitest dev -c ./test/vitest.config.ts --coverage --ui",
     "test:dev": "vitest run -c ./test/vitest.config.ts",
     "test:react": "vitest run -c ./test/vitest.config.ts dev --ui src/react",
-    "typedoc": "bun run scripts/typedoc.mjs",
+    "typedoc": "node scripts/typedoc.mjs && node scripts/parse.mjs",
     "update-version": "node scripts/version.mjs",
     "storybook": "storybook dev -p 6006",
     "build-storybook": "storybook build"

package/src/exports/react.ts

@@ -273,3 +273,17 @@ export {
 
 // Utils
 export { getLastAuthProvider } from "../react/web/utils/storage.js";
+
+// Wallet
+export {
+  WalletProvider,
+  type WalletProviderProps,
+} from "../react/web/ui/prebuilt/Wallet/provider.js";
+export {
+  WalletIcon,
+  type WalletIconProps,
+} from "../react/web/ui/prebuilt/Wallet/icon.js";
+export {
+  WalletName,
+  type WalletNameProps,
+} from "../react/web/ui/prebuilt/Wallet/name.js";

package/src/exports/wallets/in-app.native.ts

@@ -18,6 +18,12 @@ export type {
   InAppWalletAuth,
   InAppWalletSocialAuth,
   InAppWalletConnectionOptions,
+  InAppWalletAutoConnectOptions,
 } from "../../wallets/in-app/core/wallet/types.js";
 
+export type {
+  MultiStepAuthArgsType,
+  SingleStepAuthArgsType,
+} from "../../wallets/in-app/core/authentication/types.js";
+
 export { hasStoredPasskey } from "../../wallets/in-app/native/auth/passkeys.js";

package/src/exports/wallets/in-app.ts

@@ -18,8 +18,14 @@ export type {
   InAppWalletAuth,
   InAppWalletSocialAuth,
   InAppWalletConnectionOptions,
+  InAppWalletAutoConnectOptions,
 } from "../../wallets/in-app/core/wallet/types.js";
 
+export type {
+  MultiStepAuthArgsType,
+  SingleStepAuthArgsType,
+} from "../../wallets/in-app/core/authentication/types.js";
+
 export { hasStoredPasskey } from "../../wallets/in-app/web/lib/auth/passkeys.js";
 
 export {

package/src/exports/wallets.native.ts

@@ -89,8 +89,14 @@ export type {
    * @deprecated use InAppWalletSocialAuth instead
    */
   InAppWalletSocialAuth as EmbeddedWalletSocialAuth,
+  InAppWalletCreationOptions,
 } from "../wallets/in-app/core/wallet/types.js";
 
+export type {
+  MultiStepAuthArgsType,
+  SingleStepAuthArgsType,
+} from "../wallets/in-app/core/authentication/types.js";
+
 export {
   preAuthenticate,
   authenticate,

package/src/exports/wallets.ts

@@ -96,8 +96,14 @@ export type {
    * @deprecated use InAppWalletSocialAuth instead
    */
   InAppWalletSocialAuth as EmbeddedWalletSocialAuth,
+  InAppWalletCreationOptions,
 } from "../wallets/in-app/core/wallet/types.js";
 
+export type {
+  MultiStepAuthArgsType,
+  SingleStepAuthArgsType,
+} from "../wallets/in-app/core/authentication/types.js";
+
 export {
   preAuthenticate,
   authenticate,

package/src/extensions/prebuilts/deploy-published.ts

@@ -150,28 +150,35 @@ export async function deployContractfromDeployMetadata(
     salt,
   } = options;
 
-  const processedImplParams: Record<string, string | string[]> = {};
-  for (const key in implementationConstructorParams) {
-    processedImplParams[key] = await processRefDeployments({
-      client,
-      account,
-      chain,
-      paramValue: implementationConstructorParams[key] as
-        | string
-        | ImplementationConstructorParam,
-    });
+  let processedImplParams: Record<string, string | string[]> | undefined;
+  let processedInitializeParams: Record<string, string | string[]> | undefined;
+
+  if (implementationConstructorParams) {
+    processedImplParams = {};
+    for (const key in implementationConstructorParams) {
+      processedImplParams[key] = await processRefDeployments({
+        client,
+        account,
+        chain,
+        paramValue: implementationConstructorParams[key] as
+          | string
+          | ImplementationConstructorParam,
+      });
+    }
   }
 
-  const processedInitializeParams: Record<string, string | string[]> = {};
-  for (const key in initializeParams) {
-    processedInitializeParams[key] = await processRefDeployments({
-      client,
-      account,
-      chain,
-      paramValue: initializeParams[key] as
-        | string
-        | ImplementationConstructorParam,
-    });
+  if (initializeParams) {
+    processedInitializeParams = {};
+    for (const key in initializeParams) {
+      processedInitializeParams[key] = await processRefDeployments({
+        client,
+        account,
+        chain,
+        paramValue: initializeParams[key] as
+          | string
+          | ImplementationConstructorParam,
+      });
+    }
   }
 
   switch (deployMetadata?.deployType) {

package/src/react/core/hooks/wallets/useAddConnectedWallet.test.tsx

@@ -0,0 +1,52 @@
+import { renderHook } from "@testing-library/react";
+import type { ReactNode } from "react";
+import { describe, expect, it } from "vitest";
+import { MockStorage } from "../../../../../test/src/mocks/storage.js";
+import { TEST_CLIENT } from "../../../../../test/src/test-clients.js";
+import { TEST_ACCOUNT_A } from "../../../../../test/src/test-wallets.js";
+import { createWalletAdapter } from "../../../../adapters/wallet-adapter.js";
+import { ethereum } from "../../../../chains/chain-definitions/ethereum.js";
+import { createConnectionManager } from "../../../../wallets/manager/index.js";
+import { ConnectionManagerCtx } from "../../providers/connection-manager.js";
+import { useAddConnectedWallet } from "./useAddConnectedWallet.js";
+
+describe("useAddConnectedWallet", () => {
+  // Mock the connection manager
+  const mockStorage = new MockStorage();
+  const manager = createConnectionManager(mockStorage);
+
+  // Create a wrapper component with the mocked context
+  const wrapper = ({ children }: { children: ReactNode }) => {
+    return (
+      <ConnectionManagerCtx.Provider value={manager}>
+        {children}
+      </ConnectionManagerCtx.Provider>
+    );
+  };
+
+  const wallet = createWalletAdapter({
+    adaptedAccount: TEST_ACCOUNT_A,
+    client: TEST_CLIENT,
+    chain: ethereum,
+    onDisconnect: () => {},
+    switchChain: () => {},
+  });
+
+  it("should add a wallet to the connection manager", async () => {
+    // Render the hook
+    const { result } = renderHook(() => useAddConnectedWallet(), { wrapper });
+    result.current(wallet);
+
+    expect(manager.connectedWallets.getValue()).toHaveLength(1);
+    expect(manager.connectedWallets.getValue()[0]).toEqual(wallet);
+    // add connected wallet should not set the active wallet
+    expect(manager.activeWalletStore.getValue()).toBeUndefined();
+  });
+
+  it("should throw an error when used outside of ThirdwebProvider", () => {
+    // Render the hook without a provider
+    expect(() => {
+      renderHook(() => useAddConnectedWallet());
+    }).toThrow("useAddConnectedWallet must be used within <ThirdwebProvider>");
+  });
+});

package/src/react/core/hooks/wallets/useConnect.test.tsx

@@ -0,0 +1,105 @@
+import { renderHook } from "@testing-library/react";
+import type { ReactNode } from "react";
+import { beforeEach, describe, expect, it } from "vitest";
+import { MockStorage } from "../../../../../test/src/mocks/storage.js";
+import { TEST_CLIENT } from "../../../../../test/src/test-clients.js";
+import { TEST_ACCOUNT_A } from "../../../../../test/src/test-wallets.js";
+import { createWalletAdapter } from "../../../../adapters/wallet-adapter.js";
+import { ethereum } from "../../../../chains/chain-definitions/ethereum.js";
+import {
+  type ConnectionManager,
+  createConnectionManager,
+} from "../../../../wallets/manager/index.js";
+import { ConnectionManagerCtx } from "../../providers/connection-manager.js";
+import { useActiveWalletConnectionStatus } from "./useActiveWalletConnectionStatus.js";
+import { useConnect } from "./useConnect.js";
+
+describe("useAddConnectedWallet", () => {
+  // Mock the connection manager
+  const mockStorage = new MockStorage();
+  let manager: ConnectionManager;
+
+  // Create a wrapper component with the mocked context
+  const wrapper = ({ children }: { children: ReactNode }) => {
+    return (
+      <ConnectionManagerCtx.Provider value={manager}>
+        {children}
+      </ConnectionManagerCtx.Provider>
+    );
+  };
+
+  const wallet = createWalletAdapter({
+    adaptedAccount: TEST_ACCOUNT_A,
+    client: TEST_CLIENT,
+    chain: ethereum,
+    onDisconnect: () => {},
+    switchChain: () => {},
+  });
+
+  beforeEach(() => {
+    manager = createConnectionManager(mockStorage);
+  });
+
+  it("should connect a wallet to the connection manager", async () => {
+    const { result: statusResult } = renderHook(
+      () => useActiveWalletConnectionStatus(),
+      {
+        wrapper,
+      },
+    );
+    const { result } = renderHook(() => useConnect(), { wrapper });
+    expect(statusResult.current).toEqual("disconnected");
+    await result.current.connect(async () => wallet);
+    expect(statusResult.current).toEqual("connected");
+
+    // should add to connected wallets
+    expect(manager.connectedWallets.getValue()).toHaveLength(1);
+    expect(manager.connectedWallets.getValue()[0]).toEqual(wallet);
+    // should set the active wallet
+    expect(manager.activeWalletStore.getValue()).toEqual(wallet);
+  });
+
+  it("should handle a function that returns a wallet", async () => {
+    const { result: statusResult } = renderHook(
+      () => useActiveWalletConnectionStatus(),
+      {
+        wrapper,
+      },
+    );
+    const { result } = renderHook(() => useConnect(), { wrapper });
+    expect(statusResult.current).toEqual("disconnected");
+    await result.current.connect(async () => wallet);
+    expect(statusResult.current).toEqual("connected");
+
+    // should add to connected wallets
+    expect(manager.connectedWallets.getValue()).toHaveLength(1);
+    expect(manager.connectedWallets.getValue()[0]).toEqual(wallet);
+    // should set the active wallet
+    expect(manager.activeWalletStore.getValue()).toEqual(wallet);
+  });
+
+  it("should handle an error when connecting a wallet", async () => {
+    const { result: statusResult } = renderHook(
+      () => useActiveWalletConnectionStatus(),
+      {
+        wrapper,
+      },
+    );
+    expect(statusResult.current).toEqual("disconnected");
+    const { result } = renderHook(() => useConnect(), { wrapper });
+    await result.current.connect(async () => {
+      throw new Error("test");
+    });
+
+    expect(statusResult.current).toEqual("disconnected");
+    // should set the active wallet
+    expect(manager.activeWalletStore.getValue()).toEqual(undefined);
+  });
+
+  it("should throw an error when used outside of ThirdwebProvider", () => {
+    // Render the hook without a provider
+    expect(() => {
+      renderHook(() => useConnect());
+    }).toThrow("useConnect must be used within <ThirdwebProvider>");
+  });
+});

package/src/react/core/hooks/wallets/useSetActiveWallet.test.tsx

@@ -0,0 +1,53 @@
+import { renderHook } from "@testing-library/react";
+import type { ReactNode } from "react";
+import { describe, expect, it } from "vitest";
+import { MockStorage } from "../../../../../test/src/mocks/storage.js";
+import { TEST_CLIENT } from "../../../../../test/src/test-clients.js";
+import { TEST_ACCOUNT_A } from "../../../../../test/src/test-wallets.js";
+import { createWalletAdapter } from "../../../../adapters/wallet-adapter.js";
+import { ethereum } from "../../../../chains/chain-definitions/ethereum.js";
+import { createConnectionManager } from "../../../../wallets/manager/index.js";
+import { ConnectionManagerCtx } from "../../providers/connection-manager.js";
+import { useSetActiveWallet } from "./useSetActiveWallet.js";
+
+describe("useAddConnectedWallet", () => {
+  // Mock the connection manager
+  const mockStorage = new MockStorage();
+  const manager = createConnectionManager(mockStorage);
+
+  // Create a wrapper component with the mocked context
+  const wrapper = ({ children }: { children: ReactNode }) => {
+    return (
+      <ConnectionManagerCtx.Provider value={manager}>
+        {children}
+      </ConnectionManagerCtx.Provider>
+    );
+  };
+
+  const wallet = createWalletAdapter({
+    adaptedAccount: TEST_ACCOUNT_A,
+    client: TEST_CLIENT,
+    chain: ethereum,
+    onDisconnect: () => {},
+    switchChain: () => {},
+  });
+
+  it("should add a wallet to the connection manager", async () => {
+    // Render the hook
+    const { result } = renderHook(() => useSetActiveWallet(), { wrapper });
+    result.current(wallet);
+
+    // should add to connected wallets
+    expect(manager.connectedWallets.getValue()).toHaveLength(1);
+    expect(manager.connectedWallets.getValue()[0]).toEqual(wallet);
+    // should set the active wallet
+    expect(manager.activeWalletStore.getValue()).toEqual(wallet);
+  });
+
+  it("should throw an error when used outside of ThirdwebProvider", () => {
+    // Render the hook without a provider
+    expect(() => {
+      renderHook(() => useSetActiveWallet());
+    }).toThrow("useSetActiveWallet must be used within <ThirdwebProvider>");
+  });
+});