chore: add ZKsync OS verification url (#466)

adds verification url for ZKsync OS and updates the dev quickstart with
verification steps

Author: sarahschwartz

components/ZksyncEraNetworkDetails.vue

@@ -168,8 +168,8 @@ const zksyncOSTestnetDetails: NetworkDetail[] = [
   },
   {
     property: 'Explorer Verification API',
-    value: '(coming soon)',
-    isCopyable: false,
+    value: 'https://block-explorer-api.zksync-os-testnet-alpha.zksync.dev/api',
+    isCopyable: true,
   },
 ];
 </script>

content/00.zksync-network/65.zksync-os/_partials/_foundry.md

@@ -6,6 +6,9 @@ title: Foundry
 
     ```bash
     forge init Counter
+    ```
+
+    ```bash
     cd Counter
     ```
 
@@ -24,13 +27,13 @@ title: Foundry
 1. Deploy the contract:
 
     ```bash
-    forge script script/Counter.s.sol --rpc-url https://zksync-os-testnet-alpha.zksync.dev --broadcast --private-key $TESTNET_PRIVATE_KEY
+    forge script script/Counter.s.sol --rpc-url https://zksync-os-testnet-alpha.zksync.dev --broadcast --skip-simulation --private-key $TESTNET_PRIVATE_KEY
     ```
 
 1. Set the number value:
 
     ```bash
-    cast send 0xCA1386680bfd9D89c7cc6Fc3ba11938ba6E44fef \
+    cast send 0x<YOUR_CONTRACT_ADDRESS> \
     "setNumber(uint256)" 5 \
     --rpc-url https://zksync-os-testnet-alpha.zksync.dev \
     --private-key $TESTNET_PRIVATE_KEY
@@ -39,7 +42,18 @@ title: Foundry
 1. Get the latest number value:
 
     ```bash
-    cast call 0xCA1386680bfd9D89c7cc6Fc3ba11938ba6E44fef \
+    cast call 0x<YOUR_CONTRACT_ADDRESS> \
     "number()" \
     --rpc-url https://zksync-os-testnet-alpha.zksync.dev
     ```
+
+1. Verify the contract:
+
+    ```bash
+    forge verify-contract \
+    --chain-id 8022833 \
+    --verifier custom \
+    --verifier-url https://block-explorer-api.zksync-os-testnet-alpha.zksync.dev/api \
+    0x<YOUR_CONTRACT_ADDRESS> \
+    src/Counter.sol:Counter
+    ```

content/_partials/_zksyncos/_run-script.md

@@ -23,3 +23,62 @@ title: Hardhat 3 Run Script
         ```
 
         ::
+
+9. Install the Hardhat verify SDK: <!-- markdownlint-disable-line -->
+
+    ::code-group
+
+    ```bash [npm]
+    npm install --save-dev @nomicfoundation/hardhat-verify
+    ```
+
+    ```bash [yarn]
+    yarn add -D @nomicfoundation/hardhat-verify
+    ```
+
+    ```bash [pnpm]
+    pnpm add -D @nomicfoundation/hardhat-verify
+    ```
+
+    ```bash [bun]
+    bun add -D @nomicfoundation/hardhat-verify
+    ```
+
+    ::
+
+10. Add `hardhatVerify` to the hardhat plugins and configure the verification endpoint: <!-- markdownlint-disable-line -->
+
+    ```ts [hardhat.config.ts]
+    import hardhatVerify from "@nomicfoundation/hardhat-verify";
+
+    const config: HardhatUserConfig = {
+    plugins: [
+        hardhatVerify,
+        // ...other plugins...
+    ],
+    // ...other config...
+    :code-import{filePath="zksync-os/hardhat.config.ts:verify-config"}
+    };
+    ```
+
+11. Use your deployed contract address to verify using `hardhat-verify`: <!-- markdownlint-disable-line -->
+
+    ::code-group
+
+    ```bash [npm]
+    npx hardhat verify --network zksyncOS 0x<YOUR_CONTRACT_ADDRESS>
+    ```
+
+    ```bash [yarn]
+    yarn hardhat verify --network zksyncOS 0x<YOUR_CONTRACT_ADDRESS>
+    ```
+
+    ```bash [pnpm]
+    pnpm hardhat verify --network zksyncOS 0x<YOUR_CONTRACT_ADDRESS>
+    ```
+
+    ```bash [bun]
+    bun hardhat verify --network zksyncOS 0x<YOUR_CONTRACT_ADDRESS>
+    ```
+
+    ::

