fix(activation): eth PrivateKeyPolicy enum breaking changes

packages/komodo_defi_local_auth/lib/src/komodo_defi_local_auth.dart

@@ -260,7 +260,7 @@ class KomodoDefiLocalAuth implements KomodoDefiAuth {
     await _assertAuthState(false);
 
     // Trezor is not supported in non-stream functions
-    if (options.privKeyPolicy == PrivateKeyPolicy.trezor) {
+    if (options.privKeyPolicy == const PrivateKeyPolicy.trezor()) {
       throw AuthException(
         'Trezor authentication requires using signInStream() method '
         'to handle device interactions (PIN, passphrase) asynchronously',
@@ -294,7 +294,7 @@ class KomodoDefiLocalAuth implements KomodoDefiAuth {
     await ensureInitialized();
     await _assertAuthState(false);
 
-    if (options.privKeyPolicy == PrivateKeyPolicy.trezor) {
+    if (options.privKeyPolicy == const PrivateKeyPolicy.trezor()) {
       // Trezor requires streaming to handle interactive device prompts
       yield* _trezorAuthService.signInStreamed(options: options);
     } else {
@@ -354,7 +354,7 @@ class KomodoDefiLocalAuth implements KomodoDefiAuth {
     }
 
     // Trezor is not supported in non-stream functions
-    if (options.privKeyPolicy == PrivateKeyPolicy.trezor) {
+    if (options.privKeyPolicy == const PrivateKeyPolicy.trezor()) {
       throw AuthException(
         'Trezor registration requires using registerStream() method '
         'to handle device interactions (PIN, passphrase) asynchronously',
@@ -391,7 +391,7 @@ class KomodoDefiLocalAuth implements KomodoDefiAuth {
       return;
     }
 
-    if (options.privKeyPolicy == PrivateKeyPolicy.trezor) {
+    if (options.privKeyPolicy == const PrivateKeyPolicy.trezor()) {
       // Trezor requires streaming to handle interactive device prompts
       yield* _trezorAuthService.registerStream(
         options: options,

packages/komodo_defi_local_auth/lib/src/trezor/trezor_auth_service.dart

@@ -327,7 +327,7 @@ class TrezorAuthService implements IAuthService {
     return users.firstWhereOrNull(
       (u) =>
           u.walletId.name == trezorWalletName &&
-          u.authOptions.privKeyPolicy == PrivateKeyPolicy.trezor,
+          u.authOptions.privKeyPolicy == const PrivateKeyPolicy.trezor(),
     );
   }
 
@@ -340,7 +340,7 @@ class TrezorAuthService implements IAuthService {
   }) async {
     final authOptions = AuthOptions(
       derivationMethod: derivationMethod,
-      privKeyPolicy: PrivateKeyPolicy.trezor,
+      privKeyPolicy: const PrivateKeyPolicy.trezor(),
     );
 
     if (existingUser != null && !register) {

packages/komodo_defi_rpc_methods/analysis_options.yaml

@@ -1,4 +1,5 @@
 analyzer:
   errors:
     public_member_api_docs: ignore
+    invalid_annotation_target: ignore
 include: package:very_good_analysis/analysis_options.6.0.0.yaml

packages/komodo_defi_rpc_methods/index_generator.yaml

@@ -16,7 +16,7 @@ index_generator:
 
         Generated by the `index_generator` package with the `index_generator.yaml` configuration file.
       disclaimer: false
-    
+
     - directory_path: lib/src/rpc_methods
       file_name: rpc_methods
       name: rpc_methods
@@ -71,4 +71,4 @@ index_generator:
         Activation parameters used by the Komodo DeFi Framework API.
       comments: |
         Generated by the `index_generator` package with the `index_generator.yaml` configuration file.
-      disclaimer: false
+      disclaimer: false

packages/komodo_defi_rpc_methods/lib/src/common_structures/activation/activation_params/activation_params.dart

@@ -1,6 +1,9 @@
+import 'package:freezed_annotation/freezed_annotation.dart';
 import 'package:komodo_defi_rpc_methods/src/internal_exports.dart';
 import 'package:komodo_defi_types/komodo_defi_type_utils.dart';
-import 'package:meta/meta.dart';
+
+part 'activation_params.freezed.dart';
+part 'activation_params.g.dart';
 
 /// Defines additional parameters used for activation. These params may vary depending
 /// on the coin type.
@@ -22,7 +25,7 @@ class ActivationParams implements RpcRequestParams {
   const ActivationParams({
     this.requiredConfirmations,
     this.requiresNotarization = false,
-    this.privKeyPolicy = PrivateKeyPolicy.contextPrivKey,
+    this.privKeyPolicy = const PrivateKeyPolicy.contextPrivKey(),
     this.minAddressesNumber,
     this.scanPolicy,
     this.gapLimit,
@@ -38,14 +41,14 @@ class ActivationParams implements RpcRequestParams {
       json,
       type: ActivationModeType.electrum,
     );
+
     return ActivationParams(
       requiredConfirmations: json.valueOrNull<int>('required_confirmations'),
       requiresNotarization:
           json.valueOrNull<bool>('requires_notarization') ?? false,
-      privKeyPolicy:
-          json.valueOrNull<String>('priv_key_policy') == 'Trezor'
-              ? PrivateKeyPolicy.trezor
-              : PrivateKeyPolicy.contextPrivKey,
+      privKeyPolicy: PrivateKeyPolicy.fromLegacyJson(
+        json.valueOrNull<dynamic>('priv_key_policy'),
+      ),
       minAddressesNumber: json.valueOrNull<int>('min_addresses_number'),
       scanPolicy:
           json.valueOrNull<String>('scan_policy') == null
@@ -74,7 +77,7 @@ class ActivationParams implements RpcRequestParams {
 
   /// Whether to use Trezor hardware wallet or context private key.
   /// Defaults to ContextPrivKey.
-  final PrivateKeyPolicy privKeyPolicy;
+  final PrivateKeyPolicy? privKeyPolicy;
 
   /// HD wallets only. How many additional addresses to generate at a minimum.
   final int? minAddressesNumber;
@@ -107,7 +110,13 @@ class ActivationParams implements RpcRequestParams {
       if (requiredConfirmations != null)
         'required_confirmations': requiredConfirmations,
       'requires_notarization': requiresNotarization,
-      'priv_key_policy': privKeyPolicy.id,
+      // IMPORTANT: Serialization format varies by coin type:
+      // - ETH/ERC20: Uses full JSON object format with type discrimination
+      // - Other coins: Uses legacy PascalCase string format for backward compatibility
+      // This difference is maintained for API compatibility reasons.
+      'priv_key_policy':
+          (privKeyPolicy ?? const PrivateKeyPolicy.contextPrivKey())
+              .pascalCaseName,
       if (minAddressesNumber != null)
         'min_addresses_number': minAddressesNumber,
       if (scanPolicy != null) 'scan_policy': scanPolicy!.value,
@@ -136,7 +145,10 @@ class ActivationParams implements RpcRequestParams {
       requiredConfirmations:
           requiredConfirmations ?? this.requiredConfirmations,
       requiresNotarization: requiresNotarization ?? this.requiresNotarization,
-      privKeyPolicy: privKeyPolicy ?? this.privKeyPolicy,
+      privKeyPolicy:
+          privKeyPolicy ??
+          this.privKeyPolicy ??
+          const PrivateKeyPolicy.contextPrivKey(),
       minAddressesNumber: minAddressesNumber ?? this.minAddressesNumber,
       scanPolicy: scanPolicy ?? this.scanPolicy,
       gapLimit: gapLimit ?? this.gapLimit,
@@ -150,20 +162,94 @@ class ActivationParams implements RpcRequestParams {
 }
 
 /// Defines the private key policy for activation
-enum PrivateKeyPolicy {
+/// API uses pascal case for PrivKeyPolicy types, so we use it as the
+/// union key case to ensure compatibility with existing APIs.
+@Freezed(unionKey: 'type', unionValueCase: FreezedUnionCase.pascal)
+abstract class PrivateKeyPolicy with _$PrivateKeyPolicy {
+  /// Private constructor to allow for additional methods and properties
+  const PrivateKeyPolicy._();
+
   /// Use context private key (default)
-  contextPrivKey,
+  const factory PrivateKeyPolicy.contextPrivKey() = _ContextPrivKey;
 
   /// Use Trezor hardware wallet
-  trezor;
+  const factory PrivateKeyPolicy.trezor() = _Trezor;
+
+  /// Use MetaMask for activation. WASM (web) only.
+  const factory PrivateKeyPolicy.metamask() = _Metamask;
+
+  /// Use WalletConnect for hardware wallet activation
+  @JsonSerializable(fieldRename: FieldRename.snake)
+  const factory PrivateKeyPolicy.walletConnect(String sessionTopic) =
+      _WalletConnect;
+
+  factory PrivateKeyPolicy.fromJson(Map<String, dynamic> json) =>
+      _$PrivateKeyPolicyFromJson(json);
+
+  /// Converts a string or map to a [PrivateKeyPolicy]
+  /// Throws [ArgumentError] if the input is invalid
+  /// If the input is null, defaults to [PrivateKeyPolicy.contextPrivKey]
+  /// If the input is a string, it must match one of the known policy types.
+  /// If the input is a map, it must contain a 'type' key with a valid policy type.
+  /// If the input is a map with a 'session_topic' key, it will be used for
+  /// [PrivateKeyPolicy.walletConnect].
+  factory PrivateKeyPolicy.fromLegacyJson(dynamic privKeyPolicy) {
+    if (privKeyPolicy == null) {
+      return const PrivateKeyPolicy.contextPrivKey();
+    }
 
-  /// String identifier for the policy
-  String get id {
-    switch (this) {
-      case PrivateKeyPolicy.contextPrivKey:
+    if (privKeyPolicy is Map && privKeyPolicy['type'] != null) {
+      return PrivateKeyPolicy.fromJson(privKeyPolicy as JsonMap);
+    }
+
+    if (privKeyPolicy is! String) {
+      throw ArgumentError(
+        'Invalid private key policy type: ${privKeyPolicy.runtimeType}',
+      );
+    }
+
+    switch (privKeyPolicy) {
+      case 'ContextPrivKey':
+      case 'context_priv_key':
+        return const PrivateKeyPolicy.contextPrivKey();
+      case 'Trezor':
+      case 'trezor':
+        return const PrivateKeyPolicy.trezor();
+      case 'Metamask':
+      case 'metamask':
+        return const PrivateKeyPolicy.metamask();
+      case 'WalletConnect':
+      case 'wallet_connect':
+        return const PrivateKeyPolicy.walletConnect('');
+      default:
+        throw ArgumentError('Unknown private key policy type: $privKeyPolicy');
+    }
+  }
+
+  /// Returns the PascalCase name of the private key policy type
+  ///
+  /// Examples:
+  /// - `PrivateKeyPolicy.contextPrivKey()` → `"ContextPrivKey"`
+  /// - `PrivateKeyPolicy.trezor()` → `"Trezor"`
+  /// - `PrivateKeyPolicy.metamask()` → `"Metamask"`
+  /// - `PrivateKeyPolicy.walletConnect(...)` → `"WalletConnect"`
+  String get pascalCaseName {
+    switch (runtimeType) {
+      case _ContextPrivKey:
         return 'ContextPrivKey';
-      case PrivateKeyPolicy.trezor:
+      case _Trezor:
         return 'Trezor';
+      case _Metamask:
+        return 'Metamask';
+      case _WalletConnect:
+        return 'WalletConnect';
+      default:
+        // Fallback: convert snake_case from JSON to PascalCase
+        final snakeCaseType = toJson()['type'] as String;
+        return snakeCaseType
+            .split('_')
+            .map((word) => word[0].toUpperCase() + word.substring(1))
+            .join();
     }
   }
 }