@dynamic-labs-sdk/client 0.9.0 → 0.12.0

package/dist/index.cjs.js

@@ -1,8 +1,8 @@
-const require_getNetworkProviderFromNetworkId = require('./getNetworkProviderFromNetworkId-BXGwNlcZ.cjs.js');
-const require_InvalidParamError = require('./InvalidParamError-D1yNl3r1.cjs.js');
-const require_getVerifiedCredentialForWalletAccount = require('./getVerifiedCredentialForWalletAccount-BW8iluei.cjs.js');
-const require_isMfaRequiredForAction = require('./isMfaRequiredForAction-DmYvEIJH.cjs.js');
-const require_NotWaasWalletAccountError = require('./NotWaasWalletAccountError-s2J7fQHr.cjs.js');
+const require_getNetworkProviderFromNetworkId = require('./getNetworkProviderFromNetworkId-Dvi65YCc.cjs.js');
+const require_InvalidParamError = require('./InvalidParamError-Dj1fpM2M.cjs.js');
+const require_getVerifiedCredentialForWalletAccount = require('./getVerifiedCredentialForWalletAccount-CnHwYXVQ.cjs.js');
+const require_isMfaRequiredForAction = require('./isMfaRequiredForAction-zmF7uoM7.cjs.js');
+const require_NotWaasWalletAccountError = require('./NotWaasWalletAccountError-Cy_46Mkg.cjs.js');
 let _dynamic_labs_sdk_assert_package_version = require("@dynamic-labs-sdk/assert-package-version");
 let _dynamic_labs_sdk_api_core = require("@dynamic-labs/sdk-api-core");
 let zod_mini = require("zod/mini");
