Engine - Nonce management improvements

Engine - Nonce management improvements

We've made Engine even more reliable in v2.1.20. Here's a sample of nonce management improvements we made:

Improved handling of stuck transactions

Transactions can be stuck in mempool for multiple reasons (usually chain-specific). We made improvements to more aggressively retry transactions through including:

  • Retries with increasing gas (up to 10x gas).
  • Retries after a fixed amount of time, even if the RPC blocks are delayed.
  • Configuration to limit the max gas to spend on resends to stay within chain limits.
  • Configuration to limit how long to retry a transaction for.

Automatic nonce reset when out of funds

Engine resets the nonce when a wallet runs out of funds to ensure that after the wallet is funded, transactions are sent with correct nonces.

Retry failed transactions, even userOps

The Retry Failed Transactions now allows retrying any failed transactions including user operations.

Want to force a specific transaction to retry with the same nonce? Use the Retry Transaction (Synchronous) endpoint.

Advanced usage to manage wallet nonces

Most users should rely on Engine to manage and correct wallet nonces. If you want more direct control, the following endpoints allow you to directly manage Engine's wallet nonces. These endpoints are safe to run and intended to "fix" wallets that are stuck. Be warned they may cancel any pending transactions with those nonces.

Reset nonce state for one or all wallets

The Reset Nonces endpoint was updated to optionally allow resetting the nonce state for a single wallet (by default it resets all wallets).

Cancel nonces

A new Cancel Nonces endpoint allows you to send null transactions with high gas to effectively "cancel" pending transactions using those nonces.


thirdweb is hiring!

The small team at thirdweb is on a mission to build the most intuitive and complete web3 platform. Our products empower over 70,000 developers each month including Shopify, AWS, Coinbase, Rarible, Animoca Brands, and InfiniGods.

See our open roles. We’d love to work with you!