@zoralabs/protocol-sdk 0.5.2 → 0.5.3-MINT.0

package/.turbo/turbo-build.log

@@ -8,9 +8,9 @@ $ tsup
 CLI Cleaning output folder
 CJS Build start
 ESM Build start
-ESM dist/index.js     46.16 KB
-ESM dist/index.js.map 96.98 KB
-ESM ⚡️ Build success in 54ms
-CJS dist/index.cjs     49.78 KB
-CJS dist/index.cjs.map 96.89 KB
-CJS ⚡️ Build success in 55ms
+ESM dist/index.js     46.17 KB
+ESM dist/index.js.map 97.00 KB
+ESM ⚡️ Build success in 47ms
+CJS dist/index.cjs     50.09 KB
+CJS dist/index.cjs.map 96.94 KB
+CJS ⚡️ Build success in 47ms

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @zoralabs/protocol-sdk
 
+## 0.5.3-MINT.0
+
+### Patch Changes
+
+- Updated dependencies [8dc4279c]
+  - @zoralabs/protocol-deployments@0.0.14-MINT.0
+
 ## 0.5.2
 
 ### Patch Changes

package/README.md

@@ -1,6 +1,6 @@
 # Zora Protocol SDK
 
-Protocol SDK allows users to create tokens using the Zora Protocol, and mint them.
+Protocol SDK allows developers to create tokens using the Zora Protocol and mint them.
 
 ## Installing
 
@@ -9,13 +9,13 @@ Protocol SDK allows users to create tokens using the Zora Protocol, and mint the
 - `npm install viem`
 - `npm install `
 
-### Creating a mint from an on-chain contract:
+### Creating a mint from an on-chain contract
 
 #### Using viem
- 
+
 ```ts
-import {createMintClient} from "@zoralabs/protocol-sdk";
-import type {Address, PublicClient, WalletClient} from "viem";
+import { createMintClient } from "@zoralabs/protocol-sdk";
+import type { Address, PublicClient, WalletClient } from "viem";
 
 async function mintNFT({
   walletClient,
@@ -41,7 +41,7 @@ async function mintNFT({
   // optional address that will receive a mint referral reward
   mintReferral?: Address;
 }) {
-  const mintClient = createMintClient({chain: walletClient.chain!});
+  const mintClient = createMintClient({ chain: walletClient.chain! });
 
   // prepare the mint transaction, which can be simulated via an rpc with the public client.
   const prepared = await mintClient.makePrepareMintTokenParams({
@@ -69,30 +69,47 @@ async function mintNFT({
   const txHash = await walletClient.writeContract(request);
 
   // wait for the transaction to be complete
-  await publicClient.waitForTransactionReceipt({hash: txHash});
+  await publicClient.waitForTransactionReceipt({ hash: txHash });
 }
 ```
 
 #### Using wagmi
 
 ```tsx
-import {createMintClient} from "@zoralabs/protocol-sdk";
-import {useEffect, useMemo, useState} from "react";
-import {BaseError, SimulateContractParameters, stringify} from "viem";
-import {Address, useAccount, useContractWrite, useNetwork, usePrepareContractWrite, usePublicClient, useWaitForTransaction} from "wagmi";
+import { createMintClient } from "@zoralabs/protocol-sdk";
+import { useEffect, useMemo, useState } from "react";
+import { BaseError, SimulateContractParameters, stringify } from "viem";
+import {
+  Address,
+  useAccount,
+  useContractWrite,
+  useNetwork,
+  usePrepareContractWrite,
+  usePublicClient,
+  useWaitForTransaction,
+} from "wagmi";
 
 // custom hook that gets the mintClient for the current chain
 const useMintClient = () => {
   const publicClient = usePublicClient();
 
-  const {chain} = useNetwork();
+  const { chain } = useNetwork();
 
-  const mintClient = useMemo(() => chain && createMintClient({chain, publicClient}), [chain, publicClient]);
+  const mintClient = useMemo(
+    () => chain && createMintClient({ chain, publicClient }),
+    [chain, publicClient],
+  );
 
   return mintClient;
 };
 
-export const Mint = ({tokenId, tokenContract}: {tokenId: string; tokenContract: Address}) => {
+export const Mint = ({
+  tokenId,
+  tokenContract,
+}: {
+  tokenId: string;
+  tokenContract: Address;
+}) => {
   // call custom hook to get the mintClient
   const mintClient = useMintClient();
 
@@ -102,7 +119,7 @@ export const Mint = ({tokenId, tokenContract}: {tokenId: string; tokenContract:
   // params for the prepare contract write hook
   const [params, setParams] = useState<SimulateContractParameters>();
 
-  const {address} = useAccount();
+  const { address } = useAccount();
 
   useEffect(() => {
     if (!mintClient || !address) return;
@@ -124,10 +141,14 @@ export const Mint = ({tokenId, tokenContract}: {tokenId: string; tokenContract:
     makeParams();
   }, [mintClient, address, quantityToMint]);
 
-  const {config} = usePrepareContractWrite(params);
+  const { config } = usePrepareContractWrite(params);
 
-  const {write, data, error, isLoading, isError} = useContractWrite(config);
-  const {data: receipt, isLoading: isPending, isSuccess} = useWaitForTransaction({hash: data?.hash});
+  const { write, data, error, isLoading, isError } = useContractWrite(config);
+  const {
+    data: receipt,
+    isLoading: isPending,
+    isSuccess,
+  } = useWaitForTransaction({ hash: data?.hash });
 
   return (
     <>
@@ -139,7 +160,10 @@ export const Mint = ({tokenId, tokenContract}: {tokenId: string; tokenContract:
         }}
       >
         {/* input for quantity to mint: */}
-        <input placeholder="quantity to mint" onChange={(e) => setQuantityToMint(Number(e.target.value))} />
+        <input
+          placeholder="quantity to mint"
+          onChange={(e) => setQuantityToMint(Number(e.target.value))}
+        />
         <button disabled={!write} type="submit">
           Mint
         </button>
@@ -161,7 +185,7 @@ export const Mint = ({tokenId, tokenContract}: {tokenId: string; tokenContract:
 };
 ```
 
