Announcing anvil-zksync: New Name, Familiar Feel, and Exciting Upcoming Features #819

dutterbutter · 2024-12-10T14:55:45Z

dutterbutter
Dec 10, 2024
Maintainer

Hey everyone! 👋

We’ve got news: era-test-node is now anvil-zksync !

Why the change?

We want to give developers a familiar, Anvil-like experience—matching APIs, CLI parity, and a smoother workflow. Starting now, anvil-zksync will be bundled with foundry-zksync for easy setup.

How to Get Started:

Just update foundry-zksync using the installer guide and run:

anvil-zksync

Documentation:

Check out the foundry-zksync-book for anvil-zksync reference documentation.

Release Notes:

See what’s new: v0.2.1 Release Notes.

⚠️ Breaking Changes

Asynchronous Transaction Execution

Transactions are no longer executed synchronously. An example - previously await sendTransaction() guaranteed a finalized transaction. Now, you must wait for the transaction receipt before assuming it’s fully mined and validated.

Example Fix:

Before:

const txReceipt = await greeter.setGreeting("Luke Skywalker");
const details = await provider.send("zks_getTransactionDetails", [txReceipt.hash]);

After:

const txResponse = await greeter.setGreeting("Luke Skywalker");
const txReceipt = await txResponse.wait();
const details = await provider.send("zks_getTransactionDetails", [txReceipt.transactionHash]);

Version Pinning & CI Updates

For CI setups, use anvil-zksync-action for out-of-the-box support for anvil-zksync releases
If you need older era-test-node versions, you can still use era-test-node-action which will support some releases which can be viewed here.
@matterlabs/hardhat-zksync-node@v1.2.0 and below remains on era-test-node:v0.1.0-alpha.36. From v1.3.0 forward, it will make use of anvil-zksync.