@zoralabs/coins-sdk 0.0.2-sdkalpha.2 → 0.0.2-sdkalpha.3

package/dist/index.js

@@ -1,3 +1,9 @@
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
 // src/actions/createCoin.ts
 import { zoraFactoryImplABI } from "@zoralabs/coins";
 import {
@@ -72,6 +78,9 @@ async function createCoin(call, walletClient, publicClient) {
     ...createCoinCall(call),
     account: walletClient.account
   });
+  if (request.gas) {
+    request.gas = request.gas * 6n / 5n;
+  }
   const hash = await walletClient.writeContract(request);
   const receipt = await publicClient.waitForTransactionReceipt({ hash });
   const deployment = getCoinCreateFromLogs(receipt);
@@ -142,43 +151,57 @@ async function tradeCoin(params, walletClient, publicClient) {
   };
 }
 
-// src/actions/getCoinDetails.ts
+// src/actions/getOnchainCoinDetails.ts
 import { coinABI as coinABI2, iUniswapV3PoolABI } from "@zoralabs/coins";
-import { erc20Abi, formatEther, isAddressEqual, zeroAddress as zeroAddress2 } from "viem";
-async function getCoinDetails({
+import {
+  erc20Abi,
+  formatEther,
+  isAddressEqual,
+  zeroAddress as zeroAddress2
+} from "viem";
+async function getOnchainCoinDetails({
   coin,
   user = zeroAddress2,
   publicClient
 }) {
   validateClientNetwork(publicClient);
-  const [balance, pool, owners, payoutRecipient] = await publicClient.multicall({
-    contracts: [
-      {
-        address: coin,
-        abi: coinABI2,
-        functionName: "balanceOf",
-        args: [user]
-      },
-      {
-        address: coin,
-        abi: coinABI2,
-        functionName: "poolAddress"
-      },
-      {
-        address: coin,
-        abi: coinABI2,
-        functionName: "owners"
-      },
-      {
-        address: coin,
-        abi: coinABI2,
-        functionName: "payoutRecipient"
-      }
-    ],
-    allowFailure: false
-  });
+  const [balance, pool, owners, payoutRecipient] = await publicClient.multicall(
+    {
+      contracts: [
+        {
+          address: coin,
+          abi: coinABI2,
+          functionName: "balanceOf",
+          args: [user]
+        },
+        {
+          address: coin,
+          abi: coinABI2,
+          functionName: "poolAddress"
+        },
+        {
+          address: coin,
+          abi: coinABI2,
+          functionName: "owners"
+        },
+        {
+          address: coin,
+          abi: coinABI2,
+          functionName: "payoutRecipient"
+        }
+      ],
+      allowFailure: false
+    }
+  );
   const USDC_WETH_POOL = USDC_WETH_POOLS_BY_CHAIN[publicClient.chain?.id || 0];
-  const [coinWethPoolSlot0, coinWethPoolToken0, coinReservesRaw, coinTotalSupply, wethReservesRaw, usdcWethSlot0] = await publicClient.multicall({
+  const [
+    coinWethPoolSlot0,
+    coinWethPoolToken0,
+    coinReservesRaw,
+    coinTotalSupply,
+    wethReservesRaw,
+    usdcWethSlot0
+  ] = await publicClient.multicall({
     contracts: [
       {
         address: pool,
@@ -238,12 +261,20 @@ async function getCoinDetails({
     owners,
     payoutRecipient,
     marketCap: convertEthOutput(marketCap, wethPriceInUsdc),
-    liquidity: convertEthOutput(wethLiquidity + tokenLiquidity, wethPriceInUsdc),
+    liquidity: convertEthOutput(
+      wethLiquidity + tokenLiquidity,
+      wethPriceInUsdc
+    ),
     poolState: coinWethPoolSlot0
   };
 }
 function convertEthOutput(amountETH, wethToUsdc) {
-  return { eth: amountETH, ethDecimal: parseFloat(formatEther(amountETH)), usdc: wethToUsdc ? amountETH * wethToUsdc : null, usdcDecimal: wethToUsdc ? parseFloat(formatEther(amountETH * wethToUsdc / 10n ** 18n)) : null };
+  return {
+    eth: amountETH,
+    ethDecimal: parseFloat(formatEther(amountETH)),
+    usdc: wethToUsdc ? amountETH * wethToUsdc : null,
+    usdcDecimal: wethToUsdc ? parseFloat(formatEther(amountETH * wethToUsdc / 10n ** 18n)) : null
+  };
 }
 function uniswapV3SqrtPriceToBigIntScaled(sqrtPriceX96, token0Decimals, token1Decimals, isToken0Coin, scaleDecimals = 18) {
   const numerator = sqrtPriceX96 * sqrtPriceX96;
@@ -299,11 +330,76 @@ async function updateCoinURI(args, walletClient, publicClient) {
   );
   return { hash, receipt, uriUpdated };
 }
+
+// src/client/client.gen.ts
+import { createClient, createConfig } from "@hey-api/client-fetch";
+var client = createClient(createConfig({
+  baseUrl: "https://api-sdk.zora.engineering/"
+}));
+
+// src/client/sdk.gen.ts
+var getCoinDetails = (options) => {
+  return (options.client ?? client).get({
+    url: "/coinDetails",
+    ...options
+  });
+};
+var getCoinComments = (options) => {
+  return (options.client ?? client).get({
+    url: "/coinComments",
+    ...options
+  });
+};
+var getExplore = (options) => {
+  return (options.client ?? client).get({
+    url: "/explore",
+    ...options
+  });
+};
+
+// src/client/explore.ts
+var explore_exports = {};
+__export(explore_exports, {
+  getLastTraded: () => getLastTraded,
+  getLastTradedUnique: () => getLastTradedUnique,
+  getMostValuable: () => getMostValuable,
+  getNew: () => getNew,
+  getTopGainers: () => getTopGainers,
+  getTopVolume24h: () => getTopVolume24h
+});
+var getTopGainers = (options) => getExplore({
+  ...options,
+  query: { ...options?.query, listType: "TOP_GAINERS" }
+});
+var getTopVolume24h = (options) => getExplore({
+  ...options,
+  query: { ...options?.query, listType: "TOP_VOLUME_24H" }
+});
+var getMostValuable = (options) => getExplore({
+  ...options,
+  query: { ...options?.query, listType: "MOST_VALUABLE" }
+});
+var getNew = (options) => getExplore({
+  ...options,
+  query: { ...options?.query, listType: "NEW" }
+});
+var getLastTraded = (options) => getExplore({
+  ...options,
+  query: { ...options?.query, listType: "LAST_TRADED" }
+});
+var getLastTradedUnique = (options) => getExplore({
+  ...options,
+  query: { ...options?.query, listType: "LAST_TRADED_UNIQUE" }
+});
 export {
   createCoin,
   createCoinCall,
+  explore_exports as explore,
+  getCoinComments,
   getCoinCreateFromLogs,
   getCoinDetails,
+  getExplore,
+  getOnchainCoinDetails,
   getTradeFromLogs,
   tradeCoin,
   tradeCoinCall,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/actions/createCoin.ts","../src/constants.ts","../src/utils/validateClientNetwork.ts","../src/actions/tradeCoin.ts","../src/actions/getCoinDetails.ts","../src/actions/updateCoinURI.ts"],"sourcesContent":["import { zoraFactoryImplABI } from \"@zoralabs/coins\";\nimport {\n  Address,\n  PublicClient,\n  TransactionReceipt,\n  WalletClient,\n  SimulateContractParameters,\n  ContractEventArgsFromTopics,\n  parseEventLogs,\n} from \"viem\";\nimport { COIN_FACTORY_ADDRESS } from \"../constants\";\nimport { validateClientNetwork } from \"src/utils/validateClientNetwork\";\n\nexport type CoinDeploymentLogArgs = ContractEventArgsFromTopics<\n  typeof zoraFactoryImplABI,\n  \"CoinCreated\"\n>;\n\ntype CreateCoinArgs = {\n  name: string;\n  symbol: string;\n  uri: string;\n  owners?: Address[];\n  tickLower?: number;\n  payoutRecipient: Address;\n  platformReferrer?: Address;\n  initialPurchaseWei?: bigint;\n};\n\nexport function createCoinCall({\n  name,\n  symbol,\n  uri,\n  owners,\n  payoutRecipient,\n  initialPurchaseWei = 0n,\n  tickLower = -199200,\n  platformReferrer = \"0x0000000000000000000000000000000000000000\",\n}: CreateCoinArgs): SimulateContractParameters<\n  typeof zoraFactoryImplABI,\n  \"deploy\"\n> {\n  if (!owners) {\n    owners = [payoutRecipient];\n  }\n\n  const currency = \"0x4200000000000000000000000000000000000006\";\n  return {\n    abi: zoraFactoryImplABI,\n    functionName: \"deploy\",\n    address: COIN_FACTORY_ADDRESS,\n    args: [\n      payoutRecipient,\n      owners,\n      uri,\n      name,\n      symbol,\n      platformReferrer,\n      currency,\n      tickLower,\n      initialPurchaseWei,\n    ],\n    value: initialPurchaseWei,\n  } as const;\n}\n\n/**\n * Gets the deployed coin address from transaction receipt logs\n * @param receipt Transaction receipt containing the CoinCreated event\n * @returns The deployment information if found\n */\nexport function getCoinCreateFromLogs(\n  receipt: TransactionReceipt,\n): CoinDeploymentLogArgs | undefined {\n  const eventLogs = parseEventLogs({\n    abi: zoraFactoryImplABI,\n    logs: receipt.logs,\n  });\n  return eventLogs.find((log) => log.eventName === \"CoinCreated\")?.args;\n}\n\n// Update createCoin to return both receipt and coin address\nexport async function createCoin(\n  call: CreateCoinArgs,\n  walletClient: WalletClient,\n  publicClient: PublicClient,\n) {\n  validateClientNetwork(publicClient);\n  const { request } = await publicClient.simulateContract({\n    ...createCoinCall(call),\n    account: walletClient.account,\n  });\n  const hash = await walletClient.writeContract(request);\n  const receipt = await publicClient.waitForTransactionReceipt({ hash });\n  const deployment = getCoinCreateFromLogs(receipt);\n\n  return {\n    hash,\n    receipt,\n    address: deployment?.coin,\n    deployment,\n  };\n}\n","import { zoraFactoryImplAddress } from \"@zoralabs/coins\";\nimport { Address } from \"viem\";\nimport { base } from \"viem/chains\";\n\n// this is the same across all chains due to deterministic deploys.\nexport const COIN_FACTORY_ADDRESS = zoraFactoryImplAddress[\"8453\"] as Address;\n\nexport const SUPERCHAIN_WETH_ADDRESS = '0x4200000000000000000000000000000000000006';\n\nexport const USDC_WETH_POOLS_BY_CHAIN: Record<number, Address> = {\n    [base.id]: '0xd0b53D9277642d899DF5C87A3966A349A798F224',\n}\n","import { PublicClient } from \"viem\"\nimport { base, baseSepolia } from \"viem/chains\"\n\nexport const validateClientNetwork = (publicClient: PublicClient) => {\n    const clientChainId = publicClient?.chain?.id;\n    if (clientChainId === base.id) {\n        return;\n    }\n    if (clientChainId === baseSepolia.id) {\n        return;\n    }\n\n    throw new Error('Client network needs to be base or baseSepolia for current coin deployments.');\n}","import { coinABI } from \"@zoralabs/coins\";\nimport { validateClientNetwork } from \"src/utils/validateClientNetwork\";\nimport {\n  Address,\n  PublicClient,\n  TransactionReceipt,\n  WalletClient,\n  SimulateContractParameters,\n  parseEther,\n  zeroAddress,\n  ContractEventArgsFromTopics,\n  parseEventLogs,\n} from \"viem\";\nimport { baseSepolia } from \"viem/chains\";\n\n// Define trade event args type\n\nexport type SellEventArgs = ContractEventArgsFromTopics<\n  typeof coinABI,\n  \"CoinSell\"\n>;\nexport type BuyEventArgs = ContractEventArgsFromTopics<\n  typeof coinABI,\n  \"CoinBuy\"\n>;\n\nexport type TradeEventArgs = SellEventArgs | BuyEventArgs;\n\n/**\n * Simulates a buy order to get the expected output amount\n * @param {Object} params - The simulation parameters\n * @param {Address} params.target - The target coin contract address\n * @param {bigint} params.requestedOrderSize - The desired input amount for the buy\n * @param {PublicClient} params.publicClient - The viem public client instance\n * @returns {Promise<{orderSize: bigint, amountOut: bigint}>} The simulated order size and output amount\n */\nexport async function simulateBuy({\n  target,\n  requestedOrderSize,\n  publicClient,\n}: {\n  target: Address;\n  requestedOrderSize: bigint;\n  publicClient: PublicClient;\n}): Promise<{ orderSize: bigint; amountOut: bigint }> {\n  const numberResult = await publicClient.simulateContract({\n    address: target,\n    abi: coinABI,\n    functionName: \"buy\",\n    args: [\n      zeroAddress,\n      requestedOrderSize,\n      0n, // minAmountOut\n      0n, // sqrtPriceLimitX96\n      zeroAddress, // tradeReferrer\n    ],\n    stateOverride: [\n      {\n        address: baseSepolia.contracts.multicall3.address,\n        balance: parseEther(\"100000\"),\n      },\n    ],\n  });\n  const orderSize = numberResult.result[0];\n  const amountOut = numberResult.result[1];\n  return { orderSize, amountOut };\n}\n\n/**\n * Parameters for creating a trade call\n * @typedef {Object} TradeParams\n * @property {'sell' | 'buy'} direction - The trade direction\n * @property {Address} target - The target coin contract address\n * @property {Object} args - The trade arguments\n * @property {Address} args.recipient - The recipient of the trade output\n * @property {bigint} args.orderSize - The size of the order\n * @property {bigint} [args.minAmountOut] - The minimum amount to receive\n * @property {bigint} [args.sqrtPriceLimitX96] - The price limit for the trade\n * @property {Address} [args.tradeReferrer] - The referrer address for the trade\n */\ntype TradeParams = {\n  direction: \"sell\" | \"buy\";\n  target: Address;\n  args: {\n    recipient: Address;\n    orderSize: bigint;\n    minAmountOut?: bigint;\n    sqrtPriceLimitX96?: bigint;\n    tradeReferrer?: Address;\n  };\n};\n\n/**\n * Creates a trade call parameters object for buy or sell\n * @param {TradeParams} params - The trade parameters\n * @returns {SimulateContractParameters} The contract call parameters\n */\nexport function tradeCoinCall({\n  target,\n  direction,\n  args: {\n    recipient,\n    orderSize,\n    minAmountOut = 0n,\n    sqrtPriceLimitX96 = 0n,\n    tradeReferrer = zeroAddress,\n  },\n}: TradeParams): SimulateContractParameters {\n  return {\n    abi: coinABI,\n    functionName: direction,\n    address: target,\n    args: [\n      recipient,\n      orderSize,\n      minAmountOut,\n      sqrtPriceLimitX96,\n      tradeReferrer,\n    ],\n    value: direction === \"buy\" ? orderSize : 0n,\n  } as const;\n}\n\n/**\n * Gets the trade event from transaction receipt logs\n * @param {TransactionReceipt} receipt - The transaction receipt containing the logs\n * @param {'buy' | 'sell'} direction - The direction of the trade\n * @returns {TradeEventArgs | undefined} The decoded trade event args if found\n */\nexport function getTradeFromLogs(\n  receipt: TransactionReceipt,\n  direction: \"buy\" | \"sell\",\n): TradeEventArgs | undefined {\n  const eventLogs = parseEventLogs({\n    abi: coinABI,\n    logs: receipt.logs,\n  });\n\n  if (direction === \"buy\") {\n    return eventLogs.find((log) => log.eventName === \"CoinBuy\")?.args;\n  }\n  return eventLogs.find((log) => log.eventName === \"CoinSell\")?.args;\n}\n\n/**\n * Executes a trade transaction\n * @param {TradeParams} params - The trade parameters\n * @param {PublicClient} publicClient - The viem public client instance\n * @param {WalletClient} walletClient - The viem wallet client instance\n * @returns {Promise<{\n *   hash: `0x${string}`,\n *   receipt: TransactionReceipt,\n *   trade: TradeEventArgs | undefined\n * }>} The transaction result with trade details\n */\nexport async function tradeCoin(\n  params: TradeParams,\n  walletClient: WalletClient,\n  publicClient: PublicClient,\n) {\n  validateClientNetwork(publicClient);\n  const { request } = await publicClient.simulateContract({\n    ...tradeCoinCall(params),\n    account: walletClient.account,\n  });\n  const hash = await walletClient.writeContract(request);\n  const receipt = await publicClient.waitForTransactionReceipt({ hash });\n  const trade = getTradeFromLogs(receipt, params.direction);\n\n  return {\n    hash,\n    receipt,\n    trade,\n  };\n}\n","import { coinABI, iUniswapV3PoolABI } from \"@zoralabs/coins\";\nimport { SUPERCHAIN_WETH_ADDRESS, USDC_WETH_POOLS_BY_CHAIN } from \"src/constants\";\nimport { validateClientNetwork } from \"src/utils/validateClientNetwork\";\nimport { Address, erc20Abi, formatEther, isAddressEqual, PublicClient, zeroAddress } from \"viem\";\n\n\ntype Slot0Result = {\n  sqrtPriceX96: bigint;\n  tick: number;\n  observationIndex: number;\n  observationCardinality: number;\n  observationCardinalityNext: number;\n  feeProtocol: number;\n  unlocked: boolean;\n};\n\ntype PricingResult = {\n  eth: bigint,\n  usdc: bigint | null,\n  usdcDecimal: number | null,\n  ethDecimal: number,\n}\n\n/**\n * Represents the current state of a coin\n * @typedef {Object} CoinDetails\n * @property {bigint} balance - The user's balance of the coin\n * @property {PricingResult} marketCap - The market cap of the coin\n * @property {PricingResult} liquidity - The liquidity of the coin\n * @property {Address} pool - Pool address\n * @property {Slot0Result} poolState - Current state of the UniswapV3 pool\n * @property {Address[]} owners - List of owners for the coin\n * @property {Address} payoutRecipient - The payout recipient address\n */\nexport type CoinDetails = {\n  balance: bigint;\n  marketCap: PricingResult;\n  liquidity: PricingResult;\n  pool: Address;\n  poolState: Slot0Result;\n  owners: readonly Address[],\n  payoutRecipient: Address,\n};\n\n/**\n * Gets the current state of a coin for a user\n * @param {Object} params - The query parameters\n * @param {Address} params.coin - The coin contract address\n * @param {Address} params.user - The user address to check balance for\n * @param {PublicClient} params.publicClient - The viem public client instance\n * @returns {Promise<CoinDetails>} The coin's current state\n */\nexport async function getCoinDetails({\n  coin,\n  user = zeroAddress,\n  publicClient,\n}: {\n  coin: Address;\n  user?: Address;\n  publicClient: PublicClient;\n}): Promise<CoinDetails> {\n  validateClientNetwork(publicClient);\n  const [balance, pool, owners, payoutRecipient] = await publicClient.multicall({\n    contracts: [\n      {\n        address: coin,\n        abi: coinABI,\n        functionName: \"balanceOf\",\n        args: [user],\n      },\n      {\n        address: coin,\n        abi: coinABI,\n        functionName: \"poolAddress\",\n      },\n      {\n        address: coin,\n        abi: coinABI,\n        functionName: 'owners',\n      },\n      {\n        address: coin,\n        abi: coinABI,\n        functionName: 'payoutRecipient',\n      }\n    ],\n    allowFailure: false,\n  });\n\n  const USDC_WETH_POOL = USDC_WETH_POOLS_BY_CHAIN[publicClient.chain?.id || 0];\n\n  const [coinWethPoolSlot0, coinWethPoolToken0, coinReservesRaw, coinTotalSupply, wethReservesRaw, usdcWethSlot0] = await publicClient.multicall({\n    contracts: [{\n      address: pool,\n      abi: iUniswapV3PoolABI,\n      functionName: \"slot0\",\n    },\n    {\n      address: pool,\n      abi: iUniswapV3PoolABI,\n      functionName: 'token0'\n    }, {\n      address: coin,\n      abi: erc20Abi,\n      functionName: 'balanceOf',\n      args: [pool],\n    },\n    {\n      address: coin,\n      abi: coinABI,\n      functionName: 'totalSupply',\n    }, {\n      address: SUPERCHAIN_WETH_ADDRESS,\n      abi: erc20Abi,\n      functionName: 'balanceOf',\n      args: [pool],\n    }, {\n      address: USDC_WETH_POOL ?? coin,\n      abi: iUniswapV3PoolABI,\n      functionName: 'slot0',\n    }], allowFailure: false\n  });\n\n  const wethPriceInUsdc = USDC_WETH_POOL ? uniswapV3SqrtPriceToBigIntScaled(\n    usdcWethSlot0.sqrtPriceX96,\n    18,\n    6,\n    true,\n    18\n  ) : null;\n\n  const coinPriceInWeth = uniswapV3SqrtPriceToBigIntScaled(\n    coinWethPoolSlot0.sqrtPriceX96,\n    18,\n    18,\n    isAddressEqual(coinWethPoolToken0, coin),\n    18\n  );\n\n  // Divide by 10^18 to remove percision from `coinPriceInWeth` after math since bigint is decimal.\n  const marketCap = coinPriceInWeth * coinTotalSupply / 10n ** 18n;\n\n  const wethLiquidity = wethReservesRaw;\n  // Divide by 10^18 to remove percision from `coinPriceInWeth` after math since bigint is decimal.\n  const tokenLiquidity = coinReservesRaw * coinPriceInWeth / 10n ** 18n;\n\n  return {\n    balance,\n    pool,\n    owners,\n    payoutRecipient,\n    marketCap: convertEthOutput(marketCap, wethPriceInUsdc),\n    liquidity: convertEthOutput(wethLiquidity + tokenLiquidity, wethPriceInUsdc),\n    poolState: coinWethPoolSlot0,\n  };\n}\n\n\nfunction convertEthOutput(amountETH: bigint, wethToUsdc: bigint | null) {\n  return { eth: amountETH, ethDecimal: parseFloat(formatEther(amountETH)), usdc: wethToUsdc ? amountETH * wethToUsdc : null, usdcDecimal: wethToUsdc ? parseFloat(formatEther(amountETH * wethToUsdc / 10n ** 18n)) : null }\n}\n\nfunction uniswapV3SqrtPriceToBigIntScaled(\n  sqrtPriceX96: bigint,\n  token0Decimals: number,\n  token1Decimals: number,\n  isToken0Coin: boolean,\n  scaleDecimals: number = 18\n): bigint {\n  // (sqrtPrice^2 / 2^192) => ratio\n  // We'll do: ratioScaled = (sqrtPrice^2 * 10^scaleDecimals) / 2^192\n  const numerator = sqrtPriceX96 * sqrtPriceX96;\n  const denominator = 2n ** 192n;\n  const scaleFactor = 10n ** BigInt(scaleDecimals);\n\n  // raw ratioScaled\n  let ratioScaled = (numerator * scaleFactor) / denominator; // BigInt\n\n  // Adjust for difference in decimals:\n  // ratioScaled *= 10^(dec0 - dec1)\n  const decimalsDiff = BigInt(token0Decimals - token1Decimals);\n  if (decimalsDiff > 0n) {\n    ratioScaled *= 10n ** decimalsDiff;\n  } else if (decimalsDiff < 0n) {\n    ratioScaled /= 10n ** (-decimalsDiff);\n  }\n\n  if (!isToken0Coin) {\n    // We want the reciprocal: coin is token1 => coinPriceInToken0 = 1 / ratio\n    // But we also want it scaled by 10^scaleDecimals\n    // reciprocalScaled = (10^scaleDecimals * 10^(decimalsDiff)) / ratioScaled\n    // (assuming ratioScaled != 0)\n    if (ratioScaled === 0n) {\n      return 0n; // or some huge number representing infinity\n    }\n    ratioScaled = (scaleFactor * scaleFactor) / ratioScaled;\n    // or if we already included decimalsDiff above, handle carefully.\n  }\n\n  return ratioScaled;\n}\n","import { coinABI } from \"@zoralabs/coins\";\nimport { validateClientNetwork } from \"src/utils/validateClientNetwork\";\nimport {\n  Address,\n  parseEventLogs,\n  PublicClient,\n  SimulateContractParameters,\n  WalletClient,\n} from \"viem\";\n\ntype UpdateCoinURIArgs = {\n  coin: Address;\n  newURI: string;\n};\n\nexport function updateCoinURICall({\n  newURI,\n  coin,\n}: UpdateCoinURIArgs): SimulateContractParameters {\n  if (!newURI.startsWith(\"ipfs://\")) {\n    throw new Error(\"URI needs to be an ipfs:// prefix uri\");\n  }\n\n  return {\n    abi: coinABI,\n    address: coin,\n    functionName: \"setContractURI\",\n    args: [newURI],\n  };\n}\n\nexport async function updateCoinURI(\n  args: UpdateCoinURIArgs,\n  walletClient: WalletClient,\n  publicClient: PublicClient,\n) {\n  validateClientNetwork(publicClient);\n  const call = updateCoinURICall(args);\n  const { request } = await publicClient.simulateContract({\n    ...call,\n    account: walletClient.account!,\n  });\n  const hash = await walletClient.writeContract(request);\n  const receipt = await publicClient.waitForTransactionReceipt({ hash });\n  const eventLogs = parseEventLogs({ abi: coinABI, logs: receipt.logs });\n  const uriUpdated = eventLogs.find(\n    (log) => log.eventName === \"ContractURIUpdated\",\n  );\n\n  return { hash, receipt, uriUpdated };\n}\n"],"mappings":"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","names":["base","parseEventLogs","baseSepolia","parseEventLogs","coinABI","zeroAddress","coinABI","coinABI","parseEventLogs","coinABI"]}
+{"version":3,"sources":["../src/actions/createCoin.ts","../src/constants.ts","../src/utils/validateClientNetwork.ts","../src/actions/tradeCoin.ts","../src/actions/getOnchainCoinDetails.ts","../src/actions/updateCoinURI.ts","../src/client/client.gen.ts","../src/client/sdk.gen.ts","../src/client/explore.ts"],"sourcesContent":["import { zoraFactoryImplABI } from \"@zoralabs/coins\";\nimport {\n  Address,\n  PublicClient,\n  TransactionReceipt,\n  WalletClient,\n  SimulateContractParameters,\n  ContractEventArgsFromTopics,\n  parseEventLogs,\n} from \"viem\";\nimport { COIN_FACTORY_ADDRESS } from \"../constants\";\nimport { validateClientNetwork } from \"src/utils/validateClientNetwork\";\n\nexport type CoinDeploymentLogArgs = ContractEventArgsFromTopics<\n  typeof zoraFactoryImplABI,\n  \"CoinCreated\"\n>;\n\ntype CreateCoinArgs = {\n  name: string;\n  symbol: string;\n  uri: string;\n  owners?: Address[];\n  tickLower?: number;\n  payoutRecipient: Address;\n  platformReferrer?: Address;\n  initialPurchaseWei?: bigint;\n};\n\nexport function createCoinCall({\n  name,\n  symbol,\n  uri,\n  owners,\n  payoutRecipient,\n  initialPurchaseWei = 0n,\n  tickLower = -199200,\n  platformReferrer = \"0x0000000000000000000000000000000000000000\",\n}: CreateCoinArgs): SimulateContractParameters<\n  typeof zoraFactoryImplABI,\n  \"deploy\"\n> {\n  if (!owners) {\n    owners = [payoutRecipient];\n  }\n\n  const currency = \"0x4200000000000000000000000000000000000006\";\n  return {\n    abi: zoraFactoryImplABI,\n    functionName: \"deploy\",\n    address: COIN_FACTORY_ADDRESS,\n    args: [\n      payoutRecipient,\n      owners,\n      uri,\n      name,\n      symbol,\n      platformReferrer,\n      currency,\n      tickLower,\n      initialPurchaseWei,\n    ],\n    value: initialPurchaseWei,\n  } as const;\n}\n\n/**\n * Gets the deployed coin address from transaction receipt logs\n * @param receipt Transaction receipt containing the CoinCreated event\n * @returns The deployment information if found\n */\nexport function getCoinCreateFromLogs(\n  receipt: TransactionReceipt,\n): CoinDeploymentLogArgs | undefined {\n  const eventLogs = parseEventLogs({\n    abi: zoraFactoryImplABI,\n    logs: receipt.logs,\n  });\n  return eventLogs.find((log) => log.eventName === \"CoinCreated\")?.args;\n}\n\n// Update createCoin to return both receipt and coin address\nexport async function createCoin(\n  call: CreateCoinArgs,\n  walletClient: WalletClient,\n  publicClient: PublicClient,\n) {\n  validateClientNetwork(publicClient);\n  const { request } = await publicClient.simulateContract({\n    ...createCoinCall(call),\n    account: walletClient.account,\n  });\n\n  // Add a 1/5th buffer on gas.\n  if (request.gas) {\n    request.gas = request.gas * 6n / 5n;\n  }\n  const hash = await walletClient.writeContract(request);\n  const receipt = await publicClient.waitForTransactionReceipt({ hash });\n  const deployment = getCoinCreateFromLogs(receipt);\n\n  return {\n    hash,\n    receipt,\n    address: deployment?.coin,\n    deployment,\n  };\n}\n","import { zoraFactoryImplAddress } from \"@zoralabs/coins\";\nimport { Address } from \"viem\";\nimport { base } from \"viem/chains\";\n\n// this is the same across all chains due to deterministic deploys.\nexport const COIN_FACTORY_ADDRESS = zoraFactoryImplAddress[\"8453\"] as Address;\n\nexport const SUPERCHAIN_WETH_ADDRESS = '0x4200000000000000000000000000000000000006';\n\nexport const USDC_WETH_POOLS_BY_CHAIN: Record<number, Address> = {\n    [base.id]: '0xd0b53D9277642d899DF5C87A3966A349A798F224',\n}\n","import { PublicClient } from \"viem\"\nimport { base, baseSepolia } from \"viem/chains\"\n\nexport const validateClientNetwork = (publicClient: PublicClient) => {\n    const clientChainId = publicClient?.chain?.id;\n    if (clientChainId === base.id) {\n        return;\n    }\n    if (clientChainId === baseSepolia.id) {\n        return;\n    }\n\n    throw new Error('Client network needs to be base or baseSepolia for current coin deployments.');\n}","import { coinABI } from \"@zoralabs/coins\";\nimport { validateClientNetwork } from \"src/utils/validateClientNetwork\";\nimport {\n  Address,\n  PublicClient,\n  TransactionReceipt,\n  WalletClient,\n  SimulateContractParameters,\n  parseEther,\n  zeroAddress,\n  ContractEventArgsFromTopics,\n  parseEventLogs,\n} from \"viem\";\nimport { baseSepolia } from \"viem/chains\";\n\n// Define trade event args type\n\nexport type SellEventArgs = ContractEventArgsFromTopics<\n  typeof coinABI,\n  \"CoinSell\"\n>;\nexport type BuyEventArgs = ContractEventArgsFromTopics<\n  typeof coinABI,\n  \"CoinBuy\"\n>;\n\nexport type TradeEventArgs = SellEventArgs | BuyEventArgs;\n\n/**\n * Simulates a buy order to get the expected output amount\n * @param {Object} params - The simulation parameters\n * @param {Address} params.target - The target coin contract address\n * @param {bigint} params.requestedOrderSize - The desired input amount for the buy\n * @param {PublicClient} params.publicClient - The viem public client instance\n * @returns {Promise<{orderSize: bigint, amountOut: bigint}>} The simulated order size and output amount\n */\nexport async function simulateBuy({\n  target,\n  requestedOrderSize,\n  publicClient,\n}: {\n  target: Address;\n  requestedOrderSize: bigint;\n  publicClient: PublicClient;\n}): Promise<{ orderSize: bigint; amountOut: bigint }> {\n  const numberResult = await publicClient.simulateContract({\n    address: target,\n    abi: coinABI,\n    functionName: \"buy\",\n    args: [\n      zeroAddress,\n      requestedOrderSize,\n      0n, // minAmountOut\n      0n, // sqrtPriceLimitX96\n      zeroAddress, // tradeReferrer\n    ],\n    stateOverride: [\n      {\n        address: baseSepolia.contracts.multicall3.address,\n        balance: parseEther(\"100000\"),\n      },\n    ],\n  });\n  const orderSize = numberResult.result[0];\n  const amountOut = numberResult.result[1];\n  return { orderSize, amountOut };\n}\n\n/**\n * Parameters for creating a trade call\n * @typedef {Object} TradeParams\n * @property {'sell' | 'buy'} direction - The trade direction\n * @property {Address} target - The target coin contract address\n * @property {Object} args - The trade arguments\n * @property {Address} args.recipient - The recipient of the trade output\n * @property {bigint} args.orderSize - The size of the order\n * @property {bigint} [args.minAmountOut] - The minimum amount to receive\n * @property {bigint} [args.sqrtPriceLimitX96] - The price limit for the trade\n * @property {Address} [args.tradeReferrer] - The referrer address for the trade\n */\ntype TradeParams = {\n  direction: \"sell\" | \"buy\";\n  target: Address;\n  args: {\n    recipient: Address;\n    orderSize: bigint;\n    minAmountOut?: bigint;\n    sqrtPriceLimitX96?: bigint;\n    tradeReferrer?: Address;\n  };\n};\n\n/**\n * Creates a trade call parameters object for buy or sell\n * @param {TradeParams} params - The trade parameters\n * @returns {SimulateContractParameters} The contract call parameters\n */\nexport function tradeCoinCall({\n  target,\n  direction,\n  args: {\n    recipient,\n    orderSize,\n    minAmountOut = 0n,\n    sqrtPriceLimitX96 = 0n,\n    tradeReferrer = zeroAddress,\n  },\n}: TradeParams): SimulateContractParameters {\n  return {\n    abi: coinABI,\n    functionName: direction,\n    address: target,\n    args: [\n      recipient,\n      orderSize,\n      minAmountOut,\n      sqrtPriceLimitX96,\n      tradeReferrer,\n    ],\n    value: direction === \"buy\" ? orderSize : 0n,\n  } as const;\n}\n\n/**\n * Gets the trade event from transaction receipt logs\n * @param {TransactionReceipt} receipt - The transaction receipt containing the logs\n * @param {'buy' | 'sell'} direction - The direction of the trade\n * @returns {TradeEventArgs | undefined} The decoded trade event args if found\n */\nexport function getTradeFromLogs(\n  receipt: TransactionReceipt,\n  direction: \"buy\" | \"sell\",\n): TradeEventArgs | undefined {\n  const eventLogs = parseEventLogs({\n    abi: coinABI,\n    logs: receipt.logs,\n  });\n\n  if (direction === \"buy\") {\n    return eventLogs.find((log) => log.eventName === \"CoinBuy\")?.args;\n  }\n  return eventLogs.find((log) => log.eventName === \"CoinSell\")?.args;\n}\n\n/**\n * Executes a trade transaction\n * @param {TradeParams} params - The trade parameters\n * @param {PublicClient} publicClient - The viem public client instance\n * @param {WalletClient} walletClient - The viem wallet client instance\n * @returns {Promise<{\n *   hash: `0x${string}`,\n *   receipt: TransactionReceipt,\n *   trade: TradeEventArgs | undefined\n * }>} The transaction result with trade details\n */\nexport async function tradeCoin(\n  params: TradeParams,\n  walletClient: WalletClient,\n  publicClient: PublicClient,\n) {\n  validateClientNetwork(publicClient);\n  const { request } = await publicClient.simulateContract({\n    ...tradeCoinCall(params),\n    account: walletClient.account,\n  });\n  const hash = await walletClient.writeContract(request);\n  const receipt = await publicClient.waitForTransactionReceipt({ hash });\n  const trade = getTradeFromLogs(receipt, params.direction);\n\n  return {\n    hash,\n    receipt,\n    trade,\n  };\n}\n","import { coinABI, iUniswapV3PoolABI } from \"@zoralabs/coins\";\nimport {\n  SUPERCHAIN_WETH_ADDRESS,\n  USDC_WETH_POOLS_BY_CHAIN,\n} from \"src/constants\";\nimport { validateClientNetwork } from \"src/utils/validateClientNetwork\";\nimport {\n  Address,\n  erc20Abi,\n  formatEther,\n  isAddressEqual,\n  PublicClient,\n  zeroAddress,\n} from \"viem\";\n\ntype Slot0Result = {\n  sqrtPriceX96: bigint;\n  tick: number;\n  observationIndex: number;\n  observationCardinality: number;\n  observationCardinalityNext: number;\n  feeProtocol: number;\n  unlocked: boolean;\n};\n\ntype PricingResult = {\n  eth: bigint;\n  usdc: bigint | null;\n  usdcDecimal: number | null;\n  ethDecimal: number;\n};\n\n/**\n * Represents the current state of a coin\n * @typedef {Object} OnchainCoinDetails\n * @property {bigint} balance - The user's balance of the coin\n * @property {PricingResult} marketCap - The market cap of the coin\n * @property {PricingResult} liquidity - The liquidity of the coin\n * @property {Address} pool - Pool address\n * @property {Slot0Result} poolState - Current state of the UniswapV3 pool\n * @property {Address[]} owners - List of owners for the coin\n * @property {Address} payoutRecipient - The payout recipient address\n */\nexport type OnchainCoinDetails = {\n  balance: bigint;\n  marketCap: PricingResult;\n  liquidity: PricingResult;\n  pool: Address;\n  poolState: Slot0Result;\n  owners: readonly Address[];\n  payoutRecipient: Address;\n};\n\n/**\n * Gets the current state of a coin for a user\n * @param {Object} params - The query parameters\n * @param {Address} params.coin - The coin contract address\n * @param {Address} params.user - The user address to check balance for\n * @param {PublicClient} params.publicClient - The viem public client instance\n * @returns {Promise<OnchainCoinDetails>} The coin's current state\n */\nexport async function getOnchainCoinDetails({\n  coin,\n  user = zeroAddress,\n  publicClient,\n}: {\n  coin: Address;\n  user?: Address;\n  publicClient: PublicClient;\n}): Promise<OnchainCoinDetails> {\n  validateClientNetwork(publicClient);\n  const [balance, pool, owners, payoutRecipient] = await publicClient.multicall(\n    {\n      contracts: [\n        {\n          address: coin,\n          abi: coinABI,\n          functionName: \"balanceOf\",\n          args: [user],\n        },\n        {\n          address: coin,\n          abi: coinABI,\n          functionName: \"poolAddress\",\n        },\n        {\n          address: coin,\n          abi: coinABI,\n          functionName: \"owners\",\n        },\n        {\n          address: coin,\n          abi: coinABI,\n          functionName: \"payoutRecipient\",\n        },\n      ],\n      allowFailure: false,\n    },\n  );\n\n  const USDC_WETH_POOL = USDC_WETH_POOLS_BY_CHAIN[publicClient.chain?.id || 0];\n\n  const [\n    coinWethPoolSlot0,\n    coinWethPoolToken0,\n    coinReservesRaw,\n    coinTotalSupply,\n    wethReservesRaw,\n    usdcWethSlot0,\n  ] = await publicClient.multicall({\n    contracts: [\n      {\n        address: pool,\n        abi: iUniswapV3PoolABI,\n        functionName: \"slot0\",\n      },\n      {\n        address: pool,\n        abi: iUniswapV3PoolABI,\n        functionName: \"token0\",\n      },\n      {\n        address: coin,\n        abi: erc20Abi,\n        functionName: \"balanceOf\",\n        args: [pool],\n      },\n      {\n        address: coin,\n        abi: coinABI,\n        functionName: \"totalSupply\",\n      },\n      {\n        address: SUPERCHAIN_WETH_ADDRESS,\n        abi: erc20Abi,\n        functionName: \"balanceOf\",\n        args: [pool],\n      },\n      {\n        address: USDC_WETH_POOL ?? coin,\n        abi: iUniswapV3PoolABI,\n        functionName: \"slot0\",\n      },\n    ],\n    allowFailure: false,\n  });\n\n  const wethPriceInUsdc = USDC_WETH_POOL\n    ? uniswapV3SqrtPriceToBigIntScaled(\n        usdcWethSlot0.sqrtPriceX96,\n        18,\n        6,\n        true,\n        18,\n      )\n    : null;\n\n  const coinPriceInWeth = uniswapV3SqrtPriceToBigIntScaled(\n    coinWethPoolSlot0.sqrtPriceX96,\n    18,\n    18,\n    isAddressEqual(coinWethPoolToken0, coin),\n    18,\n  );\n\n  // Divide by 10^18 to remove percision from `coinPriceInWeth` after math since bigint is decimal.\n  const marketCap = (coinPriceInWeth * coinTotalSupply) / 10n ** 18n;\n\n  const wethLiquidity = wethReservesRaw;\n  // Divide by 10^18 to remove percision from `coinPriceInWeth` after math since bigint is decimal.\n  const tokenLiquidity = (coinReservesRaw * coinPriceInWeth) / 10n ** 18n;\n\n  return {\n    balance,\n    pool,\n    owners,\n    payoutRecipient,\n    marketCap: convertEthOutput(marketCap, wethPriceInUsdc),\n    liquidity: convertEthOutput(\n      wethLiquidity + tokenLiquidity,\n      wethPriceInUsdc,\n    ),\n    poolState: coinWethPoolSlot0,\n  };\n}\n\nfunction convertEthOutput(amountETH: bigint, wethToUsdc: bigint | null) {\n  return {\n    eth: amountETH,\n    ethDecimal: parseFloat(formatEther(amountETH)),\n    usdc: wethToUsdc ? amountETH * wethToUsdc : null,\n    usdcDecimal: wethToUsdc\n      ? parseFloat(formatEther((amountETH * wethToUsdc) / 10n ** 18n))\n      : null,\n  };\n}\n\nfunction uniswapV3SqrtPriceToBigIntScaled(\n  sqrtPriceX96: bigint,\n  token0Decimals: number,\n  token1Decimals: number,\n  isToken0Coin: boolean,\n  scaleDecimals: number = 18,\n): bigint {\n  // (sqrtPrice^2 / 2^192) => ratio\n  // We'll do: ratioScaled = (sqrtPrice^2 * 10^scaleDecimals) / 2^192\n  const numerator = sqrtPriceX96 * sqrtPriceX96;\n  const denominator = 2n ** 192n;\n  const scaleFactor = 10n ** BigInt(scaleDecimals);\n\n  // raw ratioScaled\n  let ratioScaled = (numerator * scaleFactor) / denominator; // BigInt\n\n  // Adjust for difference in decimals:\n  // ratioScaled *= 10^(dec0 - dec1)\n  const decimalsDiff = BigInt(token0Decimals - token1Decimals);\n  if (decimalsDiff > 0n) {\n    ratioScaled *= 10n ** decimalsDiff;\n  } else if (decimalsDiff < 0n) {\n    ratioScaled /= 10n ** -decimalsDiff;\n  }\n\n  if (!isToken0Coin) {\n    // We want the reciprocal: coin is token1 => coinPriceInToken0 = 1 / ratio\n    // But we also want it scaled by 10^scaleDecimals\n    // reciprocalScaled = (10^scaleDecimals * 10^(decimalsDiff)) / ratioScaled\n    // (assuming ratioScaled != 0)\n    if (ratioScaled === 0n) {\n      return 0n; // or some huge number representing infinity\n    }\n    ratioScaled = (scaleFactor * scaleFactor) / ratioScaled;\n    // or if we already included decimalsDiff above, handle carefully.\n  }\n\n  return ratioScaled;\n}\n","import { coinABI } from \"@zoralabs/coins\";\nimport { validateClientNetwork } from \"src/utils/validateClientNetwork\";\nimport {\n  Address,\n  parseEventLogs,\n  PublicClient,\n  SimulateContractParameters,\n  WalletClient,\n} from \"viem\";\n\ntype UpdateCoinURIArgs = {\n  coin: Address;\n  newURI: string;\n};\n\nexport function updateCoinURICall({\n  newURI,\n  coin,\n}: UpdateCoinURIArgs): SimulateContractParameters {\n  if (!newURI.startsWith(\"ipfs://\")) {\n    throw new Error(\"URI needs to be an ipfs:// prefix uri\");\n  }\n\n  return {\n    abi: coinABI,\n    address: coin,\n    functionName: \"setContractURI\",\n    args: [newURI],\n  };\n}\n\nexport async function updateCoinURI(\n  args: UpdateCoinURIArgs,\n  walletClient: WalletClient,\n  publicClient: PublicClient,\n) {\n  validateClientNetwork(publicClient);\n  const call = updateCoinURICall(args);\n  const { request } = await publicClient.simulateContract({\n    ...call,\n    account: walletClient.account!,\n  });\n  const hash = await walletClient.writeContract(request);\n  const receipt = await publicClient.waitForTransactionReceipt({ hash });\n  const eventLogs = parseEventLogs({ abi: coinABI, logs: receipt.logs });\n  const uriUpdated = eventLogs.find(\n    (log) => log.eventName === \"ContractURIUpdated\",\n  );\n\n  return { hash, receipt, uriUpdated };\n}\n","// This file is auto-generated by @hey-api/openapi-ts\n\nimport type { ClientOptions } from './types.gen';\nimport { type Config, type ClientOptions as DefaultClientOptions, createClient, createConfig } from '@hey-api/client-fetch';\n\n/**\n * The `createClientConfig()` function will be called on client initialization\n * and the returned object will become the client's initial configuration.\n *\n * You may want to initialize your client this way instead of calling\n * `setConfig()`. This is useful for example if you're using Next.js\n * to ensure your client always has the correct values.\n */\nexport type CreateClientConfig<T extends DefaultClientOptions = ClientOptions> = (override?: Config<DefaultClientOptions & T>) => Config<Required<DefaultClientOptions> & T>;\n\nexport const client = createClient(createConfig<ClientOptions>({\n    baseUrl: 'https://api-sdk.zora.engineering/'\n}));","// This file is auto-generated by @hey-api/openapi-ts\n\nimport type { Options as ClientOptions, TDataShape, Client } from '@hey-api/client-fetch';\nimport type { GetCoinDetailsData, GetCoinDetailsResponse, GetCoinCommentsData, GetCoinCommentsResponse, GetExploreData, GetExploreResponse } from './types.gen';\nimport { client as _heyApiClient } from './client.gen';\n\nexport type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean> = ClientOptions<TData, ThrowOnError> & {\n    /**\n     * You can provide a client instance returned by `createClient()` instead of\n     * individual options. This might be also useful if you want to implement a\n     * custom client.\n     */\n    client?: Client;\n    /**\n     * You can pass arbitrary values through the `meta` object. This can be\n     * used to access values that aren't defined as part of the SDK function.\n     */\n    meta?: Record<string, unknown>;\n};\n\nexport const getCoinDetails = <ThrowOnError extends boolean = false>(options: Options<GetCoinDetailsData, ThrowOnError>) => {\n    return (options.client ?? _heyApiClient).get<GetCoinDetailsResponse, unknown, ThrowOnError>({\n        url: '/coinDetails',\n        ...options\n    });\n};\n\nexport const getCoinComments = <ThrowOnError extends boolean = false>(options: Options<GetCoinCommentsData, ThrowOnError>) => {\n    return (options.client ?? _heyApiClient).get<GetCoinCommentsResponse, unknown, ThrowOnError>({\n        url: '/coinComments',\n        ...options\n    });\n};\n\nexport const getExplore = <ThrowOnError extends boolean = false>(options: Options<GetExploreData, ThrowOnError>) => {\n    return (options.client ?? _heyApiClient).get<GetExploreResponse, unknown, ThrowOnError>({\n        url: '/explore',\n        ...options\n    });\n};","import { getExplore } from \"./sdk.gen\";\nimport type { GetExploreData } from \"./types.gen\";\nimport { Options } from \"@hey-api/client-fetch\";\n\ntype QueryInnerType = {\n  query: Omit<GetExploreData[\"query\"], \"listType\">;\n} & Omit<GetExploreData, \"query\">;\n\nexport const getTopGainers = <ThrowOnError extends boolean = false>(\n  options?: Options<QueryInnerType, ThrowOnError>,\n) =>\n  getExplore({\n    ...options,\n    query: { ...options?.query, listType: \"TOP_GAINERS\" },\n  });\n\nexport const getTopVolume24h = <ThrowOnError extends boolean = false>(\n  options?: Options<QueryInnerType, ThrowOnError>,\n) =>\n  getExplore({\n    ...options,\n    query: { ...options?.query, listType: \"TOP_VOLUME_24H\" },\n  });\n\nexport const getMostValuable = <ThrowOnError extends boolean = false>(\n  options?: Options<QueryInnerType, ThrowOnError>,\n) =>\n  getExplore({\n    ...options,\n    query: { ...options?.query, listType: \"MOST_VALUABLE\" },\n  });\n\nexport const getNew = <ThrowOnError extends boolean = false>(\n  options?: Options<QueryInnerType, ThrowOnError>,\n) =>\n  getExplore({\n    ...options,\n    query: { ...options?.query, listType: \"NEW\" },\n  });\n\nexport const getLastTraded = <ThrowOnError extends boolean = false>(\n  options?: Options<QueryInnerType, ThrowOnError>,\n) =>\n  getExplore({\n    ...options,\n    query: { ...options?.query, listType: \"LAST_TRADED\" },\n  });\n\nexport const getLastTradedUnique = <ThrowOnError extends boolean = false>(\n  options?: Options<QueryInnerType, ThrowOnError>,\n) =>\n  getExplore({\n    ...options,\n    query: { ...options?.query, listType: \"LAST_TRADED_UNIQUE\" },\n  });\n"],"mappings":";;;;;;;AAAA,SAAS,0BAA0B;AACnC;AAAA,EAOE;AAAA,OACK;;;ACTP,SAAS,8BAA8B;AAEvC,SAAS,YAAY;AAGd,IAAM,uBAAuB,uBAAuB,MAAM;AAE1D,IAAM,0BAA0B;AAEhC,IAAM,2BAAoD;AAAA,EAC7D,CAAC,KAAK,EAAE,GAAG;AACf;;;ACVA,SAAS,QAAAA,OAAM,mBAAmB;AAE3B,IAAM,wBAAwB,CAAC,iBAA+B;AACjE,QAAM,gBAAgB,cAAc,OAAO;AAC3C,MAAI,kBAAkBA,MAAK,IAAI;AAC3B;AAAA,EACJ;AACA,MAAI,kBAAkB,YAAY,IAAI;AAClC;AAAA,EACJ;AAEA,QAAM,IAAI,MAAM,8EAA8E;AAClG;;;AFgBO,SAAS,eAAe;AAAA,EAC7B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,qBAAqB;AAAA,EACrB,YAAY;AAAA,EACZ,mBAAmB;AACrB,GAGE;AACA,MAAI,CAAC,QAAQ;AACX,aAAS,CAAC,eAAe;AAAA,EAC3B;AAEA,QAAM,WAAW;AACjB,SAAO;AAAA,IACL,KAAK;AAAA,IACL,cAAc;AAAA,IACd,SAAS;AAAA,IACT,MAAM;AAAA,MACJ;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,IACA,OAAO;AAAA,EACT;AACF;AAOO,SAAS,sBACd,SACmC;AACnC,QAAM,YAAY,eAAe;AAAA,IAC/B,KAAK;AAAA,IACL,MAAM,QAAQ;AAAA,EAChB,CAAC;AACD,SAAO,UAAU,KAAK,CAAC,QAAQ,IAAI,cAAc,aAAa,GAAG;AACnE;AAGA,eAAsB,WACpB,MACA,cACA,cACA;AACA,wBAAsB,YAAY;AAClC,QAAM,EAAE,QAAQ,IAAI,MAAM,aAAa,iBAAiB;AAAA,IACtD,GAAG,eAAe,IAAI;AAAA,IACtB,SAAS,aAAa;AAAA,EACxB,CAAC;AAGD,MAAI,QAAQ,KAAK;AACf,YAAQ,MAAM,QAAQ,MAAM,KAAK;AAAA,EACnC;AACA,QAAM,OAAO,MAAM,aAAa,cAAc,OAAO;AACrD,QAAM,UAAU,MAAM,aAAa,0BAA0B,EAAE,KAAK,CAAC;AACrE,QAAM,aAAa,sBAAsB,OAAO;AAEhD,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,SAAS,YAAY;AAAA,IACrB;AAAA,EACF;AACF;;;AG3GA,SAAS,eAAe;AAExB;AAAA,EAME;AAAA,EACA;AAAA,EAEA,kBAAAC;AAAA,OACK;AACP,SAAS,eAAAC,oBAAmB;AAoFrB,SAAS,cAAc;AAAA,EAC5B;AAAA,EACA;AAAA,EACA,MAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA,eAAe;AAAA,IACf,oBAAoB;AAAA,IACpB,gBAAgB;AAAA,EAClB;AACF,GAA4C;AAC1C,SAAO;AAAA,IACL,KAAK;AAAA,IACL,cAAc;AAAA,IACd,SAAS;AAAA,IACT,MAAM;AAAA,MACJ;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,IACA,OAAO,cAAc,QAAQ,YAAY;AAAA,EAC3C;AACF;AAQO,SAAS,iBACd,SACA,WAC4B;AAC5B,QAAM,YAAYC,gBAAe;AAAA,IAC/B,KAAK;AAAA,IACL,MAAM,QAAQ;AAAA,EAChB,CAAC;AAED,MAAI,cAAc,OAAO;AACvB,WAAO,UAAU,KAAK,CAAC,QAAQ,IAAI,cAAc,SAAS,GAAG;AAAA,EAC/D;AACA,SAAO,UAAU,KAAK,CAAC,QAAQ,IAAI,cAAc,UAAU,GAAG;AAChE;AAaA,eAAsB,UACpB,QACA,cACA,cACA;AACA,wBAAsB,YAAY;AAClC,QAAM,EAAE,QAAQ,IAAI,MAAM,aAAa,iBAAiB;AAAA,IACtD,GAAG,cAAc,MAAM;AAAA,IACvB,SAAS,aAAa;AAAA,EACxB,CAAC;AACD,QAAM,OAAO,MAAM,aAAa,cAAc,OAAO;AACrD,QAAM,UAAU,MAAM,aAAa,0BAA0B,EAAE,KAAK,CAAC;AACrE,QAAM,QAAQ,iBAAiB,SAAS,OAAO,SAAS;AAExD,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;;;AC9KA,SAAS,WAAAC,UAAS,yBAAyB;AAM3C;AAAA,EAEE;AAAA,EACA;AAAA,EACA;AAAA,EAEA,eAAAC;AAAA,OACK;AAgDP,eAAsB,sBAAsB;AAAA,EAC1C;AAAA,EACA,OAAOA;AAAA,EACP;AACF,GAIgC;AAC9B,wBAAsB,YAAY;AAClC,QAAM,CAAC,SAAS,MAAM,QAAQ,eAAe,IAAI,MAAM,aAAa;AAAA,IAClE;AAAA,MACE,WAAW;AAAA,QACT;AAAA,UACE,SAAS;AAAA,UACT,KAAKC;AAAA,UACL,cAAc;AAAA,UACd,MAAM,CAAC,IAAI;AAAA,QACb;AAAA,QACA;AAAA,UACE,SAAS;AAAA,UACT,KAAKA;AAAA,UACL,cAAc;AAAA,QAChB;AAAA,QACA;AAAA,UACE,SAAS;AAAA,UACT,KAAKA;AAAA,UACL,cAAc;AAAA,QAChB;AAAA,QACA;AAAA,UACE,SAAS;AAAA,UACT,KAAKA;AAAA,UACL,cAAc;AAAA,QAChB;AAAA,MACF;AAAA,MACA,cAAc;AAAA,IAChB;AAAA,EACF;AAEA,QAAM,iBAAiB,yBAAyB,aAAa,OAAO,MAAM,CAAC;AAE3E,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,IAAI,MAAM,aAAa,UAAU;AAAA,IAC/B,WAAW;AAAA,MACT;AAAA,QACE,SAAS;AAAA,QACT,KAAK;AAAA,QACL,cAAc;AAAA,MAChB;AAAA,MACA;AAAA,QACE,SAAS;AAAA,QACT,KAAK;AAAA,QACL,cAAc;AAAA,MAChB;AAAA,MACA;AAAA,QACE,SAAS;AAAA,QACT,KAAK;AAAA,QACL,cAAc;AAAA,QACd,MAAM,CAAC,IAAI;AAAA,MACb;AAAA,MACA;AAAA,QACE,SAAS;AAAA,QACT,KAAKA;AAAA,QACL,cAAc;AAAA,MAChB;AAAA,MACA;AAAA,QACE,SAAS;AAAA,QACT,KAAK;AAAA,QACL,cAAc;AAAA,QACd,MAAM,CAAC,IAAI;AAAA,MACb;AAAA,MACA;AAAA,QACE,SAAS,kBAAkB;AAAA,QAC3B,KAAK;AAAA,QACL,cAAc;AAAA,MAChB;AAAA,IACF;AAAA,IACA,cAAc;AAAA,EAChB,CAAC;AAED,QAAM,kBAAkB,iBACpB;AAAA,IACE,cAAc;AAAA,IACd;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,IACA;AAEJ,QAAM,kBAAkB;AAAA,IACtB,kBAAkB;AAAA,IAClB;AAAA,IACA;AAAA,IACA,eAAe,oBAAoB,IAAI;AAAA,IACvC;AAAA,EACF;AAGA,QAAM,YAAa,kBAAkB,kBAAmB,OAAO;AAE/D,QAAM,gBAAgB;AAEtB,QAAM,iBAAkB,kBAAkB,kBAAmB,OAAO;AAEpE,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,WAAW,iBAAiB,WAAW,eAAe;AAAA,IACtD,WAAW;AAAA,MACT,gBAAgB;AAAA,MAChB;AAAA,IACF;AAAA,IACA,WAAW;AAAA,EACb;AACF;AAEA,SAAS,iBAAiB,WAAmB,YAA2B;AACtE,SAAO;AAAA,IACL,KAAK;AAAA,IACL,YAAY,WAAW,YAAY,SAAS,CAAC;AAAA,IAC7C,MAAM,aAAa,YAAY,aAAa;AAAA,IAC5C,aAAa,aACT,WAAW,YAAa,YAAY,aAAc,OAAO,GAAG,CAAC,IAC7D;AAAA,EACN;AACF;AAEA,SAAS,iCACP,cACA,gBACA,gBACA,cACA,gBAAwB,IAChB;AAGR,QAAM,YAAY,eAAe;AACjC,QAAM,cAAc,MAAM;AAC1B,QAAM,cAAc,OAAO,OAAO,aAAa;AAG/C,MAAI,cAAe,YAAY,cAAe;AAI9C,QAAM,eAAe,OAAO,iBAAiB,cAAc;AAC3D,MAAI,eAAe,IAAI;AACrB,mBAAe,OAAO;AAAA,EACxB,WAAW,eAAe,IAAI;AAC5B,mBAAe,OAAO,CAAC;AAAA,EACzB;AAEA,MAAI,CAAC,cAAc;AAKjB,QAAI,gBAAgB,IAAI;AACtB,aAAO;AAAA,IACT;AACA,kBAAe,cAAc,cAAe;AAAA,EAE9C;AAEA,SAAO;AACT;;;AC3OA,SAAS,WAAAC,gBAAe;AAExB;AAAA,EAEE,kBAAAC;AAAA,OAIK;AAOA,SAAS,kBAAkB;AAAA,EAChC;AAAA,EACA;AACF,GAAkD;AAChD,MAAI,CAAC,OAAO,WAAW,SAAS,GAAG;AACjC,UAAM,IAAI,MAAM,uCAAuC;AAAA,EACzD;AAEA,SAAO;AAAA,IACL,KAAKC;AAAA,IACL,SAAS;AAAA,IACT,cAAc;AAAA,IACd,MAAM,CAAC,MAAM;AAAA,EACf;AACF;AAEA,eAAsB,cACpB,MACA,cACA,cACA;AACA,wBAAsB,YAAY;AAClC,QAAM,OAAO,kBAAkB,IAAI;AACnC,QAAM,EAAE,QAAQ,IAAI,MAAM,aAAa,iBAAiB;AAAA,IACtD,GAAG;AAAA,IACH,SAAS,aAAa;AAAA,EACxB,CAAC;AACD,QAAM,OAAO,MAAM,aAAa,cAAc,OAAO;AACrD,QAAM,UAAU,MAAM,aAAa,0BAA0B,EAAE,KAAK,CAAC;AACrE,QAAM,YAAYD,gBAAe,EAAE,KAAKC,UAAS,MAAM,QAAQ,KAAK,CAAC;AACrE,QAAM,aAAa,UAAU;AAAA,IAC3B,CAAC,QAAQ,IAAI,cAAc;AAAA,EAC7B;AAEA,SAAO,EAAE,MAAM,SAAS,WAAW;AACrC;;;AC/CA,SAAkE,cAAc,oBAAoB;AAY7F,IAAM,SAAS,aAAa,aAA4B;AAAA,EAC3D,SAAS;AACb,CAAC,CAAC;;;ACGK,IAAM,iBAAiB,CAAuC,YAAuD;AACxH,UAAQ,QAAQ,UAAU,QAAe,IAAmD;AAAA,IACxF,KAAK;AAAA,IACL,GAAG;AAAA,EACP,CAAC;AACL;AAEO,IAAM,kBAAkB,CAAuC,YAAwD;AAC1H,UAAQ,QAAQ,UAAU,QAAe,IAAoD;AAAA,IACzF,KAAK;AAAA,IACL,GAAG;AAAA,EACP,CAAC;AACL;AAEO,IAAM,aAAa,CAAuC,YAAmD;AAChH,UAAQ,QAAQ,UAAU,QAAe,IAA+C;AAAA,IACpF,KAAK;AAAA,IACL,GAAG;AAAA,EACP,CAAC;AACL;;;ACvCA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAQO,IAAM,gBAAgB,CAC3B,YAEA,WAAW;AAAA,EACT,GAAG;AAAA,EACH,OAAO,EAAE,GAAG,SAAS,OAAO,UAAU,cAAc;AACtD,CAAC;AAEI,IAAM,kBAAkB,CAC7B,YAEA,WAAW;AAAA,EACT,GAAG;AAAA,EACH,OAAO,EAAE,GAAG,SAAS,OAAO,UAAU,iBAAiB;AACzD,CAAC;AAEI,IAAM,kBAAkB,CAC7B,YAEA,WAAW;AAAA,EACT,GAAG;AAAA,EACH,OAAO,EAAE,GAAG,SAAS,OAAO,UAAU,gBAAgB;AACxD,CAAC;AAEI,IAAM,SAAS,CACpB,YAEA,WAAW;AAAA,EACT,GAAG;AAAA,EACH,OAAO,EAAE,GAAG,SAAS,OAAO,UAAU,MAAM;AAC9C,CAAC;AAEI,IAAM,gBAAgB,CAC3B,YAEA,WAAW;AAAA,EACT,GAAG;AAAA,EACH,OAAO,EAAE,GAAG,SAAS,OAAO,UAAU,cAAc;AACtD,CAAC;AAEI,IAAM,sBAAsB,CACjC,YAEA,WAAW;AAAA,EACT,GAAG;AAAA,EACH,OAAO,EAAE,GAAG,SAAS,OAAO,UAAU,qBAAqB;AAC7D,CAAC;","names":["base","parseEventLogs","baseSepolia","parseEventLogs","coinABI","zeroAddress","coinABI","coinABI","parseEventLogs","coinABI"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zoralabs/coins-sdk",
-  "version": "0.0.2-sdkalpha.2",
+  "version": "0.0.2-sdkalpha.3",
   "repository": "https://github.com/ourzora/zora-protocol",
   "license": "MIT",
   "type": "module",
@@ -22,13 +22,15 @@
     }
   },
   "dependencies": {
+    "@hey-api/client-fetch": "^0.8.3",
     "@zoralabs/coins": "^0.5.1-sdkalpha.0"
   },
   "peerDependencies": {
-    "viem": "^2.21.55",
-    "abitype": "^1.0.8"
+    "abitype": "^1.0.8",
+    "viem": "^2.21.55"
   },
   "devDependencies": {
+    "@hey-api/openapi-ts": "^0.64.10",
     "@lavamoat/preinstall-always-fail": "2.0.0",
     "@types/node": "^20.13.0",
     "@types/semver": "^7.5.8",
@@ -48,6 +50,7 @@
     "test:js": "vitest src",
     "test:integration": "vitest test-integration",
     "prettier:write": "prettier --write 'src/**/*.ts' 'test-integration/**/*.ts'",
-    "lint": "prettier --check 'src/**/*.ts' 'test-integration/**/*.ts'"
+    "lint": "prettier --check 'src/**/*.ts' 'test-integration/**/*.ts'",
+    "api-codegen": "openapi-ts"
   }
 }

package/src/actions/createCoin.ts

@@ -90,6 +90,11 @@ export async function createCoin(
     ...createCoinCall(call),
     account: walletClient.account,
   });
+
+  // Add a 1/5th buffer on gas.
+  if (request.gas) {
+    request.gas = request.gas * 6n / 5n;
+  }
   const hash = await walletClient.writeContract(request);
   const receipt = await publicClient.waitForTransactionReceipt({ hash });
   const deployment = getCoinCreateFromLogs(receipt);

package/src/actions/{getCoinDetails.ts → getOnchainCoinDetails.ts}

@@ -1,8 +1,17 @@
 import { coinABI, iUniswapV3PoolABI } from "@zoralabs/coins";
-import { SUPERCHAIN_WETH_ADDRESS, USDC_WETH_POOLS_BY_CHAIN } from "src/constants";
+import {
+  SUPERCHAIN_WETH_ADDRESS,
+  USDC_WETH_POOLS_BY_CHAIN,
+} from "src/constants";
 import { validateClientNetwork } from "src/utils/validateClientNetwork";
-import { Address, erc20Abi, formatEther, isAddressEqual, PublicClient, zeroAddress } from "viem";
-
+import {
+  Address,
+  erc20Abi,
+  formatEther,
+  isAddressEqual,
+  PublicClient,
+  zeroAddress,
+} from "viem";
 
 type Slot0Result = {
   sqrtPriceX96: bigint;
@@ -15,15 +24,15 @@ type Slot0Result = {
 };
 
 type PricingResult = {
-  eth: bigint,
-  usdc: bigint | null,
-  usdcDecimal: number | null,
-  ethDecimal: number,
-}
+  eth: bigint;
+  usdc: bigint | null;
+  usdcDecimal: number | null;
+  ethDecimal: number;
+};
 
 /**
  * Represents the current state of a coin
- * @typedef {Object} CoinDetails
+ * @typedef {Object} OnchainCoinDetails
  * @property {bigint} balance - The user's balance of the coin
  * @property {PricingResult} marketCap - The market cap of the coin
  * @property {PricingResult} liquidity - The liquidity of the coin
@@ -32,14 +41,14 @@ type PricingResult = {
  * @property {Address[]} owners - List of owners for the coin
  * @property {Address} payoutRecipient - The payout recipient address
  */
-export type CoinDetails = {
+export type OnchainCoinDetails = {
   balance: bigint;
   marketCap: PricingResult;
   liquidity: PricingResult;
   pool: Address;
   poolState: Slot0Result;
-  owners: readonly Address[],
-  payoutRecipient: Address,
+  owners: readonly Address[];
+  payoutRecipient: Address;
 };
 
 /**
@@ -48,9 +57,9 @@ export type CoinDetails = {
  * @param {Address} params.coin - The coin contract address
  * @param {Address} params.user - The user address to check balance for
  * @param {PublicClient} params.publicClient - The viem public client instance
- * @returns {Promise<CoinDetails>} The coin's current state
+ * @returns {Promise<OnchainCoinDetails>} The coin's current state
  */
-export async function getCoinDetails({
+export async function getOnchainCoinDetails({
   coin,
   user = zeroAddress,
   publicClient,
@@ -58,91 +67,108 @@ export async function getCoinDetails({
   coin: Address;
   user?: Address;
   publicClient: PublicClient;
-}): Promise<CoinDetails> {
+}): Promise<OnchainCoinDetails> {
   validateClientNetwork(publicClient);
-  const [balance, pool, owners, payoutRecipient] = await publicClient.multicall({
+  const [balance, pool, owners, payoutRecipient] = await publicClient.multicall(
+    {
+      contracts: [
+        {
+          address: coin,
+          abi: coinABI,
+          functionName: "balanceOf",
+          args: [user],
+        },
+        {
+          address: coin,
+          abi: coinABI,
+          functionName: "poolAddress",
+        },
+        {
+          address: coin,
+          abi: coinABI,
+          functionName: "owners",
+        },
+        {
+          address: coin,
+          abi: coinABI,
+          functionName: "payoutRecipient",
+        },
+      ],
+      allowFailure: false,
+    },
+  );
+
+  const USDC_WETH_POOL = USDC_WETH_POOLS_BY_CHAIN[publicClient.chain?.id || 0];
+
+  const [
+    coinWethPoolSlot0,
+    coinWethPoolToken0,
+    coinReservesRaw,
+    coinTotalSupply,
+    wethReservesRaw,
+    usdcWethSlot0,
+  ] = await publicClient.multicall({
     contracts: [
+      {
+        address: pool,
+        abi: iUniswapV3PoolABI,
+        functionName: "slot0",
+      },
+      {
+        address: pool,
+        abi: iUniswapV3PoolABI,
+        functionName: "token0",
+      },
       {
         address: coin,
-        abi: coinABI,
+        abi: erc20Abi,
         functionName: "balanceOf",
-        args: [user],
+        args: [pool],
       },
       {
         address: coin,
         abi: coinABI,
-        functionName: "poolAddress",
+        functionName: "totalSupply",
       },
       {
-        address: coin,
-        abi: coinABI,
-        functionName: 'owners',
+        address: SUPERCHAIN_WETH_ADDRESS,
+        abi: erc20Abi,
+        functionName: "balanceOf",
+        args: [pool],
       },
       {
-        address: coin,
-        abi: coinABI,
-        functionName: 'payoutRecipient',
-      }
+        address: USDC_WETH_POOL ?? coin,
+        abi: iUniswapV3PoolABI,
+        functionName: "slot0",
+      },
     ],
     allowFailure: false,
   });
 
-  const USDC_WETH_POOL = USDC_WETH_POOLS_BY_CHAIN[publicClient.chain?.id || 0];
-
-  const [coinWethPoolSlot0, coinWethPoolToken0, coinReservesRaw, coinTotalSupply, wethReservesRaw, usdcWethSlot0] = await publicClient.multicall({
-    contracts: [{
-      address: pool,
-      abi: iUniswapV3PoolABI,
-      functionName: "slot0",
-    },
-    {
-      address: pool,
-      abi: iUniswapV3PoolABI,
-      functionName: 'token0'
-    }, {
-      address: coin,
-      abi: erc20Abi,
-      functionName: 'balanceOf',
-      args: [pool],
-    },
-    {
-      address: coin,
-      abi: coinABI,
-      functionName: 'totalSupply',
-    }, {
-      address: SUPERCHAIN_WETH_ADDRESS,
-      abi: erc20Abi,
-      functionName: 'balanceOf',
-      args: [pool],
-    }, {
-      address: USDC_WETH_POOL ?? coin,
-      abi: iUniswapV3PoolABI,
-      functionName: 'slot0',
-    }], allowFailure: false
-  });
-
-  const wethPriceInUsdc = USDC_WETH_POOL ? uniswapV3SqrtPriceToBigIntScaled(
-    usdcWethSlot0.sqrtPriceX96,
-    18,
-    6,
-    true,
-    18
-  ) : null;
+  const wethPriceInUsdc = USDC_WETH_POOL
+    ? uniswapV3SqrtPriceToBigIntScaled(
+        usdcWethSlot0.sqrtPriceX96,
+        18,
+        6,
+        true,
+        18,
+      )
+    : null;
 
   const coinPriceInWeth = uniswapV3SqrtPriceToBigIntScaled(
     coinWethPoolSlot0.sqrtPriceX96,
     18,
     18,
     isAddressEqual(coinWethPoolToken0, coin),
-    18
+    18,
   );
 
   // Divide by 10^18 to remove percision from `coinPriceInWeth` after math since bigint is decimal.
-  const marketCap = coinPriceInWeth * coinTotalSupply / 10n ** 18n;
+  const marketCap = (coinPriceInWeth * coinTotalSupply) / 10n ** 18n;
 
   const wethLiquidity = wethReservesRaw;
   // Divide by 10^18 to remove percision from `coinPriceInWeth` after math since bigint is decimal.
-  const tokenLiquidity = coinReservesRaw * coinPriceInWeth / 10n ** 18n;
+  const tokenLiquidity = (coinReservesRaw * coinPriceInWeth) / 10n ** 18n;
 
   return {
     balance,
@@ -150,14 +176,23 @@ export async function getCoinDetails({
     owners,
     payoutRecipient,
     marketCap: convertEthOutput(marketCap, wethPriceInUsdc),
-    liquidity: convertEthOutput(wethLiquidity + tokenLiquidity, wethPriceInUsdc),
+    liquidity: convertEthOutput(
+      wethLiquidity + tokenLiquidity,
+      wethPriceInUsdc,
+    ),
     poolState: coinWethPoolSlot0,
   };
 }
 
-
 function convertEthOutput(amountETH: bigint, wethToUsdc: bigint | null) {
-  return { eth: amountETH, ethDecimal: parseFloat(formatEther(amountETH)), usdc: wethToUsdc ? amountETH * wethToUsdc : null, usdcDecimal: wethToUsdc ? parseFloat(formatEther(amountETH * wethToUsdc / 10n ** 18n)) : null }
+  return {
+    eth: amountETH,
+    ethDecimal: parseFloat(formatEther(amountETH)),
+    usdc: wethToUsdc ? amountETH * wethToUsdc : null,
+    usdcDecimal: wethToUsdc
+      ? parseFloat(formatEther((amountETH * wethToUsdc) / 10n ** 18n))
+      : null,
+  };
 }
 
 function uniswapV3SqrtPriceToBigIntScaled(
@@ -165,7 +200,7 @@ function uniswapV3SqrtPriceToBigIntScaled(
   token0Decimals: number,
   token1Decimals: number,
   isToken0Coin: boolean,
-  scaleDecimals: number = 18
+  scaleDecimals: number = 18,
 ): bigint {
   // (sqrtPrice^2 / 2^192) => ratio
   // We'll do: ratioScaled = (sqrtPrice^2 * 10^scaleDecimals) / 2^192
@@ -182,7 +217,7 @@ function uniswapV3SqrtPriceToBigIntScaled(
   if (decimalsDiff > 0n) {
     ratioScaled *= 10n ** decimalsDiff;
   } else if (decimalsDiff < 0n) {
-    ratioScaled /= 10n ** (-decimalsDiff);
+    ratioScaled /= 10n ** -decimalsDiff;
   }
 
   if (!isToken0Coin) {