@coinbase/cdp-core 0.0.73 → 0.0.75

package/README.md

@@ -508,6 +508,58 @@ try {
 }
 ```
 
+#### Check MFA Configuration
+
+Check whether MFA is enabled for your project and view TOTP configuration settings:
+
+```typescript lines
+import { getMfaConfig } from "@coinbase/cdp-core";
+
+// Retrieve MFA configuration for the current project
+const config = await getMfaConfig();
+
+console.log("MFA enabled:", config.enabled);
+console.log("TOTP enabled:", config.totpConfig.enabled);
+console.log("Configuration created:", config.createdAt);
+console.log("Last updated:", config.updatedAt);
+
+// Example response:
+// {
+//   projectId: "your-project-id",
+//   enabled: true,
+//   totpConfig: { enabled: true },
+//   createdAt: "2024-01-01T00:00:00Z",
+//   updatedAt: "2024-01-15T10:30:00Z"
+// }
+```
+
+#### Track MFA Enrollment Prompts
+
+Record when users are shown the MFA enrollment prompt to track enrollment opportunities:
+
+```typescript lines
+import { recordMfaEnrollmentPrompted, getCurrentUser } from "@coinbase/cdp-core";
+
+// When showing the MFA enrollment prompt to a user (must be signed in)
+const result = await recordMfaEnrollmentPrompted();
+
+console.log("Enrollment prompt recorded at:", result.enrollmentPromptedAt);
+
+// The user's state is updated with the prompt timestamp
+const user = await getCurrentUser();
+console.log("Last prompted:", user.mfaMethods?.enrollmentPromptedAt);
+// Output: "2024-01-15T10:30:00Z"
+
+// This helps track when users skip MFA enrollment so you can
+// decide when to prompt them again
+```
+
+**Use Cases for Tracking Enrollment Prompts:**
+- Track when users skip MFA enrollment
+- Implement smart re-prompting logic (e.g., don't prompt again for 30 days)
+- Analyze MFA adoption rates
+- Identify users who have been prompted but haven't enrolled
+
 ### Create Accounts Manually
 
 If you configured your SDK without `createOnLogin`, you can manually create accounts for authenticated users when needed. This gives you full control over when accounts are created.
@@ -948,7 +1000,62 @@ const typedDataResult = await signEvmTypedData({
 
 End users can export their private keys from their embedded wallet, allowing them to import them into compatible wallets of their choice.
 
-#### Export EVM Private Key
+#### Secure Iframe Export (Recommended)
+
+The secure iframe approach is the recommended way to export private keys. It creates a secure iframe that copies the private key directly to the user's clipboard without ever exposing it to your application's JavaScript context.
+
+##### Export EVM Private Key via Iframe
+
+```typescript lines
+import { createEvmKeyExportIframe } from "@coinbase/cdp-core";
+
+const container = document.getElementById("key-export-container");
+
+const { cleanup } = await createEvmKeyExportIframe({
+  address: "0x1234...",
+  target: container,
+  projectId: "your-project-id",
+  label: "Copy Private Key",
+  onStatusUpdate: (status, message) => {
+    if (status === "success") {
+      console.log("Key copied to clipboard!");
+    } else if (status === "error") {
+      console.error("Error:", message);
+    }
+  }
+});
+
+// The iframe will auto-cleanup when the session expires, or you can manually cleanup:
+// cleanup();
+```
+
+##### Export Solana Private Key via Iframe
+
+```typescript lines
+import { createSolanaKeyExportIframe } from "@coinbase/cdp-core";
+
+const container = document.getElementById("key-export-container");
+
+const { cleanup } = await createSolanaKeyExportIframe({
+  address: "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
+  target: container,
+  projectId: "your-project-id",
+  label: "Copy Private Key",
+  onStatusUpdate: (status, message) => {
+    if (status === "success") {
+      console.log("Key copied to clipboard!");
+    } else if (status === "error") {
+      console.error("Error:", message);
+    }
+  }
+});
+```
+
+#### Direct Export (Deprecated)
+
+> **⚠️ Deprecated:** The direct export functions expose the private key to your application's JavaScript context and will be removed soon. Use the secure iframe approach above instead.
+
+##### Export EVM Private Key (Deprecated)
 
 ```typescript lines
 import { exportEvmAccount, getCurrentUser } from "@coinbase/cdp-core";
