@coinbase/cdp-core 0.0.123 → 0.0.125

package/dist/native/index.native98.js

@@ -1,34 +1,9 @@
-function a(e) {
-  if (typeof btoa < "u")
-    return btoa(
-      Array.from(e).map((t) => String.fromCharCode(t)).join("")
+function n(e) {
+  if (!/^\+[1-9]\d{1,14}$/.test(e))
+    throw new Error(
+      `Invalid phone number format: "${e}". Phone number must be in E.164 format (e.g., +14155552671). Requirements: starts with +, followed by country code (1-3 digits), then subscriber number. Total length: 1-15 digits (excluding + prefix).`
     );
-  const c = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
-  let r = "";
-  for (let t = 0; t < e.length; t += 3) {
-    const h = e[t], n = t + 1 < e.length ? e[t + 1] : 0, s = t + 2 < e.length ? e[t + 2] : 0, o = h << 16 | n << 8 | s;
-    r += c.charAt(o >> 18 & 63), r += c.charAt(o >> 12 & 63), r += t + 1 < e.length ? c.charAt(o >> 6 & 63) : "=", r += t + 2 < e.length ? c.charAt(o & 63) : "=";
-  }
-  return r;
-}
-function g(e) {
-  if (typeof atob < "u") {
-    const n = atob(e), s = new Uint8Array(n.length);
-    for (let o = 0; o < n.length; o++)
-      s[o] = n.charCodeAt(o);
-    return s;
-  }
-  const c = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/", r = {};
-  for (let n = 0; n < c.length; n++)
-    r[c[n]] = n;
-  const t = e.replace(/[^A-Za-z0-9+/]/g, ""), h = [];
-  for (let n = 0; n < t.length; n += 4) {
-    const s = r[t[n]] || 0, o = r[t[n + 1]] || 0, l = r[t[n + 2]] || 0, f = r[t[n + 3]] || 0, i = s << 18 | o << 12 | l << 6 | f;
-    h.push(i >> 16 & 255), n + 2 < t.length && h.push(i >> 8 & 255), n + 3 < t.length && h.push(i & 255);
-  }
-  return new Uint8Array(h);
 }
 export {
-  g as decodeBase64,
-  a as encodeBase64
+  n as validatePhoneNumber
 };

package/dist/native/index.native99.js

@@ -1,28 +1,62 @@
-import "@coinbase/cdp-api-client";
+import "viem/chains";
+import { createStore as a } from "zustand";
+import { subscribeWithSelector as c, persist as d, createJSONStorage as h } from "zustand/middleware";
+import { EventEmitter as f } from "./index.native120.js";
+import "./index.native121.js";
+import { createProvider as u } from "./index.native122.js";
+import "ox/Provider";
 import "viem";
-const u = async (t) => await t.isSignedIn();
-async function i(t, a, r) {
-  if (!await u(a))
-    throw new Error("User not signed in");
-  const c = a.getUser();
-  if ("evmAccount" in t) {
-    const o = t.evmAccount.toLowerCase();
-    if (!(c.evmAccounts?.find((n) => n.toLowerCase() === o) || c.evmAccountObjects?.find((n) => n.address.toLowerCase() === o)))
-      throw new Error("EVM account not found");
-  }
-  if ("evmSmartAccount" in t) {
-    const o = t.evmSmartAccount.toLowerCase();
-    if (!(c.evmSmartAccounts?.find((n) => n.toLowerCase() === o) || c.evmSmartAccountObjects?.find(
-      (n) => n.address.toLowerCase() === o
-    )))
-      throw new Error("EVM Smart Account not found");
-  }
-  if ("solanaAccount" in t && !(c.solanaAccounts?.find((e) => e === t.solanaAccount) || c.solanaAccountObjects?.find((e) => e.address === t.solanaAccount)))
-    throw new Error("Solana account not found");
-  const s = await a.getWalletSecretId();
-  return r({ ...t, user: c, walletSecretId: s });
+import "@coinbase/cdp-api-client";
+import { getPlatformStorage as g } from "./index.native10.js";
+import { onAuthStateChange as l } from "./index.native29.js";
+import "./index.native2.js";
+import "./index.native3.js";
+import "jose";
+import "jose/jwt/sign";
+import "./index.native108.js";
+import "./index.native111.js";
+import "viem/utils";
+import "./index.native109.js";
+import "@solana/web3.js";
+import "bs58";
+function B(e) {
+  if (e.chains.length === 0)
+    throw new Error("At least one chain must be configured");
+  if (!e.transports)
+    throw new Error("Transports must be provided");
+  const o = e.chains, m = e.transports;
+  if (o.length === 0)
+    throw new Error("No chains found in configuration");
+  const s = new f(), i = g(), p = {
+    getItem: (t) => i.getItem(t),
+    setItem: (t, r) => i.setItem(t, r),
+    removeItem: (t) => i.removeItem(t)
+  }, n = a()(
+    c(
+      d(
+        (t) => ({
+          chainId: o[0].id,
+          setChainId: (r) => t({ chainId: r }),
+          chains: o,
+          user: null,
+          setUser: (r) => t({ user: r })
+        }),
+        {
+          name: "cdp-provider-store",
+          storage: h(() => p)
+        }
+      )
+    )
+  );
+  return n.persist.rehydrate(), l((t) => {
+    n.getState().setUser(t);
+  }), {
+    provider: u(s, n, {
+      chains: o,
+      transports: m
+    })
+  };
 }
 export {
-  u as isSignedIn,
-  i as withAuth
+  B as createCDPEmbeddedWallet
 };

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

@@ -0,0 +1,79 @@
+import { PaymasterContext } from '@coinbase/cdp-api-client';
+import { EvmAddress, Hex } from '../types.js';
+/**
+ * Input for adjusting a borrow position.
+ * The borrow position owner is automatically detected from the current user.
+ */
+export type AdjustBorrowPositionOptions = {
+    /** The globally unique ID of the borrow product whose position to adjust. */
+    borrowProductId: string;
+    /**
+     * The amount of collateral to add to the position, as a decimal string in
+     * standard unit denomination of the collateral token (e.g., "1" for 1 cbBTC).
+     * Can be combined with `borrowLoanAmount`. Must not be combined with
+     * `removeCollateralAmount`.
+     */
+    addCollateralAmount?: string;
+    /**
+     * The amount of collateral to withdraw from the position, as a decimal string
+     * in standard unit denomination of the collateral token (e.g., "1" for
+     * 1 cbBTC). Can be combined with `repayLoanAmount`. Must not be combined with
+     * `addCollateralAmount`.
+     */
+    removeCollateralAmount?: string;
+    /**
+     * The amount of the loan token to repay, as a decimal string in standard unit
+     * denomination of the loan token (e.g., "100" for 100 USDC). Can be combined
+     * with `removeCollateralAmount`. Must not be combined with `borrowLoanAmount`.
+     */
+    repayLoanAmount?: string;
+    /**
+     * The amount of the loan token to borrow, as a decimal string in standard
+     * unit denomination of the loan token (e.g., "100" for 100 USDC). Can be
+     * combined with `addCollateralAmount`. Must not be combined with
+     * `repayLoanAmount`.
+     */
+    borrowLoanAmount?: string;
+    /** The EVM Smart Account that owns the borrow position. */
+    evmSmartAccount: EvmAddress;
+    /**
+     * Whether to use the CDP Paymaster for the user operation.
+     *
+     * Only available on Base.
+     */
+    useCdpPaymaster?: boolean;
+    /** The URL of the paymaster to use for the user operation. */
+    paymasterUrl?: string;
+    /** Optional paymaster metadata forwarded to the paymaster service. Valid only when a paymaster is configured. */
+    paymasterContext?: PaymasterContext;
+};
+/**
+ * Result of adjustBorrowPosition.
+ */
+export type AdjustBorrowPositionResult = {
+    /** The user operation hash. */
+    userOperationHash: Hex;
+};
+/**
+ * Adjusts an existing borrow position for the user's EVM Smart Account.
+ *
+ * Supplies collateral, withdraws collateral, repays debt, and/or borrows more
+ * of the loan asset for a specific borrow product. At least one operation
+ * amount must be supplied. Supplying collateral and borrowing more can be
+ * combined, as can withdrawing collateral and repaying debt. A user operation
+ * is broadcast to adjust the position onchain.
+ *
+ * @param options - The options for adjusting the borrow position.
+ * @example
+ * ```typescript lines
+ * const result = await adjustBorrowPosition({
+ *   borrowProductId: "bp_07fb56c0-9afe-5440-8ff2-5b0e115458df",
+ *   addCollateralAmount: "1", // add 1 cbBTC
+ *   borrowLoanAmount: "100", // borrow 100 more USDC
+ *   useCdpPaymaster: true,
+ *   evmSmartAccount: "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
+ * });
+ * ```
+ * @returns The result of the borrow position adjustment.
+ */
+export declare const adjustBorrowPosition: (options: AdjustBorrowPositionOptions) => Promise<AdjustBorrowPositionResult>;

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

@@ -0,0 +1,49 @@
+import { PaymasterContext } from '@coinbase/cdp-api-client';
+import { EvmAddress, Hex } from '../types.js';
+/**
+ * Input for closing a borrow position.
+ * The borrow position owner is automatically detected from the current user.
+ */
+export type CloseBorrowPositionOptions = {
+    /** The globally unique ID of the borrow product whose position to close. */
+    borrowProductId: string;
+    /** The EVM Smart Account that owns the borrow position. */
+    evmSmartAccount: EvmAddress;
+    /**
+     * Whether to use the CDP Paymaster for the user operation.
+     *
+     * Only available on Base.
+     */
+    useCdpPaymaster?: boolean;
+    /** The URL of the paymaster to use for the user operation. */
+    paymasterUrl?: string;
+    /** Optional paymaster metadata forwarded to the paymaster service. Valid only when a paymaster is configured. */
+    paymasterContext?: PaymasterContext;
+};
+/**
+ * Result of closeBorrowPosition.
+ */
+export type CloseBorrowPositionResult = {
+    /** The user operation hash. */
+    userOperationHash: Hex;
+};
+/**
+ * Closes an existing borrow position for the user's EVM Smart Account.
+ *
+ * Fully repays the position's outstanding loan and withdraws all remaining
+ * collateral back to the smart account, broadcasting a single user operation
+ * to settle the position onchain. There is no partial close; use
+ * `adjustBorrowPosition` to adjust a position without closing it.
+ *
+ * @param options - The options for closing the borrow position.
+ * @example
+ * ```typescript lines
+ * const result = await closeBorrowPosition({
+ *   borrowProductId: "bp_07fb56c0-9afe-5440-8ff2-5b0e115458df",
+ *   evmSmartAccount: "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
+ *   useCdpPaymaster: true,
+ * });
+ * ```
+ * @returns The result of the borrow position close, containing the user operation hash.
+ */
+export declare const closeBorrowPosition: (options: CloseBorrowPositionOptions) => Promise<CloseBorrowPositionResult>;

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

@@ -0,0 +1,31 @@
+import { PaymasterContext } from '@coinbase/cdp-api-client';
+import { EvmAddress, Hex } from '../types.js';
+/** Input for creating a borrow position. */
+export type CreateBorrowPositionOptions = {
+    /** The globally unique ID of the borrow product to borrow against. */
+    borrowProductId: string;
+    /** The amount of collateral to post, in standard token units. */
+    collateralAmount: string;
+    /** The amount of the loan token to borrow, in standard token units. */
+    loanAmount: string;
+    /** The EVM Smart Account to open the borrow position from. */
+    evmSmartAccount: EvmAddress;
+    /** Whether to use the CDP Paymaster. */
+    useCdpPaymaster?: boolean;
+    /** The URL of the paymaster to use. */
+    paymasterUrl?: string;
+    /** Optional paymaster metadata forwarded to the paymaster service. Valid only when a paymaster is configured. */
+    paymasterContext?: PaymasterContext;
+};
+/** Result of creating a borrow position. */
+export type CreateBorrowPositionResult = {
+    /** The user operation hash. */
+    userOperationHash: Hex;
+};
+/**
+ * Creates a borrow position for the user's EVM Smart Account.
+ *
+ * @param options - The request parameters for creating a borrow position.
+ * @returns The result containing the user operation hash.
+ */
+export declare const createBorrowPosition: (options: CreateBorrowPositionOptions) => Promise<CreateBorrowPositionResult>;

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

@@ -1,19 +1,52 @@
-import { EvmAddress } from '../types.js';
-import { PaymentRequirementsSelector, X402Config, wrapFetchWithPayment } from 'x402-fetch';
+import { EvmAddress, SolanaAddress } from '../types.js';
+import { PaymentPolicy, x402Client } from '@x402/core/client';
+import { wrapFetchWithPayment } from '@x402/fetch';
+/**
+ * Opt-in/out per x402 payment scheme. `exact`, `upto`, and `authCapture` all
+ * default on.
+ *
+ * `authCapture` only applies to EVM (Base) — it's skipped for a Solana
+ * account regardless of this setting, matching `@x402/svm`'s current scheme
+ * coverage.
+ */
+export type X402SchemesConfig = {
+    /** Registers `ExactEvmScheme` / `ExactSvmScheme`. Defaults to `true`. */
+    exact?: boolean;
+    /** Registers `UptoEvmScheme` / `UptoSvmScheme` (usage-based billing). Defaults to `true`. */
+    upto?: boolean;
+    /** Registers `AuthCaptureEvmScheme` for EVM accounts. Defaults to `true`. */
+    authCapture?: boolean;
+};
 /**
  * Options for the fetchWithX402 function.
  */
 export type FetchWithX402Options = {
-    /** The address of the account to use for the fetch function. */
-    address?: EvmAddress | string;
-    /** The fetch function to use for the fetch function. */
+    /**
+     * The address of the account to use for the fetch function. Pins the
+     * network family — no fallback to the other network is attempted.
+     *
+     * Defaults to the signed-in user's smart account, then EOA, then Solana
+     * account: auto-detection falls back to the Solana account if no EVM
+     * account resolves.
+     */
+    address?: EvmAddress | SolanaAddress | string;
+    /** Custom `fetch` implementation to wrap. Defaults to `globalThis.fetch`. */
     fetch?: typeof globalThis.fetch;
-    /** The maximum allowed payment amount in base units (defaults to 0.1 USDC) */
-    maxValue?: bigint;
-    /** A function that selects the payment requirements from the response */
-    paymentRequirementsSelector?: PaymentRequirementsSelector;
-    /** Optional configuration for X402 operations (e.g., custom RPC URLs) */
-    config?: X402Config;
+    /**
+     * CAIP-2 network id -> RPC URL overrides, e.g.
+     * `{ "eip155:84532": "https://sepolia.base.org" }`. Also registers payment
+     * schemes on any additional `eip155:*` / `solana:*` network supplied here,
+     * on top of the Base mainnet + Solana mainnet baseline that's always
+     * registered.
+     */
+    rpcUrls?: Record<string, string>;
+    /**
+     * Policies registered on the underlying `x402Client`, e.g. to cap spend or
+     * restrict networks/assets.
+     */
+    policies?: PaymentPolicy[];
+    /** Opt-in/out per payment scheme. See {@link X402SchemesConfig}. */
+    schemes?: X402SchemesConfig;
 };
 /**
  * Return type for the fetchWithX402 function.
@@ -21,13 +54,38 @@ export type FetchWithX402Options = {
 export type FetchWithX402ReturnType = {
     /** The wrapped fetch function with payment handling. */
     fetchWithPayment: ReturnType<typeof wrapFetchWithPayment>;
+    /** The lazily initialized `x402Client` for advanced configuration. */
+    client: Promise<x402Client>;
 };
 /**
- * Hook that provides a wrapped fetch function with payment handling.
+ * Imports an x402 peer dependency, adding installation guidance when the
+ * module can't be resolved. Runtime errors thrown by an already-installed
+ * module (e.g. a bug surfaced while evaluating it) are re-thrown as-is,
+ * since installation guidance would be misleading there.
+ *
+ * Exported (but not part of the public SDK surface — not re-exported from
+ * any index) so this classification can be unit tested directly without
+ * fighting test-mocking frameworks' own module-loading error handling.
+ *
+ * @param specifier - The module specifier being imported, for the error message.
+ * @param loader - Thunk performing the dynamic `import()`, so callers keep accurate typing.
+ * @returns The imported module's exports.
+ */
+export declare function importX402Dependency<T>(specifier: string, loader: () => Promise<T>): Promise<T>;
+/**
+ * Provides a wrapped fetch function with x402 (v2) payment handling, backed
+ * by the current CDP embedded wallet user's EVM or Solana account.
+ *
+ * Builds an `x402Client` and registers payment schemes on it: for an EVM
+ * account, `exact`/`upto`/`authCapture` on Base; for a Solana account,
+ * `exact`/`upto` on Solana. See {@link X402SchemesConfig}.
  *
  * @param options - Configuration object for the fetch function
  * @param options.address - The address to use for the fetch function
- * @returns A wrapped fetch function with payment handling
+ * @param options.rpcUrls - CAIP-2 network id -> RPC URL overrides
+ * @param options.policies - Policies to register on the underlying `x402Client`
+ * @param options.schemes - Opt-in/out per payment scheme
+ * @returns A wrapped fetch function with payment handling, and the underlying `x402Client`
  *
  * @example
  * ```tsx lines
@@ -36,5 +94,14 @@ export type FetchWithX402ReturnType = {
  *   method: "GET",
  * });
  * ```
+ *
+ * @example
+ * ```tsx lines
+ * // Also register Base Sepolia (e.g. for local testing) and disable authCapture.
+ * const { fetchWithPayment } = fetchWithX402({
+ *   rpcUrls: { "eip155:84532": "https://sepolia.base.org" },
+ *   schemes: { authCapture: false },
+ * });
+ * ```
  */
 export declare function fetchWithX402(options?: FetchWithX402Options): FetchWithX402ReturnType;

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

@@ -0,0 +1,22 @@
+import { BorrowProduct } from '@coinbase/cdp-api-client';
+/** Options for fetching a single EVM borrow product by ID. */
+export type GetEvmBorrowProductOptions = {
+    /** The globally unique ID of the borrow product to fetch. */
+    borrowProductId: string;
+};
+/** The result of fetching a single EVM borrow product. */
+export type GetEvmBorrowProductResult = BorrowProduct;
+/**
+ * Gets a single EVM borrow product by its ID.
+ *
+ * @param options - The request parameters including the `borrowProductId`.
+ * @returns The borrow product.
+ *
+ * @example
+ * ```typescript
+ * const borrowProduct = await getEvmBorrowProduct({
+ *   borrowProductId: "bp_07fb56c0-9afe-5440-8ff2-5b0e115458df",
+ * });
+ * ```
+ */
+export declare const getEvmBorrowProduct: (options: GetEvmBorrowProductOptions) => Promise<GetEvmBorrowProductResult>;

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

@@ -1,4 +1,4 @@
-import { MfaMethod } from '@coinbase/cdp-api-client';
+import { InitiateMfaVerificationResponseWrapper, MfaMethod } from '@coinbase/cdp-api-client';
 /**
  * Request parameters for initiating MFA verification.
  */
@@ -7,6 +7,12 @@ export type InitiateMfaVerificationOptions = {
     mfaMethod: MfaMethod;
     /** Optional idempotency key for safe retries. */
     idempotencyKey?: string;
+    /**
+     * Opaque challenge handle from the MFA listener's context, required when the
+     * project's `verificationScope` is `request`; ignored under `session`. Never
+     * inspected — pass through the value received from the listener unchanged.
+     */
+    challengeId?: string;
 };
 /**
  * Initiates an MFA verification flow for operations requiring MFA.
@@ -28,6 +34,7 @@ export type InitiateMfaVerificationOptions = {
  * await initiateMfaVerification({ mfaMethod: "sms" });
  * // SMS sent to user's phone - prompt for code
  * ```
- * @returns A promise that resolves if MFA initiation is successful.
+ * @returns A promise that resolves with the initiate response (opaque under `session`
+ *   scope, where it resolves to `{}`) once MFA initiation is successful.
  */
-export declare const initiateMfaVerification: (options: InitiateMfaVerificationOptions) => Promise<void>;
+export declare const initiateMfaVerification: (options: InitiateMfaVerificationOptions) => Promise<InitiateMfaVerificationResponseWrapper | void>;

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

@@ -0,0 +1,36 @@
+import { BorrowPosition } from '@coinbase/cdp-api-client';
+import { EvmAddress } from '../types.js';
+/** Options for listing borrow positions for an EVM Smart Account. */
+export type ListBorrowPositionsOptions = {
+    /** The EVM Smart Account to list borrow positions for. */
+    evmSmartAccount: EvmAddress;
+    /** The number of resources to return per page. */
+    pageSize?: number;
+    /** The token for the next page of resources, if any. */
+    pageToken?: string;
+};
+/** A page of borrow positions held by a smart account. */
+export type ListBorrowPositionsResult = {
+    /** The borrow positions held by the smart account. */
+    borrowPositions: BorrowPosition[];
+    /** Whether there are more results available. */
+    hasNextPage: boolean;
+    /** The token for the next page of borrow positions, if any. */
+    nextPageToken: string | undefined;
+};
+/**
+ * Lists the borrow positions held by an EVM Smart Account for the signed-in end
+ * user, with the live onchain state of each position read at a point-in-time
+ * snapshot.
+ *
+ * @param options - The request parameters including the smart account address and optional pagination.
+ * @returns A page of borrow positions, a `hasNextPage` flag, and an optional `nextPageToken` for pagination.
+ *
+ * @example
+ * ```typescript
+ * const { borrowPositions, hasNextPage, nextPageToken } = await listBorrowPositions({
+ *   evmSmartAccount: "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
+ * });
+ * ```
+ */
+export declare const listBorrowPositions: (options: ListBorrowPositionsOptions) => Promise<ListBorrowPositionsResult>;

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

@@ -0,0 +1,36 @@
+import { BorrowProduct, BorrowProductNetwork, BorrowProductProtocol } from '@coinbase/cdp-api-client';
+/** Options for listing EVM borrow products. */
+export type ListEvmBorrowProductsOptions = {
+    /** The EVM network to list borrow products for. Currently only `"base"` is supported. */
+    network?: BorrowProductNetwork;
+    /** The lending protocol whose borrow products to list. Currently only `"morpho_blue"` is supported. */
+    protocol?: BorrowProductProtocol;
+    /** The number of resources to return per page. */
+    pageSize?: number;
+    /** The token for the next page of resources, if any. */
+    pageToken?: string;
+};
+/** A page of EVM borrow products. */
+export type ListEvmBorrowProductsResult = {
+    /** The EVM borrow products on the requested network and protocol. */
+    borrowProducts: BorrowProduct[];
+    /** Whether there are more results available. */
+    hasNextPage: boolean;
+    /** The token for the next page of borrow products, if any. */
+    nextPageToken: string | undefined;
+};
+/**
+ * Lists the EVM borrow products available to the signed-in end user.
+ *
+ * @param options - The request parameters (network, protocol, optional pagination).
+ * @returns A page of borrow products and an optional `nextPageToken` for pagination.
+ *
+ * @example
+ * ```typescript
+ * const { borrowProducts, nextPageToken } = await listEvmBorrowProducts({
+ *   network: "base",
+ *   protocol: "morpho_blue",
+ * });
+ * ```
+ */
+export declare const listEvmBorrowProducts: (options?: ListEvmBorrowProductsOptions) => Promise<ListEvmBorrowProductsResult>;

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

@@ -0,0 +1,22 @@
+import { User } from '../types.js';
+/**
+ * Re-fetches the signed-in user from the API and writes the result back into shared auth state.
+ *
+ * Unlike {@link getCurrentUser}, which returns the locally cached user (and only re-fetches, without
+ * caching, when `includeBtcXpubs` is set), `refreshUser` reconciles the local auth state with the
+ * server. Use it after accounts are provisioned for the current user out-of-band — i.e. created by a
+ * backend service via the End User API rather than by an in-SDK action such as
+ * `createEvmEoaAccount` / `createSolanaAccount`, which already update the cache themselves.
+ *
+ * Because the refreshed user is written via `setAuthState`, every `useCurrentUser` /
+ * `useEvmAccounts` / `useSolanaAccounts` subscriber re-renders, and subsequent signing actions
+ * (e.g. `signEvmHash`) recognize the newly provisioned accounts instead of throwing
+ * "EVM account not found" against a stale cache.
+ *
+ * This does not request Bitcoin xpubs, so the sensitivity concern that keeps `getCurrentUser`'s
+ * xpub re-fetch out of shared state does not apply here.
+ *
+ * @returns The refreshed user, or null if no user is signed in.
+ * @throws When the network request to re-fetch the user fails.
+ */
+export declare const refreshUser: () => Promise<User | null>;

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

@@ -8,6 +8,12 @@ export type SubmitMfaVerificationOptions = {
     mfaCode: string;
     /** Optional idempotency key for safe retries. */
     idempotencyKey?: string;
+    /**
+     * Opaque challenge handle from the MFA listener's context, required when the
+     * project's `verificationScope` is `request`; ignored under `session`. Never
+     * inspected — pass through the value received from the listener unchanged.
+     */
+    challengeId?: string;
 };
 /**
  * Submits an MFA code to complete the verification process.

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

@@ -4,6 +4,12 @@
 export type VerifyPasskeyOptions = {
     /** Optional idempotency key for safe retries. */
     idempotencyKey?: string;
+    /**
+     * Opaque challenge handle from the MFA listener's context, required when the
+     * project's `verificationScope` is `request`; ignored under `session`. Never
+     * inspected — pass through the value received from the listener unchanged.
+     */
+    challengeId?: string;
 };
 /**
  * Completes an MFA verification using an enrolled passkey (WebAuthn).
@@ -23,7 +29,7 @@ export type VerifyPasskeyOptions = {
  * ```typescript
  * await verifyPasskey();
  * ```
- * @returns A promise that resolves if passkey verification is successful.
+ * @returns A promise that resolves once MFA verification is complete.
  * @throws {MfaError} With code `PASSKEY_NOT_SUPPORTED` when passkeys are not available in the current environment.
  * @throws {MfaError} With code `CANCELLED` when the user dismisses the passkey prompt or it times out.
  */