@coinbase/cdp-core 0.0.122 → 0.0.124

package/dist/native-types/platform/registry.d.ts

@@ -1,4 +1,4 @@
-import { PlatformServices, PlatformCrypto, PlatformStorage, PlatformOAuth, PlatformAttestation } from './types.js';
+import { PlatformAttestation, PlatformCrypto, PlatformOAuth, PlatformServices, PlatformServicesOverride, PlatformStorage } from './types.js';
 /**
  * Registers platform-specific services with the dependency injection container.
  * This should be called once during application initialization, typically by
@@ -17,6 +17,26 @@ import { PlatformServices, PlatformCrypto, PlatformStorage, PlatformOAuth, Platf
  * ```
  */
 export declare function setPlatformServices(services: PlatformServices): void;
+/**
+ * Replaces individual platform services while leaving the rest of the platform
+ * defaults in place.
+ *
+ * Call this once during application startup, after importing `@coinbase/cdp-core`
+ * and before `initialize`. React Native apps use it to supply a storage
+ * implementation when they do not install `@react-native-async-storage/async-storage`.
+ *
+ * Services omitted from `overrides`, or set to `undefined`, keep their current
+ * implementation. Calling this more than once applies each override on top of the
+ * previous state.
+ *
+ * @param overrides - The platform services to replace.
+ * @throws Error if platform services have not been initialized.
+ * @example
+ * ```typescript
+ * configurePlatformServices({ storage: mmkvStorage });
+ * ```
+ */
+export declare function configurePlatformServices(overrides: PlatformServicesOverride): void;
 /**
  * Retrieves the registered platform services.
  * Throws an error if services have not been initialized.

package/dist/native-types/platform/types.d.ts

@@ -130,6 +130,38 @@ export interface PlatformSecureStorage {
      */
     clear(): Promise<void>;
 }
+/**
+ * A storage implementation supplied by an application in place of a platform default.
+ *
+ * Identical to {@link PlatformStorage} except that `getItemWithOutcome` is optional.
+ * When it is omitted, the SDK derives read outcomes from `getItem`, so an adapter
+ * does not have to classify them itself. Read error messages are reported in SDK
+ * telemetry after truncation to 256 characters, whether they come from a thrown
+ * error or a resolved `error` outcome, so adapters must not include stored values
+ * or key material in error text. The built-in web and native adapters pass their
+ * own bounded module-resolution and storage errors through without truncation,
+ * because those messages are SDK-controlled and already bounded.
+ */
+export type PlatformStorageOverride = Omit<PlatformStorage, "getItemWithOutcome"> & Partial<Pick<PlatformStorage, "getItemWithOutcome">>;
+/**
+ * The platform services an application may replace after the SDK has registered
+ * its platform defaults.
+ *
+ * Only the services named here are replaced. Every service left out keeps the
+ * default the SDK registered for the current platform.
+ */
+export interface PlatformServicesOverride {
+    /**
+     * Storage used for the pending OAuth flow ID, the embedded wallet store, and the
+     * refresh-token mirror on platforms without secure storage.
+     */
+    storage?: PlatformStorageOverride;
+    /**
+     * Secure storage used for the refresh token on native platforms. Supplying this
+     * on web makes `initialize` use native refresh-token failure handling.
+     */
+    secureStorage?: PlatformStorageOverride;
+}
 /**
  * Result of reading a value from storage.
  */

package/dist/native-types/version.d.ts

@@ -2,4 +2,4 @@
  * Current version of @coinbase/cdp-core package.
  * This file is auto-generated by scripts/sync-versions.js
  */
-export declare const VERSION = "0.0.122";
+export declare const VERSION = "0.0.124";

package/dist/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/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/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/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/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/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/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/types/auth/authManager.d.ts

@@ -1,5 +1,16 @@
 import { AuthState, IAuthManager, WalletSecret } from './types.js';
 import { OnAuthStateChangeFn, User } from '../types.js';
