Update Client 0.3.3 | Make TonClient Disposable, Fix Stack Parsing (continuation-team#91)

* GITBOOK-35: No subject

* GITBOOK-36: No subject

* Add StackItem parsing | Client 0.3.2

* implement JettonMinter.cs

* Add NftCollection.cs

* GITBOOK-37: No subject

* update TonSdk.Contracts.csproj

* GITBOOK-38: No subject

* GITBOOK-39: No subject

* GITBOOK-40: No subject

* add sse client cancelation on disconnect

* added tg wallet support

* GITBOOK-42: No subject

* update deps version

* Update Transformers.cs continuation-team#86 (continuation-team#87)

Co-authored-by: Purple Guy <[email protected]>

* GITBOOK-45: No subject

* add TonCenter v3, TonWhales API

* remove console writeline

* make TonClient.cs disposable (continuation-team#90)

* change package version, fix stack item parsing

---------

Co-authored-by: vlad013 <[email protected]>
Co-authored-by: Daniel <[email protected]>

Author: 3 people

TonSdk.Client/src/Client/ITonClient.cs

@@ -0,0 +1,149 @@
+using System.Threading.Tasks;
+using TonSdk.Client.Stack;
+using TonSdk.Core;
+using TonSdk.Core.Block;
+using TonSdk.Core.Boc;
+
+namespace TonSdk.Client
+{
+    public interface ITonClient
+    {
+        Jetton Jetton { get; }
+        Nft Nft { get; }
+        Wallet Wallet { get; }
+        Dns Dns { get; }
+        TonClientType GetClientType();
+
+        /// <summary>
+        /// Retrieves the balance of the specified address.
+        /// </summary>
+        /// <param name="address">The address to retrieve the balance for.</param>
+        /// <returns>The task result contains the balance as a Coins instance.</returns>
+        Task<Coins> GetBalance(Address address);
+
+        /// <summary>
+        /// Checks if a contract is deployed at the specified address.
+        /// </summary>
+        /// <param name="address">The address to check.</param>
+        /// <returns>The task result indicates whether a contract is deployed (true) or not (false) at the specified address.</returns>
+        Task<bool> IsContractDeployed(Address address);
+
+        /// <summary>
+        /// Retrieves the address information for the specified address.
+        /// </summary>
+        /// <param name="address">The address object to retrieve information for.</param>
+        /// <returns>An object containing the address information.</returns>
+        Task<AddressInformationResult?> GetAddressInformation(Address address);
+
+        /// <summary>
+        /// Retrieves the wallet information for the specified address.
+        /// </summary>
+        /// <param name="address">The address object to retrieve information for.</param>
+        /// <returns>An object containing the wallet information.</returns>
+        Task<WalletInformationResult?> GetWalletInformation(Address address);
+
+        /// <summary>
+        /// Get up-to-date masterchain state.
+        /// </summary>
+        /// <returns>An object containing the masterchain information.</returns>
+        Task<MasterchainInformationResult?> GetMasterchainInfo();
+
+        /// <summary>
+        /// Look up block by either seqno, lt or unixTime.
+        /// </summary>
+        /// <returns>An object containing the block information.</returns>
+        Task<BlockIdExtended> LookUpBlock(int workchain, long shard, long? seqno = null, ulong? lt = null, ulong? unixTime = null);
+
+        /// <summary>
+        /// Get metadata of a given block.
+        /// </summary>
+        /// <returns>An object containing the block metadata.</returns>
+        Task<BlockDataResult?> GetBlockData(int workchain,
+            long shard,
+            long seqno,
+            string rootHash = null,
+            string fileHash = null);
+
+        /// <summary>
+        /// Get transactions of the given block.
+        /// </summary>
+        /// <param name="workchain"></param>
+        /// <param name="shard"></param>
+        /// <param name="seqno"></param>
+        /// <param name="rootHash"></param>
+        /// <param name="fileHash"></param>
+        /// <param name="afterLt"></param>
+        /// <param name="afterHash"></param>
+        /// <param name="count"></param>
+        /// <returns>An object containing the shards information.</returns>
+        Task<BlockTransactionsResult?> GetBlockTransactions(
+            int workchain,
+            long shard,
+            long seqno,
+            string rootHash = null,
+            string fileHash = null,
+            ulong? afterLt = null,
+            string afterHash = null,
+            uint count = 10);
+
+        /// <summary>
+        /// Retrieves transaction information for the specified address.
+        /// </summary>
+        /// <param name="address">The address object to retrieve transaction information for.</param>
+        /// <param name="limit">The maximum number of transactions to retrieve (default: 10).</param>
+        /// <param name="lt">The logical time of the transaction to start retrieving from (optional).</param>
+        /// <param name="hash">The hash of the transaction to start retrieving from (optional).</param>
+        /// <param name="to_lt">The logical time of the transaction to retrieve up to (optional).</param>
+        /// <param name="archival">Specifies whether to retrieve transactions from archival nodes (optional).</param>
+        /// <returns>An array of transaction information results.</returns>
+        Task<TransactionsInformationResult[]> GetTransactions(Address address, uint limit = 10,
+            ulong? lt = null, string hash = null, ulong? to_lt = null, bool? archival = null);
+
+        /// <summary>
+        /// Executes a specific method on the specified address.
+        /// </summary>
+        /// <param name="address">The address object to execute the method on.</param>
+        /// <param name="method">The name of the method to execute.</param>
+        /// <param name="stackItems">The stack parameters for the method (optional).</param>
+        /// <returns>The result of the executed method.</returns>
+        Task<RunGetMethodResult?> RunGetMethod(Address address, string method, IStackItem[] stackItems);
+
+        /// <summary>
+        /// Executes a specific method on the specified address.
+        /// </summary>
+        /// <param name="address">The address object to execute the method on.</param>
+        /// <param name="method">The name of the method to execute.</param>
+        /// <param name="stack">The stack parameters for the method (optional).</param>
+        /// <returns>The result of the executed method.</returns>
+        Task<RunGetMethodResult?> RunGetMethod(Address address, string method, string[][] stack);
+
+        /// <summary>
+        /// Sends a Bag of Cells (BoC) to the network.
+        /// </summary>
+        /// <param name="boc">The Cell object representing the Bag of Cells.</param>
+        /// <returns>The result of sending the Bag of Cells.</returns>
+        Task<SendBocResult?> SendBoc(Cell boc);
+
+        /// <summary>
+        /// Retrieves a configuration parameter by its ID.
+        /// </summary>
+        /// <param name="configId">The ID of the configuration parameter to retrieve.</param>
+        /// <param name="seqno">The sequence number of the configuration parameter (optional).</param>
+        /// <returns>The result of the configuration parameter retrieval.</returns>
+        Task<ConfigParamResult?> GetConfigParam(int configId, int? seqno = null);
+
+        /// <summary>
+        /// Get shards information.
+        /// </summary>
+        /// <param name="seqno">Masterchain seqno to fetch shards of.</param>
+        /// <returns>An object containing the shards information.</returns>
+        Task<ShardsInformationResult?> Shards(long seqno);
+
+        /// <summary>
+        /// Estimates fee for the message
+        /// </summary>
+        /// <param name="message">The message for which you need to calculate the fees</param>
+        /// <returns>The result of estimation fees.</returns>
+        Task<IEstimateFeeResult> EstimateFee(MessageX message, bool ignoreChksig = true);
+    }
+}

TonSdk.Client/src/Client/TonClient.cs

@@ -7,18 +7,18 @@
 
 namespace TonSdk.Client
 {
-    public class TonClient
+    public class TonClient : ITonClient, IDisposable
     {
-        private TonClientType _type;
-        private HttpApi _httpApi;
-        private HttpApiV3 _httpApiV3;
-        private HttpWhales _httpWhales;
-        private LiteClientApi _liteClientApi;
+        private readonly TonClientType _type;
+        private readonly HttpApi _httpApi;
+        private readonly HttpApiV3 _httpApiV3;
+        private readonly HttpWhales _httpWhales;
+        private readonly LiteClientApi _liteClientApi;
 
-        public Jetton Jetton { get; private set; }
-        public Nft Nft { get; private set; }
-        public Wallet Wallet { get; private set; }
-        public Dns Dns { get; private set; }
+        public Jetton Jetton { get; }
+        public Nft Nft { get; }
+        public Wallet Wallet { get; }
+        public Dns Dns { get; }
 
         public TonClient(TonClientType clientType, ITonClientOptions options)
         {
@@ -339,5 +339,13 @@ public async Task<bool> IsContractDeployed(Address address)
                 _ => null
             };
         }
+
+        public void Dispose()
+        {
+            _httpApi?.Dispose();
+            _httpApiV3?.Dispose();
+            _httpWhales?.Dispose();
+            _liteClientApi?.Dispose();
+        }
     }
 }

TonSdk.Client/src/LiteClientApi/LiteClientApi.cs

@@ -14,9 +14,9 @@
 
 namespace TonSdk.Client
 {
-    internal class LiteClientApi
+    internal class LiteClientApi : IDisposable
     {
-        private LiteClient _liteClient;
+        private readonly LiteClient _liteClient;
 
         internal LiteClientApi(string host, int port, string pubKey)
         {
@@ -516,5 +516,10 @@ private void LoadBinTreeR(CellSlice slice, ref List<BlockIdExtended> shards)
                 LoadBinTreeR(slice.LoadRef().Parse(), ref shards);
             }
         }
+
+        public void Dispose()
+        {
+            _liteClient.Disconnect();
+        }
     }
 }

