@zoralabs/coins-sdk 0.7.0 → 0.8.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zoralabs/coins-sdk",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "repository": "https://github.com/ourzora/zora-protocol",
   "license": "MIT",
   "type": "module",
@@ -23,11 +23,11 @@
   },
   "dependencies": {
     "@hey-api/client-fetch": "^0.8.3",
-    "@zoralabs/protocol-deployments": "^0.7.5"
+    "@zoralabs/protocol-deployments": "^0.7.6"
   },
   "peerDependencies": {
     "abitype": "^1.0.8",
-    "viem": "2.22.12"
+    "viem": "2.53.1"
   },
   "devDependencies": {
     "@hey-api/openapi-ts": "^0.64.10",

package/src/api/queries.ts

@@ -1,6 +1,8 @@
 import {
   GetCoinCommentsData,
   GetCoinCommentsResponse,
+  GetCoinMergedCommentsData,
+  GetCoinMergedCommentsResponse,
   GetCoinData,
   GetCoinHoldersData,
   GetCoinHoldersResponse,
@@ -38,6 +40,7 @@ import {
   getCoin as getCoinSDK,
   getCoins as getCoinsSDK,
   getCoinComments as getCoinCommentsSDK,
+  getCoinMergedComments as getCoinMergedCommentsSDK,
   getCoinHolders as getCoinHoldersSDK,
   getCoinPriceHistory as getCoinPriceHistorySDK,
   getCoinSwaps as getCoinSwapsSDK,
@@ -153,6 +156,28 @@ export const getCoinComments = async (
   });
 };
 
+type GetCoinMergedCommentsQuery = GetCoinMergedCommentsData["query"];
+export type { GetCoinMergedCommentsQuery, GetCoinMergedCommentsData };
+export type { GetCoinMergedCommentsResponse } from "../client/types.gen";
+
+/**
+ * Fetches a coin's unified comment feed — on-chain, backfilled, and off-chain
+ * comments — pre-sorted newest-first under a single cursor. Mirrors the
+ * `GraphQLMergedComment` union that web and mobile consume. Unlike
+ * {@link getCoinComments} (on-chain `zoraComments` only), this includes
+ * off-chain comments.
+ */
+export const getCoinMergedComments = async (
+  query: GetCoinMergedCommentsQuery,
+  options?: RequestOptionsType<GetCoinMergedCommentsData>,
+): Promise<RequestResult<GetCoinMergedCommentsResponse>> => {
+  return await getCoinMergedCommentsSDK({
+    query,
+    ...getApiKeyMeta(),
+    ...options,
+  });
+};
+
 type GetProfileQuery = GetProfileData["query"];
 export type { GetProfileQuery, GetProfileData };
 export type { GetProfileResponse } from "../client/types.gen";

package/src/client/sdk.gen.ts

@@ -14,6 +14,8 @@ import type {
   GetCoinCommentsResponse,
   GetCoinHoldersData,
   GetCoinHoldersResponse,
+  GetCoinMergedCommentsData,
+  GetCoinMergedCommentsResponse,
   GetCoinPriceHistoryData,
   GetCoinPriceHistoryResponse,
   GetCoinSwapsData,
@@ -172,6 +174,28 @@ export const getCoinHolders = <ThrowOnError extends boolean = false>(
   });
 };
 
+/**
+ * zoraSDK_coinMergedComments query
+ */
+export const getCoinMergedComments = <ThrowOnError extends boolean = false>(
+  options: Options<GetCoinMergedCommentsData, ThrowOnError>,
+) => {
+  return (options.client ?? _heyApiClient).get<
+    GetCoinMergedCommentsResponse,
+    unknown,
+    ThrowOnError
+  >({
+    security: [
+      {
+        name: "api-key",
+        type: "apiKey",
+      },
+    ],
+    url: "/coinMergedComments",
+    ...options,
+  });
+};
+
 /**
  * zoraSDK_coinPriceHistory query
  */

package/src/client/types.gen.ts

