@coinbase/cdp-core 0.0.123 → 0.0.125

package/dist/web/index.web98.js

@@ -1,108 +1,138 @@
-import { Analytics as u } from "./index.web2.js";
-import "./index.web3.js";
-import { getCurrentUserSync as b } from "./index.web44.js";
+import { hashTypedData as m, serializeErc6492Signature as u, encodeFunctionData as p, pad as g, getTypesForEIP712Domain as d, hashMessage as A } from "viem";
+import { toAccount as l } from "viem/accounts";
+import { getCurrentUserSync as h } from "./index.web45.js";
 import "@coinbase/cdp-api-client";
+import "./index.web2.js";
+import "./index.web3.js";
 import "jose";
-import "viem";
-import "./index.web103.js";
-import { getConfig as S } from "./index.web74.js";
-import { getAccessToken as A } from "./index.web24.js";
-import { getAccessTokenExpiration as j } from "./index.web25.js";
-import { ensureMfaVerified as y } from "./index.web86.js";
-import { DEFAULT_SECURE_IFRAME_BASE_PATH as w, SECURE_IFRAME_KEY_EXPORT_EVENT_TYPE as n, DEFAULT_SECURE_IFRAME_THEME as k } from "./index.web97.js";
-import { validateSecureIframeEnvironment as g, createIframe as x, calculateSecureIframeHeight as U, buildKeyExportIframeUrl as L, getSecureIframeOrigin as v, isSecureIframeKeyExportMessage as R, sendSecureIframeMessage as l } from "./index.web96.js";
+import "jose/jwt/sign";
+import "./index.web110.js";
+import { signEvmHash as i } from "./index.web29.js";
+import { signEvmTransaction as f } from "./index.web30.js";
+import { signEvmMessage as y } from "./index.web31.js";
+import { signEvmTypedData as v } from "./index.web32.js";
 import "./index.web104.js";
+import "./index.web113.js";
+import "viem/utils";
+import "./index.web111.js";
 import "@solana/web3.js";
 import "bs58";
