@hsuite/native-connect-angular 2.1.0 → 2.1.1

package/src/index.ts

@@ -78,12 +78,28 @@ export { WalletEventBus } from './lib/services/wallet-event-bus.service';
 export { WalletContextService } from './lib/services/wallet-context.service';
 export { TransactionService } from './lib/services/transaction.service';
 export { LoggerService } from './lib/services/logger.service';
+export {
+  SmartSessionService,
+  SMART_SESSION_CONFIG,
+  type SmartSessionConfig,
+  type SmartHostHealth,
+  type SmartHostChallenge,
+  type SmartHostVerifyRequest,
+  type SmartHostVerifyResponse,
+} from './lib/services/smart-session.service';
+export {
+  HsuiteAuthInterceptor,
+  hsuiteAuthInterceptor,
+  HSUITE_AUTH_HEADER,
+  HSUITE_LEDGER_HEADER,
+} from './lib/services/hsuite-auth.interceptor';
 
 // Transaction Builders (for dApps to construct transactions)
 export {
   HederaTransactionBuilderService,
   XrplTransactionBuilderService,
   scaleHederaAmountToBaseUnits,
+  ACTIVE_ACCOUNT_SOURCE,
 } from './lib/services/transaction-builders';
 
 // Transaction builder types (for dApps)
@@ -94,6 +110,7 @@ export type {
   TopicCreateOptions,
   TokenCreateOptions,
   AccountCreateOptions,
+  ActiveAccountSource,
 } from './lib/services/transaction-builders';
 
 // Transports
@@ -200,4 +217,13 @@ export {
   DEFAULT_LEDGER_ICONS,
   LEDGER_COLORS,
   LEDGER_NAMES,
+  LEDGER_ICON_NAMES,
+  registerLedgerIcons,
 } from './lib/utils';
+// Registry-driven ledger presentation (open/extensible; the single source of
+// truth the helpers above derive from).
+export { LedgerUIRegistry } from './lib/utils';
+export type { LedgerUiDescriptor } from './lib/utils';
+// Canonical, open ledger identity — re-exported from the shared types package so
+// consumers get the single source of truth, not a narrowing local duplicate.
+export type { LedgerId } from '@hsuite/native-connect-types';

package/src/lib/components/account-selector/account-formatting.service.ts

@@ -18,6 +18,8 @@
 
 import { Injectable } from '@angular/core';
 
+import { LedgerUIRegistry } from '../../utils/ledger-ui-registry';
+
 /**
  * Account formatting service.
  *
@@ -46,11 +48,11 @@ export class AccountFormattingService {
    * @returns Display name
    */
   getLedgerName(ledgerId: string): string {
-    const names: Record<string, string> = {
-      hedera: 'Hedera',
-      xrpl: 'XRPL',
-    };
-    return names[ledgerId?.toLowerCase()] || ledgerId?.toUpperCase() || 'Unknown';
+    return (
+      LedgerUIRegistry.get(ledgerId?.toLowerCase())?.shortName ||
+      ledgerId?.toUpperCase() ||
+      'Unknown'
+    );
   }
 
   /**
@@ -60,11 +62,7 @@ export class AccountFormattingService {
    * @returns Ionic color name
    */
   getLedgerColor(ledgerId: string): string {
-    const colors: Record<string, string> = {
-      hedera: 'success',
-      xrpl: 'tertiary',
-    };
-    return colors[ledgerId?.toLowerCase()] || 'medium';
+    return LedgerUIRegistry.get(ledgerId?.toLowerCase())?.badgeColor || 'medium';
   }
 
   /**

package/src/lib/components/wallet-account-display/wallet-account-display.component.ts

@@ -16,12 +16,14 @@
  * and responsive styling. Eliminates repetitive account display boilerplate.
  */
 
-import { Component, Input, computed, inject } from '@angular/core';
 import { CommonModule } from '@angular/common';
+import { Component, Input, computed, inject } from '@angular/core';
 import { IonText, IonBadge, IonIcon } from '@ionic/angular/standalone';
 import { addIcons } from 'ionicons';
 import { walletOutline, personOutline, peopleOutline } from 'ionicons/icons';
+
 import { WalletContextService } from '../../services/wallet-context.service';
