@coinbase/cdp-core 0.0.98 → 0.0.100

package/dist/native/index.native97.js

@@ -1,28 +1,27 @@
-import { InvalidAddressError as s } from "./index.native124.js";
-import { isAddress as a } from "./index.native125.js";
-function r(n) {
-  if (typeof n == "string") {
-    if (!a(n, { strict: !1 }))
-      throw new s({ address: n });
-    return {
-      address: n,
-      type: "json-rpc"
-    };
+import { InputValidationError as n } from "./index.native82.js";
+function u(t, e) {
+  if (e) {
+    const o = e.toLowerCase();
+    if (!(t.evmAccountObjects?.some((c) => c.address.toLowerCase() === o) || t.evmSmartAccountObjects?.some((c) => c.address.toLowerCase() === o)))
+      throw new n(`Account ${e} is not owned by the current user`);
+    return e;
   }
-  if (!a(n.address, { strict: !1 }))
-    throw new s({ address: n.address });
-  return {
-    address: n.address,
-    nonceManager: n.nonceManager,
-    sign: n.sign,
-    signAuthorization: n.signAuthorization,
-    signMessage: n.signMessage,
-    signTransaction: n.signTransaction,
-    signTypedData: n.signTypedData,
-    source: "custom",
-    type: "local"
-  };
+  return r(t);
+}
+function r(t) {
+  const e = t.evmSmartAccountObjects?.length || 0, o = t.evmAccountObjects?.length || 0;
+  if (e === 0 && o === 0)
+    throw new Error(
+      "No EVM accounts available. User must have at least one EVM Smart Account or EVM Account."
+    );
+  if (e === 1 && o <= 1)
+    return t.evmSmartAccountObjects[0].address;
+  if (o === 1 && e === 0)
+    return t.evmAccountObjects[0].address;
+  throw new Error(
+    "Multiple EVM accounts available. Please specify 'account' to select which account to swap with."
+  );
 }
 export {
-  r as toAccount
+  u as resolveAccount
 };

package/dist/native/index.native98.js

@@ -1,162 +1,24 @@
-const H = (m) => (h, n, r) => {
-  const s = r.subscribe;
-  return r.subscribe = (c, i, a) => {
-    let l = c;
-    if (i) {
-      const g = a?.equalityFn || Object.is;
-      let v = c(r.getState());
-      l = (f) => {
-        const u = c(f);
-        if (!g(v, u)) {
-          const y = v;
-          i(v = u, y);
-        }
-      }, a?.fireImmediately && i(v, v);
-    }
-    return s(l);
-  }, m(h, n, r);
-}, R = H;
-function F(m, h) {
-  let n;
-  try {
-    n = m();
-  } catch {
-    return;
-  }
-  return {
-    getItem: (s) => {
-      var e;
-      const c = (a) => a === null ? null : JSON.parse(a, void 0), i = (e = n.getItem(s)) != null ? e : null;
-      return i instanceof Promise ? i.then(c) : c(i);
-    },
-    setItem: (s, e) => n.setItem(s, JSON.stringify(e, void 0)),
-    removeItem: (s) => n.removeItem(s)
-  };
-}
-const p = (m) => (h) => {
-  try {
-    const n = m(h);
-    return n instanceof Promise ? n : {
-      then(r) {
-        return p(r)(n);
-      },
-      catch(r) {
-        return this;
-      }
-    };
-  } catch (n) {
-    return {
-      then(r) {
-        return this;
-      },
-      catch(r) {
-        return p(r)(n);
-      }
-    };
-  }
-}, O = (m, h) => (n, r, s) => {
-  let e = {
-    storage: F(() => localStorage),
-    partialize: (t) => t,
-    version: 0,
-    merge: (t, S) => ({
-      ...S,
-      ...t
-    }),
-    ...h
-  }, c = !1;
-  const i = /* @__PURE__ */ new Set(), a = /* @__PURE__ */ new Set();
-  let l = e.storage;
-  if (!l)
-    return m(
-      (...t) => {
-        console.warn(
-          `[zustand persist middleware] Unable to update item '${e.name}', the given storage is currently unavailable.`
-        ), n(...t);
-      },
-      r,
-      s
+import { EvmSwapsNetwork as a } from "@coinbase/cdp-api-client";
+import { InputValidationError as t } from "./index.native82.js";
+const r = /^0x[a-fA-F0-9]{40}$/, o = /^[1-9]\d*$/, n = new Set(Object.values(a));
+function w(e) {
+  if (!n.has(e.network))
+    throw new t(
+      `Invalid network: ${e.network}. Must be one of: ${[...n].join(", ")}`
     );
-  const g = () => {
-    const t = e.partialize({ ...r() });
-    return l.setItem(e.name, {
-      state: t,
-      version: e.version
-    });
-  }, v = s.setState;
-  s.setState = (t, S) => {
-    v(t, S), g();
-  };
-  const f = m(
-    (...t) => {
-      n(...t), g();
-    },
-    r,
-    s
-  );
-  s.getInitialState = () => f;
-  let u;
-  const y = () => {
-    var t, S;
-    if (!l) return;
-    c = !1, i.forEach((o) => {
-      var d;
-      return o((d = r()) != null ? d : f);
-    });
-    const b = ((S = e.onRehydrateStorage) == null ? void 0 : S.call(e, (t = r()) != null ? t : f)) || void 0;
-    return p(l.getItem.bind(l))(e.name).then((o) => {
-      if (o)
-        if (typeof o.version == "number" && o.version !== e.version) {
-          if (e.migrate) {
-            const d = e.migrate(
-              o.state,
-              o.version
-            );
-            return d instanceof Promise ? d.then((I) => [!0, I]) : [!0, d];
-          }
-          console.error(
-            "State loaded from storage couldn't be migrated since no migrate function was provided"
-          );
-        } else
-          return [!1, o.state];
-      return [!1, void 0];
-    }).then((o) => {
-      var d;
-      const [I, _] = o;
-      if (u = e.merge(
-        _,
-        (d = r()) != null ? d : f
-      ), n(u, !0), I)
-        return g();
-    }).then(() => {
-      b?.(u, void 0), u = r(), c = !0, a.forEach((o) => o(u));
-    }).catch((o) => {
-      b?.(void 0, o);
-    });
-  };
-  return s.persist = {
-    setOptions: (t) => {
-      e = {
-        ...e,
-        ...t
-      }, t.storage && (l = t.storage);
-    },
-    clearStorage: () => {
-      l?.removeItem(e.name);
-    },
-    getOptions: () => e,
-    rehydrate: () => y(),
-    hasHydrated: () => c,
-    onHydrate: (t) => (i.add(t), () => {
-      i.delete(t);
-    }),
-    onFinishHydration: (t) => (a.add(t), () => {
-      a.delete(t);
-    })
-  }, e.skipHydration || y(), u || f;
-}, w = O;
+  if (!r.test(e.fromToken))
+    throw new t("Invalid fromToken address");
+  if (!r.test(e.toToken))
+    throw new t("Invalid toToken address");
+  if (e.fromToken.toLowerCase() === e.toToken.toLowerCase())
+    throw new t("fromToken and toToken must be different");
+  if (!o.test(e.fromAmount))
+    throw new t("fromAmount must be a positive integer string in atomic units");
+  if (e.slippageBps !== void 0 && (!Number.isInteger(e.slippageBps) || e.slippageBps < 0 || e.slippageBps > 1e4))
+    throw new t("slippageBps must be an integer between 0 and 10000");
+  if (e.account !== void 0 && !r.test(e.account))
+    throw new t("Invalid account address");
+}
 export {
-  F as createJSONStorage,
-  w as persist,
-  R as subscribeWithSelector
+  w as validateSwapParams
 };

package/dist/native/index.native99.js

@@ -1,50 +1,19 @@
-class n {
-  events = {};
-  /**
-   * Add an event listener.
-   *
-   * @param event - The name of the event to listen for.
-   * @param listener - The function to call when the event is emitted.
-   */
-  on(e, s) {
-    this.events[e] || (this.events[e] = []), this.events[e].push(s);
-  }
-  /**
-   * Remove an event listener.
-   *
-   * @param event - The name of the event to remove the listener from.
-   * @param listener - The function to remove from the event listeners.
-   */
-  removeListener(e, s) {
-    if (!this.events[e])
-      return;
-    const t = this.events[e].indexOf(s);
-    t > -1 && this.events[e].splice(t, 1);
-  }
-  /**
-   * Emit an event.
-   *
-   * @param event - The name of the event to emit.
-   * @param args - The arguments to pass to the event listeners.
-   */
-  emit(e, ...s) {
-    this.events[e] && this.events[e].forEach((t) => {
-      try {
-        t(...s);
-      } catch (i) {
-        console.error(`Error in event listener for ${e}:`, i);
-      }
-    });
-  }
-  /**
-   * Remove all listeners for an event.
-   *
-   * @param event - The name of the event to remove all listeners from. If not provided, removes all listeners for all events.
-   */
-  removeAllListeners(e) {
-    e ? delete this.events[e] : this.events = {};
+import { APIError as o } from "@coinbase/cdp-api-client";
+import { SwapError as r } from "./index.native82.js";
+const t = {
+  insufficient_liquidity: "INSUFFICIENT_LIQUIDITY",
+  insufficient_allowance: "INSUFFICIENT_ALLOWANCE",
+  insufficient_balance: "INSUFFICIENT_BALANCE",
+  transaction_simulation_failed: "TRANSACTION_SIMULATION_FAILED"
+};
+function e(i) {
+  if (i instanceof o && i.statusCode === 422) {
+    const n = t[i.errorType];
+    if (n)
+      return new r(n, i.errorMessage);
   }
+  return i instanceof Error ? i : new Error(String(i));
 }
 export {
-  n as EventEmitter
+  e as mapSwapApiError
 };

package/dist/native-types/actions/authenticateWithJWT.d.ts

@@ -1,4 +1,68 @@
 import { AuthenticateWithJWTResult } from '../types.js';
+/**
+ * Authenticates an end user using a developer-issued JWT from a third-party identity provider
+ * (e.g., Auth0, Firebase, Cognito, custom OIDC).
+ *
+ * This function validates the JWT, auto-creates the user if they don't exist, and provisions
+ * wallets based on your configuration.
+ *
+ * @param options - Optional options for the authentication.
+ * @param options.idempotencyKey - Optional idempotency key for safe retries.
+ *
+ * **Important**: Before using this function, you must:
+ * 1. Configure custom auth in the CDP Portal (JWKS endpoint, issuer, etc.)
+ * 2. Provide a `customAuth.getJwt` callback in your config to handle JWT refresh
+ *
+ * @example
+ * ```typescript lines
+ * // React - With Auth0
+ * import { useAuth0 } from '@auth0/auth0-react';
+ * import { initialize, authenticateWithJWT } from '@coinbase/cdp-core';
+ *
+ * const { getAccessTokenSilently } = useAuth0();
+ *
+ * await initialize({
+ *   projectId: 'my-project',
+ *   customAuth: {
+ *     getJwt: getAccessTokenSilently
+ *   },
+ *   ethereum: { createOnLogin: 'eoa' }
+ * });
+ *
+ * const result = await authenticateWithJWT();
+ * console.log(result.user); // Authenticated user with wallet
+ * ```
+ *
+ * @example
+ * ```typescript lines
+ * // React Native - With Auth0
+ * import { useAuth0 } from 'react-native-auth0';
+ * import { initialize, authenticateWithJWT } from '@coinbase/cdp-core';
+ *
+ * const { authorize, getCredentials } = useAuth0();
+ *
+ * await initialize({
+ *   projectId: 'my-project',
+ *   customAuth: {
+ *     getJwt: async () => {
+ *       const creds = await getCredentials();
+ *       return creds?.accessToken;
+ *     }
+ *   },
+ *   ethereum: { createOnLogin: 'eoa' }
+ * });
+ *
+ * // User clicks sign in - triggers Auth0 login
+ * await authorize();
+ *
+ * // Then authenticate with CDP
+ * const result = await authenticateWithJWT();
+ * console.log(result.user); // Authenticated user with wallet
+ * ```
+ *
+ * @returns The authentication result with user and wallet information
+ * @throws {CustomAuthError} If customAuth.getJwt callback is not configured or JWT retrieval fails
+ */
 export declare const authenticateWithJWT: (options?: {
     idempotencyKey?: string;
 }) => Promise<AuthenticateWithJWTResult>;

package/dist/native-types/actions/cancelMfaVerification.d.ts

@@ -1 +1,20 @@
+/**
+ * Cancels the current MFA verification flow.
+ *
+ * Call this when the user dismisses the MFA UI without completing verification.
+ * The original operation that triggered MFA will reject with an error.
+ *
+ * @example
+ * ```typescript
+ * // In your MFA modal's cancel button handler
+ * function MfaModal() {
+ *   const handleCancel = () => {
+ *     cancelMfaVerification();
+ *     closeModal();
+ *   };
+ *
+ *   return <button onClick={handleCancel}>Cancel</button>;
+ * }
+ * ```
+ */
 export declare const cancelMfaVerification: () => void;

package/dist/native-types/actions/createDelegation.d.ts

@@ -1,8 +1,26 @@
+/**
+ * Options for creating a delegation that allows a developer to sign on behalf of an end user.
+ */
 export type CreateDelegationOptions = {
+    /** The date until which the delegation is valid (ISO 8601 string). */
     expiresAt: string;
+    /** Optional idempotency key for safe retries. */
     idempotencyKey?: string;
 };
+/**
+ * Result of creating a delegation for an end user.
+ */
 export type CreateDelegationResult = {
+    /** The unique identifier for the delegation. */
     delegationId: string;
 };
+/**
+ * Creates a delegation that allows a developer to sign on behalf of an end user for the specified duration.
+ * The end user must be authenticated to authorize this delegation.
+ *
+ * @param options - Options for creating the delegation.
+ * @returns The delegation ID.
+ * @throws {InputValidationError} If `expiresAt` is not a valid date or is not in the future.
+ * @throws Error if the user is not signed in.
+ */
 export declare function createDelegation(options: CreateDelegationOptions): Promise<CreateDelegationResult>;

package/dist/native-types/actions/createEvmEip7702Delegation.d.ts

@@ -1,12 +1,39 @@
 import { EvmAddress } from '../types.js';
 import { EvmEip7702DelegationNetwork } from '@coinbase/cdp-api-client';
+/**
+ * Result of creating an EIP-7702 delegation.
+ */
 export type CreateEvmEip7702DelegationResult = {
+    /** The unique identifier for the delegation operation. Use this to poll the operation status. */
     delegationOperationId: string;
 };
+/**
+ * Options for creating an EIP-7702 delegation for an EVM EOA account.
+ */
 export type CreateEvmEip7702DelegationOptions = {
+    /** The 0x-prefixed address of the EVM EOA account to delegate. Must belong to the current user. */
     address: EvmAddress;
+    /** The network to create the delegation on. */
     network: EvmEip7702DelegationNetwork;
+    /**
+     * Whether to configure spend permissions for the upgraded, delegated account.
+     * When enabled, the account can grant permissions for third parties to spend on its behalf.
+     * Defaults to false.
+     */
     enableSpendPermissions?: boolean;
+    /** Optional idempotency key for safe retries. */
     idempotencyKey?: string;
 };
+/**
+ * Creates an EIP-7702 delegation for an end user's EVM EOA account, upgrading it with smart account capabilities.
+ *
+ * This endpoint retrieves delegation artifacts from onchain, signs the EIP-7702 authorization,
+ * submits a Type 4 transaction, and creates an associated smart account object. After success,
+ * the local auth state is refreshed so the new smart account appears in the user's account list.
+ *
+ * @param options - Options for creating the EIP-7702 delegation.
+ * @returns The delegation operation ID for polling the operation status.
+ * @throws Error if the user is not signed in.
+ * @throws Error if the address does not belong to the current user.
+ */
 export declare function createEvmEip7702Delegation(options: CreateEvmEip7702DelegationOptions): Promise<CreateEvmEip7702DelegationResult>;

package/dist/native-types/actions/createEvmEoaAccount.d.ts

@@ -1,5 +1,17 @@
 import { Address } from 'viem';
+/**
+ * Options for creating an EVM EOA account.
+ */
 export type CreateEvmEoaAccountOptions = {
+    /** Optional idempotency key for safe retries. */
     idempotencyKey?: string;
 };
+/**
+ * Creates an EVM EOA (Externally Owned Account) for the current user.
+ * Multiple EVM EOA accounts can be created per user.
+ *
+ * @param options - Optional options for creating the account.
+ * @returns The address of the newly created EVM EOA account.
+ * @throws Error if the user is not signed in.
+ */
 export declare function createEvmEoaAccount(options?: CreateEvmEoaAccountOptions): Promise<Address>;

package/dist/native-types/actions/createEvmSmartAccount.d.ts

@@ -1,7 +1,32 @@
 import { EvmAddress } from '../types.js';
+/**
+ * Options for creating a Smart Account.
+ */
 export type CreateEvmSmartAccountOptions = {
+    /**
+     * Optional owner address for the smart account.
+     * If not provided, a new EOA will be created as the owner.
+     * If the owner already controls a smart account, an error will be thrown.
+     */
     owner?: EvmAddress;
+    /**
+     * Whether to enable spend permissions for the smart account.
+     * Setting this to true is necessary in order to create spend permissions.
+     * Only new accounts can be created with spend permissions enabled.
+     * Defaults to false.
+     */
     enableSpendPermissions?: boolean;
+    /** Optional idempotency key for safe retries. */
     idempotencyKey?: string;
 };
+/**
+ * Creates an EVM Smart Account for the current user.
+ * Multiple EVM Smart Accounts can be created per user.
+ * If no owner is provided, a new EVM EOA account will be created automatically as the owner.
+ *
+ * @param options - Options for creating the EVM Smart Account.
+ * @returns The address of the newly created EVM Smart Account.
+ * @throws Error if the user is not signed in.
+ * @throws Error if the provided owner already controls a smart account.
+ */
 export declare function createEvmSmartAccount(options?: CreateEvmSmartAccountOptions): Promise<EvmAddress>;

package/dist/native-types/actions/createKeyExportIframe.d.ts

@@ -1,18 +1,166 @@
 import { SecureIframeStatus, SecureIframeTheme } from '../secureIframe/types.js';
+/**
+ * Options for setting up a key export iframe.
+ */
 export interface CreateKeyExportIframeOptions {
+    /**
+     * The address of the account to export.
+     */
     address: string;
+    /**
+     * The target element: either a CSS selector string or an HTMLElement container.
+     * An iframe will be created and appended to the target container.
+     */
     target: string | HTMLElement;
+    /**
+     * The project ID for authentication.
+     */
     projectId: string;
+    /**
+     * The label for the button displayed in the iframe.
+     */
     label?: string;
+    /**
+     * The label to display when the key is copied successfully.
+     */
     copiedLabel?: string;
+    /**
+     * Whether to show an icon in the button.
+     *
+     * @default true
+     */
     icon?: boolean;
+    /**
+     * Theme overrides for the iframe button.
+     */
     theme?: Partial<SecureIframeTheme>;
+    /**
+     * Callback invoked when the iframe status changes.
+     */
     onStatusUpdate?: (status: SecureIframeStatus, message?: string) => void;
 }
+/**
+ * Result of setting up a key export iframe.
+ */
 export interface CreateKeyExportIframeResult {
+    /**
+     * The iframe element that was set up.
+     */
     iframe: HTMLIFrameElement;
+    /**
+     * Function to clean up event listeners and remove the iframe.
+     */
     cleanup: () => void;
+    /**
+     * Function to update the theme of the iframe.
+     */
     updateTheme: (theme: Partial<SecureIframeTheme>) => void;
 }
+/**
+ * Sets up a secure iframe for exporting EVM private keys.
+ *
+ * This function handles the communication with a secure iframe that safely
+ * exports EVM private keys to the user's clipboard without exposing them to the
+ * JavaScript context.
+ *
+ * The iframe will be automatically cleaned up when the session expires (status "expired").
+ * The `cleanup` function is idempotent, so it's safe to call it in your teardown code
+ * even if the iframe has already been cleaned up due to expiration.
+ *
+ * @param {CreateKeyExportIframeOptions} options - Configuration options for the EVM key export iframe.
+ * @returns {CreateKeyExportIframeResult} An object containing the iframe element, cleanup function, and theme update function.
+ *
+ * @example
+ * ```typescript
+ * // Using a CSS selector for the container
+ * const { iframe, cleanup } = await createEvmKeyExportIframe({
+ *   address: "0x1234...",
+ *   target: "#key-export-container",
+ *   projectId: "your-project-id",
+ *   label: "Copy Private Key",
+ *   onStatusUpdate: (status, message) => {
+ *     if (status === "success") {
+ *       console.log("Key copied!");
+ *     } else if (status === "error") {
+ *       console.error("Error:", message);
+ *     }
+ *   }
+ * });
+ *
+ * // Later, clean up. Iframe will auto cleanup when it expires.
+ * cleanup();
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Using an HTMLElement container directly
+ * const container = document.getElementById("my-container") as HTMLElement;
+ * const { cleanup, updateTheme } = await createEvmKeyExportIframe({
+ *   address: "0x1234...",
+ *   target: container,
+ *   projectId: "your-project-id",
+ *   theme: {
+ *     buttonBg: "#0052ff",
+ *     buttonText: "#ffffff"
+ *   }
+ * });
+ *
+ * // Update theme later
+ * updateTheme({ buttonBg: "#ff0000" });
+ * ```
+ */
 export declare function createEvmKeyExportIframe(options: CreateKeyExportIframeOptions): Promise<CreateKeyExportIframeResult>;
+/**
+ * Sets up a secure iframe for exporting Solana private keys.
+ *
+ * This function handles the communication with a secure iframe that safely
+ * exports Solana private keys to the user's clipboard without exposing them to the
+ * JavaScript context.
+ *
+ * The iframe will be automatically cleaned up when the session expires (status "expired").
+ * The `cleanup` function is idempotent, so it's safe to call it in your teardown code
+ * even if the iframe has already been cleaned up due to expiration.
+ *
+ * @param {CreateKeyExportIframeOptions} options - Configuration options for the Solana key export iframe.
+ * @returns {CreateKeyExportIframeResult} An object containing the iframe element, cleanup function, and theme update function.
+ *
+ * @example
+ * ```typescript
+ * // Using a CSS selector for the container
+ * const { iframe, cleanup } = await createSolanaKeyExportIframe({
+ *   address: "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
+ *   target: "#key-export-container",
+ *   projectId: "your-project-id",
+ *   label: "Copy Private Key",
+ *   onStatusUpdate: (status, message) => {
+ *     if (status === "success") {
+ *       console.log("Key copied!");
+ *     } else if (status === "error") {
+ *       console.error("Error:", message);
+ *     }
+ *   }
+ * });
+ *
+ * // Later, clean up. Iframe will auto cleanup when it expires.
+ * cleanup();
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Using an HTMLElement container directly
+ * const container = document.getElementById("my-container") as HTMLElement;
+ * const { cleanup, updateTheme } = await createSolanaKeyExportIframe({
+ *   address: "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
+ *   target: container,
+ *   projectId: "your-project-id",
+ *   theme: {
+ *     buttonBg: "#9945ff",
+ *     buttonText: "#ffffff"
+ *   }
+ * });
+ *
+ * // Update theme later
+ * updateTheme({ buttonBg: "#ff0000" });
+ * ```
+ */
 export declare function createSolanaKeyExportIframe(options: CreateKeyExportIframeOptions): Promise<CreateKeyExportIframeResult>;