@@ -964,7 +1071,7 @@ const { privateKey } = await exportEvmAccount({
 console.log("EVM Private Key:", privateKey);
 ```
 
-#### Export Solana Private Key
+##### Export Solana Private Key (Deprecated)
 
 When your application is configured with `solana: { createOnLogin: true }`, you can export Solana private keys:
 

package/dist/esm/index.native.js

@@ -6,31 +6,33 @@ import { nativeSecureStorage as e } from "./index.native6.js";
 import { nativeStorage as n } from "./index.native7.js";
 import { setPlatformServices as i } from "./index.native8.js";
 import { VERSION as a } from "./index.native9.js";
-import { authenticateWithJWT as d, exportEvmAccount as h, exportSolanaAccount as v, getAccessToken as T, getAccessTokenExpiration as O, getCurrentUser as y, getUserOperation as P, initialize as k, isSignedIn as I, onAuthStateChange as W, onOAuthStateChange as C, sendEvmTransaction as M, sendSolanaTransaction as V, sendUserOperation as R, signEvmHash as U, signEvmMessage as D, signEvmTransaction as N, signEvmTypedData as b, signInWithEmail as w, signInWithOAuth as B, signInWithSms as H, signOut as _, signSolanaMessage as z, signSolanaTransaction as G, verifyEmailOTP as J, verifyOAuth as X, verifySmsOTP as j } from "./index.native10.js";
+import { authenticateWithJWT as A, exportEvmAccount as h, exportSolanaAccount as v, getAccessToken as T, getAccessTokenExpiration as O, getCurrentUser as y, getUserOperation as P, initialize as k, isSignedIn as M, onAuthStateChange as C, onOAuthStateChange as I, sendEvmTransaction as W, sendSolanaTransaction as V, sendUserOperation as R, signEvmHash as U, signEvmMessage as D, signEvmTransaction as N, signEvmTypedData as b, signInWithEmail as w, signInWithOAuth as B, signInWithSms as H, signOut as _, signSolanaMessage as z, signSolanaTransaction as G, verifyEmailOTP as J, verifyOAuth as X, verifySmsOTP as j } from "./index.native10.js";
 import { createSpendPermission as F } from "./index.native11.js";
 import { listSpendPermissions as L } from "./index.native12.js";
 import { APIError as Y, ErrorType as Z, HttpErrorType as $, OAuth2ProviderType as rr, SendEvmTransactionWithEndUserAccountBodyNetwork as or, SendSolanaTransactionWithEndUserAccountBodyNetwork as tr } from "@coinbase/cdp-api-client";
 import { revokeSpendPermission as nr } from "./index.native13.js";
 import { getCurrentUserSync as ar } from "./index.native14.js";
 import { fetchWithX402 as sr } from "./index.native15.js";
-import { linkGoogle as cr } from "./index.native16.js";
-import { linkSms as Er } from "./index.native17.js";
-import { linkEmail as ur } from "./index.native18.js";
+import { linkGoogle as fr } from "./index.native16.js";
+import { linkSms as lr } from "./index.native17.js";
+import { linkEmail as gr } from "./index.native18.js";
 import { linkOAuth as xr } from "./index.native19.js";
-import { linkApple as Ar } from "./index.native20.js";
+import { linkApple as dr } from "./index.native20.js";
 import { createEvmEoaAccount as hr } from "./index.native21.js";
 import { createEvmSmartAccount as Tr } from "./index.native22.js";
 import { createSolanaAccount as yr } from "./index.native23.js";
-import { initiateMfaEnrollment as kr } from "./index.native24.js";
-import { submitMfaEnrollment as Wr } from "./index.native25.js";
-import { initiateMfaVerification as Mr } from "./index.native26.js";
-import { submitMfaVerification as Rr } from "./index.native27.js";
-import { AuthManager as Dr } from "./index.native28.js";
-import { CustomAuthError as br } from "./index.native29.js";
-import { toViemAccount as Br } from "./index.native30.js";
-import { InputValidationError as _r, InternalError as zr, ModuleResolutionError as Gr, ValidationError as Jr } from "./index.native31.js";
-import { createCDPEmbeddedWallet as jr } from "./index.native32.js";
-import { EIP1193ProviderError as Fr, STANDARD_ERROR_CODES as Kr } from "./index.native33.js";
+import { getMfaConfig as kr } from "./index.native24.js";
+import { recordMfaEnrollmentPrompted as Cr } from "./index.native25.js";
+import { initiateMfaEnrollment as Wr } from "./index.native26.js";
+import { submitMfaEnrollment as Rr } from "./index.native27.js";
+import { initiateMfaVerification as Dr } from "./index.native28.js";
+import { submitMfaVerification as br } from "./index.native29.js";
+import { AuthManager as Br } from "./index.native30.js";
+import { CustomAuthError as _r } from "./index.native31.js";
+import { toViemAccount as Gr } from "./index.native32.js";
+import { InputValidationError as Xr, InternalError as jr, ModuleResolutionError as qr, ValidationError as Fr } from "./index.native33.js";
+import { createCDPEmbeddedWallet as Lr } from "./index.native34.js";
+import { EIP1193ProviderError as Yr, STANDARD_ERROR_CODES as Zr } from "./index.native35.js";
 import "viem";
 import "zustand";
 r.registerPackageVersion("core", a);
@@ -42,21 +44,21 @@ i({
 });
 export {
   Y as APIError,
-  Dr as AuthManager,
-  br as CustomAuthError,
-  Fr as EIP1193ProviderError,
+  Br as AuthManager,
+  _r as CustomAuthError,
+  Yr as EIP1193ProviderError,
   Z as ErrorType,
   $ as HttpErrorType,
-  _r as InputValidationError,
-  zr as InternalError,
-  Gr as ModuleResolutionError,
+  Xr as InputValidationError,
+  jr as InternalError,
+  qr as ModuleResolutionError,
   rr as OAuth2ProviderType,
-  Kr as STANDARD_ERROR_CODES,
+  Zr as STANDARD_ERROR_CODES,
   or as SendEvmTransactionWithEndUserAccountBodyNetwork,
   tr as SendSolanaTransactionWithEndUserAccountBodyNetwork,
-  Jr as ValidationError,
-  d as authenticateWithJWT,
-  jr as createCDPEmbeddedWallet,
+  Fr as ValidationError,
+  A as authenticateWithJWT,
+  Lr as createCDPEmbeddedWallet,
   hr as createEvmEoaAccount,
   Tr as createEvmSmartAccount,
   yr as createSolanaAccount,
@@ -68,21 +70,23 @@ export {
   O as getAccessTokenExpiration,
   y as getCurrentUser,
   ar as getCurrentUserSync,
+  kr as getMfaConfig,
   P as getUserOperation,
   k as initialize,
-  kr as initiateMfaEnrollment,
-  Mr as initiateMfaVerification,
-  I as isSignedIn,
-  Ar as linkApple,
-  ur as linkEmail,
-  cr as linkGoogle,
+  Wr as initiateMfaEnrollment,
+  Dr as initiateMfaVerification,
+  M as isSignedIn,
+  dr as linkApple,
+  gr as linkEmail,
+  fr as linkGoogle,
   xr as linkOAuth,
-  Er as linkSms,
+  lr as linkSms,
   L as listSpendPermissions,
-  W as onAuthStateChange,
-  C as onOAuthStateChange,
+  C as onAuthStateChange,
+  I as onOAuthStateChange,
+  Cr as recordMfaEnrollmentPrompted,
   nr as revokeSpendPermission,
-  M as sendEvmTransaction,
+  W as sendEvmTransaction,
   V as sendSolanaTransaction,
   R as sendUserOperation,
   U as signEvmHash,
@@ -95,9 +99,9 @@ export {
   _ as signOut,
   z as signSolanaMessage,
   G as signSolanaTransaction,
-  Wr as submitMfaEnrollment,
-  Rr as submitMfaVerification,
-  Br as toViemAccount,
+  Rr as submitMfaEnrollment,
+  br as submitMfaVerification,
+  Gr as toViemAccount,
   J as verifyEmailOTP,
   X as verifyOAuth,
   j as verifySmsOTP

package/dist/esm/index.native10.js

@@ -1,22 +1,22 @@
-import { b as m } from "./index.native36.js";
+import { b as m } from "./index.native38.js";
 import { configureCdpApiClient as T, setAuthManager as b, authenticateUserWithCustomAuth as j, initiateAuthentication as P, createEndUserEvmAccount as x, createEndUserEvmSmartAccount as k, createEndUserSolanaAccount as K, verifyEmailAuthentication as W, verifySmsAuthentication as H, verifyOAuthCode as R, signEvmHashWithEndUserAccount as B, signEvmTransactionWithEndUserAccount as D, signSolanaTransactionWithEndUserAccount as N, sendEvmTransactionWithEndUserAccount as F, sendSolanaTransactionWithEndUserAccount as J, signEvmMessageWithEndUserAccount as L, signSolanaMessageWithEndUserAccount as z, signEvmTypedDataWithEndUserAccount as $, sendUserOperationWithEndUserAccount as V, getUserOperationWithEndUserAccount as q, exportEndUserEvmAccount as G, exportEndUserSolanaAccount as Q } from "@coinbase/cdp-api-client";
 import { Analytics as c } from "./index.native2.js";
 import "./index.native3.js";
 import { Keypair as E } from "@solana/web3.js";
 import S from "bs58";
-import { createAuthManager as X } from "./index.native37.js";
-import { CUSTOM_AUTH_REFRESH_BUFFER_MS as Y } from "./index.native38.js";
-import { OAuthManager as Z } from "./index.native39.js";
-import { toAuthState as g } from "./index.native40.js";
-import { withAuth as d } from "./index.native41.js";
-import { MockAuthManager as ee } from "./index.native42.js";
-import { MockOAuthManager as te } from "./index.native43.js";
-import { mockUser as p } from "./index.native44.js";
+import { createAuthManager as X } from "./index.native39.js";
+import { CUSTOM_AUTH_REFRESH_BUFFER_MS as Y } from "./index.native40.js";
+import { OAuthManager as Z } from "./index.native41.js";
+import { toAuthState as g } from "./index.native42.js";
+import { withAuth as d } from "./index.native43.js";
+import { MockAuthManager as ee } from "./index.native44.js";
+import { MockOAuthManager as te } from "./index.native45.js";
+import { mockUser as p } from "./index.native46.js";
 import { getPlatformServices as f, getPlatformCrypto as U } from "./index.native8.js";
-import { isChainSupportedForCDPSends as ne } from "./index.native45.js";
-import { getConfig as a, setCoreAuthManager as I, setCoreOAuthManager as _, getCoreAuthManager as o, getCoreOAuthManager as re, setConfig as se } from "./index.native35.js";
-import { CustomAuthError as w } from "./index.native29.js";
-import { serializeTransaction as C } from "./index.native46.js";
+import { isChainSupportedForCDPSends as ne } from "./index.native47.js";
+import { getConfig as a, setCoreAuthManager as I, setCoreOAuthManager as _, getCoreAuthManager as o, getCoreOAuthManager as re, setConfig as se } from "./index.native37.js";
+import { CustomAuthError as w } from "./index.native31.js";
+import { serializeTransaction as C } from "./index.native48.js";
 const _e = async (e) => {
   if (!e.projectId)
     throw new Error("Project ID is required");

package/dist/esm/index.native100.js

@@ -1,37 +1,16 @@
-import { formatGwei as a } from "./index.native106.js";
-import { BaseError as o } from "./index.native85.js";
-class n extends o {
-  constructor({ cause: r, maxFeePerGas: e } = {}) {
-    super(`The fee cap (\`maxFeePerGas\`${e ? ` = ${a(e)} gwei` : ""}) cannot be higher than the maximum allowed value (2^256-1).`, {
-      cause: r,
-      name: "FeeCapTooHighError"
+import { blobsToCommitments as f } from "./index.native97.js";
+import { blobsToProofs as l } from "./index.native98.js";
+import { toBlobs as p } from "./index.native121.js";
+function k(t) {
+  const { data: i, kzg: n, to: m } = t, s = t.blobs ?? p({ data: i, to: m }), b = t.commitments ?? f({ blobs: s, kzg: n, to: m }), r = t.proofs ?? l({ blobs: s, commitments: b, kzg: n, to: m }), c = [];
+  for (let o = 0; o < s.length; o++)
+    c.push({
+      blob: s[o],
+      commitment: b[o],
+      proof: r[o]
     });
-  }
+  return c;
 }
-Object.defineProperty(n, "nodeMessage", {
-  enumerable: !0,
-  configurable: !0,
-  writable: !0,
-  value: /max fee per gas higher than 2\^256-1|fee cap higher than 2\^256-1/
-});
-class h extends o {
-  constructor({ cause: r, maxPriorityFeePerGas: e, maxFeePerGas: t } = {}) {
-    super([
-      `The provided tip (\`maxPriorityFeePerGas\`${e ? ` = ${a(e)} gwei` : ""}) cannot be higher than the fee cap (\`maxFeePerGas\`${t ? ` = ${a(t)} gwei` : ""}).`
-    ].join(`
-`), {
-      cause: r,
-      name: "TipAboveFeeCapError"
-    });
-  }
-}
-Object.defineProperty(h, "nodeMessage", {
-  enumerable: !0,
-  configurable: !0,
-  writable: !0,
-  value: /max priority fee per gas higher than max fee per gas|tip higher than fee cap/
-});
 export {
-  n as FeeCapTooHighError,
-  h as TipAboveFeeCapError
+  k as toBlobSidecars
 };

package/dist/esm/index.native101.js

@@ -1,11 +1,21 @@
-import { hexToBytes as i } from "./index.native73.js";
-import { bytesToHex as f } from "./index.native71.js";
-function y(o) {
-  const { kzg: s } = o, n = o.to ?? (typeof o.blobs[0] == "string" ? "hex" : "bytes"), m = typeof o.blobs[0] == "string" ? o.blobs.map((t) => i(t)) : o.blobs, b = [];
-  for (const t of m)
-    b.push(Uint8Array.from(s.blobToKzgCommitment(t)));
-  return n === "bytes" ? b : b.map((t) => f(t));
+import { InvalidAddressError as s } from "./index.native93.js";
+import { InvalidStorageKeySizeError as l } from "./index.native89.js";
+import { isAddress as f } from "./index.native72.js";
+function a(r) {
+  if (!r || r.length === 0)
+    return [];
+  const n = [];
+  for (let o = 0; o < r.length; o++) {
+    const { address: i, storageKeys: e } = r[o];
+    for (let t = 0; t < e.length; t++)
+      if (e[t].length - 2 !== 64)
+        throw new l({ storageKey: e[t] });
+    if (!f(i, { strict: !1 }))
+      throw new s({ address: i });
+    n.push([i, e]);
+  }
+  return n;
 }
 export {
-  y as blobsToCommitments
+  a as serializeAccessList
 };

package/dist/esm/index.native102.js

@@ -1,13 +1,8 @@
-import { hexToBytes as b } from "./index.native73.js";
-import { bytesToHex as y } from "./index.native71.js";
-function h(t) {
-  const { kzg: m } = t, c = t.to ?? (typeof t.blobs[0] == "string" ? "hex" : "bytes"), s = typeof t.blobs[0] == "string" ? t.blobs.map((o) => b(o)) : t.blobs, i = typeof t.commitments[0] == "string" ? t.commitments.map((o) => b(o)) : t.commitments, n = [];
-  for (let o = 0; o < s.length; o++) {
-    const f = s[o], l = i[o];
-    n.push(Uint8Array.from(m.computeBlobKzgProof(f, l)));
-  }
-  return c === "bytes" ? n : n.map((o) => y(o));
+import { gweiUnits as i } from "./index.native103.js";
+import { formatUnits as o } from "./index.native104.js";
+function f(r, t = "wei") {
+  return o(r, i[t]);
 }
 export {
-  h as blobsToProofs
+  f as formatGwei
 };

package/dist/esm/index.native103.js

@@ -1,14 +1,7 @@
-import { commitmentToVersionedHash as i } from "./index.native141.js";
-function r(o) {
-  const { commitments: t, version: n } = o, e = o.to ?? (typeof t[0] == "string" ? "hex" : "bytes"), s = [];
-  for (const m of t)
-    s.push(i({
-      commitment: m,
-      to: e,
-      version: n
-    }));
-  return s;
-}
+const e = {
+  ether: -9,
+  wei: 9
+};
 export {
-  r as commitmentsToVersionedHashes
+  e as gweiUnits
 };

package/dist/esm/index.native104.js

@@ -1,16 +1,13 @@
-import { blobsToCommitments as f } from "./index.native101.js";
-import { blobsToProofs as l } from "./index.native102.js";
-import { toBlobs as p } from "./index.native142.js";
-function k(t) {
-  const { data: i, kzg: n, to: m } = t, s = t.blobs ?? p({ data: i, to: m }), b = t.commitments ?? f({ blobs: s, kzg: n, to: m }), r = t.proofs ?? l({ blobs: s, commitments: b, kzg: n, to: m }), c = [];
-  for (let o = 0; o < s.length; o++)
-    c.push({
-      blob: s[o],
-      commitment: b[o],
-      proof: r[o]
-    });
-  return c;
+function a(r, n) {
+  let t = r.toString();
+  const i = t.startsWith("-");
+  i && (t = t.slice(1)), t = t.padStart(n, "0");
+  let [l, e] = [
+    t.slice(0, t.length - n),
+    t.slice(t.length - n)
+  ];
+  return e = e.replace(/(0+)$/, ""), `${i ? "-" : ""}${l || "0"}${e ? `.${e}` : ""}`;
 }
 export {
-  k as toBlobSidecars
+  a as formatUnits
 };