zkSync is a Layer 2 scaling solution for Ethereum, leveraging zkRollup technology. It provides low gas fees, high throughput, and enhanced user privacy while maintaining a secure and decentralized architecture.

The zkSync Era API enables developers to interact seamlessly with the zkSync Era network. Through the API, developers can submit transactions, query state changes, and more, all while benefiting from the scalability and security zkSync Era offers.

Send Your First Request on Alchemy

Let’s use the viem package to create a zkSync Era client connected to Alchemy and fetch the latest block number!

npm install --save viem

Create Client Connected to Alchemy

1
import { createPublicClient, http } from "viem"; 
2
import { zkSync } from "viem/chains";
3
4
const client = createPublicClient({
5
  chain: zkSync,
6
  transport: http("https://zksync-mainnet.g.alchemy.com/v2/YOUR_ALCHEMY_API_KEY"),
7
});

Now that you’ve created a client connected to Alchemy, you can continue with some basics:

Get Latest Block Number

1
const blockNumber = await client.getBlockNumber();
2
console.log("Current block number:", blockNumber);

Get an Address Balance

1
const balance = await client.getBalance({ address: "0xab5801a7d398351b8be11c439e05c5b3259aec9b" });
2
console.log("Balance (ETH):", Number(balance) / 1e18);

Read Block Data

1
const block = await client.getBlock({
2
  blockNumber: blockNumber, // from previous example
3
});
4
console.log(block);

Fetch a Transaction by Hash

1
const tx = await client.getTransaction({ hash: "0xYOUR_TX_HASH" });
2
console.log(tx);

Fetch Transaction Receipt

1
const receipt = await client.getTransactionReceipt({
2
  hash: "0xYOUR_TX_HASH"
3
});
4
console.log(receipt);

zkSync Era APIs

For the full list of zkSync Era APIs, see the zkSync Era API Endpoints.