TonSdk.Client/src/Models/Transformers.cs

@@ -1014,7 +1014,9 @@ internal static object ParseStackItem(object[] item)
                         string slice = isNegative ? valueStr.Substring(3) : valueStr.Substring(2);
 
                         if (slice.Length % 2 != 0)
+                        {
                             slice = "0" + slice;
+                        }
 
                         int length = slice.Length;
                         byte[] bytes = new byte[length / 2];
@@ -1023,8 +1025,16 @@ internal static object ParseStackItem(object[] item)
                             bytes[i / 2] = Convert.ToByte(slice.Substring(i, 2), 16);
                         }
 
-                        var bigInt = new BigInteger(bytes.Reverse().ToArray());
+                        if (bytes[0] >= 0x80)
+                        {
+                            byte[] temp = new byte[bytes.Length + 1];
+                            Array.Copy(bytes, 0, temp, 1, bytes.Length);
+                            bytes = temp;
+                        }
 
+                        Array.Reverse(bytes);
+                        var bigInt = new BigInteger(bytes);
+                        
                         return isNegative ? 0 - bigInt : bigInt;
                     }
                 case "cell":

TonSdk.Client/src/TonSdk.Client.csproj

@@ -6,7 +6,7 @@
         <LangVersion>8.0</LangVersion>
         <RootNamespace>TonSdk.Client</RootNamespace>
         <PackageId>TonSdk.Client</PackageId>
