gas tracker API implementation

Author: abhaygupta1999

Diff for: src/main/java/io/api/etherscan/core/IGasTrackerApi.java

@@ -0,0 +1,23 @@
+package io.api.etherscan.core;
+
+import io.api.etherscan.error.ApiException;
+import io.api.etherscan.model.GasOracle;
+import org.jetbrains.annotations.NotNull;
+
+/**
+ * EtherScan - API Descriptions https://docs.etherscan.io/api-endpoints/gas-tracker
+ *
+ * @author Abhay Gupta
+ * @since 14.11.2022
+ */
+public interface IGasTrackerApi {
+
+    /**
+     * GasOracle details
+     *
+     * @return fast, suggested gas price
+     * @throws ApiException parent exception class
+     */
+    @NotNull
+    GasOracle gasoracle() throws ApiException;
+}

Diff for: src/main/java/io/api/etherscan/core/impl/EtherScanApi.java

@@ -34,6 +34,7 @@ public class EtherScanApi implements AutoCloseable {
     private final IProxyApi proxy;
     private final IStatisticApi stats;
     private final ITransactionApi txs;
+    private final IGasTrackerApi gastracker;
 
     public EtherScanApi() {
         this(DEFAULT_KEY, EthNetwork.MAINNET);
@@ -96,6 +97,7 @@ public EtherScanApi(final String apiKey,
         this.proxy = new ProxyApiProvider(queue, baseUrl, executor);
         this.stats = new StatisticApiProvider(queue, baseUrl, executor);
         this.txs = new TransactionApiProvider(queue, baseUrl, executor);
+        this.gastracker = new GasTrackerApiProvider(queue, baseUrl, executor);
     }
 
     @NotNull
@@ -133,6 +135,11 @@ public IStatisticApi stats() {
         return stats;
     }
 
+    @NotNull
+    public IGasTrackerApi gastracker() {
+        return gastracker;
+    }
+
     @Override
     public void close() throws Exception {
         queueManager.close();

Diff for: src/main/java/io/api/etherscan/core/impl/GasTrackerApiProvider.java

@@ -0,0 +1,39 @@
+package io.api.etherscan.core.impl;
+
+import io.api.etherscan.core.IGasTrackerApi;
+import io.api.etherscan.error.ApiException;
+import io.api.etherscan.error.EtherScanException;
+import io.api.etherscan.executor.IHttpExecutor;
+import io.api.etherscan.manager.IQueueManager;
+import io.api.etherscan.model.GasOracle;
+import io.api.etherscan.model.utility.GasOracleResponseTO;
+import org.jetbrains.annotations.NotNull;
+
+/**
+ * GasTracker API Implementation
+ *
+ * @see IGasTrackerApi
+ *
+ * @author Abhay Gupta
+ * @since 14.11.2022
+ */
+public class GasTrackerApiProvider extends BasicProvider implements IGasTrackerApi {
+
+    private static final String ACT_GAS_ORACLE_PARAM = ACT_PREFIX + "gasoracle";
+
+    GasTrackerApiProvider(final IQueueManager queue,
+                          final String baseUrl,
+                          final IHttpExecutor executor) {
+        super(queue, "gastracker", baseUrl, executor);
+    }
+
+    @NotNull
+    @Override
+    public GasOracle gasoracle() throws ApiException {
+        final GasOracleResponseTO response = getRequest(ACT_GAS_ORACLE_PARAM, GasOracleResponseTO.class);
+        if (response.getStatus() != 1)
+            throw new EtherScanException(response);
+
+        return response.getResult();
+    }
+}

Diff for: src/main/java/io/api/etherscan/model/GasOracle.java

@@ -0,0 +1,68 @@
+package io.api.etherscan.model;
+
+import java.math.BigInteger;
+import java.util.Objects;
+
+/**
+ * ! NO DESCRIPTION !
+ *
+ * @author Abhay Gupta
+ * @since 14.11.2022
+ */
+public class GasOracle {
+    private Long LastBlock;
+    private Integer SafeGasPrice;
+    private Integer ProposeGasPrice;
+    private Integer FastGasPrice;
+    private Double suggestBaseFee;
+    private String gasUsedRatio;
+
+    public Long getLastBlock() {
+        return LastBlock;
+    }
+
+    public BigInteger getSafeGasPriceInWei() {
+        return BigInteger.valueOf(SafeGasPrice).multiply(BigInteger.TEN.pow(9));
+    }
+
+    public BigInteger getProposeGasPriceInWei() {
+        return BigInteger.valueOf(ProposeGasPrice).multiply(BigInteger.TEN.pow(9));
+    }
+
+    public BigInteger getFastGasPriceInWei() {
+        return BigInteger.valueOf(FastGasPrice).multiply(BigInteger.TEN.pow(9));
+    }
+
+    public Double getSuggestBaseFee() {
+        return suggestBaseFee;
+    }
+
+    public String getGasUsedRatio() {
+        return gasUsedRatio;
+    }
+
+    @Override
+    public boolean equals(Object o) {
+        if (this == o) return true;
+        if (o == null || getClass() != o.getClass()) return false;
+        GasOracle gasOracle = (GasOracle) o;
+        return LastBlock.equals(gasOracle.LastBlock) && SafeGasPrice.equals(gasOracle.SafeGasPrice) && ProposeGasPrice.equals(gasOracle.ProposeGasPrice) && FastGasPrice.equals(gasOracle.FastGasPrice) && suggestBaseFee.equals(gasOracle.suggestBaseFee) && gasUsedRatio.equals(gasOracle.gasUsedRatio);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(LastBlock, SafeGasPrice, ProposeGasPrice, FastGasPrice, suggestBaseFee, gasUsedRatio);
+    }
+
+    @Override
+    public String toString() {
+        return "GasOracle{" +
+                "LastBlock=" + LastBlock +
+                ", SafeGasPrice=" + SafeGasPrice +
+                ", ProposeGasPrice=" + ProposeGasPrice +
+                ", FastGasPrice=" + FastGasPrice +
+                ", suggestBaseFee=" + suggestBaseFee +
+                ", gasUsedRatio='" + gasUsedRatio + '\'' +
+                '}';
+    }
+}

Diff for: src/main/java/io/api/etherscan/model/utility/GasOracleResponseTO.java

@@ -0,0 +1,18 @@
+package io.api.etherscan.model.utility;
+
+import io.api.etherscan.model.GasOracle;
+
+/**
+ * ! NO DESCRIPTION !
+ *
+ * @author Abhay Gupta
+ * @since 14.11.2022
+ */
+public class GasOracleResponseTO extends BaseResponseTO {
+
+    private GasOracle result;
+
+    public GasOracle getResult() {
+        return result;
+    }
+}