thirdweb 5.41.0 → 5.42.0-nightly-e27ebef85bb61342c3de53f85e134cf4a29f787c-20240730000342

package/dist/types/react/core/hooks/others/useChainQuery.d.ts

@@ -1,4 +1,5 @@
-import type { Chain } from "../../../../chains/types.js";
+import { type UseQueryResult } from "@tanstack/react-query";
+import type { Chain, ChainMetadata } from "../../../../chains/types.js";
 export declare function useChainName(chain?: Chain): {
     name: string | undefined;
     isLoading: boolean;
@@ -24,13 +25,29 @@ export declare function useChainExplorers(chain?: Chain): {
     isLoading: boolean;
 };
 /**
- * @internal
+ * @description Retrieves metadata for a chain such as name, icon, available faucets, block explorers, etc.
+ *
+ * @param chain - Chain to retrieve metadata for, see [defineChain](https://portal.thirdweb.com/references/typescript/v5/defineChain) for how to create a chain from a chain ID.
+ * @returns A React Query result containing the chain metadata, @see {@link ChainMetadata}.
+ *
+ * @example
+ * ```jsx
+ * import { useChainMetadata } from "thirdweb/react";
+ *
+ * const { data: chainMetadata } = useChainMetadata(defineChain(11155111));
+ *
+ * console.log("Name:", chainMetadata.name); // Sepolia
+ * console.log("Faucets:", chainMetadata.faucets); // ["https://thirdweb.com/sepolia/faucet"]
+ * console.log("Explorers:", chainMetadata.explorers); // ["https://sepolia.etherscan.io/"]
+ * ```
+ *
+ * @chain
  */
-export declare function useChainQuery(chain?: Chain): import("@tanstack/react-query").UseQueryResult<import("../../../../chains/types.js").ChainMetadata, Error>;
+export declare function useChainMetadata(chain?: Chain): UseQueryResult<ChainMetadata>;
 /**
  * @param chains - array of `Chains`
  * @param maxConcurrency - maximum number of concurrent requests to make
  * @internal
  */
-export declare function useChainsQuery(chains: Chain[], maxConcurrency: number): import("@tanstack/react-query").UseQueryResult<import("../../../../chains/types.js").ChainMetadata, Error>[];
+export declare function useChainsQuery(chains: Chain[], maxConcurrency: number): UseQueryResult<ChainMetadata, Error>[];
 //# sourceMappingURL=useChainQuery.d.ts.map

package/dist/types/react/core/hooks/others/useChainQuery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useChainQuery.d.ts","sourceRoot":"","sources":["../../../../../../src/react/core/hooks/others/useChainQuery.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AAOzD,wBAAgB,YAAY,CAAC,KAAK,CAAC,EAAE,KAAK;;;EAqBzC;AAED,wBAAgB,eAAe,CAAC,KAAK,CAAC,EAAE,KAAK;;;EAsB5C;AAED,wBAAgB,eAAe,CAAC,KAAK,CAAC,EAAE,KAAK;;;EA0B5C;AAED,wBAAgB,cAAc,CAAC,KAAK,CAAC,EAAE,KAAK;;;EAuB3C;AAED,wBAAgB,iBAAiB,CAAC,KAAK,CAAC,EAAE,KAAK;;;;;;;EAsB9C;AAUD;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,CAAC,EAAE,KAAK,8GAU1C;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,cAAc,EAAE,MAAM,gHAcrE"}
+{"version":3,"file":"useChainQuery.d.ts","sourceRoot":"","sources":["../../../../../../src/react/core/hooks/others/useChainQuery.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,cAAc,EAGpB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAOxE,wBAAgB,YAAY,CAAC,KAAK,CAAC,EAAE,KAAK;;;EAqBzC;AAED,wBAAgB,eAAe,CAAC,KAAK,CAAC,EAAE,KAAK;;;EAsB5C;AAED,wBAAgB,eAAe,CAAC,KAAK,CAAC,EAAE,KAAK;;;EA0B5C;AAED,wBAAgB,cAAc,CAAC,KAAK,CAAC,EAAE,KAAK;;;EAuB3C;AAED,wBAAgB,iBAAiB,CAAC,KAAK,CAAC,EAAE,KAAK;;;;;;;EAsB9C;AAUD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,cAAc,CAAC,aAAa,CAAC,CAU7E;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,cAAc,EAAE,MAAM,0CAcrE"}

package/dist/types/react/core/hooks/transaction/transaction-button-utils.d.ts

@@ -31,6 +31,7 @@ export type TransactionButtonProps = {
     onError?: (error: Error) => void;
     /**
      * Callback to be called when the button is clicked
+     * This function is provoked before the transaction is sent
      */
     onClick?: () => void;
     /**

package/dist/types/react/core/hooks/transaction/transaction-button-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transaction-button-utils.d.ts","sourceRoot":"","sources":["../../../../../../src/react/core/hooks/transaction/transaction-button-utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,MAAM,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kDAAkD,CAAC;AACvF,OAAO,EACL,KAAK,qBAAqB,EAE3B,MAAM,wDAAwD,CAAC;AAChE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gDAAgD,CAAC;AAE1F,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,KAAK,EACV,6BAA6B,EAC7B,sBAAsB,EACvB,MAAM,yBAAyB,CAAC;AAEjC;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC;;OAEG;IACH,WAAW,EAAE,MACT,mBAAmB,CAAC,GAAG,CAAC,GAExB,OAAO,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC;IAEtC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,CAAC,iBAAiB,EAAE,qBAAqB,KAAK,IAAI,CAAC;IACvE;;;;;OAKG;IACH,sBAAsB,CAAC,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAC/D;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAE1B;;;OAGG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;IAEzB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,QAAQ,CAAC,EAAE,6BAA6B,CAAC;IAEzC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;IAEjC;;;;OAIG;IACH,IAAI,CAAC,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC;CAClC,CAAC;AAEF,eAAO,MAAM,4BAA4B,UAChC,sBAAsB,qBACV,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC,aAAa,CAAC,kFAuC5E,CAAC"}
+{"version":3,"file":"transaction-button-utils.d.ts","sourceRoot":"","sources":["../../../../../../src/react/core/hooks/transaction/transaction-button-utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,MAAM,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kDAAkD,CAAC;AACvF,OAAO,EACL,KAAK,qBAAqB,EAE3B,MAAM,wDAAwD,CAAC;AAChE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gDAAgD,CAAC;AAE1F,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,KAAK,EACV,6BAA6B,EAC7B,sBAAsB,EACvB,MAAM,yBAAyB,CAAC;AAEjC;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC;;OAEG;IACH,WAAW,EAAE,MACT,mBAAmB,CAAC,GAAG,CAAC,GAExB,OAAO,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC;IAEtC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,CAAC,iBAAiB,EAAE,qBAAqB,KAAK,IAAI,CAAC;IACvE;;;;;OAKG;IACH,sBAAsB,CAAC,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAC/D;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAE1B;;;OAGG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;IAEzB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,QAAQ,CAAC,EAAE,6BAA6B,CAAC;IAEzC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;IAEjC;;;;OAIG;IACH,IAAI,CAAC,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC;CAClC,CAAC;AAEF,eAAO,MAAM,4BAA4B,UAChC,sBAAsB,qBACV,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC,aAAa,CAAC,kFAuC5E,CAAC"}

package/dist/types/react/web/ui/PayEmbed.d.ts

@@ -14,7 +14,7 @@ import type { LocaleId } from "./types.js";
 export type PayEmbedProps = {
     /**
      * Override the default tokens shown in PayEmbed uI
-     *
+     * @component
      * By default, PayEmbed shows a few popular tokens for Pay supported chains
      * @example
      *

package/dist/types/react/web/ui/prebuilt/thirdweb/BuyDirectListingButton/index.d.ts

@@ -0,0 +1,63 @@
+import type { Chain } from "../../../../../../chains/types.js";
+import type { ThirdwebClient } from "../../../../../../client/client.js";
+import type { TransactionButtonProps } from "../../../../../core/hooks/transaction/transaction-button-utils.js";
+export type BuyDirectListingButtonProps = Omit<TransactionButtonProps, "transaction"> & {
+    /**
+     * The contract address of the Marketplace v3 contract.
+     */
+    contractAddress: string;
+    /**
+     * The chain which the Drop contract is deployed on
+     */
+    chain: Chain;
+    /**
+     * thirdweb Client
+     */
+    client: ThirdwebClient;
+    /**
+     * ID of the marketplace's DirectListing
+     */
+    listingId: bigint;
+    /**
+     * Qty to buy (optional)
+     *
+     * - For ERC721 listing: the `quantity` is always hard-coded to 1n - passing this props doesn't do anything
+     *
+     * - For ERC1155 listing: the `quantity` defaults to the quantity of the listing if not specified.
+     *
+     * The component will also throw an error if  you pass a `quantity` and it's greater than the listing's quantity
+     */
+    quantity?: bigint;
+};
+/**
+ * This button is used with thirdweb Marketplace v3 contract, for buying NFT(s) from a listing.
+ *
+ * Under the hood, it prepares a transaction using the [`buyFromListing` extension](https://portal.thirdweb.com/references/typescript/v5/marketplace/buyFromListing)
+ * and then pass it to a <TransactionButton />
+ *
+ * Since it uses the TransactionButton, it can take in any props that can be passed
+ * to the [`TransactionButton`](https://portal.thirdweb.com/references/typescript/v5/TransactionButton)
+ *
+ *
+ * @param props
+ * @returns <TransactionButton />
+ *
+ * @example
+ * ```tsx
+ * import { BuyDirectListingButton } from "thirdweb/react";
+ *
+ * <BuyDirectListingButton
+ *   contractAddress="0x..." // contract address of the marketplace v3
+ *   chain={...} // the chain which the marketplace contract is deployed on
+ *   client={...} // thirdweb client
+ *   listingId={100n} // the listingId or the item you want to buy
+ *   quantity={1n} // optional - see the docs to learn more
+ * >
+ *   Buy NFT
+ * </BuyDirectListingButton>
+ * ```
+ *
+ * @component
+ */
+export declare function BuyDirectListingButton(props: BuyDirectListingButtonProps): import("react/jsx-runtime.js").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/react/web/ui/prebuilt/thirdweb/BuyDirectListingButton/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../src/react/web/ui/prebuilt/thirdweb/BuyDirectListingButton/index.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mCAAmC,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAKzE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mEAAmE,CAAC;AAKhH,MAAM,MAAM,2BAA2B,GAAG,IAAI,CAC5C,sBAAsB,EACtB,aAAa,CACd,GAAG;IACF;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,KAAK,EAAE,KAAK,CAAC;IAEb;;OAEG;IACH,MAAM,EAAE,cAAc,CAAC;IAEvB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,2BAA2B,8CAuGxE"}

package/dist/types/react/web/ui/prebuilt/thirdweb/ClaimButton/index.d.ts

@@ -1,5 +1,6 @@
 import { type ThirdwebContract } from "../../../../../../contract/contract.js";
 import type { PreparedTransaction } from "../../../../../../transaction/prepare-transaction.js";
+import type { BaseTransactionOptions } from "../../../../../../transaction/types.js";
 import type { Account } from "../../../../../../wallets/interfaces/wallet.js";
 import type { ClaimButtonProps, ClaimParams, Erc20ClaimParams, Erc721ClaimParams, Erc1155ClaimParams } from "./types.js";
 /**
@@ -14,6 +15,7 @@ import type { ClaimButtonProps, ClaimParams, Erc20ClaimParams, Erc721ClaimParams
  * @param props
  * @returns A wrapper for TransactionButton
  *
+ * @component
  * @example
  *
  * ```tsx
@@ -63,9 +65,28 @@ import type { ClaimButtonProps, ClaimParams, Erc20ClaimParams, Erc721ClaimParams
  *   Claim now
  * </ClaimButton>
  *
+ * // Attach custom Pay metadata
+ * <ClaimButton
+ *   payModal={{
+ *     metadata: {
+ *       name: "Van Gogh Starry Night",
+ *       image: "https://unsplash.com/starry-night.png"
+ *     }
+ *   }}
+ * >...</ClaimButton>
+ *
  * ```
  */
 export declare function ClaimButton(props: ClaimButtonProps): import("react/jsx-runtime.js").JSX.Element;
+/**
+ * @internal
+ */
+export declare function getPayMetadata(options: BaseTransactionOptions<{
+    tokenId?: bigint;
+}>): Promise<{
+    name?: string;
+    image?: string;
+}>;
 /**
  * @internal Export for test
  */

package/dist/types/react/web/ui/prebuilt/thirdweb/ClaimButton/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../src/react/web/ui/prebuilt/thirdweb/ClaimButton/index.tsx"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,gBAAgB,EAEtB,MAAM,wCAAwC,CAAC;AAChD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sDAAsD,CAAC;AAChG,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gDAAgD,CAAC;AAG9E,OAAO,KAAK,EACV,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8DG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,8CAmBlD;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,EACxC,QAAQ,EACR,OAAO,EACP,WAAW,GACZ,EAAE;IACD,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,OAAO,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,WAAW,EAAE,WAAW,CAAC;CAC1B,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAc/B;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,EACrC,QAAQ,EACR,OAAO,EACP,WAAW,GACZ,EAAE;IACD,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,OAAO,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,WAAW,EAAE,iBAAiB,CAAC;CAChC,8JAuBA;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,EACtC,QAAQ,EACR,OAAO,EACP,WAAW,GACZ,EAAE;IACD,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,OAAO,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,WAAW,EAAE,kBAAkB,CAAC;CACjC,8JAwBA;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,EACpC,QAAQ,EACR,OAAO,EACP,WAAW,GACZ,EAAE;IACD,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,OAAO,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,WAAW,EAAE,gBAAgB,CAAC;CAC/B,8JA4BA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../src/react/web/ui/prebuilt/thirdweb/ClaimButton/index.tsx"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,gBAAgB,EAEtB,MAAM,wCAAwC,CAAC;AAGhD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sDAAsD,CAAC;AAChG,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AACrF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gDAAgD,CAAC;AAK9E,OAAO,KAAK,EACV,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,8CAqDlD;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,sBAAsB,CAAC;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GACpD,OAAO,CAAC;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAgB5C;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,EACxC,QAAQ,EACR,OAAO,EACP,WAAW,GACZ,EAAE;IACD,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,OAAO,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,WAAW,EAAE,WAAW,CAAC;CAC1B,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAc/B;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,EACrC,QAAQ,EACR,OAAO,EACP,WAAW,GACZ,EAAE;IACD,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,OAAO,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,WAAW,EAAE,iBAAiB,CAAC;CAChC,8JAuBA;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,EACtC,QAAQ,EACR,OAAO,EACP,WAAW,GACZ,EAAE;IACD,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,OAAO,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,WAAW,EAAE,kBAAkB,CAAC;CACjC,8JAwBA;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,EACpC,QAAQ,EACR,OAAO,EACP,WAAW,GACZ,EAAE;IACD,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,OAAO,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,WAAW,EAAE,gBAAgB,CAAC;CAC/B,8JA4BA"}

package/dist/types/storage/download.d.ts

@@ -4,18 +4,58 @@ export type DownloadOptions = Prettify<ResolveSchemeOptions & {
     requestTimeoutMs?: number;
 }>;
 /**
- * Downloads a file from the specified URI.
+ * @description Downloads a file from the specified IPFS, Arweave, or HTTP URI.
+ *
+ * `download` will parse the provided URI based on its scheme (ipfs://, ar://, https://) and convert it to a URL to fetch the file from thirdweb's storage service.
+ *
  * @param options - The download options.
- * @returns A Promise that resolves to the downloaded file.
- * @throws An error if the URI scheme is invalid.
+ * @param options.client - The Thirdweb client. See [createThirdwebClient](https://portal.thirdweb.com/references/typescript/v5/createThirdwebClient).
+ * @param options.uri - The URI of the file to download. Can be IPFS, Arweave, or HTTP.
+ * @param [options.requestTimeoutMs] - The maximum time in milliseconds to wait for the request to complete. Defaults to 60 seconds (60,000 milliseconds).
+ *
+ * @returns Asynchronously returns the network response from fetching the file.
+ * @throws An error if the URI scheme is invalid or if the request fails.
+ *
  * @example
+ * Download a file from IPFS:
  * ```ts
  * import { download } from "thirdweb/storage";
+ * import { createThirdwebClient } from "@thirdweb-dev/sdk";
+ *
+ * const client = createThirdwebClient({ clientId: "YOUR_CLIENT_ID" });
+ *
  * const file = await download({
  *  client,
  *  uri: "ipfs://Qm...",
  * });
  * ```
+ *
+ * Download a file from Arweave:
+ * ```ts
+ * import { download } from "thirdweb/storage";
+ * import { createThirdwebClient } from "@thirdweb-dev/sdk";
+ *
+ * const client = createThirdwebClient({ clientId: "YOUR_CLIENT_ID" });
+ *
+ * const file = await download({
+ *  client,
+ *  uri: "ar://{arweave-transaction-id}",
+ * });
+ * ```
+ *
+ * Download a file from HTTP:
+ * ```ts
+ * import { download } from "thirdweb/storage";
+ * import { createThirdwebClient } from "@thirdweb-dev/sdk";
+ *
+ * const client = createThirdwebClient({ clientId: "YOUR_CLIENT_ID" });
+ *
+ * const file = await download({
+ *  client,
+ *  uri: "https://example.com/file.txt",
+ * });
+ * ```
+ *
  * @storage
  */
 export declare function download(options: DownloadOptions): Promise<Response>;

package/dist/types/storage/download.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../../../src/storage/download.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,oBAAoB,EAAiB,MAAM,kBAAkB,CAAC;AAC5E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEvD,MAAM,MAAM,eAAe,GAAG,QAAQ,CACpC,oBAAoB,GAAG;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CACF,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,eAAe,qBAkBtD"}
+{"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../../../src/storage/download.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,oBAAoB,EAAiB,MAAM,kBAAkB,CAAC;AAC5E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEvD,MAAM,MAAM,eAAe,GAAG,QAAQ,CACpC,oBAAoB,GAAG;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CACF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,eAAe,qBAqBtD"}

package/dist/types/utils/contract/parse-abi-params.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Converts an array of parameter values to their respective types based on the provided type array.
+ *
+ * This utility function is particularly useful for ensuring that parameter values are correctly formatted
+ * according to the expected types before they are used in further processing or passed to a Solidity smart contract.
+ *
+ * @param {string[]} constructorParamTypes - An array of type strings indicating the expected types of the values,
+ *                   following Solidity type conventions (e.g., "address", "uint256", "bool").
+ * @param {unknown[]} constructorParamValues - An array of values to be converted according to the types.
+ * @returns - An array of values converted to their respective types.
+ *
+ * @example
+ * ```ts
+ * import { parseAbiParams } from "thirdweb/utils";
+ *
+ * const example1 = parseAbiParams(
+ *   ["address", "uint256"],
+ *   ["0x.....", "1200000"]
+ * ); // result: ["0x......", 1200000n]
+ *
+ * const example2 = parseAbiParams(
+ *   ["address", "bool"],
+ *   ["0x.....", "true"]
+ * ); // result: ["0x......", true]
+ * ```
+ * @utils
+ */
+export declare function parseAbiParams(constructorParamTypes: string[], constructorParamValues: unknown[]): Array<string | bigint | boolean>;
+//# sourceMappingURL=parse-abi-params.d.ts.map

package/dist/types/utils/contract/parse-abi-params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-abi-params.d.ts","sourceRoot":"","sources":["../../../../src/utils/contract/parse-abi-params.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,cAAc,CAC5B,qBAAqB,EAAE,MAAM,EAAE,EAC/B,sBAAsB,EAAE,OAAO,EAAE,GAChC,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAwDlC"}

package/dist/types/version.d.ts

@@ -1,2 +1,2 @@
-export declare const version = "5.41.0";
+export declare const version = "5.42.0-nightly-e27ebef85bb61342c3de53f85e134cf4a29f787c-20240730000342";
 //# 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/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/wallets/in-app/core/wallet/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AAMzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,KAAK,EACV,gBAAgB,EAChB,0BAA0B,EAC1B,sBAAsB,EACvB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,GACvB,MAAM,IAAI,MAAM,CAAC,OAAO,GAAG,UAAU,CAAC,CAExC;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EACH,sBAAsB,CAAC,OAAO,CAAC,GAC/B,sBAAsB,CAAC,iBAAiB,CAAC,EAC7C,aAAa,EACT,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAC5B,gBAAgB,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,EAC1C,SAAS,EAAE,cAAc,GACxB,OAAO,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAgC3B;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EACH,0BAA0B,CAAC,OAAO,CAAC,GACnC,0BAA0B,CAAC,iBAAiB,CAAC,EACjD,aAAa,EACT,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAC5B,gBAAgB,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,EAC1C,SAAS,EAAE,cAAc,GACxB,OAAO,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CA0B3B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/wallets/in-app/core/wallet/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AAMzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,KAAK,EACV,gBAAgB,EAChB,0BAA0B,EAC1B,sBAAsB,EACvB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,GACvB,MAAM,IAAI,MAAM,CAAC,OAAO,GAAG,UAAU,CAAC,CAExC;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EACH,sBAAsB,CAAC,OAAO,CAAC,GAC/B,sBAAsB,CAAC,iBAAiB,CAAC,EAC7C,aAAa,EACT,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAC5B,gBAAgB,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,EAC1C,SAAS,EAAE,cAAc,GACxB,OAAO,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CA+B3B;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EACH,0BAA0B,CAAC,OAAO,CAAC,GACnC,0BAA0B,CAAC,iBAAiB,CAAC,EACjD,aAAa,EACT,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAC5B,gBAAgB,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,EAC1C,SAAS,EAAE,cAAc,GACxB,OAAO,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CA0B3B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "thirdweb",
-  "version": "5.41.0",
+  "version": "5.42.0-nightly-e27ebef85bb61342c3de53f85e134cf4a29f787c-20240730000342",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/thirdweb-dev/js.git#main"

package/src/client/client.ts

@@ -70,15 +70,33 @@ export type ThirdwebClient = {
 } & Readonly<ClientOptions>;
 
 /**
- * Creates a Thirdweb client with the provided options.
+ * Creates a Thirdweb client using the provided client ID (client-side) or secret key (server-side).
+ *
+ * Get your client ID and secret key from the Thirdweb dashboard [here](https://thirdweb.com/dashboard/settings/api-keys).
+ * **Never share your secret key with anyone.
+ *
+ * A client is necessary for most functions in the thirdweb SDK. It provides access to thirdweb APIs including built-in RPC, storage, and more.
+ *
  * @param options - The options for creating the client.
+ * @param [options.clientId] - The client ID to use for thirdweb services.
+ * @param [options.secretKey] - The secret key to use for thirdweb services.
  * @returns The created Thirdweb client.
  * @throws An error if neither `clientId` nor `secretKey` is provided.
+ *
  * @example
+ * Create a client on the client side (client ID):
  * ```ts
  * import { createThirdwebClient } from "thirdweb";
+ *
  * const client = createThirdwebClient({ clientId: "..." });
  * ```
+ *
+ * Create a client on the server (secret key):
+ * ```ts
+ * import { createThirdwebClient } from "thirdweb";
+ *
+ * const client = createThirdwebClient({ secretKey: "..." });
+ * ```
  */
 export function createThirdwebClient(
   options: CreateThirdwebClientOptions,

package/src/exports/extensions/common.ts

@@ -21,6 +21,11 @@ export {
   type SetContractMetadataParams,
 } from "../../extensions/common/write/setContractMetadata.js";
 
+export {
+  multicall,
+  type MulticallParams,
+} from "../../extensions/common/__generated__/IMulticall/write/multicall.js";
+
 // events
 
 export {

package/src/exports/extensions/erc1155.ts

@@ -54,6 +54,7 @@ export {
 } from "../../extensions/erc1155/__generated__/IERC1155/write/setApprovalForAll.js";
 export {
   safeTransferFrom,
+  encodeSafeTransferFrom,
   type SafeTransferFromParams,
 } from "../../extensions/erc1155/__generated__/IERC1155/write/safeTransferFrom.js";
 export {

package/src/exports/react.ts

@@ -56,6 +56,9 @@ export { useSwitchActiveWalletChain } from "../react/core/hooks/wallets/useSwitc
 export { useCallsStatus } from "../react/core/hooks/wallets/useCallsStatus.js";
 export { useWalletBalance } from "../react/core/hooks/others/useWalletBalance.js";
 
+// chain hooks
+export { useChainMetadata } from "../react/core/hooks/others/useChainQuery.js";
+
 export type { ConnectManagerOptions } from "../wallets/manager/index.js";
 
 // contract
@@ -158,5 +161,9 @@ export { useEnsName, useEnsAvatar } from "../react/core/utils/wallet.js";
  */
 export { ClaimButton } from "../react/web/ui/prebuilt/thirdweb/ClaimButton/index.js";
 export type { ClaimButtonProps } from "../react/web/ui/prebuilt/thirdweb/ClaimButton/types.js";
+export {
+  BuyDirectListingButton,
+  type BuyDirectListingButtonProps,
+} from "../react/web/ui/prebuilt/thirdweb/BuyDirectListingButton/index.js";
 
 export { useConnectionManager } from "../react/core/providers/connection-manager.js";

package/src/exports/utils.ts

@@ -21,6 +21,7 @@ export { getSaltHash } from "../utils/any-evm/get-salt-hash.js";
 export { isEIP155Enforced } from "../utils/any-evm/is-eip155-enforced.js";
 export { keccakId } from "../utils/any-evm/keccak-id.js";
 export { getKeylessTransaction } from "../utils/any-evm/keyless-transaction.js";
+export type { ExtendedMetadata } from "../utils/any-evm/deploy-metadata.js";
 
 //signatures
 export {
@@ -171,3 +172,5 @@ export {
 } from "../utils/extensions/drops/get-claim-params.js";
 
 export type { NFTMetadata, NFTInput } from "../utils/nft/parseNft.js";
+
+export { parseAbiParams } from "../utils/contract/parse-abi-params.js";

package/src/react/core/hooks/others/useChainQuery.ts

@@ -1,6 +1,10 @@
-import { useQueries, useQuery } from "@tanstack/react-query";
+import {
+  type UseQueryResult,
+  useQueries,
+  useQuery,
+} from "@tanstack/react-query";
 import { useMemo } from "react";
-import type { Chain } from "../../../../chains/types.js";
+import type { Chain, ChainMetadata } from "../../../../chains/types.js";
 import {
   convertApiChainToChain,
   getChainMetadata,
@@ -140,9 +144,25 @@ function getQueryOptions(chain?: Chain) {
 }
 
 /**
- * @internal
+ * @description Retrieves metadata for a chain such as name, icon, available faucets, block explorers, etc.
+ *
+ * @param chain - Chain to retrieve metadata for, see [defineChain](https://portal.thirdweb.com/references/typescript/v5/defineChain) for how to create a chain from a chain ID.
+ * @returns A React Query result containing the chain metadata, @see {@link ChainMetadata}.
+ *
+ * @example
+ * ```jsx
+ * import { useChainMetadata } from "thirdweb/react";
+ *
+ * const { data: chainMetadata } = useChainMetadata(defineChain(11155111));
+ *
+ * console.log("Name:", chainMetadata.name); // Sepolia
+ * console.log("Faucets:", chainMetadata.faucets); // ["https://thirdweb.com/sepolia/faucet"]
+ * console.log("Explorers:", chainMetadata.explorers); // ["https://sepolia.etherscan.io/"]
+ * ```
+ *
+ * @chain
  */
-export function useChainQuery(chain?: Chain) {
+export function useChainMetadata(chain?: Chain): UseQueryResult<ChainMetadata> {
   return useQuery({
     ...getQueryOptions(chain),
     queryFn: async () => {

package/src/react/core/hooks/transaction/transaction-button-utils.ts

@@ -44,6 +44,7 @@ export type TransactionButtonProps = {
   onError?: (error: Error) => void;
   /**
    * Callback to be called when the button is clicked
+   * This function is provoked before the transaction is sent
    */
   onClick?: () => void;
   /**

package/src/react/web/ui/ConnectWallet/screens/Buy/DirectPaymentModeScreen.tsx

@@ -11,7 +11,7 @@ import type { Account } from "../../../../../../wallets/interfaces/wallet.js";
 import { useCustomTheme } from "../../../../../core/design-system/CustomThemeProvider.js";
 import { iconSize, spacing } from "../../../../../core/design-system/index.js";
 import type { PayUIOptions } from "../../../../../core/hooks/connection/ConnectButtonProps.js";
-import { useChainQuery } from "../../../../../core/hooks/others/useChainQuery.js";
+import { useChainMetadata } from "../../../../../core/hooks/others/useChainQuery.js";
 import { useActiveWallet } from "../../../../../core/hooks/wallets/useActiveWallet.js";
 import type { TokenInfo } from "../../../../../core/utils/defaultTokens.js";
 import { useEnsName } from "../../../../../core/utils/wallet.js";
@@ -52,7 +52,7 @@ export function DirectPaymentModeScreen(props: {
   const activeWallet = useActiveWallet();
   const metadata = payUiOptions.metadata;
   const paymentInfo = payUiOptions.paymentInfo;
-  const { data: chainData } = useChainQuery(paymentInfo.chain);
+  const { data: chainData } = useChainMetadata(paymentInfo.chain);
   const { data: sellerEns } = useEnsName({
     client,
     address: paymentInfo.sellerAddress,

package/src/react/web/ui/ConnectWallet/screens/Buy/TransactionModeScreen.tsx

@@ -7,7 +7,7 @@ import type { Account } from "../../../../../../wallets/interfaces/wallet.js";
 import { useCustomTheme } from "../../../../../core/design-system/CustomThemeProvider.js";
 import { iconSize, spacing } from "../../../../../core/design-system/index.js";
 import type { PayUIOptions } from "../../../../../core/hooks/connection/ConnectButtonProps.js";
-import { useChainQuery } from "../../../../../core/hooks/others/useChainQuery.js";
+import { useChainMetadata } from "../../../../../core/hooks/others/useChainQuery.js";
 import { useActiveWallet } from "../../../../../core/hooks/wallets/useActiveWallet.js";
 import { hasSponsoredTransactionsEnabled } from "../../../../../core/utils/wallet.js";
 import { LoadingScreen } from "../../../../wallets/shared/LoadingScreen.js";
@@ -44,7 +44,7 @@ export function TransactionModeScreen(props: {
     supportedDestinations,
     onContinue,
   } = props;
-  const { data: chainData } = useChainQuery(payUiOptions.transaction.chain);
+  const { data: chainData } = useChainMetadata(payUiOptions.transaction.chain);
   const metadata = payUiOptions.metadata;
   const { data: transactionCostAndData } = useTransactionCostAndData({
     transaction: payUiOptions.transaction,

package/src/react/web/ui/PayEmbed.tsx

@@ -29,7 +29,7 @@ import type { LocaleId } from "./types.js";
 export type PayEmbedProps = {
   /**
    * Override the default tokens shown in PayEmbed uI
-   *
+   * @component
    * By default, PayEmbed shows a few popular tokens for Pay supported chains
    * @example
    *

package/src/react/web/ui/prebuilt/thirdweb/BuyDirectListingButton/BuyDirectListingButton.test.tsx

@@ -0,0 +1,27 @@
+import { describe, expect, it } from "vitest";
+import { render, screen } from "~test/react-render.js";
+import { TEST_CLIENT } from "~test/test-clients.js";
+import { sepolia } from "../../../../../../chains/chain-definitions/sepolia.js";
+import { BuyDirectListingButton } from "./index.js";
+
+const client = TEST_CLIENT;
+
+// marketplace v3 on sepolia
+const marketplaceAddress = "0xe0eFD6fb388405b67b3E9FaFc02649c70E749f03";
+
+describe.runIf(process.env.TW_SECRET_KEY)("BuyDirectListingButton", () => {
+  it("should render", () => {
+    render(
+      <BuyDirectListingButton
+        client={client}
+        chain={sepolia}
+        contractAddress={marketplaceAddress}
+        listingId={1n}
+      >
+        Buy NFT
+      </BuyDirectListingButton>,
+    );
+    expect(screen.queryByText("Buy NFT")).toBeInTheDocument();
+    expect(screen.getByRole("button")).toBeInTheDocument();
+  });
+});