Skip to content

Commit

Permalink
Relayer nonce collisions (#2157)
Browse files Browse the repository at this point in the history
* Relayer nonce collisions

* Update docs/2.build/1.chain-abstraction/meta-transactions.md

Co-authored-by: Damián Parrino <[email protected]>

* Update docs/2.build/1.chain-abstraction/meta-transactions.md

Co-authored-by: Damián Parrino <[email protected]>

* Update meta-transactions.md

* Update docs/2.build/1.chain-abstraction/meta-transactions.md

---------

Co-authored-by: Damián Parrino <[email protected]>
Co-authored-by: Guille <[email protected]>
  • Loading branch information
3 people authored Sep 2, 2024
1 parent ac09ac7 commit 83dadcf
Showing 1 changed file with 20 additions and 0 deletions.
20 changes: 20 additions & 0 deletions docs/2.build/1.chain-abstraction/meta-transactions.md
Original file line number Diff line number Diff line change
Expand Up @@ -106,6 +106,26 @@ Progress is being made to make this possible in the future.

</details>

### High volume parallel processing

When running a relayer that handles a large number of transactions, you will quickly run into a `nonce` collision problem. At the protocol level, transactions have a unique number that identifies them (nonce) that helps to mitigate reply attacks. Each key on an account has its own nonce, and the nonce is expected to increase with each signature the key creates.

When multiple transactions are sent from the same access key simultaneously, their nonces might collide. Imagine the relayer creates 3 transactions `Tx1`, `Tx2`, `Tx3` and send them in very short distance from each other, and lets assume that `Tx3` has the largest nonce. If `Tx3` ends up being processed before `Tx1` (because of network delays, or a node picks `Tx3` first), then `Tx3` will execute, but `Tx1` and `Tx2` will fail, because they have smaller nonce!

One way to mitigate this is to sign each transaction with a different key. Adding multiple full access keys to the NEAR account used for relaying (up to 20 keys can make a significant difference) will help.

<details>
<summary> Adding keys </summary>

```js
const keyPair = nearAPI.KeyPair.fromRandom("ed25519");

const receipt = await account.addKey(keyPair.getPublicKey().toString())
```

After saving these keys, its possible to rotate the private keys randomly when instantiating accounts before relaying ensuring you won't create a nonce collision.

</details>

### Gating the relayer

Expand Down

0 comments on commit 83dadcf

Please sign in to comment.