Get Paid: unified transaction card

lib/features/bullnym/domain/bullnym_fiat_settlement.dart

@@ -38,11 +38,17 @@ enum BullnymSettlementLegStatus {
   unknown,
 }
 
-/// Why a configured fiat conversion was overridden to all-Bitcoin.
+/// Why a configured fiat conversion was overridden to all-Bitcoin. `unknown`
+/// covers a reason this client version does not recognize — it is NOT a wire
+/// value, so every reason the contract defines must be mapped explicitly.
 enum BullnymFiatConversionOverrideReason {
   belowMinimum,
   invalidSplit,
   conversionUnavailable,
+
+  /// The server could not confirm the outcome of a conversion attempt, so the
+  /// funds stayed in Bitcoin (contract 0.3 `ambiguous_create`).
+  ambiguousCreate,
   unknown,
 }
 
@@ -310,6 +316,7 @@ class BullnymGetPaidSettlement {
     'invalid_split' => BullnymFiatConversionOverrideReason.invalidSplit,
     'conversion_unavailable' =>
       BullnymFiatConversionOverrideReason.conversionUnavailable,
+    'ambiguous_create' => BullnymFiatConversionOverrideReason.ambiguousCreate,
     _ => BullnymFiatConversionOverrideReason.unknown,
   };
 

lib/features/get_paid/domain/get_paid_settlement.dart

@@ -21,6 +21,10 @@ enum GetPaidFiatOverrideReason {
   belowMinimum,
   invalidSplit,
   conversionUnavailable,
+
+  /// A conversion attempt whose outcome the server could not confirm, so the
+  /// funds stayed in Bitcoin.
+  ambiguousCreate,
   unknown,
 }
 
@@ -52,10 +56,16 @@ class GetPaidFiatSettlementLeg {
 /// The Bitcoin-wallet portion of a mixed settlement.
 class GetPaidBitcoinSettlementLeg {
   final int amountSat;
+
+  /// The server-named network this leg settles on (version one settles Bitcoin
+  /// legs on Liquid only; the strict parser rejects any other value, so an
+  /// unrecognized network never reaches here as a definite leg).
+  final String network;
   final GetPaidSettlementLegStatus status;
 
   const GetPaidBitcoinSettlementLeg({
     required this.amountSat,
+    required this.network,
     required this.status,
   });
 }

lib/features/get_paid/domain/get_paid_settlement_mapper.dart

@@ -42,6 +42,7 @@ GetPaidFiatSettlementLeg _fiatLeg(BullnymFiatSettlementLeg leg) =>
 GetPaidBitcoinSettlementLeg _bitcoinLeg(BullnymBitcoinSettlementLeg leg) =>
     GetPaidBitcoinSettlementLeg(
       amountSat: leg.amountSat,
+      network: leg.network,
       status: _legStatus(leg.status),
     );
 
@@ -66,6 +67,8 @@ GetPaidFiatOverrideReason _overrideReason(
     GetPaidFiatOverrideReason.invalidSplit,
   BullnymFiatConversionOverrideReason.conversionUnavailable =>
     GetPaidFiatOverrideReason.conversionUnavailable,
+  BullnymFiatConversionOverrideReason.ambiguousCreate =>
+    GetPaidFiatOverrideReason.ambiguousCreate,
   BullnymFiatConversionOverrideReason.unknown =>
     GetPaidFiatOverrideReason.unknown,
 };