@coinbase/cdp-sdk 1.51.2 → 1.52.0

package/src/_vendor/errors/CoinbaseApiTimeoutError.ts

@@ -0,0 +1,18 @@
+// This file was auto-generated by Fern from our API Definition.
+
+export class CoinbaseApiTimeoutError extends Error {
+    public readonly cause?: unknown;
+
+    constructor(message: string, opts?: { cause?: unknown }) {
+        super(message);
+        Object.setPrototypeOf(this, new.target.prototype);
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+
+        this.name = this.constructor.name;
+        if (opts?.cause != null) {
+            this.cause = opts.cause;
+        }
+    }
+}

package/src/_vendor/errors/handleNonStatusCodeError.ts

@@ -0,0 +1,40 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import type * as core from "../core/index.js";
+import * as errors from "./index.js";
+
+export function handleNonStatusCodeError(
+    error: core.Fetcher.Error,
+    rawResponse: core.RawResponse,
+    method: string,
+    path: string,
+): never {
+    switch (error.reason) {
+        case "non-json":
+            throw new errors.CoinbaseApiError({
+                statusCode: error.statusCode,
+                body: error.rawBody,
+                rawResponse: rawResponse,
+            });
+        case "body-is-null":
+            throw new errors.CoinbaseApiError({
+                statusCode: error.statusCode,
+                rawResponse: rawResponse,
+            });
+        case "timeout":
+            throw new errors.CoinbaseApiTimeoutError(`Timeout exceeded when calling ${method} ${path}.`, {
+                cause: error.cause,
+            });
+        case "unknown":
+            throw new errors.CoinbaseApiError({
+                message: error.errorMessage,
+                rawResponse: rawResponse,
+                cause: error.cause,
+            });
+        default:
+            throw new errors.CoinbaseApiError({
+                message: "Unknown error",
+                rawResponse: rawResponse,
+            });
+    }
+}

package/src/_vendor/errors/index.ts

@@ -0,0 +1,2 @@
+export { CoinbaseApiError } from "./CoinbaseApiError.js";
+export { CoinbaseApiTimeoutError } from "./CoinbaseApiTimeoutError.js";

package/src/_vendor/exports.ts

@@ -0,0 +1 @@
+export * from "./core/exports.js";

package/src/_vendor/index.ts

@@ -0,0 +1,6 @@
+export * as CoinbaseApi from "./api/index.js";
+export type { BaseClientOptions, BaseRequestOptions } from "./BaseClient.js";
+export { CoinbaseApiClient } from "./Client.js";
+export { CoinbaseApiEnvironment } from "./environments.js";
+export { CoinbaseApiError, CoinbaseApiTimeoutError } from "./errors/index.js";
+export * from "./exports.js";

package/src/auth/utils/http.ts

