@dynamic-labs-sdk/client 1.24.1 → 1.26.0

package/dist/index.esm.js

@@ -1,11 +1,11 @@
-import { $ as UnauthorizedError, A as isSignedIn, B as retryOnFail, C as getWalletProviderFromWalletAccount, Ct as version, D as NoWalletProviderFoundError, F as CHAINS_INFO_MAP, G as createApiClient, H as offEvent, I as formatWalletAccountId, L as normalizeAddress, O as generateSessionKeys, P as getChainFromVerifiedCredentialChain, Q as createStorageKeySchema, R as splitWalletProviderKey, S as extractSessionId, St as name, T as getWalletProviderRegistry, U as onEvent, V as emitEvent, W as onceEvent, X as fetchAndStoreNonces, Y as getNonce, Z as updateNoncePoolStorage, _ as instrumentFunction, _t as getDefaultClient, a as initializeWaasClientsForEagerRecovery, at as APIError, b as getUserAgent, bt as BaseError, ct as SDK_API_CORE_VERSION, dt as assertDefined, et as SandboxMaximumThresholdReachedError, f as getWalletProviders, ft as ValueMustBeDefinedError, g as __logoutWithReason_wrapped, gt as NONCE_POOL_SIZE, ht as getPlatform, i as InvalidParamError, it as InvalidExternalAuthError, j as getWalletAccounts, k as fetchProjectSettings, m as checkAndRaiseWalletAccountsChangedEvent, mt as randomString, n as upsertElevatedAccessToken, nt as MfaInvalidOtpError, p as isUserMissingMfaAuth, pt as getElevatedAccessToken, r as parseElevatedAccessToken, rt as LinkCredentialError, st as DYNAMIC_ICONIC_SPRITE_URL, t as updateAuthFromVerifyResponse, tt as MfaRateLimitedError, ut as isCookieEnabled, v as scrubParameters, vt as setDefaultClient, w as WalletProviderPriority, x as getOperatingSystem, xt as getCore, y as DEFAULT_PII_FIELDS } from "./updateAuthFromVerifyResponse-C_yGmd99.esm.js";
-import { A as createCrossTabBroadcast, B as subscribeWithSelector, C as getKeychainIndexedDBName, D as assertSafeNavigationUrl, E as createKeychainService, F as GENERATE_SESSION_KEYS_TRACKER_KEY, G as isServerSideRendering, H as createStorage, I as INITIALIZE_STORAGE_SYNC_TRACKER_KEY, K as UnavailableInServerSideError, L as REFRESH_USER_STATE_FROM_COOKIE_TRACKER_KEY, M as CannotTrackError, N as createDeferredPromise, P as FETCH_PROJECT_SETTINGS_TRACKER_KEY, R as REFRESH_USER_STATE_FROM_VALID_TOKEN_TRACKER_KEY, S as MergeAccountsConfirmationError, T as assertSafeDeeplinkUrl, V as isEqualShallow, W as createLocalStorageAdapter, _ as consumeCaptchaToken, a as verifyMessageSignatureOwnership, b as WalletAlreadyLinkedToAnotherUserError, c as formatSignInMessage, d as updateWalletProviderKeysForVerifiedCredentials, f as setUnverifiedWalletAccounts, g as MethodNotImplementedError, h as __setCaptchaToken_wrapped, i as getNetworksData, k as createLogger, l as getAppMetadata, m as hasExtension, o as removeUnverifiedWalletAccount, p as createVisit, s as createSignInMessageStatement, t as getNetworkProviderFromNetworkId, u as reconcileWalletAccountsAgainstClient, v as isCaptchaRequired, w as createRealtimeService, x as NoNetworkProvidersError, y as WalletScreeningBlockedError, z as getBuffer } from "./getNetworkProviderFromNetworkId-CYONf9-8.esm.js";
-import { n as NotWaasWalletAccountError, r as __refreshAuth_wrapped } from "./isDynamicWaasEnabled-BbhbghRE.esm.js";
-import { a as WaasOnboardingIncompleteError, i as preconnectWaasIframe, n as isPendingRecoveryCodesAcknowledgment, o as WaasLoadFailedError, r as isDeviceRegistrationRequired, t as isUserOnboardingComplete } from "./isUserOnboardingComplete-WzXFgdor.esm.js";
-import { n as getVerifiedCredentialForWalletAccount, t as getWalletProviderByKey } from "./getWalletProviderByKey-Dh3JbMi6.esm.js";
-import { n as getMfaMethods, r as __consumeMfaToken_wrapped, t as isMfaRequiredForAction } from "./isMfaRequiredForAction-DBlmv1ew.esm.js";
+import { $ as UnauthorizedError, A as isSignedIn, B as retryOnFail, C as getWalletProviderFromWalletAccount, Ct as version, D as NoWalletProviderFoundError, F as CHAINS_INFO_MAP, G as createApiClient, H as offEvent, I as formatWalletAccountId, L as normalizeAddress, O as generateSessionKeys, P as getChainFromVerifiedCredentialChain, Q as createStorageKeySchema, R as splitWalletProviderKey, S as extractSessionId, St as name, T as getWalletProviderRegistry, U as onEvent, V as emitEvent, W as onceEvent, X as fetchAndStoreNonces, Y as getNonce, Z as updateNoncePoolStorage, _ as instrumentFunction, _t as getDefaultClient, a as initializeWaasClientsForEagerRecovery, at as APIError, b as getUserAgent, bt as BaseError, ct as SDK_API_CORE_VERSION, dt as assertDefined, et as SandboxMaximumThresholdReachedError, f as getWalletProviders, ft as ValueMustBeDefinedError, g as __logoutWithReason_wrapped, gt as NONCE_POOL_SIZE, ht as getPlatform, i as InvalidParamError, it as InvalidExternalAuthError, j as getWalletAccounts, k as fetchProjectSettings, m as checkAndRaiseWalletAccountsChangedEvent, mt as randomString, n as upsertElevatedAccessToken, nt as MfaInvalidOtpError, p as isUserMissingMfaAuth, pt as getElevatedAccessToken, r as parseElevatedAccessToken, rt as LinkCredentialError, st as DYNAMIC_ICONIC_SPRITE_URL, t as updateAuthFromVerifyResponse, tt as MfaRateLimitedError, ut as isCookieEnabled, v as scrubParameters, vt as setDefaultClient, w as WalletProviderPriority, x as getOperatingSystem, xt as getCore, y as DEFAULT_PII_FIELDS } from "./updateAuthFromVerifyResponse-CfqviWkz.esm.js";
+import { A as createCrossTabBroadcast, B as getBuffer, C as getKeychainIndexedDBName, D as assertSafeNavigationUrl, E as createKeychainService, F as FETCH_PROJECT_SETTINGS_TRACKER_KEY, G as createLocalStorageAdapter, H as isEqualShallow, I as GENERATE_SESSION_KEYS_TRACKER_KEY, K as isServerSideRendering, L as INITIALIZE_STORAGE_SYNC_TRACKER_KEY, M as CannotTrackError, N as createDeferredPromise, P as createAppForegroundSubscriber, R as REFRESH_USER_STATE_FROM_COOKIE_TRACKER_KEY, S as MergeAccountsConfirmationError, T as assertSafeDeeplinkUrl, U as createStorage, V as subscribeWithSelector, _ as consumeCaptchaToken, a as verifyMessageSignatureOwnership, b as WalletAlreadyLinkedToAnotherUserError, c as formatSignInMessage, d as updateWalletProviderKeysForVerifiedCredentials, f as setUnverifiedWalletAccounts, g as MethodNotImplementedError, h as __setCaptchaToken_wrapped, i as getNetworksData, k as createLogger, l as getAppMetadata, m as hasExtension, o as removeUnverifiedWalletAccount, p as createVisit, q as UnavailableInServerSideError, s as createSignInMessageStatement, t as getNetworkProviderFromNetworkId, u as reconcileWalletAccountsAgainstClient, v as isCaptchaRequired, w as createRealtimeService, x as NoNetworkProvidersError, y as WalletScreeningBlockedError, z as REFRESH_USER_STATE_FROM_VALID_TOKEN_TRACKER_KEY } from "./getNetworkProviderFromNetworkId-D7lIOS6I.esm.js";
+import { i as __refreshAuth_wrapped, n as TransactionBroadcastError, r as NotWaasWalletAccountError } from "./isDynamicWaasEnabled-CBvSRUgG.esm.js";
+import { a as WaasOnboardingIncompleteError, i as preconnectWaasIframe, n as isPendingRecoveryCodesAcknowledgment, o as WaasLoadFailedError, r as isDeviceRegistrationRequired, t as isUserOnboardingComplete } from "./isUserOnboardingComplete-k3nlisFA.esm.js";
+import { n as getVerifiedCredentialForWalletAccount, t as getWalletProviderByKey } from "./getWalletProviderByKey-CU8zmrf2.esm.js";
+import { n as getMfaMethods, r as __consumeMfaToken_wrapped, t as isMfaRequiredForAction } from "./isMfaRequiredForAction-D1rhRlDu.esm.js";
 import { assertPackageVersion } from "@dynamic-labs-sdk/assert-package-version";
