# Gas Price Strategies
Airnode supports different strategies to calculate the gas price that it should
use for submitting transactions. These can be defined in the config.json.
The supported strategies include:
latestBlockPercentileGasPriceproviderRecommendedGasPriceproviderRecommendedEip1559GasPriceconstantGasPrice
The strategies are attempted in the order that they are defined in config.json
where the Airnode will move on to the next strategy in the list if the current
fails. The only required strategy to be included is constantGasPrice which is
intended to be used as the final fallback if all other strategies fail to return
a gas price. Therefore, constantGasPrice should be set as the last strategy in
the list.
# latestBlockPercentileGasPrice
The latestBlockPercentileGasPrice strategy calculates a gas price based on the
specified percentile of previous transactions in recent blocks and sets the
transaction to type 0 and a gasPrice value. The parameters that the strategy
uses to calculate the gas price can be configured.
{
"gasPriceStrategy": "latestBlockPercentileGasPrice",
"percentile": 60,
"minTransactionCount": 20,
"pastToCompareInBlocks": 20,
"maxDeviationMultiplier": 2
}
2
3
4
5
6
7
# percentile
(required) - The percentile of gas prices to return from a block.
# minTransactionCount
(required) - The minimum amount of transactions required in a block to use for calculating a gas price percentile.
# pastToCompareInBlocks
(required) - The number of blocks to look back for the reference block.
# maxDeviationMultiplier
(required) - The maximum deviation multiplier of the latest block gas price percentile compared to the reference block gas price percentile. Used to protect against large gas price spikes.
# providerRecommendedGasPrice
The providerRecommendedGasPrice strategy gets a gas price estimate from the
provider, applies the defined multiplier to it and sets the transaction
totype 0 and a gasPrice value.
{
"gasPriceStrategy": "providerRecommendedGasPrice",
"recommendedGasPriceMultiplier": 1.2
}
2
3
4
# recommendedGasPriceMultiplier
(required) - A number with a maximum of two decimals that gets multiplied by the
provider reported gas price. The resulting Gas Price will equal
Gas Price * providerRecommendedGasPrice.
# providerRecommendedEip1559GasPrice
The providerRecommendedEip1559GasPrice strategy gets an EIP1559 fee data
estimate from the provider and applies the configured baseFeeMultiplier and
priorityFee values returning a type 2 transaction with maxFeePerGas and
maxPriorityFeePerGas values.
{
"gasPriceStrategy": "providerRecommendedEip1559GasPrice",
"baseFeeMultiplier": 2,
"priorityFee": {
"value": 3.12,
"unit": "gwei"
}
}
2
3
4
5
6
7
8
# baseFeeMultiplier
(required) - Number multiplied by the Base Fee to yield the Maximum Fee for
EIP-1559 transactions. Defaults to: 2. The resulting Maximum Fee will equal
(Base Fee * baseFeeMultiplier) + priorityFee.
# priorityFee
(required) - An object that configures the EIP-1559 Priority Fee. Defaults:
{"value": 3.12, "unit": "gwei"}.
# priorityFee.value
(required) - A number specifying the EIP-1559 priority fee value.
# priorityFee.unit
(required) - The unit of the priority fee value. It can be one of the following: (wei, kwei, mwei, gwei, szabo, finney, ether).
# constantGasPrice
The constantGasPrice strategy returns a type 0 gas price with the configured
gasPrice value. This strategy is intended to be used as a fallback in the case
that the other strategies fail to return a gas price.
{
"gasPriceStrategy": "constantGasPrice",
"gasPrice": {
"value": 10,
"unit": "gwei"
}
}
2
3
4
5
6
7
# gasPrice
(required) - An object of the form {"value": 0, "unit": "wei"} that configures
the amount to use as gas price.