thirdweb 5.38.0 → 5.38.1-nightly-c82c524e139d7960794e08bca838a1a1b78a3532-20240725000333

package/src/chains/chain-definitions/palm.ts

@@ -1,5 +1,8 @@
 import { defineChain } from "../utils.js";
 
+/**
+ * @chain
+ */
 export const palm = /* @__PURE__ */ defineChain({
   id: 11297108109,
   name: "Palm",

package/src/chains/chain-definitions/polygon-amoy.ts

@@ -1,5 +1,8 @@
 import { defineChain } from "../utils.js";
 
+/**
+ * @chain
+ */
 export const polygonAmoy = /*@__PURE__*/ defineChain({
   id: 80002,
   name: "Polygon Amoy",

package/src/chains/chain-definitions/polygon-mumbai.ts

@@ -1,5 +1,8 @@
 import { defineChain } from "../utils.js";
 
+/**
+ * @chain
+ */
 export const polygonMumbai = /*@__PURE__*/ defineChain({
   id: 80001,
   name: "Polygon Mumbai",

package/src/chains/chain-definitions/polygon-zkevm-testnet.ts

@@ -1,5 +1,8 @@
 import { defineChain } from "../utils.js";
 
+/**
+ * @chain
+ */
 export const polygonZkEvmTestnet = /*@__PURE__*/ defineChain({
   id: 1442,
   name: "Polygon zkEVM Testnet",

package/src/chains/chain-definitions/polygon-zkevm.ts

@@ -1,5 +1,8 @@
 import { defineChain } from "../utils.js";
 
+/**
+ * @chain
+ */
 export const polygonZkEvm = /*@__PURE__*/ defineChain({
   id: 1101,
   name: "Polygon zkEVM",

package/src/chains/chain-definitions/polygon.ts

@@ -1,5 +1,8 @@
 import { defineChain } from "../utils.js";
 
+/**
+ * @chain
+ */
 export const polygon = /*@__PURE__*/ defineChain({
   id: 137,
   name: "Polygon",

package/src/chains/chain-definitions/rari-testnet.ts

@@ -1,5 +1,8 @@
 import { defineChain } from "../utils.js";
 
+/**
+ * @chain
+ */
 export const rariTestnet = /*@__PURE__*/ defineChain({
   id: 1918988905,
   name: "RARIchain Testnet",

package/src/chains/chain-definitions/rari.ts

@@ -1,5 +1,8 @@
 import { defineChain } from "../utils.js";
 
+/**
+ * @chain
+ */
 export const rari = /* @__PURE__ */ defineChain({
   id: 1380012617,
   name: "Rarichain",

package/src/chains/chain-definitions/scroll-alpha-testnet.ts

@@ -1,5 +1,8 @@
 import { defineChain } from "../utils.js";
 
+/**
+ * @chain
+ */
 export const scrollAlphaTestnet = /*@__PURE__*/ defineChain({
   id: 534353,
   name: "Scroll Alpha Testnet",

package/src/chains/chain-definitions/scroll-sepolia-testnet.ts

@@ -1,5 +1,8 @@
 import { defineChain } from "../utils.js";
 
+/**
+ * @chain
+ */
 export const scrollSepoliaTestnet = /*@__PURE__*/ defineChain({
   id: 534353,
   name: "Scroll Sepolia Testnet",

package/src/chains/chain-definitions/scroll.ts

@@ -1,5 +1,8 @@
 import { defineChain } from "../utils.js";
 
+/**
+ * @chain
+ */
 export const scroll = /*@__PURE__*/ defineChain({
   id: 534352,
   name: "Scroll",

package/src/chains/chain-definitions/sepolia.ts

@@ -1,5 +1,8 @@
 import { defineChain } from "../utils.js";
 
+/**
+ * @chain
+ */
 export const sepolia = /*@__PURE__*/ defineChain({
   id: 11155111,
   name: "Sepolia",

package/src/chains/chain-definitions/xai-sepolia.ts

@@ -1,5 +1,8 @@
 import { defineChain } from "../utils.js";
 
+/**
+ * @chain
+ */
 export const xaiSepolia = /* @__PURE__ */ defineChain({
   id: 37714555429,
   name: "Xai Sepolia",

package/src/chains/chain-definitions/xai.ts

@@ -1,5 +1,8 @@
 import { defineChain } from "../utils.js";
 
+/**
+ * @chain
+ */
 export const xai = /*@__PURE__*/ defineChain({
   id: 660279,
   name: "Xai Mainnet",

package/src/chains/chain-definitions/zk-candy-sepolia.ts

@@ -1,5 +1,8 @@
 import { defineChain } from "../utils.js";
 
+/**
+ * @chain
+ */
 export const zkCandySepolia = /*@__PURE__*/ defineChain({
   id: 302,
   name: "zkCandy Sepolia Testnet",

package/src/chains/chain-definitions/zksync-sepolia.ts

@@ -1,5 +1,8 @@
 import { defineChain } from "../utils.js";
 
+/**
+ * @chain
+ */
 export const zkSyncSepolia = /*@__PURE__*/ defineChain({
   id: 300,
   name: "ZkSync Sepolia",

package/src/chains/chain-definitions/zksync.ts

@@ -1,5 +1,8 @@
 import { defineChain } from "../utils.js";
 
+/**
+ * @chain
+ */
 export const zkSync = /*@__PURE__*/ defineChain({
   id: 324,
   name: "ZkSync Era",

package/src/chains/chain-definitions/zora-sepolia.ts

@@ -1,5 +1,8 @@
 import { defineChain } from "../utils.js";
 
+/**
+ * @chain
+ */
 export const zoraSepolia = /*@__PURE__*/ defineChain({
   id: 999999999,
   name: "Zora Sepolia",

package/src/chains/chain-definitions/zora.ts

@@ -1,5 +1,8 @@
 import { defineChain } from "../utils.js";
 
+/**
+ * @chain
+ */
 export const zora = /*@__PURE__*/ defineChain({
   id: 7777777,
   name: "Zora",

package/src/chains/types.ts

@@ -1,6 +1,11 @@
-import type { Prettify } from "../utils/type-utils.js";
-export type Chain = Prettify<Readonly<ChainOptions & { rpc: string }>>;
+/**
+ * @chain
+ */
+export type Chain = Readonly<ChainOptions & { rpc: string }>;
 
+/**
+ * @chain
+ */
 export type ChainOptions = {
   id: number;
   name?: string;
@@ -23,6 +28,9 @@ export type ChainOptions = {
   faucets?: Array<string>;
 };
 
+/**
+ * @chain
+ */
 type Icon = {
   url: string;
   width: number;
@@ -30,6 +38,9 @@ type Icon = {
   format: string;
 };
 
+/**
+ * @chain
+ */
 type ChainExplorer = {
   name: string;
   url: string;
@@ -37,6 +48,9 @@ type ChainExplorer = {
   standard: string;
 };
 
+/**
+ * @chain
+ */
 export type ChainMetadata = {
   name: string;
   title?: string;
@@ -70,7 +84,9 @@ export type ChainMetadata = {
   };
 };
 
-// legacy chain type
+/**
+ * @chain
+ */
 export type LegacyChain = {
   name: string;
   title?: string;

package/src/chains/utils.ts

@@ -38,10 +38,11 @@ const CUSTOM_CHAIN_MAP = new Map<number, Chain>();
 export function defineChain(
   options: number | ChainOptions | ViemChain | LegacyChain,
 ): Chain {
+  const RPC_URL = getThirdwebDomains().rpc;
   if (typeof options === "number") {
     return {
       id: options,
-      rpc: `https://${options}.rpc.thirdweb.com`,
+      rpc: `https://${options}.${RPC_URL}`,
     } as const;
   }
   if (isViemChain(options)) {
@@ -53,7 +54,7 @@ export function defineChain(
   // otherwise if it's not a viem chain, continue
   let rpc = options.rpc;
   if (!rpc) {
-    rpc = `https://${options.id}.rpc.thirdweb.com`;
+    rpc = `https://${options.id}.${RPC_URL}`;
   }
   const chain = { ...options, rpc } as const;
   CUSTOM_CHAIN_MAP.set(options.id, chain);
@@ -76,9 +77,10 @@ export function getCachedChain(id: number) {
   if (CUSTOM_CHAIN_MAP.has(id)) {
     return CUSTOM_CHAIN_MAP.get(id) as Chain;
   }
+  const RPC_URL = getThirdwebDomains().rpc;
   const chain = {
     id: id,
-    rpc: `https://${id}.rpc.thirdweb.com`,
+    rpc: `https://${id}.${RPC_URL}`,
   } as const;
   return chain;
 }
@@ -90,11 +92,11 @@ function isLegacyChain(
 }
 
 function convertLegacyChain(legacyChain: LegacyChain): Chain {
+  const RPC_URL = getThirdwebDomains().rpc;
   return {
     id: legacyChain.chainId,
     name: legacyChain.name,
-    rpc:
-      legacyChain.rpc[0] ?? `https://${legacyChain.chainId}.rpc.thirdweb.com`,
+    rpc: legacyChain.rpc[0] ?? `https://${legacyChain.chainId}.${RPC_URL}`,
     blockExplorers: legacyChain?.explorers?.map((explorer) => ({
       name: explorer.name,
       url: explorer.url,
@@ -118,6 +120,7 @@ function isViemChain(
 }
 
 function convertViemChain(viemChain: ViemChain): Chain {
+  const RPC_URL = getThirdwebDomains().rpc;
   return {
     id: viemChain.id,
     name: viemChain.name,
@@ -127,8 +130,7 @@ function convertViemChain(viemChain: ViemChain): Chain {
       decimals: viemChain.nativeCurrency.decimals,
     },
     rpc:
-      viemChain.rpcUrls.default.http[0] ??
-      `https://${viemChain.id}.rpc.thirdweb.com`,
+      viemChain.rpcUrls.default.http[0] ?? `https://${viemChain.id}.${RPC_URL}`,
     blockExplorers: viemChain?.blockExplorers
       ? Object.values(viemChain?.blockExplorers).map((explorer) => {
           return {

package/src/contract/actions/compiler-metadata.ts

@@ -1,5 +1,8 @@
 import type { Abi } from "abitype";
 
+/**
+ * @contract
+ */
 export type PublishedMetadata = {
   name: string;
   abi: Abi;

package/src/contract/contract.ts

@@ -2,6 +2,9 @@ import type { Abi } from "abitype";
 import type { Chain } from "../chains/types.js";
 import type { ThirdwebClient } from "../client/client.js";
 
+/**
+ * @contract
+ */
 export type ContractOptions<abi extends Abi = []> = {
   client: ThirdwebClient;
   address: string;
@@ -9,6 +12,9 @@ export type ContractOptions<abi extends Abi = []> = {
   readonly abi?: abi;
 };
 
+/**
+ * @contract
+ */
 export type ThirdwebContract<abi extends Abi = []> = Readonly<
   ContractOptions<abi>
 >;

package/src/contract/deployment/deploy-deterministic.ts

@@ -4,6 +4,9 @@ import type { Prettify } from "../../utils/type-utils.js";
 import type { ClientAndChain } from "../../utils/types.js";
 import { computeCreate2FactoryAddress } from "./utils/create-2-factory.js";
 
+/**
+ * @extension DEPLOY
+ */
 export type DeployDetemisiticParams = Prettify<
   ClientAndChain & {
     contractId: string;

package/src/contract/deployment/deploy-with-abi.ts

@@ -13,6 +13,9 @@ import type { Prettify } from "../../utils/type-utils.js";
 import type { ClientAndChain } from "../../utils/types.js";
 import type { Account } from "../../wallets/interfaces/wallet.js";
 
+/**
+ * @extension DEPLOY
+ */
 export type PrepareDirectDeployTransactionOptions<
   TConstructor extends AbiConstructor,
   TParams = AbiParametersToPrimitiveTypes<TConstructor["inputs"]>,

package/src/contract/deployment/publisher.ts

@@ -190,6 +190,9 @@ const GET_PUBLISHED_CONTRACT_VERSIONS_ABI = {
   type: "function",
 } as const;
 
+/**
+ * @contract
+ */
 type FetchPublishedContractOptions = {
   publisherAddress: string;
   contractId: string;

package/src/contract/verification/index.ts

@@ -11,6 +11,9 @@ const RequestStatus = {
   NOTOK: "0",
 };
 
+/**
+ * @contract
+ */
 type VerifyContractOptions = {
   contract: ThirdwebContract;
   explorerApiUrl: string;

package/src/exports/react.ts

@@ -140,3 +140,9 @@ export {
   useNetworkSwitcherModal,
   type UseNetworkSwitcherModalOptions,
 } from "../react/web/ui/ConnectWallet/NetworkSelector.js";
+
+/**
+ * Prebuilt UI components for thirdweb contracts
+ */
+export { ClaimButton } from "../react/web/ui/prebuilt/thirdweb/ClaimButton/index.js";
+export type { ClaimButtonProps } from "../react/web/ui/prebuilt/thirdweb/ClaimButton/types.js";

package/src/exports/utils.ts

@@ -134,6 +134,10 @@ export {
 // abi
 // ------------------------------------------------
 export { encodeAbiParameters } from "../utils/abi/encodeAbiParameters.js";
+
+/**
+ * @utils
+ */
 export { encodePacked } from "viem";
 
 // Useful helpers

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

@@ -28,6 +28,9 @@ import { airdropERC1155WithSignature as generatedAirdropERC1155WithSignature } f
  */
 export const airdropERC1155WithSignature = generatedAirdropERC1155WithSignature;
 
+/**
+ * @extension Airdrop
+ */
 export type GenerateAirdropERC1155SignatureOptions = {
   account: Account;
   contract: ThirdwebContract;

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

@@ -28,6 +28,9 @@ import { airdropERC20WithSignature as generatedAirdropERC20WithSignature } from
  */
 export const airdropERC20WithSignature = generatedAirdropERC20WithSignature;
 
+/**
+ * @extension Airdrop
+ */
 export type GenerateAirdropERC20SignatureOptions = {
   account: Account;
   contract: ThirdwebContract;

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

@@ -28,6 +28,9 @@ import { airdropERC721WithSignature as generatedAirdropERC721WithSignature } fro
  */
 export const airdropERC721WithSignature = generatedAirdropERC721WithSignature;
 
+/**
+ * @extension Airdrop
+ */
 export type GenerateAirdropERC721SignatureOptions = {
   account: Account;
   contract: ThirdwebContract;

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

@@ -4,6 +4,9 @@ import { fetchProofsERC1155 } from "../../../utils/extensions/airdrop/fetch-proo
 import { tokenMerkleRoot } from "../__generated__/Airdrop/read/tokenMerkleRoot.js";
 import { claimERC1155 as generatedClaimERC1155 } from "../__generated__/Airdrop/write/claimERC1155.js";
 
+/**
+ * @extension Airdrop
+ */
 export type ClaimERC1155Params = {
   tokenAddress: string;
   recipient: string;

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

@@ -8,6 +8,9 @@ import { fetchProofsERC20 } from "../../../utils/extensions/airdrop/fetch-proofs
 import { tokenMerkleRoot } from "../__generated__/Airdrop/read/tokenMerkleRoot.js";
 import { claimERC20 as generatedClaimERC20 } from "../__generated__/Airdrop/write/claimERC20.js";
 
+/**
+ * @extension Airdrop
+ */
 export type ClaimERC20Params = {
   tokenAddress: string;
   recipient: string;

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

@@ -4,6 +4,9 @@ import { fetchProofsERC721 } from "../../../utils/extensions/airdrop/fetch-proof
 import { tokenMerkleRoot } from "../__generated__/Airdrop/read/tokenMerkleRoot.js";
 import { claimERC721 as generatedClaimERC721 } from "../__generated__/Airdrop/write/claimERC721.js";
 
+/**
+ * @extension Airdrop
+ */
 export type ClaimERC721Params = {
   tokenAddress: string;
   recipient: string;

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

@@ -2,6 +2,9 @@ import type { BaseTransactionOptions } from "../../../transaction/types.js";
 import { processSnapshotERC1155 } from "../../../utils/extensions/airdrop/process-snapshot-erc1155.js";
 import type { SnapshotEntryERC1155 } from "../../../utils/extensions/airdrop/types.js";
 
+/**
+ * @extension Airdrop
+ */
 export type GenerateMerkleTreeInfoERC1155Params = {
   snapshot: SnapshotEntryERC1155[];
   tokenAddress: string;

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

@@ -6,6 +6,9 @@ import type { BaseTransactionOptions } from "../../../transaction/types.js";
 import { processSnapshotERC20 } from "../../../utils/extensions/airdrop/process-snapshot-erc20.js";
 import type { SnapshotEntryERC20 } from "../../../utils/extensions/airdrop/types.js";
 
+/**
+ * @extension Airdrop
+ */
 export type GenerateMerkleTreeInfoERC20Params = {
   snapshot: SnapshotEntryERC20[];
   tokenAddress: string;

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

@@ -2,6 +2,9 @@ import type { BaseTransactionOptions } from "../../../transaction/types.js";
 import { processSnapshotERC721 } from "../../../utils/extensions/airdrop/process-snapshot-erc721.js";
 import type { SnapshotEntryERC721 } from "../../../utils/extensions/airdrop/types.js";
 
+/**
+ * @extension Airdrop
+ */
 export type GenerateMerkleTreeInfoERC721Params = {
   snapshot: SnapshotEntryERC721[];
   tokenAddress: string;

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

@@ -2,6 +2,9 @@ import { upload } from "../../../storage/upload.js";
 import type { BaseTransactionOptions } from "../../../transaction/types.js";
 import { setContractURI } from "../../common/__generated__/IContractMetadata/write/setContractURI.js";
 
+/**
+ * @extension Airdrop
+ */
 export type SaveSnapshotParams = {
   merkleRoot: string;
   snapshotUri: string;

package/src/extensions/common/read/getContractMetadata.ts

@@ -8,7 +8,7 @@ import { symbol } from "./symbol.js";
  * Retrieves the contract metadata including name and symbol.
  * @param options The transaction options.
  * @returns A promise that resolves to an object containing the resolved metadata, name, and symbol.
- * @extension
+ * @extension COMMON
  * @example
  * ```ts
  * import { getContractMetadata } from "thirdweb/extensions/common";

package/src/extensions/common/write/setContractMetadata.ts

@@ -2,6 +2,9 @@ import { upload } from "../../../storage/upload.js";
 import type { BaseTransactionOptions } from "../../../transaction/types.js";
 import { setContractURI } from "../__generated__/IContractMetadata/write/setContractURI.js";
 
+/**
+ * @extension COMMON
+ */
 export type SetContractMetadataParams = Record<string, unknown>;
 
 /**

package/src/extensions/ens/resolve-address.ts

@@ -11,6 +11,9 @@ import { encodeAddr } from "./__generated__/AddressResolver/read/addr.js";
 import { resolve } from "./__generated__/UniversalResolver/read/resolve.js";
 import { UNIVERSAL_RESOLVER_ADDRESS } from "./constants.js";
 
+/**
+ * @extension ENS
+ */
 export type ResolveAddressOptions = {
   client: ThirdwebClient;
   name: string;

package/src/extensions/ens/resolve-avatar.ts

@@ -4,6 +4,9 @@ import { parseAvatarRecord } from "../../utils/ens/avatar.js";
 import { withCache } from "../../utils/promise/withCache.js";
 import { resolveText } from "./resolve-text.js";
 
+/**
+ * @extension ENS
+ */
 export type ResolveAvatarOptions = {
   client: ThirdwebClient;
   name: string;

package/src/extensions/ens/resolve-name.ts

@@ -9,6 +9,9 @@ import { withCache } from "../../utils/promise/withCache.js";
 import { reverse } from "./__generated__/UniversalResolver/read/reverse.js";
 import { UNIVERSAL_RESOLVER_ADDRESS } from "./constants.js";
 
+/**
+ * @extension ENS
+ */
 export type ResolveNameOptions = {
   client: ThirdwebClient;
   address: Address;

package/src/extensions/ens/resolve-text.ts

@@ -13,6 +13,9 @@ import {
 import { resolve } from "./__generated__/UniversalResolver/read/resolve.js";
 import { UNIVERSAL_RESOLVER_ADDRESS } from "./constants.js";
 
+/**
+ * @extension ENS
+ */
 export type ResolveTextOptions = {
   client: ThirdwebClient;
   name: string;

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

@@ -13,7 +13,7 @@ export type GetActiveClaimConditionParams = GetActiveClaimConditionIdParams;
  * @param options - The transaction options.
  * @returns A promise that resolves to the active claim condition.
  * @throws An error if the claim condition is unsupported.
- * @extension
+ * @extension ERC1155
  * @example
  * ```ts
  * import { getActiveClaimCondition } from "thirdweb/extensions/erc1155";

package/src/extensions/erc1155/drops/write/claimTo.ts

@@ -3,6 +3,9 @@ import type { BaseTransactionOptions } from "../../../../transaction/types.js";
 import { getClaimParams } from "../../../../utils/extensions/drops/get-claim-params.js";
 import { claim } from "../../__generated__/IDrop1155/write/claim.js";
 
+/**
+ * @extension ERC1155
+ */
 export type ClaimToParams = {
   to: Address;
   tokenId: bigint;

package/src/extensions/erc1155/drops/write/setClaimConditions.ts

@@ -3,6 +3,9 @@ import { getMulticallSetClaimConditionTransactions } from "../../../../utils/ext
 import type { ClaimConditionsInput } from "../../../../utils/extensions/drops/types.js";
 import { multicall } from "../../../common/__generated__/IMulticall/write/multicall.js";
 
+/**
+ * @extension ERC1155
+ */
 export type SetClaimConditionsParams = {
   tokenId: bigint;
   phases: ClaimConditionsInput[];

package/src/extensions/erc1155/drops/write/updateMetadata.ts

@@ -8,6 +8,9 @@ import type { ThirdwebClient } from "../../../../client/client.js";
 import type { BaseTransactionOptions } from "../../../../transaction/types.js";
 import type { NFT, NFTInput } from "../../../../utils/nft/parseNft.js";
 
+/**
+ * @extension ERC1155
+ */
 export type UpdateMetadataParams = {
   targetTokenId: bigint;
   newMetadata: NFTInput;

package/src/extensions/erc1155/read/getNFT.ts

@@ -6,6 +6,7 @@ import { uri } from "../__generated__/IERC1155/read/uri.js";
 
 /**
  * Parameters for getting an NFT.
+ * @extension ERC1155
  */
 export type GetNFTParams = {
   tokenId: bigint;

package/src/extensions/erc1155/read/getNFTs.ts

@@ -8,6 +8,7 @@ const DEFAULT_QUERY_ALL_COUNT = 100n;
 
 /**
  * Parameters for retrieving NFTs.
+ * @extension ERC1155
  */
 export type GetNFTsParams = {
   /**

package/src/extensions/erc1155/read/getOwnedNFTs.ts

@@ -10,6 +10,7 @@ const DEFAULT_QUERY_ALL_COUNT = 100;
 
 /**
  * Parameters for retrieving NFTs.
+ * @extension ERC1155
  */
 export type GetOwnedNFTsParams = {
   /**