-import { AuthModeEnum, CaptchaProviderEnum as CaptchaProviderEnum$1, ExchangeKeyEnum, JwtVerifiedCredentialFormatEnum, JwtVerifiedCredentialFormatEnum as JwtVerifiedCredentialFormatEnum$1, MFAAction, MfaBackupCodeAcknowledgement, ProviderEnum, ProviderEnum as ProviderEnum$1, TokenScope, TokenScope as TokenScope$1, WaasBackupOptionsEnum, WalletProviderEnum } from "@dynamic-labs/sdk-api-core";
+import { AuthModeEnum, CaptchaProviderEnum as CaptchaProviderEnum$1, ChainEnum, ExchangeKeyEnum, JwtVerifiedCredentialFormatEnum, JwtVerifiedCredentialFormatEnum as JwtVerifiedCredentialFormatEnum$1, MFAAction, MfaBackupCodeAcknowledgement, ProviderEnum, ProviderEnum as ProviderEnum$1, TokenScope, TokenScope as TokenScope$1, WaasBackupOptionsEnum, WalletProviderEnum } from "@dynamic-labs/sdk-api-core";
 import * as z from "zod/mini";
 import EventEmitter, { EventEmitter as EventEmitter$1 } from "eventemitter3";
 import { browserSupportsWebAuthn, startAuthentication, startRegistration } from "@simplewebauthn/browser";
@@ -976,6 +976,7 @@ const createCore = (config) => {
 	});
 	const fetch = config.coreConfig?.fetch ?? createWebFetch();
 	const openDeeplink = config.coreConfig?.openDeeplink ?? createDeeplinkOpener();
+	const subscribeToAppForeground = createAppForegroundSubscriber();
 	const openAuthSession = config.coreConfig?.openAuthSession;
 	const navigate = config.coreConfig?.navigate ?? createNavigationHandler();
 	const state = createObservableState(getInitialState);
@@ -1031,6 +1032,7 @@ const createCore = (config) => {
 		sdkSessionId,
 		state,
 		storage,
+		subscribeToAppForeground,
 		transformers: config.transformers,
 		version,
 		waas: config.waas
@@ -1156,6 +1158,150 @@ var CheckoutSessionTokenMissingError = class extends BaseError {
 	}
 };
 
