thirdweb 5.76.1 → 5.77.0

package/src/react/web/ui/prebuilt/Token/name.tsx

@@ -3,11 +3,14 @@
 import { type UseQueryOptions, useQuery } from "@tanstack/react-query";
 import type React from "react";
 import type { JSX } from "react";
+import type { Chain } from "../../../../../chains/types.js";
 import { getChainMetadata } from "../../../../../chains/utils.js";
+import type { ThirdwebClient } from "../../../../../client/client.js";
 import { NATIVE_TOKEN_ADDRESS } from "../../../../../constants/addresses.js";
 import { getContract } from "../../../../../contract/contract.js";
 import { getContractMetadata } from "../../../../../extensions/common/read/getContractMetadata.js";
 import { name } from "../../../../../extensions/common/read/name.js";
+import { getFunctionId } from "../../../../../utils/function-id.js";
 import { useTokenContext } from "./provider.js";
 
 /**
@@ -157,33 +160,9 @@ export function TokenName({
 }: TokenNameProps) {
   const { address, client, chain } = useTokenContext();
   const nameQuery = useQuery({
-    queryKey: ["_internal_token_name_", chain.id, address] as const,
-    queryFn: async () => {
-      if (typeof nameResolver === "string") {
-        return nameResolver;
-      }
-      if (typeof nameResolver === "function") {
-        return nameResolver();
-      }
-      if (address.toLowerCase() === NATIVE_TOKEN_ADDRESS.toLowerCase()) {
-        // Don't wanna use `getChainNativeCurrencyName` because it has some side effect (it catches error and defaults to "ETH")
-        return getChainMetadata(chain).then((data) => data.nativeCurrency.name);
-      }
-      // Try to fetch the name from both the `name()` function and the contract metadata
-      // then prioritize the `name()`
-      const contract = getContract({ address, client, chain });
-      const [_name, contractMetadata] = await Promise.all([
-        name({ contract }),
-        getContractMetadata({ contract }),
-      ]);
-      if (!_name && !contractMetadata.name) {
-        throw new Error(
-          "Failed to resolve name from both name() and contract metadata",
-        );
-      }
-
-      return _name || contractMetadata.name;
-    },
+    queryKey: getQueryKeys({ chainId: chain.id, nameResolver, address }),
+    queryFn: async () =>
+      fetchTokenName({ address, chain, client, nameResolver }),
     ...queryOptions,
   });
 
@@ -195,7 +174,72 @@ export function TokenName({
     return fallbackComponent || null;
   }
 
-  const displayValue = formatFn ? formatFn(nameQuery.data) : nameQuery.data;
+  if (formatFn && typeof formatFn === "function") {
+    return <span {...restProps}>{formatFn(nameQuery.data)}</span>;
+  }
+
+  return <span {...restProps}>{nameQuery.data}</span>;
+}
+
+/**
+ * @internal Exported for tests only
+ */
+export async function fetchTokenName(props: {
+  address: string;
+  client: ThirdwebClient;
+  chain: Chain;
+  nameResolver?: string | (() => string) | (() => Promise<string>);
+}) {
+  const { nameResolver, address, client, chain } = props;
+  if (typeof nameResolver === "string") {
+    return nameResolver;
+  }
+  if (typeof nameResolver === "function") {
+    return nameResolver();
+  }
+  if (address.toLowerCase() === NATIVE_TOKEN_ADDRESS.toLowerCase()) {
+    // Don't wanna use `getChainName` because it has some side effect (it catches error and defaults to "ETH")
+    return getChainMetadata(chain).then((data) => data.nativeCurrency.name);
+  }
+
+  // Try to fetch the name from both the `name` function and the contract metadata
+  // then prioritize its result
+  const contract = getContract({ address, client, chain });
+  const [_name, contractMetadata] = await Promise.all([
+    name({ contract }).catch(() => undefined),
+    getContractMetadata({ contract }).catch(() => undefined),
+  ]);
+  if (typeof _name === "string") {
+    return _name;
+  }
+  if (typeof contractMetadata?.name === "string") {
+    return contractMetadata.name;
+  }
+  throw new Error(
+    "Failed to resolve name from both name() and contract metadata",
+  );
+}
 