content/_partials/_zksyncos/_setup.md

@@ -4,7 +4,7 @@ title: Hardhat 3 Setup
 
 3. Add ZKsync OS to the `hardhat.config.ts` file and configure the ignition required confirmations. <!-- markdownlint-disable-line -->
 
-    ```ts
+    ```ts [hardhat.config.ts]
      :code-import{filePath="zksync-os/hardhat.config.ts:hh-config"}
     ```
 

examples/zksync-os/bun.lock

@@ -7,6 +7,7 @@
         "@nomicfoundation/hardhat-ignition": "^3.0.3",
         "@nomicfoundation/hardhat-toolbox-mocha-ethers": "^3.0.0",
         "@nomicfoundation/hardhat-toolbox-viem": "^5.0.0",
+        "@nomicfoundation/hardhat-verify": "^3.0.4",
         "@nomicfoundation/hardhat-viem": "^3.0.0",
         "@types/chai": "^4.3.20",
         "@types/chai-as-promised": "^8.0.2",
@@ -179,7 +180,7 @@
 
     "@nomicfoundation/hardhat-utils": ["@nomicfoundation/[email protected]", "", { "dependencies": { "@streamparser/json-node": "^0.0.22", "debug": "^4.3.2", "env-paths": "^2.2.0", "ethereum-cryptography": "^2.2.1", "fast-equals": "^5.0.1", "json-stream-stringify": "^3.1.6", "rfdc": "^1.3.1", "undici": "^6.16.1" } }, "sha512-d/LYe9k9W56dimt6mY6SA1SjadSKKyHZC2S+0JsSFr4BjU4SHBDaM0cKWx44JdZqBdMjLWCiRBcVaIq3X8qTAA=="],
 
-    "@nomicfoundation/hardhat-verify": ["@nomicfoundation/[email protected].2", "", { "dependencies": { "@ethersproject/abi": "^5.8.0", "@nomicfoundation/hardhat-errors": "^3.0.2", "@nomicfoundation/hardhat-utils": "^3.0.1", "@nomicfoundation/hardhat-zod-utils": "^3.0.0", "cbor2": "^1.9.0", "chalk": "^5.3.0", "debug": "^4.3.2", "semver": "^7.6.3", "zod": "^3.23.8" }, "peerDependencies": { "hardhat": "^3.0.0" } }, "sha512-t+YykFxz2Zz/f8n1Fe0tGTDOTgaTbZDM+XgroIbx/Fwc5Rq9hIAWQLk0WVuDQx7bisMnUTzhsjEO00+4ExfTig=="],
+    "@nomicfoundation/hardhat-verify": ["@nomicfoundation/[email protected].4", "", { "dependencies": { "@ethersproject/abi": "^5.8.0", "@nomicfoundation/hardhat-errors": "^3.0.3", "@nomicfoundation/hardhat-utils": "^3.0.3", "@nomicfoundation/hardhat-zod-utils": "^3.0.0", "cbor2": "^1.9.0", "chalk": "^5.3.0", "debug": "^4.3.2", "semver": "^7.6.3", "zod": "^3.23.8" }, "peerDependencies": { "hardhat": "^3.0.0" } }, "sha512-2EeteIxYL+teGDDm/NxMXmyiclAeg3XLAgGRL3CWCjEpxHX0xHa1sQOIsBkTs+DaVZnPCOY/s6/F+xvXgfoVyQ=="],
 
     "@nomicfoundation/hardhat-viem": ["@nomicfoundation/[email protected]", "", { "dependencies": { "@nomicfoundation/hardhat-errors": "^3.0.0", "@nomicfoundation/hardhat-utils": "^3.0.0" }, "peerDependencies": { "hardhat": "^3.0.0", "viem": "^2.30.0" } }, "sha512-4QHBfTgJuo1O8vK9AO2AQYKsIp9yg06aF9C+WydDr2XS7VLJYh3g3gZdszLbSD9eHWsuviN688VKbcmfIZNWvQ=="],
 
@@ -585,6 +586,10 @@
 
     "@nomicfoundation/hardhat-keystore/@noble/hashes": ["@noble/[email protected]", "", {}, "sha512-B8XBPsn4vT/KJAGqDzbwztd+6Yte3P4V7iafm24bxgDe/mlRuK6xmWPuCNrKt2vDafZ8MfJLlchDG/vYafQEjQ=="],
 
+    "@nomicfoundation/hardhat-verify/@nomicfoundation/hardhat-errors": ["@nomicfoundation/[email protected]", "", { "dependencies": { "@nomicfoundation/hardhat-utils": "^3.0.1" } }, "sha512-qvVIyNE5yXFdwCD7G74fb3j+p5PjYSej/K2mhOuJBhxdGwzARpyoJbcDZrjkNyabytlt95iniZLHHWM9jvVXEA=="],
+
+    "@nomicfoundation/hardhat-verify/@nomicfoundation/hardhat-utils": ["@nomicfoundation/[email protected]", "", { "dependencies": { "@streamparser/json-node": "^0.0.22", "debug": "^4.3.2", "env-paths": "^2.2.0", "ethereum-cryptography": "^2.2.1", "fast-equals": "^5.0.1", "json-stream-stringify": "^3.1.6", "rfdc": "^1.3.1", "undici": "^6.16.1" } }, "sha512-XNoDJshvGR3l8/oQdNoLPLlcv+P+mGZBLixCyuO8Q0wTIyH/1+KYI77E+yvgTyw+GG4UmldFw9R3Hmnemk3KCA=="],
+
     "@scure/bip32/@noble/curves": ["@noble/[email protected]", "", { "dependencies": { "@noble/hashes": "1.8.0" } }, "sha512-k11yZxZg+t+gWvBbIswW0yoJlu8cHOC7dhunwOzoWH/mXGBiYyR4YY6hAEK/3EUs4UpB8la1RfdRpeGsFHkWsA=="],
 
     "@scure/bip32/@noble/hashes": ["@noble/[email protected]", "", {}, "sha512-jCs9ldd7NwzpgXDIf6P3+NrHh9/sD6CQdxHyjQI+h/6rDNo88ypBxxz45UDuZHz9r3tNz7N/VInSVoVdtXEI4A=="],

examples/zksync-os/hardhat.config.ts

@@ -1,4 +1,5 @@
 import type { HardhatUserConfig } from 'hardhat/config';
+import hardhatVerify from '@nomicfoundation/hardhat-verify';
 
 import hardhatToolboxViemPlugin from '@nomicfoundation/hardhat-toolbox-viem';
 // eslint-disable-next-line @typescript-eslint/no-unused-vars
@@ -7,7 +8,7 @@ import { configVariable } from 'hardhat/config';
 
 const config: HardhatUserConfig = {
   // plugins: [hardhatToolboxMochaEthersPlugin],
-  plugins: [hardhatToolboxViemPlugin],
+  plugins: [hardhatToolboxViemPlugin, hardhatVerify],
   solidity: {
     profiles: {
       default: {
@@ -37,6 +38,20 @@ const config: HardhatUserConfig = {
     },
   },
   // ANCHOR_END: hh-config
+  // ANCHOR: verify-config
+  chainDescriptors: {
+    8022833: {
+      name: 'zksyncOS',
+      blockExplorers: {
+        blockscout: {
+          name: 'Testnet Explorer',
+          url: 'https://zksync-os-testnet-alpha.staging-scan-v2.zksync.dev',
+          apiUrl: 'https://block-explorer-api.zksync-os-testnet-alpha.zksync.dev/api',
+        },
+      },
+    },
+  },
+  // ANCHOR_END: verify-config
 };
 
 export default config;

examples/zksync-os/package.json

@@ -12,6 +12,7 @@
     "@nomicfoundation/hardhat-ignition": "^3.0.3",
     "@nomicfoundation/hardhat-toolbox-mocha-ethers": "^3.0.0",
     "@nomicfoundation/hardhat-toolbox-viem": "^5.0.0",
+    "@nomicfoundation/hardhat-verify": "^3.0.4",
     "@nomicfoundation/hardhat-viem": "^3.0.0",
     "@types/chai": "^4.3.20",
     "@types/chai-as-promised": "^8.0.2",