Merge branch 'feature/#62' into Manual-Test

src/BscScan.NetCore/Constants/Constants.cs

@@ -73,6 +73,7 @@ internal static class ProxyModuleAction
     public const string ETH_GET_TRANSACTION_RECEIPT = "eth_getTransactionReceipt";
     public const string ETH_CALL = "eth_call";
     public const string ETH_GET_CODE = "eth_getCode";
+    public const string ETH_GET_STORAGE_AT = "eth_getStorageAt";
 }
 
 
@@ -93,6 +94,7 @@ internal static class BscQueryParam
     public const string Hex = "hex={value}";
     public const string To = "to={value}";
     public const string Data = "data={value}";
+    public const string Position = "position={value}";
 }
 
 internal static class MimeTypes

src/BscScan.NetCore/Contracts/IBscScanGethProxyService.cs

@@ -20,7 +20,7 @@ public interface IBscScanGethProxyService
         /// eth_getBlockByNumber
         /// </summary>
         /// <param name="tag">the block number, in hex eg. 0xC36B3C</param>
-        /// when true, returns full transaction objects and their information, when false only returns a list of transactions.</param>
+        /// when true, returns full transaction objects and their information, when false only returns a list of transactions.
         /// <returns>Returns information about a block by block number.</returns>
         Task<BlockByNumber?> EthGetBlockByNumber(string tag);
 
@@ -84,5 +84,15 @@ public interface IBscScanGethProxyService
         /// <param name="tag">the string pre-defined block parameter, either earliest, pending or latest</param>
         /// <returns>Returns code at a given address.</returns>
         Task<EthCode?> EthGetCode(string address, Tag tag = Tag.Latest);
+
+        /// <summary>
+        /// eth_getStorageAt
+        /// Note: This endpoint is still experimental and may have potential issues
+        /// </summary>
+        /// <param name="address">the string representing the address to get code</param>
+        /// <param name="position">the hex code of the position in storage, eg 0x0</param>
+        /// <param name="tag">the string pre-defined block parameter, either earliest, pending or latest</param>
+        /// <returns>Returns the value from a storage position at a given address.</returns>
+        Task<EthStorageAt?> EthGetStorageAt(string address,string position, Tag tag = Tag.Latest);
     }
 }

src/BscScan.NetCore/Models/Response/Proxy/EthCode.cs

@@ -3,7 +3,7 @@
 namespace BscScan.NetCore.Models.Response.Proxy
 {
     /// <summary>
-    /// 
+    /// EthCode
     /// </summary>
     public class EthCode
     {

src/BscScan.NetCore/Models/Response/Proxy/EthStorageAt.cs

@@ -0,0 +1,28 @@
+using System.Text.Json.Serialization;
+
+namespace BscScan.NetCore.Models.Response.Proxy
+{
+    /// <summary>
+    /// EthStorageAt
+    /// </summary>
+    public class EthStorageAt
+    {
+        /// <summary>
+        /// JsonRpc
+        /// </summary>
+        [JsonPropertyName("jsonrpc")]
+        public string? JsonRpc { get; set; }
+
+        /// <summary>
+        /// Id
+        /// </summary>
+        [JsonPropertyName("id")]
+        public int Id { get; set; }
+
+        /// <summary>
+        /// result
+        /// </summary>
+        [JsonPropertyName("result")]
+        public string? Result { get; set; }
+    }
+}

src/BscScan.NetCore/Services/BscScanGethProxyService.cs

@@ -159,5 +159,21 @@ public BscScanGethProxyService(HttpClient bscScanHttpClient, BscScanConfiguratio
             var result = await JsonSerializer.DeserializeAsync<EthCode>(responseStream);
             return result;
         }
+
+        /// <inheritdoc />
+        public async Task<EthStorageAt?> EthGetStorageAt(string address, string position, Tag tag = Tag.Latest)
+        {
+            var queryParameters = $"{_bscScanModule}".AddAction(ProxyModuleAction.ETH_GET_STORAGE_AT)
+                .AddQuery(BscQueryParam.Tag.AppendValue(tag.ToString().ToLower()))
+                .AddQuery(BscQueryParam.Position.AppendValue(position))
+                .AddQuery(BscQueryParam.Address.AppendValue(address));
+            using var response = await BscScanHttpClient.GetAsync($"{queryParameters}")
+                .ConfigureAwait(false);
+
+            response.EnsureSuccessStatusCode();
+            await using var responseStream = await response.Content.ReadAsStreamAsync().ConfigureAwait(false);
+            var result = await JsonSerializer.DeserializeAsync<EthStorageAt>(responseStream);
+            return result;
+        }
     }
 }