@coinbase/cdp-sdk 1.1.2 → 1.3.0

package/_esm/actions/evm/sendUserOperation.js

@@ -0,0 +1,85 @@
+import { encodeFunctionData } from "viem";
+/**
+ * Sends a user operation to the network.
+ *
+ * @example
+ * ```ts
+ * import { sendUserOperation } from "@coinbase/cdp-sdk";
+ * import { parseEther } from "viem";
+ * import { CdpClient } from "@coinbase/cdp-sdk";
+ *
+ * const client = new CdpClient({
+ *   apiKeyId: "your-api-key-id",
+ *   apiKeySecret: "your-api-key-secret",
+ *   walletSecret: "your-wallet-secret",
+ * });
+ *
+ * const ethAccount = await client.createEvmServerAccount()
+ * const smartAccount = await client.createEvmSmartAccount({ owner: ethAccount })
+ *
+ * const result = await sendUserOperation(client, smartAccount, {
+ *   calls: [
+ *     {
+ *       abi: erc20Abi,
+ *       functionName: "transfer",
+ *       args: [to, amount],
+ *     },
+ *     {
+ *       to: "0x1234567890123456789012345678901234567890",
+ *       data: "0x",
+ *       value: parseEther("0.0000005"),
+ *     },
+ *   ],
+ *   network: "base-sepolia",
+ *   paymasterUrl: "https://api.developer.coinbase.com/rpc/v1/base/someapikey",
+ * });
+ * ```
+ *
+ * @param {CdpOpenApiClientType} client - The client to use to send the user operation.
+ * @param {EvmSmartAccount} smartAccount - The smart account to send the user operation from.
+ * @param {SendUserOperationOptions<T>} options - The options for the user operation.
+ * @returns {Promise<SendUserOperationReturnType>} The result of the user operation.
+ */
+export async function sendUserOperation(client, smartAccount, options) {
+    const { calls, network, paymasterUrl } = options;
+    if (calls.length === 0) {
+        throw new Error("Calls array is empty");
+    }
+    const encodedCalls = calls.map(call => {
+        const value = (call.value ?? BigInt(0)).toString();
+        if ("abi" in call && call.abi && "functionName" in call) {
+            return {
+                to: call.to,
+                data: encodeFunctionData({
+                    abi: call.abi,
+                    functionName: call.functionName,
+                    args: call.args,
+                }),
+                value,
+            };
+        }
+        return {
+            to: call.to,
+            data: call.data ?? "0x",
+            value,
+        };
+    });
+    const createOpResponse = await client.prepareUserOperation(smartAccount.address, {
+        network,
+        calls: encodedCalls,
+        paymasterUrl,
+    });
+    const owner = smartAccount.owners[0];
+    const signature = await owner.sign({
+        hash: createOpResponse.userOpHash,
+    });
+    const broadcastResponse = await client.sendUserOperation(smartAccount.address, createOpResponse.userOpHash, {
+        signature,
+    }, options.idempotencyKey);
+    return {
+        smartAccountAddress: smartAccount.address,
+        status: broadcastResponse.status,
+        userOpHash: createOpResponse.userOpHash,
+    };
+}
+//# sourceMappingURL=sendUserOperation.js.map

