feat: EIP712 signing capabilities

Co-authored-by: David Magalhães <speeddragon@gmail.com>
Co-authored-by: Roberts Ivanovs <robertsivanovs1999@gmail.com>
Co-authored-by: Mariusz Pilarek <mariusz@eiger.co>

Author: 4 people

site/.vitepress/config.ts

@@ -75,6 +75,17 @@ export default defineConfig({
 
     nav: [
       { text: 'Docs', link: '/docs/getting-started', activeMatch: '/docs' },
+      {
+        activeMatch: '/zksync',
+        text: 'Extensions',
+        items: [
+          {
+            activeMatch: '/zksync',
+            text: 'zkSync',
+            link: '/zksync',
+          },
+        ],
+      },
       {
         activeMatch: '/op-stack',
         text: 'Extensions',

site/.vitepress/sidebar.ts

@@ -925,6 +925,41 @@ export const sidebar: DefaultTheme.Sidebar = {
       ],
     },
   ],
+  '/zksync': [
+    { text: '← Viem Docs', link: '/docs/getting-started' },
+    {
+      text: 'zkSync',
+      items: [
+        {
+          text: 'Getting started',
+          link: '/zksync',
+        },
+        { text: 'Client', link: '/zksync/client' },
+        { text: 'Chains', link: '/zksync/chains' },
+      ],
+    },
+    {
+      text: 'Actions',
+      items: [
+        {
+          text: 'prepareEip712TransactionRequest',
+          link: '/zksync/actions/prepareEip712TransactionRequest',
+        },
+        {
+          text: 'sendEip712Transaction',
+          link: '/zksync/actions/sendEip712Transaction',
+        },
+        {
+          text: 'signEip712Transaction',
+          link: '/zksync/actions/signEip712Transaction',
+        },
+        {
+          text: 'writeEip712Contract',
+          link: '/zksync/actions/writeEip712Contract',
+        },
+      ],
+    },
+  ],
   '/op-stack': [
     { text: '← Viem Docs', link: '/docs/getting-started' },
     {

site/zksync.md

@@ -0,0 +1,53 @@
+---
+head:
+  - - meta
+    - property: og:title
+      content: Getting started
+  - - meta
+    - name: description
+      content: Getting started with the zkSync in Viem
+  - - meta
+    - property: og:description
+      content: Getting started with the zkSync in Viem
+---
+
+# Getting started with zkSync
+
+Viem provides first-class support for the [zkSync](https://zksync.io) 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](/docs/clients/intro) with a desired [Transport](/docs/clients/intro) & [zkSync Chain](./zksync/chains.md) and extend it with zkSync EIP712 actions.
+
+```ts {5-8}
+import { createWalletClient, custom } from 'viem'
+import { zkSync } from 'viem/chains'
+import { eip712Actions } from 'viem/chains/zksync'
+
+const client = createWalletClient({
+  chain: zkSync,
+  transport: custom(window.ethereum),
+}).extend(eip712Actions())
+```
+
+::: info
+In a production app, it is highly recommended to pass through your authenticated RPC provider URL (Alchemy, Infura, Ankr, etc). If no URL is provided, viem will default to a public RPC provider. [Read more](/docs/clients/transports/http.html#usage).
+:::
+
+### 2. Send transactions using paymaster
+
+Now that you have a Client set up, you can [send a transaction](./zksync/actions/sendEip712Transaction.md) using a paymaster! [Read more](./zksync/client.md)
+
+```ts
+const hash = await client.sendEip712Transaction({
+  account: '0xA0Cf798816D4b9b9866b5330EEa46a18382f251e',
+  to: '0x70997970c51812dc3a010c7d01b50e0d17dc79c8',
+  value: 1000000000000000000n,
+  paymaster: '0xFD9aE5ebB0F6656f4b77a0E99dCbc5138d54b0BA',
+  paymasterInput: '0x123abc...'
+})
+```