-let c = null;
-const C = async () => (c || (c = A({ forceRefresh: !0 }).finally(() => {
-  c = null;
-})), c);
-async function h(e) {
-  const r = x(e.target), I = U(e.theme), m = S().secureIframeBasePath || w;
-  r.setAttribute("allow", "clipboard-read; clipboard-write"), r.style.border = "none", r.style.display = "none", r.style.height = `${I}px`, r.src = L({ projectId: e.projectId, basePath: m });
-  const d = v(m);
-  let f = !1;
-  const E = () => {
-    f || (f = !0, window.removeEventListener("message", p), r.parentNode && r.parentNode.removeChild(r));
-  }, p = async (a) => {
-    if (a.source !== r.contentWindow || !d || a.origin !== d) return;
-    const i = a.data;
-    if (R(i))
-      switch (i.type) {
-        case n.LISTENING: {
-          try {
-            const t = b();
-            if (!t) {
-              e.onStatusUpdate?.("error", "User not authenticated");
-              return;
-            }
-            const o = await C(), s = await j();
-            l(r, {
-              type: n.GET_PRIVATE_KEY,
-              payload: {
-                address: e.address,
-                type: e.type,
-                authState: {
-                  accessToken: o || "",
-                  expiresAt: s || 0,
-                  user: t
-                },
-                theme: {
-                  ...k,
-                  ...e.theme || {}
-                },
-                config: {
-                  action: e.action,
-                  label: e.label,
-                  copiedLabel: e.copiedLabel,
-                  ejectLabel: e.ejectLabel ?? "Eject wallet",
-                  ejectingLabel: e.ejectingLabel ?? "Ejecting…",
-                  ejectedLabel: e.ejectedLabel ?? "Ejected",
-                  icon: e.icon,
-                  ejectIcon: e.ejectIcon,
-                  fullWidth: e.fullWidth
-                }
-              }
-            });
-          } catch (t) {
-            e.onStatusUpdate?.(
-              "error",
-              t instanceof Error ? "Error requesting private key: " + t.message : "Error requesting private key"
-            );
-          }
-          break;
-        }
-        case n.STATUS: {
-          const { status: t, message: o, operation: s, errorType: T, correlationId: _ } = i.payload;
-          t === "ready" && (r.style.display = "block"), t === "expired" && (r.style.display = "none", E()), e.onStatusUpdate?.(t, o, { operation: s, errorType: T, correlationId: _ });
-          break;
-        }
+import { COINBASE_SMART_WALLET_FACTORY_ADDRESS as w, COINBASE_SMART_WALLET_FACTORY_ABI as E } from "./index.web120.js";
+import { signAndWrapTypedDataForSmartAccount as T } from "./index.web121.js";
+function H(r) {
+  const o = h();
+  if (!o || !o.evmAccountObjects?.length && !o.evmSmartAccountObjects?.length)
+    throw new Error(
+      "No accounts found - user must be authenticated and have at least one EVM account or smart account"
+    );
+  const s = r.toLowerCase(), c = o.evmAccountObjects?.some((e) => e.address.toLowerCase() === s) ?? !1, a = o.evmSmartAccountObjects?.some((e) => e.address.toLowerCase() === s) ?? !1;
+  if (!c && !a)
+    throw new Error(`Cannot sign for address ${r} - not authorized for this account`);
+  return l({
+    address: r,
+    /**
+     * Signs a message using CDP's message signing functionality.
+     * Supports string messages, hex strings, and byte arrays.
+     *
+     * @param root0 - The parameters object
+     * @param root0.message - The message to sign, can be a string, hex string, or byte array
+     * @returns The signature as a hex string
+     */
+    async signMessage({ message: e }) {
+      let t;
+      if (typeof e == "string")
+        t = (await y({
+          evmAccount: r,
+          message: e
+        })).signature;
+      else if ("raw" in e) {
+        const n = A(e);
+        t = (await i({
+          evmAccount: r,
+          hash: n
+        })).signature;
+      } else
+        throw new Error("Unsupported message format");
+      return t;
+    },
+    /**
+     * Signs a transaction using CDP's transaction signing functionality.
+     * Converts Viem's transaction format to CDP's AllowedEvmTransactionType.
+     *
+     * @param transaction - The transaction to sign in Viem's format
+     * @returns The signature as a hex string
+     */
+    async signTransaction(e) {
+      const t = {
+        to: e.to,
+        value: e.value,
+        data: e.data,
+        nonce: e.nonce,
+        gas: e.gas,
+        chainId: e.chainId ?? 1
+      };
+      return e.gasPrice !== void 0 ? (t.maxFeePerGas = e.gasPrice, t.maxPriorityFeePerGas = e.gasPrice) : (t.maxFeePerGas = e.maxFeePerGas, t.maxPriorityFeePerGas = e.maxPriorityFeePerGas), (await f({
+        evmAccount: r,
+        transaction: t
+      })).signedTransaction;
+    },
+    /**
+     * Signs EIP-712 typed data using CDP's typed data signing functionality.
+     * Handles domain separation and type encoding according to the EIP-712 specification.
+     * For smart accounts, implements replay-safe hash and signature wrapping.
+     *
+     * @param params - The typed data parameters following the EIP-712 specification
+     * @returns The signature as a hex string
+     */
+    async signTypedData(e) {
+      if (a) {
+        const t = await T({
+          smartAccount: r,
+          ownerAddress: o.evmAccountObjects?.[0]?.address,
+          hash: m(e),
+          chainId: Number(e.domain.chainId)
+        });
+        return u({
+          address: w,
+          data: p({
+            abi: E,
+            functionName: "createAccount",
+            args: [[g(o.evmAccountObjects?.[0]?.address)], 0n]
+          }),
+          signature: t.signature
+        });
+      } else {
+        const t = {
+          domain: e.domain,
+          types: {
+            EIP712Domain: d({
+              domain: e.domain
+            }),
+            ...e.types
+          },
+          primaryType: e.primaryType,
+          message: e.message
+        };
+        return (await v({
+          evmAccount: r,
+          typedData: t
+        })).signature;
       }
-  };
-  return window.addEventListener("message", p), {
-    iframe: r,
-    cleanup: E,
-    updateTheme: (a) => {
-      l(r, {
-        type: n.THEME,
-        payload: { theme: a }
-      });
     },
-    showEject: () => {
-      l(r, {
-        type: n.SHOW_EJECT
-      });
+    /**
+     * Signs a raw message hash using CDP's message signing functionality.
+     *
+     * @param message - The message hash to sign
+     * @returns The signature as a hex string
+     */
+    async sign(e) {
+      return (await i({
+        evmAccount: r,
+        hash: e.hash
+      })).signature;
     }
-  };
-}
-async function Q(e) {
-  return u.sendActionCallEvent({ name: "create_evm_key_export_iframe" }), g(), await y(), h({ ...e, type: "evm" });
-}
-async function Z(e) {
-  return u.sendActionCallEvent({ name: "create_solana_key_export_iframe" }), g(), await y(), h({ ...e, type: "solana" });
+  });
 }
 export {
-  Q as createEvmKeyExportIframe,
-  Z as createSolanaKeyExportIframe
+  H as toViemAccount
 };

package/dist/web/index.web99.js

@@ -1,45 +1,91 @@
-import { getTransactionEncoder as m, getTransactionDecoder as u, address as p } from "@solana/kit";
-import { getCurrentUserSync as f } from "./index.web44.js";
-import "@coinbase/cdp-api-client";
-import "./index.web2.js";
-import "./index.web3.js";
-import "jose";
-import "viem";
-import "./index.web103.js";
-import "./index.web97.js";
-import { signSolanaTransaction as g } from "./index.web32.js";
-import "./index.web104.js";
-import "@solana/web3.js";
-import "bs58";
-import { encodeBase64 as l, decodeBase64 as T } from "./index.web101.js";
-function N(o) {
-  const t = f();
-  if (!t || !t.solanaAccountObjects?.length)
-    throw new Error(
-      "No accounts found. User must be authenticated and have at least one Solana account"
-    );
-  const e = m(), a = u();
-  return {
-    address: p(o),
-    signTransactions: async (c, h) => {
-      const n = [];
-      for (const i of c) {
-        const s = new Uint8Array(e.encode(i)), { signedTransaction: d } = await g({
-          solanaAccount: o,
-          transaction: l(s)
-        }), r = a.decode(T(d)).signatures[o];
-        if (!r)
-          throw new Error("Wallet did not return a signature for the selected account.");
-        n.push(
-          Object.freeze({
-            [o]: r
-          })
-        );
-      }
-      return n;
-    }
-  };
+class n extends Error {
+  /**
+   * The name of the missing module.
+   */
+  moduleName;
+  /**
+   * The API or feature that requires the missing module.
+   */
+  requiredFor;
+  /**
+   * Creates a new ModuleResolutionError.
+   *
+   * @param moduleName - The name of the missing module.
+   * @param requiredFor - The API or feature that requires the module.
+   * @param message - Optional custom error message.
+   */
+  constructor(r, e, o) {
+    const t = `${e} is not available in this React Native environment. Please ensure ${r} is installed.`;
+    super(o || t), this.name = "ModuleResolutionError", this.moduleName = r, this.requiredFor = e;
+  }
+}
+class a extends Error {
+  /**
+   * Creates a new InputValidationError.
+   *
+   * @param message - The validation error message.
+   */
+  constructor(r) {
+    super(r), this.name = "InputValidationError";
+  }
+}
+class i extends Error {
+  /**
+   * Creates a new ValidationError.
+   *
+   * @param message - The validation error message.
+   */
+  constructor(r) {
+    super(r), this.name = "ValidationError";
+  }
+}
+class c extends Error {
+  /**
+   * Creates a new InternalError.
+   *
+   * @param message - The internal error message.
+   */
+  constructor(r) {
+    super(r), this.name = "InternalError";
+  }
+}
+class l extends Error {
+  /**
+   * The error code identifying the type of MFA error.
+   */
+  code;
+  /**
+   * Creates a new MfaError.
+   *
+   * @param code - The error code identifying the type of MFA error.
+   * @param message - The error message.
+   * @param options - Additional error options.
+   * @param options.cause - The underlying error this one was mapped from, when there is one.
+   */
+  constructor(r, e, o) {
+    super(e, o), this.name = "MfaError", this.code = r;
+  }
+}
+class u extends Error {
+  /**
+   * The error code identifying the type of swap failure.
+   */
+  code;
+  /**
+   * Creates a new SwapError.
+   *
+   * @param code - The error code identifying the type of swap failure.
+   * @param message - The error message.
+   */
+  constructor(r, e) {
+    super(e), this.name = "SwapError", this.code = r;
+  }
 }
 export {
-  N as toTransactionSigner
+  a as InputValidationError,
+  c as InternalError,
+  l as MfaError,
+  n as ModuleResolutionError,
+  u as SwapError,
+  i as ValidationError
 };

package/dist/web-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/web-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/web-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/web-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;