package/_esm/actions/evm/sendUserOperation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sendUserOperation.js","sourceRoot":"","sources":["../../../actions/evm/sendUserOperation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,MAAM,CAAC;AA8D1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAA4B,EAC5B,YAA6B,EAC7B,OAAoC;IAEpC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;IAEjD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,YAAY,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;QACpC,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;QAEnD,IAAI,KAAK,IAAI,IAAI,IAAI,IAAI,CAAC,GAAG,IAAI,cAAc,IAAI,IAAI,EAAE,CAAC;YACxD,OAAO;gBACL,EAAE,EAAE,IAAI,CAAC,EAAE;gBACX,IAAI,EAAE,kBAAkB,CAAC;oBACvB,GAAG,EAAE,IAAI,CAAC,GAAG;oBACb,YAAY,EAAE,IAAI,CAAC,YAAY;oBAC/B,IAAI,EAAE,IAAI,CAAC,IAAI;iBAChB,CAAC;gBACF,KAAK;aACN,CAAC;QACJ,CAAC;QAED,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,IAAI;YACvB,KAAK;SACN,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,gBAAgB,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,YAAY,CAAC,OAAO,EAAE;QAC/E,OAAO;QACP,KAAK,EAAE,YAAY;QACnB,YAAY;KACb,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAErC,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC;QACjC,IAAI,EAAE,gBAAgB,CAAC,UAAiB;KACzC,CAAC,CAAC;IAEH,MAAM,iBAAiB,GAAG,MAAM,MAAM,CAAC,iBAAiB,CACtD,YAAY,CAAC,OAAO,EACpB,gBAAgB,CAAC,UAAiB,EAClC;QACE,SAAS;KACV,EACD,OAAO,CAAC,cAAc,CACvB,CAAC;IAEF,OAAO;QACL,mBAAmB,EAAE,YAAY,CAAC,OAAO;QACzC,MAAM,EAAE,iBAAiB,CAAC,MAAM;QAChC,UAAU,EAAE,gBAAgB,CAAC,UAAU;KACT,CAAC;AACnC,CAAC"}

package/_esm/actions/evm/waitForUserOperation.js

@@ -0,0 +1,58 @@
+import { EvmUserOperationStatus, } from "../../openapi-client/index.js";
+import { wait } from "../../utils/wait.js";
+/**
+ * Waits for a user operation to complete or fail.
+ *
+ * @example
+ * ```ts
+ * import { waitForUserOperation } from "@coinbase/cdp-sdk";
+ *
+ * const result = await waitForUserOperation(client, {
+ *   userOpHash: "0x1234567890123456789012345678901234567890",
+ *   smartAccountAddress: "0x1234567890123456789012345678901234567890",
+ *   waitOptions: {
+ *     timeoutSeconds: 30,
+ *   },
+ * });
+ * ```
+ *
+ * @param {CdpOpenApiClientType} client - The client to use to wait for the user operation.
+ * @param {WaitForUserOperationOptions} options - The options for the wait operation.
+ * @returns {Promise<WaitForUserOperationReturnType>} The result of the user operation.
+ */
+export async function waitForUserOperation(client, options) {
+    const { userOpHash, smartAccountAddress } = options;
+    const reload = async () => {
+        const response = await client.getUserOperation(smartAccountAddress, userOpHash);
+        return response;
+    };
+    const transform = (operation) => {
+        if (operation.status === EvmUserOperationStatus.failed) {
+            return {
+                smartAccountAddress: smartAccountAddress,
+                status: EvmUserOperationStatus.failed,
+                userOpHash: operation.userOpHash,
+            };
+        }
+        else if (operation.status === EvmUserOperationStatus.complete) {
+            return {
+                smartAccountAddress: smartAccountAddress,
+                transactionHash: operation.transactionHash,
+                status: EvmUserOperationStatus.complete,
+                userOpHash: operation.userOpHash,
+            };
+        }
+        else {
+            throw new Error("User operation is not terminal");
+        }
+    };
+    const waitOptions = options.waitOptions || {
+        timeoutSeconds: 30,
+    };
+    return await wait(reload, isTerminal, transform, waitOptions);
+}
+const isTerminal = (operation) => {
+    return (operation.status === EvmUserOperationStatus.complete ||
+        operation.status === EvmUserOperationStatus.failed);
+};
+//# sourceMappingURL=waitForUserOperation.js.map