@@ -261,6 +261,7 @@ const logout = async (client = require_InvalidParamError.getDefaultClient()) =>
 	}
 	core.state.set({
 		captchaToken: null,
+		elevatedAccessTokens: [],
 		legacyToken: null,
 		mfaToken: null,
 		sessionExpiresAt: null,
@@ -321,6 +322,36 @@ const initializeAuth = (client) => {
 	checkExpiration();
 };
 
+//#endregion
+//#region src/modules/crossTabEventSync/setupCrossTabEventSync/setupCrossTabEventSync.ts
+/**
+* Sets up bidirectional event synchronization between the core event emitter
+* and the CrossTabBroadcast service.
+*
+* This enables events fired in one tab to be received in other tabs.
+*
+* **Local → Cross-Tab (Forwarding)**
+* - Listens to specific events on core.eventEmitter
+* - Forwards them to other tabs via core.crossTabBroadcast.send()
+*
+* **Cross-Tab → Local (Receiving)**
+* - Listens to cross-tab events via core.crossTabBroadcast.on()
+* - Emits corresponding "*InAnotherTab" events on core.eventEmitter
+*
+* @param client - The Dynamic client instance
+*/
+const setupCrossTabEventSync = (client) => {
+	const core = require_InvalidParamError.getCore(client);
+	const handleDeviceRegistrationCompleted = () => {
+		core.crossTabBroadcast.send({ event: "deviceRegistrationCompleted" });
+	};
+	core.eventEmitter.on("deviceRegistrationCompleted", handleDeviceRegistrationCompleted);
+	const handleCrossTabDeviceRegistrationCompleted = () => {
+		require_getVerifiedCredentialForWalletAccount.emitEvent({ event: "deviceRegistrationCompletedInAnotherTab" }, client);
+	};
+	core.crossTabBroadcast.on("deviceRegistrationCompleted", handleCrossTabDeviceRegistrationCompleted);
+};
+
 //#endregion
 //#region src/modules/state/raiseStateEvents/raiseStateEvents.ts
 const raiseStateEvents = (client) => {
@@ -345,6 +376,7 @@ const unverifiedWalletAccountSchema = zod_mini.object({
 		type: zod_mini.custom((val) => typeof val === "string")
 	}))),
 	chain: zod_mini.custom((val) => typeof val === "string"),
+	hardwareWalletVendor: zod_mini.optional(zod_mini.custom((val) => typeof val === "string")),
 	id: zod_mini.string(),
 	lastSelectedAt: zod_mini.nullable(zod_mini.date()),
 	walletProviderKey: zod_mini.string()
@@ -370,6 +402,12 @@ const sessionStorageKeySchema = require_getNetworkProviderFromNetworkId.createSt
 	key: "session",
 	schema: zod_mini.object({
 		captchaToken: zod_mini.nullable(zod_mini.string()),
+		elevatedAccessTokens: zod_mini.array(zod_mini.object({
+			expiresAt: zod_mini.number(),
+			scopes: zod_mini.array(zod_mini.string()),
+			singleUse: zod_mini.nullable(zod_mini.boolean()),
+			token: zod_mini.string()
+		})),
 		legacyToken: zod_mini.nullable(zod_mini.string()),
 		mfaToken: zod_mini.nullable(zod_mini.string()),
 		sessionExpiration: zod_mini.number(),
@@ -391,6 +429,12 @@ const hydrateStateWithStorage = async (client) => {
 		stateChanges.legacyToken = session.legacyToken;
 		stateChanges.sessionExpiresAt = new Date(session.sessionExpiration);
 		stateChanges.mfaToken = session.mfaToken;
+		stateChanges.elevatedAccessTokens = session.elevatedAccessTokens.map((token) => ({
+			expiresAt: new Date(token.expiresAt),
+			scopes: token.scopes,
+			singleUse: token.singleUse ?? false,
+			token: token.token
+		}));
 		stateChanges.captchaToken = session.captchaToken;
 		stateChanges.sessionKeys = session.sessionKeys;
 	}
@@ -413,6 +457,12 @@ const syncStateWithStorage = (client) => {
 		if (state.sessionExpiresAt === null) core.storage.removeItem(sessionStorageKeySchema);
 		else core.storage.setItem(sessionStorageKeySchema, {
 			captchaToken: state.captchaToken,
+			elevatedAccessTokens: (state.elevatedAccessTokens || []).map((token) => ({
+				expiresAt: token.expiresAt.getTime(),
+				scopes: token.scopes,
+				singleUse: token.singleUse ?? null,
+				token: token.token
+			})),
 			legacyToken: state.legacyToken,
 			mfaToken: state.mfaToken,
 			sessionExpiration: state.sessionExpiresAt.getTime(),
@@ -472,6 +522,7 @@ const initializeClient = async (client = require_InvalidParamError.getDefaultCli
 	core.state.set({ initStatus: "in-progress" });
 	initializeAuth(client);
 	raiseStateEvents(client);
+	setupCrossTabEventSync(client);
 	const initializeStorageSyncPromise = initializeStorageSync(client);
 	const fetchProjectSettingsPromise = initializeStorageSyncPromise.then(async () => {
 		if (!core.state.get().projectSettings) await fetchProjectSettings(client);
@@ -901,6 +952,20 @@ const createDynamicClient = (config) => {
 	return client;
 };
 
+//#endregion
+//#region src/errors/FeeEstimationFailedError.ts
+var FeeEstimationFailedError = class extends require_InvalidParamError.BaseError {
+	constructor(params) {
+		super({
+			cause: params.cause || null,
+			code: "fee_estimation_failed_error",
+			docsUrl: null,
+			name: "FeeEstimationFailedError",
+			shortMessage: params.message
+		});
+	}
+};
+
 //#endregion
 //#region src/errors/InvalidDeviceRegistrationRedirectError.ts
 var InvalidDeviceRegistrationRedirectError = class extends require_InvalidParamError.BaseError {
@@ -1085,6 +1150,20 @@ var NoWebAuthNSupportError = class extends require_InvalidParamError.BaseError {
 	}
 };
 
+//#endregion
+//#region src/errors/SimulationFailedError.ts
+var SimulationFailedError = class extends require_InvalidParamError.BaseError {
+	constructor(params) {
+		super({
+			cause: params.cause || null,
+			code: "simulation_failed_error",
+			docsUrl: null,
+			name: "SimulationFailedError",
+			shortMessage: params.message
+		});
+	}
+};
+
 //#endregion
 //#region src/errors/UnrecognizedNetworkError.ts
 var UnrecognizedNetworkError = class extends require_InvalidParamError.BaseError {
@@ -1685,6 +1764,18 @@ const getMultichainBalances = async ({ balanceRequest }, client = require_Invali
 	})).chainBalances;
 };
 
+//#endregion
+//#region src/modules/deviceRegistration/completeDeviceRegistration/completeDeviceRegistration.ts
+const DEVICE_REGISTRATION_TOKEN_HEADER = "x-dynamic-device-registration-token";
+const completeDeviceRegistration = async ({ deviceToken }, client = require_InvalidParamError.getDefaultClient()) => {
+	require_InvalidParamError.assertDefined(deviceToken, "deviceToken is required");
+	const core = require_InvalidParamError.getCore(client);
+	const response = await require_InvalidParamError.createApiClient({ headers: { [DEVICE_REGISTRATION_TOKEN_HEADER]: deviceToken } }, client).deviceRegistration({ environmentId: core.environmentId });
+	require_getVerifiedCredentialForWalletAccount.updateAuthFromVerifyResponse({ response }, client);
+	require_getVerifiedCredentialForWalletAccount.emitEvent({ event: "deviceRegistrationCompleted" }, client);
+	return response;
+};
+
 //#endregion
 //#region src/modules/deviceRegistration/getDeviceRegistrationTokenFromUrl/getDeviceRegistrationTokenFromUrl.ts
 /**
@@ -3755,13 +3846,14 @@ const verifyOTPForUserSignIn = async ({ otpVerification, verificationToken }, cl
 
 //#endregion
 //#region src/modules/otp/verifyOTP/verifyOTPForUserUpdate/verifyOTPForUserUpdate.ts
-const verifyOTPForUserUpdate = async ({ otpVerification, verificationToken }, client) => {
+const verifyOTPForUserUpdate = async ({ otpVerification, verificationToken, requestedScopes }, client) => {
 	const core = require_InvalidParamError.getCore(client);
 	const apiClient = require_InvalidParamError.createApiClient({}, client);
 	const verifyRequest = {
 		verificationToken,
 		verificationUUID: otpVerification.verificationUUID
 	};
+	if (requestedScopes) verifyRequest.requestedScopes = requestedScopes;
 	if (otpVerification.email) return apiClient.verifyEmailVerification({
 		emailVerificationVerifyRequest: verifyRequest,
 		environmentId: core.environmentId
@@ -3785,8 +3877,14 @@ const verifyOTPForUserUpdate = async ({ otpVerification, verificationToken }, cl
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns A promise that resolves to the verify response object upon successful verification.
 */
-const verifyOTP = async ({ otpVerification, verificationToken }, client = require_InvalidParamError.getDefaultClient()) => {
-	const response = await (client.user ? verifyOTPForUserUpdate : verifyOTPForUserSignIn)({
+const verifyOTP = async ({ otpVerification, verificationToken, requestedScopes }, client = require_InvalidParamError.getDefaultClient()) => {
+	let response;
+	if (client.user) response = await verifyOTPForUserUpdate({
+		otpVerification,
+		requestedScopes,
+		verificationToken
+	}, client);
+	else response = await verifyOTPForUserSignIn({
 		otpVerification,
 		verificationToken
 	}, client);
@@ -3920,11 +4018,12 @@ const getAddressesWithTypesFromConnectionResult = (connectionResult) => {
 *
 * @param params.walletProviderKey - The unique key identifying the wallet provider to connect to (e.g. 'metamaskevm', 'phantomsol').
 * @param [params.addToDynamicWalletAccounts] - Whether to add the connected wallet account to the user's wallet accounts. Defaults to true.
+* @param [params.hardwareWalletVendor] - The hardware wallet vendor, if connecting via a hardware wallet (e.g. 'ledger').
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns A promise that resolves to the connected wallet account.
 * @throws NoAddressFoundError If the request to connect was successful but no address is connected to your app.
 */
-const connectWithWalletProvider = async ({ walletProviderKey, addToDynamicWalletAccounts = true }, client = require_InvalidParamError.getDefaultClient()) => {
+const connectWithWalletProvider = async ({ walletProviderKey, addToDynamicWalletAccounts = true, hardwareWalletVendor }, client = require_InvalidParamError.getDefaultClient()) => {
 	const walletProvider = require_getVerifiedCredentialForWalletAccount.getWalletProviderByKey({ walletProviderKey }, client);
 	assertWalletProviderMethodDefined(walletProvider, "connect");
 	const { addresses } = await walletProvider.connect();
@@ -3940,6 +4039,7 @@ const connectWithWalletProvider = async ({ walletProviderKey, addToDynamicWallet
 		address: mainAddress,
 		addressesWithTypes: getAddressesWithTypesFromConnectionResult({ addresses }),
 		chain: walletProvider.chain,
+		hardwareWalletVendor,
 		id: require_getVerifiedCredentialForWalletAccount.formatWalletAccountId({
 			address: mainAddress,
 			chain: walletProvider.chain,
@@ -3958,6 +4058,17 @@ const connectWithWalletProvider = async ({ walletProviderKey, addToDynamicWallet
 	return walletAccount;
 };
 
+//#endregion
+//#region src/modules/wallets/hardwareWallet/formatSignatureForHardwareWallet/formatSignatureForHardwareWallet.ts
+/**
+* Wraps a raw signature in the JSON format expected by the backend for hardware wallet verification.
+*
+* @param params.hardwareWalletVendor - The hardware wallet vendor that produced the signature.
+* @param params.signature - The raw signature string to wrap.
+* @returns The signature wrapped in `{ signedTransaction: { data } }` JSON format.
+*/
+const formatSignatureForHardwareWallet = ({ signature, hardwareWalletVendor: _ }) => JSON.stringify({ signedTransaction: { data: signature } });
+
 //#endregion
 //#region src/modules/wallets/utils/getChainIdForAccountVerification/getChainIdForAccountVerification.ts
 const getChainIdForAccountVerification = async ({ walletProvider }) => {
@@ -4039,10 +4150,14 @@ const isSameAddress = (left, right, chain) => require_getVerifiedCredentialForWa
 
 //#endregion
 //#region src/modules/wallets/verifyWalletAccountForSignInOrTransfer/verifyWalletAccountForSignInOrTransfer.ts
-const verifyWalletAccountForSignInOrTransfer = async ({ walletAccount, isTransfer }, client) => {
+const verifyWalletAccountForSignInOrTransfer = async ({ walletAccount, isTransfer, requestedScopes }, client) => {
 	if (walletAccount.verifiedCredentialId) throw new WalletAccountAlreadyVerifiedError(walletAccount.address);
 	const walletProvider = require_getVerifiedCredentialForWalletAccount.getWalletProviderFromWalletAccount({ walletAccount }, client);
 	const { messageToSign, signature } = await proveWalletAccountOwnership({ walletAccount }, client);
+	const formattedSignature = walletAccount.hardwareWalletVendor ? formatSignatureForHardwareWallet({
+		hardwareWalletVendor: walletAccount.hardwareWalletVendor,
+		signature
+	}) : signature;
 	const { networkId } = await walletProvider.getActiveNetworkId();
 	const response = await require_getNetworkProviderFromNetworkId.verifyMessageSignatureOwnership({
 		addressesWithTypes: walletAccount.addressesWithTypes,
@@ -4050,7 +4165,8 @@ const verifyWalletAccountForSignInOrTransfer = async ({ walletAccount, isTransfe
 		isTransfer,
 		messageToSign,
 		networkId,
-		signature,
+		requestedScopes,
+		signature: formattedSignature,
 		walletAddress: walletAccount.address,
 		walletDisplayName: walletProvider.metadata.displayName,
 		walletProviderType: walletProvider.walletProviderType
@@ -4086,9 +4202,10 @@ const verifyWalletAccountForSignInOrTransfer = async ({ walletAccount, isTransfe
 * @throws WalletAccountAlreadyVerifiedError If the wallet is already verified.
 * @throws WalletAlreadyLinkedToAnotherUserError If the wallet is linked to another user.
 */
-const verifyWalletAccount = async ({ walletAccount }, client = require_InvalidParamError.getDefaultClient()) => {
+const verifyWalletAccount = async ({ walletAccount, requestedScopes }, client = require_InvalidParamError.getDefaultClient()) => {
 	return verifyWalletAccountForSignInOrTransfer({
 		isTransfer: false,
+		requestedScopes,
 		walletAccount
 	}, client);
 };
@@ -4103,12 +4220,14 @@ const verifyWalletAccount = async ({ walletAccount }, client = require_InvalidPa
 * the wallet account is added to their profile.
 *
 * @param params.walletProviderKey - The unique key identifying the wallet provider to connect to.
+* @param [params.hardwareWalletVendor] - The hardware wallet vendor, if connecting via a hardware wallet (e.g. 'ledger').
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns A promise that resolves to the connected and verified wallet account.
 */
-const connectAndVerifyWithWalletProvider = async ({ walletProviderKey }, client = require_InvalidParamError.getDefaultClient()) => {
+const connectAndVerifyWithWalletProvider = async ({ walletProviderKey, hardwareWalletVendor }, client = require_InvalidParamError.getDefaultClient()) => {
 	const walletAccount = await connectWithWalletProvider({
 		addToDynamicWalletAccounts: false,
+		hardwareWalletVendor,
 		walletProviderKey
 	}, client);
 	await verifyWalletAccount({ walletAccount }, client);
@@ -4190,6 +4309,30 @@ const getWalletProviderDataByKey = ({ walletProviderKey }, client = require_Inva
 	};
 };
 
+//#endregion
+//#region src/modules/wallets/hardwareWallet/canConnectWithHardwareWallet/canConnectWithHardwareWallet.ts
+/**
+* Checks whether a wallet provider supports connecting with a specific hardware wallet vendor.
+*
+* @param params.walletProviderKey - The key of the wallet provider to check.
+* @param params.hardwareWalletVendor - The hardware wallet vendor to check for.
+* @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
+* @returns Whether the wallet provider supports the specified hardware wallet vendor.
+*/
+const canConnectWithHardwareWallet = ({ walletProviderKey, hardwareWalletVendor }, client = require_InvalidParamError.getDefaultClient()) => {
+	return require_getVerifiedCredentialForWalletAccount.getWalletProviderByKey({ walletProviderKey }, client).metadata.supportedHardwareWalletVendors?.includes(hardwareWalletVendor) ?? false;
+};
+
+//#endregion
+//#region src/modules/wallets/hardwareWallet/isHardwareWalletAccount/isHardwareWalletAccount.ts
+/**
+* Checks whether a wallet account was connected via a hardware wallet.
+*
+* @param params.walletAccount - The wallet account to check.
+* @returns Whether the wallet account has a hardware wallet vendor set.
+*/
+const isHardwareWalletAccount = ({ walletAccount }) => walletAccount.hardwareWalletVendor !== void 0;
+
 //#endregion
 //#region src/modules/wallets/isWalletAccountVerified/isWalletAccountVerified.ts
 /**
@@ -4560,6 +4703,7 @@ const isIPad = (maxTouchPointsOverride) => {
 //#endregion
 exports.BaseError = require_InvalidParamError.BaseError;
 exports.ClientAlreadyInitializedError = ClientAlreadyInitializedError;
+exports.FeeEstimationFailedError = FeeEstimationFailedError;
 exports.InvalidDeviceRegistrationRedirectError = InvalidDeviceRegistrationRedirectError;
 exports.InvalidExternalAuthError = require_InvalidParamError.InvalidExternalAuthError;
 exports.InvalidParamError = require_InvalidParamError.InvalidParamError;
@@ -4586,6 +4730,7 @@ exports.NoSmartWalletAccountSignerFoundError = NoSmartWalletAccountSignerFoundEr
 exports.NoWebAuthNSupportError = NoWebAuthNSupportError;
 exports.NotWaasWalletAccountError = require_NotWaasWalletAccountError.NotWaasWalletAccountError;
 exports.SandboxMaximumThresholdReachedError = require_InvalidParamError.SandboxMaximumThresholdReachedError;
+exports.SimulationFailedError = SimulationFailedError;
 exports.UnavailableInServerSideError = UnavailableInServerSideError;
 exports.UnrecognizedNetworkError = UnrecognizedNetworkError;
 exports.UserNotAuthenticatedError = UserNotAuthenticatedError;
@@ -4603,6 +4748,8 @@ exports.authenticateMfaRecoveryCode = authenticateMfaRecoveryCode;
 exports.authenticatePasskeyMFA = authenticatePasskeyMFA;
 exports.authenticateTotpMfaDevice = authenticateTotpMfaDevice;
 exports.authenticateWithSocial = authenticateWithSocial;
+exports.canConnectWithHardwareWallet = canConnectWithHardwareWallet;
+exports.completeDeviceRegistration = completeDeviceRegistration;
 exports.completeSocialAuthentication = completeSocialAuthentication;
 exports.connectAndVerifyWithWalletProvider = connectAndVerifyWithWalletProvider;
 exports.connectWithWalletProvider = connectWithWalletProvider;
@@ -4651,6 +4798,7 @@ exports.hasExtension = require_getNetworkProviderFromNetworkId.hasExtension;
 exports.initializeClient = initializeClient;
 exports.isCaptchaRequired = require_getNetworkProviderFromNetworkId.isCaptchaRequired;
 exports.isDeviceRegistrationRequired = isDeviceRegistrationRequired;
+exports.isHardwareWalletAccount = isHardwareWalletAccount;
 exports.isMfaRequiredForAction = require_isMfaRequiredForAction.isMfaRequiredForAction;
 exports.isMobile = isMobile;
 exports.isPendingRecoveryCodesAcknowledgment = isPendingRecoveryCodesAcknowledgment;
@@ -4679,6 +4827,7 @@ exports.setDefaultMfaDevice = setDefaultMfaDevice;
 exports.signInWithExternalJwt = signInWithExternalJwt;
 exports.signInWithPasskey = signInWithPasskey;
 exports.signMessage = signMessage;
+exports.supportedCountries = supportedCountries;
 exports.switchActiveNetwork = switchActiveNetwork;
 exports.transferWalletAccount = transferWalletAccount;
 exports.unlinkSocialAccount = unlinkSocialAccount;