Added XrplPaymentFlags to XrplPaymentTransaction. (#20)

- Added `XrplPaymentFlags` to `XrplPaymentTransaction`.
- Created an extension method to create a `XummPostJsonPayload` based on an object.
- Ability to set `DeliverMin` and `SendMax` as XRP or `XrplTransactionCurrencyAmount`.

Author: DominiqueBlomsma

src/XUMM.NET.SDK/Clients/XummHttpClient.cs

@@ -3,12 +3,12 @@
 using System.Net.Http.Headers;
 using System.Text;
 using System.Text.Json;
-using System.Text.Json.Serialization;
 using System.Threading.Tasks;
 using Microsoft.Extensions.Logging;
 using Microsoft.Extensions.Options;
 using XUMM.NET.SDK.Clients.Interfaces;
 using XUMM.NET.SDK.Configs;
+using XUMM.NET.SDK.Helpers;
 using XUMM.NET.SDK.Models;
 
 namespace XUMM.NET.SDK.Clients;
@@ -18,7 +18,6 @@ public class XummHttpClient : IXummHttpClient
     private readonly ApiConfig _config;
     private readonly IHttpClientFactory _httpClientFactory;
     private readonly ILogger<XummHttpClient> _logger;
-    private readonly JsonSerializerOptions _serializerOptions;
 
     public XummHttpClient(
         IHttpClientFactory httpClientFactory,
@@ -28,19 +27,6 @@ public XummHttpClient(
         _config = options.Value;
         _httpClientFactory = httpClientFactory;
         _logger = logger;
-
-        _serializerOptions = new JsonSerializerOptions
-        {
-#if NET5_0_OR_GREATER
-            DefaultIgnoreCondition = JsonIgnoreCondition.WhenWritingNull,
-#else
-            IgnoreNullValues = true,
-#endif
-            Converters =
-            {
-                new JsonStringEnumConverter()
-            }
-        };
     }
 
     public async Task<T> GetAsync<T>(string endpoint)
@@ -55,7 +41,7 @@ public async Task<T> GetPublicAsync<T>(string endpoint)
 
     public async Task<T> PostAsync<T>(string endpoint, object content)
     {
-        return await PostAsync<T>(endpoint, JsonSerializer.Serialize(content, _serializerOptions));
+        return await PostAsync<T>(endpoint, JsonSerializer.Serialize(content, JsonHelper.SerializerOptions));
     }
 
     public async Task<T> PostAsync<T>(string endpoint, string json)

src/XUMM.NET.SDK/Enums/XrplPaymentFlags.cs

@@ -0,0 +1,22 @@
+using System;
+
+namespace XUMM.NET.SDK.Enums;
+
+[Flags]
+public enum XrplPaymentFlags
+{
+    /// <summary>
+    /// Do not use the default path; only use paths included in the Paths field. This is intended to force the transaction to take arbitrage opportunities. Most clients do not need this.
+    /// </summary>
+    tfNoDirectRipple = 65536,
+
+    /// <summary>
+    /// If the specified Amount cannot be sent without spending more than SendMax, reduce the received amount instead of failing outright.
+    /// </summary>
+    tfPartialPayment = 131072,
+
+    /// <summary>
+    /// Only take paths where all the conversions have an input:output ratio that is equal or better than the ratio of Amount:SendMax.
+    /// </summary>
+    tfLimitQuality = 262144
+}

src/XUMM.NET.SDK/Extensions/XummPayloadExtensions.cs

@@ -0,0 +1,18 @@
+using System.Text.Json;
+using XUMM.NET.SDK.Helpers;
+using XUMM.NET.SDK.Models.Payload;
+
+namespace XUMM.NET.SDK.Extensions
+{
+    public static class XummPayloadExtensions
+    {
+        /// <summary>
+        /// Serialize the <paramref name="payloadObject"/> as the <see cref="XummPostJsonPayload.TxJson"/> of <see cref="XummPostJsonPayload"/>.
+        /// </summary>
+        public static XummPostJsonPayload ToXummPostJsonPayload(this object payloadObject)
+        {
+            var json = JsonSerializer.Serialize(payloadObject, JsonHelper.SerializerOptions);
+            return new XummPostJsonPayload(json);
+        }
+    }
+}

src/XUMM.NET.SDK/Helpers/JsonHelper.cs

@@ -0,0 +1,21 @@
+using System.Text.Json;
+using System.Text.Json.Serialization;
+
+namespace XUMM.NET.SDK.Helpers
+{
+    internal class JsonHelper
+    {
+        internal static JsonSerializerOptions SerializerOptions => new JsonSerializerOptions
+        {
+#if NET5_0_OR_GREATER
+            DefaultIgnoreCondition = JsonIgnoreCondition.WhenWritingNull,
+#else
+            IgnoreNullValues = true,
+#endif
+            Converters =
+            {
+                new JsonStringEnumConverter()
+            }
+        };
+    }
+}

src/XUMM.NET.SDK/Models/Payload/XRPL/XrplPaymentTransaction.cs

@@ -25,6 +25,12 @@ public XrplPaymentTransaction()
         TransactionType = XrplTransactionType.Payment.ToString();
     }
 
+    /// <summary>
+    /// Transactions of the Payment type support additional values in the Flags field.
+    /// </summary>
+    [JsonPropertyName("Flags")]
+    public new XrplPaymentFlags? Flags { get; set; }
+
     /// <summary>
     /// The unique address of the account receiving the payment.
     /// </summary>
@@ -53,14 +59,14 @@ public XrplPaymentTransaction()
     /// rates, and slippage.
     /// </summary>
     [JsonPropertyName("SendMax")]
-    public XrplTransactionCurrencyAmount? SendMax { get; set; }
+    public object? SendMax { get; private set; }
 
     /// <summary>
     /// (Optional) Minimum amount of destination currency this transaction should deliver. Only valid if this is a partial
     /// payment.
     /// </summary>
     [JsonPropertyName("DeliverMin")]
-    public XrplTransactionCurrencyAmount? DeliverMin { get; set; }
+    public object? DeliverMin { get;  private set; }
 
     /// <summary>
     /// XRP Amount
@@ -70,6 +76,22 @@ public void SetAmount(decimal amount)
         Amount = amount.XrpToDropsString();
     }
 
