From a2b3a040b7a3445389a66824e604aa5f1776c66a Mon Sep 17 00:00:00 2001
From: Philip Offtermatt <57488781+p-offtermatt@users.noreply.github.com>
Date: Mon, 24 Jun 2024 17:07:51 +0200
Subject: [PATCH] docs: Add link to feemarket querying (#3163)

* Add link to feemarket querying

* Add pointer to feemarket integration guide

* Add back bash instructions

* Add concrete commands to doc
---
 docs/docs/hub-tutorials/gaiad.md | 29 ++++++++++++++++++++++-------
 1 file changed, 22 insertions(+), 7 deletions(-)

diff --git a/docs/docs/hub-tutorials/gaiad.md b/docs/docs/hub-tutorials/gaiad.md
index 09480cbaadf..4b5cabcc58f 100644
--- a/docs/docs/hub-tutorials/gaiad.md
+++ b/docs/docs/hub-tutorials/gaiad.md
@@ -171,14 +171,11 @@ is included in a block.
 
 ### Fees & Gas
 
-Each transaction may either supply fees or gas prices, but not both.
-
-Validator's have a minimum gas price (multi-denom) configuration and they use
-this value when determining if they should include the transaction in a block during `CheckTx`, where `gasPrices >= minGasPrices`. Note, your transaction must supply fees that are greater than or equal to **any** of the denominations the validator requires.
-
-**Note**: With such a mechanism in place, validators may start to prioritize
-txs by `gasPrice` in the mempool, so providing higher fees or gas prices may yield higher tx priority.
+The Cosmos Hub uses the `x/feemarket` module to
+dynamically vary the gas price based on demand.
 
+You need to specify a sufficient gas price or total fees
+to ensure that your transaction is included in a block,
 e.g.
 
 ```bash
@@ -191,6 +188,24 @@ or
 gaiad tx bank send ... --gas-prices=0.0025uatom
 ```
 
+To find out more about the current minimal gas price, you can query the feemarket module:
+```bash
+gaiad q feemarket gas-prices
+```
+or
+```bash
+gaiad q feemarket gas-prices uatom
+```
+which will output the current gas price similar to this:
+```bash
+price:  
+  amount: "0.005"  
+  denom: uatom  
+```
+
+For more information, check out how to query the [feemarket](https://github.com/skip-mev/feemarket/blob/main/docs/SPEC.md#gas-price),
+or check out the [feemarket integration guide](https://github.com/skip-mev/feemarket/blob/main/docs/INTEGRATIONS.md).
+
 ### Account
 
 #### Get Tokens