@zoralabs/protocol-sdk 0.5.15 → 0.5.17

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,GAAG,EACH,OAAO,EAEP,KAAK,EACL,oBAAoB,EACpB,oBAAoB,EACpB,0BAA0B,EAC3B,MAAM,MAAM,CAAC;AAEd,eAAO,MAAM,8BAA8B,0fAmBlC,CAAC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,GAAG,EACH,OAAO,EAEP,KAAK,EACL,oBAAoB,EACpB,oBAAoB,EACpB,YAAY,IAAI,gBAAgB,EAChC,0BAA0B,EAC1B,SAAS,EAGV,MAAM,MAAM,CAAC;AACd,OAAO,EACL,WAAW,EAEZ,MAAM,sBAAsB,CAAC;AAE9B,eAAO,MAAM,8BAA8B,0fAmBlC,CAAC;AAEV,MAAM,MAAM,YAAY,GAAG,gBAAgB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;AAE9D,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,KAAK,CAAC;IACb,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,UAAU,CAAC,EAAE,WAAW,CAAC;CAC1B,CAAC;AAEF,wBAAgB,WAAW,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,EAAE,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAO5E"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zoralabs/protocol-sdk",
-  "version": "0.5.15",
+  "version": "0.5.17",
   "repository": "https://github.com/ourzora/zora-protocol",
   "license": "MIT",
   "type": "module",
