@zoralabs/coins-sdk 0.5.0 → 0.5.2

package/dist/uploader/providers/zora.d.ts

@@ -1,5 +1,5 @@
 import { Address } from "viem";
-import { Uploader, UploadResult } from "../types";
+import { Uploader, UploadOptions, UploadResult } from "../types";
 /**
  * Zora IPFS uploader implementation
  */
@@ -8,8 +8,11 @@ export declare class ZoraUploader implements Uploader {
     private creatorAddress;
     private jwtApiKey;
     private jwtApiKeyExpiresAt;
-    getJWTApiKey(): Promise<string>;
-    upload(file: File): Promise<UploadResult>;
+    private invalidateJwt;
+    private getJWTApiKey;
+    private buildUploadSignal;
+    private doUpload;
+    upload(file: File, options?: UploadOptions): Promise<UploadResult>;
 }
 /**
  * Create a new Zora IPFS uploader

package/dist/uploader/providers/zora.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zora.d.ts","sourceRoot":"","sources":["../../../src/uploader/providers/zora.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAIlD;;GAEG;AACH,qBAAa,YAAa,YAAW,QAAQ;gBAC/B,cAAc,EAAE,OAAO;IAOnC,OAAO,CAAC,cAAc,CAAU;IAChC,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,kBAAkB,CAAqB;IAEzC,YAAY;IAsBZ,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC;CAkChD;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,cAAc,EAAE,OAAO,GACtB,QAAQ,CAEV"}
+{"version":3,"file":"zora.d.ts","sourceRoot":"","sources":["../../../src/uploader/providers/zora.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAOjE;;GAEG;AACH,qBAAa,YAAa,YAAW,QAAQ;gBAC/B,cAAc,EAAE,OAAO;IAOnC,OAAO,CAAC,cAAc,CAAU;IAChC,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,kBAAkB,CAAqB;IAE/C,OAAO,CAAC,aAAa;YAKP,YAAY;IA8B1B,OAAO,CAAC,iBAAiB;YAWX,QAAQ;IAmBhB,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;CA8BzE;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,cAAc,EAAE,OAAO,GACtB,QAAQ,CAEV"}

package/dist/uploader/types.d.ts

@@ -7,11 +7,20 @@ export type UploadResult = {
     size: number | undefined;
     mimeType: string | undefined;
 };
+/**
+ * Options for file upload operations
+ */
+export type UploadOptions = {
+    /** AbortSignal to cancel the upload */
+    signal?: AbortSignal;
+    /** Timeout in milliseconds for the upload request (no default) */
+    timeout?: number;
+};
 /**
  * Interface for file uploaders (IPFS, Arweave, etc.)
  */
 export interface Uploader {
-    upload(file: File): Promise<UploadResult>;
+    upload(file: File, options?: UploadOptions): Promise<UploadResult>;
 }
 export type CreateMetadataParameters = {
     name: string;

package/dist/uploader/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/uploader/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GACxB,UAAU,MAAM,EAAE,GAClB,QAAQ,MAAM,EAAE,GAChB,QAAQ,MAAM,EAAE,GAChB,WAAW,MAAM,EAAE,CAAC;AAExB;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,EAAE,gBAAgB,CAAC;IACtB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CAC3C;AAED,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE;QACR,IAAI,EAAE,SAAS,CAAC;QAChB,GAAG,EAAE,gBAAgB,CAAC;KACvB,CAAC;CACH,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/uploader/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GACxB,UAAU,MAAM,EAAE,GAClB,QAAQ,MAAM,EAAE,GAChB,QAAQ,MAAM,EAAE,GAChB,WAAW,MAAM,EAAE,CAAC;AAExB;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,EAAE,gBAAgB,CAAC;IACtB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,uCAAuC;IACvC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CACpE;AAED,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE;QACR,IAAI,EAAE,SAAS,CAAC;QAChB,GAAG,EAAE,gBAAgB,CAAC;KACvB,CAAC;CACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zoralabs/coins-sdk",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "repository": "https://github.com/ourzora/zora-protocol",
   "license": "MIT",
   "type": "module",
@@ -46,7 +46,7 @@
     "@zoralabs/tsconfig": "^0.0.1"
   },
   "engines": {
-    "node": ">=22"
+    "node": ">=20"
   },
   "scripts": {
     "build": "pnpm tsup",

package/src/actions/tradeCoin.ts

@@ -247,7 +247,14 @@ export async function createTradeCall(
 
   if (!quote.data) {
     console.error(quote);
-    throw new Error("Quote failed");
+    const errorBody = quote.error as
+      | { error?: string; errorType?: string }
+      | undefined;
+    const errorMessage = errorBody?.error || "Quote failed";
+    const err = new Error(errorMessage);
+    (err as any).errorType = errorBody?.errorType;
+    (err as any).errorBody = errorBody;
+    throw err;
   }
 
   return quote.data;

package/src/api/api-raw.ts

@@ -1,4 +1,5 @@
 import { client } from "../client/client.gen";
+import { createConfig } from "@hey-api/client-fetch";
 import { getApiKeyMeta } from "./api-key";
 
 export const apiGet = (path: string, data?: Record<string, unknown>) =>
@@ -6,3 +7,7 @@ export const apiGet = (path: string, data?: Record<string, unknown>) =>
 
 export const apiPost = (path: string, data?: Record<string, unknown>) =>
   client.post({ url: path, body: data, ...getApiKeyMeta() });
+
+export const setApiBaseUrl = (baseUrl: string) => {
+  client.setConfig(createConfig({ baseUrl }));
+};

package/src/api/queries.ts

@@ -27,6 +27,8 @@ import {
   GetContentCoinPoolConfigResponse,
   GetCreatorCoinPoolConfigData,
   GetCreatorCoinPoolConfigResponse,
+  GetCreatorLivestreamCommentsData,
+  GetCreatorLivestreamCommentsResponse,
 } from "../client/types.gen";
 import {
   getCoin as getCoinSDK,
@@ -43,6 +45,7 @@ import {
   getTraderLeaderboard as getTraderLeaderboardSDK,
   getContentCoinPoolConfig as getContentCoinPoolConfigSDK,
   getCreatorCoinPoolConfig as getCreatorCoinPoolConfigSDK,
+  getCreatorLivestreamComments as getCreatorLivestreamCommentsSDK,
 } from "../client/sdk.gen";
 import { getApiKeyMeta } from "./api-key";
 import { RequestOptionsType } from "./query-types";
@@ -263,3 +266,22 @@ export const getCreatorCoinPoolConfig = async (
     ...options,
   });
 };
+
+type GetCreatorLivestreamCommentsQuery =
+  GetCreatorLivestreamCommentsData["query"];
+export type {
+  GetCreatorLivestreamCommentsQuery,
+  GetCreatorLivestreamCommentsData,
+};
+export type { GetCreatorLivestreamCommentsResponse } from "../client/types.gen";
+
+export const getCreatorLivestreamComments = async (
+  query: GetCreatorLivestreamCommentsQuery,
+  options?: RequestOptionsType<GetCreatorLivestreamCommentsData>,
+): Promise<RequestResult<GetCreatorLivestreamCommentsResponse>> => {
+  return await getCreatorLivestreamCommentsSDK({
+    query,
+    ...getApiKeyMeta(),
+    ...options,
+  });
+};

package/src/client/sdk.gen.ts

@@ -14,6 +14,8 @@ import type {
   GetCoinCommentsResponse,
   GetCoinHoldersData,
   GetCoinHoldersResponse,
+  GetCoinPriceHistoryData,
+  GetCoinPriceHistoryResponse,
   GetCoinSwapsData,
   GetCoinSwapsResponse,
   GetCoinsData,
@@ -26,6 +28,8 @@ import type {
   SetCreateUploadJwtResponse,
   GetCreatorCoinPoolConfigData,
   GetCreatorCoinPoolConfigResponse,
+  GetCreatorLivestreamCommentsData,
+  GetCreatorLivestreamCommentsResponse,
   GetExploreData,
   GetExploreResponse,
   GetFeaturedCreatorsData,
@@ -164,6 +168,28 @@ export const getCoinHolders = <ThrowOnError extends boolean = false>(
   });
 };
 
+/**
+ * zoraSDK_coinPriceHistory query
+ */
+export const getCoinPriceHistory = <ThrowOnError extends boolean = false>(
+  options: Options<GetCoinPriceHistoryData, ThrowOnError>,
+) => {
+  return (options.client ?? _heyApiClient).get<
+    GetCoinPriceHistoryResponse,
+    unknown,
+    ThrowOnError
+  >({
+    security: [
+      {
+        name: "api-key",
+        type: "apiKey",
+      },
+    ],
+    url: "/coinPriceHistory",
+    ...options,
+  });
+};
+
 /**
  * zoraSDK_coinSwaps query
  */
@@ -300,6 +326,30 @@ export const getCreatorCoinPoolConfig = <ThrowOnError extends boolean = false>(
   });
 };
 