+//#endregion
+//#region src/errors/CoinbaseTransferMfaFailedError.ts
+/**
+* Thrown when a {@link createCoinbaseExchangeTransfer} retry supplies an
+* `mfaCode` that Coinbase rejects -- the two-step verification code was
+* incorrect, or it expired before the retry was submitted. Coinbase's own
+* codes are short-lived, so this is expected to happen occasionally even
+* with correct user input; it does not mean the transfer itself is invalid.
+*
+* Coinbase does not automatically send a new code on this failure -- prompt
+* the user again and retry, which triggers
+* {@link CoinbaseTransferMfaRequiredError} again and, with it, a fresh code.
+*
+* @example
+* ```ts
+* const transferParams = { accountId, amount: 0.5, currency: 'USDC', to };
+* const submitWithMfaCode = (mfaCode: string) =>
+*   createCoinbaseExchangeTransfer({ ...transferParams, mfaCode });
+*
+* try {
+*   await submitWithMfaCode(mfaCode);
+* } catch (error) {
+*   if (error instanceof CoinbaseTransferMfaFailedError) {
+*     // wrong or expired code -- ask the user to try again
+*     await createCoinbaseExchangeTransfer(transferParams);
+*   }
+* }
+* ```
+* @see createCoinbaseExchangeTransfer
+* @see CoinbaseTransferMfaRequiredError
+*/
+var CoinbaseTransferMfaFailedError = class extends BaseError {
+	constructor({ cause }) {
+		super({
+			cause,
+			code: "transfer_mfa_failed",
+			docsUrl: null,
+			name: "CoinbaseTransferMfaFailedError",
+			shortMessage: "The Coinbase two-step verification code was incorrect or has expired. Retry createCoinbaseExchangeTransfer with a fresh 'mfaCode'."
+		});
+	}
+};
+
+//#endregion
+//#region src/errors/CoinbaseTransferMfaRequiredError.ts
+/**
+* Thrown when Coinbase rejects a {@link createCoinbaseExchangeTransfer} call
+* because the account holder's two-step verification ("2FA") is required to
+* authorize the transfer. This is unrelated to Dynamic's own step-up auth
+* (see {@link checkStepUpAuth}) -- it is a security requirement enforced by
+* Coinbase itself, on the Coinbase account being transferred from.
+*
+* The first `createCoinbaseExchangeTransfer` call for a transfer
+* automatically triggers Coinbase to send the account holder a verification
+* code (SMS, or push to an authenticator app such as Authy if one is
+* linked). Retry the *same* transfer with `mfaCode` set to that code before
+* it expires. If the code is wrong or has expired, the retry throws
+* {@link CoinbaseTransferMfaFailedError} instead, so a fresh code can be
+* requested and retried again.
+*
+* @example
+* ```ts
+* const transferParams = { accountId, amount: 0.5, currency: 'USDC', to };
+*
+* try {
+*   await createCoinbaseExchangeTransfer(transferParams);
+* } catch (error) {
+*   if (error instanceof CoinbaseTransferMfaRequiredError) {
+*     // Coinbase already sent a code to the account holder -- prompt for it
+*     const mfaCode = await promptUserForCoinbase2faCode();
+*     await createCoinbaseExchangeTransfer({ ...transferParams, mfaCode });
+*   }
+* }
+* ```
+* @see createCoinbaseExchangeTransfer
+* @see CoinbaseTransferMfaFailedError
+*/
+var CoinbaseTransferMfaRequiredError = class extends BaseError {
+	constructor({ cause }) {
+		super({
+			cause,
+			code: "transfer_mfa_required",
+			docsUrl: null,
+			name: "CoinbaseTransferMfaRequiredError",
+			shortMessage: "Coinbase requires a two-step verification code to complete this transfer. Coinbase has automatically sent the code to the account holder (SMS or authenticator app) -- retry createCoinbaseExchangeTransfer with 'mfaCode' set to that code before it expires."
+		});
+	}
+};
+
+//#endregion
+//#region src/errors/CoinbaseTravelRuleRequiredError.ts
+/**
+* Thrown when Coinbase rejects a {@link createCoinbaseExchangeTransfer} call
+* because it's missing "Travel Rule" information about the transfer's
+* recipient. The Travel Rule is a regulatory requirement on custodial
+* exchanges (like Coinbase) to collect basic counterparty information above
+* certain transfer thresholds -- which fields are required depends on the
+* sender's and recipient's jurisdictions and the transfer amount, so it can't
+* be predicted client-side; Coinbase reports the exact missing fields on
+* {@link missingFields}.
+*
+* Unlike {@link CoinbaseTransferMfaRequiredError}, retrying does not require
+* waiting for anything from Coinbase -- collect the listed fields (each has a
+* user-facing `description`) and retry the same transfer with
+* `travelRuleData` set.
+*
+* @example
+* ```ts
+* const transferParams = { accountId, amount: 0.5, currency: 'USDC', to };
+*
+* try {
+*   await createCoinbaseExchangeTransfer(transferParams);
+* } catch (error) {
+*   if (error instanceof CoinbaseTravelRuleRequiredError) {
+*     // e.g. [{ name: 'BENEFICIARY_NAME', description: "The recipient's full legal name." }, ...]
+*     console.log(error.missingFields);
+*
+*     const travelRuleData = await promptUserForTravelRuleFields(
+*       error.missingFields
+*     );
+*     await createCoinbaseExchangeTransfer({ ...transferParams, travelRuleData });
+*   }
+* }
+* ```
+* @see createCoinbaseExchangeTransfer
+* @see CoinbaseTravelRuleData
+* @see CoinbaseTravelRuleFieldName
+* @see https://docs.cdp.coinbase.com/coinbase-app/transfer-apis/travel-rule
+*/
+var CoinbaseTravelRuleRequiredError = class extends BaseError {
+	missingFields;
+	constructor({ cause, missingFields }) {
+		super({
+			cause,
+			code: "coinbase_travel_rule_required",
+			docsUrl: "https://docs.cdp.coinbase.com/coinbase-app/transfer-apis/travel-rule",
+			metaMessages: missingFields.map(({ name: name$1, description }) => `- ${name$1}: ${description}`),
+			name: "CoinbaseTravelRuleRequiredError",
+			shortMessage: "Coinbase requires additional recipient information (Travel Rule compliance) before this transfer can complete."
+		});
+		this.missingFields = missingFields;
+	}
+};
+
 //#endregion
 //#region src/errors/DeeplinkConnectAndVerifyUnsupportedError.ts
 var DeeplinkConnectAndVerifyUnsupportedError = class extends BaseError {
@@ -3968,6 +4114,196 @@ const addCoinbaseOnrampOrderEventListener = ({ listener }, client = getDefaultCl
 	};
 };
 