@@ -653,6 +653,220 @@ export type GetCoinHoldersResponses = {
 export type GetCoinHoldersResponse =
   GetCoinHoldersResponses[keyof GetCoinHoldersResponses];
 
+export type GetCoinMergedCommentsData = {
+  body?: never;
+  path?: never;
+  query: {
+    address: string;
+    chain?: number;
+    after?: string;
+    count?: number;
+  };
+  url: "/coinMergedComments";
+};
+
+export type GetCoinMergedCommentsErrors = {
+  /**
+   * Bad request
+   */
+  400: unknown;
+  /**
+   * Internal server error
+   */
+  500: unknown;
+};
+
+export type GetCoinMergedCommentsResponses = {
+  /**
+   * Successful operation
+   */
+  200: {
+    zora20Token?: {
+      comments: {
+        pageInfo: {
+          /**
+           * When paginating forwards, the cursor to continue.
+           */
+          endCursor?: string;
+          /**
+           * When paginating forwards, are there more items?
+           */
+          hasNextPage: boolean;
+        };
+        /**
+         * The `Int` scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.
+         */
+        count: number;
+        edges: Array<{
+          /**
+           * A comment from any source in the merged feed: an on-chain comment (`GraphQLComment`), a backfilled on-chain comment (`GraphQLBackfilledComment`), or an off-chain comment (`GraphQLOffChainComment`).
+           */
+          node: {
+            /**
+             * The `String` scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.
+             */
+            commentId: string;
+            /**
+             * The `String` scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.
+             */
+            nonce: string;
+            userAddress: string;
+            /**
+             * The `String` scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.
+             */
+            txHash: string;
+            /**
+             * The `String` scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.
+             */
+            comment: string;
+            /**
+             * The `Int` scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.
+             */
+            timestamp: number;
+            userProfile?: {
+              /**
+               * The Globally Unique ID of this object
+               */
+              id: string;
+              /**
+               * Manually set username, or truncated wallet address if the profile isn't a GraphQLAccountProfile. For full wallet address, use the profile_id field instead.
+               */
+              handle: string;
+              avatar?: {
+                previewImage: {
+                  /**
+                   * The `String` scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.
+                   */
+                  blurhash?: string;
+                  /**
+                   * The `String` scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.
+                   */
+                  small: string;
+                  /**
+                   * The `String` scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.
+                   */
+                  medium: string;
+                };
+              };
+            };
+            replies: {
+              /**
+               * The `Int` scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.
+               */
+              count: number;
+              edges: Array<{
+                node: {
+                  /**
+                   * The `String` scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.
+                   */
+                  commentId: string;
+                  contractAddress: string;
+                  /**
+                   * The `String` scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.
+                   */
+                  text: string;
+                  /**
+                   * Date with time (isoformat)
+                   */
+                  commentedAt: string;
+                  /**
+                   * The `String` scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.
+                   */
+                  replyToOnChainId?: string;
+                  /**
+                   * The `String` scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.
+                   */
+                  replyToOffChainId?: string;
+                  /**
+                   * The `Int` scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.
+                   */
+                  sparkCount: number;
+                  profile?: {
+                    /**
+                     * The Globally Unique ID of this object
+                     */
+                    id: string;
+                    /**
+                     * Manually set username, or truncated wallet address if the profile isn't a GraphQLAccountProfile. For full wallet address, use the profile_id field instead.
+                     */
+                    handle: string;
+                    avatar?: {
+                      previewImage: {
+                        /**
+                         * The `String` scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.
+                         */
+                        blurhash?: string;
+                        /**
+                         * The `String` scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.
+                         */
+                        small: string;
+                        /**
+                         * The `String` scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.
+                         */
+                        medium: string;
+                      };
+                    };
+                  };
+                };
+              }>;
+            };
+            contractAddress: string;
+            /**
+             * The `String` scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.
+             */
+            text: string;
+            /**
+             * Date with time (isoformat)
+             */
+            commentedAt: string;
+            /**
+             * The `String` scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.
+             */
+            replyToOnChainId?: string;
+            /**
+             * The `String` scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.
+             */
+            replyToOffChainId?: string;
+            /**
+             * The `Int` scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.
+             */
+            sparkCount: number;
+            profile?: {
+              /**
+               * The Globally Unique ID of this object
+               */
+              id: string;
+              /**
+               * Manually set username, or truncated wallet address if the profile isn't a GraphQLAccountProfile. For full wallet address, use the profile_id field instead.
+               */
+              handle: string;
+              avatar?: {
+                previewImage: {
+                  /**
+                   * The `String` scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.
+                   */
+                  blurhash?: string;
+                  /**
+                   * The `String` scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.
+                   */
+                  small: string;
+                  /**
+                   * The `String` scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.
+                   */
+                  medium: string;
+                };
+              };
+            };
+          };
+        }>;
+      };
+    };
+  };
+};
+
+export type GetCoinMergedCommentsResponse =
+  GetCoinMergedCommentsResponses[keyof GetCoinMergedCommentsResponses];
+
 export type GetCoinPriceHistoryData = {
   body?: never;
   path?: never;
@@ -1657,7 +1871,9 @@ export type GetExploreData = {
       | "TRENDING_CREATORS"
       | "TRENDING_ALL"
       | "TOP_VOLUME_TRENDS_24H"
-      | "MOST_VALUABLE_ALL";
+      | "MOST_VALUABLE_ALL"
+      | "TRENDING_AGENTS"
+      | "MOST_VALUABLE_AGENTS";
     count?: number;
     after?: string;
   };