+    /// <summary>
+    /// XRP Amount
+    /// </summary>
+    public void SetSendMaxAmount(decimal amount)
+    {
+        SendMax = amount.XrpToDropsString();
+    }
+
+    /// <summary>
+    /// XRP Amount
+    /// </summary>
+    public void SetDeliverMinAmount(decimal amount)
+    {
+        DeliverMin = amount.XrpToDropsString();
+    }
+
     /// <summary>
     /// Non-XRP Amounts
     /// </summary>
@@ -82,4 +104,30 @@ public void SetAmount(string currency, decimal amount, string issuer)
             Issuer = issuer
         };
     }
+
+    /// <summary>
+    /// Non-XRP Amounts
+    /// </summary>
+    public void SetSendMaxAmount(string currency, decimal amount, string issuer)
+    {
+        SendMax = new XrplTransactionCurrencyAmount
+        {
+            Currency = currency,
+            Value = amount.ToString(CultureInfo.InvariantCulture),
+            Issuer = issuer
+        };
+    }
+
+    /// <summary>
+    /// Non-XRP Amounts
+    /// </summary>
+    public void SetDeliverMinAmount(string currency, decimal amount, string issuer)
+    {
+        DeliverMin = new XrplTransactionCurrencyAmount
+        {
+            Currency = currency,
+            Value = amount.ToString(CultureInfo.InvariantCulture),
+            Issuer = issuer
+        };
+    }
 }

src/XUMM.NET.SDK/Models/Payload/Xumm/XummPayloadTransaction.cs

@@ -1,11 +1,13 @@
-using XUMM.NET.SDK.Enums;
+using System.Collections.Generic;
+using XUMM.NET.SDK.Enums;
 
 namespace XUMM.NET.SDK.Models.Payload.Xumm
 {
-    public class XummPayloadTransaction : XummPayloadTransactionBase
+    public class XummPayloadTransaction : Dictionary<string, object>
     {
-        public XummPayloadTransaction(XummTransactionType transactionType) : base(transactionType.ToString())
+        public XummPayloadTransaction(XummTransactionType transactionType)
         {
+            Add("TransactionType", transactionType.ToString());
         }
     }
 }