Merge pull request #1707 from multiversx/development

5.6.0

Author: arhtudormorar

CHANGELOG.md

@@ -7,6 +7,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [[5.6.0](https://github.com/multiversx/mx-sdk-dapp/pull/1707)] - 2026-01-13
+
+- [Added async `onCancelLogin` callback to UnlockPanelManager and made `onClose` callback async](https://github.com/multiversx/mx-sdk-dapp/pull/1706)
+
 ## [[5.5.2](https://github.com/multiversx/mx-sdk-dapp/pull/1704)] - 2026-01-13
 
 - [Added `selectProvider` method to UnlockPanelManager](https://github.com/multiversx/mx-sdk-dapp/pull/1703)

README.md

@@ -183,6 +183,9 @@ export const AdvancedConnectButton = () => {
       const { address, signature } = await provider.login();
       navigate(`/dashboard?address=${address}`);
     },
+    onCancelLogin: async () => { // optional action to be performed when the user cancels the login
+      navigate('/');
+    }
   });
   const handleOpenUnlockPanel = () => {
     unlockPanelManager.openUnlockPanel();

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@multiversx/sdk-dapp",
-  "version": "5.5.2",
+  "version": "5.6.0",
   "description": "A library to hold the main logic for a dapp on the MultiversX blockchain",
   "author": "MultiversX",
   "license": "MIT",

src/managers/UnlockPanelManager/UnlockPanelManager.ts

@@ -37,6 +37,7 @@ export class UnlockPanelManager extends SidePanelBaseManager<
   private static loginHandler: LoginHandlerType | null = null;
   private static onClose: OnCloseUnlockPanelType | null = null;
   private static allowedProviders?: ProviderType[] | null = null;
+  private static onCancelLogin?: (() => Promise<void>) | null = null;
 
   constructor() {
     super({
@@ -62,6 +63,10 @@ export class UnlockPanelManager extends SidePanelBaseManager<
       this.onClose = params.onClose;
     }
 
+    if (params.onCancelLogin) {
+      this.onCancelLogin = params.onCancelLogin;
+    }
+
     return this.getInstance();
   }
 
@@ -109,7 +114,7 @@ export class UnlockPanelManager extends SidePanelBaseManager<
     isLoginFinished?: boolean;
   }) => {
     if (!options?.isLoginFinished && UnlockPanelManager.onClose) {
-      UnlockPanelManager.onClose();
+      await UnlockPanelManager.onClose();
     }
 
     this.closeUI();
@@ -142,5 +147,8 @@ export class UnlockPanelManager extends SidePanelBaseManager<
 
   private readonly handleCancelLogin = async () => {
     await ProviderFactory.destroy();
+    if (UnlockPanelManager.onCancelLogin) {
+      await UnlockPanelManager.onCancelLogin();
+    }
   };
 }

src/managers/UnlockPanelManager/UnlockPanelManager.types.ts

@@ -24,7 +24,7 @@ export type LoginFunctonType = ({
 export type LoginCallbackType = () => void;
 
 export type LoginHandlerType = LoginFunctonType | LoginCallbackType;
-export type OnCloseUnlockPanelType = () => void;
+export type OnCloseUnlockPanelType = () => Promise<void>;
 
 export type UnlockPanelManagerInitParamsType = {
   /**
@@ -70,10 +70,20 @@ export type UnlockPanelManagerInitParamsType = {
    * 
    * @example
    * ```ts
-     onClose: () => {
+     onClose: async () => {
        navigate('/');
      }
    *  ```
    */
   onClose?: OnCloseUnlockPanelType;
+  /**
+   * Callback function to handle UI behavior when the login is cancelled
+   * @example
+   * ```ts
+   *  onCancelLogin: async () => {
+   *    navigate('/');
+   *  }
+   *  ```
+   */
+  onCancelLogin?: () => Promise<void>;
 };

src/managers/UnlockPanelManager/tests/UnlockPanelManager.test.ts

@@ -43,7 +43,7 @@ describe('UnlockPanelManager tests', () => {
       loginHandler: () => {
         navigete();
       },
-      onClose: () => {
+      onClose: async () => {
         onClose();
       }
     });