Fix/zksync rpc deprecations by uF4No · Pull Request #3819 · wevm/viem

uF4No · 2025-07-23T15:51:33Z

ZKsync has deprecated and announced the future deprecation of multiple RPC methods (see here and here)

Add deprecation warnings for method getAllBalances and its correspondent L2 action
Adds documentation for getGasPerPubData, added in feat: add getGasPerPubdata action to use zks_gasPerPubdata #3817
Updates docs to reflect upcoming RPC deprecated methods:

getMainContract
[x] docs deprecation warning
[x] down in sidebar
[x] add TS deprecation comment to the function

getBaseTokenL1Address
[x] docs deprecation warning
[x] down in sidebar
[x] add TS deprecation comment to the function

getL1ChainId
[x] docs deprecation warning
[x] down in sidebar
[x] add TS deprecation comment to the function

getTestnetPaymaster
[x] docs deprecation warning
[x] down in sidebar
[x] add TS deprecation comment to the function

estimateFee
[x] docs deprecation warning
[x] down in sidebar
[x] add TS deprecation comment to the function

getRawBlockTransactions
[x] docs deprecation warning
[x] down in sidebar
[x] add TS deprecation comment to the function

changeset-bot · 2025-07-23T15:51:37Z

⚠️ No Changeset found

Latest commit: 01bad5e

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

site/pages/zksync/actions/estimateFee.md

tmm · 2025-07-28T21:29:12Z

site/pages/zksync/actions/estimateFee.md

+- `gasLimit`: use `eth_estimateGas` or its correspondent viem action..
+- `maxFeePerGas`: use `eth_gasPrice` or its correspondent viem action..


Can we link to these Viem action doc pages?

tmm · 2025-07-28T21:29:56Z

site/pages/zksync/actions/estimateFee.md

+- `gasLimit`: use `eth_estimateGas` or its correspondent viem action..
+- `maxFeePerGas`: use `eth_gasPrice` or its correspondent viem action..
+- `maxPriorityFeePerGas`: set to `0`.
+- `gasPerPubData`: use `zks_gasPerPubdata` or its correspondent viem action.


Should this PR add a Viem action for this? (So it can be linked to here.)

I was going to do it but this new action (getGasPerPubData) was added in #3817 . Just noticed that #3817 only added the action but not the documentation so I'm adding it in this PR

tmm · 2025-07-28T21:30:57Z

site/pages/zksync/actions/getAllBalances.md

Let's add the deprecation notice instead of deleting this page outright.

site/pages/zksync/actions/getBaseTokenL1Address.md

tmm · 2025-07-28T21:37:54Z

src/zksync/actions/getTestnetPaymasterAddress.ts


 export type GetTestnetPaymasterAddressReturnType = Address | null

+/* @deprecated Check the ZKsync chain technical documentation to find the testnet paymaster address */


Is there a link to the technical docs we can use here?

Suggested change

/* @deprecated Check the ZKsync chain technical documentation to find the testnet paymaster address */

/* @deprecated Check the [ZKsync chain technical documentation](TODO) to find the testnet paymaster address */

there's not really a single link for all, as this will depend if the dev is using ZKsync Era, Abstract, Sophon etc. Each ZKsync chain has its own. I'm updating the wording slightly to better reflect that.

tmm · 2025-07-28T21:38:23Z

src/zksync/decorators/publicL2.test.ts

Let's keep this code during the deprecation period and we can remove in the next major version.

files restored

tmm · 2025-07-28T21:38:29Z

src/zksync/decorators/publicL2.ts

Let's keep this code during the deprecation period and we can remove in the next major version.

files restored

tmm · 2025-07-28T21:38:51Z

src/zksync/decorators/publicL2.ts

-   *
-   * const balances = await client.getAllBalances({account: "0x36615Cf349d7F6344891B1e7CA7C72883F5dc049"});
-   */
-  getAllBalances: (


Add a @deprecated comment instead of removing.

original code restored and added deprecation

tmm · 2025-07-28T21:39:01Z

src/zksync/index.ts

Let's keep this code during the deprecation period and we can remove in the next major version.

Co-authored-by: tmm <tom@meagher.co>

uF4No added 3 commits July 23, 2025 16:45

feat: deprecation notices

65608ee

feat: deprecation sidebar changes

d8a3fe4

feat: removes getAllbalances method

3a541de

uF4No added 2 commits July 24, 2025 11:29

feat: link to announcement

b58ad6a

fix: test types

937f97f

tmm requested changes Jul 28, 2025

View reviewed changes

uF4No and others added 10 commits July 29, 2025 10:52

fix: recover deleted methods

f77f7ce

fix: removes deprecated from title

4a9ce51

fix: adds deprecation warning

0f21537

fix: add back allbalances

e1c6d7a

fix: wording paymaster deprecation

32d3f6f

fix: deprecated decorator

d7aa62f

feat: gasPerPubData docs

e2503df

fix: adds links to actions

82a8cc1

Apply suggestions from code review

22389b6

Co-authored-by: tmm <tom@meagher.co>

chore: tweak

01bad5e

tmm merged commit 84c340b into wevm:main Jul 29, 2025
11 of 24 checks passed

tmm mentioned this pull request Oct 23, 2025

ci: reenable wagmi verify #4052

Merged

tmm mentioned this pull request Nov 21, 2025

feat: abi parameter named tuples #4107

Merged

		- `gasLimit`: use `eth_estimateGas` or its correspondent viem action..
		- `maxFeePerGas`: use `eth_gasPrice` or its correspondent viem action..


		export type GetTestnetPaymasterAddressReturnType = Address \| null

		/* @deprecated Check the ZKsync chain technical documentation to find the testnet paymaster address */

	/* @deprecated Check the ZKsync chain technical documentation to find the testnet paymaster address */
	/* @deprecated Check the [ZKsync chain technical documentation](TODO) to find the testnet paymaster address */

Uh oh!

Conversation

uF4No commented Jul 23, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

changeset-bot bot commented Jul 23, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

⚠️ No Changeset found

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

uF4No Jul 29, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

uF4No Jul 29, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

uF4No commented Jul 23, 2025 •

edited

Loading

changeset-bot bot commented Jul 23, 2025 •

edited

Loading

uF4No Jul 29, 2025 •

edited

Loading

uF4No Jul 29, 2025 •

edited

Loading