Sending Web3 Transactions In Node.js — Nonce Hell. | by Nonse Odion | May, 2022

The nonce is a crucial a part of EVM accounts. Know the way it’s managed

Hellish Numbers. Credit score: Unsplah

Have you ever ever been greeted with the next error when sending a web3 transaction in Node?

substitute payment too low [ See: ]


the tx doesn’t have the proper nonce. account has nonce of: 95 tx has nonce of: 94

This suggests that your transaction comprises a nonce that has already been utilized in one in every of your earlier transactions.

A nonce is a quantity connected to each transaction you ship on Ethereum or some other blockchain that makes use of the Ethereum Digital Machine (EVM) just like the Binance Smartchain and Avalanche.

It begins at zero in your first transaction and increments by one (+1) for subsequent transactions. This permits every transaction from an deal with to have a singular nonce. Since it’s distinctive for each transaction, it helps forestall double-spend assaults.

A double-spend assault is when an deal with tries to spend its present stability twice. One thing so simple as amassing your change from the salesgirl in your native grocery retailer and calling the shop proprietor to gather the identical cash is a double-spend assault. Two transactions from an deal with can’t have the identical nonce, one in every of them can be rejected by the blockchain community. In order that error comes from the transaction the blockchain rejected.

Word: There’s additionally the block nonce used to mine blocks in Proof of Work (POW) chains like Ethereum and Bitcoin. It’s fully totally different and separate from the nonce talked about right here.

Once you ship a transaction in Node.js utilizing a web3 library, it mechanically detects the nonce for you if you don’t specify it. It does this by querying your nonce from the blockchain and attaching it to your transaction. It will get wild from right here, stick with me.

Let’s say you wish to ship two transactions on the similar time and also you don’t specify their nonce, the library mechanically detects the nonce and attaches it to the primary transaction. When it will get to the second transaction, it mechanically detects it once more and attaches it. However there’s a catch, are you able to attempt guessing the place the problem is earlier than you learn on?

The primary transaction despatched will get the most recent nonce however when the second transaction is being despatched, it will get the identical nonce as the primary which makes it invalid. It will get the identical nonce as the primary as a result of when the library tries to get the nonce once more, it receives the identical nonce from the blockchain. This occurs as a result of the primary transaction hasn’t been mined but. If it was mined, it could replace the nonce and the library would obtain the precise worth.

Frontend code makes use of a pockets to ship transactions. These wallets reminiscent of Metamask and Trustwallet are capable of observe the nonce so that you by no means get to see these errors. The nonce could be modified on these wallets earlier than sending transactions. That is helpful for canceling transactions.

It’s fairly easy actually, you simply should know the precise nonce earlier than sending the transaction. You possibly can determine to implement a nonce tracker that retains observe of the transactions you ship or simply merely wait till a transaction is mined earlier than sending the following one. Let’s take a look at how a nonce tracker would work with just a little node app.

The next code is written in node with Typescript and Ethers.js and runs on Rinkeby Testnet. It’s hosted on Github. Right here’s the primary piece of code.


We configure the Ethers.js library with the Rinkeby supplier and our personal key from the atmosphere variable. Let’s take a look at the sendTx perform which handles sending transactions and tracks the nonce.


This piece of code receives the configured web3 and makes use of it to ship the transaction. Every transaction is anticipated to ship the transaction parameters. We don’t make use of Ethers.js well-known transaction.wait as a result of we’re not giving suggestions to a person, in contrast to frontend code. This permits us to ship a number of transactions that may all get mined in the identical block. The 2 most necessary elements of this code are the nonce and the lock. Let’s take a look at them.

Earlier than we ship the transaction, we connect the nonce we predict is the latest. The nonce is first gotten from the blockchain and incremented after each transaction. We additionally ensure that to verify for the most recent nonce earlier than sending the transaction simply in case there are different transactions despatched with this deal with however not from us i.e the pockets is perhaps utilized in a distinct place. This overseas transaction would additionally have an effect on the nonce, so we have now to concentrate on it. We outline the nonce outdoors the perform so its worth persists even after each sendTx name. The sendTx perform accesses it utilizing Javascripts closure property.

From the code you’ll discover a lock is used, the lock helps to pause every sendTx name till the decision previous it’s accomplished. This helps ensure that all sendTx calls irrespective of the place they originate from our little node app are executed sequentially. The lock works by placing all of the calls in an array and executing them one after the opposite. lock.purchase places the decision within the array and pauses it whereas lock.launch lets the following name within the array run. With out the lock, calls to sendTx would run in parallel and make use of the identical nonce worth.

Listed below are our easy transactions:


The 2 transactions simply ship ETH.

We run them like this.


tx1 and tx2 are deliberately referred to as with out an await to indicate how our code would deal with sendTx calls from unbiased locations in our app. The code sends 10 transactions at nearly the identical time by calling sendTx. The transactions are all queued and executed sequentially due to our lock. They’ll even all be mined in the identical block.

Once we run the code it queues all of the transactions, will get the nonce and executes them sequentially. This fashion we’re in a position to make sure every transaction will get the precise nonce. The queuing and nonce monitoring happen due to our lock and the best way we observe the nonce with out them we might get the error above.

Simply so you recognize, if you happen to run the code above, you’re successfully deploying 10 contracts. It’s because contract deployment transactions don’t specify a receiver and we didn’t in our code. We deployed the contracts with zero code and despatched the 0.01/0.001 ether to them. Right here’s one in every of my transactions on Etherscan. You possibly can entry the code on Github and run it with a easy command in your terminal. There’s a brief readme there that tells you the way to setup.

In order that’s how we deal with nonce errors on the backend. The nonce is an important a part of EVM accounts and we’ve seen how it’s managed. Subsequent time you’re racing in opposition to that deadline and expertise this error, you’re free to repeat this piece of code and implement it. What are devs for? I’ll see you in my subsequent article. I can be rewriting the contract used within the Fei protocol/Rari capital hack. Want me luck.

More Posts