thirdweb 5.54.0-nightly-c3800d6c0765a9a0b69ac0a4a390d20cec932419-20240912000413 → 5.55.0-nightly-8035923cdad943a47fc909e04522c351d06804f0-20240913000407

package/src/exports/extensions/ens.ts

@@ -8,6 +8,11 @@ export {
   resolveAvatar,
 } from "../../extensions/ens/resolve-avatar.js";
 
+export {
+  parseAvatarRecord,
+  type ParseAvatarOptions,
+} from "../../utils/ens/avatar.js";
+
 export {
   type ResolveTextOptions,
   resolveText,

package/src/exports/modules.ts

@@ -1,20 +1,90 @@
 // Modules
+/**
+ * All functions related to the MintableERC20 module.
+ * @modules MintableERC20
+ */
 export * as MintableERC20 from "../extensions/modules/MintableERC20/index.js";
+/**
+ * All functions related to the MintableERC721 module.
+ * @modules MintableERC721
+ */
 export * as MintableERC721 from "../extensions/modules/MintableERC721/index.js";
+/**
+ * All functions related to the MintableERC1155 module.
+ * @modules MintableERC1155
+ */
 export * as MintableERC1155 from "../extensions/modules/MintableERC1155/index.js";
+/**
+ * All functions related to the ClaimableERC20 module.
+ * @modules ClaimableERC20
+ */
 export * as ClaimableERC20 from "../extensions/modules/ClaimableERC20/index.js";
+/**
+ * All functions related to the ClaimableERC721 module.
+ * @modules ClaimableERC721
+ */
 export * as ClaimableERC721 from "../extensions/modules/ClaimableERC721/index.js";
+/**
+ * All functions related to the ClaimableERC1155 module.
+ * @modules ClaimableERC1155
+ */
 export * as ClaimableERC1155 from "../extensions/modules/ClaimableERC1155/index.js";
+/**
+ * All functions related to the OpenEditionMetadataERC721 module.
+ * @modules OpenEditionMetadataERC721
+ */
 export * as OpenEditionMetadataERC721 from "../extensions/modules/OpenEditionMetadataERC721/index.js";
+/**
+ * All functions related to the BatchMetadataERC721 module.
+ * @modules BatchMetadataERC721
+ */
 export * as BatchMetadataERC721 from "../extensions/modules/BatchMetadataERC721/index.js";
+/**
+ * All functions related to the BatchMetadataERC1155 module.
+ * @modules BatchMetadataERC1155
+ */
 export * as BatchMetadataERC1155 from "../extensions/modules/BatchMetadataERC1155/index.js";
+/**
+ * All functions related to the SequentialTokenIdERC1155 module.
+ * @modules SequentialTokenIdERC1155
+ */
 export * as SequentialTokenIdERC1155 from "../extensions/modules/SequentialTokenIdERC1155/index.js";
+/**
+ * All functions related to the RoyaltyERC721 module.
+ * @modules RoyaltyERC721
+ */
 export * as RoyaltyERC721 from "../extensions/modules/RoyaltyERC721/index.js";
+/**
+ * All functions related to the RoyaltyERC1155 module.
+ * @modules RoyaltyERC1155
+ */
 export * as RoyaltyERC1155 from "../extensions/modules/RoyaltyERC1155/index.js";
-export * as TransferableERC20 from "../extensions/modules/TransferableERC721/index.js";
+/**
+ * All functions related to the TransferableERC20 module.
+ * @modules TransferableERC20
+ */
+export * as TransferableERC20 from "../extensions/modules/TransferableERC20/index.js";
+/**
+ * All functions related to the TransferableERC721 module.
+ * @modules TransferableERC721
+ */
 export * as TransferableERC721 from "../extensions/modules/TransferableERC721/index.js";
+/**
+ * All functions related to the TransferableERC1155 module.
+ * @modules TransferableERC1155
+ */
 export * as TransferableERC1155 from "../extensions/modules/TransferableERC1155/index.js";
 
+// deploy
+export {
+  deployModularContract,
+  type DeployModularContractOptions,
+  type CoreType,
+  type ModularContractParams,
+  type ModuleInstallData,
+  type ModuleInstaller,
+} from "../extensions/prebuilts/deploy-modular.js";
+
 // Common
 export { grantMinterRole } from "../extensions/modules/common/grantMinterRole.js";
 export {

package/src/exports/thirdweb.ts

@@ -68,6 +68,14 @@ export {
   type ThirdwebContract,
 } from "../contract/contract.js";
 
+/**
+ * WALLETS
+ */
+export {
+  getUser,
+  type GetUserResult,
+} from "../wallets/in-app/core/users/getUser.js";
+
 /**
  * TRANSACTIONS
  */

package/src/exports/wallets.ts

@@ -102,6 +102,11 @@ export {
   linkProfile,
 } from "../wallets/in-app/core/wallet/profiles.js";
 
+export {
+  getUser,
+  type GetUserResult,
+} from "../wallets/in-app/core/users/getUser.js";
+
 export type {
   CoinbaseWalletCreationOptions,
   CoinbaseSDKWalletConnectionOptions,

package/src/extensions/airdrop/write/airdropERC1155WithSignature.ts

@@ -23,13 +23,13 @@ import { airdropERC1155WithSignature as generatedAirdropERC1155WithSignature } f
  * });
  * await sendTransaction({ transaction, account });
  * ```
- * @extension Airdrop
+ * @extension AIRDROP
  * @returns A promise that resolves to the transaction result.
  */
 export const airdropERC1155WithSignature = generatedAirdropERC1155WithSignature;
 
 /**
- * @extension Airdrop
+ * @extension AIRDROP
  */
 export type GenerateAirdropERC1155SignatureOptions = {
   account: Account;
@@ -67,7 +67,7 @@ export type GenerateAirdropERC1155SignatureOptions = {
  * });
  * await sendTransaction({ transaction, account });
  * ```
- * @extension Airdrop
+ * @extension AIRDROP
  * @returns A promise that resolves to the req and signature.
  */
 export async function generateAirdropSignatureERC1155(

package/src/extensions/airdrop/write/airdropERC20WithSignature.ts

@@ -23,13 +23,13 @@ import { airdropERC20WithSignature as generatedAirdropERC20WithSignature } from
  * });
  * await sendTransaction({ transaction, account });
  * ```
- * @extension Airdrop
+ * @extension AIRDROP
  * @returns A promise that resolves to the transaction result.
  */
 export const airdropERC20WithSignature = generatedAirdropERC20WithSignature;
 
 /**
- * @extension Airdrop
+ * @extension AIRDROP
  */
 export type GenerateAirdropERC20SignatureOptions = {
   account: Account;
@@ -67,7 +67,7 @@ export type GenerateAirdropERC20SignatureOptions = {
  * });
  * await sendTransaction({ transaction, account });
  * ```