+import { LedgerUIRegistry } from '../../utils/ledger-ui-registry';
 
 /**
  * Pre-built component for displaying active account
@@ -112,26 +114,24 @@ export class WalletAccountDisplayComponent {
     return null;
   });
 
+  /**
+   *
+   */
   constructor() {
     addIcons({ walletOutline, personOutline, peopleOutline });
   }
 
   /**
    * Get color for ledger badge
+   * @param ledgerId
    */
   protected getLedgerColor(ledgerId: string): string {
-    switch (ledgerId.toLowerCase()) {
-      case 'hedera':
-        return 'success';
-      case 'xrpl':
-        return 'tertiary';
-      default:
-        return 'primary';
-    }
+    return LedgerUIRegistry.get(ledgerId.toLowerCase())?.badgeColor ?? 'primary';
   }
 
   /**
    * Format network ID for display
+   * @param networkId
    */
   protected formatNetwork(networkId: string): string {
     const parts = networkId.split(':');

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

@@ -33,12 +33,15 @@ import {
   inject,
 } from '@angular/core';
 import { getLogger } from '@hsuite/native-connect-sdk';
+import type { SupportedLedger } from '@hsuite/native-connect-sdk';
 import { IonicModule, ModalController, Platform } from '@ionic/angular';
 
 import type { WalletConnectV2Config } from '../../models/provider-types';
 import { DEFAULT_WALLET_URL } from '../../models/provider-types';
 import { P2PNativeProvider } from '../../providers/p2p-native/p2p-native.provider';
 import { UnifiedWalletService } from '../../services/unified-wallet.service';
+import { registerLedgerIcons } from '../../utils/ledger-icons.util';
+import { LedgerUIRegistry } from '../../utils/ledger-ui-registry';
 
 import {
   ConnectionMethodStepComponent,
@@ -93,12 +96,25 @@ interface ProtocolOption {
  * Ledger configuration options
  */
 interface LedgerOption {
-  id: 'hedera' | 'xrpl';
+  id: SupportedLedger;
   name: string;
   description: string;
   icon: string;
 }
 
+/**
+ * Per-ledger copy for the WalletConnect "Choose Blockchain" step.
+ *
+ * Keyed by {@link SupportedLedger} (the closed set of ledgers the WalletConnect
+ * provider brokers) via `satisfies`, so widening that union forces a description
+ * here. Display name and icon come from {@link LedgerUIRegistry}; this map holds
+ * only the connection-flow copy specific to this surface.
+ */
+const LEDGER_DESCRIPTIONS = {
+  hedera: 'Hedera Hashgraph network',
+  xrpl: 'XRP Ledger network',
+} satisfies Record<SupportedLedger, string>;
+
 /**
  * Step configuration for dynamic step indicator.
  * Defines the total steps and labels based on selected protocol path.
@@ -170,7 +186,7 @@ export class WalletConnectionModalComponent implements OnInit {
   readonly selectedNetwork = signal<string>('testnet');
   readonly selectedProtocol = signal<'hsuite-native' | 'walletconnect' | null>(null);
   readonly selectedConnectionMethod = signal<ConnectionMethod | null>(null);
-  readonly selectedLedger = signal<'hedera' | 'xrpl' | null>(null);
+  readonly selectedLedger = signal<SupportedLedger | null>(null);
 
   // Loading state
   readonly isConnecting = signal<boolean>(false);
@@ -247,20 +263,17 @@ export class WalletConnectionModalComponent implements OnInit {
     return options;
   });
 
-  readonly ledgerOptions: LedgerOption[] = [
-    {
-      id: 'hedera',
-      name: 'Hedera',
-      description: 'Hedera Hashgraph network',
-      icon: 'logo-bitcoin', // Placeholder, use actual Hedera icon
-    },
-    {
-      id: 'xrpl',
-      name: 'XRP Ledger',
-      description: 'XRP Ledger network',
-      icon: 'logo-usd', // Placeholder, use actual XRPL icon
-    },
-  ];
+  readonly ledgerOptions: LedgerOption[] = (
+    Object.keys(LEDGER_DESCRIPTIONS) as SupportedLedger[]
+  ).map((id) => {
+    const ui = LedgerUIRegistry.get(id);
+    return {
+      id,
+      name: ui?.displayName ?? id,
+      description: LEDGER_DESCRIPTIONS[id],
+      icon: ui?.iconName ?? '',
+    };
+  });
 
   /**
    * Connection method options for HSuite Native.
@@ -435,6 +448,9 @@ export class WalletConnectionModalComponent implements OnInit {
     this.p2pNativeProvider.onPeerConnected(() => {
       this.onMobileConnected();
     });
+
+    // Register the shared ledger brand logos so <ion-icon> can resolve them by name.
+    registerLedgerIcons();
   }
 
   /**
@@ -518,7 +534,7 @@ export class WalletConnectionModalComponent implements OnInit {
    * Select a ledger option (internal, use selectLedgerAndConnect for UI)
    * @param ledgerId
    */
-  selectLedger(ledgerId: 'hedera' | 'xrpl'): void {
+  selectLedger(ledgerId: SupportedLedger): void {
     this.selectedLedger.set(ledgerId);
   }
 
@@ -527,7 +543,7 @@ export class WalletConnectionModalComponent implements OnInit {
    * This enables direct selection behavior for WalletConnect ledger step.
    * @param ledgerId - The ledger ID to select ('hedera' or 'xrpl')
    */
-  selectLedgerAndConnect(ledgerId: 'hedera' | 'xrpl'): void {
+  selectLedgerAndConnect(ledgerId: SupportedLedger): void {
     this.selectedLedger.set(ledgerId);
     // Auto-connect with the selected ledger
     void this.connect();

package/src/lib/models/provider-types.ts

@@ -20,6 +20,8 @@
  * ```
  */
 
+import type { SupportedLedger } from '@hsuite/native-connect-sdk';
+
 /**
  * Supported wallet connection protocol types.
  *
@@ -129,7 +131,7 @@ export interface HsuiteNativeConfig {
 export interface WalletConnectV2Config {
   type: 'walletconnect-v2';
   projectId: string; // WalletConnect Cloud project ID - REQUIRED
-  ledgerId: 'hedera' | 'xrpl'; // Which ledger to connect to
+  ledgerId: SupportedLedger; // Which ledger to connect to
   networkId: string; // e.g., 'hedera:testnet' or 'xrpl:testnet'
   appName?: string;
   appDescription?: string;

package/src/lib/models/unified-account.model.ts

@@ -9,7 +9,7 @@
  */
 
 /**
- * @fileoverview Unified account model that works across all wallet providers.
+ * @file Unified account model that works across all wallet providers.
  *
  * @module models/unified-account
  *
@@ -45,6 +45,9 @@ export interface UnifiedAccount {
   /** Account address/public key */
   address: string;
 
+  /** Public key associated with the account, when available from the provider. */
+  publicKey?: string;
+
   /** Human-readable label */
   label?: string;
 

package/src/lib/providers/hsuite-native/channel-client.service.ts

@@ -170,6 +170,7 @@ export class ChannelClientService {
       return {
         id: `channel-${account.address}`,
         address: account.address,
+        publicKey: account.publicKey,
         label: account.alias ?? `Account ${index + 1}`,
         ledgerId: account.ledgerId,
         networkId: account.networkId,

package/src/lib/providers/p2p-native/p2p-session-manager.ts

@@ -587,6 +587,7 @@ export class P2PSessionManager {
       accounts: accounts.map((acc, index) => ({
         id: `p2p-${acc.address}`,
         address: acc.address,
+        publicKey: acc.publicKey,
         label: acc.alias || `Account ${index + 1}`,
         ledgerId: acc.ledgerId,
         networkId: acc.networkId,

package/src/lib/providers/walletconnect/core/walletconnect-provider.ts

@@ -29,6 +29,7 @@
 
 import { Injectable, signal, inject, NgZone } from '@angular/core';
 import { getLogger } from '@hsuite/native-connect-sdk';
+import type { SupportedLedger } from '@hsuite/native-connect-sdk';
 
 import type {
   ConnectionStatus,
@@ -298,7 +299,7 @@ export class WalletConnectV2Provider extends BaseWalletProvider {
       id: `${this.id}-${ledgerId}-${acc.address}`,
       address: acc.address,
       label: `Account ${index + 1}`,
-      ledgerId: ledgerId as 'hedera' | 'xrpl',
+      ledgerId: ledgerId as SupportedLedger,
       networkId: networkId, // Use user's selected network
       providerId: this.id,
       providerType: 'walletconnect-v2',

package/src/lib/services/hsuite-auth.interceptor.ts

@@ -0,0 +1,159 @@
+/**
+ * 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
+ */
+
+/**
+ * @file HTTP interceptor that attaches wallet-attributed auth headers.
+ *
+ * @module services/hsuite-auth-interceptor
+ *
+ * @description
+ * `HsuiteAuthInterceptor` automatically adds the active smart-host bearer token
+ * and wallet ledger identifier to outgoing HTTP requests. When a request fails
+ * with HTTP 401, it delegates recovery to {@link SmartSessionService} for a
+ * single re-login and retry.
+ *
+ * **Registration (standalone apps):**
+ * ```typescript
+ * provideHttpClient(withInterceptors([provideHsuiteAuthInterceptor()]))
+ * ```
+ *
+ * **Registration (module-based apps):**
+ * ```typescript
+ * { provide: HTTP_INTERCEPTORS, useClass: HsuiteAuthInterceptor, multi: true }
+ * ```
+ */
+
+import {
+  HttpErrorResponse,
+  HttpEvent,
+  HttpHandler,
+  HttpInterceptor,
+  HttpInterceptorFn,
+  HttpRequest,
+} from '@angular/common/http';
+import { inject, Injectable } from '@angular/core';
+import { catchError, from, Observable, switchMap, throwError } from 'rxjs';
+
+import { SmartSessionService } from './smart-session.service';
+import { UnifiedWalletService } from './unified-wallet.service';
+
+/**
+ * Headers injected by the interceptor.
+ */
+export const HSUITE_AUTH_HEADER = 'Authorization';
+export const HSUITE_LEDGER_HEADER = 'X-Ledger-Id';
+
+/**
+ * Functional HTTP interceptor that attaches wallet-attributed auth headers.
+ *
+ * @description
+ * Adds:
+ * - `Authorization: Bearer <token>` when {@link SmartSessionService.getBearer} returns a token
+ * - `X-Ledger-Id: <ledgerId>` when a wallet account is active
+ *
+ * On 401 responses, clears the stale bearer and retries once after re-login.
+ *
+ * @param req - The outgoing HTTP request
+ * @param next - The downstream request handler
+ * @returns Observable of HTTP events
+ */
+export const hsuiteAuthInterceptor: HttpInterceptorFn = (req, next) => {
+  const session = inject(SmartSessionService);
+  const wallet = inject(UnifiedWalletService);
+
+  const authenticated = appendAuthHeaders(req, session, wallet);
+
+  return next(authenticated).pipe(
+    catchError((error) => {
+      if (error instanceof HttpErrorResponse && error.status === 401) {
+        session.logout();
+        return from(session.login()).pipe(
+          switchMap(() => next(appendAuthHeaders(req, session, wallet))),
+          catchError((loginError) => throwError(() => loginError)),
+        );
+      }
+      return throwError(() => error);
+    }),
+  );
+};
+
+/**
+ * Class-based HTTP interceptor for module-based Angular apps.
+ *
+ * @description
+ * Provides the same behavior as {@link hsuiteAuthInterceptor} in a class form
+ * suitable for registration via `HTTP_INTERCEPTORS`.
+ */
+@Injectable({ providedIn: 'root' })
+export class HsuiteAuthInterceptor implements HttpInterceptor {
+  private readonly session = inject(SmartSessionService);
+  private readonly wallet = inject(UnifiedWalletService);
+
+  /**
+   * Intercepts outgoing HTTP requests to attach wallet-attributed auth headers.
+   *
+   * @param req - The outgoing HTTP request
+   * @param next - The downstream request handler
+   * @returns Observable of HTTP events
+   */
+  intercept(req: HttpRequest<unknown>, next: HttpHandler): Observable<HttpEvent<unknown>> {
+    const authenticated = appendAuthHeaders(req, this.session, this.wallet);
+
+    return next.handle(authenticated).pipe(
+      catchError((error) => {
+        if (error instanceof HttpErrorResponse && error.status === 401) {
+          this.session.logout();
+          return from(this.session.login()).pipe(
+            switchMap(() => next.handle(appendAuthHeaders(req, this.session, this.wallet))),
+            catchError((loginError) => throwError(() => loginError)),
+          );
+        }
+        return throwError(() => error);
+      }),
+    );
+  }
+}
+
+/**
+ * Helper that clones a request with the active auth headers attached.
+ *
+ * @param req - The outgoing HTTP request
+ * @param session - Smart session service for bearer lookup
+ * @param wallet - Unified wallet service for ledger ID lookup
+ * @returns The request cloned with Authorization and/or X-Ledger-Id headers
+ */
+function appendAuthHeaders(
+  req: HttpRequest<unknown>,
+  session: SmartSessionService,
+  wallet: UnifiedWalletService,
+): HttpRequest<unknown> {
+  const bearer = session.getBearer();
+  const activeAccount = wallet.activeAccount();
+  const ledgerId = activeAccount?.ledgerId;
+
+  // Avoid mutating requests that already carry an Authorization header
+  if (!bearer && !ledgerId) {
+    return req;
+  }
+
+  const headers: Record<string, string> = {};
+  if (bearer && !req.headers.has(HSUITE_AUTH_HEADER)) {
+    headers[HSUITE_AUTH_HEADER] = `Bearer ${bearer}`;
+  }
+  if (ledgerId && !req.headers.has(HSUITE_LEDGER_HEADER)) {
+    headers[HSUITE_LEDGER_HEADER] = ledgerId;
+  }
+
+  if (Object.keys(headers).length === 0) {
+    return req;
+  }
+
+  return req.clone({ setHeaders: headers });
+}