@dynamic-labs-sdk/client 0.12.1 → 0.14.0

package/dist/index.cjs.js

@@ -1,8 +1,8 @@
-const require_getNetworkProviderFromNetworkId = require('./getNetworkProviderFromNetworkId-BRin5Ty5.cjs.js');
-const require_InvalidParamError = require('./InvalidParamError-B83QXOQl.cjs.js');
-const require_getVerifiedCredentialForWalletAccount = require('./getVerifiedCredentialForWalletAccount-CsHHUt3-.cjs.js');
-const require_isMfaRequiredForAction = require('./isMfaRequiredForAction-BzWbWDdR.cjs.js');
-const require_NotWaasWalletAccountError = require('./NotWaasWalletAccountError-C_XzpX9u.cjs.js');
+const require_getNetworkProviderFromNetworkId = require('./getNetworkProviderFromNetworkId-z8WEapnj.cjs.js');
+const require_InvalidParamError = require('./InvalidParamError-DVzrk97b.cjs.js');
+const require_getVerifiedCredentialForWalletAccount = require('./getVerifiedCredentialForWalletAccount-Ck7DNGPJ.cjs.js');
+const require_isMfaRequiredForAction = require('./isMfaRequiredForAction-BINs954q.cjs.js');
+const require_NotWaasWalletAccountError = require('./NotWaasWalletAccountError-IxbdRVGy.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");
@@ -119,51 +119,10 @@ const fetchProjectSettings = async (client = require_InvalidParamError.getDefaul
 	return projectSettings;
 };
 
-//#endregion
-//#region src/utils/base64UrlDecode/base64UrlDecode.ts
-/**
-* Takes a base64url-encoded string (e.g. "nMueRPiAm51YXEjRtka8S_8Ura3HaqbmqDqMJCZmvkM")
-* and return the corresponding bytes, as an array buffer.
-*/
-const base64UrlDecode = (s) => {
-	s = s?.replace(/-/g, "+").replace(/_/g, "/") || "";
-	return Uint8Array.from(atob(s), (c) => c.charCodeAt(0));
-};
-
-//#endregion
-//#region src/utils/compressRawPublicKey/compressRawPublicKey.ts
-/**
-* Accepts a public key array buffer, and returns a buffer with the compressed version of the public key
-*/
-const compressRawPublicKey = (rawPublicKey) => {
-	const rawPublicKeyBytes = new Uint8Array(rawPublicKey);
-	const len = rawPublicKeyBytes.byteLength;
-	const compressedBytes = rawPublicKeyBytes.slice(0, 1 + len >>> 1);
-	compressedBytes[0] = 2 | rawPublicKeyBytes[len - 1] & 1;
-	return compressedBytes.buffer;
-};
-
-//#endregion
-//#region src/utils/p256Keygen/p256Keygen.ts
-const p256Keygen = async () => {
-	const p256Keypair = await crypto.subtle.generateKey({
-		name: "ECDSA",
-		namedCurve: "P-256"
-	}, true, ["sign", "verify"]);
-	const rawPublicKey = await crypto.subtle.exportKey("raw", p256Keypair.publicKey);
-	const privateKeyJwk = await crypto.subtle.exportKey("jwk", p256Keypair.privateKey);
-	const compressedPublicKeyBuffer = compressRawPublicKey(rawPublicKey);
-	return {
-		private: require_isMfaRequiredForAction.bufferToHex(base64UrlDecode(privateKeyJwk.d)),
-		privateJwk: privateKeyJwk,
-		public: require_isMfaRequiredForAction.bufferToHex(compressedPublicKeyBuffer)
-	};
-};
-
 //#endregion
 //#region src/modules/sessionKeys/generateSessionKeys/generateSessionKeys.ts
 const generateSessionKeys = async (client) => {
-	const { private: privateKey, public: publicKey, privateJwk: privateKeyJwk } = await p256Keygen();
+	const { private: privateKey, public: publicKey, privateJwk: privateKeyJwk } = await require_getNetworkProviderFromNetworkId.p256Keygen();
 	const core = require_InvalidParamError.getCore(client);
 	const stringifiedSessionKeys = JSON.stringify({
 		privateKey,
@@ -952,6 +911,20 @@ const createDynamicClient = (config) => {
 	return client;
 };
 
+//#endregion
+//#region src/errors/CheckoutSessionTokenMissingError.ts
+var CheckoutSessionTokenMissingError = class extends require_InvalidParamError.BaseError {
+	constructor({ transactionId }) {
+		super({
+			cause: null,
+			code: "checkout_session_token_missing",
+			docsUrl: null,
+			name: "CheckoutSessionTokenMissingError",
+			shortMessage: `No session token found for transaction ${transactionId}. Session tokens are issued once at transaction creation and cannot be recovered.`
+		});
+	}
+};
+
 //#endregion
 //#region src/errors/FeeEstimationFailedError.ts
 var FeeEstimationFailedError = class extends require_InvalidParamError.BaseError {
@@ -1764,6 +1737,176 @@ const getMultichainBalances = async ({ balanceRequest }, client = require_Invali
 	})).chainBalances;
 };
 
+//#endregion
+//#region src/modules/checkout/utils/createCheckoutSessionTokenStorageKey/createCheckoutSessionTokenStorageKey.ts
+const createCheckoutSessionTokenStorageKey = (transactionId) => {
+	return require_getNetworkProviderFromNetworkId.createStorageKeySchema({
+		key: `checkoutSessionToken:${transactionId}`,
+		schema: zod_mini.string()
+	});
+};
+
+//#endregion
+//#region src/modules/checkout/utils/createCheckoutApiClient/createCheckoutApiClient.ts
+const createCheckoutApiClient = async ({ transactionId }, client) => {
+	const core = require_InvalidParamError.getCore(client);
+	const apiClient = require_InvalidParamError.createApiClient({}, client);
+	const sessionToken = await core.storage.getItem(createCheckoutSessionTokenStorageKey(transactionId));
+	if (!sessionToken) throw new CheckoutSessionTokenMissingError({ transactionId });
+	return {
+		apiClient,
+		environmentId: core.environmentId,
+		sessionToken
+	};
+};
+
+//#endregion
+//#region src/modules/checkout/attachCheckoutTransactionSource/attachCheckoutTransactionSource.ts
+/**
+* Attaches a wallet source to a checkout transaction
+*
+* @param params AttachCheckoutTransactionSourceParams - The source details to attach.
+* @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
+* @returns The updated checkout transaction
+*/
+const attachCheckoutTransactionSource = async ({ fromAddress, fromChainId, transactionId }, client = require_InvalidParamError.getDefaultClient()) => {
+	const { apiClient, environmentId, sessionToken } = await createCheckoutApiClient({ transactionId }, client);
+	return apiClient.attachSource({
+		attachSourceRequest: {
+			fromAddress,
+			fromChainId,
+			sourceType: "wallet"
+		},
+		environmentId,
+		transactionId,
+		xDynamicCheckoutSessionToken: sessionToken
+	});
+};
+
+//#endregion
+//#region src/modules/checkout/broadcastCheckoutTransaction/broadcastCheckoutTransaction.ts
+/**
+* Records the on-chain broadcast of a checkout transaction
+*
+* @param params BroadcastCheckoutTransactionParams - The transaction ID and tx hash.
+* @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
+* @returns The updated checkout transaction
+*/
+const broadcastCheckoutTransaction = async ({ transactionId, txHash }, client = require_InvalidParamError.getDefaultClient()) => {
+	const { apiClient, environmentId, sessionToken } = await createCheckoutApiClient({ transactionId }, client);
+	return apiClient.recordCheckoutBroadcast({
+		environmentId,
+		recordBroadcastRequest: { txHash },
+		transactionId,
+		xDynamicCheckoutSessionToken: sessionToken
+	});
+};
+
+//#endregion
+//#region src/modules/checkout/cancelCheckoutTransaction/cancelCheckoutTransaction.ts
+/**
+* Cancels a checkout transaction before it has been broadcasted
+*
+* @param params CancelCheckoutTransactionParams - The transaction to cancel.
+* @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
+* @returns The cancelled checkout transaction
+*/
+const cancelCheckoutTransaction = async ({ transactionId }, client = require_InvalidParamError.getDefaultClient()) => {
+	const { apiClient, environmentId, sessionToken } = await createCheckoutApiClient({ transactionId }, client);
+	const result = await apiClient.cancelCheckoutTransaction({
+		environmentId,
+		transactionId,
+		xDynamicCheckoutSessionToken: sessionToken
+	});
+	await require_InvalidParamError.getCore(client).storage.removeItem(createCheckoutSessionTokenStorageKey(transactionId));
+	return result;
+};
+
+//#endregion
+//#region src/modules/checkout/createCheckoutTransaction/createCheckoutTransaction.ts
+/**
+* Creates a new checkout transaction and stores the session token for subsequent calls
+*
+* @param params CreateCheckoutTransactionParams - The parameters for the checkout transaction.
+* @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
+* @returns The created transaction with session token
+*/
+const createCheckoutTransaction = async (params, client = require_InvalidParamError.getDefaultClient()) => {
+	const core = require_InvalidParamError.getCore(client);
+	const result = await require_InvalidParamError.createApiClient({}, client).createCheckoutTransaction({
+		checkoutId: params.checkoutId,
+		checkoutTransactionCreateRequest: {
+			amount: params.amount,
+			currency: params.currency,
+			expiresIn: params.expiresIn,
+			externalId: params.externalId
+		},
+		environmentId: core.environmentId
+	});
+	await core.storage.setItem(createCheckoutSessionTokenStorageKey(result.transaction.id), result.sessionToken);
+	return result;
+};
+
+//#endregion
+//#region src/modules/checkout/getCheckoutTransaction/getCheckoutTransaction.ts
+/**
+* Fetches the current state of a checkout transaction
+*
+* @param params GetCheckoutTransactionParams - The parameters for fetching the transaction.
+* @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
+* @returns The checkout transaction
+*/
+const getCheckoutTransaction = async ({ transactionId }, client = require_InvalidParamError.getDefaultClient()) => {
+	const core = require_InvalidParamError.getCore(client);
+	return require_InvalidParamError.createApiClient({}, client).getCheckoutTransaction({
+		environmentId: core.environmentId,
+		transactionId
+	});
+};
+
+//#endregion
+//#region src/modules/checkout/getCheckoutTransactionQuote/getCheckoutTransactionQuote.ts
+/**
+* Fetches a quote for a checkout transaction
+*
+* @param params GetCheckoutTransactionQuoteParams - The quote parameters.
+* @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
+* @returns The updated checkout transaction with quote data
+*/
+const getCheckoutTransactionQuote = async ({ fromTokenAddress, slippage, toTokenAddress, transactionId }, client = require_InvalidParamError.getDefaultClient()) => {
+	const { apiClient, environmentId, sessionToken } = await createCheckoutApiClient({ transactionId }, client);
+	return apiClient.quoteCheckoutTransaction({
+		environmentId,
+		quoteRequest: {
+			fromTokenAddress,
+			slippage,
+			toTokenAddress
+		},
+		transactionId,
+		xDynamicCheckoutSessionToken: sessionToken
+	});
+};
+
+//#endregion
+//#region src/modules/checkout/prepareCheckoutTransaction/prepareCheckoutTransaction.ts
+/**
+* Prepares a checkout transaction for signing
+* This should be called immediately before triggering the transaction signing.
+* It will confirm the quote is still valid, the risk state is cleared, and the transaction is ready to be signed.
+*
+* @param params PrepareCheckoutTransactionParams - The transaction to prepare.
+* @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
+* @returns The updated checkout transaction
+*/
+const prepareCheckoutTransaction = async ({ transactionId }, client = require_InvalidParamError.getDefaultClient()) => {
+	const { apiClient, environmentId, sessionToken } = await createCheckoutApiClient({ transactionId }, client);
+	return apiClient.prepareCheckoutTransaction({
+		environmentId,
+		transactionId,
+		xDynamicCheckoutSessionToken: sessionToken
+	});
+};
+
 //#endregion
 //#region src/modules/deviceRegistration/completeDeviceRegistration/completeDeviceRegistration.ts
 const DEVICE_REGISTRATION_TOKEN_HEADER = "x-dynamic-device-registration-token";
@@ -1831,7 +1974,7 @@ const detectDeviceRegistrationRedirect = ({ url }) => {
 const isDeviceRegistrationRequired = (client = require_InvalidParamError.getDefaultClient()) => {
 	const user = client.user;
 	require_InvalidParamError.assertDefined(user, "User not logged in");
-	return Boolean(user.scope?.includes("device:registration"));
+	return Boolean(user.scope?.includes("device:register"));
 };
 
 //#endregion
@@ -2548,10 +2691,12 @@ const acknowledgeRecoveryCodes = async (client = require_InvalidParamError.getDe
 * one of their backup recovery codes when none of the registered MFA methods are available.
 *
 * @param params.code - The recovery code to authenticate with.
+* @param [params.createMfaTokenOptions] - @deprecated Use `requestedScopes` instead. Optional configuration for MFA token creation.
+* @param [params.requestedScopes] - Optional scopes to request an elevated access token instead of an MFA token.
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
-* @returns A promise that resolves to the MFA authentication response with token.
+* @returns A promise that resolves to the MFA authentication response.
 */
-const authenticateMfaRecoveryCode = async ({ code, createMfaTokenOptions }, client = require_InvalidParamError.getDefaultClient()) => {
+const authenticateMfaRecoveryCode = async ({ code, createMfaTokenOptions, requestedScopes }, client = require_InvalidParamError.getDefaultClient()) => {
 	const core = require_InvalidParamError.getCore(client);
 	const apiClient = require_InvalidParamError.createApiClient({}, client);
 	try {
@@ -2559,7 +2704,8 @@ const authenticateMfaRecoveryCode = async ({ code, createMfaTokenOptions }, clie
 			environmentId: core.environmentId,
 			mFAAuthRecoveryDevicePostRequest: {
 				code,
-				createMfaToken: createMfaTokenOptions
+				createMfaToken: createMfaTokenOptions,
+				requestedScopes
 			}
 		});
 		require_getVerifiedCredentialForWalletAccount.updateAuthFromVerifyResponse({ response }, client);
@@ -2589,13 +2735,14 @@ const getPasskeyAuthenticationOptions = async ({ relatedOriginRpId } = {}, clien
 
 //#endregion
 //#region src/modules/auth/passkeys/serverAuthenticatePasskey/serverAuthenticatePasskey.ts
-const serverAuthenticatePasskey = async ({ authentication, createMfaToken }, client) => {
+const serverAuthenticatePasskey = async ({ authentication, createMfaToken, requestedScopes }, client) => {
 	const core = require_InvalidParamError.getCore(client);
 	return await require_InvalidParamError.createApiClient({}, client).authenticateMfaPasskeyDevice({
 		environmentId: core.environmentId,
 		passkeyAuthRequest: {
 			...authentication,
 			createMfaToken,
+			requestedScopes,
 			response: {
 				...authentication.response,
 				clientDataJson: authentication.response.clientDataJSON
@@ -2612,13 +2759,14 @@ const serverAuthenticatePasskey = async ({ authentication, createMfaToken }, cli
 * This function prompts the user to authenticate with their registered
 * passkey to complete an MFA challenge and obtain an MFA token.
 *
-* @param [params.createMfaToken] - Optional configuration for MFA token creation.
+* @param [params.createMfaToken] - @deprecated Use `requestedScopes` instead. Optional configuration for MFA token creation.
+* @param [params.requestedScopes] - Optional scopes to request an elevated access token instead of an MFA token.
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns A promise that resolves to the MFA authentication response.
 * @throws NoWebAuthNSupportError If WebAuthn is not supported by the browser.
 * @throws NoPasskeyCredentialsFoundError If no passkey credentials are found.
 */
-const authenticatePasskeyMFA = async ({ createMfaToken, relatedOriginRpId } = {}, client = require_InvalidParamError.getDefaultClient()) => {
+const authenticatePasskeyMFA = async ({ createMfaToken, relatedOriginRpId, requestedScopes } = {}, client = require_InvalidParamError.getDefaultClient()) => {
 	const core = require_InvalidParamError.getCore(client);
 	try {
 		if (!core.passkey.isSupported()) throw new NoWebAuthNSupportError();
@@ -2634,7 +2782,8 @@ const authenticatePasskeyMFA = async ({ createMfaToken, relatedOriginRpId } = {}
 		};
 		const response = await serverAuthenticatePasskey({
 			authentication: await core.passkey.authenticate({ optionsJSON: formattedOptions }),
-			createMfaToken
+			createMfaToken,
+			requestedScopes
 		}, client);
 		require_getVerifiedCredentialForWalletAccount.updateAuthFromVerifyResponse({ response }, client);
 		require_getVerifiedCredentialForWalletAccount.emitEvent({
@@ -2661,11 +2810,12 @@ const authenticatePasskeyMFA = async ({ createMfaToken, relatedOriginRpId } = {}
 *
 * @param params.code - The 6-digit TOTP code from the authenticator app.
 * @param [params.deviceId] - The ID of the specific TOTP device to authenticate with.
-* @param [params.createMfaTokenOptions] - Optional configuration for MFA token creation.
+* @param [params.createMfaTokenOptions] - @deprecated Use `requestedScopes` instead. Optional configuration for MFA token creation.
+* @param [params.requestedScopes] - Optional scopes to request an elevated access token instead of an MFA token.
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns A promise that resolves to the MFA authentication response.
 */
-const authenticateTotpMfaDevice = async ({ deviceId, code, createMfaTokenOptions }, client = require_InvalidParamError.getDefaultClient()) => {
+const authenticateTotpMfaDevice = async ({ deviceId, code, createMfaTokenOptions, requestedScopes }, client = require_InvalidParamError.getDefaultClient()) => {
 	const core = require_InvalidParamError.getCore(client);
 	const apiClient = require_InvalidParamError.createApiClient({}, client);
 	try {
@@ -2674,7 +2824,8 @@ const authenticateTotpMfaDevice = async ({ deviceId, code, createMfaTokenOptions
 			mFAAuthTotpDevicePostRequest: {
 				code,
 				createMfaToken: createMfaTokenOptions,
-				id: deviceId
+				id: deviceId,
+				requestedScopes
 			}
 		});
 		require_getVerifiedCredentialForWalletAccount.updateAuthFromVerifyResponse({ response }, client);
@@ -4086,13 +4237,11 @@ const getChainIdForAccountVerification = async ({ walletProvider }) => {
 //#region src/modules/wallets/utils/getSignInMessage/getSignInMessage.ts
 const getSignInMessage = async ({ walletAccount }, client) => {
 	const core = require_InvalidParamError.getCore(client);
-	const apiClient = require_InvalidParamError.createApiClient({}, client);
 	const universalLink = core.metadata?.universalLink;
 	require_InvalidParamError.assertDefined(universalLink, "Universal link is not set");
 	const url = new URL(universalLink);
 	const domain = url.host;
-	const { nonce } = await apiClient.getNonce({ environmentId: core.environmentId });
-	require_InvalidParamError.assertDefined(nonce, "Failed to get nonce");
+	const nonce = await require_getNetworkProviderFromNetworkId.getNonce(client);
 	const walletProvider = require_getVerifiedCredentialForWalletAccount.getWalletProviderFromWalletAccount({ walletAccount }, client);
 	if (walletProvider.chain === "STARK")
  /**
@@ -4702,6 +4851,7 @@ const isIPad = (maxTouchPointsOverride) => {
 
 //#endregion
 exports.BaseError = require_InvalidParamError.BaseError;
+exports.CheckoutSessionTokenMissingError = CheckoutSessionTokenMissingError;
 exports.ClientAlreadyInitializedError = ClientAlreadyInitializedError;
 exports.FeeEstimationFailedError = FeeEstimationFailedError;
 exports.InvalidDeviceRegistrationRedirectError = InvalidDeviceRegistrationRedirectError;
@@ -4744,16 +4894,20 @@ exports.addCoinbaseOnrampOrderEventListener = addCoinbaseOnrampOrderEventListene
 exports.addNetwork = addNetwork;
 exports.assertWalletAccountSigningAvailability = assertWalletAccountSigningAvailability;
 exports.assertWalletProviderMethodDefined = assertWalletProviderMethodDefined;
+exports.attachCheckoutTransactionSource = attachCheckoutTransactionSource;
 exports.authenticateMfaRecoveryCode = authenticateMfaRecoveryCode;
 exports.authenticatePasskeyMFA = authenticatePasskeyMFA;
 exports.authenticateTotpMfaDevice = authenticateTotpMfaDevice;
 exports.authenticateWithSocial = authenticateWithSocial;
+exports.broadcastCheckoutTransaction = broadcastCheckoutTransaction;
 exports.canConnectWithHardwareWallet = canConnectWithHardwareWallet;
+exports.cancelCheckoutTransaction = cancelCheckoutTransaction;
 exports.completeDeviceRegistration = completeDeviceRegistration;
 exports.completeSocialAuthentication = completeSocialAuthentication;
 exports.connectAndVerifyWithWalletProvider = connectAndVerifyWithWalletProvider;
 exports.connectWithWalletProvider = connectWithWalletProvider;
 exports.consumeMfaToken = require_isMfaRequiredForAction.consumeMfaToken;
+exports.createCheckoutTransaction = createCheckoutTransaction;
 exports.createCoinbaseOnrampOrder = createCoinbaseOnrampOrder;
 exports.createCryptoDotComPayment = createCryptoDotComPayment;
 exports.createDynamicClient = createDynamicClient;
@@ -4770,6 +4924,8 @@ exports.getActiveNetworkId = getActiveNetworkId;
 exports.getAvailableWalletProvidersData = getAvailableWalletProvidersData;
 exports.getBalance = getBalance;
 exports.getBalanceForAddress = getBalanceForAddress;
+exports.getCheckoutTransaction = getCheckoutTransaction;
+exports.getCheckoutTransactionQuote = getCheckoutTransactionQuote;
 exports.getCoinbaseBuyUrl = getCoinbaseBuyUrl;
 exports.getConnectedAddresses = getConnectedAddresses;
 exports.getDefaultClient = require_InvalidParamError.getDefaultClient;
@@ -4813,6 +4969,7 @@ exports.offWalletProviderEvent = offWalletProviderEvent;
 exports.onEvent = require_getVerifiedCredentialForWalletAccount.onEvent;
 exports.onWalletProviderEvent = onWalletProviderEvent;
 exports.onceEvent = require_getVerifiedCredentialForWalletAccount.onceEvent;
+exports.prepareCheckoutTransaction = prepareCheckoutTransaction;
 exports.proveWalletAccountOwnership = proveWalletAccountOwnership;
 exports.refreshAuth = require_NotWaasWalletAccountError.refreshAuth;
 exports.refreshUser = refreshUser;