PathfindingFallback and ForceNetwork payload options (#30)

* Added `PathfindingFallback` and `ForceNetwork` to the Payload Options.

Author: DominiqueBlomsma

src/XUMM.NET.SDK.Tests/Data/payload-cancel.json

@@ -9,6 +9,8 @@
     "multisign": false,
     "submit": false,
     "pathfinding": true,
+    "pathfinding_fallback": true,
+    "force_network": "MAINNET",
     "destination": "",
     "resolved_destination": "",
     "resolved": false,

src/XUMM.NET.SDK.Tests/Data/payload-get.json

@@ -4,7 +4,9 @@
     "uuid": "00000000-0000-4839-af2f-f794874a80b0",
     "multisign": false,
     "submit": false,
-    "pathfinding": null,
+    "pathfinding": false,
+    "pathfinding_fallback": false,
+    "force_network": null,
     "destination": "",
     "resolved_destination": "",
     "resolved": true,

src/XUMM.NET.SDK.Tests/Fixtures/PayloadFixtures.cs

@@ -38,7 +38,9 @@ internal static class PayloadFixtures
             Uuid = "00000000-0000-4839-af2f-f794874a80b0",
             Multisign = false,
             Submit = false,
-            Pathfinding = null,
+            Pathfinding = false,
+            PathfindingFallback = false,
+            ForceNetwork = null,
             Destination = string.Empty,
             ResolvedDestination = string.Empty,
             Resolved = true,
@@ -109,6 +111,8 @@ internal static class PayloadFixtures
             Multisign = false,
             Submit = false,
             Pathfinding = true,
+            PathfindingFallback = true,
+            ForceNetwork = "MAINNET",
             Destination = string.Empty,
             ResolvedDestination = string.Empty,
             Resolved = false,

src/XUMM.NET.SDK/Models/Payload/XummPayloadDetailsMeta.cs

@@ -17,7 +17,13 @@ public class XummPayloadDetailsMeta
     public bool Submit { get; set; }
 
     [JsonPropertyName("pathfinding")]
-    public bool? Pathfinding { get; set; }
+    public bool Pathfinding { get; set; }
+
+    [JsonPropertyName("pathfinding_fallback")]
+    public bool PathfindingFallback { get; set; }
+
+    [JsonPropertyName("force_network")]
+    public string? ForceNetwork { get; set; } = default!;
 
     [JsonPropertyName("destination")]
     public string Destination { get; set; } = default!;

src/XUMM.NET.SDK/Models/Payload/XummPayloadOptions.cs

@@ -5,37 +5,49 @@ namespace XUMM.NET.SDK.Models.Payload;
 public class XummPayloadOptions
 {
     /// <summary>
-    /// Should the xumm app submit to the XRPL after signing? (Optional)
+    /// (Optional) Should the xumm app submit to the XRPL after signing? 
     /// </summary>
     [JsonPropertyName("submit")]
     public bool? Submit { get; set; }
 
     /// <summary>
-    /// Allow pathfinding for regular Payment type transactions, so the user can select the asset to send to deliver the requested asset amount.
+    /// (Optional) Allow pathfinding for regular Payment type transactions, so the user can select the asset to send to deliver the requested asset amount.
     /// </summary>
     [JsonPropertyName("pathfinding")]
     public bool? Pathfinding { get; set; }
 
     /// <summary>
-    /// Should the transaction be signed as a multi sign transaction? (Optional)
+    /// (Optional) Allow Xumm clients &lt; version 2.4.0 to fall back from modern pathfinding UX to a native 1:1 asset payment.
+    /// </summary>
+    [JsonPropertyName("pathfinding_fallback")]
+    public bool? PathfindingFallback { get; set; }
+
+    /// <summary>
+    /// (Optional) Should the transaction be signed as a multi sign transaction?
     /// </summary>
     [JsonPropertyName("multisign")]
     public bool? MultiSign { get; set; }
 
     /// <summary>
-    /// After how many minutes should the payload expire? (Optional)
+    /// (Optional) After how many minutes should the payload expire?
     /// </summary>
     [JsonPropertyName("expire")]
     public int Expire { get; set; }
 
     /// <summary>
-    /// Force any of the provided accounts to sign. (Optional)
+    /// (Optional) Force any of the provided accounts to sign.
     /// </summary>
     [JsonPropertyName("signers")]
     public string[]? Signers { get; set; }
 
     /// <summary>
-    /// Where should the user be redirected to after resolving the payload? (Optional)
+    /// (Optional) When set, the payload can only be opened by a device connected to the specified network. Xumm 2.5.0 and higher required.
+    /// </summary>
+    [JsonPropertyName("force_network")]
+    public string? ForceNetwork { get; set; }
+
+    /// <summary>
+    /// (Optional) Where should the user be redirected to after resolving the payload?
     /// </summary>
     [JsonPropertyName("return_url")]
     public XummPayloadReturnUrl? ReturnUrl { get; set; }