feat: update SorobanServer.SimulateTransaction to add support for non-root authorization (#68)

Author: cuongph87

StellarDotnetSdk.Tests/SorobanServerTest.cs

@@ -343,7 +343,7 @@ public async Task TestSimulateSignedTransaction()
     {
         using var sorobanServer = Utils.CreateTestSorobanServerWithContent("");
         await Assert.ThrowsExceptionAsync<TooManySignaturesException>(() =>
-            sorobanServer.SimulateTransaction(CreateDummyTransaction()));
+            sorobanServer.SimulateTransaction(CreateDummyTransaction(sign: true)));
     }
 
     [TestMethod]
@@ -1061,7 +1061,11 @@ public async Task TestSimulateTransactionSuccess()
             """;
         using var sorobanServer = Utils.CreateTestSorobanServerWithContent(json);
 
-        var response = await sorobanServer.SimulateTransaction(CreateDummyTransaction(false));
+        var response = await sorobanServer.SimulateTransaction(
+            CreateDummyTransaction(sign: false),
+            resourceConfig: null,
+            authMode: AuthMode.RECORD_ALLOW_NONROOT
+        );
 
         Assert.IsNotNull(response);
 

StellarDotnetSdk/Soroban/AuthMode.cs

@@ -0,0 +1,8 @@
+namespace StellarDotnetSdk.Soroban;
+
+public enum AuthMode
+{
+    ENFORCE,
+    RECORD,
+    RECORD_ALLOW_NONROOT,
+}

StellarDotnetSdk/Soroban/SorobanServer.cs

@@ -1,4 +1,5 @@
 using System;
+using System.Collections.Generic;
 using System.Linq;
 using System.Net.Http;
 using System.Reflection;
@@ -240,24 +241,45 @@ public Task<GetLedgerEntriesResponse> GetLedgerEntry(LedgerKey key)
     ///     </remarks>
     /// </param>
     /// <param name="resourceConfig">Contains configuration for how resources will be calculated when simulating transactions.</param>
+    /// <param name="authMode">Explicitly allows users to opt in to non-root authorization in recording mode.
+    /// <p>Leaving this field unset will default to <see cref="AuthMode.ENFORCE"/> if auth entries are present,
+    /// <see cref="AuthMode.RECORD"/> otherwise.</p>
+    /// </param>
     /// <returns>A <see cref="SimulateTransactionResponse" /> object.</returns>
-    public Task<SimulateTransactionResponse> SimulateTransaction(Transaction transaction, uint? resourceConfig = null)
+    public Task<SimulateTransactionResponse> SimulateTransaction(
+        Transaction transaction,
+        uint? resourceConfig = null,
+        AuthMode? authMode = null)
+    {
+        var requestParams = BuildSimulateTransactionRequest(transaction, resourceConfig, authMode);
+
+        return SendRequest<object, SimulateTransactionResponse>(
+            "simulateTransaction",
+            requestParams
+        );
+    }
+
+    private static Dictionary<string, object> BuildSimulateTransactionRequest(
+        Transaction transaction,
+        uint? resourceConfig,
+        AuthMode? authMode)
     {
+        var request = new Dictionary<string, object>
+        {
+            ["transaction"] = transaction.ToUnsignedEnvelopeXdrBase64()
+        };
+
         if (resourceConfig != null)
         {
-            return SendRequest<object, SimulateTransactionResponse>("simulateTransaction",
-                new
-                {
-                    transaction = transaction.ToUnsignedEnvelopeXdrBase64(),
-                    resourceConfig = new { instructionLeeway = resourceConfig },
-                });
+            request["resourceConfig"] = new { instructionLeeway = resourceConfig };
+        }
+
+        if (authMode != null)
+        {
+            request["authMode"] = authMode;
         }
 
-        return SendRequest<object, SimulateTransactionResponse>("simulateTransaction",
-            new
-            {
-                transaction = transaction.ToUnsignedEnvelopeXdrBase64(),
-            });
+        return request;
     }
 
     /// <summary>