-### Creating an 1155 contract:
+### Creating an 1155 contract
 
 If an object with {name, uri} is passed in to this helper, it uses the creatorAccount and those values to either 1) create or 2) mint to that existing contract.
 
@@ -195,11 +219,11 @@ export async function createContract({
 }
 ```
 
-### Creating a token for free (gasless creation):
+### Premint: create a mint without paying gas
 
 ```ts
-import {createPremintClient} from "@zoralabs/protocol-sdk";
-import type {Address, PublicClient, WalletClient} from "viem";
+import { createPremintClient } from "@zoralabs/protocol-sdk";
+import type { Address, PublicClient, WalletClient } from "viem";
 
 async function createForFree({
   walletClient,
@@ -213,7 +237,10 @@ async function createForFree({
   // address of the token contract
   creatorAccount: Address;
 }) {
-  const premintClient = createPremintClient({chain: walletClient.chain!, publicClient});
+  const premintClient = createPremintClient({
+    chain: walletClient.chain!,
+    publicClient,
+  });
 
   // create and sign a free token creation.
   const createdPremint = await premintClient.createPremint({
@@ -225,11 +252,13 @@ async function createForFree({
     collection: {
       contractAdmin: creatorAccount,
       contractName: "Testing Contract",
-      contractURI: "ipfs://bafkreiainxen4b4wz4ubylvbhons6rembxdet4a262nf2lziclqvv7au3e",
+      contractURI:
+        "ipfs://bafkreiainxen4b4wz4ubylvbhons6rembxdet4a262nf2lziclqvv7au3e",
     },
     // token info of token to create
     tokenCreationConfig: {
-      tokenURI: "ipfs://bafkreice23maski3x52tsfqgxstx3kbiifnt5jotg3a5ynvve53c4soi2u",
+      tokenURI:
+        "ipfs://bafkreice23maski3x52tsfqgxstx3kbiifnt5jotg3a5ynvve53c4soi2u",
     },
   });
 
@@ -243,19 +272,21 @@ async function createForFree({
     tokenContractAddress: premintCollectionAddress,
   };
 }
-
 ```
 
-### Updating a token that was created for free (before it was brought onchain):
+### Updating a premint before it is brought onchain
 
-Before a token that was created for free is brought onchain, it can be updated by the original creator of that token, by having that creator sign a message indicating the update. This is useful for updating the tokenURI, other metadata, or token sale configuration (price, duration, limits, etc.):
+Before a premint is brought onchain, it can be updated by the original creator of that token, by having that creator sign a message indicating the update. This is useful for updating the tokenURI, other metadata, or token sale configuration (price, duration, limits, etc.):
 
 ```ts
-import {createPremintClient} from "@zoralabs/protocol-sdk";
-import type {Address, PublicClient, WalletClient} from "viem";
+import { createPremintClient } from "@zoralabs/protocol-sdk";
+import type { Address, PublicClient, WalletClient } from "viem";
 
-async function updateCreatedForFreeToken(walletClient: WalletClient, premintUid: number) {
-  const premintClient = createPremintClient({chain: walletClient.chain!});
+async function updateCreatedForFreeToken(
+  walletClient: WalletClient,
+  premintUid: number,
+) {
+  const premintClient = createPremintClient({ chain: walletClient.chain! });
 
   // sign a message to update the created for free token, and store the update
   await premintClient.updatePremint({
@@ -265,19 +296,20 @@ async function updateCreatedForFreeToken(walletClient: WalletClient, premintUid:
     walletClient,
     // Token information, falls back to defaults set in DefaultMintArguments.
     tokenConfigUpdates: {
-      tokenURI: "ipfs://bafkreice23maski3x52tsfqgxstx3kbiifnt5jotg3a5ynvve53c4soi2u",
+      tokenURI:
+        "ipfs://bafkreice23maski3x52tsfqgxstx3kbiifnt5jotg3a5ynvve53c4soi2u",
     },
   });
 }
 ```
 
-### Deleting a token that was created for free (before it was brought onchain):
+### Deleting a premint before it is brought onchain
 
-Before a token that was created for free is brought onchain, it can be deleted by the original creator of that token, by having that creator sign a message indicating the deletion:
+Before a premint is brought onchain, it can be deleted by the original creator of that token, by having that creator sign a message indicating the deletion:
 
 ```ts
 async function deleteCreatedForFreeToken(walletClient: WalletClient) {
-  const premintClient = createPremintClient({chain: walletClient.chain!});
+  const premintClient = createPremintClient({ chain: walletClient.chain! });
 
   // sign a message to delete the premint, and store the deletion
   await premintClient.deletePremint({
@@ -290,14 +322,18 @@ async function deleteCreatedForFreeToken(walletClient: WalletClient) {
 }
 ```
 
-### Minting a token that was created for free (and bringing it onchain):
+### Minting a premint and bringing it onchain
 
 ```ts
-import {createPremintClient} from "@zoralabs/protocol-sdk";
-import type {Address, PublicClient, WalletClient} from "viem";
+import { createPremintClient } from "@zoralabs/protocol-sdk";
+import type { Address, PublicClient, WalletClient } from "viem";
 
-async function mintCreatedForFreeToken(walletClient: WalletClient, publicClient: PublicClient, minterAccount: Address) {
-  const premintClient = createPremintClient({chain: walletClient.chain!});
+async function mintCreatedForFreeToken(
+  walletClient: WalletClient,
+  publicClient: PublicClient,
+  minterAccount: Address,
+) {
+  const premintClient = createPremintClient({ chain: walletClient.chain! });
 
   const simulateContractParameters = await premintClient.makeMintParameters({
     minterAccount,
@@ -310,15 +346,19 @@ async function mintCreatedForFreeToken(walletClient: WalletClient, publicClient:
   });
 
   // simulate the transaction and get any validation errors
-  const {request} = await publicClient.simulateContract(simulateContractParameters);
+  const { request } = await publicClient.simulateContract(
+    simulateContractParameters,
+  );
 
   // submit the transaction to the network
   const txHash = await walletClient.writeContract(request);
 
   // wait for the transaction to be complete
-  const receipt = await publicClient.waitForTransactionReceipt({hash: txHash});
+  const receipt = await publicClient.waitForTransactionReceipt({
+    hash: txHash,
+  });
 
-  const {urls} = await premintClient.getDataFromPremintReceipt(receipt);
+  const { urls } = await premintClient.getDataFromPremintReceipt(receipt);
 
   // block explorer url:
   console.log(urls.explorer);
@@ -327,4 +367,4 @@ async function mintCreatedForFreeToken(walletClient: WalletClient, publicClient:
   // manage url:
   console.log(urls.zoraManage);
 }
-```
+```

package/dist/index.cjs

@@ -67,10 +67,10 @@ module.exports = __toCommonJS(src_exports);
 
 // src/premint/premint-client.ts
 var import_viem4 = require("viem");
-var import_deployments2 = require("@zoralabs/1155-deployments");
+var import_protocol_deployments2 = require("@zoralabs/protocol-deployments");
 
 // src/premint/preminter.ts
-var import_deployments = require("@zoralabs/1155-deployments");
+var import_protocol_deployments = require("@zoralabs/protocol-deployments");
 var import_viem = require("viem");
 
 // src/premint/contract-types.ts
@@ -130,7 +130,7 @@ var PremintConfigVersion = /* @__PURE__ */ ((PremintConfigVersion2) => {
 })(PremintConfigVersion || {});
 
 // src/premint/preminter.ts
-var getPremintExecutorAddress = () => import_deployments.zoraCreator1155PremintExecutorImplAddress[999];
+var getPremintExecutorAddress = () => import_protocol_deployments.zoraCreator1155PremintExecutorImplAddress[999];
 var premintTypedDataDefinition = ({
   verifyingContract,
   chainId,
@@ -167,7 +167,7 @@ async function isAuthorizedToCreatePremint({
   signer
 }) {
   return await publicClient.readContract({
-    abi: import_deployments.zoraCreator1155PremintExecutorImplABI,
+    abi: import_protocol_deployments.zoraCreator1155PremintExecutorImplABI,
     address: getPremintExecutorAddress(),
     functionName: "isAuthorizedToCreatePremint",
     args: [signer, collection.contractAdmin, collectionAddress]
@@ -283,7 +283,7 @@ var supportedPremintVersions = async ({
   publicClient
 }) => {
   return await publicClient.readContract({
-    abi: import_deployments.zoraCreator1155PremintExecutorImplABI,
+    abi: import_protocol_deployments.zoraCreator1155PremintExecutorImplABI,
     address: getPremintExecutorAddress(),
     functionName: "supportedPremintSignatureVersions",
     args: [tokenContract]
@@ -302,7 +302,7 @@ async function getPremintCollectionAddress({
 }) {
   return publicClient.readContract({
     address: getPremintExecutorAddress(),
-    abi: import_deployments.zoraCreator1155PremintExecutorImplABI,
+    abi: import_protocol_deployments.zoraCreator1155PremintExecutorImplABI,
     functionName: "getContractAddress",
     args: [collection]
   });
@@ -350,7 +350,7 @@ async function getPremintMintFee({
   try {
     return await publicClient.readContract({
       address: getPremintExecutorAddress(),
-      abi: import_deployments.zoraCreator1155PremintExecutorImplABI,
+      abi: import_protocol_deployments.zoraCreator1155PremintExecutorImplABI,
       functionName: "mintFee",
       args: [tokenContract]
     });
@@ -379,7 +379,7 @@ function makeMintRewardsRecipient({
   return [mintReferral, platformReferral];
 }
 function getDefaultFixedPriceMinterAddress(chainId) {
-  return import_deployments.zoraCreatorFixedPriceSaleStrategyAddress[chainId];
+  return import_protocol_deployments.zoraCreatorFixedPriceSaleStrategyAddress[chainId];
 }
 
 // src/apis/http-api-base.ts
@@ -851,7 +851,7 @@ function getPremintedLogFromReceipt(receipt) {
   for (const data of receipt.logs) {
     try {
       const decodedLog = (0, import_viem4.decodeEventLog)({
-        abi: import_deployments2.zoraCreator1155PremintExecutorImplABI,
+        abi: import_protocol_deployments2.zoraCreator1155PremintExecutorImplABI,
         eventName: "PremintedV2",
         ...data
       });
@@ -1163,7 +1163,7 @@ var PremintClient = class {
     if (premintConfigVersion === "1" /* V1 */) {
       return {
         account: minterAccount,
-        abi: import_deployments2.zoraCreator1155PremintExecutorImplABI,
+        abi: import_protocol_deployments2.zoraCreator1155PremintExecutorImplABI,
         functionName: "premintV1",
         value,
         address: getPremintExecutorAddress(),
@@ -1178,7 +1178,7 @@ var PremintClient = class {
     } else if (premintConfigVersion === "2" /* V2 */) {
       return {
         account: minterAccount,
-        abi: import_deployments2.zoraCreator1155PremintExecutorImplABI,
+        abi: import_protocol_deployments2.zoraCreator1155PremintExecutorImplABI,
         functionName: "premintV2",
         value,
         address: getPremintExecutorAddress(),
@@ -1267,7 +1267,7 @@ async function signAndSubmitPremint({
 
 // src/mint/mint-client.ts
 var import_viem5 = require("viem");
-var import_deployments3 = require("@zoralabs/1155-deployments");
+var import_protocol_deployments3 = require("@zoralabs/protocol-deployments");
 var MintError = class extends Error {
 };
 var MintInactiveError = class extends Error {
@@ -1380,14 +1380,14 @@ async function makePrepareMint1155TokenParams({
     quantityToMint: mintQuantity
   }).totalCost;
   const result = {
-    abi: import_deployments3.zoraCreator1155ImplABI,
+    abi: import_protocol_deployments3.zoraCreator1155ImplABI,
     functionName: "mintWithRewards",
     account: minterAccount,
     value: mintValue,
     address: tokenAddress,
     /* args: minter, tokenId, quantity, minterArguments, mintReferral */
     args: [
-      salesConfigAndTokenInfo?.fixedPrice.address || import_deployments3.zoraCreatorFixedPriceSaleStrategyAddress[999],
+      salesConfigAndTokenInfo?.fixedPrice.address || import_protocol_deployments3.zoraCreatorFixedPriceSaleStrategyAddress[999],
       BigInt(tokenId),
       mintQuantity,
       (0, import_viem5.encodeAbiParameters)((0, import_viem5.parseAbiParameters)("address, string"), [
@@ -1401,7 +1401,7 @@ async function makePrepareMint1155TokenParams({
 }
 
 // src/create/1155-create-helper.ts
-var import_deployments4 = require("@zoralabs/1155-deployments");
+var import_protocol_deployments4 = require("@zoralabs/protocol-deployments");
 var import_viem6 = require("viem");
 var SALE_END_FOREVER = 18446744073709551615n;
 var ROYALTY_BPS_DEFAULT = 1e3;
@@ -1446,32 +1446,32 @@ function create1155TokenSetupArgs({
   };
   const setupActions = [
     (0, import_viem6.encodeFunctionData)({
-      abi: import_deployments4.zoraCreator1155ImplABI,
+      abi: import_protocol_deployments4.zoraCreator1155ImplABI,
       functionName: "assumeLastTokenIdMatches",
       args: [nextTokenId - 1n]
     }),
     createReferral ? (0, import_viem6.encodeFunctionData)({
-      abi: import_deployments4.zoraCreator1155ImplABI,
+      abi: import_protocol_deployments4.zoraCreator1155ImplABI,
       functionName: "setupNewTokenWithCreateReferral",
       args: [tokenMetadataURI, maxSupply, createReferral]
     }) : (0, import_viem6.encodeFunctionData)({
-      abi: import_deployments4.zoraCreator1155ImplABI,
+      abi: import_protocol_deployments4.zoraCreator1155ImplABI,
       functionName: "setupNewToken",
       args: [tokenMetadataURI, maxSupply]
     }),
     (0, import_viem6.encodeFunctionData)({
-      abi: import_deployments4.zoraCreator1155ImplABI,
+      abi: import_protocol_deployments4.zoraCreator1155ImplABI,
       functionName: "addPermission",
       args: [0n, fixedPriceMinterAddress, PERMISSION_BIT_MINTER]
     }),
     (0, import_viem6.encodeFunctionData)({
-      abi: import_deployments4.zoraCreator1155ImplABI,
+      abi: import_protocol_deployments4.zoraCreator1155ImplABI,
       functionName: "callSale",
       args: [
         nextTokenId,
         fixedPriceMinterAddress,
         (0, import_viem6.encodeFunctionData)({
-          abi: import_deployments4.zoraCreatorFixedPriceSaleStrategyABI,
+          abi: import_protocol_deployments4.zoraCreatorFixedPriceSaleStrategyABI,
           functionName: "setSale",
           args: [nextTokenId, salesConfigWithDefaults]
         })
@@ -1481,7 +1481,7 @@ function create1155TokenSetupArgs({
   if (mintToCreatorCount) {
     setupActions.push(
       (0, import_viem6.encodeFunctionData)({
-        abi: import_deployments4.zoraCreator1155ImplABI,
+        abi: import_protocol_deployments4.zoraCreator1155ImplABI,
         functionName: "adminMint",
         args: [account, nextTokenId, mintToCreatorCount, "0x"]
       })
@@ -1490,7 +1490,7 @@ function create1155TokenSetupArgs({
   if (royaltySettings) {
     setupActions.push(
       (0, import_viem6.encodeFunctionData)({
-        abi: import_deployments4.zoraCreator1155ImplABI,
+        abi: import_protocol_deployments4.zoraCreator1155ImplABI,
         functionName: "updateRoyaltiesForToken",
         args: [
           nextTokenId,
@@ -1509,7 +1509,7 @@ var getTokenIdFromCreateReceipt = (receipt) => {
   for (const data of receipt.logs) {
     try {
       const decodedLog = (0, import_viem6.decodeEventLog)({
-        abi: import_deployments4.zoraCreator1155ImplABI,
+        abi: import_protocol_deployments4.zoraCreator1155ImplABI,
         eventName: "SetupNewToken",
         ...data
       });
@@ -1525,9 +1525,9 @@ async function getContractExists(publicClient, contract, account) {
   let contractExists = false;
   if (typeof contract !== "string") {
     contractAddress = await publicClient.readContract({
-      abi: import_deployments4.zoraCreator1155FactoryImplABI,
+      abi: import_protocol_deployments4.zoraCreator1155FactoryImplABI,
       // Since this address is deterministic we can hardcode a chain id safely here.
-      address: import_deployments4.zoraCreator1155FactoryImplAddress[999],
+      address: import_protocol_deployments4.zoraCreator1155FactoryImplAddress[999],
       functionName: "deterministicContractAddress",
       args: [
         account,
@@ -1538,7 +1538,7 @@ async function getContractExists(publicClient, contract, account) {
     });
     try {
       await publicClient.readContract({
-        abi: import_deployments4.zoraCreator1155ImplABI,
+        abi: import_protocol_deployments4.zoraCreator1155ImplABI,
         address: contractAddress,
         functionName: "contractVersion"
       });
@@ -1573,14 +1573,14 @@ function create1155CreatorClient({
     let nextTokenId = 1n;
     if (contractExists) {
       nextTokenId = await publicClient.readContract({
-        abi: import_deployments4.zoraCreator1155ImplABI,
+        abi: import_protocol_deployments4.zoraCreator1155ImplABI,
         functionName: "nextTokenId",
         address: contractAddress
       });
     }
     const fixedPriceMinterAddress = await publicClient.readContract({
-      abi: import_deployments4.zoraCreator1155FactoryImplABI,
-      address: import_deployments4.zoraCreator1155FactoryImplAddress[999],
+      abi: import_protocol_deployments4.zoraCreator1155FactoryImplABI,
+      address: import_protocol_deployments4.zoraCreator1155FactoryImplAddress[999],
       functionName: "fixedPriceMinter"
     });
     let tokenSetupActions = create1155TokenSetupArgs({
@@ -1604,10 +1604,10 @@ function create1155CreatorClient({
     }
     if (!contractExists && typeof contract !== "string") {
       const request = {
-        abi: import_deployments4.zoraCreator1155FactoryImplABI,
+        abi: import_protocol_deployments4.zoraCreator1155FactoryImplABI,
         functionName: "createContractDeterministic",
         account,
-        address: import_deployments4.zoraCreator1155FactoryImplAddress[999],
+        address: import_protocol_deployments4.zoraCreator1155FactoryImplAddress[999],
         args: [
           contract.uri,
           contract.name,
@@ -1629,7 +1629,7 @@ function create1155CreatorClient({
       };
     } else if (contractExists) {
       const request = {
-        abi: import_deployments4.zoraCreator1155ImplABI,
+        abi: import_protocol_deployments4.zoraCreator1155ImplABI,
         functionName: "multicall",
         account,
         address: contractAddress,