@coinbase/cdp-sdk 1.3.1 → 1.4.0

package/_esm/auth/utils/ws.js

@@ -0,0 +1,28 @@
+import { getCorrelationData } from "./http.js";
+import { generateJwt } from "./jwt.js";
+/**
+ * Gets authentication headers for a WebSocket connection.
+ *
+ * @param options - The configuration options for generating WebSocket auth headers
+ * @returns Object containing the authentication headers
+ */
+export async function getWebSocketAuthHeaders(options) {
+    const headers = {};
+    // Generate and add JWT token without request parameters for WebSocket
+    const jwt = await generateJwt({
+        apiKeyId: options.apiKeyId,
+        apiKeySecret: options.apiKeySecret,
+        // All request parameters are null for WebSocket
+        requestMethod: null,
+        requestHost: null,
+        requestPath: null,
+        expiresIn: options.expiresIn,
+        audience: options.audience,
+    });
+    headers["Authorization"] = `Bearer ${jwt}`;
+    headers["Content-Type"] = "application/json";
+    // Add correlation data
+    headers["Correlation-Context"] = getCorrelationData(options.source, options.sourceVersion);
+    return headers;
+}
+//# sourceMappingURL=ws.js.map

package/_esm/auth/utils/ws.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws.js","sourceRoot":"","sources":["../../../auth/utils/ws.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AA6CvC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,OAAuC;IAEvC,MAAM,OAAO,GAA2B,EAAE,CAAC;IAE3C,sEAAsE;IACtE,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC;QAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,gDAAgD;QAChD,aAAa,EAAE,IAAI;QACnB,WAAW,EAAE,IAAI;QACjB,WAAW,EAAE,IAAI;QACjB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ;KAC3B,CAAC,CAAC;IACH,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,GAAG,EAAE,CAAC;IAC3C,OAAO,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAC;IAE7C,uBAAuB;IACvB,OAAO,CAAC,qBAAqB,CAAC,GAAG,kBAAkB,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IAE3F,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/_esm/client/cdp.js

@@ -1,4 +1,4 @@
-import { AnalyticsConfig } from "../analytics.js";
+import { wrapClassWithErrorTracking } from "../analytics.js";
 import { CdpOpenApiClient } from "../openapi-client/index.js";
 import { version } from "../version.js";
 import { EvmClient } from "./evm/evm.js";
@@ -89,7 +89,11 @@ For more information, see: https://github.com/coinbase/cdp-sdk/blob/main/typescr
             source: "sdk",
             sourceVersion: version,
         });
-        AnalyticsConfig.set(apiKeyId);
+        if (process.env.DISABLE_CDP_ERROR_REPORTING !== "true") {
+            wrapClassWithErrorTracking(CdpClient, apiKeyId);
+            wrapClassWithErrorTracking(EvmClient, apiKeyId);
+            wrapClassWithErrorTracking(SolanaClient, apiKeyId);
+        }
         this.evm = new EvmClient();
         this.solana = new SolanaClient();
     }

package/_esm/client/cdp.js.map