- * @extension Airdrop
+ * @extension AIRDROP
  * @returns A promise that resolves to the req and signature.
  */
 export async function generateAirdropSignatureERC20(

package/src/extensions/airdrop/write/airdropERC721WithSignature.ts

@@ -23,13 +23,13 @@ import { airdropERC721WithSignature as generatedAirdropERC721WithSignature } fro
  * });
  * await sendTransaction({ transaction, account });
  * ```
- * @extension Airdrop
+ * @extension AIRDROP
  * @returns A promise that resolves to the transaction result.
  */
 export const airdropERC721WithSignature = generatedAirdropERC721WithSignature;
 
 /**
- * @extension Airdrop
+ * @extension AIRDROP
  */
 export type GenerateAirdropERC721SignatureOptions = {
   account: Account;
@@ -67,7 +67,7 @@ export type GenerateAirdropERC721SignatureOptions = {
  * });
  * await sendTransaction({ transaction, account });
  * ```
- * @extension Airdrop
+ * @extension AIRDROP
  * @returns A promise that resolves to the req and signature.
  */
 export async function generateAirdropSignatureERC721(

package/src/extensions/airdrop/write/claimERC1155.ts

@@ -5,7 +5,7 @@ import { tokenMerkleRoot } from "../__generated__/Airdrop/read/tokenMerkleRoot.j
 import { claimERC1155 as generatedClaimERC1155 } from "../__generated__/Airdrop/write/claimERC1155.js";
 
 /**
- * @extension Airdrop
+ * @extension AIRDROP
  */
 export type ClaimERC1155Params = {
   tokenAddress: string;
@@ -32,7 +32,7 @@ export type ClaimERC1155Params = {
  * await sendTransaction({ claimTransaction, account });
  *
  * ```
- * @extension Airdrop
+ * @extension AIRDROP
  * @returns A promise that resolves to the transaction result.
  */
 export function claimERC1155(

package/src/extensions/airdrop/write/claimERC20.ts

@@ -9,7 +9,7 @@ import { tokenMerkleRoot } from "../__generated__/Airdrop/read/tokenMerkleRoot.j
 import { claimERC20 as generatedClaimERC20 } from "../__generated__/Airdrop/write/claimERC20.js";
 
 /**
- * @extension Airdrop
+ * @extension AIRDROP
  */
 export type ClaimERC20Params = {
   tokenAddress: string;
@@ -36,7 +36,7 @@ export type ClaimERC20Params = {
  * await sendTransaction({ claimTransaction, account });
  *
  * ```
- * @extension Airdrop
+ * @extension AIRDROP
  * @returns A promise that resolves to the transaction result.
  */
 export function claimERC20(options: BaseTransactionOptions<ClaimERC20Params>) {

package/src/extensions/airdrop/write/claimERC721.ts

@@ -5,7 +5,7 @@ import { tokenMerkleRoot } from "../__generated__/Airdrop/read/tokenMerkleRoot.j
 import { claimERC721 as generatedClaimERC721 } from "../__generated__/Airdrop/write/claimERC721.js";
 
 /**
- * @extension Airdrop
+ * @extension AIRDROP
  */
 export type ClaimERC721Params = {
   tokenAddress: string;
@@ -32,7 +32,7 @@ export type ClaimERC721Params = {
  * await sendTransaction({ claimTransaction, account });
  *
  * ```
- * @extension Airdrop
+ * @extension AIRDROP
  * @returns A promise that resolves to the transaction result.
  */
 export function claimERC721(

package/src/extensions/airdrop/write/merkleInfoERC1155.ts

@@ -3,7 +3,7 @@ import { processSnapshotERC1155 } from "../../../utils/extensions/airdrop/proces
 import type { SnapshotEntryERC1155 } from "../../../utils/extensions/airdrop/types.js";
 
 /**
- * @extension Airdrop
+ * @extension AIRDROP
  */
 export type GenerateMerkleTreeInfoERC1155Params = {
   snapshot: SnapshotEntryERC1155[];
@@ -37,7 +37,7 @@ export type GenerateMerkleTreeInfoERC1155Params = {
  * // - Set merkle root on the contract to enable claiming
  *
  * ```
- * @extension Airdrop
+ * @extension AIRDROP
  * @returns A promise that resolves to the merkle-root and snapshot-uri.
  */
 export async function generateMerkleTreeInfoERC1155(

package/src/extensions/airdrop/write/merkleInfoERC20.ts

@@ -7,7 +7,7 @@ import { processSnapshotERC20 } from "../../../utils/extensions/airdrop/process-
 import type { SnapshotEntryERC20 } from "../../../utils/extensions/airdrop/types.js";
 
 /**
- * @extension Airdrop
+ * @extension AIRDROP
  */
 export type GenerateMerkleTreeInfoERC20Params = {
   snapshot: SnapshotEntryERC20[];
@@ -41,7 +41,7 @@ export type GenerateMerkleTreeInfoERC20Params = {
  * // - Set merkle root on the contract to enable claiming
  *
  * ```
- * @extension Airdrop
+ * @extension AIRDROP
  * @returns A promise that resolves to the merkle-root and snapshot-uri.
  */
 export async function generateMerkleTreeInfoERC20(

package/src/extensions/airdrop/write/merkleInfoERC721.ts

@@ -3,7 +3,7 @@ import { processSnapshotERC721 } from "../../../utils/extensions/airdrop/process
 import type { SnapshotEntryERC721 } from "../../../utils/extensions/airdrop/types.js";
 
 /**
- * @extension Airdrop
+ * @extension AIRDROP
  */
 export type GenerateMerkleTreeInfoERC721Params = {
   snapshot: SnapshotEntryERC721[];
@@ -37,7 +37,7 @@ export type GenerateMerkleTreeInfoERC721Params = {
  * // - Set merkle root on the contract to enable claiming
  *
  * ```
- * @extension Airdrop
+ * @extension AIRDROP
  * @returns A promise that resolves to the merkle-root and snapshot-uri.
  */
 export async function generateMerkleTreeInfoERC721(

package/src/extensions/airdrop/write/saveSnapshot.ts

@@ -3,7 +3,7 @@ import type { BaseTransactionOptions } from "../../../transaction/types.js";
 import { setContractURI } from "../../common/__generated__/IContractMetadata/write/setContractURI.js";
 
 /**
- * @extension Airdrop
+ * @extension AIRDROP
  */
 export type SaveSnapshotParams = {
   merkleRoot: string;
@@ -52,7 +52,7 @@ export type SaveSnapshotParams = {
  * await sendTransaction({ setMerkleRootTransaction, account });
  *
  * ```
- * @extension Airdrop
+ * @extension AIRDROP
  * @returns A promise that resolves to the transaction result.
  */
 export function saveSnapshot(

package/src/extensions/erc20/drops/read/getActiveClaimCondition.ts

@@ -26,6 +26,18 @@ export async function getActiveClaimCondition(
   }
 }
 
+/**
+ * Checks if the `getActiveClaimCondition` method is supported by the given contract.
+ * @param availableSelectors An array of 4byte function selectors of the contract. You can get this in various ways, such as using "whatsabi" or if you have the ABI of the contract available you can use it to generate the selectors.
+ * @returns A boolean indicating if the `getActiveClaimCondition` method is supported.
+ * @extension ERC20
+ * @example
+ * ```ts
+ * import { isGetActiveClaimConditionSupported } from "thirdweb/extensions/erc20";
+ *
+ * const supported = isGetActiveClaimConditionSupported(["0x..."]);
+ * ```
+ */
 export function isGetActiveClaimConditionSupported(
   availableSelectors: string[],
 ) {

package/src/extensions/erc20/write/getApprovalForTransaction.ts

@@ -53,7 +53,7 @@ export type GetApprovalForTransactionParams = {
  * }
  * ```
  *
- * @transactions
+ * @transaction
  */
 export async function getApprovalForTransaction(
   options: GetApprovalForTransactionParams,

package/src/extensions/modules/BatchMetadataERC1155/uploadMetadata.ts

@@ -1,3 +1,4 @@
+import type { BaseTransactionOptions } from "../../../transaction/types.js";
 import {} from "../../../utils/ipfs.js";
 import {
   type UploadMetadataParams as CommonUploadMetadataParams,
@@ -6,5 +7,32 @@ import {
 
 export type UploadMetadataParams = CommonUploadMetadataParams;
 
-// exact same implementation as BatchMetadataERC721
-export const uploadMetadata = commonUploadMetadata;
+/**
+ * Uploads metadata for a batch of NFTs.
+ * @param options - The options for the transaction.
+ * @param options.contract - The contract to upload the metadata for.
+ * @param options.metadatas - The metadata for the NFTs.
+ * @returns The transaction to upload the metadata.
+ * @modules BatchMetadataERC1155
+ * @example
+ * ```ts
+ * import { BatchMetadataERC1155 } from "thirdweb/modules";
+ *
+ * const transaction = BatchMetadataERC1155.uploadMetadata({
+ *   contract,
+ *   metadatas: [
+ *     { name: "My NFT", description: "This is my NFT" },
+ *   ],
+ * });
+ *
+ * await sendTransaction({
+ *   transaction,
+ *   account,
+ * });
+ * ```
+ */
+export function uploadMetadata(
+  options: BaseTransactionOptions<UploadMetadataParams>,
+) {
+  return commonUploadMetadata(options);
+}

package/src/extensions/modules/BatchMetadataERC721/uploadMetadata.ts

@@ -10,6 +10,30 @@ export type UploadMetadataParams = {
   metadatas: (NFTInput | string)[];
 };
 
+/**
+ * Uploads metadata for a batch of NFTs.
+ * @param options - The options for the transaction.
+ * @param options.contract - The contract to upload the metadata for.
+ * @param options.metadatas - The metadata for the NFTs.
+ * @returns The transaction to upload the metadata.
+ * @modules BatchMetadataERC721
+ * @example
+ * ```ts
+ * import { BatchMetadataERC721 } from "thirdweb/modules";
+ *
+ * const transaction = BatchMetadataERC721.uploadMetadata({
+ *   contract,
+ *   metadatas: [
+ *     { name: "My NFT", description: "This is my NFT" },
+ *   ],
+ * });
+ *
+ * await sendTransaction({
+ *   transaction,
+ *   account,
+ * });
+ * ```
+ */
 export function uploadMetadata(
   options: BaseTransactionOptions<UploadMetadataParams>,
 ) {

package/src/extensions/modules/ClaimableERC1155/mint.ts

@@ -30,7 +30,7 @@ export type MintParams = {
  * // Send the transaction
  * await sendTransaction({ transaction, account });
  * ```
- * @module ClaimableERC1155
+ * @modules ClaimableERC1155
  */
 export function mint(options: BaseTransactionOptions<MintParams>) {
   return generatedMint({

package/src/extensions/modules/ClaimableERC1155/setClaimConditions.ts

@@ -10,6 +10,26 @@ import type { ClaimConditionInput } from "../../../utils/extensions/drops/types.
 import { keccak256 } from "../../../utils/hashing/keccak256.js";
 import { setClaimConditionByTokenId as generatedSetClaimCondition } from "../__generated__/ClaimableERC1155/write/setClaimConditionByTokenId.js";
 
+/**
+ * Sets the claim conditions for a given token ID.
+ * @param options - The options for setting the claim conditions.
+ * @returns A transaction to set the claim conditions.
+ * @modules ClaimableERC1155
+ * @example
+ * ```ts
+ * import { ClaimableERC1155 } from "thirdweb/modules";
+ *
+ * const transaction = ClaimableERC1155.setClaimCondition({
+ *   contract: contract,
+ *   tokenId: 0n,
+ *   pricePerToken: "1", // in ETH
+ *   maxClaimableSupply: "1000000",
+ *   maxClaimablePerWallet: "1",
+ * });
+ *
+ * await sendTransaction({ transaction, account });
+ * ```
+ */
 export function setClaimCondition(
   options: BaseTransactionOptions<ClaimConditionInput & { tokenId: bigint }>,
 ) {

package/src/extensions/modules/ClaimableERC20/mint.ts

@@ -28,7 +28,7 @@ export type MintParams = {
  * // Send the transaction
  * await sendTransaction({ transaction, account });
  * ```
- * @module ClaimableERC20
+ * @modules ClaimableERC20
  */
 export function mint(options: BaseTransactionOptions<MintParams>) {
   return generatedMint({

package/src/extensions/modules/ClaimableERC20/setClaimConditions.ts

@@ -10,6 +10,25 @@ import type { ClaimConditionInput } from "../../../utils/extensions/drops/types.
 import { keccak256 } from "../../../utils/hashing/keccak256.js";
 import { setClaimCondition as generatedSetClaimCondition } from "../__generated__/ClaimableERC20/write/setClaimCondition.js";
 
+/**
+ * Sets the claim conditions for a given token ID.
+ * @param options - The options for setting the claim conditions.
+ * @returns A transaction to set the claim conditions.
+ * @modules ClaimableERC20
+ * @example
+ * ```ts
+ * import { ClaimableERC20 } from "thirdweb/modules";
+ *
+ * const transaction = ClaimableERC20.setClaimCondition({
+ *   contract: contract,
+ *   pricePerToken: "1", // in ETH
+ *   maxClaimableSupply: "1000000",
+ *   maxClaimablePerWallet: "1",
+ * });
+ *
+ * await sendTransaction({ transaction, account });
+ * ```
+ */
 export function setClaimCondition(
   options: BaseTransactionOptions<ClaimConditionInput>,
 ) {

package/src/extensions/modules/ClaimableERC721/mint.ts

@@ -29,7 +29,7 @@ export type MintParams = {
  * // Send the transaction
  * await sendTransaction({ transaction, account });
  * ```
- * @module ClaimableERC721
+ * @modules ClaimableERC721
  */
 export function mint(options: BaseTransactionOptions<MintParams>) {
   return generatedMint({

package/src/extensions/modules/ClaimableERC721/setClaimConditions.ts

@@ -10,6 +10,25 @@ import type { ClaimConditionInput } from "../../../utils/extensions/drops/types.
 import { keccak256 } from "../../../utils/hashing/keccak256.js";
 import { setClaimCondition as generatedSetClaimCondition } from "../__generated__/ClaimableERC721/write/setClaimCondition.js";
 
+/**
+ * Sets the claim conditions for a given token ID.
+ * @param options - The options for setting the claim conditions.
+ * @returns A transaction to set the claim conditions.
+ * @modules ClaimableERC721
+ * @example
+ * ```ts
+ * import { ClaimableERC721 } from "thirdweb/modules";
+ *
+ * const transaction = ClaimableERC721.setClaimCondition({
+ *   contract: contract,
+ *   pricePerToken: "1", // in ETH
+ *   maxClaimableSupply: "1000000",
+ *   maxClaimablePerWallet: "1",
+ * });
+ *
+ * await sendTransaction({ transaction, account });
+ * ```
+ */
 export function setClaimCondition(
   options: BaseTransactionOptions<ClaimConditionInput>,
 ) {

package/src/extensions/modules/MintableERC1155/mintWithRole.ts

@@ -37,7 +37,7 @@ export type EditionMintParams = {
  * // Send the transaction
  * await sendTransaction({ transaction, account });
  * ```
- * @module MintableERC1155
+ * @modules MintableERC1155
  */
 export function mintWithRole(
   options: BaseTransactionOptions<EditionMintParams>,

package/src/extensions/modules/MintableERC1155/mintWithSignature.ts

@@ -49,7 +49,7 @@ import {
  * // Send the transaction
  * await sendTransaction({ transaction, account });
  * ```
- * @module MintableERC1155
+ * @modules MintableERC1155
  */
 export function mintWithSignature(
   options: BaseTransactionOptions<
@@ -114,7 +114,7 @@ export type GenerateMintSignatureOptions = {
  * // Send the transaction
  * await sendTransaction({ transaction, account });
  * ```
- * @module MintableERC1155
+ * @modules MintableERC1155
  */
 export async function generateMintSignature(
   options: GenerateMintSignatureOptions,

package/src/extensions/modules/MintableERC20/mintWithRole.ts

@@ -26,7 +26,7 @@ export type TokenMintParams = {
  * // Send the transaction
  * await sendTransaction({ transaction, account });
  * ```
- * @module MintableERC20
+ * @modules MintableERC20
  */
 export function mintWithRole(options: BaseTransactionOptions<TokenMintParams>) {
   return generatedMint({

package/src/extensions/modules/MintableERC20/mintWithSignature.ts

@@ -42,7 +42,7 @@ import {
  * // Send the transaction
  * await sendTransaction({ transaction, account });
  * ```
- * @module MintableERC20
+ * @modules MintableERC20
  */
 export function mintWithSignature(
   options: BaseTransactionOptions<
@@ -99,7 +99,7 @@ export type GenerateMintSignatureOptions = {
  * // Send the transaction
  * await sendTransaction({ transaction, account });
  * ```
- * @module MintableERC20
+ * @modules MintableERC20
  */
 export async function generateMintSignature(
   options: GenerateMintSignatureOptions,

package/src/extensions/modules/MintableERC721/mintWithRole.ts

@@ -36,7 +36,7 @@ export type NFTMintParams = {
  * // Send the transaction
  * await sendTransaction({ transaction, account });
  * ```
- * @module MintableERC721
+ * @modules MintableERC721
  */
 export function mintWithRole(options: BaseTransactionOptions<NFTMintParams>) {
   return generatedMint({

package/src/extensions/modules/MintableERC721/mintWithSignature.ts

@@ -53,7 +53,7 @@ import {
  * // Send the transaction
  * await sendTransaction({ transaction, account });
  * ```
- * @module MintableERC721
+ * @modules MintableERC721
  */
 export function mintWithSignature(
   options: BaseTransactionOptions<
@@ -116,7 +116,7 @@ export type GenerateMintSignatureOptions = {
  * // Send the transaction
  * await sendTransaction({ transaction, account });
  * ```
- * @module MintableERC721
+ * @modules MintableERC721
  */
 export async function generateMintSignature(
   options: GenerateMintSignatureOptions,

package/src/extensions/modules/__generated__/BatchMetadataERC1155/events/BatchMetadataUpdate.ts

@@ -3,7 +3,7 @@ import { prepareEvent } from "../../../../../event/prepare-event.js";
 /**
  * Creates an event object for the BatchMetadataUpdate event.
  * @returns The prepared event object.
- * @module BatchMetadataERC1155
+ * @modules BatchMetadataERC1155
  * @example
  * ```ts
  * import { getContractEvents } from "thirdweb";