@hsuite/native-connect-angular 1.0.0 → 2.1.0

package/dist/index.d.ts

@@ -2021,6 +2021,12 @@ declare class WalletConnectButtonComponent {
      * Wallet URL for targeting the wallet window
      */
     walletUrl: string;
+    /**
+     * Pins the connection network and hides the network-selection step in the
+     * modal. When set to `'mainnet'` or `'testnet'`, the dApp decides the network
+     * and the user never sees the picker. When omitted, the user chooses.
+     */
+    network?: 'mainnet' | 'testnet';
     /**
      * Whether to show session information when connected
      * @default true
@@ -2104,7 +2110,7 @@ declare class WalletConnectButtonComponent {
      */
     getConnectedAccounts(): any[];
     static ɵfac: i0.ɵɵFactoryDeclaration<WalletConnectButtonComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<WalletConnectButtonComponent, "wallet-connect-button", never, { "walletConnectProjectId": { "alias": "walletConnectProjectId"; "required": false; }; "appName": { "alias": "appName"; "required": false; }; "appDescription": { "alias": "appDescription"; "required": false; }; "walletUrl": { "alias": "walletUrl"; "required": false; }; "showSessionInfo": { "alias": "showSessionInfo"; "required": false; }; "buttonColor": { "alias": "buttonColor"; "required": false; }; "size": { "alias": "size"; "required": false; }; "connectText": { "alias": "connectText"; "required": false; }; "connectedText": { "alias": "connectedText"; "required": false; }; "multiSessionMode": { "alias": "multiSessionMode"; "required": false; }; }, { "connected": "connected"; "disconnected": "disconnected"; "error": "error"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<WalletConnectButtonComponent, "wallet-connect-button", never, { "walletConnectProjectId": { "alias": "walletConnectProjectId"; "required": false; }; "appName": { "alias": "appName"; "required": false; }; "appDescription": { "alias": "appDescription"; "required": false; }; "walletUrl": { "alias": "walletUrl"; "required": false; }; "network": { "alias": "network"; "required": false; }; "showSessionInfo": { "alias": "showSessionInfo"; "required": false; }; "buttonColor": { "alias": "buttonColor"; "required": false; }; "size": { "alias": "size"; "required": false; }; "connectText": { "alias": "connectText"; "required": false; }; "connectedText": { "alias": "connectedText"; "required": false; }; "multiSessionMode": { "alias": "multiSessionMode"; "required": false; }; }, { "connected": "connected"; "disconnected": "disconnected"; "error": "error"; }, never, never, true, never>;
 }
 
 /**
@@ -3298,13 +3304,22 @@ interface StepConfig {
  * Main wallet connection modal component.
  * Orchestrates the multi-step connection flow.
  */
-declare class WalletConnectionModalComponent {
+declare class WalletConnectionModalComponent implements OnInit {
     private modalController;
     private unifiedWalletService;
     /**
      * WalletConnect project ID (required for WalletConnect)
      */
     projectId?: string;
+    /**
+     * Pins the connection network and hides the network-selection step.
+     *
+     * When set to `'mainnet'` or `'testnet'`, the host dApp decides the network
+     * and the user is never shown the network picker — the modal opens directly
+     * on protocol selection. When omitted (default), the user chooses the network
+     * as the first step.
+     */
+    network?: 'mainnet' | 'testnet';
     /**
      * App name for WalletConnect metadata
      */
@@ -3372,12 +3387,27 @@ declare class WalletConnectionModalComponent {
      * Different protocol paths have different step mappings.
      */
     readonly displayStep: i0.Signal<number>;
+    /**
+     * Whether a back affordance should be offered for the current step.
+     * The first reachable step has no back target — that is protocol selection
+     * when the network is pinned, otherwise network selection. The connection
+     * progress step manages its own retry navigation instead.
+     */
+    readonly canGoBack: i0.Signal<boolean>;
     /**
      *
      * @param modalController
      * @param unifiedWalletService
      */
     constructor(modalController: ModalController$1, unifiedWalletService: UnifiedWalletService);
+    /**
+     * Apply the pinned network (if any) before the first render.
+     *
+     * When the host dApp provides a {@link network}, lock the selection to it and
+     * skip straight to protocol selection so the user never sees — and cannot
+     * change — the network. With no input, the modal opens on network selection.
+     */
+    ngOnInit(): void;
     /**
      * Select a network option (internal, use selectNetworkAndProceed for UI)
      * @param networkId
@@ -3476,7 +3506,7 @@ declare class WalletConnectionModalComponent {
      */
     private detectExtension;
     static ɵfac: i0.ɵɵFactoryDeclaration<WalletConnectionModalComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<WalletConnectionModalComponent, "hsuite-wallet-connection-modal", never, { "projectId": { "alias": "projectId"; "required": false; }; "appName": { "alias": "appName"; "required": false; }; "appDescription": { "alias": "appDescription"; "required": false; }; "walletUrl": { "alias": "walletUrl"; "required": false; }; }, { "connected": "connected"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<WalletConnectionModalComponent, "hsuite-wallet-connection-modal", never, { "projectId": { "alias": "projectId"; "required": false; }; "network": { "alias": "network"; "required": false; }; "appName": { "alias": "appName"; "required": false; }; "appDescription": { "alias": "appDescription"; "required": false; }; "walletUrl": { "alias": "walletUrl"; "required": false; }; }, { "connected": "connected"; }, never, never, true, never>;
 }
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hsuite/native-connect-angular",
-  "version": "1.0.0",
+  "version": "2.1.0",
   "license": "PolyForm-Noncommercial-1.0.0",
   "description": "Angular integration SDK for HSuite Wallet - provides direct SDK integration without wrappers",
   "type": "module",
@@ -23,9 +23,9 @@
   "dependencies": {
     "@hashgraph/proto": "^2.25.0",
     "@hashgraph/sdk": "^2.76.0",
-    "@hsuite/native-connect-sdk": "^1.0.0",
-    "@hsuite/native-connect-types": "^1.0.0",
-    "@hsuite/native-connect-ui": "^1.0.0",
+    "@hsuite/native-connect-sdk": "^2.1.0",
+    "@hsuite/native-connect-types": "^2.1.0",
+    "@hsuite/native-connect-ui": "^2.1.0",
     "@walletconnect/modal": "^2.7.0",
     "@walletconnect/sign-client": "^2.23.0",
     "@walletconnect/types": "^2.23.0",

package/src/lib/components/wallet-connect-button/wallet-connect-button.component.spec.ts

@@ -0,0 +1,89 @@
+/**
+ * HSuite Native Connect
+ * Copyright 2024-2025 HSuite (https://hsuite.finance)
+ *
+ * SPDX-License-Identifier: PolyForm-Noncommercial-1.0.0
+ *
+ * This file is part of HSuite Native Connect. For commercial licensing,
+ * visit https://hsuite.finance/licensing
+ */
+
+/**
+ * @fileoverview Unit tests for WalletConnectButtonComponent.
+ *
+ * Focused on threading the `network` pinning input through to the connection
+ * modal, so the convenience button exposes the same capability as opening the
+ * modal directly.
+ */
+
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+import { TestBed } from '@angular/core/testing';
+import { ModalController } from '@ionic/angular/standalone';
+
+// Mock the logger so the SDK does not need real configuration during tests.
+vi.mock('@hsuite/native-connect-sdk', () => ({
+  getLogger: vi.fn(() => ({
+    debug: vi.fn(),
+    info: vi.fn(),
+    warn: vi.fn(),
+    error: vi.fn(),
+    scoped: vi.fn(() => ({
+      debug: vi.fn(),
+      info: vi.fn(),
+      warn: vi.fn(),
+      error: vi.fn(),
+    })),
+  })),
+}));
+
+import { UnifiedWalletService } from '../../services/unified-wallet.service';
+
+import { WalletConnectButtonComponent } from './wallet-connect-button.component';
+
+describe('WalletConnectButtonComponent — network pinning', () => {
+  let component: WalletConnectButtonComponent;
+  let modalController: { create: ReturnType<typeof vi.fn> };
+  let modal: { present: ReturnType<typeof vi.fn>; onDidDismiss: ReturnType<typeof vi.fn> };
+
+  beforeEach(() => {
+    modal = {
+      present: vi.fn().mockResolvedValue(undefined),
+      onDidDismiss: vi.fn().mockResolvedValue({ data: { connected: false } }),
+    };
+    modalController = { create: vi.fn().mockResolvedValue(modal) };
+    const wallet = {
+      allAccounts: vi.fn().mockReturnValue([]),
+      isAnyConnected: vi.fn().mockReturnValue(false),
+    };
+
+    TestBed.configureTestingModule({
+      providers: [
+        { provide: ModalController, useValue: modalController },
+        { provide: UnifiedWalletService, useValue: wallet },
+      ],
+    });
+
+    component = TestBed.runInInjectionContext(() => new WalletConnectButtonComponent());
+  });
+
+  it('forwards the pinned network to the connection modal', async () => {
+    component.network = 'mainnet';
+
+    await component.connect();
+
+    expect(modalController.create).toHaveBeenCalledWith(
+      expect.objectContaining({
+        componentProps: expect.objectContaining({ network: 'mainnet' }),
+      }),
+    );
+  });
+
+  it('passes no network by default so the user chooses it', async () => {
+    await component.connect();
+
+    const props = (
+      modalController.create.mock.calls[0][0] as { componentProps: { network?: string } }
+    ).componentProps;
+    expect(props.network).toBeUndefined();
+  });
+});

package/src/lib/components/wallet-connect-button/wallet-connect-button.component.ts

@@ -69,6 +69,13 @@ export class WalletConnectButtonComponent {
    */
   @Input() walletUrl = DEFAULT_WALLET_URL;
 
+  /**
+   * Pins the connection network and hides the network-selection step in the
+   * modal. When set to `'mainnet'` or `'testnet'`, the dApp decides the network
+   * and the user never sees the picker. When omitted, the user chooses.
+   */
+  @Input() network?: 'mainnet' | 'testnet';
+
   /**
    * Whether to show session information when connected
    * @default true
@@ -160,6 +167,7 @@ export class WalletConnectButtonComponent {
         appName: this.appName,
         appDescription: this.appDescription,
         walletUrl: this.walletUrl,
+        network: this.network,
       },
     });
 

package/src/lib/components/wallet-connection-modal/wallet-connection-modal.component.html

@@ -2,12 +2,7 @@
   <div class="modal-inner-content wallet-connection-modal">
     <div class="header">
       <div class="title">
-        <ion-button
-          *ngIf="currentStep() > 1 && currentStep() !== ConnectionStep.ConnectionProgress"
-          (click)="back()"
-          fill="clear"
-          class="back-btn"
-        >
+        <ion-button *ngIf="canGoBack()" (click)="back()" fill="clear" class="back-btn">
           <ion-icon slot="icon-only" name="arrow-back-outline"></ion-icon>
         </ion-button>
         <p>{{ stepTitle() }}</p>

package/src/lib/components/wallet-connection-modal/wallet-connection-modal.component.spec.ts

@@ -0,0 +1,173 @@
+/**
+ * HSuite Native Connect
+ * Copyright 2024-2025 HSuite (https://hsuite.finance)
+ *
+ * SPDX-License-Identifier: PolyForm-Noncommercial-1.0.0
+ *
+ * This file is part of HSuite Native Connect. For commercial licensing,
+ * visit https://hsuite.finance/licensing
+ */
+
+/**
+ * @fileoverview Unit tests for WalletConnectionModalComponent.
+ *
+ * Focused on the `network` pinning capability: a host dApp can fix the
+ * connection network ('mainnet' | 'testnet') so the user is never shown the
+ * network-selection step. When the input is absent the modal behaves exactly
+ * as before (user picks the network as step 1).
+ */
+
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+import { TestBed } from '@angular/core/testing';
+import { ModalController, Platform } from '@ionic/angular';
+
+// Mock the logger so the SDK does not need real configuration during tests.
+vi.mock('@hsuite/native-connect-sdk', () => ({
+  getLogger: vi.fn(() => ({
+    debug: vi.fn(),
+    info: vi.fn(),
+    warn: vi.fn(),
+    error: vi.fn(),
+    scoped: vi.fn(() => ({
+      debug: vi.fn(),
+      info: vi.fn(),
+      warn: vi.fn(),
+      error: vi.fn(),
+    })),
+  })),
+}));
+
+import { P2PNativeProvider } from '../../providers/p2p-native/p2p-native.provider';
+import { UnifiedWalletService } from '../../services/unified-wallet.service';
+
+import { WalletConnectionModalComponent } from './wallet-connection-modal.component';
+
+/** ConnectionStep display values mirrored from the component (1-based). */
+const NETWORK_SELECTION_STEP = 1;
+const PROTOCOL_SELECTION_STEP = 2;
+
+describe('WalletConnectionModalComponent — network pinning', () => {
+  let component: WalletConnectionModalComponent;
+  let modalController: { dismiss: ReturnType<typeof vi.fn>; create: ReturnType<typeof vi.fn> };
+  let unifiedWalletService: { connect: ReturnType<typeof vi.fn> };
+
+  beforeEach(() => {
+    modalController = {
+      dismiss: vi.fn().mockResolvedValue(undefined),
+      create: vi.fn(),
+    };
+    unifiedWalletService = {
+      connect: vi.fn().mockResolvedValue(undefined),
+    };
+    const platform = { is: vi.fn().mockReturnValue(false) };
+    const p2pNativeProvider = {
+      onPeerConnected: vi.fn(),
+      createPairingOffer: vi.fn(),
+      waitForSessionApproval: vi.fn(),
+    };
+
+    TestBed.configureTestingModule({
+      providers: [
+        { provide: Platform, useValue: platform },
+        { provide: P2PNativeProvider, useValue: p2pNativeProvider },
+      ],
+    });
+
+    // Construct directly inside an injection context so the component's
+    // `inject(Platform)` / `inject(P2PNativeProvider)` field initializers
+    // resolve, without compiling the external template/styles (this package
+    // has no Angular template-resolving test plugin configured).
+    component = TestBed.runInInjectionContext(
+      () =>
+        new WalletConnectionModalComponent(
+          modalController as unknown as ModalController,
+          unifiedWalletService as unknown as UnifiedWalletService,
+        ),
+    );
+  });
+
+  describe('default behavior (no network input)', () => {
+    it('starts on the network-selection step so the user chooses the network', () => {
+      component.ngOnInit();
+
+      expect(component.currentStep()).toBe(NETWORK_SELECTION_STEP);
+      expect(component.selectedNetwork()).toBe('testnet');
+    });
+
+    it('allows going back from protocol selection to network selection', () => {
+      component.ngOnInit();
+      // Advance from network selection to protocol selection the way the UI does.
+      component.selectNetworkAndProceed('testnet');
+      expect(component.currentStep()).toBe(PROTOCOL_SELECTION_STEP);
+
+      component.back();
+
+      expect(component.currentStep()).toBe(NETWORK_SELECTION_STEP);
+    });
+
+    it('keeps "Network" as the first step in the progress indicator', () => {
+      component.ngOnInit();
+      component.selectProtocol('hsuite-native');
+      component.selectConnectionMethod('desktop');
+
+      expect(component.stepConfig().labels).toEqual(['Network', 'Protocol', 'Method']);
+      expect(component.stepConfig().total).toBe(3);
+    });
+  });
+
+  describe('pinned network (network = "mainnet")', () => {
+    beforeEach(() => {
+      component.network = 'mainnet';
+      component.ngOnInit();
+    });
+
+    it('skips the network-selection step and starts on protocol selection', () => {
+      expect(component.currentStep()).toBe(PROTOCOL_SELECTION_STEP);
+    });
+
+    it('pins the selected network to the provided value', () => {
+      expect(component.selectedNetwork()).toBe('mainnet');
+    });
+
+    it('does not allow navigating back to the network-selection step', () => {
+      component.back();
+
+      expect(component.currentStep()).toBe(PROTOCOL_SELECTION_STEP);
+    });
+
+    it('hides the back affordance on the first reachable step', () => {
+      expect(component.canGoBack()).toBe(false);
+    });
+
+    it('drops "Network" from the progress indicator and renumbers', () => {
+      component.selectProtocol('hsuite-native');
+      component.selectConnectionMethod('desktop');
+
+      expect(component.stepConfig().labels).toEqual(['Protocol', 'Method']);
+      expect(component.stepConfig().total).toBe(2);
+      expect(component.displayStep()).toBe(1);
+    });
+
+    it('forwards the pinned network to the SDK connect call', async () => {
+      component.selectProtocolAndProceed('hsuite-native');
+      component.selectConnectionMethod('desktop');
+
+      await component.next();
+
+      expect(unifiedWalletService.connect).toHaveBeenCalledWith(
+        'hsuite-native',
+        expect.objectContaining({ networkId: 'mainnet' }),
+      );
+    });
+  });
+
+  describe('pinned network (network = "testnet")', () => {
+    it('skips selection and pins testnet', () => {
+      component.network = 'testnet';
+      component.ngOnInit();
+
+      expect(component.currentStep()).toBe(PROTOCOL_SELECTION_STEP);
+      expect(component.selectedNetwork()).toBe('testnet');
+    });
+  });
+});

package/src/lib/components/wallet-connection-modal/wallet-connection-modal.component.ts

@@ -22,7 +22,16 @@
  */
 
 import { CommonModule } from '@angular/common';
-import { Component, Input, Output, EventEmitter, signal, computed, inject } from '@angular/core';
+import {
+  Component,
+  Input,
+  Output,
+  EventEmitter,
+  OnInit,
+  signal,
+  computed,
+  inject,
+} from '@angular/core';
 import { getLogger } from '@hsuite/native-connect-sdk';
 import { IonicModule, ModalController, Platform } from '@ionic/angular';
 
@@ -112,12 +121,22 @@ interface StepConfig {
   templateUrl: './wallet-connection-modal.component.html',
   styleUrls: ['./wallet-connection-modal.component.scss'],
 })
-export class WalletConnectionModalComponent {
+export class WalletConnectionModalComponent implements OnInit {
   /**
    * WalletConnect project ID (required for WalletConnect)
    */
   @Input() projectId?: string;
 
+  /**
+   * Pins the connection network and hides the network-selection step.
+   *
+   * When set to `'mainnet'` or `'testnet'`, the host dApp decides the network
+   * and the user is never shown the network picker — the modal opens directly
+   * on protocol selection. When omitted (default), the user chooses the network
+   * as the first step.
+   */
+  @Input() network?: 'mainnet' | 'testnet';
+
   /**
    * App name for WalletConnect metadata
    */
@@ -325,23 +344,30 @@ export class WalletConnectionModalComponent {
     const protocol = this.selectedProtocol();
     const method = this.selectedConnectionMethod();
 
+    let base: StepConfig;
+
     // Initial state: show 3 placeholder steps until protocol is selected
     if (!protocol) {
-      return { total: 3, labels: ['Network', 'Protocol', '...'] };
+      base = { total: 3, labels: ['Network', 'Protocol', '...'] };
+    } else if (protocol === 'hsuite-native') {
+      // HSuite Native path
+      base =
+        method === 'mobile-qr'
+          ? // Mobile QR needs 4 steps
+            { total: 4, labels: ['Network', 'Protocol', 'Method', 'Pair'] }
+          : // Desktop connects immediately after method selection (3 steps)
+            { total: 3, labels: ['Network', 'Protocol', 'Method'] };
+    } else {
+      // WalletConnect path: 4 steps
+      base = { total: 4, labels: ['Network', 'Protocol', 'Ledger', 'Connect'] };
     }
 
-    // HSuite Native path
-    if (protocol === 'hsuite-native') {
-      // If mobile QR is selected, we need 4 steps
-      if (method === 'mobile-qr') {
-        return { total: 4, labels: ['Network', 'Protocol', 'Method', 'Pair'] };
-      }
-      // Desktop connection is 3 steps (connects immediately after method selection)
-      return { total: 3, labels: ['Network', 'Protocol', 'Method'] };
+    // When the network is pinned by the host dApp the network step is never
+    // shown — drop it from the indicator so the numbering stays accurate.
+    if (this.network) {
+      return { total: base.total - 1, labels: base.labels.slice(1) };
     }
-
-    // WalletConnect path: 4 steps
-    return { total: 4, labels: ['Network', 'Protocol', 'Ledger', 'Connect'] };
+    return base;
   });
 
   /**
@@ -353,20 +379,24 @@ export class WalletConnectionModalComponent {
     // Protocol could be used for protocol-specific step mapping in the future
     const _protocol = this.selectedProtocol();
 
+    // When the network is pinned the network step is removed, so every
+    // subsequent step shifts down one position in the indicator.
+    const networkOffset = this.network ? 1 : 0;
+
     // Map internal step to display position based on protocol path
     switch (step) {
       case ConnectionStep.NetworkSelection:
         return 1;
       case ConnectionStep.ProtocolSelection:
-        return 2;
+        return 2 - networkOffset;
       case ConnectionStep.ConnectionMethodSelection:
-        return 3;
+        return 3 - networkOffset;
       case ConnectionStep.LedgerSelection:
         // WalletConnect ledger selection is step 3
-        return 3;
+        return 3 - networkOffset;
       case ConnectionStep.QrPairing:
         // QR pairing is step 4 for both paths that use it
-        return 4;
+        return 4 - networkOffset;
       case ConnectionStep.ConnectionProgress:
         // Connection progress is always the last step
         return this.stepConfig().total;
@@ -375,6 +405,23 @@ export class WalletConnectionModalComponent {
     }
   });
 
+  /**
+   * Whether a back affordance should be offered for the current step.
+   * The first reachable step has no back target — that is protocol selection
+   * when the network is pinned, otherwise network selection. The connection
+   * progress step manages its own retry navigation instead.
+   */
+  readonly canGoBack = computed<boolean>(() => {
+    const step = this.currentStep();
+    if (step === ConnectionStep.ConnectionProgress) {
+      return false;
+    }
+    const firstStep = this.network
+      ? ConnectionStep.ProtocolSelection
+      : ConnectionStep.NetworkSelection;
+    return step > firstStep;
+  });
+
   /**
    *
    * @param modalController
@@ -390,6 +437,20 @@ export class WalletConnectionModalComponent {
     });
   }
 
+  /**
+   * Apply the pinned network (if any) before the first render.
+   *
+   * When the host dApp provides a {@link network}, lock the selection to it and
+   * skip straight to protocol selection so the user never sees — and cannot
+   * change — the network. With no input, the modal opens on network selection.
+   */
+  ngOnInit(): void {
+    if (this.network) {
+      this.selectedNetwork.set(this.network);
+      this.currentStep.set(ConnectionStep.ProtocolSelection);
+    }
+  }
+
   /**
    * Select a network option (internal, use selectNetworkAndProceed for UI)
    * @param networkId
@@ -510,7 +571,11 @@ export class WalletConnectionModalComponent {
   back(): void {
     const currentStep = this.currentStep();
     if (currentStep === ConnectionStep.ProtocolSelection) {
-      this.currentStep.set(ConnectionStep.NetworkSelection);
+      // When the network is pinned, protocol selection is the first reachable
+      // step — there is no network step to return to.
+      if (!this.network) {
+        this.currentStep.set(ConnectionStep.NetworkSelection);
+      }
     } else if (currentStep === ConnectionStep.ConnectionMethodSelection) {
       this.currentStep.set(ConnectionStep.ProtocolSelection);
     } else if (currentStep === ConnectionStep.LedgerSelection) {

package/src/lib/services/transaction.service.ts

@@ -57,7 +57,6 @@ import type { SignResult, SubmitResult } from '../providers/base-wallet-provider
 import { UnifiedWalletService } from './unified-wallet.service';
 import { WalletEventBus } from './wallet-event-bus.service';
 
-
 const logger = getLogger().scoped?.('TransactionService') ?? getLogger();
 
 /**

package/src/lib/services/unified-wallet.service.ts

@@ -56,7 +56,6 @@ import { WalletConnectV2Provider } from '../providers/walletconnect/core/walletc
 
 import { WalletEventBus } from './wallet-event-bus.service';
 
-
 const logger = getLogger().scoped?.('UnifiedWalletService') ?? getLogger();
 
 interface ProviderSummary {

package/src/lib/services/wallet-providers.service.ts

@@ -44,7 +44,6 @@ import { WalletConnectV2Provider } from '../providers/walletconnect/core/walletc
 
 import { UnifiedWalletService } from './unified-wallet.service';
 
-
 const logger = getLogger().scoped?.('WalletProvidersService') ?? getLogger();
 
 /**