speedUpTxAction()

speedUpTxAction<T>(params): Promise<`0x${string}`>

Speeds up a pending EVM transaction: asks the connected wallet to resend it (same to, value, input and nonce) with both EIP-1559 fees 15% above the fees last sent for this nonce, and at least at the market estimate, since a transaction stuck below the base fee stays stuck with 15% more. When it is mined, the tracker of the original transaction reports it as Replaced with replacedReason: 'repriced'. In a createPulsarStore store a new record under the new hash, linked by replaces, then goes on to the result: do not add the returned hash to the pool yourself.

Side effects: reads the fees of the chain over RPC, opens a wallet prompt, broadcasts a transaction, and keeps the fees sent for the next replacement of this nonce, in memory and in sessionStorage under pulsar-evm:replacementFees:<chain>:<sender>:<nonce>.

Type Parameters

T

T extends Transaction

The application transaction type.

Parameters

params

The wagmi config and the transaction.

config

Config

The wagmi config of the app.

tx

T

The pending transaction. It must be an EVM transaction with nonce, from, to, value, maxFeePerGas and maxPriorityFeePerGas (set by the EVM tracker once the transaction details are fetched).

Returns

Promise<`0x${string}`>

The hash of the replacement transaction.

Throws

Error when the transaction is not an EVM transaction or lacks the required fields, and Error('Failed to speed up transaction: …') (with the original error as cause) when no account is connected, the connected account did not send the transaction (from another account the same transfer would be sent a second time), or the wallet rejects or fails to send the transaction.

Example


const hash = await speedUpTxAction({ config: wagmiConfig, tx: pendingTx });