docs: SendAggregatedResponse and gas price calc

Author: MarcosNicolau

core/chainio/avs_writer.go

@@ -76,7 +76,10 @@ func NewAvsWriterFromConfig(baseConfig *config.BaseConfig, ecdsaConfig *config.E
 	}, nil
 }
 
-func (w *AvsWriter) SendAggregatedResponse(batchIdentifierHash [32]byte, batchMerkleRoot [32]byte, senderAddress [20]byte, nonSignerStakesAndSignature servicemanager.IBLSSignatureCheckerNonSignerStakesAndSignature) (*types.Receipt, error) {
+// Sends AggregatedResponse and waits for the receipt for three blocks, if not received
+// it will try again bumping the last tx gas price based on `CalculateGasPriceBump`
+// This process happens indefinitely until the transaction is included.
+func (w *AvsWriter) SendAggregatedResponse(batchIdentifierHash [32]byte, batchMerkleRoot [32]byte, senderAddress [20]byte, nonSignerStakesAndSignature servicemanager.IBLSSignatureCheckerNonSignerStakesAndSignature, onRetry func()) (*types.Receipt, error) {
 	txOpts := *w.Signer.GetTxOpts()
 	txOpts.NoSend = true // simulate the transaction
 	tx, err := w.AvsContractBindings.ServiceManager.RespondToTaskV2(&txOpts, batchMerkleRoot, senderAddress, nonSignerStakesAndSignature)
@@ -99,9 +102,6 @@ func (w *AvsWriter) SendAggregatedResponse(batchIdentifierHash [32]byte, batchMe
 	txOpts.NoSend = false
 	txOpts.Nonce = txNonce
 
-	// Sends a transaction and waits for the receipt for three blocks, if not received
-	// it will try again bumping the gas price based on `CalculateGasPriceBumpBasedOnRetry`
-	// This process happens indefinitely until we sendTransaction does not return err.
 	lastTxGasPrice := tx.GasPrice()
 	sendTransaction := func() (*types.Receipt, error) {
 		bumpedGasPrice := utils.CalculateGasPriceBump(lastTxGasPrice, gasBumpPercentage)

core/utils/eth_client_utils.go

@@ -48,8 +48,8 @@ func BytesToQuorumThresholdPercentages(quorumThresholdPercentagesBytes []byte) e
 	return quorumThresholdPercentages
 }
 
-// Very basic algorithm to calculate the gasPrice bump based on the currentGasPrice and retry iteration.
-// It adds a i/10 percentage to the current prices, where i represents the iteration.
+// Very basic algorithm to calculate the gasPrice bump based on the currentGasPrice and percentage.
+// It adds a the percentage to the current gas price.
 func CalculateGasPriceBump(currentGasPrice *big.Int, percentage int) *big.Int {
 	percentageBump := new(big.Int).Div(big.NewInt(int64(percentage)), big.NewInt(100))
 	bumpAmount := new(big.Int).Mul(currentGasPrice, percentageBump)