Getting Started with ZKsync

Viem provides first-class support for the ZKsync chain.

ZKsync is a Layer-2 protocol that scales Ethereum with cutting-edge ZK tech.

Quick Start

1. Set up your Client & Transport

Firstly, set up your Client with a desired Transport & ZKsync Chain and extend it with ZKsync EIP712 actions.

import { createWalletClient, custom } from 'viem'
import { zksync } from 'viem/chains'
import { eip712WalletActions } from 'viem/zksync'
 
const walletClient = createWalletClient({ 
  chain: zksync, 
  transport: custom(window.ethereum!), 
}).extend(eip712WalletActions())

2. Use Actions

Now that you have a Client set up, you can send a transaction on ZKsync using a paymaster!

const hash = await walletClient.sendTransaction({
  account: '0xA0Cf798816D4b9b9866b5330EEa46a18382f251e',
  to: '0x70997970c51812dc3a010c7d01b50e0d17dc79c8',
  value: 1000000000000000000n,
  paymaster: '0xFD9aE5ebB0F6656f4b77a0E99dCbc5138d54b0BA',
  paymasterInput: '0x123abc...'
})

...and even write to contracts:

const hash = await walletClient.writeContract({
  address: '0xFBA3912Ca04dd458c843e2EE08967fC04f3579c2',
  abi: parseAbi(['function mint(uint32 tokenId) nonpayable']),
  functionName: 'mint',
  args: [69420],
})