@@ -28,7 +28,7 @@
     "@zoralabs/protocol-deployments": "*"
   },
   "peerDependencies": {
-    "viem": "^2.9.19"
+    "viem": "^2.11.1"
   },
   "devDependencies": {
     "@lavamoat/preinstall-always-fail": "2.0.0",

package/src/apis/generated/premint-api-types.ts

@@ -71,6 +71,11 @@ export interface components {
       contractURI: string;
       /** Contractname */
       contractName: string;
+      /**
+       * Additionaladmins
+       * @default []
+       */
+      additionalAdmins?: string[];
     };
     /** HTTPValidationError */
     HTTPValidationError: {
@@ -187,7 +192,7 @@ export interface components {
      *     ...:     other: str = "default"
      */
     PremintRequest: {
-      collection: components["schemas"]["CollectionCreationConfig"];
+      collection?: components["schemas"]["CollectionCreationConfig"];
       /** Premint */
       premint:
         | components["schemas"]["PremintConfigV1"]
@@ -195,6 +200,8 @@ export interface components {
       chain_name: components["schemas"]["ChainName"];
       /** Signature */
       signature: string;
+      /** Collection Address */
+      collection_address?: string;
     };
     /**
      * PremintSignature
@@ -209,7 +216,7 @@ export interface components {
      *     ...:     other: str = "default"
      */
     PremintSignature: {
-      collection: components["schemas"]["CollectionCreationConfig"];
+      collection?: components["schemas"]["CollectionCreationConfig"];
       /** Premint */
       premint:
         | components["schemas"]["PremintConfigV1"]

package/src/create/1155-create-helper.test.ts

@@ -12,7 +12,9 @@ const demoContractMetadataURI = "ipfs://DUMMY/contract.json";
 describe("create-helper", () => {
   anvilTest(
     "creates a new contract given arguments",
-    async ({ viemClients: { testClient, publicClient, walletClient } }) => {
+    async ({
+      viemClients: { testClient, publicClient, walletClient, chain },
+    }) => {
       const addresses = await walletClient.getAddresses();
       const creatorAddress = addresses[0]!;
       await testClient.setBalance({
@@ -20,6 +22,7 @@ describe("create-helper", () => {
         value: parseEther("1"),
       });
       const creatorClient = create1155CreatorClient({
+        chain,
         publicClient: publicClient,
       });
       const { request } = await creatorClient.createNew1155Token({
@@ -43,11 +46,12 @@ describe("create-helper", () => {
   );
   anvilTest(
     "creates a new contract, than creates a new token on this existing contract",
-    async ({ viemClients: { publicClient, walletClient } }) => {
+    async ({ viemClients: { publicClient, walletClient, chain } }) => {
       const addresses = await walletClient.getAddresses();
       const creatorAccount = addresses[0]!;
 
       const creatorClient = create1155CreatorClient({
+        chain,
         publicClient: publicClient,
       });
 
@@ -103,7 +107,9 @@ describe("create-helper", () => {
   );
   anvilTest(
     "creates a new token with a create referral address",
-    async ({ viemClients: { testClient, publicClient, walletClient } }) => {
+    async ({
+      viemClients: { testClient, publicClient, walletClient, chain },
+    }) => {
       const addresses = await walletClient.getAddresses();
       const creatorAddress = addresses[0]!;
       await testClient.setBalance({
@@ -111,6 +117,7 @@ describe("create-helper", () => {
         value: parseEther("1"),
       });
       const creatorClient = create1155CreatorClient({
+        chain,
         publicClient: publicClient,
       });
       const { request } = await creatorClient.createNew1155Token({

package/src/create/1155-create-helper.ts

@@ -8,13 +8,17 @@ import type {
   Account,
   Address,
   Hex,
-  PublicClient,
   SimulateContractParameters,
   TransactionReceipt,
 } from "viem";
 import { decodeEventLog, encodeFunctionData, zeroAddress } from "viem";
 import { OPEN_EDITION_MINT_SIZE } from "../constants";
-import { makeSimulateContractParamaters } from "src/utils";
+import {
+  makeSimulateContractParamaters,
+  ClientConfig,
+  PublicClient,
+  setupClient,
+} from "src/utils";
 
 // Sales end forever amount (uint64 max)
 const SALE_END_FOREVER = 18446744073709551615n;
@@ -242,11 +246,8 @@ type CreateNew1155TokenReturn = {
   contractExists: boolean;
 };
 
-export function create1155CreatorClient({
-  publicClient,
-}: {
-  publicClient: PublicClient;
-}) {
+export function create1155CreatorClient(clientConfig: ClientConfig) {
+  const { publicClient } = setupClient(clientConfig);
   async function createNew1155Token({
     contract,
     tokenMetadataURI,

package/src/index.ts

@@ -19,3 +19,9 @@ export * from "./mints/mints-queries";
 export * from "./mints/mints-contracts";
 
 export * from "./mints/mints-eth-unwrapper-and-caller";
+
+export {
+  type ContractCreationConfigWithOptionalAdditionalAdmins,
+  type ContractCreationConfigOrAddress,
+  type ContractCreationConfigAndAddress,
+} from "./premint/contract-types";

package/src/mint/mint-client.ts

@@ -1,12 +1,9 @@
 import {
   Address,
   Chain,
-  PublicClient,
-  createPublicClient,
   encodeAbiParameters,
   parseAbiParameters,
   zeroAddress,
-  http,
   Account,
   SimulateContractParameters,
 } from "viem";
@@ -19,12 +16,17 @@ import {
 import { IHttpClient } from "src/apis/http-api-base";
 import { zora721Abi } from "src/constants";
 import { GenericTokenIdTypes } from "src/types";
-import { makeSimulateContractParamaters } from "src/utils";
 import {
   MintAPIClient,
   SalesConfigAndTokenInfo,
   SaleType,
 } from "./mint-api-client";
+import {
+  makeSimulateContractParamaters,
+  ClientConfig,
+  setupClient,
+  PublicClient,
+} from "src/utils";
 
 class MintError extends Error {}
 class MintInactiveError extends Error {}
@@ -35,44 +37,50 @@ export const Errors = {
 };
 
 type MintArguments = {
+  /** Quantity of tokens to mint */
   quantityToMint: number;
+  /** Comment to add to the mint */
   mintComment?: string;
+  /** Optional address to receive the mint referral reward */
   mintReferral?: Address;
+  /** Address to receive the minted tokens */
   mintToAddress: Address;
   saleType?: SaleType;
 };
 
+type MintTokenParams = {
+  /** Account to execute the mint */
+  minterAccount: Address | Account;
+  /** Contract address of token to mint */
+  tokenAddress: Address;
+  /** Id of token to mint */
+  tokenId?: GenericTokenIdTypes;
+  /** Mint settings */
+  mintArguments: MintArguments;
+};
+
 class MintClient {
   readonly apiClient: MintAPIClient;
   readonly publicClient: PublicClient;
 
   constructor(
     chain: Chain,
-    publicClient?: PublicClient,
-    httpClient?: IHttpClient,
+    publicClient: PublicClient,
+    httpClient: IHttpClient,
   ) {
     this.apiClient = new MintAPIClient(chain.id, httpClient);
-    this.publicClient =
-      publicClient || createPublicClient({ chain, transport: http() });
+    this.publicClient = publicClient;
   }
 
   /**
    * Returns the parameters needed to prepare a transaction mint a token.
-   * @param param0.minterAccount The account that will mint the token.
-   * @param param0.mintable The mintable token to mint.
-   * @param param0.mintArguments The arguments for the mint (mint recipient, comment, mint referral, quantity to mint)
-   * @returns
+   *
+   * @param parameters - Parameters for collecting the token {@link MintTokenParams}
+   * @returns Parameters for simulating/executing the mint transaction
    */
-  async makePrepareMintTokenParams({
-    ...rest
-  }: {
-    minterAccount: Address | Account;
-    tokenAddress: Address;
-    tokenId?: GenericTokenIdTypes;
-    mintArguments: MintArguments;
-  }) {
+  async makePrepareMintTokenParams(parameters: MintTokenParams) {
     return makePrepareMintTokenParams({
-      ...rest,
+      ...parameters,
       apiClient: this.apiClient,
       publicClient: this.publicClient,
     });
@@ -86,15 +94,8 @@ class MintClient {
  * @param param0.httpClient Optional http client to override post, get, and retry methods
  * @returns
  */
-export function createMintClient({
-  chain,
-  publicClient,
-  httpClient,
-}: {
-  chain: Chain;
-  publicClient?: PublicClient;
-  httpClient?: IHttpClient;
-}) {
+export function createMintClient(clientConfig: ClientConfig) {
+  const { chain, publicClient, httpClient } = setupClient(clientConfig);
   return new MintClient(chain, publicClient, httpClient);
 }
 

package/src/mints/mints-contracts.test.ts

@@ -18,7 +18,6 @@ import {
   Address,
   BaseError,
   ContractFunctionRevertedError,
-  PublicClient,
   WalletClient,
   parseEther,
 } from "viem";
@@ -39,8 +38,9 @@ import {
   getFixedPricedMinter,
   waitForSuccess,
 } from "src/test-utils";
+import { PublicClient } from "src/utils";
 
-const mintsMainnetDeployedBlock = 12990454;
+const mintsMainnetDeployedBlock = 15372992;
 
 const anvilTest = makeAnvilTest({
   forkUrl: forkUrls.zoraMainnet,

package/src/premint/contract-types.ts

@@ -1,7 +1,38 @@
-import { PremintConfigVersion as PremintConfigVersionOrig } from "@zoralabs/protocol-deployments";
+import {
+  ContractCreationConfig,
+  PremintConfigVersion as PremintConfigVersionOrig,
+} from "@zoralabs/protocol-deployments";
+import { Address } from "viem";
 
 export enum PremintConfigVersion {
   V1 = PremintConfigVersionOrig.V1,
   V2 = PremintConfigVersionOrig.V2,
   V3 = PremintConfigVersionOrig.V3,
 }
+
+export type ContractCreationConfigWithOptionalAdditionalAdmins = Omit<
+  ContractCreationConfig,
+  "additionalAdmins"
+> & {
+  /** Optional: if there are additional admins accounts that should be added as contract wide admins upon contract creation. */
+  additionalAdmins?: Address[];
+};
+
+export type ContractCreationConfigAndAddress = {
+  /** Parameters for creating the contract for new premints. */
+  collection?: ContractCreationConfigWithOptionalAdditionalAdmins;
+  /** Premint collection address */
+  collectionAddress: Address;
+};
+
+export type ContractCreationConfigOrAddress =
+  | {
+      /** Parameters for creating the contract for new premints. */
+      collection: ContractCreationConfigWithOptionalAdditionalAdmins;
+      collectionAddress?: undefined;
+    }
+  | {
+      collection?: undefined;
+      /** Premint collection address */
+      collectionAddress: Address;
+    };

package/src/premint/conversions.ts

@@ -10,14 +10,21 @@ import {
   PremintConfigWithVersion,
 } from "@zoralabs/protocol-deployments";
 import { PremintSignatureGetResponse } from "./premint-api-client";
+import { ContractCreationConfigOrAddress } from "./contract-types";
 
 export const convertCollectionFromApi = (
   collection: PremintSignatureGetResponse["collection"],
-): ContractCreationConfig => ({
-  ...collection,
-  contractAdmin: collection.contractAdmin as Address,
-  additionalAdmins: [],
-});
+): ContractCreationConfig | undefined => {
+  if (!collection) return undefined;
+
+  return {
+    additionalAdmins:
+      (collection.additionalAdmins as Address[] | undefined) || [],
+    contractAdmin: collection.contractAdmin as Address,
+    contractName: collection.contractName,
+    contractURI: collection.contractURI,
+  };
+};
 
 /**
  * Convert server to on-chain types for a premint
@@ -82,6 +89,7 @@ export const convertGetPremintApiResponse = (
 ) => ({
   ...convertPremintFromApi(response.premint),
   collection: convertCollectionFromApi(response.collection),
+  collectionAddress: response.collection_address as Address,
   signature: response.signature as Hex,
 });
 
@@ -143,20 +151,24 @@ export type PremintSignatureResponse =
  */
 export const encodePostSignatureInput = <T extends PremintConfigVersion>({
   collection,
+  collectionAddress,
   premintConfigVersion,
   premintConfig,
   signature,
   chainId,
 }: {
-  collection: ContractCreationConfig;
   signature: Hex;
   chainId: number;
-} & PremintConfigWithVersion<T>): PremintSignatureRequestBody => ({
+} & PremintConfigWithVersion<T> &
+  ContractCreationConfigOrAddress): PremintSignatureRequestBody => ({
   premint: encodePremintForAPI({
     premintConfig,
     premintConfigVersion,
   }),
   signature,
-  collection,
+  collection: collection as
+    | PremintSignatureRequestBody["collection"]
+    | undefined,
+  collection_address: collectionAddress,
   chain_name: networkConfigByChain[chainId]!.zoraBackendChainName,
 });

package/src/premint/premint-api-client.ts

@@ -19,6 +19,7 @@ import {
   convertGetPremintApiResponse,
   encodePostSignatureInput,
 } from "./conversions";
+import { ContractCreationConfigOrAddress } from "./contract-types";
 
 type PremintNextUIDGetType =
   paths["/signature/{chain_name}/{collection_address}/next_uid"]["get"];
@@ -91,16 +92,14 @@ class PremintAPIClient {
     this.networkConfig = getApiNetworkConfigForChain(chainId);
   }
   postSignature = async <T extends PremintConfigVersion>({
-    collection,
     signature,
-    ...premintConfigAndVersion
+    ...rest
   }: {
-    collection: ContractCreationConfig;
     signature: Hex;
-  } & PremintConfigWithVersion<T>): Promise<PremintSignatureResponse> => {
+  } & PremintConfigWithVersion<T> &
+    ContractCreationConfigOrAddress): Promise<PremintSignatureResponse> => {
     const data = encodePostSignatureInput({
-      collection,
-      ...premintConfigAndVersion,
+      ...rest,
       chainId: this.networkConfig.chainId,
       signature,
     });
@@ -128,7 +127,8 @@ class PremintAPIClient {
   }): Promise<
     {
       signature: Hex;
-      collection: ContractCreationConfig;
+      collection: ContractCreationConfig | undefined;
+      collectionAddress: Address;
     } & PremintConfigAndVersion
   > => {
     const response = await getSignature({