+/**
+ * zoraSDK_creatorLivestreamComments query
+ */
+export const getCreatorLivestreamComments = <
+  ThrowOnError extends boolean = false,
+>(
+  options: Options<GetCreatorLivestreamCommentsData, ThrowOnError>,
+) => {
+  return (options.client ?? _heyApiClient).get<
+    GetCreatorLivestreamCommentsResponse,
+    unknown,
+    ThrowOnError
+  >({
+    security: [
+      {
+        name: "api-key",
+        type: "apiKey",
+      },
+    ],
+    url: "/creatorLivestreamComments",
+    ...options,
+  });
+};
+
 /**
  * zoraSDK_explore query
  */

package/src/client/types.gen.ts

@@ -653,6 +653,90 @@ export type GetCoinHoldersResponses = {
 export type GetCoinHoldersResponse =
   GetCoinHoldersResponses[keyof GetCoinHoldersResponses];
 
+export type GetCoinPriceHistoryData = {
+  body?: never;
+  path?: never;
+  query: {
+    address: string;
+    chain?: number;
+  };
+  url: "/coinPriceHistory";
+};
+
+export type GetCoinPriceHistoryErrors = {
+  /**
+   * Bad request
+   */
+  400: unknown;
+  /**
+   * Internal server error
+   */
+  500: unknown;
+};
+
+export type GetCoinPriceHistoryResponses = {
+  /**
+   * Successful operation
+   */
+  200: {
+    zora20Token?: {
+      oneHour: Array<{
+        /**
+         * Date with time (isoformat)
+         */
+        timestamp: 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.
+         */
+        closePrice: string;
+      }>;
+      oneDay: Array<{
+        /**
+         * Date with time (isoformat)
+         */
+        timestamp: 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.
+         */
+        closePrice: string;
+      }>;
+      oneWeek: Array<{
+        /**
+         * Date with time (isoformat)
+         */
+        timestamp: 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.
+         */
+        closePrice: string;
+      }>;
+      oneMonth: Array<{
+        /**
+         * Date with time (isoformat)
+         */
+        timestamp: 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.
+         */
+        closePrice: string;
+      }>;
+      all: Array<{
+        /**
+         * Date with time (isoformat)
+         */
+        timestamp: 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.
+         */
+        closePrice: string;
+      }>;
+    };
+  };
+};
+
+export type GetCoinPriceHistoryResponse =
+  GetCoinPriceHistoryResponses[keyof GetCoinPriceHistoryResponses];
+
 export type GetCoinSwapsData = {
   body?: never;
   path?: never;
@@ -1356,6 +1440,193 @@ export type GetCreatorCoinPoolConfigResponses = {
 export type GetCreatorCoinPoolConfigResponse =
   GetCreatorCoinPoolConfigResponses[keyof GetCreatorCoinPoolConfigResponses];
 
+export type GetCreatorLivestreamCommentsData = {
+  body?: never;
+  path?: never;
+  query: {
+    address: string;
+    chain?: number;
+    after?: string;
+    count?: number;
+  };
+  url: "/creatorLivestreamComments";
+};
+
+export type GetCreatorLivestreamCommentsErrors = {
+  /**
+   * Bad request
+   */
+  400: unknown;
+  /**
+   * Internal server error
+   */
+  500: unknown;
+};
+
+export type GetCreatorLivestreamCommentsResponses = {
+  /**
+   * Successful operation
+   */
+  200: {
+    zora20Token?: {
+      creatorProfile?: {
+        liveStream?: {
+          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<{
+              /**
+               * 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.
+               */
+              cursor: string;
+              node: {
+                /**
+                 * The Globally Unique ID of this object
+                 */
+                id: 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.
+                 */
+                commentId: 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.
+                 */
+                comment: string;
+                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;
+                  /**
+                   * The `Boolean` scalar type represents `true` or `false`.
+                   */
+                  platformBlocked: boolean;
+                  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.
+                       */
+                      medium: 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;
+                    };
+                  };
+                  socialAccounts: {
+                    instagram?: {
+                      /**
+                       * 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.
+                       */
+                      username?: 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.
+                       */
+                      displayName?: string;
+                      /**
+                       * The `Int` scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.
+                       */
+                      followerCount?: number;
+                      /**
+                       * 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.
+                       */
+                      id?: string;
+                    };
+                    tiktok?: {
+                      /**
+                       * 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.
+                       */
+                      username?: 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.
+                       */
+                      displayName?: string;
+                      /**
+                       * The `Int` scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.
+                       */
+                      followerCount?: number;
+                      /**
+                       * 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.
+                       */
+                      id?: string;
+                    };
+                    twitter?: {
+                      /**
+                       * 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.
+                       */
+                      username?: 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.
+                       */
+                      displayName?: string;
+                      /**
+                       * The `Int` scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.
+                       */
+                      followerCount?: number;
+                      /**
+                       * 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.
+                       */
+                      id?: string;
+                    };
+                    farcaster?: {
+                      /**
+                       * 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.
+                       */
+                      username?: 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.
+                       */
+                      displayName?: string;
+                      /**
+                       * The `Int` scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.
+                       */
+                      followerCount?: number;
+                      /**
+                       * 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.
+                       */
+                      id?: string;
+                    };
+                  };
+                  creatorCoin?: {
+                    address: string;
+                  };
+                };
+              };
+            }>;
+          };
+        };
+      };
+    };
+  };
+};
+
+export type GetCreatorLivestreamCommentsResponse =
+  GetCreatorLivestreamCommentsResponses[keyof GetCreatorLivestreamCommentsResponses];
+
 export type GetExploreData = {
   body?: never;
   path?: never;
@@ -2241,10 +2512,52 @@ export type GetProfileBalancesResponses = {
              * 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.
              */
             balance: 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.
+             */
+            walletBalance: string;
             /**
              * The Globally Unique ID of this object
              */
             id: string;
+            valuation?: {
+              /**
+               * 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.
+               */
+              marketValueUsd?: 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.
+               */
+              faceValueUsd?: string;
+              /**
+               * The `Int` scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.
+               */
+              blockNumber?: number;
+              maxSwappable?: {
+                /**
+                 * Raw amount of the currency, in wei. Not formatted with decimals
+                 */
+                amountRaw: string;
+                /**
+                 * Amount of the currency, in float format accounting for currency decimals
+                 */
+                amountDecimal: number;
+              };
+              currencyAmount: {
+                /**
+                 * Raw amount of the currency, in wei. Not formatted with decimals
+                 */
+                amountRaw: string;
+                /**
+                 * Amount of the currency, in float format accounting for currency decimals
+                 */
+                amountDecimal: number;
+              };
+              /**
+               * 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.
+               */
+              error?: string;
+            };
             coin?: {
               /**
                * The Globally Unique ID of this object
@@ -3819,6 +4132,10 @@ export type GetTrendsByNameResponses = {
   200: {
     trendsByName: {
       pageInfo: {
+        /**
+         * When paginating forwards, are there more items?
+         */
+        hasNextPage: boolean;
         /**
          * When paginating backwards, the cursor to continue.
          */
@@ -4127,10 +4444,26 @@ export type PostQuoteData = {
 
 export type PostQuoteErrors = {
   /**
-   * Error
+   * Liquidity error — not enough pool liquidity for the requested trade
+   */
+  422: {
+    success: "false";
+    error: string;
+    /**
+     * The type of error. LIQUIDITY indicates insufficient pool liquidity for the requested trade.
+     */
+    errorType: "LIQUIDITY" | "UNKNOWN";
+  };
+  /**
+   * Server error
    */
   500: {
-    error?: string;
+    success: "false";
+    error: string;
+    /**
+     * The type of error. LIQUIDITY indicates insufficient pool liquidity for the requested trade.
+     */
+    errorType: "LIQUIDITY" | "UNKNOWN";
   };
 };
 

package/src/index.ts

@@ -36,7 +36,7 @@ export type * from "./api/explore";
 export { setApiKey } from "./api/api-key";
 
 // Raw API helpers
-export { apiGet, apiPost } from "./api/api-raw";
+export { apiGet, apiPost, setApiBaseUrl } from "./api/api-raw";
 
 // Metadata Validation Utils
 export * from "./metadata";