package/_esm/actions/evm/waitForUserOperation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"waitForUserOperation.js","sourceRoot":"","sources":["../../../actions/evm/waitForUserOperation.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,GAGvB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,IAAI,EAAe,MAAM,qBAAqB,CAAC;AA+CxD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAA4B,EAC5B,OAAoC;IAEpC,MAAM,EAAE,UAAU,EAAE,mBAAmB,EAAE,GAAG,OAAO,CAAC;IAEpD,MAAM,MAAM,GAAG,KAAK,IAAI,EAAE;QACxB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,mBAAmB,EAAE,UAAU,CAAC,CAAC;QAChF,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;IAEF,MAAM,SAAS,GAAG,CAAC,SAA2B,EAAkC,EAAE;QAChF,IAAI,SAAS,CAAC,MAAM,KAAK,sBAAsB,CAAC,MAAM,EAAE,CAAC;YACvD,OAAO;gBACL,mBAAmB,EAAE,mBAAmB;gBACxC,MAAM,EAAE,sBAAsB,CAAC,MAAM;gBACrC,UAAU,EAAE,SAAS,CAAC,UAAiB;aACd,CAAC;QAC9B,CAAC;aAAM,IAAI,SAAS,CAAC,MAAM,KAAK,sBAAsB,CAAC,QAAQ,EAAE,CAAC;YAChE,OAAO;gBACL,mBAAmB,EAAE,mBAAmB;gBACxC,eAAe,EAAE,SAAS,CAAC,eAAgB;gBAC3C,MAAM,EAAE,sBAAsB,CAAC,QAAQ;gBACvC,UAAU,EAAE,SAAS,CAAC,UAAiB;aACX,CAAC;QACjC,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACpD,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI;QACzC,cAAc,EAAE,EAAE;KACnB,CAAC;IAEF,OAAO,MAAM,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,SAA2B,EAAW,EAAE;IAC1D,OAAO,CACL,SAAS,CAAC,MAAM,KAAK,sBAAsB,CAAC,QAAQ;QACpD,SAAS,CAAC,MAAM,KAAK,sBAAsB,CAAC,MAAM,CACnD,CAAC;AACJ,CAAC,CAAC"}

package/_esm/analytics.js

