feat(extensions): add generated is<Ext>Supported and encode<Ext> calls, add concatHex util fn (#2752)

Author: jnsdls

.changeset/happy-ads-march.md

@@ -0,0 +1,5 @@
+---
+"thirdweb": minor
+---
+
+add `concatHex` utility function

packages/thirdweb/scripts/generate/generate.ts

@@ -120,6 +120,8 @@ ${
 import { once } from "../../../../../utils/promise/once.js";`
     : ""
 }
+import type { ThirdwebContract } from "../../../../../contract/contract.js";
+import { detectMethod } from "../../../../../utils/bytecode/detectExtension.js";
 
 
 ${
@@ -145,6 +147,24 @@ export const FN_SELECTOR = "${preparedMethod[0]}" as const;
 const FN_INPUTS = ${JSON.stringify(preparedMethod[1], null, 2)} as const;
 const FN_OUTPUTS = ${JSON.stringify(preparedMethod[2], null, 2)} as const;
 
+/**
+ * Checks if the \`${f.name}\` method is supported by the given contract.
+ * @param contract The ThirdwebContract.
+ * @returns A promise that resolves to a boolean indicating if the \`${f.name}\` method is supported.
+ * @extension ERC721
+ * @example
+ * \`\`\`ts
+ * import { is${uppercaseFirstLetter(
+   f.name,
+ )}Supported } from "thirdweb/extensions/${extensionName}";
+ * 
+ * const supported = await is${uppercaseFirstLetter(f.name)}Supported(contract);
+ * \`\`\`
+ */
+export async function is${uppercaseFirstLetter(f.name)}Supported(contract: ThirdwebContract<any>) {
+  return detectMethod({contract, method: [FN_SELECTOR, FN_INPUTS, FN_OUTPUTS] as const});
+}
+
 ${
   f.inputs.length > 0
     ? `/**
@@ -172,9 +192,31 @@ export function encode${uppercaseFirstLetter(
 `
     : ""
 }
-
-
-
+${
+  f.inputs.length > 0
+    ? `/**
+ * Encodes the "${f.name}" function into a Hex string with its parameters.
+ * @param options - The options for the ${f.name} function.
+ * @returns The encoded hexadecimal string.
+ * @extension ${extensionName.toUpperCase()}
+ * @example
+ * \`\`\`ts
+ * import { encode${uppercaseFirstLetter(
+   f.name,
+ )} } "thirdweb/extensions/${extensionName}";
+ * const result = encode${uppercaseFirstLetter(f.name)}({\n * ${f.inputs
+   .map((x) => ` ${removeLeadingUnderscore(x.name)}: ...,`)
+   .join("\n * ")}\n * });
+ * \`\`\`
+ */
+export function encode${uppercaseFirstLetter(f.name)}(options: ${inputTypeName}) {
+  \/\/ we do a "manual" concat here to avoid the overhead of the "concatHex" function
+  \/\/ we can do this because we know the specific formats of the values
+  return FN_SELECTOR + encode${uppercaseFirstLetter(f.name)}Params(options).slice(2) as \`\${typeof FN_SELECTOR}\${string}\`;
+}
+`
+    : ""
+}
 /**
  * Calls the "${f.name}" function on the contract.
  * @param options - The options for the "${f.name}" function.
@@ -255,6 +297,8 @@ ${
 import type { Hex } from "../../../../../utils/encoding/hex.js";`
     : ""
 }
+import type { ThirdwebContract } from "../../../../../contract/contract.js";
+import { detectMethod } from "../../../../../utils/bytecode/detectExtension.js";
 
 ${
   f.inputs.length > 0
@@ -278,6 +322,24 @@ export const FN_SELECTOR = "${preparedMethod[0]}" as const;
 const FN_INPUTS = ${JSON.stringify(preparedMethod[1], null, 2)} as const;
 const FN_OUTPUTS = ${JSON.stringify(preparedMethod[2], null, 2)} as const;
 
+/**
+ * Checks if the \`${f.name}\` method is supported by the given contract.
+ * @param contract The ThirdwebContract.
+ * @returns A promise that resolves to a boolean indicating if the \`${f.name}\` method is supported.
+ * @extension ERC721
+ * @example
+ * \`\`\`ts
+ * import { is${uppercaseFirstLetter(
+   f.name,
+ )}Supported } from "thirdweb/extensions/${extensionName}";
+ * 
+ * const supported = await is${uppercaseFirstLetter(f.name)}Supported(contract);
+ * \`\`\`
+ */
+export async function is${uppercaseFirstLetter(f.name)}Supported(contract: ThirdwebContract<any>) {
+  return detectMethod({contract, method: [FN_SELECTOR, FN_INPUTS, FN_OUTPUTS] as const});
+}
+
 ${
   f.inputs.length > 0
     ? `/**
@@ -305,7 +367,33 @@ export function encode${uppercaseFirstLetter(
 `
     : ""
 }
-
+${
+  f.inputs.length > 0
+    ? `/**
+ * Encodes the "${f.name}" function into a Hex string with its parameters.
+ * @param options - The options for the ${f.name} function.
+ * @returns The encoded hexadecimal string.
+ * @extension ${extensionName.toUpperCase()}
+ * @example
+ * \`\`\`ts
+ * import { encode${uppercaseFirstLetter(
+   f.name,
+ )} } "thirdweb/extensions/${extensionName}";
+ * const result = encode${uppercaseFirstLetter(f.name)}({\n * ${f.inputs
+   .map((x) => ` ${removeLeadingUnderscore(x.name)}: ...,`)
+   .join("\n * ")}\n * });
+ * \`\`\`
+ */
+export function encode${uppercaseFirstLetter(
+        f.name,
+      )}(options: ${uppercaseFirstLetter(f.name)}Params) {
+  \/\/ we do a "manual" concat here to avoid the overhead of the "concatHex" function
+  \/\/ we can do this because we know the specific formats of the values
+  return FN_SELECTOR + encode${uppercaseFirstLetter(f.name)}Params(options).slice(2) as \`\${typeof FN_SELECTOR}\${string}\`;
+}
+`
+    : ""
+}
 ${
   f.outputs.length > 0
     ? `/**

packages/thirdweb/src/abi/encode.ts

@@ -3,8 +3,9 @@ import type {
   AbiParameter,
   AbiParametersToPrimitiveTypes,
 } from "abitype";
-import { concatHex, toFunctionSelector } from "viem";
+import { toFunctionSelector } from "viem";
 import { encodeAbiParameters } from "../utils/abi/encodeAbiParameters.js";
+import { concatHex } from "../utils/encoding/helpers/concat-hex.js";
 
 /**
  * Encodes an ABI function with its arguments into a hexadecimal string.

packages/thirdweb/src/contract/deployment/deploy-with-abi.ts

@@ -3,10 +3,10 @@ import type {
   AbiParameter,
   AbiParametersToPrimitiveTypes,
 } from "abitype";
-import { concatHex } from "viem";
 import { prepareTransaction } from "../../transaction/prepare-transaction.js";
 import { encodeAbiParameters } from "../../utils/abi/encodeAbiParameters.js";
 import { ensureBytecodePrefix } from "../../utils/bytecode/prefix.js";
+import { concatHex } from "../../utils/encoding/helpers/concat-hex.js";
 import { type Hex, isHex } from "../../utils/encoding/hex.js";
 import type { Prettify } from "../../utils/type-utils.js";
 import type { ClientAndChain } from "../../utils/types.js";

packages/thirdweb/src/exports/thirdweb.ts

@@ -206,6 +206,7 @@ export {
   type ToHexParameters,
   type Uint8ArrayToHexOpts,
 } from "../utils/encoding/hex.js";
+export { concatHex } from "../utils/encoding/helpers/concat-hex.js";
 
 // bytes
 // to

packages/thirdweb/src/exports/utils.ts

@@ -74,6 +74,7 @@ export {
   type ToHexParameters,
   type Uint8ArrayToHexOpts,
 } from "../utils/encoding/hex.js";
+export { concatHex } from "../utils/encoding/helpers/concat-hex.js";
 
 // bytes
 // to