Merge pull request 0xPolygon#65 from 0xPolygon/empieichO-docs-review

update and adding gas station doc

Author: kmurphypolygon

docs/miden/index.md

@@ -6,4 +6,4 @@ Polygon Miden is an in-development zero-knowledge (ZK) rollup running the Miden
 <div class="flex-figure-right">
 <img src="../img/miden/miden.svg" class="figure figure-right" alt="" />
 </div>
-</div>
+</div>

docs/zkEVM/get-started/zkevm-gas-station.md

@@ -0,0 +1,87 @@
+The goal of Polygon zkEVM Gas Station is to provide dApp developers with gas pricing suggestions so they can use them before sending transactions to the Polygon zkEVM network. The prediction method is modeled after the [Polygon Gas Station](https://wiki.polygon.technology/docs/tools/faucets/polygon-gas-station) but is unique in its own way.
+
+Polygon zkEVM Gas Station is currently deployed on the zkEVM Mainnet Beta and Blueberry Testnet, where it analyzes recent 1500 transactions and recommends gas prices.
+
+## Usage
+
+<Tabs
+  defaultValue="mainnet"
+  values={[
+    { label: 'zkEVM Mainnet Beta', value: 'mainnet', },
+    { label: 'zKEVM Testnet', value: 'testnet', },
+  ]
+}>
+
+<TabItem value="testnet">
+
+Send a GET request to the [zkEVM Gas Station endpoint](https://gasstation-testnet.polygon.technology/zkevm) to get a gas price recommendation from this oracle.
+
+#### cURL
+
+```bash
+curl https://gasstation-testnet.polygon.technology/zkevm
+```
+
+#### JavaScript
+
+```javascript
+fetch('https://gasstation-testnet.polygon.technology/zkevm')
+  .then(response => response.json())
+  .then(json => console.log(json))
+```
+
+#### Python
+
+```python
+import requests
+requests.get('https://gasstation-testnet.polygon.technology/zkevm').json()
+```
+
+</TabItem>
+
+<TabItem value="mainnet">
+
+Send a GET request to the [zkEVM Gas Station endpoint](https://gasstation.polygon.technology/zkevm) to get a gas price recommendation from this oracle.
+
+#### cURL
+
+```bash
+curl https://gasstation.polygon.technology/zkevm
+```
+
+#### JavaScript
+
+```javascript
+fetch('https://gasstation.polygon.technology/zkevm')
+  .then(response => response.json())
+  .then(json => console.log(json))
+```
+
+#### Python
+
+```python
+import requests
+requests.get('https://gasstation.polygon.technology/zkevm').json()
+```
+
+</TabItem>
+</Tabs>
+
+## Interpretation
+
+An example JSON response will look like this.
+
+```json
+{
+    "safeLow":1,
+    "standard":1,
+    "fast":1,
+    "fastest":1,
+    "blockTime":2,
+    "blockNumber":308789
+}
+```
+
+- {`safelow`, `standard`, `fast`, `fastest`} are gas prices in Gwei, you can use these prices before sending the transaction off to Polygon zkEVM, depending upon your needs.
+- `blockTime`, in seconds, gives the average block time of the network.
+- `blockNumber` provides the information of the latest block mined when the recommendation was made.

mkdocs.yml

@@ -80,6 +80,7 @@ nav:
           - Connecting to zkEVM: zkEVM/get-started/quick-start/connect-wallet.md
           - Using Polygon faucet: zkEVM/get-started/quick-start/zkevm-faucet.md
           - Bridging assets to zkEVM: zkEVM/get-started/quick-start/bridge-to-zkevm.md
+        - Gas station: zkEVM/get-started/zkevm-gas-station.md
         - Setup nodes:
           - Setup local zkNode: zkEVM/get-started/setup-nodes/local-node.md
           - Setup production zkNode: zkEVM/get-started/setup-nodes/production-node.md