+/**
+ * Initialization and platform-specific behavior for standard authentication refreshes.
+ */
+export type AuthManagerOptions = {
+    /** Whether to defer the initial session refresh until ensureInitialized is called. */
+    deferInitialization?: boolean;
+    /** Whether automatic non-transient refresh failures should revoke the remote session. */
+    remoteSignOutOnRefreshFailure?: boolean;
+    /** Whether browser Web Locks should serialize refreshes across contexts. */
+    useBrowserRefreshLock?: boolean;
+};
 /**
  * Manages the authentication state and access token for standard CDP authentication
  * (email/SMS/OAuth flows).
@@ -11,13 +22,20 @@ export declare class AuthManager implements IAuthManager {
     protected authStateChangeCallbacks: OnAuthStateChangeFn[];
     protected initPromise: Promise<void> | null;
     protected refreshTimeout: ReturnType<typeof setTimeout> | null;
+    private refreshAccessTokenPromise;
     private refreshWalletSecretPromise;
+    private remoteSignOutOnRefreshFailure;
+    private useBrowserRefreshLock;
     /**
      * Initializes the token manager.
      *
      * @param projectId - The project ID.
+     * @param options - Initialization and platform-specific refresh behavior.
+     * @param options.deferInitialization - Whether to defer the initial session refresh until ensureInitialized is called.
+     * @param options.remoteSignOutOnRefreshFailure - Whether failed refreshes should revoke the remote session.
+     * @param options.useBrowserRefreshLock - Whether browser refreshes should be serialized across contexts.
      */
-    constructor(projectId: string);
+    constructor(projectId: string, options?: AuthManagerOptions);
     /**
      * Gets the current user, or null if there is no user signed in.
      *
@@ -98,7 +116,7 @@ export declare class AuthManager implements IAuthManager {
     clearAuthState(): Promise<void>;
     /**
      * Ensures the AuthManager is initialized before proceeding.
-     * If initialization is already in progress, waits for it to complete.
+     * Starts deferred initialization when necessary, otherwise waits for initialization already in progress.
      */
     ensureInitialized(): Promise<void>;
     /**
@@ -113,15 +131,17 @@ export declare class AuthManager implements IAuthManager {
     protected shouldRefreshToken(): boolean;
     /**
      * Refreshes the access token and transitions the auth state accordingly.
-     * If a refresh is already in progress, it will wait for that refresh to complete.
-     * Retries with exponential backoff on transient failures only. Unauthorized error
-     * short-circuit immediately since retrying won't help.
+     * Concurrent refresh callers in one SDK instance share the same request.
      *
      * @param trigger - The trigger for the refresh.
-     *
-     * @returns The new access token.
      */
     protected refreshAccessToken(trigger?: string): Promise<void>;
+    /**
+     * Performs one serialized refresh cycle.
+     *
+     * @param trigger - The trigger for the refresh.
+     */
+    protected performRefreshAccessToken(trigger: string): Promise<void>;
     /**
      * Schedules a token refresh to occur exactly when shouldRefreshToken() would return true.
      * Uses the same REFRESH_CREDENTIALS_BUFFER_MS timing as the rest of the auth system.

package/dist/types/auth/createAuthManager.d.ts

@@ -1,3 +1,4 @@
+import { AuthManagerOptions } from './authManager.js';
 import { IAuthManager } from './types.js';
 /**
  * Creates the appropriate AuthManager instance based on the configuration.
@@ -6,6 +7,10 @@ import { IAuthManager } from './types.js';
  * - Otherwise, returns an AuthManager for standard CDP authentication
  *
  * @param projectId - The project ID.
+ * @param options - Initialization and platform-specific standard-auth refresh behavior.
+ * @param options.deferInitialization - Whether to defer the initial session refresh until ensureInitialized is called.
+ * @param options.remoteSignOutOnRefreshFailure - Whether failed refreshes should revoke the remote session.
+ * @param options.useBrowserRefreshLock - Whether browser refreshes should be serialized across contexts.
  * @returns The appropriate AuthManager instance.
  */
-export declare function createAuthManager(projectId: string): IAuthManager;
+export declare function createAuthManager(projectId: string, options?: AuthManagerOptions): IAuthManager;

package/dist/types/core.d.ts