@@ -1 +1 @@
-{"version":3,"file":"cdp.js","sourceRoot":"","sources":["../../client/cdp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAelD;;GAEG;AACH,MAAM,OAAO,SAAS;IACpB,4CAA4C;IACrC,GAAG,CAAY;IAEtB,+CAA+C;IACxC,MAAM,CAAe;IAE5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACH,YAAY,UAA4B,EAAE;QACxC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;QAChG,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;QAC5E,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;QAE3E,IAAI,CAAC,QAAQ,IAAI,CAAC,YAAY,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BrB,CAAC,CAAC;QACC,CAAC;QAED,gBAAgB,CAAC,SAAS,CAAC;YACzB,GAAG,OAAO;YACV,QAAQ;YACR,YAAY;YACZ,YAAY;YACZ,MAAM,EAAE,KAAK;YACb,aAAa,EAAE,OAAO;SACvB,CAAC,CAAC;QAEH,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAE9B,IAAI,CAAC,GAAG,GAAG,IAAI,SAAS,EAAE,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;IACnC,CAAC;CACF"}
+{"version":3,"file":"cdp.js","sourceRoot":"","sources":["../../client/cdp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAelD;;GAEG;AACH,MAAM,OAAO,SAAS;IACpB,4CAA4C;IACrC,GAAG,CAAY;IAEtB,+CAA+C;IACxC,MAAM,CAAe;IAE5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACH,YAAY,UAA4B,EAAE;QACxC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;QAChG,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;QAC5E,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;QAE3E,IAAI,CAAC,QAAQ,IAAI,CAAC,YAAY,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BrB,CAAC,CAAC;QACC,CAAC;QAED,gBAAgB,CAAC,SAAS,CAAC;YACzB,GAAG,OAAO;YACV,QAAQ;YACR,YAAY;YACZ,YAAY;YACZ,MAAM,EAAE,KAAK;YACb,aAAa,EAAE,OAAO;SACvB,CAAC,CAAC;QAEH,IAAI,OAAO,CAAC,GAAG,CAAC,2BAA2B,KAAK,MAAM,EAAE,CAAC;YACvD,0BAA0B,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;YAChD,0BAA0B,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;YAChD,0BAA0B,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;QACrD,CAAC;QAED,IAAI,CAAC,GAAG,GAAG,IAAI,SAAS,EAAE,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;IACnC,CAAC;CACF"}

package/_esm/index.js

@@ -1,3 +1,2 @@
-import "./analytics.js";
 export { CdpClient } from "./client/cdp.js";
 //# sourceMappingURL=index.js.map

package/_esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,gBAAgB,CAAC;AAExB,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/_esm/version.js

@@ -1,2 +1,2 @@
-export const version = "1.3.1";
+export const version = "1.4.0";
 //# sourceMappingURL=version.js.map

package/_types/analytics.d.ts

@@ -19,22 +19,9 @@ type ErrorEventData = {
      */
     name: "error";
 };
-type EventData = ErrorEventData;
-/**
- * AnalyticsConfig singleton class for holding the API key ID
- */
-export declare class AnalyticsConfig {
-    /**
-     * The API key ID
-     */
-    static apiKeyId: string;
-    /**
-     * Sets the API key ID
-     *
-     * @param apiKeyId - The API key ID
-     */
-    static set(apiKeyId: string): void;
-}
+type EventData = ErrorEventData & {
+    apiKeyId: string;
+};
 /**
  * Sends an analytics event to the default endpoint
  *
@@ -42,5 +29,12 @@ export declare class AnalyticsConfig {
  * @returns Promise that resolves when the event is sent
  */
 export declare function sendEvent(event: EventData): Promise<void>;
+/**
+ * Wraps all methods of a class with error tracking.
+ *
+ * @param ClassToWrap - The class whose prototype methods should be wrapped.
+ * @param apiKeyId - The API key ID to use for the error tracking.
+ */
+export declare function wrapClassWithErrorTracking(ClassToWrap: any, apiKeyId: string): void;
 export {};
 //# sourceMappingURL=analytics.d.ts.map

package/_types/analytics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../analytics.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,KAAK,cAAc,GAAG;IACpB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,IAAI,EAAE,OAAO,CAAC;CACf,CAAC;AAEF,KAAK,SAAS,GAAG,cAAc,CAAC;AAKhC;;GAEG;AACH,qBAAa,eAAe;IAC1B;;OAEG;IACH,OAAc,QAAQ,EAAE,MAAM,CAAC;IAE/B;;;;OAIG;WACW,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;CAG1C;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAuC/D"}
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../analytics.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,KAAK,cAAc,GAAG;IACpB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,IAAI,EAAE,OAAO,CAAC;CACf,CAAC;AAEF,KAAK,SAAS,GAAG,cAAc,GAAG;IAChC,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAKF;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAuC/D;AAED;;;;;GAKG;AAEH,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CA+BnF"}

package/_types/auth/index.d.ts

@@ -1,5 +1,6 @@
 import * as axiosHooks from "./hooks/axios/index.js";
 export * from "./utils/http.js";
 export * from "./utils/jwt.js";
+export * from "./utils/ws.js";
 export { axiosHooks };
 //# sourceMappingURL=index.d.ts.map

package/_types/auth/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../auth/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,wBAAwB,CAAC;AAErD,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../auth/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,wBAAwB,CAAC;AAErD,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/_types/auth/utils/http.d.ts

@@ -50,6 +50,10 @@ export interface GetAuthHeadersOptions {
      * Optional expiration time in seconds (defaults to 120)
      */
     expiresIn?: number;
+    /**
+     * Optional audience claim for the JWT
+     */
+    audience?: string[];
 }
 /**
  * Gets authentication headers for a request.
@@ -58,4 +62,12 @@ export interface GetAuthHeadersOptions {
  * @returns Object containing the authentication headers
  */
 export declare function getAuthHeaders(options: GetAuthHeadersOptions): Promise<Record<string, string>>;
+/**
+ * Returns encoded correlation data including the SDK version and language.
+ *
+ * @param source - The source identifier for the request
+ * @param sourceVersion - The version of the source making the request
+ * @returns Encoded correlation data as a query string
+ */
+export declare function getCorrelationData(source?: string, sourceVersion?: string): string;
 //# sourceMappingURL=http.d.ts.map

package/_types/auth/utils/http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../auth/utils/http.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;;OAMG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;;;OAMG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAqCjC"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../auth/utils/http.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;;OAMG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;;;OAMG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAsCjC;AAeD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAYlF"}

package/_types/auth/utils/index.d.ts

@@ -1,3 +1,4 @@
 export * from "./http.js";
 export * from "./jwt.js";
+export * from "./ws.js";
 //# sourceMappingURL=index.d.ts.map

package/_types/auth/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../auth/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../auth/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC"}

package/_types/auth/utils/jwt.d.ts

@@ -23,21 +23,25 @@ export interface JwtOptions {
      */
     apiKeySecret: string;
     /**
-     * The HTTP method for the request (e.g. 'GET', 'POST')
+     * The HTTP method for the request (e.g. 'GET', 'POST'), or null for JWTs intended for websocket connections
      */
-    requestMethod: string;
+    requestMethod?: string | null;
     /**
-     * The host for the request (e.g. 'api.cdp.coinbase.com')
+     * The host for the request (e.g. 'api.cdp.coinbase.com'), or null for JWTs intended for websocket connections
      */
-    requestHost: string;
+    requestHost?: string | null;
     /**
-     * The path for the request (e.g. '/platform/v1/wallets')
+     * The path for the request (e.g. '/platform/v1/wallets'), or null for JWTs intended for websocket connections
      */
-    requestPath: string;
+    requestPath?: string | null;
     /**
      * Optional expiration time in seconds (defaults to 120)
      */
     expiresIn?: number;
+    /**
+     * Optional audience claim for the JWT
+     */
+    audience?: string[];
 }
 /**
  * WalletJwtOptions contains configuration for Wallet Auth JWT generation.
@@ -69,7 +73,9 @@ export interface WalletJwtOptions {
 }
 /**
  * Generates a JWT (also known as a Bearer token) for authenticating with Coinbase's REST APIs.
- * Supports both EC (ES256) and Ed25519 (EdDSA) keys.
+ * Supports both EC (ES256) and Ed25519 (EdDSA) keys. Also supports JWTs meant for
+ * websocket connections by allowing requestMethod, requestHost, and requestPath to all be
+ * null, in which case the 'uris' claim is omitted from the JWT.
  *
  * @param options - The configuration options for generating the JWT
  * @returns The generated JWT (Bearer token) string

package/_types/auth/utils/jwt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jwt.d.ts","sourceRoot":"","sources":["../../../auth/utils/jwt.ts"],"names":[],"mappings":"AAOA;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB;;;;;;OAMG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;;;OAMG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IAEH,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAClC;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAiDtE;AAED;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiClF"}
+{"version":3,"file":"jwt.d.ts","sourceRoot":"","sources":["../../../auth/utils/jwt.ts"],"names":[],"mappings":"AAOA;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB;;;;;;OAMG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;;;OAMG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IAEH,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAClC;AAED;;;;;;;;;GASG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAiEtE;AAED;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiClF"}

package/_types/auth/utils/ws.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Options for generating WebSocket authentication headers.
+ */
+export interface GetWebSocketAuthHeadersOptions {
+    /**
+     * The API key ID
+     *
+     * Examples:
+     *  'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'
+     *  'organizations/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/apiKeys/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'
+     */
+    apiKeyId: string;
+    /**
+     * The API key secret
+     *
+     * Examples:
+     *  'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx==' (Edwards key (Ed25519))
+     *  '-----BEGIN EC PRIVATE KEY-----\n...\n...\n...==\n-----END EC PRIVATE KEY-----\n' (EC key (ES256))
+     */
+    apiKeySecret: string;
+    /**
+     * The source identifier for the request
+     */
+    source?: string;
+    /**
+     * The version of the source making the request
+     */
+    sourceVersion?: string;
+    /**
+     * Optional expiration time in seconds (defaults to 120)
+     */
+    expiresIn?: number;
+    /**
+     * Optional audience claim for the JWT
+     */
+    audience?: string[];
+}
+/**
+ * Gets authentication headers for a WebSocket connection.
+ *
+ * @param options - The configuration options for generating WebSocket auth headers
+ * @returns Object containing the authentication headers
+ */
+export declare function getWebSocketAuthHeaders(options: GetWebSocketAuthHeadersOptions): Promise<Record<string, string>>;
+//# sourceMappingURL=ws.d.ts.map

package/_types/auth/utils/ws.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws.d.ts","sourceRoot":"","sources":["../../../auth/utils/ws.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C;;;;;;OAMG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;;;OAMG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAqBjC"}

package/_types/client/cdp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cdp.d.ts","sourceRoot":"","sources":["../../client/cdp.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,UAAU,gBAAgB;IACxB,sBAAsB;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0BAA0B;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yBAAyB;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mCAAmC;IACnC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,qBAAa,SAAS;IACpB,4CAA4C;IACrC,GAAG,EAAE,SAAS,CAAC;IAEtB,+CAA+C;IACxC,MAAM,EAAE,YAAY,CAAC;IAE5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;gBACS,OAAO,GAAE,gBAAqB;CAmD3C"}
+{"version":3,"file":"cdp.d.ts","sourceRoot":"","sources":["../../client/cdp.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,UAAU,gBAAgB;IACxB,sBAAsB;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0BAA0B;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yBAAyB;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mCAAmC;IACnC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,qBAAa,SAAS;IACpB,4CAA4C;IACrC,GAAG,EAAE,SAAS,CAAC;IAEtB,+CAA+C;IACxC,MAAM,EAAE,YAAY,CAAC;IAE5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;gBACS,OAAO,GAAE,gBAAqB;CAuD3C"}

package/_types/index.d.ts

@@ -1,4 +1,3 @@
-import "./analytics.js";
 export { CdpClient } from "./client/cdp.js";
 export type { EvmServerAccount, EvmSmartAccount } from "./accounts/types.js";
 //# sourceMappingURL=index.d.ts.map

package/_types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,gBAAgB,CAAC;AAExB,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC"}

package/_types/version.d.ts

@@ -1,2 +1,2 @@
-export declare const version = "1.3.1";
+export declare const version = "1.4.0";
 //# sourceMappingURL=version.d.ts.map

package/analytics.ts

@@ -1,9 +1,5 @@
 import md5 from "md5";
 
-import { CdpClient } from "./client/cdp.js";
-import { EvmClient } from "./client/evm/evm.js";
-import { SolanaClient } from "./client/solana/solana.js";
-
 /**
  * The data in an error event
  */
@@ -26,30 +22,13 @@ type ErrorEventData = {
   name: "error";
 };
 
-type EventData = ErrorEventData;
+type EventData = ErrorEventData & {
+  apiKeyId: string;
+};
 
 // This is a public client id for the analytics service
 const publicClientId = "54f2ee2fb3d2b901a829940d70fbfc13";
 
-/**
- * AnalyticsConfig singleton class for holding the API key ID
- */
-export class AnalyticsConfig {
-  /**
-   * The API key ID
-   */
-  public static apiKeyId: string;
-
-  /**
-   * Sets the API key ID
-   *
-   * @param apiKeyId - The API key ID
-   */
-  public static set(apiKeyId: string): void {
-    AnalyticsConfig.apiKeyId = apiKeyId;
-  }
-}
-
 /**
  * Sends an analytics event to the default endpoint
  *
@@ -60,7 +39,7 @@ export async function sendEvent(event: EventData): Promise<void> {
   const timestamp = Date.now();
 
   const enhancedEvent = {
-    user_id: AnalyticsConfig.apiKeyId,
+    user_id: event.apiKeyId,
     event_type: event.name,
     platform: "server",
     timestamp,
@@ -101,16 +80,17 @@ export async function sendEvent(event: EventData): Promise<void> {
  * Wraps all methods of a class with error tracking.
  *
  * @param ClassToWrap - The class whose prototype methods should be wrapped.
+ * @param apiKeyId - The API key ID to use for the error tracking.
  */
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
-function wrapClassWithErrorTracking(ClassToWrap: any): void {
-  const methodNames = Object.getOwnPropertyNames(ClassToWrap.prototype).filter(
+export function wrapClassWithErrorTracking(ClassToWrap: any, apiKeyId: string): void {
+  const methods = Object.getOwnPropertyNames(ClassToWrap.prototype).filter(
     name => name !== "constructor" && typeof ClassToWrap.prototype[name] === "function",
   );
 
-  for (const methodName of methodNames) {
-    const originalMethod = ClassToWrap.prototype[methodName];
-    ClassToWrap.prototype[methodName] = async function (...args: unknown[]) {
+  for (const method of methods) {
+    const originalMethod = ClassToWrap.prototype[method];
+    ClassToWrap.prototype[method] = async function (...args: unknown[]) {
       try {
         return await originalMethod.apply(this, args);
       } catch (error) {
@@ -120,23 +100,18 @@ function wrapClassWithErrorTracking(ClassToWrap: any): void {
 
         const { message, stack } = error;
 
-        if (process.env.DISABLE_CDP_ERROR_REPORTING !== "true") {
-          sendEvent({
-            method: String(methodName),
-            message,
-            stack,
-            name: "error",
-          }).catch(() => {
-            // ignore error
-          });
-        }
+        sendEvent({
+          apiKeyId,
+          method,
+          message,
+          stack,
+          name: "error",
+        }).catch(() => {
+          // ignore error
+        });
 
         throw error;
       }
     };
   }
 }
-
-wrapClassWithErrorTracking(CdpClient);
-wrapClassWithErrorTracking(EvmClient);
-wrapClassWithErrorTracking(SolanaClient);

package/auth/README.md

@@ -25,6 +25,7 @@ npm install @coinbase/cdp-sdk
 ```typescript
 import { generateJwt } from "@coinbase/cdp-sdk/auth";
 
+// For REST (HTTP) requests
 const jwt = await generateJwt({
   apiKeyId: "YOUR_API_KEY_ID",
   apiKeySecret: "YOUR_API_KEY_SECRET",
@@ -35,6 +36,18 @@ const jwt = await generateJwt({
 });
 
 console.log(jwt);
+
+// For websocket connections
+const websocketJwt = await generateJwt({
+  apiKeyId: "YOUR_API_KEY_ID",
+  apiKeySecret: "YOUR_API_KEY_SECRET",
+  requestMethod: null,
+  requestHost: null,
+  requestPath: null,
+  expiresIn: 120, // optional (defaults to 120 seconds)
+});
+
+console.log(websocketJwt);
 ```
 
 For information about the above parameters, please refer to the [Authentication parameters](#authentication-parameters) section.
@@ -138,8 +151,10 @@ The following table provides more context of many of the authentication paramete
 | :-- | :-- | :-- |
 | `apiKeyId` | true | The unique identifier for your API key. Supported formats are:<br/>- `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx`<br/>- `organizations/{orgId}/apiKeys/{keyId}` |
 | `apiKeySecret` | true | Your API key secret. Supported formats are:<br/>- Edwards key (Ed25519): `xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx==`<br/>- Elliptic Curve key (ES256): `-----BEGIN EC PRIVATE KEY-----\n...\n...\n...==\n-----END EC PRIVATE KEY-----\n` |
-| `requestMethod` | true | The HTTP method for the API request you're authenticating (ie, `GET`, `POST`, `PUT`, `DELETE`). |
-| `requestHost` | true | The API host you're calling (ie, `api.cdp.coinbase.com`). |
-| `requestPath` | true | The path of the specific API endpoint you're calling (ie, `/platform/v1/wallets`). |
+| `requestMethod` | true* | The HTTP method for the API request you're authenticating (ie, `GET`, `POST`, `PUT`, `DELETE`). Can be `null` for JWTs intended for websocket connections. |
+| `requestHost` | true* | The API host you're calling (ie, `api.cdp.coinbase.com`). Can be `null` for JWTs intended for websocket connections. |
+| `requestPath` | true* | The path of the specific API endpoint you're calling (ie, `/platform/v1/wallets`). Can be `null` for JWTs intended for websocket connections. |
 | `requestBody` | false | Optional request body data. |
 | `expiresIn` | false | The JWT expiration time in seconds. After this time, the JWT will no longer be valid, and a new one must be generated. Defaults to `120` (ie, 2 minutes) if not specified. |
+
+\* Either all three request parameters (`requestMethod`, `requestHost`, and `requestPath`) must be provided for REST API requests, or all three must be `null` for JWTs intended for websocket connections.

package/auth/index.ts

@@ -2,4 +2,5 @@ import * as axiosHooks from "./hooks/axios/index.js";
 
 export * from "./utils/http.js";
 export * from "./utils/jwt.js";
+export * from "./utils/ws.js";
 export { axiosHooks };

package/auth/utils/http.ts

@@ -62,6 +62,11 @@ export interface GetAuthHeadersOptions {
    * Optional expiration time in seconds (defaults to 120)
    */
   expiresIn?: number;
+
+  /**
+   * Optional audience claim for the JWT
+   */
+  audience?: string[];
 }
 
 /**
@@ -83,6 +88,7 @@ export async function getAuthHeaders(
     requestHost: options.requestHost,
     requestPath: options.requestPath,
     expiresIn: options.expiresIn,
+    audience: options.audience,
   });
   headers["Authorization"] = `Bearer ${jwt}`;
   headers["Content-Type"] = "application/json";
@@ -131,7 +137,7 @@ function requiresWalletAuth(requestMethod: string, requestPath: string): boolean
  * @param sourceVersion - The version of the source making the request
  * @returns Encoded correlation data as a query string
  */
-function getCorrelationData(source?: string, sourceVersion?: string): string {
+export function getCorrelationData(source?: string, sourceVersion?: string): string {
   const data = {
     sdk_version: version,
     sdk_language: "typescript",

package/auth/utils/index.ts

@@ -1,2 +1,3 @@
 export * from "./http.js";
 export * from "./jwt.js";
+export * from "./ws.js";

package/auth/utils/jwt.ts

@@ -32,24 +32,29 @@ export interface JwtOptions {
   apiKeySecret: string;
 
   /**
-   * The HTTP method for the request (e.g. 'GET', 'POST')
+   * The HTTP method for the request (e.g. 'GET', 'POST'), or null for JWTs intended for websocket connections
    */
-  requestMethod: string;
+  requestMethod?: string | null;
 
   /**
-   * The host for the request (e.g. 'api.cdp.coinbase.com')
+   * The host for the request (e.g. 'api.cdp.coinbase.com'), or null for JWTs intended for websocket connections
    */
-  requestHost: string;
+  requestHost?: string | null;
 
   /**
-   * The path for the request (e.g. '/platform/v1/wallets')
+   * The path for the request (e.g. '/platform/v1/wallets'), or null for JWTs intended for websocket connections
    */
-  requestPath: string;
+  requestPath?: string | null;
 
   /**
    * Optional expiration time in seconds (defaults to 120)
    */
   expiresIn?: number;
+
+  /**
+   * Optional audience claim for the JWT
+   */
+  audience?: string[];
 }
 
 /**
@@ -88,7 +93,9 @@ export interface WalletJwtOptions {
 
 /**
  * Generates a JWT (also known as a Bearer token) for authenticating with Coinbase's REST APIs.
- * Supports both EC (ES256) and Ed25519 (EdDSA) keys.
+ * Supports both EC (ES256) and Ed25519 (EdDSA) keys. Also supports JWTs meant for
+ * websocket connections by allowing requestMethod, requestHost, and requestPath to all be
+ * null, in which case the 'uris' claim is omitted from the JWT.
  *
  * @param options - The configuration options for generating the JWT
  * @returns The generated JWT (Bearer token) string
@@ -102,22 +109,38 @@ export async function generateJwt(options: JwtOptions): Promise<string> {
   if (!options.apiKeySecret) {
     throw new Error("Private key is required");
   }
-  if (!options.requestMethod || !options.requestHost || !options.requestPath) {
-    throw new Error("Request details (method, host, path) are required");
+
+  // Check if we have a REST API request or a websocket connection
+  const hasAllRequestParams = Boolean(
+    options.requestMethod && options.requestHost && options.requestPath,
+  );
+  const hasNoRequestParams =
+    (options.requestMethod === undefined || options.requestMethod === null) &&
+    (options.requestHost === undefined || options.requestHost === null) &&
+    (options.requestPath === undefined || options.requestPath === null);
+
+  // Ensure we either have all request parameters or none (for websocket)
+  if (!hasAllRequestParams && !hasNoRequestParams) {
+    throw new Error(
+      "Either all request details (method, host, path) must be provided, or all must be null for JWTs intended for websocket connections",
+    );
   }
 
   const now = Math.floor(Date.now() / 1000);
   const expiresIn = options.expiresIn || 120; // Default to 120 seconds if not specified
-  const uri = `${options.requestMethod} ${options.requestHost}${options.requestPath}`;
 
   // Prepare the JWT payload
-  const claims = {
+  const claims: JWTPayload = {
     sub: options.apiKeyId,
     iss: "cdp",
-    aud: ["cdp_service"],
-    uris: [uri],
+    aud: options.audience || ["cdp_service"],
   };
 
+  // Add the uris claim only for REST API requests
+  if (hasAllRequestParams) {
+    claims.uris = [`${options.requestMethod} ${options.requestHost}${options.requestPath}`];
+  }
+
   // Generate random nonce for the header
   const randomNonce = nonce();