-        <Version>0.3.3</Version>
+        <Version>0.3.4</Version>
         <Authors>Continuation Team</Authors>
         <PackageDescription>Ton Client library for work with HTTP API and Lite Servers.</PackageDescription>
         <RepositoryUrl>https://github.com/continuation-team/TonSdk.NET</RepositoryUrl>

TonSdk.Client/test/Client.test.cs

@@ -1,4 +1,5 @@
 using System;
+using System.Numerics;
 using System.Threading.Tasks;
 using NUnit.Framework;
 using TonSdk.Core;
@@ -13,6 +14,54 @@ public class ClientTest
         new HttpParameters() { Endpoint = "https://toncenter.com/api/v3/", ApiKey = "841a5532a6549cc38f465973eab609c9acb34bb8a15608c85468af38a2842cc9" });
     TonClient client_lite = new TonClient(TonClientType.LITECLIENT, new LiteClientParameters("5.9.10.47", 19949, "n4VDnSCUuSpjnCyUk9e3QOOd6o0ItSWYbTnW3Wnn8wk="));
 
+    [OneTimeTearDown]
+    public void TearDown()
+    {
+        client.Dispose();
+        client_lite.Dispose();
+        clientv3.Dispose();
+    }
+    
+    private BigInteger ParseStackItemNum(string valueStr)
+    { 
+        bool isNegative = valueStr[0] == '-';
+        string slice = isNegative ? valueStr.Substring(3) : valueStr.Substring(2);
+                        
+        if (slice.Length % 2 != 0)
+        {
+            slice = "0" + slice;
+        }
+
+        int length = slice.Length;
+        byte[] bytes = new byte[length / 2];
+        for (int i = 0; i < length; i += 2)
+        {
+            bytes[i / 2] = Convert.ToByte(slice.Substring(i, 2), 16);
+        }
+                        
+        if (bytes[0] >= 0x80)
+        {
+            byte[] temp = new byte[bytes.Length + 1];
+            Array.Copy(bytes, 0, temp, 1, bytes.Length);
+            bytes = temp;
+        }
+
+        Array.Reverse(bytes);
+        var bigInt = new BigInteger(bytes);
+                        
+        return isNegative ? 0 - bigInt : bigInt;
+    }
+    
+    [Test]
+    public void Test_ParseStackItemNum()
+    {
+        Assert.That(ParseStackItemNum("0xf") == 15, Is.EqualTo(true));
+        Assert.That(ParseStackItemNum("0x0f") == 15, Is.EqualTo(true));
+        Assert.That(ParseStackItemNum("0x10") == 16, Is.EqualTo(true));
+        Assert.That(ParseStackItemNum("0x159ecd52") == 362728786, Is.EqualTo(true));
+        Assert.That(ParseStackItemNum("0x9a") == 154, Is.EqualTo(true));
+    }
+    
     [Test]
     public async Task Test_AddressBalance()
     {

TonSdk.Client/test/LiteClientApi.test.cs

@@ -17,6 +17,12 @@ public void SetUpTest()
     {
         _client = new TonClient(TonClientType.LITECLIENT, new LiteClientParameters("5.9.10.47", 19949, "n4VDnSCUuSpjnCyUk9e3QOOd6o0ItSWYbTnW3Wnn8wk="));
     }
+    
+    [TearDown]
+    public void TearDownTest()
+    {
+        _client.Dispose();
+    }
 
     [Test]
     public async Task Test_GetAddressInformation()