@@ -0,0 +1,101 @@
+import md5 from "md5";
+import { CdpClient } from "./client/cdp.js";
+import { EvmClient } from "./client/evm/evm.js";
+import { SolanaClient } from "./client/solana/solana.js";
+// 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
+     */
+    static apiKeyId;
+    /**
+     * Sets the API key ID
+     *
+     * @param apiKeyId - The API key ID
+     */
+    static set(apiKeyId) {
+        AnalyticsConfig.apiKeyId = apiKeyId;
+    }
+}
+/**
+ * Sends an analytics event to the default endpoint
+ *
+ * @param event - The event data containing event-specific fields
+ * @returns Promise that resolves when the event is sent
+ */
+export async function sendEvent(event) {
+    const timestamp = Date.now();
+    const enhancedEvent = {
+        user_id: AnalyticsConfig.apiKeyId,
+        event_type: event.name,
+        platform: "server",
+        timestamp,
+        event_properties: {
+            project_name: "cdp-sdk",
+            cdp_sdk_language: "typescript",
+            ...event,
+        },
+    };
+    const events = [enhancedEvent];
+    const stringifiedEventData = JSON.stringify(events);
+    const uploadTime = timestamp.toString();
+    const checksum = md5(stringifiedEventData + uploadTime);
+    const analyticsServiceData = {
+        client: publicClientId,
+        e: stringifiedEventData,
+        checksum,
+    };
+    const apiEndpoint = "https://cca-lite.coinbase.com";
+    const eventPath = "/amp";
+    const eventEndPoint = `${apiEndpoint}${eventPath}`;
+    await fetch(eventEndPoint, {
+        method: "POST",
+        mode: "no-cors",
+        headers: {
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify(analyticsServiceData),
+    });
+}
+/**
+ * Wraps all methods of a class with error tracking.
+ *
+ * @param ClassToWrap - The class whose prototype methods should be wrapped.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function wrapClassWithErrorTracking(ClassToWrap) {
+    const methodNames = 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) {
+            try {
+                return await originalMethod.apply(this, args);
+            }
+            catch (error) {
+                if (!(error instanceof Error)) {
+                    return;
+                }
+                const { message, stack } = error;
+                if (process.env.DISABLE_CDP_ERROR_REPORTING !== "true") {
+                    sendEvent({
+                        method: String(methodName),
+                        message,
+                        stack,
+                        name: "error",
+                    }).catch(() => {
+                        // ignore error
+                    });
+                }
+                throw error;
+            }
+        };
+    }
+}
+wrapClassWithErrorTracking(CdpClient);
+wrapClassWithErrorTracking(EvmClient);
+wrapClassWithErrorTracking(SolanaClient);
+//# sourceMappingURL=analytics.js.map

package/_esm/analytics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.js","sourceRoot":"","sources":["../analytics.ts"],"names":[],"mappings":"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"}

package/_esm/auth/errors.js

@@ -0,0 +1,57 @@
+/**
+ * A class of errors for capturing stack traces.
+ */
+class BaseError extends Error {
+    /**
+     * Base error constructor.
+     *
+     * @param message - The message to display.
+     */
+    constructor(message) {
+        super(message);
+        this.name = this.constructor.name;
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+}
+/**
+ * An error for invalid API key format.
+ */
+export class InvalidAPIKeyFormatError extends BaseError {
+    /**
+     * Invalid API key format error constructor.
+     *
+     * @param message - The message to display.
+     */
+    constructor(message) {
+        super("Invalid API key format: " + message);
+    }
+}
+/**
+ * An error for invalid Wallet Secret format.
+ */
+export class InvalidWalletSecretFormatError extends BaseError {
+    /**
+     * Invalid Wallet Secret format error constructor.
+     *
+     * @param message - The message to display.
+     */
+    constructor(message) {
+        super("Invalid Wallet Secret format: " + message);
+    }
+}
+/**
+ * An error for an undefined Wallet Secret.
+ */
+export class UndefinedWalletSecretError extends BaseError {
+    /**
+     * Undefined Wallet Secret error constructor.
+     *
+     * @param message - The message to display.
+     */
+    constructor(message) {
+        super("Undefined Wallet Secret: " + message);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/_esm/auth/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../auth/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,SAAU,SAAQ,KAAK;IAC3B;;;;OAIG;IACH,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,wBAAyB,SAAQ,SAAS;IACrD;;;;OAIG;IACH,YAAY,OAAe;QACzB,KAAK,CAAC,0BAA0B,GAAG,OAAO,CAAC,CAAC;IAC9C,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,8BAA+B,SAAQ,SAAS;IAC3D;;;;OAIG;IACH,YAAY,OAAe;QACzB,KAAK,CAAC,gCAAgC,GAAG,OAAO,CAAC,CAAC;IACpD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,0BAA2B,SAAQ,SAAS;IACvD;;;;OAIG;IACH,YAAY,OAAe;QACzB,KAAK,CAAC,2BAA2B,GAAG,OAAO,CAAC,CAAC;IAC/C,CAAC;CACF"}

package/_esm/auth/hooks/axios/index.js

@@ -0,0 +1,2 @@
+export * from "./withAuth.js";
+//# sourceMappingURL=index.js.map

package/_esm/auth/hooks/axios/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../auth/hooks/axios/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC"}

package/_esm/auth/hooks/axios/withAuth.js

@@ -0,0 +1,72 @@
+import { AxiosHeaders } from "axios";
+import { getAuthHeaders } from "../../utils/http.js";
+/**
+ * Axios interceptor for adding the JWT to the Authorization header.
+ *
+ * @param axiosClient - The Axios client instance to add the interceptor to
+ * @param options - Options for the request including API keys and debug flag
+ * @returns The modified request configuration with the Authorization header added
+ */
+export function withAuth(axiosClient, options) {
+    axiosClient.interceptors.request.use(async (axiosConfig) => {
+        const method = axiosConfig.method?.toString().toUpperCase() || "GET";
+        if (!axiosConfig.url) {
+            throw new Error("URL is required for authentication");
+        }
+        const fullyQualifiedURL = axiosClient.getUri() + axiosConfig.url;
+        // Parse URL to get host and path
+        const url = new URL(fullyQualifiedURL);
+        // Get authentication headers
+        const headers = await getAuthHeaders({
+            apiKeyId: options.apiKeyId,
+            apiKeySecret: options.apiKeySecret,
+            requestMethod: method,
+            requestHost: url.host,
+            requestPath: url.pathname,
+            requestBody: axiosConfig.data,
+            walletSecret: options.walletSecret,
+            source: options.source,
+            sourceVersion: options.sourceVersion,
+            expiresIn: options.expiresIn,
+        });
+        // Add headers to request config
+        axiosConfig.headers = new AxiosHeaders({
+            ...axiosConfig.headers,
+            ...headers,
+        });
+        if (options.debug) {
+            console.log("Request:", {
+                method,
+                url: fullyQualifiedURL,
+                headers: axiosConfig.headers,
+                data: axiosConfig.data,
+            });
+        }
+        return axiosConfig;
+    });
+    if (options.debug) {
+        axiosClient.interceptors.response.use(response => {
+            console.log("Response:", {
+                status: response.status,
+                statusText: response.statusText,
+                headers: response.headers,
+                data: response.data,
+            });
+            return response;
+        }, error => {
+            // Ensure we have access to the error response details
+            const errorDetails = {
+                status: error.response?.status,
+                statusText: error.response?.statusText,
+                headers: error.response?.headers,
+                data: error.response?.data,
+                message: error.message,
+                cause: error.cause,
+            };
+            console.error("Response Error:", errorDetails);
+            return Promise.reject(error);
+        });
+    }
+    return axiosClient;
+}
+//# sourceMappingURL=withAuth.js.map

package/_esm/auth/hooks/axios/withAuth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"withAuth.js","sourceRoot":"","sources":["../../../../auth/hooks/axios/withAuth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,YAAY,EAAE,MAAM,OAAO,CAAC;AAEpD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAqCrD;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAC,WAA0B,EAAE,OAA+B;IAClF,WAAW,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAC,WAAW,EAAC,EAAE;QACvD,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,WAAW,EAAE,IAAI,KAAK,CAAC;QAErE,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACxD,CAAC;QAED,MAAM,iBAAiB,GAAG,WAAW,CAAC,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC;QAEjE,iCAAiC;QACjC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,iBAAiB,CAAC,CAAC;QAEvC,6BAA6B;QAC7B,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC;YACnC,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,aAAa,EAAE,MAAM;YACrB,WAAW,EAAE,GAAG,CAAC,IAAI;YACrB,WAAW,EAAE,GAAG,CAAC,QAAQ;YACzB,WAAW,EAAE,WAAW,CAAC,IAAI;YAC7B,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,SAAS,EAAE,OAAO,CAAC,SAAS;SAC7B,CAAC,CAAC;QAEH,gCAAgC;QAChC,WAAW,CAAC,OAAO,GAAG,IAAI,YAAY,CAAC;YACrC,GAAG,WAAW,CAAC,OAAO;YACtB,GAAG,OAAO;SACX,CAAC,CAAC;QAEH,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE;gBACtB,MAAM;gBACN,GAAG,EAAE,iBAAiB;gBACtB,OAAO,EAAE,WAAW,CAAC,OAAO;gBAC5B,IAAI,EAAE,WAAW,CAAC,IAAI;aACvB,CAAC,CAAC;QACL,CAAC;QAED,OAAO,WAAW,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,WAAW,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,CACnC,QAAQ,CAAC,EAAE;YACT,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE;gBACvB,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,UAAU,EAAE,QAAQ,CAAC,UAAU;gBAC/B,OAAO,EAAE,QAAQ,CAAC,OAAO;gBACzB,IAAI,EAAE,QAAQ,CAAC,IAAI;aACpB,CAAC,CAAC;YACH,OAAO,QAAQ,CAAC;QAClB,CAAC,EACD,KAAK,CAAC,EAAE;YACN,sDAAsD;YACtD,MAAM,YAAY,GAAG;gBACnB,MAAM,EAAE,KAAK,CAAC,QAAQ,EAAE,MAAM;gBAC9B,UAAU,EAAE,KAAK,CAAC,QAAQ,EAAE,UAAU;gBACtC,OAAO,EAAE,KAAK,CAAC,QAAQ,EAAE,OAAO;gBAChC,IAAI,EAAE,KAAK,CAAC,QAAQ,EAAE,IAAI;gBAC1B,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,KAAK,EAAE,KAAK,CAAC,KAAK;aACnB,CAAC;YAEF,OAAO,CAAC,KAAK,CAAC,iBAAiB,EAAE,YAAY,CAAC,CAAC;YAC/C,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC,CACF,CAAC;IACJ,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/_esm/auth/index.js

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

package/_esm/auth/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","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"}

package/_esm/auth/utils/http.js

@@ -0,0 +1,70 @@
+import { generateWalletJwt, generateJwt } from "./jwt.js";
+import { version } from "../../version.js";
+/**
+ * Gets authentication headers for a request.
+ *
+ * @param options - The configuration options for generating auth headers
+ * @returns Object containing the authentication headers
+ */
+export async function getAuthHeaders(options) {
+    const headers = {};
+    // Generate and add JWT token
+    const jwt = await generateJwt({
+        apiKeyId: options.apiKeyId,
+        apiKeySecret: options.apiKeySecret,
+        requestMethod: options.requestMethod,
+        requestHost: options.requestHost,
+        requestPath: options.requestPath,
+        expiresIn: options.expiresIn,
+    });
+    headers["Authorization"] = `Bearer ${jwt}`;
+    headers["Content-Type"] = "application/json";
+    // Add wallet auth if needed
+    if (requiresWalletAuth(options.requestMethod, options.requestPath)) {
+        if (!options.walletSecret) {
+            throw new Error("Wallet Secret not configured. Please set the CDP_WALLET_SECRET environment variable, or pass it as an option to the CdpClient constructor.");
+        }
+        const walletAuthToken = await generateWalletJwt({
+            walletSecret: options.walletSecret,
+            requestMethod: options.requestMethod,
+            requestHost: options.requestHost,
+            requestPath: options.requestPath,
+            requestData: options.requestBody || {},
+        });
+        headers["X-Wallet-Auth"] = walletAuthToken;
+    }
+    // Add correlation data
+    headers["Correlation-Context"] = getCorrelationData(options.source, options.sourceVersion);
+    return headers;
+}
+/**
+ * Returns true if the request indicated by the method and URL requires wallet authentication.
+ *
+ * @param requestMethod - The HTTP method of the request
+ * @param requestPath - The URL path of the request
+ * @returns True if the request requires wallet authentication, false otherwise
+ */
+function requiresWalletAuth(requestMethod, requestPath) {
+    return (requestPath?.includes("/accounts") && (requestMethod === "POST" || requestMethod === "DELETE"));
+}
+/**
+ * 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
+ */
+function getCorrelationData(source, sourceVersion) {
+    const data = {
+        sdk_version: version,
+        sdk_language: "typescript",
+        source: source || "sdk-auth",
+    };
+    if (sourceVersion) {
+        data["source_version"] = sourceVersion;
+    }
+    return Object.keys(data)
+        .map(key => `${key}=${encodeURIComponent(data[key])}`)
+        .join(",");
+}
+//# sourceMappingURL=http.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../../auth/utils/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAiE3C;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAA8B;IAE9B,MAAM,OAAO,GAA2B,EAAE,CAAC;IAE3C,6BAA6B;IAC7B,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC;QAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,SAAS,EAAE,OAAO,CAAC,SAAS;KAC7B,CAAC,CAAC;IACH,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,GAAG,EAAE,CAAC;IAC3C,OAAO,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAC;IAE7C,4BAA4B;IAC5B,IAAI,kBAAkB,CAAC,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QACnE,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CACb,4IAA4I,CAC7I,CAAC;QACJ,CAAC;QAED,MAAM,eAAe,GAAG,MAAM,iBAAiB,CAAC;YAC9C,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,EAAE;SACvC,CAAC,CAAC;QACH,OAAO,CAAC,eAAe,CAAC,GAAG,eAAe,CAAC;IAC7C,CAAC;IAED,uBAAuB;IACvB,OAAO,CAAC,qBAAqB,CAAC,GAAG,kBAAkB,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IAE3F,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;GAMG;AACH,SAAS,kBAAkB,CAAC,aAAqB,EAAE,WAAmB;IACpE,OAAO,CACL,WAAW,EAAE,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,aAAa,KAAK,MAAM,IAAI,aAAa,KAAK,QAAQ,CAAC,CAC/F,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAS,kBAAkB,CAAC,MAAe,EAAE,aAAsB;IACjE,MAAM,IAAI,GAAG;QACX,WAAW,EAAE,OAAO;QACpB,YAAY,EAAE,YAAY;QAC1B,MAAM,EAAE,MAAM,IAAI,UAAU;KAC7B,CAAC;IACF,IAAI,aAAa,EAAE,CAAC;QAClB,IAAI,CAAC,gBAAgB,CAAC,GAAG,aAAa,CAAC;IACzC,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;SACrB,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;SACrD,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC"}

package/_esm/auth/utils/index.js

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

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

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