-  return <span {...restProps}>{displayValue}</span>;
+/**
+ * @internal
+ */
+export function getQueryKeys(props: {
+  chainId: number;
+  address: string;
+  nameResolver?: string | (() => string) | (() => Promise<string>);
+}) {
+  const { chainId, address, nameResolver } = props;
+  return [
+    "_internal_token_name_",
+    chainId,
+    address,
+    {
+      resolver:
+        typeof nameResolver === "string"
+          ? nameResolver
+          : typeof nameResolver === "function"
+            ? getFunctionId(nameResolver)
+            : undefined,
+    },
+  ] as const;
 }

package/src/react/web/ui/prebuilt/Token/provider.test.tsx

@@ -5,6 +5,7 @@ import { ethereum } from "../../../../../chains/chain-definitions/ethereum.js";
 import { NATIVE_TOKEN_ADDRESS } from "../../../../../constants/addresses.js";
 import { TokenName } from "./name.js";
 import { TokenProvider } from "./provider.js";
+import { TokenSymbol } from "./symbol.js";
 
 describe.runIf(process.env.TW_SECRET_KEY)("TokenProvider component", () => {
   it("should render children correctly", () => {
@@ -29,6 +30,7 @@ describe.runIf(process.env.TW_SECRET_KEY)("TokenProvider component", () => {
         chain={ethereum}
       >
         <TokenName />
+        <TokenSymbol />
       </TokenProvider>,
     );
 
@@ -40,5 +42,14 @@ describe.runIf(process.env.TW_SECRET_KEY)("TokenProvider component", () => {
         }),
       ).toBeInTheDocument(),
     );
+
+    waitFor(() =>
+      expect(
+        screen.getByText("ETH", {
+          exact: true,
+          selector: "span",
+        }),
+      ).toBeInTheDocument(),
+    );
   });
 });

package/src/react/web/ui/prebuilt/Token/symbol.test.tsx

@@ -1,30 +1,148 @@
 import { describe, expect, it } from "vitest";
-import { render, screen, waitFor } from "~test/react-render.js";
+import { ANVIL_CHAIN } from "~test/chains.js";
+import {} from "~test/react-render.js";
 import { TEST_CLIENT } from "~test/test-clients.js";
+import {
+  UNISWAPV3_FACTORY_CONTRACT,
+  USDT_CONTRACT,
+} from "~test/test-contracts.js";
 import { ethereum } from "../../../../../chains/chain-definitions/ethereum.js";
 import { NATIVE_TOKEN_ADDRESS } from "../../../../../constants/addresses.js";