+//#endregion
+//#region src/modules/funding/coinbase/coinbase.consts.ts
+/**
+* Whether the transfer's destination wallet is self-hosted (controlled
+* directly by its owner, with no custodial exchange in between) or held at
+* another exchange -- required by some jurisdictions' Travel Rule rules, see
+* {@link CoinbaseTravelRuleData}.
+*
+* @example
+* ```typescript
+* const walletType = CoinbaseBeneficiaryWalletType.SelfHosted;
+* ```
+* @see CoinbaseTravelRuleData
+* @see https://docs.cdp.coinbase.com/coinbase-app/transfer-apis/travel-rule
+*/
+const CoinbaseBeneficiaryWalletType = {
+	Exchange: "WALLET_TYPE_EXCHANGE",
+	SelfHosted: "WALLET_TYPE_SELF_HOSTED"
+};
+/**
+* Whether the transfer's destination wallet also belongs to the sender --
+* required by some jurisdictions' Travel Rule rules, see
+* {@link CoinbaseTravelRuleData}.
+*
+* @example
+* ```typescript
+* const isSelfTransfer = CoinbaseIsSelfTransfer.SelfOwned;
+* ```
+* @see CoinbaseTravelRuleData
+* @see https://docs.cdp.coinbase.com/coinbase-app/transfer-apis/travel-rule
+*/
+const CoinbaseIsSelfTransfer = {
+	NotSelfOwned: "IS_SELF_FALSE",
+	SelfOwned: "IS_SELF_TRUE"
+};
+/**
+* The individual Travel Rule fields Coinbase can require on a transfer.
+* Which of these are actually required depends on the sender's and
+* recipient's jurisdictions and the transfer amount -- Coinbase reports the
+* exact list that's missing for a given transfer via
+* {@link CoinbaseTravelRuleRequiredError.missingFields}.
+*
+* @example
+* ```typescript
+* const fieldName = CoinbaseTravelRuleFieldName.BeneficiaryName;
+* ```
+* @see CoinbaseTravelRuleRequiredError
+* @see https://docs.cdp.coinbase.com/coinbase-app/transfer-apis/travel-rule
+*/
+const CoinbaseTravelRuleFieldName = {
+	BeneficiaryAddress: "BENEFICIARY_ADDRESS",
+	BeneficiaryCountry: "BENEFICIARY_COUNTRY",
+	BeneficiaryFinancialInstitution: "BENEFICIARY_FINANCIAL_INSTITUTION",
+	BeneficiaryName: "BENEFICIARY_NAME",
+	BeneficiaryWalletType: "BENEFICIARY_WALLET_TYPE",
+	IsSelf: "IS_SELF",
+	TransferPurpose: "TRANSFER_PURPOSE"
+};
+/**
+* Human-readable description of a {@link CoinbaseTravelRuleFieldName},
+* written to be shown directly to an end user (for example, as helper text
+* next to the form field that collects it).
+*
+* @example
+* ```typescript
+* const description = COINBASE_TRAVEL_RULE_FIELD_DESCRIPTIONS.IS_SELF;
+* // "Whether the destination wallet also belongs to you."
+* ```
+* @see CoinbaseTravelRuleFieldName
+* @see CoinbaseTravelRuleRequiredError
+*/
+const COINBASE_TRAVEL_RULE_FIELD_DESCRIPTIONS = {
+	BENEFICIARY_ADDRESS: "The recipient's postal address.",
+	BENEFICIARY_COUNTRY: "The recipient's country, as an ISO 3166-1 alpha-2 code (e.g. \"US\", \"GB\").",
+	BENEFICIARY_FINANCIAL_INSTITUTION: "The identifier (VASP ID) of the recipient exchange, required when the destination wallet is held at another exchange rather than self-hosted.",
+	BENEFICIARY_NAME: "The recipient's full legal name.",
+	BENEFICIARY_WALLET_TYPE: "Whether the destination wallet is self-hosted (the recipient controls it directly) or held at another exchange.",
+	IS_SELF: "Whether the destination wallet also belongs to you.",
+	TRANSFER_PURPOSE: "The reason for this transfer (e.g. \"Rent\", \"Gift\")."
+};
+
+//#endregion
+//#region src/modules/funding/coinbase/utils/parseCoinbaseTravelRuleMissingFields/parseCoinbaseTravelRuleMissingFields.ts
+/**
+* Coinbase reports missing Travel Rule fields as a bracketed, comma-separated
+* list appended to its error message, e.g. `"... Param:
+* [BENEFICIARY_WALLET_TYPE, BENEFICIARY_NAME]"`.
+*/
+const TRAVEL_RULE_PARAM_LIST_REGEX = /Param:\s*\[([^\]]+)\]/;
+const isCoinbaseTravelRuleFieldName = (name$1) => Object.hasOwn(COINBASE_TRAVEL_RULE_FIELD_DESCRIPTIONS, name$1);
+/**
+* Extracts the list of missing Travel Rule fields from a Coinbase
+* `unknown_transfer_error` message, pairing each field with its user-facing
+* description. Returns an empty array if the message doesn't contain a
+* recognizable Travel Rule field list (i.e. this isn't a Travel Rule error).
+*
+* @param params.message - The raw `error` string from Coinbase's response body.
+* @returns The missing fields, or an empty array if none were found.
+* @example
+* ```typescript
+* const missingFields = parseCoinbaseTravelRuleMissingFields({
+*   message: 'Incomplete travel rules information provided. Param: [BENEFICIARY_NAME, IS_SELF]',
+* });
+* // [
+* //   { name: 'BENEFICIARY_NAME', description: "The recipient's full legal name." },
+* //   { name: 'IS_SELF', description: 'Whether the destination wallet also belongs to you.' },
+* // ]
+* ```
+* @see CoinbaseTravelRuleRequiredError
+* @notInstrumented
+*/
+const parseCoinbaseTravelRuleMissingFields = ({ message }) => {
+	const match = TRAVEL_RULE_PARAM_LIST_REGEX.exec(message);
+	if (!match) return [];
+	return match[1].split(",").map((name$1) => name$1.trim()).filter(isCoinbaseTravelRuleFieldName).map((name$1) => ({
+		description: COINBASE_TRAVEL_RULE_FIELD_DESCRIPTIONS[name$1],
+		name: name$1
+	}));
+};
+
+//#endregion
+//#region src/modules/funding/coinbase/createCoinbaseExchangeTransfer/createCoinbaseExchangeTransfer.ts
+/**
+* Creates a Coinbase exchange transfer to send crypto from a Coinbase account to an external address.
+*
+* Coinbase may reject the transfer for reasons that require a second attempt
+* rather than a hard failure:
+* - {@link CoinbaseTransferMfaRequiredError} / {@link CoinbaseTransferMfaFailedError} --
+*   Coinbase's own two-step verification on the sending account.
+* - {@link CoinbaseTravelRuleRequiredError} -- missing recipient information
+*   required by regulation for this transfer's jurisdictions/amount.
+*
+* @param transferParams - The parameters for the transfer including accountId.
+* @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
+* @returns A promise resolving to the created exchange transfer.
+* @throws {CoinbaseTransferMfaRequiredError} When the API requires MFA for the transfer.
+* @throws {CoinbaseTransferMfaFailedError} When the provided MFA code is rejected.
+* @throws {CoinbaseTravelRuleRequiredError} When Coinbase requires additional recipient information for the transfer.
+* @throws {APIError} For any other API error returned by the exchange transfer request.
+* @example
+* ```typescript
+* // Include any known recipient info upfront -- see travelRuleData below for why.
+* const transferParams = {
+*   accountId: accounts[0].id,
+*   amount: 0.5,
+*   currency: 'USDC',
+*   to: '0x71C7656EC7ab88b098defB751B7401B5f6d8976F',
+*   travelRuleData: { beneficiaryName: 'Jane Doe', beneficiaryCountry: 'US' },
+* };
+*
+* try {
+*   const transfer = await createCoinbaseExchangeTransfer(transferParams);
+* } catch (error) {
+*   if (error instanceof CoinbaseTravelRuleRequiredError) {
+*     const travelRuleData = await promptUserForTravelRuleFields(error.missingFields);
+*     await createCoinbaseExchangeTransfer({ ...transferParams, travelRuleData });
+*   }
+* }
+* ```
+* @see getCoinbaseAccounts
+* @see CoinbaseTransferMfaRequiredError
+* @see CoinbaseTravelRuleRequiredError
+* @notInstrumented
+*/
+const createCoinbaseExchangeTransfer = async (transferParams, client = getDefaultClient()) => {
+	const core = getCore(client);
+	const apiClient = createApiClient({ includeMfaToken: true }, client);
+	const { accountId, ...createExchangeTransferRequest } = transferParams;
+	try {
+		return await apiClient.postExchangeAccountTransfer({
+			accountId,
+			createExchangeTransferRequest,
+			environmentId: core.environmentId,
+			exchangeKey: ExchangeKeyEnum.Coinbase
+		});
+	} catch (error) {
+		if (!(error instanceof APIError)) throw error;
+		if (error.code === "transfer_mfa_required") throw new CoinbaseTransferMfaRequiredError({ cause: error });
+		if (error.code === "transfer_mfa_failed") throw new CoinbaseTransferMfaFailedError({ cause: error });
+		if (error.code === "unknown_transfer_error") {
+			const missingFields = parseCoinbaseTravelRuleMissingFields({ message: error.message });
+			if (missingFields.length > 0) throw new CoinbaseTravelRuleRequiredError({
+				cause: error,
+				missingFields
+			});
+		}
+		throw error;
+	}
+};
+
 //#endregion
 //#region src/modules/funding/coinbase/getMissingVerificationForCoinbaseOnrampOrder/getMissingVerificationForCoinbaseOnrampOrder.ts
 /**
@@ -4089,6 +4425,59 @@ const __createCoinbaseOnrampOrder_wrapped = instrumentFunction({
 	}
 });
 
+//#endregion
+//#region src/utils/assertChainName/assertChainName.ts
+const CHAIN_ENUM_VALUES = Object.values(ChainEnum);
+/**
+* Validates that a chain name is a recognized ChainEnum value.
+*
+* Throws an {@link InvalidParamError} when the value is undefined or is not a
+* valid chain name.
+*
+* @category Extension Development
+*
+* @param chainName - The chain name to validate.
+* @throws {InvalidParamError} When chainName is undefined or not a valid ChainEnum value.
+* @notInstrumented
+*/
+const assertChainName = (chainName) => {
+	if (chainName === void 0) throw new InvalidParamError("chainName is required");
+	if (!CHAIN_ENUM_VALUES.includes(chainName)) throw new InvalidParamError(`Invalid chainName: ${chainName}`);
+};
+
+//#endregion
+//#region src/modules/funding/coinbase/getCoinbaseAccounts/getCoinbaseAccounts.ts
+/**
+* Gets the Coinbase accounts (balances) for the authenticated user.
+*
+* @param [params] GetCoinbaseAccountsParams - Optional filters for the accounts.
+* @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
+* @returns A promise resolving to an array of Coinbase accounts with balances.
+* @throws {InvalidParamError} When chainName is not a valid ChainEnum value or networkId is a non-integer or negative number.
+* @example
+* ```typescript
+* const accounts = await getCoinbaseAccounts({ chainName: 'EVM' });
+* console.log(accounts[0].balances);
+* ```
+* @see createCoinbaseExchangeTransfer
+* @see GetCoinbaseAccountsParams
+* @notInstrumented
+*/
+const getCoinbaseAccounts = async (params, client = getDefaultClient()) => {
+	const core = getCore(client);
+	const apiClient = createApiClient({ includeMfaToken: true }, client);
+	const chainName = params?.chainName;
+	if (chainName !== void 0) assertChainName(chainName);
+	const networkId = params?.networkId;
+	if (networkId !== void 0 && (!Number.isInteger(networkId) || networkId < 0)) throw new InvalidParamError(`Invalid networkId: ${networkId}`);
+	return await apiClient.getUserAccounts({
+		chainName,
+		environmentId: core.environmentId,
+		exchangeKey: ExchangeKeyEnum.Coinbase,
+		networkId
+	});
+};
+
 //#endregion
 //#region src/modules/funding/coinbase/getCoinbaseBuyUrl/getCoinbaseBuyUrl.ts
 /**
@@ -9198,5 +9587,5 @@ const parseUserAgent = ({ userAgent }) => {
 assertPackageVersion(name, version);
 
 //#endregion
-export { BaseError, CaptchaProviderEnum, CheckoutSessionTokenMissingError, ClientAlreadyInitializedError, DeeplinkConnectAndVerifyUnsupportedError, DeviceRegistrationIdentityMismatchError, FeeEstimationFailedError, FlowSessionTokenMissingError, GOOGLE_DRIVE_BACKUP_REQUIRED_SCOPES, InvalidDeviceRegistrationRedirectError, InvalidExternalAuthError, InvalidParamError, InvalidRedirectStorageStateError, InvalidSocialCallbackOriginError, JwtVerifiedCredentialFormatEnum, LinkCredentialError, MFAAction, MergeAccountsConfirmationError, MfaInvalidOtpError, MfaRateLimitedError, MissingRedirectStorageStateError, MissingSocialUrlParamError, MissingUserVerificationError, NetworkAddingUnavailableError, NetworkNotAddedError, NetworkSwitchingUnavailableError, NoAddressFoundError, NoNetworkProvidersError, NoPasskeyCredentialsFoundError, NoSmartWalletAccountSignerFoundError, NoWebAuthNSupportError, NotWaasWalletAccountError, ProviderEnum, SandboxMaximumThresholdReachedError, SimulationFailedError, TokenScope, TokenSwapError, UnauthorizedError, UnavailableInServerSideError, UnrecognizedNetworkError, UserCancelledSocialPopUpError, UserNotAuthenticatedError, UserRejectedError, WaasLoadFailedError, WaasOnboardingIncompleteError, WalletAccountAlreadyVerifiedError, WalletAccountNotSelectedError, WalletAlreadyLinkedToAnotherUserError, WalletProviderMethodUnavailableError, WalletScreeningBlockedError, __acknowledgeRecoveryCodes_wrapped as acknowledgeRecoveryCodes, addCoinbaseOnrampOrderEventListener, __addNetwork_wrapped as addNetwork, appendConnectionUriToDeeplink, assertWalletAccountSigningAvailability, assertWalletProviderMethodDefined, __attachCheckoutTransactionSource_wrapped as attachCheckoutTransactionSource, __attachFlowSource_wrapped as attachFlowSource, authenticateMfaRecoveryCode, authenticatePasskeyMFA, authenticateTotpMfaDevice, __authenticateWithSocial_wrapped as authenticateWithSocial, __broadcastCheckoutTransaction_wrapped as broadcastCheckoutTransaction, __broadcastFlow_wrapped as broadcastFlow, canConnectWithHardwareWallet, __cancelCheckoutTransaction_wrapped as cancelCheckoutTransaction, __cancelFlow_wrapped as cancelFlow, __checkStepUpAuth_wrapped as checkStepUpAuth, checkUserScopes, clearDeviceRegistrationRedirectParams, clearSocialRedirectParams, __completeDeviceRegistration_wrapped as completeDeviceRegistration, __completeSocialAuthentication_wrapped as completeSocialAuthentication, __completeSocialRedirect_wrapped as completeSocialRedirect, __confirmTransaction_wrapped as confirmTransaction, __connectAndVerifyWithWalletProvider_wrapped as connectAndVerifyWithWalletProvider, __connectWithWalletProvider_wrapped as connectWithWalletProvider, __consumeMfaToken_wrapped as consumeMfaToken, __createCheckoutTransaction_wrapped as createCheckoutTransaction, __createCoinbaseOnrampOrder_wrapped as createCoinbaseOnrampOrder, __createCryptoDotComPayment_wrapped as createCryptoDotComPayment, __createDynamicClient_wrapped as createDynamicClient, createKrakenExchangeTransfer, __createNewMfaRecoveryCodes_wrapped as createNewMfaRecoveryCodes, __deleteMfaDevice_wrapped as deleteMfaDevice, __deletePasskey_wrapped as deletePasskey, __deleteUser_wrapped as deleteUser, detectDeviceRegistrationRedirect, detectOAuthRedirect, detectSocialRedirectUrl, excludeInstalledFromCatalog, __executeSwapTransaction_wrapped as executeSwapTransaction, fetchProjectSettings, findMissingGoogleDriveBackupScopes, getActiveNetworkData, getActiveNetworkId, getAvailableWalletProvidersData, getBalance, getBalanceForAddress, getBalances, getCaptchaSettings, getCheckoutTransaction, getCheckoutTransactionQuote, getCoinbaseBuyUrl, getConnectedAddresses, getDefaultClient, getDeviceRegistrationTokenFromUrl, getElevatedAccessToken, getFlow, getFlowQuote, __getGoogleDriveBackupReadiness_wrapped as getGoogleDriveBackupReadiness, getInstallationLinkForCurrentPlatform, getKrakenAccounts, getKrakenWhitelistedAddresses, getMfaDevices, getMfaMethods, getMfaRecoveryCodes, getMissingVerificationForCoinbaseOnrampOrder, __getMoonPayCurrencies_wrapped as getMoonPayCurrencies, __getMoonPayUrl_wrapped as getMoonPayUrl, getMultichainBalances, getMultichainTokenBalances, getNativeBalance, getNetworksData, getOwnerWalletAccountForSmartWalletAccount, getPasskeys, getPrimaryWalletAccount, getRegisteredDevices, getSelectedWalletAccount, getSwapQuote, getSwapStatus, getTokenBalances, getTransactionHistory, getUserSocialAccounts, getWalletAccountAddressByType, getWalletAccountFromAddress, getWalletAccounts, getWalletConnectCatalog, getWalletConnectCatalogWalletByWalletProviderKey, getWalletOptionsCatalogue, getWalletProviderDataByKey, hasAllGoogleDriveBackupScopes, hasExtension, __initializeClient_wrapped as initializeClient, isAnyWalletAccountConnected, isCaptchaRequired, isDeeplinkWalletProvider, isDeviceRegistrationRequired, isHardwareWalletAccount, isInsufficientGoogleDriveScopesError, isMfaRequiredForAction, isMobile, isPendingRecoveryCodesAcknowledgment, isProgrammaticNetworkSwitchAvailable, isSignedIn, isUserMissingMfaAuth, isUserOnboardingComplete, isWalletAccountVerified, logout, matchWalletProvidersToCatalogGroup, mergeUserAccounts, offEvent, offWalletProviderEvent, onEvent, onWalletProviderEvent, onceEvent, parseUserAgent, __prepareCheckoutTransaction_wrapped as prepareCheckoutTransaction, __prepareFlowSigning_wrapped as prepareFlowSigning, __proveWalletAccountOwnership_wrapped as proveWalletAccountOwnership, __refreshAuth_wrapped as refreshAuth, __refreshUser_wrapped as refreshUser, __registerPasskey_wrapped as registerPasskey, __registerTotpMfaDevice_wrapped as registerTotpMfaDevice, __removeWalletAccount_wrapped as removeWalletAccount, __requestExternalAuthElevatedToken_wrapped as requestExternalAuthElevatedToken, requiresConversion, __revokeAllRegisteredDevices_wrapped as revokeAllRegisteredDevices, __revokeRegisteredDevice_wrapped as revokeRegisteredDevice, __selectPrimaryWalletAccount_wrapped as selectPrimaryWalletAccount, __sendEmailOTP_wrapped as sendEmailOTP, __sendSmsOTP_wrapped as sendSmsOTP, __setCaptchaToken_wrapped as setCaptchaToken, __setDefaultMfaDevice_wrapped as setDefaultMfaDevice, __setInstrumentationEnabled_wrapped as setInstrumentationEnabled, __setSelectedWalletAccount_wrapped as setSelectedWalletAccount, __signInWithExternalJwt_wrapped as signInWithExternalJwt, __signInWithPasskey_wrapped as signInWithPasskey, __signInWithSocialPopUp_wrapped as signInWithSocialPopUp, __signInWithSocialRedirect_wrapped as signInWithSocialRedirect, __signMessage_wrapped as signMessage, __submitCheckoutTransaction_wrapped as submitCheckoutTransaction, __submitFlowTransaction_wrapped as submitFlowTransaction, supportedCountries, __switchActiveNetwork_wrapped as switchActiveNetwork, trackCheckoutTransaction, __transferAmount_wrapped as transferAmount, __transferWalletAccount_wrapped as transferWalletAccount, __unlinkSocialAccount_wrapped as unlinkSocialAccount, __updateUser_wrapped as updateUser, __verifyOTP_wrapped as verifyOTP, __verifyWalletAccount_wrapped as verifyWalletAccount, waitForClientInitialized };
+export { BaseError, COINBASE_TRAVEL_RULE_FIELD_DESCRIPTIONS, CaptchaProviderEnum, CheckoutSessionTokenMissingError, ClientAlreadyInitializedError, CoinbaseBeneficiaryWalletType, CoinbaseIsSelfTransfer, CoinbaseTransferMfaFailedError, CoinbaseTransferMfaRequiredError, CoinbaseTravelRuleFieldName, CoinbaseTravelRuleRequiredError, DeeplinkConnectAndVerifyUnsupportedError, DeviceRegistrationIdentityMismatchError, FeeEstimationFailedError, FlowSessionTokenMissingError, GOOGLE_DRIVE_BACKUP_REQUIRED_SCOPES, InvalidDeviceRegistrationRedirectError, InvalidExternalAuthError, InvalidParamError, InvalidRedirectStorageStateError, InvalidSocialCallbackOriginError, JwtVerifiedCredentialFormatEnum, LinkCredentialError, MFAAction, MergeAccountsConfirmationError, MfaInvalidOtpError, MfaRateLimitedError, MissingRedirectStorageStateError, MissingSocialUrlParamError, MissingUserVerificationError, NetworkAddingUnavailableError, NetworkNotAddedError, NetworkSwitchingUnavailableError, NoAddressFoundError, NoNetworkProvidersError, NoPasskeyCredentialsFoundError, NoSmartWalletAccountSignerFoundError, NoWebAuthNSupportError, NotWaasWalletAccountError, ProviderEnum, SandboxMaximumThresholdReachedError, SimulationFailedError, TokenScope, TokenSwapError, TransactionBroadcastError, UnauthorizedError, UnavailableInServerSideError, UnrecognizedNetworkError, UserCancelledSocialPopUpError, UserNotAuthenticatedError, UserRejectedError, WaasLoadFailedError, WaasOnboardingIncompleteError, WalletAccountAlreadyVerifiedError, WalletAccountNotSelectedError, WalletAlreadyLinkedToAnotherUserError, WalletProviderMethodUnavailableError, WalletScreeningBlockedError, __acknowledgeRecoveryCodes_wrapped as acknowledgeRecoveryCodes, addCoinbaseOnrampOrderEventListener, __addNetwork_wrapped as addNetwork, appendConnectionUriToDeeplink, assertWalletAccountSigningAvailability, assertWalletProviderMethodDefined, __attachCheckoutTransactionSource_wrapped as attachCheckoutTransactionSource, __attachFlowSource_wrapped as attachFlowSource, authenticateMfaRecoveryCode, authenticatePasskeyMFA, authenticateTotpMfaDevice, __authenticateWithSocial_wrapped as authenticateWithSocial, __broadcastCheckoutTransaction_wrapped as broadcastCheckoutTransaction, __broadcastFlow_wrapped as broadcastFlow, canConnectWithHardwareWallet, __cancelCheckoutTransaction_wrapped as cancelCheckoutTransaction, __cancelFlow_wrapped as cancelFlow, __checkStepUpAuth_wrapped as checkStepUpAuth, checkUserScopes, clearDeviceRegistrationRedirectParams, clearSocialRedirectParams, __completeDeviceRegistration_wrapped as completeDeviceRegistration, __completeSocialAuthentication_wrapped as completeSocialAuthentication, __completeSocialRedirect_wrapped as completeSocialRedirect, __confirmTransaction_wrapped as confirmTransaction, __connectAndVerifyWithWalletProvider_wrapped as connectAndVerifyWithWalletProvider, __connectWithWalletProvider_wrapped as connectWithWalletProvider, __consumeMfaToken_wrapped as consumeMfaToken, __createCheckoutTransaction_wrapped as createCheckoutTransaction, createCoinbaseExchangeTransfer, __createCoinbaseOnrampOrder_wrapped as createCoinbaseOnrampOrder, __createCryptoDotComPayment_wrapped as createCryptoDotComPayment, __createDynamicClient_wrapped as createDynamicClient, createKrakenExchangeTransfer, __createNewMfaRecoveryCodes_wrapped as createNewMfaRecoveryCodes, __deleteMfaDevice_wrapped as deleteMfaDevice, __deletePasskey_wrapped as deletePasskey, __deleteUser_wrapped as deleteUser, detectDeviceRegistrationRedirect, detectOAuthRedirect, detectSocialRedirectUrl, excludeInstalledFromCatalog, __executeSwapTransaction_wrapped as executeSwapTransaction, fetchProjectSettings, findMissingGoogleDriveBackupScopes, getActiveNetworkData, getActiveNetworkId, getAvailableWalletProvidersData, getBalance, getBalanceForAddress, getBalances, getCaptchaSettings, getCheckoutTransaction, getCheckoutTransactionQuote, getCoinbaseAccounts, getCoinbaseBuyUrl, getConnectedAddresses, getDefaultClient, getDeviceRegistrationTokenFromUrl, getElevatedAccessToken, getFlow, getFlowQuote, __getGoogleDriveBackupReadiness_wrapped as getGoogleDriveBackupReadiness, getInstallationLinkForCurrentPlatform, getKrakenAccounts, getKrakenWhitelistedAddresses, getMfaDevices, getMfaMethods, getMfaRecoveryCodes, getMissingVerificationForCoinbaseOnrampOrder, __getMoonPayCurrencies_wrapped as getMoonPayCurrencies, __getMoonPayUrl_wrapped as getMoonPayUrl, getMultichainBalances, getMultichainTokenBalances, getNativeBalance, getNetworksData, getOwnerWalletAccountForSmartWalletAccount, getPasskeys, getPrimaryWalletAccount, getRegisteredDevices, getSelectedWalletAccount, getSwapQuote, getSwapStatus, getTokenBalances, getTransactionHistory, getUserSocialAccounts, getWalletAccountAddressByType, getWalletAccountFromAddress, getWalletAccounts, getWalletConnectCatalog, getWalletConnectCatalogWalletByWalletProviderKey, getWalletOptionsCatalogue, getWalletProviderDataByKey, hasAllGoogleDriveBackupScopes, hasExtension, __initializeClient_wrapped as initializeClient, isAnyWalletAccountConnected, isCaptchaRequired, isDeeplinkWalletProvider, isDeviceRegistrationRequired, isHardwareWalletAccount, isInsufficientGoogleDriveScopesError, isMfaRequiredForAction, isMobile, isPendingRecoveryCodesAcknowledgment, isProgrammaticNetworkSwitchAvailable, isSignedIn, isUserMissingMfaAuth, isUserOnboardingComplete, isWalletAccountVerified, logout, matchWalletProvidersToCatalogGroup, mergeUserAccounts, offEvent, offWalletProviderEvent, onEvent, onWalletProviderEvent, onceEvent, parseUserAgent, __prepareCheckoutTransaction_wrapped as prepareCheckoutTransaction, __prepareFlowSigning_wrapped as prepareFlowSigning, __proveWalletAccountOwnership_wrapped as proveWalletAccountOwnership, __refreshAuth_wrapped as refreshAuth, __refreshUser_wrapped as refreshUser, __registerPasskey_wrapped as registerPasskey, __registerTotpMfaDevice_wrapped as registerTotpMfaDevice, __removeWalletAccount_wrapped as removeWalletAccount, __requestExternalAuthElevatedToken_wrapped as requestExternalAuthElevatedToken, requiresConversion, __revokeAllRegisteredDevices_wrapped as revokeAllRegisteredDevices, __revokeRegisteredDevice_wrapped as revokeRegisteredDevice, __selectPrimaryWalletAccount_wrapped as selectPrimaryWalletAccount, __sendEmailOTP_wrapped as sendEmailOTP, __sendSmsOTP_wrapped as sendSmsOTP, __setCaptchaToken_wrapped as setCaptchaToken, __setDefaultMfaDevice_wrapped as setDefaultMfaDevice, __setInstrumentationEnabled_wrapped as setInstrumentationEnabled, __setSelectedWalletAccount_wrapped as setSelectedWalletAccount, __signInWithExternalJwt_wrapped as signInWithExternalJwt, __signInWithPasskey_wrapped as signInWithPasskey, __signInWithSocialPopUp_wrapped as signInWithSocialPopUp, __signInWithSocialRedirect_wrapped as signInWithSocialRedirect, __signMessage_wrapped as signMessage, __submitCheckoutTransaction_wrapped as submitCheckoutTransaction, __submitFlowTransaction_wrapped as submitFlowTransaction, supportedCountries, __switchActiveNetwork_wrapped as switchActiveNetwork, trackCheckoutTransaction, __transferAmount_wrapped as transferAmount, __transferWalletAccount_wrapped as transferWalletAccount, __unlinkSocialAccount_wrapped as unlinkSocialAccount, __updateUser_wrapped as updateUser, __verifyOTP_wrapped as verifyOTP, __verifyWalletAccount_wrapped as verifyWalletAccount, waitForClientInitialized };
 //# sourceMappingURL=index.esm.js.map