@@ -10,6 +10,7 @@ export { verifySiweSignature, type VerifySiweSignatureOptions, type VerifySiweSi
 export { verifyTelegramOAuth } from './actions/verifyTelegramOAuth.js';
 export { authenticateWithJWT } from './actions/authenticateWithJWT.js';
 export { getCurrentUser, type GetCurrentUserOptions } from './actions/getCurrentUser.js';
+export { refreshUser } from './actions/refreshUser.js';
 export { isSignedIn } from './actions/isSignedIn.js';
 export { signOut } from './actions/signOut.js';
 export { getAccessToken } from './actions/getAccessToken.js';

package/dist/types/index.d.ts

@@ -36,6 +36,14 @@ export { sendUsdc, type SendUsdcOptions, type SendUsdcResult, type SendUsdcNetwo
 export { getSwapPrice, type GetSwapPriceOptions, type GetSwapPriceResult, type SwapUnavailableResult, type SwapIssues, } from './actions/getSwapPrice.js';
 export { executeSwap, type ExecuteSwapOptions, type ExecuteSwapResult, type ExecuteEvmEoaSwapResult, type ExecuteEvmSmartSwapResult, } from './actions/executeSwap.js';
 export { EvmSwapsNetwork } from '@coinbase/cdp-api-client';
+export { listEvmBorrowProducts, type ListEvmBorrowProductsOptions, type ListEvmBorrowProductsResult, } from './actions/listEvmBorrowProducts.js';
+export { getEvmBorrowProduct, type GetEvmBorrowProductOptions, type GetEvmBorrowProductResult, } from './actions/getEvmBorrowProduct.js';
+export { createBorrowPosition, type CreateBorrowPositionOptions, type CreateBorrowPositionResult, } from './actions/createBorrowPosition.js';
+export { adjustBorrowPosition, type AdjustBorrowPositionOptions, type AdjustBorrowPositionResult, } from './actions/adjustBorrowPosition.js';
+export { closeBorrowPosition, type CloseBorrowPositionOptions, type CloseBorrowPositionResult, } from './actions/closeBorrowPosition.js';
+export { listBorrowPositions, type ListBorrowPositionsOptions, type ListBorrowPositionsResult, } from './actions/listBorrowPositions.js';
+export { type BorrowPosition, type BorrowPositionAssetAmount, type BorrowPositionDebt, type BorrowPositionHealthStatus, type BorrowPositionOnchainState, type MorphoBlueOnchainState, } from '@coinbase/cdp-api-client';
+export { BorrowProductNetwork, BorrowProductProtocol, type BorrowProduct, type BorrowProductVenue, type BorrowProductToken, type BorrowProductAsset, type BorrowProductAssetCapability, type BorrowProductAssetCapabilityType, type BorrowProductSnapshot, type BorrowProductProtocolDetails, type MorphoBlueProtocolDetails, type MorphoBlueMarketParams, type MorphoBlueProtocolDetailsType, } from '@coinbase/cdp-api-client';
 export { getMfaConfig, type GetMfaConfigResult } from './actions/getMfaConfig.js';
 export { getProjectConfig, type GetProjectConfigResult } from './actions/getProjectConfig.js';
 export { getMfaConfigState, getProjectConfigState } from './state.js';
@@ -61,4 +69,6 @@ export * from './eip1193/types.js';
 export * from './secureIframe/index.js';
 export { createEvmKeyExportIframe, createSolanaKeyExportIframe, type CreateKeyExportIframeOptions, type CreateKeyExportIframeResult, type SecureIframeStatusDetails, } from './actions/createKeyExportIframe.js';
 export { getConfig } from './state.js';
+export { configurePlatformServices } from './platform/registry.js';
+export { type PlatformStorage, type PlatformStorageOverride, type PlatformServicesOverride, type StorageReadResult, } from './platform/types.js';
 export { toTransactionSigner } from './solana-kit/toTransactionSigner.js';

package/dist/types/index.native.d.ts

@@ -40,6 +40,14 @@ export { sendUsdc, type SendUsdcOptions, type SendUsdcResult, type SendUsdcNetwo
 export { getSwapPrice, type GetSwapPriceOptions, type GetSwapPriceResult, type SwapUnavailableResult, type SwapIssues, } from './actions/getSwapPrice.js';
 export { executeSwap, type ExecuteSwapOptions, type ExecuteSwapResult, type ExecuteEvmEoaSwapResult, type ExecuteEvmSmartSwapResult, } from './actions/executeSwap.js';
 export { EvmSwapsNetwork } from '@coinbase/cdp-api-client';
+export { listEvmBorrowProducts, type ListEvmBorrowProductsOptions, type ListEvmBorrowProductsResult, } from './actions/listEvmBorrowProducts.js';
+export { getEvmBorrowProduct, type GetEvmBorrowProductOptions, type GetEvmBorrowProductResult, } from './actions/getEvmBorrowProduct.js';
+export { createBorrowPosition, type CreateBorrowPositionOptions, type CreateBorrowPositionResult, } from './actions/createBorrowPosition.js';
+export { adjustBorrowPosition, type AdjustBorrowPositionOptions, type AdjustBorrowPositionResult, } from './actions/adjustBorrowPosition.js';
+export { closeBorrowPosition, type CloseBorrowPositionOptions, type CloseBorrowPositionResult, } from './actions/closeBorrowPosition.js';
+export { listBorrowPositions, type ListBorrowPositionsOptions, type ListBorrowPositionsResult, } from './actions/listBorrowPositions.js';
+export { type BorrowPosition, type BorrowPositionAssetAmount, type BorrowPositionDebt, type BorrowPositionHealthStatus, type BorrowPositionOnchainState, type MorphoBlueOnchainState, } from '@coinbase/cdp-api-client';
+export { BorrowProductNetwork, BorrowProductProtocol, type BorrowProduct, type BorrowProductVenue, type BorrowProductToken, type BorrowProductAsset, type BorrowProductAssetCapability, type BorrowProductAssetCapabilityType, type BorrowProductSnapshot, type BorrowProductProtocolDetails, type MorphoBlueProtocolDetails, type MorphoBlueMarketParams, type MorphoBlueProtocolDetailsType, } from '@coinbase/cdp-api-client';
 export { getMfaConfig, type GetMfaConfigResult } from './actions/getMfaConfig.js';
 export { getProjectConfig, type GetProjectConfigResult } from './actions/getProjectConfig.js';
 export { getMfaConfigState, getProjectConfigState } from './state.js';
@@ -66,4 +74,5 @@ export { toTransactionSigner } from './solana-kit/toTransactionSigner.js';
 export { registerAttestationModule, type NativeAttestationModule, } from './platform/native/attestationRegistry.js';
 export { registerAppleAuthProvider, type AppleAuthProvider, } from './platform/native/appleAuthRegistry.js';
 export { registerDeviceInfoModule, type NativeDeviceInfoModule, } from './platform/native/deviceInfoRegistry.js';
-export { type AppleNativeCredential } from './platform/types.js';
+export { configurePlatformServices } from './platform/registry.js';
+export { type AppleNativeCredential, type PlatformStorage, type PlatformStorageOverride, type PlatformServicesOverride, type StorageReadResult, } from './platform/types.js';

package/dist/types/index.web.d.ts

@@ -40,6 +40,14 @@ export { sendUsdc, type SendUsdcOptions, type SendUsdcResult, type SendUsdcNetwo
 export { getSwapPrice, type GetSwapPriceOptions, type GetSwapPriceResult, type SwapUnavailableResult, type SwapIssues, } from './actions/getSwapPrice.js';
 export { executeSwap, type ExecuteSwapOptions, type ExecuteSwapResult, type ExecuteEvmEoaSwapResult, type ExecuteEvmSmartSwapResult, } from './actions/executeSwap.js';
 export { EvmSwapsNetwork } from '@coinbase/cdp-api-client';
+export { listEvmBorrowProducts, type ListEvmBorrowProductsOptions, type ListEvmBorrowProductsResult, } from './actions/listEvmBorrowProducts.js';
+export { getEvmBorrowProduct, type GetEvmBorrowProductOptions, type GetEvmBorrowProductResult, } from './actions/getEvmBorrowProduct.js';
+export { createBorrowPosition, type CreateBorrowPositionOptions, type CreateBorrowPositionResult, } from './actions/createBorrowPosition.js';
+export { adjustBorrowPosition, type AdjustBorrowPositionOptions, type AdjustBorrowPositionResult, } from './actions/adjustBorrowPosition.js';
+export { closeBorrowPosition, type CloseBorrowPositionOptions, type CloseBorrowPositionResult, } from './actions/closeBorrowPosition.js';
+export { listBorrowPositions, type ListBorrowPositionsOptions, type ListBorrowPositionsResult, } from './actions/listBorrowPositions.js';
+export { type BorrowPosition, type BorrowPositionAssetAmount, type BorrowPositionDebt, type BorrowPositionHealthStatus, type BorrowPositionOnchainState, type MorphoBlueOnchainState, } from '@coinbase/cdp-api-client';
+export { BorrowProductNetwork, BorrowProductProtocol, type BorrowProduct, type BorrowProductVenue, type BorrowProductToken, type BorrowProductAsset, type BorrowProductAssetCapability, type BorrowProductAssetCapabilityType, type BorrowProductSnapshot, type BorrowProductProtocolDetails, type MorphoBlueProtocolDetails, type MorphoBlueMarketParams, type MorphoBlueProtocolDetailsType, } from '@coinbase/cdp-api-client';
 export { getMfaConfig, type GetMfaConfigResult } from './actions/getMfaConfig.js';
 export { getProjectConfig, type GetProjectConfigResult } from './actions/getProjectConfig.js';
 export { getMfaConfigState, getProjectConfigState } from './state.js';
@@ -69,5 +77,7 @@ export * from './eip1193/types.js';
 export * from './secureIframe/index.js';
 export { createEvmKeyExportIframe, createSolanaKeyExportIframe, type CreateKeyExportIframeOptions, type CreateKeyExportIframeResult, type SecureIframeStatusDetails, } from './actions/createKeyExportIframe.js';
 export { getConfig } from './state.js';
+export { configurePlatformServices } from './platform/registry.js';
+export { type PlatformStorage, type PlatformStorageOverride, type PlatformServicesOverride, type StorageReadResult, } from './platform/types.js';
 export { toTransactionSigner } from './solana-kit/toTransactionSigner.js';
 export { isPasskeySupported } from './shared/webauthn.js';

package/dist/types/mocks/borrowProduct.d.ts

@@ -0,0 +1,25 @@
+import { BorrowProduct } from '@coinbase/cdp-api-client';
+/** A stable borrow product ID used across the borrow-product action tests. */
+export declare const mockBorrowProductId = "bp_07fb56c0-9afe-5440-8ff2-5b0e115458df";
+/**
+ * A representative Morpho Blue borrow product (cbBTC / USDC on Base) for use in
+ * core action tests. Mirrors the shape returned by the api-client.
+ */
+export declare const mockBorrowProduct: BorrowProduct;
+/**
+ * Builds a borrow product for tests, applying overrides on top of
+ * {@link mockBorrowProduct}. Useful when a test needs a second, distinct
+ * product (e.g. to assert a key change clears stale data).
+ *
+ * @param overrides - The fields to override on the base mock product.
+ * @returns A borrow product with the overrides applied.
+ *
+ * @example
+ * ```typescript
+ * const other = createBorrowProduct({
+ *   borrowProductId: "bp_other",
+ *   name: "WETH / USDC",
+ * });
+ * ```
+ */
+export declare function createBorrowProduct(overrides?: Partial<BorrowProduct>): BorrowProduct;

package/dist/types/platform/native/loadOptionalModule.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Converts a module-resolution error from an optional native import into an
+ * installation error naming the package and its `configurePlatformServices`
+ * override. Returns non-resolution errors unchanged.
+ *
+ * Call this from a `catch` wrapping a literal dynamic `import()`. Metro's
+ * optional-dependency detection only recognizes an `import()` that appears
+ * directly inside the `try`, so the import cannot be hidden behind a helper.
+ *
+ * @param error - The error caught from the dynamic import.
+ * @param packageName - The optional package name.
+ * @param overrideHint - The platform service that can replace the optional package.
+ * @returns An installation error for module-resolution failures, or the original error.
+ */
+export declare const toOptionalNativeModuleError: (error: unknown, packageName: string, overrideHint: string) => unknown;

package/dist/types/platform/native/storage.d.ts

@@ -4,6 +4,7 @@ import { PlatformStorage } from '../types.js';
  * Uses AsyncStorage for persistent storage.
  *
  * Note: This implementation requires @react-native-async-storage/async-storage
- * to be installed as a peer dependency.
+ * to be installed as a peer dependency. Apps that use a different store supply
+ * their own implementation with `configurePlatformServices({ storage })` instead.
  */
 export declare const nativeStorage: PlatformStorage;

package/dist/types/platform/registry.d.ts

@@ -1,4 +1,4 @@
-import { PlatformServices, PlatformCrypto, PlatformStorage, PlatformOAuth, PlatformAttestation } from './types.js';
+import { PlatformAttestation, PlatformCrypto, PlatformOAuth, PlatformServices, PlatformServicesOverride, PlatformStorage } from './types.js';
 /**
  * Registers platform-specific services with the dependency injection container.
  * This should be called once during application initialization, typically by
@@ -17,6 +17,26 @@ import { PlatformServices, PlatformCrypto, PlatformStorage, PlatformOAuth, Platf
  * ```
  */
 export declare function setPlatformServices(services: PlatformServices): void;
+/**
+ * Replaces individual platform services while leaving the rest of the platform
+ * defaults in place.
+ *
+ * Call this once during application startup, after importing `@coinbase/cdp-core`
+ * and before `initialize`. React Native apps use it to supply a storage
+ * implementation when they do not install `@react-native-async-storage/async-storage`.
+ *
+ * Services omitted from `overrides`, or set to `undefined`, keep their current
+ * implementation. Calling this more than once applies each override on top of the
+ * previous state.
+ *
+ * @param overrides - The platform services to replace.
+ * @throws Error if platform services have not been initialized.
+ * @example
+ * ```typescript
+ * configurePlatformServices({ storage: mmkvStorage });
+ * ```
+ */
+export declare function configurePlatformServices(overrides: PlatformServicesOverride): void;
 /**
  * Retrieves the registered platform services.
  * Throws an error if services have not been initialized.