-import { TokenProvider } from "./provider.js";
-import { TokenSymbol } from "./symbol.js";
+import { getFunctionId } from "../../../../../utils/function-id.js";
+import { fetchTokenSymbol, getQueryKeys } from "./symbol.js";
+
+const client = TEST_CLIENT;
 
 describe.runIf(process.env.TW_SECRET_KEY)("TokenSymbol component", () => {
-  it("should pass the address correctly to the children props", () => {
-    render(
-      <TokenProvider
-        address={NATIVE_TOKEN_ADDRESS}
-        client={TEST_CLIENT}
-        chain={ethereum}
-      >
-        <TokenSymbol />
-      </TokenProvider>,
-    );
+  it("fetchTokenSymbol should respect the symbolResolver being a string", async () => {
+    const res = await fetchTokenSymbol({
+      address: "thing",
+      client,
+      chain: ANVIL_CHAIN,
+      symbolResolver: "tw",
+    });
+    expect(res).toBe("tw");
+  });
+
+  it("fetchTokenSymbol should respect the symbolResolver being a non-async function", async () => {
+    const res = await fetchTokenSymbol({
+      address: "thing",
+      client,
+      chain: ANVIL_CHAIN,
+      symbolResolver: () => "tw",
+    });
+
+    expect(res).toBe("tw");
+  });
+
+  it("fetchTokenSymbol should respect the symbolResolver being an async function", async () => {
+    const res = await fetchTokenSymbol({
+      address: "thing",
+      client,
+      chain: ANVIL_CHAIN,
+      symbolResolver: async () => {
+        await new Promise((resolve) => setTimeout(resolve, 2000));
+        return "tw";
+      },
+    });
+
+    expect(res).toBe("tw");
+  });
+
+  it("fetchTokenSymbol should work for contract with `symbol` function", async () => {
+    const res = await fetchTokenSymbol({
+      address: USDT_CONTRACT.address,
+      client,
+      chain: USDT_CONTRACT.chain,
+    });
+
+    expect(res).toBe("USDT");
+  });
+
+  it("fetchTokenSymbol should work for native token", async () => {
+    const res = await fetchTokenSymbol({
+      address: NATIVE_TOKEN_ADDRESS,
+      client,
+      chain: ethereum,
+    });
 
-    waitFor(() =>
-      expect(
-        screen.getByText("ETH", {
-          exact: true,
-          selector: "span",
-        }),
-      ).toBeInTheDocument(),
+    expect(res).toBe("ETH");
+  });
+
+  it("fetchTokenSymbol should try to fallback to the contract metadata if fails to resolves from `symbol()`", async () => {
+    // todo: find a contract with symbol in contractMetadata, but does not have a symbol function
+  });
+
+  it("fetchTokenSymbol should throw in the end where all fallback solutions failed to resolve to any symbol", async () => {
+    await expect(() =>
+      fetchTokenSymbol({
+        address: UNISWAPV3_FACTORY_CONTRACT.address,
+        client,
+        chain: UNISWAPV3_FACTORY_CONTRACT.chain,
+      }),
+    ).rejects.toThrowError(
+      "Failed to resolve symbol from both symbol() and contract metadata",
     );
   });
+
+  it("getQueryKeys should work without resolver", () => {
+    expect(getQueryKeys({ chainId: 1, address: "0x" })).toStrictEqual([
+      "_internal_token_symbol_",
+      1,
+      "0x",
+      {
+        resolver: undefined,
+      },
+    ]);
+  });
+
+  it("getQueryKeys should work with resolver being a string", () => {
+    expect(
+      getQueryKeys({ chainId: 1, address: "0x", symbolResolver: "tw" }),
+    ).toStrictEqual([
+      "_internal_token_symbol_",
+      1,
+      "0x",
+      {
+        resolver: "tw",
+      },
+    ]);
+  });
+
+  it("getQueryKeys should work with resolver being a non-async fn that returns a string", () => {
+    const fn = () => "tw";
+    const fnId = getFunctionId(fn);
+    expect(
+      getQueryKeys({ chainId: 1, address: "0x", symbolResolver: fn }),
+    ).toStrictEqual([
+      "_internal_token_symbol_",
+      1,
+      "0x",
+      {
+        resolver: fnId,
+      },
+    ]);
+  });
+
+  it("getQueryKeys should work with resolver being an async fn that returns a string", () => {
+    const fn = async () => {
+      await new Promise((resolve) => setTimeout(resolve, 2000));
+      return "tw";
+    };
+    const fnId = getFunctionId(fn);
+    expect(
+      getQueryKeys({
+        chainId: 1,
+        address: "0x",
+        symbolResolver: fn,
+      }),
+    ).toStrictEqual([
+      "_internal_token_symbol_",
+      1,
+      "0x",
+      {
+        resolver: fnId,
+      },
+    ]);
+  });
 });

package/src/react/web/ui/prebuilt/Token/symbol.tsx

@@ -3,11 +3,14 @@
 import { type UseQueryOptions, useQuery } from "@tanstack/react-query";
 import type React from "react";
 import type { JSX } from "react";
+import type { Chain } from "../../../../../chains/types.js";
 import { getChainMetadata } from "../../../../../chains/utils.js";
+import type { ThirdwebClient } from "../../../../../client/client.js";
 import { NATIVE_TOKEN_ADDRESS } from "../../../../../constants/addresses.js";
 import { getContract } from "../../../../../contract/contract.js";
 import { getContractMetadata } from "../../../../../extensions/common/read/getContractMetadata.js";
 import { symbol } from "../../../../../extensions/common/read/symbol.js";
+import { getFunctionId } from "../../../../../utils/function-id.js";
 import { useTokenContext } from "./provider.js";
 
 /**
@@ -154,36 +157,9 @@ export function TokenSymbol({
 }: TokenSymbolProps) {
   const { address, client, chain } = useTokenContext();
   const symbolQuery = useQuery({
-    queryKey: ["_internal_token_symbol_", chain.id, address] as const,
-    queryFn: async () => {
-      if (typeof symbolResolver === "string") {
-        return symbolResolver;
-      }
-      if (typeof symbolResolver === "function") {
-        return symbolResolver();
-      }
-      if (address.toLowerCase() === NATIVE_TOKEN_ADDRESS.toLowerCase()) {
-        // Don't wanna use `getChainSymbol` because it has some side effect (it catches error and defaults to "ETH")
-        return getChainMetadata(chain).then(
-          (data) => data.nativeCurrency.symbol,
-        );
-      }
-
-      // Try to fetch the symbol from both the `symbol` function and the contract metadata
-      // then prioritize the `symbol()`
-      const contract = getContract({ address, client, chain });
-      const [_symbol, contractMetadata] = await Promise.all([
-        symbol({ contract }),
-        getContractMetadata({ contract }),
-      ]);
-      if (!_symbol && !contractMetadata.symbol) {
-        throw new Error(
-          "Failed to resolve symbol from both symbol() and contract metadata",
-        );
-      }
-
-      return _symbol || contractMetadata.symbol;
-    },
+    queryKey: getQueryKeys({ chainId: chain.id, address, symbolResolver }),
+    queryFn: async () =>
+      fetchTokenSymbol({ symbolResolver, address, chain, client }),
     ...queryOptions,
   });
 
@@ -195,7 +171,72 @@ export function TokenSymbol({
     return fallbackComponent || null;
   }
 
-  const displayValue = formatFn ? formatFn(symbolQuery.data) : symbolQuery.data;
+  if (formatFn && typeof formatFn === "function") {
+    return <span {...restProps}>{formatFn(symbolQuery.data)}</span>;
+  }
+
+  return <span {...restProps}>{symbolQuery.data}</span>;
+}
 
-  return <span {...restProps}>{displayValue}</span>;
+/**
+ * @internal Exported for tests only
+ */
+export async function fetchTokenSymbol(props: {
+  address: string;
+  client: ThirdwebClient;
+  chain: Chain;
+  symbolResolver?: string | (() => string) | (() => Promise<string>);
+}): Promise<string> {
+  const { symbolResolver, address, client, chain } = props;
+  if (typeof symbolResolver === "string") {
+    return symbolResolver;
+  }
+  if (typeof symbolResolver === "function") {
+    return symbolResolver();
+  }
+  if (address.toLowerCase() === NATIVE_TOKEN_ADDRESS.toLowerCase()) {
+    // Don't wanna use `getChainSymbol` because it has some side effect (it catches error and defaults to "ETH")
+    return getChainMetadata(chain).then((data) => data.nativeCurrency.symbol);
+  }
+
+  // Try to fetch the symbol from both the `symbol` function and the contract metadata
+  // then prioritize its result
+  const contract = getContract({ address, client, chain });
+  const [_symbol, contractMetadata] = await Promise.all([
+    symbol({ contract }).catch(() => undefined),
+    getContractMetadata({ contract }).catch(() => undefined),
+  ]);
+  if (typeof _symbol === "string") {
+    return _symbol;
+  }
+  if (typeof contractMetadata?.symbol === "string") {
+    return contractMetadata.symbol;
+  }
+  throw new Error(
+    "Failed to resolve symbol from both symbol() and contract metadata",
+  );
+}
+
+/**
+ * @internal
+ */
+export function getQueryKeys(props: {
+  chainId: number;
+  address: string;
+  symbolResolver?: string | (() => string) | (() => Promise<string>);
+}) {
+  const { chainId, address, symbolResolver } = props;
+  return [
+    "_internal_token_symbol_",
+    chainId,
+    address,
+    {
+      resolver:
+        typeof symbolResolver === "string"
+          ? symbolResolver
+          : typeof symbolResolver === "function"
+            ? getFunctionId(symbolResolver)
+            : undefined,
+    },
+  ] as const;
 }

package/src/react/web/utils/storage.test.ts

@@ -0,0 +1,34 @@
+import { describe, expect, it, vi } from "vitest";
+import { webLocalStorage } from "../../../utils/storage/webStorage.js";
+import { LAST_AUTH_PROVIDER_STORAGE_KEY } from "../../core/utils/storage.js";
+import { getLastAuthProvider } from "./storage.js";
+
+vi.mock("../../../utils/storage/webStorage.js", () => ({
+  webLocalStorage: {
+    getItem: vi.fn().mockResolvedValueOnce("mockStrategy"),
+  },
+}));
+
+describe("getLastAuthProvider", () => {
+  it("should return the last authentication provider strategy if it exists", async () => {
+    const mockStrategy = "mockStrategy";
+    webLocalStorage.getItem = vi.fn().mockResolvedValueOnce(mockStrategy);
+
+    const result = await getLastAuthProvider();
+    expect(result).toBe(mockStrategy);
+  });
+
+  it("should return null if no authentication provider strategy is found", async () => {
+    webLocalStorage.getItem = vi.fn().mockResolvedValueOnce(null);
+
+    const result = await getLastAuthProvider();
+    expect(result).toBeNull();
+  });
+
+  it("should call webLocalStorage.getItem with the correct key", async () => {
+    await getLastAuthProvider();
+    expect(webLocalStorage.getItem).toHaveBeenCalledWith(
+      LAST_AUTH_PROVIDER_STORAGE_KEY,
+    );
+  });
+});

package/src/react/web/utils/storage.ts

@@ -0,0 +1,23 @@
+import { webLocalStorage } from "../../../utils/storage/webStorage.js";
+import { getLastAuthProvider as getLastAuthProviderCore } from "../../core/utils/storage.js";
+
+/**
+ * Retrieves the last authentication provider used from local storage.
+ *
+ * This function is designed to work only in a browser environment.
+ *
+ * @returns {Promise<AuthArgsType["strategy"] | null>} A promise that resolves to the last
+ * authentication provider strategy used, or `null` if none is found.
+ *
+ * @example
+ * ```typescript
+ * import { getLastAuthProvider } from "thirdweb/react";
+ *
+ * const lastAuthProvider = await getLastAuthProvider();
+ * ```
+ *
+ * @utils
+ */
+export async function getLastAuthProvider() {
+  return getLastAuthProviderCore(webLocalStorage);
+}

package/src/utils/any-evm/deploy-metadata.ts

@@ -159,6 +159,27 @@ type ParsedCompilerMetadata = {
   zk_version?: string;
 };
 
+export type DynamicParams = {
+  type: "address" | "address[]" | "bytes" | "bytes[]";
+
+  // use for address types
+  refContracts?: Array<{
+    contractId: string;
+    publisherAddress: string;
+    version: string;
+    salt?: string;
+  }>;
+
+  // use for bytes
+  paramsToEncode?: Array<
+    Array<{
+      type: string;
+      defaultValue?: string;
+      dynamicValue?: DynamicParams; // can have address type which may need ref
+    }>
+  >;
+};
+
 export type CompilerMetadata = Prettify<
   RawCompilerMetadata & ParsedCompilerMetadata
 >;
@@ -220,6 +241,14 @@ export type ExtendedMetadata = {
       description?: string;
       defaultValue?: string;
       hidden?: boolean;
+      dynamicValue?: DynamicParams;
+    }
+  >;
+  implConstructorParams?: Record<
+    string,
+    {
+      defaultValue?: string;
+      dynamicValue?: DynamicParams;
     }
   >;
   compositeAbi?: Abi;

package/src/version.ts

@@ -1 +1 @@
-export const version = "5.76.1";
+export const version = "5.77.0";