Gas Fees

Telliot has flags you can use to manipulate the Gas values used in the transactions

Estimating Gas Fees

Run telliot report --help (top of the instructions) for the options related to gas.

These values should be expressed in BEATS (GWEI). For example, if you want to use 1500000000 IMPULSE (WEI) as maxPriorityFeePerGas, you need to pass -mf 1.5 BEATS (GWEI).

Gas calculations are complex and should be done carefully.

Test it first and do diligent research on how Gas and transaction fees work before running any settings in Mainnet, risking losing PLS by having the transaction revert due to bad configuration.

Gas Setting Flags:

-gl, --gas-limit INTEGER

What it does: Sets the maximum computational units (gas) the transaction is allowed to use. Think of it as a "fuel tank size" limit for your transaction.

Purpose: Acts as a safety measure to prevent a transaction from accidentally consuming huge amounts of gas.

Example: -gl 300000 (Allow the transaction to use up to 300,000 gas units).

-mf, --max-fee FLOAT

What it does: (EIP-1559 / Type 2 Only) Sets the absolute maximum total fee (base fee + priority fee/tip) you are willing to pay per gas unit, specified in Gwei.

Purpose: Your total budget cap per unit of gas. The transaction will never cost more per gas unit than this value.

Example: -mf 50.5 (Willing to pay up to 50.5 Gwei total per gas unit).

-pf, --priority-fee FLOAT

What it does: (EIP-1559 / Type 2 Only) Sets the specific "tip" (maxPriorityFeePerGas) paid directly to the validator per gas unit, specified in Gwei.

Purpose: Incentivizes validators to include your transaction faster, especially during busy times. Using this overrides any automatic tip calculation and the -mpfr cap.

Example: -pf 4.5 (Offer a 4.5 Gwei tip per gas unit to the validator).

-bf, --base-fee FLOAT

What it does: (EIP-1559 / Type 2 Only) Manually sets the base fee part of the gas cost, specified in Gwei.

Purpose: Overrides the current base fee dictated by the network. Make sure you know what you're doing before using this, since it may revert the transaction or not even submit.

Example: -bf 40 (Force the transaction to use a base fee of 40 Gwei, ignoring the network's current base fee).

-tx, --tx-type TEXT

What it does: Explicitly chooses the transaction format. Use 0 for Legacy or 2 for EIP-1559. (PulseChain uses tx 2)

Purpose: Ensures the correct fee parameters.

Example: -tx 2 (Submit this transaction using the modern EIP-1559 format).

-mpfr, --max-priority-fee-range INTEGER

What it does: (EIP-1559 / Type 2 Only) Sets a maximum limit or ceiling (in Gwei) on the automatically calculated priority fee/tip (-pf). Only used if you don't provide -pf manually. The default is 3 Gwei.

Purpose: Acts as a safety cap to prevent paying extremely high tips during automatic calculation, especially during network volatility.

Example: -mpfr 5 (Allow the automatic tip calculation to go up to 5 Gwei, but no higher).