Developer Quickstart - ZKsync Docs

You can use all standard EVM tooling for ZKsync OS.

To get started with Hardhat, follow the steps below:

Create a new project folder

mkdir hardhat-example
cd hardhat-example

Initialize a new Hardhat 3 project with Node Test Runner and Viem.
```
npx hardhat --init
```

Add ZKsync OS to the hardhat.config.ts file and configure the ignition required confirmations.

  ignition: {
    requiredConfirmations: 1,
  },
  networks: {
    zksyncOS: {
      type: 'http',
      chainType: 'generic',
      url: 'https://zksync-os-testnet-alpha.zksync.dev',
      accounts: [configVariable('TESTNET_PRIVATE_KEY')],
    },
  },

Add your private key to the keystore as TESTNET_PRIVATE_KEY.
```
npx hardhat keystore set TESTNET_PRIVATE_KEY
```
Compile and deploy the example contract.
```
npx hardhat compile
```
```
npx hardhat ignition deploy ignition/modules/Counter.ts --network zksyncOS
```
Create a new script file in the scripts folder called increment.ts.
```
touch scripts/increment.ts
```

Copy/paste the script below.

increment.ts

import { network } from 'hardhat';
import { type Abi, defineChain } from 'viem';

const CONTRACT_ADDRESS = '0x7Be3f2d08500Fe75B92b9561287a16962C697cb7';

const { viem } = await network.connect('zksyncOS');

const zksyncOS = defineChain({
  id: 8022833,
  name: 'ZKsync OS',
  network: 'zksyncOS',
  nativeCurrency: { name: 'Ether', symbol: 'ETH', decimals: 18 },
  rpcUrls: { default: { http: ['https://zksync-os-testnet-alpha.zksync.dev'] } },
});

const publicClient = await viem.getPublicClient({ chain: zksyncOS });
const [senderClient] = await viem.getWalletClients({ chain: zksyncOS });
if (!senderClient) throw new Error('No wallet client. Set TESTNET_PRIVATE_KEY in hardhat config.');

const counterContract = await viem.getContractAt('Counter', CONTRACT_ADDRESS, {
  client: { public: publicClient, wallet: senderClient },
});

const initialCount = await publicClient.readContract({
  address: CONTRACT_ADDRESS,
  abi: counterContract.abi as Abi,
  functionName: 'x',
});
console.log('Initial count:', initialCount);

const tx = await senderClient.writeContract({
  address: CONTRACT_ADDRESS,
  abi: counterContract.abi as Abi,
  functionName: 'inc',
});
await publicClient.waitForTransactionReceipt({ hash: tx });
console.log('Transaction sent successfully');

const newCount = await publicClient.readContract({
  address: CONTRACT_ADDRESS,
  abi: counterContract.abi as Abi,
  functionName: 'x',
});
console.log('New count:', newCount);

Run the script
```
npx hardhat run scripts/increment.ts
```

ZKsync OS Network

Get connected to ZKsync OS Devnet

FAQs

Answers to frequently asked questions about ZKsync OS.