@@ -131,7 +131,13 @@ export async function getAuthHeaders(
  */
 function requiresWalletAuth(requestMethod: string, requestPath: string): boolean {
   return (
-    (requestPath?.includes("/accounts") ||
+    /*
+     * Match the wallet account endpoints (/v2/evm/accounts, /v2/solana/accounts)
+     * but NOT the custodial /v2/accounts endpoint, which authenticates with the
+     * API key alone (see openapi.yaml: POST /v2/accounts declares apiKeyAuth and
+     * no X-Wallet-Auth parameter). A bare includes("/accounts") over-matched it.
+     */
+    (/\/(evm|solana)\/accounts/.test(requestPath ?? "") ||
       requestPath?.includes("/spend-permissions") ||
       requestPath?.includes("/user-operations/prepare-and-send") ||
       requestPath?.includes("/embedded-wallet-api/") ||

package/src/client/cdp.ts

@@ -5,6 +5,7 @@ import { EndUserClient } from "./end-user/endUser.js";
 import { EvmClient } from "./evm/evm.js";
 import { PoliciesClient } from "./policies/policies.js";
 import { SolanaClient } from "./solana/solana.js";
+import { VendoredClient } from "./vendored.js";
 import { WebhooksClient } from "./webhooks/webhooks.js";
 
 export interface CdpClientOptions {
@@ -23,7 +24,7 @@ export interface CdpClientOptions {
 /**
  * The main client for interacting with the CDP API.
  */
-export class CdpClient {
+export class CdpClient extends VendoredClient {
   /** Namespace containing all EVM methods. */
   public evm: EvmClient;
 
@@ -129,6 +130,19 @@ For more information, see: https://github.com/coinbase/cdp-sdk/blob/main/typescr
       sourceVersion: version,
     });
 
+    /*
+     * Map CdpClient construction onto the generated CoinbaseApiClient convention.
+     * This must run after configure() (so the axios instance is ready) and before
+     * any `this` access below.
+     */
+    super({
+      apiKeyId,
+      apiKeySecret,
+      walletSecret,
+      basePath: options.basePath,
+      debugging: options.debugging,
+    });
+
     if (
       process.env.DISABLE_CDP_ERROR_REPORTING !== "true" ||
       process.env.DISABLE_CDP_USAGE_TRACKING !== "true"

package/src/client/vendored.ts

@@ -0,0 +1,131 @@
+import { CoinbaseApiClient } from "../_vendor/index.js";
+import { CdpOpenApiClient } from "../openapi-client/index.js";
+
+const DEFAULT_BASE_PATH = "https://api.cdp.coinbase.com/platform";
+
+/**
+ * Creates a `fetch`-compatible function that delegates HTTP requests to the
+ * configured axios instance from the legacy OpenAPI client.
+ *
+ * While the SDK is mid-migration to the new generated client, this keeps
+ * all HTTP requests consistent: auth headers (JWT + wallet auth), retries, and
+ * error handling all flow through the battle-tested `withAuth` axios interceptor
+ * wired up by `CdpOpenApiClient.configure()`.
+ *
+ * @returns {typeof fetch} A fetch implementation backed by the configured axios instance.
+ */
+export function createAxiosFetch(): typeof fetch {
+  return (async (input: Request | string | URL, init?: RequestInit): Promise<Response> => {
+    const axios = CdpOpenApiClient.getAxiosInstance();
+
+    const fullUrl =
+      typeof input === "string" ? input : input instanceof URL ? input.toString() : input.url;
+    const method = (init?.method ?? "GET").toUpperCase();
+
+    /*
+     * The axios `withAuth` interceptor reconstructs the signed path as
+     * `axiosClient.getUri() + axiosConfig.url`, so we must pass a relative URL
+     * (with the configured base stripped) for correct JWT path signing.
+     */
+    const base = axios.getUri();
+    let url = fullUrl.startsWith(base) ? fullUrl.slice(base.length) : fullUrl;
+    if (!url.startsWith("/")) {
+      url = "/" + url;
+    }
+
+    /*
+     * The internal fetcher serializes the body to a JSON string. Parse it back to an
+     * object so axios serialization, bigint conversion, and the wallet-JWT
+     * request hash all match the legacy (tested) behavior.
+     */
+    let data: unknown = init?.body ?? undefined;
+    if (typeof data === "string" && data.length > 0) {
+      try {
+        data = JSON.parse(data);
+      } catch {
+        // Leave non-JSON bodies untouched.
+      }
+    }
+
+    const headers: Record<string, string> = init?.headers
+      ? Object.fromEntries(new Headers(init.headers as HeadersInit))
+      : {};
+
+    const response = await axios.request({
+      url,
+      method,
+      headers,
+      data,
+      // Preserve the raw response bytes so the internal fetcher's own parser handles them.
+      responseType: "text",
+      // Let the Fern fetcher own status-code handling instead of axios throwing.
+      validateStatus: () => true,
+    });
+
+    const responseHeaders = new Headers();
+    for (const [key, value] of Object.entries(response.headers ?? {})) {
+      if (value != null) {
+        responseHeaders.set(key, String(value));
+      }
+    }
+
+    return new Response(response.data as string, {
+      status: response.status,
+      statusText: response.statusText,
+      headers: responseHeaders,
+    });
+  }) as typeof fetch;
+}
+
+/**
+ * Options for constructing a {@link VendoredClient}.
+ */
+export interface VendoredClientOptions {
+  /** The API key ID. */
+  apiKeyId: string;
+  /** The API key secret. */
+  apiKeySecret: string;
+  /** The wallet secret. */
+  walletSecret?: string;
+  /** The host URL to connect to. */
+  basePath?: string;
+  /** Whether to enable debugging. */
+  debugging?: boolean;
+}
+
+/**
+ * Middleman client that maps the {@link CdpClient} construction convention onto
+ * the generated `CoinbaseApiClient` configuration convention.
+ *
+ * It disables the generated client's built-in auth provider and instead routes
+ * all HTTP through the legacy configured axios instance (see {@link createAxiosFetch}),
+ * so the generated API resources are exposed without modifying any generated
+ * code in `_vendor` and without breaking changes.
+ */
+export class VendoredClient extends CoinbaseApiClient {
+  /**
+   * Constructs a VendoredClient.
+   *
+   * @param {VendoredClientOptions} options - The configuration options.
+   */
+  constructor(options: VendoredClientOptions) {
+    super({
+      apiKeyId: options.apiKeyId,
+      apiKeySecret: options.apiKeySecret,
+      walletSecret: options.walletSecret,
+      baseUrl: options.basePath ?? DEFAULT_BASE_PATH,
+      /*
+       * Disable the generated BearerAuthProvider; auth is injected by the axios
+       * interceptor inside the custom fetch implementation below.
+       */
+      auth: false,
+      fetch: createAxiosFetch(),
+      // Retries are already handled by axios-retry in the legacy axios instance.
+      maxRetries: 0,
+      /*
+       * `token` and `hook0Signature` are required by the generated type but are
+       * unused at runtime when `auth` is `false`; the cast satisfies the type.
+       */
+    } as unknown as CoinbaseApiClient.Options);
+  }
+}

package/src/client/vendored.types.accounts.ts

@@ -0,0 +1,25 @@
+/**
+ * @module Accounts
+ */
+
+/*
+ * Account-scoped shared types, re-exported so they are documented under the
+ * Accounts group. Hand-maintained partition of ../_vendor/api/types — if a new
+ * type is added to _vendor and belongs to Accounts, add it here (a type absent
+ * from every vendored.types.* barrel is dropped from the docs).
+ */
+export * from "../_vendor/api/types/Account.js";
+export * from "../_vendor/api/types/AccountId.js";
+export * from "../_vendor/api/types/AccountName.js";
+export * from "../_vendor/api/types/AccountType.js";
+export * from "../_vendor/api/types/AmountDetail.js";
+export * from "../_vendor/api/types/Asset.js";
+export * from "../_vendor/api/types/AssetType.js";
+export * from "../_vendor/api/types/Balance.js";
+export * from "../_vendor/api/types/BalancesAsset.js";
+export * from "../_vendor/api/types/Owner.js";
+
+/*
+ * Intentionally NOT re-exported (error plumbing, not part of the documented
+ * request/response surface): Error_, ErrorType, Url, CapabilityName.
+ */

package/src/client/vendored.types.depositDestinations.ts

@@ -0,0 +1,26 @@
+/**
+ * @module DepositDestinations
+ */
+
+/*
+ * DepositDestinations-scoped shared types, re-exported so they are documented
+ * under the DepositDestinations group. Hand-maintained partition of
+ * ../_vendor/api/types — a type absent from every vendored.types.* barrel is
+ * dropped from the docs.
+ */
+export * from "../_vendor/api/types/CreateCryptoDepositDestinationRequest.js";
+export * from "../_vendor/api/types/CreateDepositDestinationCrypto.js";
+export * from "../_vendor/api/types/CreateDepositDestinationRequest.js";
+export * from "../_vendor/api/types/CryptoDepositDestination.js";
+export * from "../_vendor/api/types/DepositDestination.js";
+export * from "../_vendor/api/types/DepositDestinationCrypto.js";
+export * from "../_vendor/api/types/DepositDestinationId.js";
+export * from "../_vendor/api/types/DepositDestinationReference.js";
+export * from "../_vendor/api/types/DepositDestinationStatus.js";
+export * from "../_vendor/api/types/DepositDestinationTarget.js";
+export * from "../_vendor/api/types/DepositDestinationTargetAccount.js";
+export * from "../_vendor/api/types/DepositDestinationType.js";
+export * from "../_vendor/api/types/DepositTravelRuleBeneficiary.js";
+export * from "../_vendor/api/types/DepositTravelRuleOriginator.js";
+export * from "../_vendor/api/types/DepositTravelRuleResponse.js";
+export * from "../_vendor/api/types/DepositTravelRuleVasp.js";

package/src/client/vendored.types.paymentMethods.ts

@@ -0,0 +1,21 @@
+/**
+ * @module PaymentMethods
+ */
+
+/*
+ * PaymentMethods-scoped shared types, re-exported so they are documented under
+ * the PaymentMethods group. Hand-maintained partition of ../_vendor/api/types —
+ * a type absent from every vendored.types.* barrel is dropped from the docs.
+ */
+export * from "../_vendor/api/types/PaymentMethod.js";
+export * from "../_vendor/api/types/PaymentMethodId.js";
+export * from "../_vendor/api/types/PaymentMethodsPaymentMethod.js";
+export * from "../_vendor/api/types/FedwireDetails.js";
+export * from "../_vendor/api/types/FedwirePaymentMethod.js";
+export * from "../_vendor/api/types/SepaDetails.js";
+export * from "../_vendor/api/types/SepaPaymentMethod.js";
+export * from "../_vendor/api/types/SwiftDetails.js";
+export * from "../_vendor/api/types/SwiftPaymentMethod.js";
+export * from "../_vendor/api/types/OriginatingBankAccountUs.js";
+export * from "../_vendor/api/types/Email.js";
+export * from "../_vendor/api/types/EmailInstrument.js";

package/src/client/vendored.types.transfers.ts

@@ -0,0 +1,30 @@
+/**
+ * @module Transfers
+ */
+
+/*
+ * Transfers-scoped shared types, re-exported so they are documented under the
+ * Transfers group. Hand-maintained partition of ../_vendor/api/types — a type
+ * absent from every vendored.types.* barrel is dropped from the docs.
+ */
+export * from "../_vendor/api/types/BlockchainAddress.js";
+export * from "../_vendor/api/types/CreateTransferSource.js";
+export * from "../_vendor/api/types/DateOfBirth.js";
+export * from "../_vendor/api/types/Metadata.js";
+export * from "../_vendor/api/types/Network.js";
+export * from "../_vendor/api/types/OnchainAddress.js";
+export * from "../_vendor/api/types/PhysicalAddress.js";
+export * from "../_vendor/api/types/Transfer.js";
+export * from "../_vendor/api/types/TransferDetails.js";
+export * from "../_vendor/api/types/TransferEstimate.js";
+export * from "../_vendor/api/types/TransferExchangeRate.js";
+export * from "../_vendor/api/types/TransferFee.js";
+export * from "../_vendor/api/types/TransferFees.js";
+export * from "../_vendor/api/types/TransferSource.js";
+export * from "../_vendor/api/types/TransferStatus.js";
+export * from "../_vendor/api/types/TransfersAccount.js";
+export * from "../_vendor/api/types/TransferTarget.js";
+export * from "../_vendor/api/types/TravelRule.js";
+export * from "../_vendor/api/types/TravelRuleBeneficiary.js";
+export * from "../_vendor/api/types/TravelRuleOriginator.js";
+export * from "../_vendor/api/types/TravelRuleStatus.js";

package/src/openapi-client/cdpApiClient.ts

@@ -55,6 +55,13 @@ let axiosInstance: AxiosInstance;
 export let config: Prettify<Omit<CdpOptions, "basePath"> & { basePath: string }> | undefined =
   undefined;
 
+/**
+ * Returns the configured axios instance. `configure()` must be called first.
+ *
+ * @returns {AxiosInstance} The configured axios instance.
+ */
+export const getAxiosInstance = (): AxiosInstance => axiosInstance;
+
 /**
  * Configures the CDP client with the given options.
  *

package/src/openapi-client/index.ts

@@ -12,7 +12,7 @@ export * from "./generated/onchain-data/onchain-data.js";
 export * from "./generated/end-user-accounts/end-user-accounts.js";
 export * from "./generated/x402-facilitator/x402-facilitator.js";
 
-import { configure } from "./cdpApiClient.js";
+import { configure, getAxiosInstance } from "./cdpApiClient.js";
 import * as endUserAccountManagement from "./generated/end-user-account-management/end-user-account-management.js";
 import * as endUserAccounts from "./generated/end-user-accounts/end-user-accounts.js";
 import * as evm from "./generated/evm-accounts/evm-accounts.js";
@@ -40,6 +40,7 @@ export const CdpOpenApiClient = {
   ...endUserAccounts,
   ...endUserAccountManagement,
   configure,
+  getAxiosInstance,
 };
 
 export const OpenApiEvmMethods = {

package/src/version.ts

@@ -1 +1 @@
-export const version = "1.51.2";
+export const version = "1.52.0";