diff --git a/.markdownlint.json b/.markdownlint.json
index 83951752..a9e61989 100644
--- a/.markdownlint.json
+++ b/.markdownlint.json
@@ -15,5 +15,6 @@
   "MD034": false,
   "MD024": false,
   "MD022": false,
-  "MD023": false
+  "MD023": false,
+  "MD046": false
 }
diff --git a/app.config.ts b/app.config.ts
index 38d99c76..79fc0f17 100644
--- a/app.config.ts
+++ b/app.config.ts
@@ -102,24 +102,18 @@ export default defineAppConfig({
       edit: 'https://github.com/matter-labs/zksync-docs/edit/staging/content',
       feedback: 'https://github.com/matter-labs/zksync-docs/issues/new?labels=documentation',
       links: [
-        // {
-        //   icon: 'i-heroicons-star',
-        //   label: 'Star on GitHub',
-        //   to: 'https://github.com/nuxt/ui',
-        //   target: '_blank',
-        // },
-        // {
-        //   icon: 'i-heroicons-book-open',
-        //   label: 'Nuxt UI Pro docs',
-        //   to: 'https://ui.nuxt.com/pro/guide',
-        //   target: '_blank',
-        // },
-        // {
-        //   icon: 'i-simple-icons-nuxtdotjs',
-        //   label: 'Purchase a license',
-        //   to: 'https://ui.nuxt.com/pro/purchase',
-        //   target: '_blank',
-        // },
+        {
+          icon: 'i-heroicons-chat-bubble-oval-left-ellipsis-16-solid',
+          label: 'Chat on Discord',
+          to: 'https://join.zksync.dev/',
+          target: '_blank',
+        },
+        {
+          icon: 'i-heroicons-user-group-20-solid',
+          label: 'Developer Forum',
+          to: 'https://github.com/zkSync-Community-Hub/zkync-developers/discussions',
+          target: '_blank',
+        },
       ],
     },
   },
diff --git a/bun.lockb b/bun.lockb
index 3dd88caf..883b0748 100755
Binary files a/bun.lockb and b/bun.lockb differ
diff --git a/components/content/CheckIcon.vue b/components/content/CheckIcon.vue
new file mode 100644
index 00000000..6c9f6ca0
--- /dev/null
+++ b/components/content/CheckIcon.vue
@@ -0,0 +1,17 @@
+<template>
+  <UIcon
+    name="i-heroicons-check-circle-16-solid"
+    class="mb-1 ml-2 h-4 w-4 align-middle text-green-600 opacity-85"
+  />
+</template>
+
+<script setup lang="ts">
+/**
+ * A super simple component that renders a check icon inline.
+ *
+ * ```
+ * example usage in markdown:
+ *  :check-icon some text beside the icon
+ * ```
+ */
+</script>
diff --git a/components/content/ContentSwitcher.vue b/components/content/ContentSwitcher.vue
index 21dd8de6..6e23d6c3 100644
--- a/components/content/ContentSwitcher.vue
+++ b/components/content/ContentSwitcher.vue
@@ -2,13 +2,15 @@
 defineProps<{
   items: ContentSwitcherItem[];
 }>();
-
 const selectedIndex = ref(0);
 
 function onTabChange(index: number) {
   selectedIndex.value = index;
 }
 const route = useRoute();
+// This splits the path into segments and takes the first one
+// TODO: This is a temporary solution, we need to find a better way to get the base path
+const basePath = route.path.split('/')[1];
 </script>
 
 <template>
@@ -25,7 +27,7 @@ const route = useRoute();
     >
       <ContentQuery
         v-slot="{ data }"
-        :path="$route.path"
+        :path="basePath"
         find="one"
         :where="{ _partial: true, _path: { $icontains: item.partial } }"
       >
diff --git a/components/content/DropPanel/DropPanel.vue b/components/content/DropPanel/DropPanel.vue
new file mode 100644
index 00000000..bed9f25d
--- /dev/null
+++ b/components/content/DropPanel/DropPanel.vue
@@ -0,0 +1,51 @@
+<template>
+  <div class="-mt-6 flex w-full flex-col divide-y divide-gray-200 dark:divide-gray-800">
+    <HeadlessDisclosure
+      v-for="(tab, index) in tabs"
+      :key="index"
+      v-slot="{ open }"
+    >
+      <HeadlessDisclosureButton
+        class="focus-visible:ring-primary-500 dark:focus-visible:ring-primary-400 inline-flex w-full flex-shrink-0 items-center gap-x-1.5 rounded-none py-6 text-left text-lg font-medium text-gray-500 underline-offset-4 hover:text-gray-700 hover:no-underline focus:outline-none focus-visible:outline-0 focus-visible:ring-2 focus-visible:ring-inset disabled:cursor-not-allowed disabled:opacity-75 dark:text-gray-400 dark:hover:text-gray-200"
+      >
+        <UIcon
+          name="i-heroicons-chevron-down-20-solid"
+          class="h-5 w-5 flex-shrink-0 transform font-bold transition-transform duration-200"
+          :class="open ? '' : '-rotate-90'"
+        />
+        <span class="text-gray-900 dark:text-white">{{ tab.label }}</span>
+      </HeadlessDisclosureButton>
+      <HeadlessDisclosurePanel class="py-4 pl-6 text-base text-gray-500 dark:text-gray-100">
+        <component :is="tab.component" />
+      </HeadlessDisclosurePanel>
+    </HeadlessDisclosure>
+  </div>
+</template>
+
+<script setup lang="ts">
+/**
+ * An accordion style component that allows
+ * for multiple panels to be open at once.
+ *
+ * Use Panel component to slot in panels.
+ */
+import { useSlots, computed } from 'vue';
+
+const slots = useSlots();
+
+const tabs = computed(() => {
+  return (
+    slots.default?.().map((slot, index) => {
+      if (slot.props?.label === undefined) {
+        throw new Error(`DropPanel: Panel at index ${index} is missing a label prop.`);
+      } else {
+        return {
+          index,
+          label: slot.props.label,
+          component: slot,
+        };
+      }
+    }) || []
+  );
+});
+</script>
diff --git a/components/content/DropPanel/Panel.vue b/components/content/DropPanel/Panel.vue
new file mode 100644
index 00000000..a0aa04e7
--- /dev/null
+++ b/components/content/DropPanel/Panel.vue
@@ -0,0 +1,11 @@
+<template>
+  <ContentSlot :use="$slots.default" />
+</template>
+
+<script setup lang="ts">
+/**
+ * A panel component that can be slotted into a DropPanel.
+ *
+ * Use the `label` prop to set the tab label on the drop panel.
+ */
+</script>
diff --git a/content/10.getting-started/1.index.md b/content/10.getting-started/1.index.md
deleted file mode 100644
index 1add1407..00000000
--- a/content/10.getting-started/1.index.md
+++ /dev/null
@@ -1,79 +0,0 @@
----
-title: Introduction
-description: Welcome to Nuxt UI Pro documentation template.
-layout: test
----
-
-This template is a ready-to-use documentation template made with [Nuxt UI Pro](https://ui.nuxt.com/pro), a collection of
-premium components built on top of [Nuxt UI](https://ui.nuxt.com) to create beautiful & responsive Nuxt applications in
-minutes.
-
-::content-switcher
----
-items: [{
-  label: 'HardHat',
-  partial: '_getting-started/_aPartial'
-}, {
-  label: 'Forge',
-  partial: '_getting-started/_anotherpartial'
-}]
----
-::
-
-There are already many websites based on this template:
-
-- [Nuxt](https://nuxt.com) - The Nuxt website
-- [Nuxt UI](https://ui.nuxt.com) - The documentation of `@nuxt/ui` and `@nuxt/ui-pro`
-- [Nuxt Image](https://image.nuxt.com) - The documentation of `@nuxt/image`
-- [Nuxt Content](https://content.nuxt.com) - The documentation of `@nuxt/content`
-- [Nuxt Devtools](https://devtools.nuxt.com) - The documentation of `@nuxt/devtools`
-- [Nuxt Studio](https://nuxt.studio) - The pro version of Nuxt Content
-
-::display-partial
----
-path: '_partials/setting-up-your-wallet'
----
-::
-
-## Features
-
-- Powered by [Nuxt 3](https://nuxt.com)
-- Built with [Nuxt UI](https://ui.nuxt.com) and [Nuxt UI Pro](https://ui.nuxt.com/pro)
-- Write content with [MDC syntax](https://content.nuxt.com/usage/markdown) thanks to
-  [Nuxt Content](https://content.nuxt.com)
-- Compatible with [Nuxt Studio](https://nuxt.studio)
-- Auto-generated sidebar navigation
-- Full-Text Search out of the box
-- Beautiful Typography styles
-- Dark mode support
-- And more...
-
-## Play online
-
-You can start playing with this template in your browser using our online sandboxes:
-
-::card
----
-title: Play on StackBlitz
-icon: i-simple-icons-stackblitz
-to: https://stackblitz.com/github/nuxt-ui-pro/docs/
-target: _blank
----
-Explore Nuxt built-in components for pages, layouts, head, and more.
-::
-
----
-
-::card
----
-title: Play on CodeSandbox
-icon: i-simple-icons-codesandbox
-to: https://codesandbox.io/s/github/nuxt-ui-pro/docs/
-target: _blank
----
-Explore Nuxt built-in components for pages, layouts, head, and more.
-::
-
----
-
-Or open [Nuxt UI playground](https://ui.nuxt.com/playground).
diff --git a/content/10.getting-started/2.installation.md b/content/10.getting-started/2.installation.md
deleted file mode 100644
index 802d52fe..00000000
--- a/content/10.getting-started/2.installation.md
+++ /dev/null
@@ -1,33 +0,0 @@
----
-title: Installation
-description: Get started with Nuxt UI Pro documentation template.
-layout: docs
----
-
-::callout{icon="i-heroicons-light-bulb"}
-This is a callout.
-::
-
----
-
-Use this template on Nuxt Studio and start your documentation in seconds. ::
-
-## Quick Start
-
-You can start a fresh new project with:
-
-```bash [Terminal]
-npx nuxi init -t github:nuxt-ui-pro/docs
-```
-
-or create a new repository from GitHub:
-
-1. Open <https://github.com/nuxt-ui-pro/docs>
-2. Click on `Use this template` button
-3. Enter repository name and click on `Create repository from template` button
-4. Clone your new repository
-5. Install dependencies with your favorite package manager
-6. Start development server
-
-That's it! You can now start writing your documentation in the
-[`content/`](https://content.nuxt.com/usage/content-directory) directory 🚀
diff --git a/content/10.getting-started/3.usage.md b/content/10.getting-started/3.usage.md
deleted file mode 100644
index 6cdaaed6..00000000
--- a/content/10.getting-started/3.usage.md
+++ /dev/null
@@ -1,155 +0,0 @@
----
-title: Usage
-description: Learn how to write and customize your documentation.
----
-
-This is only a basic example of what you can achieve with [Nuxt UI Pro](https://ui.nuxt.com/pro/guide), you can tweak it
-to match your needs. The template uses several Nuxt modules underneath like [`@nuxt/content`](https://content.nuxt.com)
-for the content, [`@nuxtjs/fontaine`](https://github.com/nuxt-modules/fontaine) and
-[`@nuxtjs/google-fonts`](https://github.com/nuxt-modules/google-fonts) to change the font and
-[`nuxt-og-image`](https://nuxtseo.com/og-image/getting-started/installation) for social previews.
-
-## ::callout
-
-icon: i-heroicons-light-bulb target: \_blank to: [nuxt guide](https://ui.nuxt.com/pro/guide/usage#structure)
-
----
-
-Learn more on how to customize and structure a Nuxt UI Pro app! ::
-
-## Writing content
-
-You can just start writing `.md` or `.yml` files in the [`content/`](https://content.nuxt.com/usage/content-directory)
-directory to have your pages updated. The navigation will be automatically generated in the left aside and in the mobile
-menu. You will also be able to go through your content with full-text search.
-
-::callout{icon="i-heroicons-light-bulb"} This template relies on a
-[catch-all route](https://nuxt.com/docs/guide/directory-structure/pages#catch-all-route) but you can achieve the same
-thing with the [document-driven mode](https://content.nuxt.com/document-driven/introduction). ::
-
-## App Configuration
-
-In addition to `@nuxt/ui-pro` configuration through the `app.config.ts`, this template lets you customize the `Header`,
-`Footer` and the `Table of contents` components.
-
-### Header
-
-```ts [app.config.ts]
-export default defineAppConfig({
-  header: {
-    // Logo configuration
-    logo: {
-      // Light mode
-      light: {
-        src: '',
-        alt: '',
-        class: '',
-      },
-      // Dark mode
-      dark: {
-        src: '',
-        alt: '',
-        class: '',
-      },
-    },
-    // Show or hide the search bar
-    search: true,
-    // Show or hide the color mode button
-    colorMode: true,
-    // Customize links
-    links: [
-      {
-        icon: 'i-simple-icons-github',
-        to: 'https://github.com/nuxt-ui-pro/docs',
-        target: '_blank',
-        'aria-label': 'Docs template on GitHub',
-      },
-    ],
-  },
-});
-```
-
-### Footer
-
-```ts [app.config.ts]
-export default defineAppConfig({
-  footer: {
-    // Update bottom left credits
-    credits: 'Copyright © 2023',
-    // Show or hide the color mode button
-    colorMode: false,
-    // Customize links
-    links: [
-      {
-        icon: 'i-simple-icons-nuxtdotjs',
-        to: 'https://nuxt.com',
-        target: '_blank',
-        'aria-label': 'Nuxt Website',
-      },
-      {
-        icon: 'i-simple-icons-discord',
-        to: 'https://discord.com/invite/ps2h6QT',
-        target: '_blank',
-        'aria-label': 'Nuxt UI on Discord',
-      },
-      {
-        icon: 'i-simple-icons-x',
-        to: 'https://x.com/nuxt_js',
-        target: '_blank',
-        'aria-label': 'Nuxt on X',
-      },
-      {
-        icon: 'i-simple-icons-github',
-        to: 'https://github.com/nuxt/ui',
-        target: '_blank',
-        'aria-label': 'Nuxt UI on GitHub',
-      },
-    ],
-  },
-});
-```
-
-### Table of contents
-
-```ts [app.config.ts]
-export default defineAppConfig({
-  toc: {
-    // Title of the main table of contents
-    title: 'Table of Contents',
-    // Bottom TOC configuration
-    bottom: {
-      // Title of the bottom table of contents
-      title: 'Community',
-      // URL of your repository content folder
-      edit: '',
-      // Customize links
-      links: [
-        {
-          icon: 'i-heroicons-star',
-          label: 'Star on GitHub',
-          to: 'https://github.com/nuxt/ui',
-          target: '_blank',
-        },
-        {
-          icon: 'i-heroicons-book-open',
-          label: 'Nuxt UI Pro docs',
-          to: 'https://ui.nuxt.com/pro/guide',
-          target: '_blank',
-        },
-        {
-          icon: 'i-simple-icons-nuxtdotjs',
-          label: 'Purchase a license',
-          to: 'https://ui.nuxt.com/pro/purchase',
-          target: '_blank',
-        },
-      ],
-    },
-  },
-});
-```
-
-icon: i-heroicons-light-bulb target: \_blank to: [app-config](https://nuxt.studio/docs/developers/app-config)
-
----
-
-A dedicated interface is provided to edit those configurations on Nuxt Studio. ::
diff --git a/content/10.getting-started/_dir.yml b/content/10.getting-started/_dir.yml
deleted file mode 100644
index c8496134..00000000
--- a/content/10.getting-started/_dir.yml
+++ /dev/null
@@ -1,2 +0,0 @@
-title: Getting Started
-layout: docs
diff --git a/content/10.getting-started/_getting-started/_aPartial.md b/content/10.getting-started/_getting-started/_aPartial.md
deleted file mode 100644
index 0fea5446..00000000
--- a/content/10.getting-started/_getting-started/_aPartial.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-title: A Partial
----
-
-This is a partial that's coming from somewhere else!
diff --git a/content/10.getting-started/_getting-started/_anotherPartial.md b/content/10.getting-started/_getting-started/_anotherPartial.md
deleted file mode 100644
index f1ac3572..00000000
--- a/content/10.getting-started/_getting-started/_anotherPartial.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-title: Another Partial
----
-
-This is the second partial
diff --git a/content/10.quick-start/00.index.md b/content/10.quick-start/00.index.md
new file mode 100644
index 00000000..25f84b79
--- /dev/null
+++ b/content/10.quick-start/00.index.md
@@ -0,0 +1,156 @@
+---
+title: Getting Started
+description: Learn to build and deploy smart contracts on zkSync Era.
+---
+
+Welcome to the Quickstart Guide for deploying smart contracts on zkSync!
+In this guide, we'll walk you through the process of creating and deploying a simple smart contract that creates a crowdfunding campaign for Zeek.
+
+By the end of the series, you will learn integral pieces that will
+help you become a great developer on zkSync! You will learn how to:
+
+:check-icon Initialize a new project with zksync-cli.
+
+:check-icon Deploy contracts on zkSync Era using Hardhat or Foundry.
+
+:check-icon Test your contracts with Hardhat or Foundry.
+
+:check-icon Implement upgradable patterns for your contracts.
+
+:check-icon Implement a Paymaster to simplify transactions for your users.
+
+---
+
+## Install zksync-cli
+
+Our Quickstart series utilizes the `zksync-cli` to help you develop and interact with zkSync from your local machine.
+<!-- TODO: update link -->
+<!-- Check out our [zksync-cli section](/content/tooling/zksync-cli) to learn more on how to use the CLI. -->
+
+You will need to install a couple tools to effectively use `zksync-cli`:
+
+#### Install Node.js or Bun.sh
+
+You will need either Node.js or Bun.sh.
+The choice depends on your project's requirements and personal preference for package management and execution speed.
+If you are unfamiliar with both, choose Node.js.
+
+- Node.js
+  - Download the Long-Term Support (LTS) version from the :external-link{text="official Node.js website" href="https://nodejs.org/en/download"}.
+  - For first-time users, the :external-link{text="Node.js usage guide" href="https://nodejs.org/api/synopsis.html#usage"}
+  offers comprehensive instructions on getting started.
+- Bun.sh
+  - Obtain the latest version from the :external-link{text="Bun installation page" href="https://bun.sh/docs/installation"}.
+  Bun.sh is known for its high performance and modern JavaScript features.
+
+### Setup era local node (optional)
+
+Our Quickstart series will have you compile and deploy contracts to
+zkSync Sepolia testnet which requires you to have ETH in your wallet for funding transactions.
+Alternatively, our `zksync-cli` tool provides a way for you to setup a test node locally.
+This era local node allows for quicker testing and debugging processes without incurring testnet transaction costs.
+
+#### Install Docker
+
+The era local node will need Docker to run locally on your machine.
+Download the appropriate version from the :external-link{text="Docker website" href="https://docs.docker.com/engine/install/"}.
+
+#### Run a local zkSync Era node
+
+Run the following command in your terminal:
+
+```bash
+zksync-cli dev start
+```
+
+Choose "In memory node" to deploy a local zkSync Era node in a Docker container.
+
+The local era node will also include pre-configured rich wallets for use,
+<!-- TODO: update link -->
+<!-- visit [era-test-node rich wallets](https://era.zksync.io/docs/tools/testing/era-test-node.html#use-pre-configured-rich-wallets) -->
+
+Your local zkSync Era node is accessible at **[http://127.0.0.1:8011](http://127.0.0.1:8011/)**, ready for deployment or testing purposes.
+Leave this terminal open and running as you build your projects.
+When you are done running your local Era node, you can stop it with `Ctrl+C`.
+
+---
+
+## Choose Hardhat or Foundry
+
+Our Quickstart series provides two options for your learning process using
+either Hardhat or Foundry. Pick one to use and stick with as you go through
+each of the guides.
+
+<!-- Create a component that sets which tool they use and pre-set the tabs -->
+
+### Install foundry-zksync
+
+If you choose to use Foundry for the Quick Start series, you will need to
+install the `foundry-zksync` tool. This tool is a specialized fork of Foundry, tailored for zkSync.
+It extends Foundry's capabilities for Ethereum app development to support zkSync,
+allowing for the compilation, deployment, testing, and interaction with smart contracts on zkSync.
+
+::callout{icon="i-heroicons-information-circle-16-solid" color="amber"}
+`foundry-zksync` is still in an alpha stage, so some features might not be fully supported
+yet and may not work as fully intended. It is open-sourced and contributions are welcome.
+::
+
+Install `foundry-zksync` with the following command:
+<!-- TODO: @dutterbutter this should be a single curl command -->
+```bash
+# TODO: @dutterbutter this should be a single curl command without Rust requirements
+git clone git@github.com:matter-labs/foundry-zksync.git
+cd foundry-zksync
+cargo build --bin forge --bin cast --release
+```
+
+---
+
+## Fund your wallet
+
+If you did not set up a local era node for development and plan to use zkSync Sepolia testnet, you will need testnet ETH to fund transactions.
+
+1. Obtaining Testnet ETH:
+
+    - Use the [LearnWeb3 faucet](https://learnweb3.io/faucets/zksync_sepolia/)
+    to directly receive testnet ETH on zkSync Sepolia.
+    - Alternatively, acquire SepoliaETH from [recommended faucets](https://www.notion.so/tooling/network-faucets.md) and
+    transfer it to the zkSync Sepolia testnet via the [zkSync bridge](https://portal.zksync.io/bridge/?network=sepolia).
+
+1. Verify your balance:
+
+      - Check your wallet's balance using the [zkSync Sepolia explorer](https://sepolia.explorer.zksync.io/).
+
+---
+
+## Configure your wallet in a project
+
+To deploy contracts, you'll need to securely add your wallet's private key to the project environment. Follow these steps when you set up a new project:
+
+1. **Extract Your Private Key:**
+      <!-- markdownlint-disable-next-line MD013 -->
+      - If you are using the local era node, use a private key from the available rich accounts. Otherwise, find your personal wallet's private key. For MetaMask users, here's how to :external-link{ text="export your wallet's private key" href="https://support.metamask.io/hc/en-us/articles/360015289632-How-to-export-an-account-s-private-key" }.
+
+1. **Prepare the Environment File:**
+      - Locate the **`.env-example`** file in your project directory.
+      - Rename this file to **`.env`**.
+
+1. **Add Your Private Key:**
+      - Open the `.env` file and add your private key in the following format:
+
+        ```sh
+        WALLET_PRIVATE_KEY=your_private_key_here
+        ```
+
+      - Replace **`your_private_key_here`** with your actual private key.
+
+---
+
+## Next Steps
+
+You should now have a fully working local environment to build new projects on zkSync!
+
+- Continue to [Hello zkSync!](/quick-start/hello-zksync) to begin the series on building a crowdfunding campaign for Zeek.
+<!-- TODO: add a link to other guides -->
+- This setup provides you everything you need to build in zkSync.
+You can skip on to creating your own projects using `zksync-cli` with your fully set up local dev environment.
diff --git a/content/10.quick-start/10.hello-zksync.md b/content/10.quick-start/10.hello-zksync.md
new file mode 100644
index 00000000..954d12be
--- /dev/null
+++ b/content/10.quick-start/10.hello-zksync.md
@@ -0,0 +1,58 @@
+---
+title: Hello zkSync!
+description: Learn to deploy smart contracts efficiently in the zkSync environment.
+---
+
+Welcome to the Quickstart guide for deploying smart contracts on zkSync! In this series, we'll walk you through the process
+of creating and deploying a simple smart contract that creates a crowdfunding campaign for Zeek. In this section you will learn the following:
+
+:check-icon Initialize a new project with zkSync-cli.
+
+:check-icon Craft a smart contract to fund Zeek's latest adventure.
+
+:check-icon Deploy the contract on the zkSync Era using your choice of Hardhat or Foundry.
+
+Let's dive in and start your developer journey on zkSync!
+
+---
+
+## Prerequisites
+
+This Quickstart series requires some initial setup of tools to elevate your
+development experience building for zkSync.
+Make sure to go through the setup provided in the initial [Getting Started](/quick-start) section.
+
+Select the framework you want to get started using zkSync Era with.
+
+::content-switcher
+---
+items: [{
+  label: 'Hardhat',
+  partial: '_hello-zksync/_hardhat_deploy_contract'
+}, {
+  label: 'Foundry',
+  partial: '_hello-zksync/_foundry_deploy_contract'
+}]
+---
+::
+
+## Takeaways
+
+- **EVM Compatibility:** zkSync is EVM compatible and you can write smart contracts in Solidity or Vyper.
+- **Custom Compilation:** Contracts deployed to zkSync are compiled using `zksolc` or `zkvyper` as
+they generate a special bytecode for zkSync's ZKEVM.
+- **Development Tools:** zkSync supports your favorite development toolkit Hardhat and Foundry.
+
+## Next steps
+
+Having successfully deployed your first contract on zkSync, you're well on your way to becoming
+a proficient zkSync developer. To expand your expertise:
+
+- **Explore Contract Factories:** Enhance your project by building a contract factory
+for the `CrowdfundingCampaign` contract in the [next guide](/quick-start/contract-factory). This will allow you to efficiently
+manage multiple crowdfunding campaigns, each with its own unique parameters.
+- **Dive Deeper into zkSync Features:** Investigate advanced zkSync features such as account abstraction,
+and paymasters.
+- **Join the Community:** Engage with the zkSync developer community through forums,
+Discord channels, Dev Discussions, or GitHub repositories. Share your experiences, ask questions,
+and collaborate on projects.
diff --git a/content/10.quick-start/20.contract-factory.md b/content/10.quick-start/20.contract-factory.md
new file mode 100644
index 00000000..b9c23849
--- /dev/null
+++ b/content/10.quick-start/20.contract-factory.md
@@ -0,0 +1,67 @@
+---
+title: Contract Factory
+description: Learn how to deploy and manage multiple smart contracts on zkSync using a contract factory.
+---
+
+This second Quickstart installment advances from your introductory exploration of smart contract deployment to dive into the utility of contract factories.
+Through this guide, you'll learn how to streamline the deployment of multiple crowdfunding campaigns using a single contract factory, leveraging the
+foundational `CrowdfundingCampaign` contract in the first guide.
+
+:check-icon Advance your zkSync development journey with contract factories.
+
+:check-icon Construct a contract factory to create multiple crowdfunding campaigns.
+
+:check-icon Seamlessly deploy your contract factory on zkSync Era, using either Hardhat or Foundry.
+
+Let's explore the efficiency and scalability that contract factories bring.
+
+## What is a contract factory?
+
+A contract factory is a design pattern that allows for the creation of multiple
+contract instances from a single "factory" contract. It's essentially a contract
+that creates other contracts, streamlining and organizing the deployment of
+numerous similar contracts efficiently.
+
+---
+
+## Setup the project
+
+Select the framework you want to get started using zkSync Era with.
+
+::content-switcher
+---
+items: [{
+  label: 'Hardhat',
+  partial: '_deploy_factory/_hardhat_deploy_contract_factory'
+}, {
+  label: 'Foundry',
+  partial: '_deploy_factory/_foundry_deploy_contract_factory'
+}]
+---
+::
+
+## Takeaways
+
+- **Contract Factories:** Utilizing contract factories significantly streamlines
+the deployment process, allowing for the creation of multiple instances of a
+contract, like the `CrowdfundingCampaign`, with varied parameters.
+- **Scalability and Management:** Contract factories offer a scalable solution to manage
+numerous contract instances, enhancing project organization and efficiency.
+- **Event-Driven Insights:** The `CampaignCreated` event in the factory contract provides
+a transparent mechanism to track each crowdfunding campaign's deployment, useful for
+off-chain monitoring and interaction.
+
+## Next steps
+
+With the contract factory in your zkSync development arsenal, you're set to elevate
+your smart contract projects. Here's how you can further your journey:
+
+- **Contract Testing:** Progress to the next guide focused on testing your contracts.
+Ensuring the reliability and security of your `CrowdfundingCampaign` through
+comprehensive tests is critical.
+- **Advanced zkSync Integrations:** Explore deeper into zkSync's ecosystem by
+implementing features like account abstraction and paymasters to enhance user
+experience and contract flexibility.
+- **Community Engagement and Contribution:** Join the vibrant zkSync community.
+Participate in forums, Discord, or GitHub discussions. Sharing insights, asking queries,
+and contributing can enrich the ecosystem and your understanding of zkSync.
diff --git a/content/10.quick-start/30.testing.md b/content/10.quick-start/30.testing.md
new file mode 100644
index 00000000..5d0eec48
--- /dev/null
+++ b/content/10.quick-start/30.testing.md
@@ -0,0 +1,58 @@
+---
+title: Testing
+description: Discover how to effectively test smart contracts on zkSync Era ecosystem.
+---
+
+Welcome back to our Quickstart Series, your fast-track to zkSync development! In this
+third guide, we transition from deploying and managing contracts to the critical phase
+of testing. This guide will walk you through the steps to ensure your `CrowdfundingCampaign`
+contracts, introduced in our first guide and efficiently deployed through contract factories
+in the second, work flawlessly.
+
+:check-icon Elevate your zkSync toolkit with robust contract testing techniques.
+
+:check-icon Craft comprehensive tests for your `CrowdfundingCampaign` to ensure reliability and security.
+
+:check-icon Use Hardhat or Foundry to write and run tests, ensuring your campaigns are ready.
+
+Dive into the world of smart contract testing and solidify the foundation of your zkSync projects.
+
+## Setup the project
+
+::content-switcher
+---
+items: [{
+  label: 'Hardhat',
+  partial: '_testing/_hardhat_contract_testing'
+}, {
+  label: 'Foundry',
+  partial: '_testing/_foundry_contract_testing'
+}]
+---
+::
+
+## Takeaways
+
+- **Testing**: Understanding contract testing is important for ensuring the reliability and security of your smart contracts
+on zkSync. Proper testing safeguards against unforeseen errors and vulnerabilities.
+- **Comprehensive Coverage**: Achieving comprehensive test coverage, including both positive and negative testing
+scenarios, is essential for a robust smart contract. This guide emphasized the `contribute` method,
+but testing should encompass all aspects of your contract.
+- **Tooling Efficiency**: Leveraging Hardhat or Foundry for testing provides a streamlined and efficient workflow.
+These tools offer powerful features and plugins, like `@nomicfoundation/hardhat-chai-matchers`,
+that enhance the testing process.
+
+## Next Steps
+
+With a solid foundation in contract testing, you're well-equipped to advance your zkSync
+development journey. Consider the following steps to further your expertise:
+
+- **Upgradeability**: Delve into the [next guide](/quick-start/upgrading) focusing on contract upgradability.
+Learning to make your contracts upgradeable will enable you to update and improve your smart contracts
+over time without losing state or funds.
+- **Advanced zkSync Integrations:** Explore deeper into zkSync's ecosystem by
+implementing features like account abstraction and paymasters to enhance user
+experience and contract flexibility.
+- **Community Engagement and Contribution:** Join the vibrant zkSync community.
+Participate in forums, Discord, or GitHub discussions. Sharing insights, asking queries,
+and contributing can enrich the ecosystem and your understanding of zkSync.
diff --git a/content/10.quick-start/40.upgrading.md b/content/10.quick-start/40.upgrading.md
new file mode 100644
index 00000000..fa798004
--- /dev/null
+++ b/content/10.quick-start/40.upgrading.md
@@ -0,0 +1,59 @@
+---
+title: Upgradability
+description: Learn to make smart contracts upgradeable within the zkSync ecosystem.
+---
+
+In this fourth installment, we embark on a journey through contract upgradability,
+an important aspect for maintaining and enhancing smart contracts over time. This guide will
+lead you through the strategies and practices for making the `CrowdfundingCampaign` contract **upgradeable**.
+
+:check-icon Harness advanced techniques for contract upgradability in zkSync.
+
+:check-icon Implement upgradeable patterns for the `CrowdfundingCampaign` to ensure long-term adaptability and improvement.
+
+:check-icon Leverage tools and best practices in zkSync to facilitate seamless contract upgrades.
+
+Begin to understand smart contract evolution and empower your zkSync applications with the
+flexibility of upgradability.
+
+Select your preferred upgrade mechanism:
+
+::content-switcher
+---
+items: [{
+  label: 'Transparent',
+  partial: '_upgrading/_transparent_proxy_contract_upgradability'
+}, {
+  label: 'Beacon',
+  partial: '_upgrading/_beacon_proxy_contract_upgradability'
+},
+ {
+  label: 'UUPS',
+  partial: '_upgrading/_uups_contract_upgradability'
+},]
+---
+::
+
+## Takeaways and Next Steps
+
+### Takeaways
+
+- **Upgradability:** The guide highlights the critical aspect of smart contract upgradability, introducing techniques
+for using transparent, beacon, and UUPS proxies.
+This ensures your contracts remain adaptable, allowing for seamless updates to business logic or enhancements in efficiency.
+
+- **Flexibility:** Emphasizing flexibility, the guide demonstrates how upgradable
+contracts maintain continuity of state and fund security, even as underlying
+functionalities evolve. This approach provides a resilient framework for your dApps to grow and adapt over time.
+
+### Next Steps
+
+- **Exploring Paymasters:** Continue on to the next guide focused on [using paymasters](/quick-start/paymaster)
+with your smart contracts. Paymasters abstract gas payments in transactions,
+offering new models for transaction fee management and enhancing user experience in dApps.
+- **Advanced zkSync Integrations:** Explore deeper into zkSync's ecosystem by
+implementing features like account abstraction and paymasters to enhance user
+experience and contract flexibility.
+- **Community Engagement and Contribution:** Join the vibrant zkSync community.
+Participate in forums, Discord, or GitHub discussions. Sharing insights, asking queries,
+and contributing can enrich the ecosystem and your understanding of zkSync.
diff --git a/content/10.quick-start/50.paymaster.md b/content/10.quick-start/50.paymaster.md
new file mode 100644
index 00000000..67a97bed
--- /dev/null
+++ b/content/10.quick-start/50.paymaster.md
@@ -0,0 +1,70 @@
+---
+title: Paymaster
+description: Implement a paymaster flow into your project.
+---
+
+Welcome to the final part of our Quickstart Series on mastering zkSync development!
+In this guide, we move beyond the basics
+of smart contract deployment and the creation of contract factories to explore the innovative concept of paymasters
+in the zkSync ecosystem. This guide will illuminate the power of paymasters to revolutionize transaction
+fee management and enhance user experiences within your dApps.
+
+:check-icon Delve deeper into zkSync development with the introduction of paymasters.
+
+:check-icon Learn how paymasters can cover transaction fees for your dApp users, enhancing accessibility and user experience.
+
+:check-icon Discover the flexibility of fee payment with paymasters, including the ability to pay
+fees in ERC20 tokens on zkSync Era, using Hardhat or Foundry.
+
+Embark on this journey to understand how paymasters can add a new layer of functionality and user-friendliness
+to your decentralized applications.
+
+## What are Paymasters?
+
+Paymasters in the zkSync ecosystem represent a groundbreaking approach to handling transaction fees.
+They are special accounts designed to subsidize transaction costs for other accounts, potentially making
+certain transactions free for end-users. This feature is particularly useful for dApp developers looking
+to improve their platform's accessibility and user experience by covering transaction fees on behalf of their users.
+
+## Built-in Paymaster Flows
+
+Paymasters can operate under various flows, some of which may require user interaction, such as setting allowances
+for token swaps. These flows enable paymasters to support a wide range of use cases, from simple fee subsidies
+to more complex scenarios involving ERC20 token exchanges for transaction fees.
+
+- **General Paymaster Flow:** This default flow requires no preliminary actions from users, allowing paymasters
+to interpret transaction data as needed to cover fees.
+
+- **Approval-Based Paymaster Flow:** For operations requiring user permissions, such as token allowances,
+this flow provides a structured approach. It ensures that user tokens can be seamlessly exchanged for transaction
+fees, subject to user-approved limits.
+
+As we explore paymasters, remember that while they offer enhanced flexibility for fee management, their
+implementation should always prioritize security and user trust. This guide aims to equip you with the knowledge
+to effectively incorporate paymasters into your zkSync projects, paving the way for more user-friendly and accessible dApps.
+
+---
+
+## Paymaster flow
+
+Select the paymaster type you want to get started using zkSync Era with.
+
+::content-switcher
+---
+items: [{
+  label: 'General',
+  partial: '_paymasters/_general_paymaster_flow'
+},{
+  label: 'Approval',
+  partial: '_paymasters/_approval_paymaster_flow'
+}]
+---
+::
+
+## Takeaways
+
+-
+
+## Next steps
+
+-
diff --git a/content/10.quick-start/_deploy_factory/_foundry_deploy_contract_factory.md b/content/10.quick-start/_deploy_factory/_foundry_deploy_contract_factory.md
new file mode 100644
index 00000000..0db0657a
--- /dev/null
+++ b/content/10.quick-start/_deploy_factory/_foundry_deploy_contract_factory.md
@@ -0,0 +1,140 @@
+---
+title: Foundry | Deploy Contract Factory
+---
+<!-- TODO: @dutterbutter update to simplify the project init step -->
+Run the following command in your terminal to initialize the Foundry project.
+
+```sh
+git clone https://github.com/dutterbutter/zksync-foundry-quickstart-guide
+cd zksync-foundry-quickstart-guide
+git checkout db/deploy-contract-factory
+```
+
+## Set up your wallet
+
+:display-partial{path="quick-start/_partials/_setup-wallet"}
+
+---
+
+## Review the CrowdfundingFactory contract
+
+The `CrowdfundingFactory.sol` we will compile and deploy is provided under the [`/src` directory](https://github.com/dutterbutter/zksync-foundry-quickstart-guide/blob/db/deploy-contract-factory/src/CrowdfundFactory.sol).
+
+The `CrowdfundingFactory.sol`contract will be used to deploy multiple instances of
+the `CrowdfundingCampaign.sol` contract from the previous guide.
+
+::drop-panel
+  ::panel{label="CrowdfundingFactory.sol"}
+    ```solidity
+    // SPDX-License-Identifier: MIT
+    pragma solidity ^0.8.0;
+
+    // Crowdfunding campaign contract
+    import "./CrowdfundingCampaign.sol";
+
+    // Factory contract to create and manage crowdfunding campaigns
+    contract CrowdfundingFactory {
+        CrowdfundingCampaign[] public campaigns;
+
+        event CampaignCreated(address campaignAddress, uint256 fundingGoal);
+
+        function createCampaign(uint256 fundingGoal) public {
+            CrowdfundingCampaign newCampaign = new CrowdfundingCampaign(fundingGoal);
+            campaigns.push(newCampaign);
+
+            emit CampaignCreated(address(newCampaign), fundingGoal);
+        }
+
+        function getCampaigns() public view returns (CrowdfundingCampaign[] memory) {
+            return campaigns;
+        }
+    }
+    ```
+  ::
+::
+
+The `CrowdfundingFactory` contract automates the creation and oversight of
+`CrowdfundingCampaign` contracts, each with its distinct funding goals, it features:
+
+- **Campaign Creation**: Utilizes the `createCampaign` method to initiate a new
+`CrowdfundingCampaign` contract. This function takes a `fundingGoal` as an argument,
+deploys a new campaign contract with this goal, and tracks the created campaign in the
+`campaigns` array.
+- **Campaign Tracking**: The `getCampaigns` method offers a view into all the campaigns
+created by the factory, allowing for easy access and management of multiple crowdfunding
+initiatives.
+
+This contract factory approach streamlines the deployment of crowdfunding campaigns,
+making it efficient to launch and manage multiple campaigns.
+
+### Compile contract
+
+Smart contracts deployed to zkSync must be compiled using our custom compiler.
+For this particular guide we are making use of `zksolc`.
+
+To compile the contracts in the project, run the following command:
+
+```bash
+forge build --zksync
+```
+
+Upon successful compilation, you'll receive output detailing the
+`zksolc` and `solc` versions used during compiling and the number
+of Solidity files compiled.
+
+```bash
+[⠒] Compiling...
+[⠃] Compiling 3 files with 0.8.20
+[⠊] Solc 0.8.20 finished in 336.48ms
+Compiler run successful!
+Compiling contracts for zkSync Era with zksolc v1.4.0
+```
+
+The compiled zkEVM artifacts will be located in the `/zkout` folder, and the solc
+artifacts will be located in the `/out` folder.
+
+---
+
+## Deploy a CrowdfundingCampaign with CrowdfundingFactory
+
+This section outlines the steps to deploy the `CrowdfundingCampaign` contract using
+our new `CrowdfundingFactory`.
+
+1. Let's start by deploying the `CrowdfundingFactory` contract. Execute the following
+command:
+
+    ```bash
+    forge create src/CrowdfundFactory.sol:CrowdfundingFactory --factory-deps src/CrowdfundingCampaign.sol:CrowdfundingCampaign --rpc-url zkSyncSepoliaTestnet --chain 300 --private-key <YOUR-PRIVATE-KEY> --zksync
+    # To deploy the contract on local in-memory node:
+    # forge script script/DeployFactory.s.sol:DeployFactoryAndCreateCampaign --rpc-url inMemoryNode --broadcast --zksync
+    ```
+
+    Upon a successfull deployment you'll receive details of the deploying address, the contract address,
+    and the transaction hash, like so:
+
+    ```bash
+    Deployer: 0x89E0Ff69Cc520b55C9F7Bcd3EAC17e81d9bB8dc2
+    Deployed to: 0x607545Fd35ef49d7445555ddFa22938fD4Efb219
+    Transaction hash: 0x94e7a97bb64c2bacffbd2a47f3c10021a80156d11082c079046a426c99518d28
+    ```
+
+1. Using the `CrowdfundingFactory` contract address let's deploy our `CrowdfundingCampaign`:
+
+    ```bash
+    cast send 0x607545Fd35ef49d7445555ddFa22938fD4Efb219 "createCampaign(uint256)" "1" --rpc-url zkSyncSepoliaTestnet --chain 300 --private-key <YOUR-PRIVATE-KEY>
+    # To use the contract factory on local in-memory node:
+    # cast send 0x607545Fd35ef49d7445555ddFa22938fD4Efb219 "createCampaign(uint256)" "1" --rpc-url inMemoryNode --chain 260 --private-key <YOUR-PRIVATE-KEY>
+    ```
+
+    Upon a successfull deployment you'll receive details of the transaction, including the
+    contract address of our crowdfunding campaign:
+
+    ```bash
+    blockHash               0x7f8dfcd365b4ba5ac690e94aedb5fdb2bdb5ef12b2ff68672ab58c7a89738161
+    blockNumber             1576375
+    contractAddress         0x95f83473b88B5599cdB273F976fB3DC66DEA1c1D
+    ...
+    ...
+    ```
+
+🌟 Brilliant! Your contract factory and its first crowdfunding campaign are now operational.
diff --git a/content/10.quick-start/_deploy_factory/_hardhat_deploy_contract_factory.md b/content/10.quick-start/_deploy_factory/_hardhat_deploy_contract_factory.md
new file mode 100644
index 00000000..b614e92c
--- /dev/null
+++ b/content/10.quick-start/_deploy_factory/_hardhat_deploy_contract_factory.md
@@ -0,0 +1,215 @@
+---
+title: Hardhat | Deploy Contract Factory
+---
+<!-- TODO: @dutterbutter determine best approach to leverage zksync cli for project
+bootstrapping for this guide series. -->
+Run the following command in your terminal to initialize the project.
+
+```sh
+git clone https://github.com/dutterbutter/zksync-quickstart-guide.git
+cd zksync-quickstart-guide
+git checkout db/contract-factories
+```
+
+Install the dependencies:
+
+::code-group
+
+```bash [npm]
+npm install
+```
+
+```bash [yarn]
+yarn install
+```
+
+```bash [pnpm]
+pnpm install
+```
+
+```bash [bun]
+bun install
+```
+
+::
+
+## Set up your wallet
+
+:display-partial{path="quick-start/_partials/_setup-wallet"}
+
+---
+
+## Compile the contracts
+
+This section will focus on compiling and deploying the `CrowdfundingFactory.sol`
+contract that is provided under the [`/contracts` directory](https://github.com/dutterbutter/zksync-quickstart-guide/blob/db/contract-factories/contracts/CrowdfundFactory.sol).
+
+The `CrowdfundingFactory.sol`contract will be used to deploy multiple instances of
+the `CrowdfundingCampaign.sol` contract from the previous guide.
+This contract factory approach streamlines the deployment of crowdfunding campaigns,
+making it efficient to launch and manage multiple campaigns.
+
+::drop-panel
+  ::panel{label="CrowdfundingFactory.sol"}
+    ```solidity
+    // SPDX-License-Identifier: MIT
+    pragma solidity ^0.8.0;
+
+    // Crowdfunding campaign contract
+    import "./CrowdfundingCampaign.sol";
+
+    // Factory contract to create and manage crowdfunding campaigns
+    contract CrowdfundingFactory {
+        CrowdfundingCampaign[] public campaigns;
+
+        event CampaignCreated(address campaignAddress, uint256 fundingGoal);
+
+        function createCampaign(uint256 fundingGoal) public {
+            CrowdfundingCampaign newCampaign = new CrowdfundingCampaign(fundingGoal);
+            campaigns.push(newCampaign);
+
+            emit CampaignCreated(address(newCampaign), fundingGoal);
+        }
+
+        function getCampaigns() public view returns (CrowdfundingCampaign[] memory) {
+            return campaigns;
+        }
+    }
+    ```
+  ::
+::
+
+The `CrowdfundingFactory` contract automates the creation and oversight of
+`CrowdfundingCampaign` contracts, each with their own distinct funding goals.
+The factory contract features:
+
+- **Campaign Creation**: Utilizes the `createCampaign` method to initiate a new
+`CrowdfundingCampaign` contract. This function takes a `fundingGoal` as an argument,
+deploys a new campaign contract with this goal, and tracks the created campaign in the
+`campaigns` array.
+- **Campaign Tracking**: The `getCampaigns` method offers a view into all the campaigns
+created by the factory, allowing for easy access and management of multiple crowdfunding
+initiatives.
+
+:display-partial{path = "/_partials/_compile-solidity-contracts"}
+
+Upon successful compilation, you'll receive output detailing the
+`zksolc` and `solc` versions used during compiling and the number
+of Solidity files compiled.
+
+```bash
+Compiling contracts for zkSync Era with zksolc v1.4.0 and solc v0.8.17
+Compiling 2 Solidity file
+Successfully compiled 2 Solidity file
+```
+
+The compiled artifacts will be located in the `/artifacts-zk` folder.
+
+### Deploy CrowdfundingCampaigns via the CrowdfundingFactory
+
+This section outlines the steps to deploy the `CrowdfundingCampaign` contract
+using our new `CrowdfundingFactory`.
+
+The deployment script is located at `/deploy/deployUsingFactory.ts`.
+
+::drop-panel
+  ::panel{label="deployUsingFactory.ts"}
+
+  ```typescript
+  import { deployContract, getWallet } from "./utils";
+  import { ethers } from "ethers";
+  import { HardhatRuntimeEnvironment } from "hardhat/types";
+
+  export default async function (hre: HardhatRuntimeEnvironment) {
+    const contractArtifactName = "CrowdfundingFactory";
+    const constructorArguments = [];
+    const crowdfundingFactory = await deployContract(contractArtifactName, constructorArguments);
+
+    console.log(`🏭 CrowdfundingFactory address: ${crowdfundingFactory.target}`);
+
+    const contractArtifact = await hre.artifacts.readArtifact("CrowdfundingFactory");
+    const factoryContract = new ethers.Contract(
+      crowdfundingFactory.target,
+      contractArtifact.abi,
+      getWallet()
+    );
+
+    // Define funding goal for the campaign, e.g., 0.1 ether
+    const fundingGoalInWei = ethers.parseEther('0.1').toString();
+
+    // Use the factory to create a new CrowdfundingCampaign
+    const createTx = await factoryContract.createCampaign(fundingGoalInWei);
+    await createTx.wait();
+
+    // Retrieve the address of the newly created CrowdfundingCampaign
+    const campaigns = await factoryContract.getCampaigns();
+    const newCampaignAddress = campaigns[campaigns.length - 1];
+
+    console.log(`🚀 New CrowdfundingCampaign deployed at: ${newCampaignAddress}`);
+    console.log('✅ Deployment and campaign creation complete!');
+  }
+  ```
+
+  ::
+::
+
+- The `deployUsingFactory.ts` script deploys the `CrowdfundingFactory` through the `deployContract` method.
+- An instance of the factory is assigned to `factoryContract`.
+  This gives us access to the factory's functionalities.
+- The `createCampaign` method is called on this instance to create
+  and deploy a new crowdfunding campaign contract.
+
+Run the deployment command. The default command
+deploys to the configured network in your Hardhat setup. For local deployment, append
+`--network inMemoryNode` to deploy to the local in-memory node running.
+
+::code-group
+
+```bash [npm]
+npm run hardhat deploy-zksync --script deployUsingFactory.ts
+# To deploy the contract on local in-memory node:
+# npm run hardhat deploy-zksync --script deployUsingFactory.ts --network inMemoryNode
+```
+
+```bash [yarn]
+yarn hardhat deploy-zksync --script deployUsingFactory.ts
+# To deploy the contract on local in-memory node:
+# yarn hardhat deploy-zksync --script deployUsingFactory.ts --network inMemoryNode
+```
+
+```bash [pnpm]
+pnpm run hardhat deploy-zksync --script deployUsingFactory.ts
+# To deploy the contract on local in-memory node:
+# pnpm run hardhat deploy-zksync --script deployUsingFactory.ts --network inMemoryNode
+```
+
+```bash [bun]
+bun run hardhat deploy-zksync --script deployUsingFactory.ts
+# To deploy the contract on local in-memory node:
+# bun run hardhat deploy-zksync --script deployUsingFactory.ts --network inMemoryNode
+```
+
+::
+
+Upon successful deployment, you'll receive output detailing the deployment process,
+including the contract address, source, and encoded constructor arguments:
+
+```bash
+Starting deployment process of "CrowdfundingFactory"...
+Estimated deployment cost: 0.0002500236 ETH
+
+"CrowdfundingFactory" was successfully deployed:
+ - Contract address: 0xD084EF36f8F5353f70498cD84cb8D2B844C120a8
+ - Contract source: contracts/CrowdfundFactory.sol:CrowdfundingFactory
+ - Encoded constructor arguments: 0x
+
+Requesting contract verification...
+Your verification ID is: 10097
+Contract successfully verified on zkSync block explorer!
+🏭 CrowdfundingFactory address: 0xD084EF36f8F5353f70498cD84cb8D2B844C120a8
+🚀 New CrowdfundingCampaign deployed at: 0x060B748eC3512795E94045c406CFd5877DD84e4D
+✅ Deployment and campaign creation complete!
+```
+
+🌟 Brilliant! Your contract factory and its first crowdfunding campaign are now
+operational.
diff --git a/content/10.quick-start/_dir.yml b/content/10.quick-start/_dir.yml
new file mode 100644
index 00000000..f29ef524
--- /dev/null
+++ b/content/10.quick-start/_dir.yml
@@ -0,0 +1,2 @@
+title: Quickstart
+layout: docs
diff --git a/content/10.quick-start/_hello-zksync/_foundry_deploy_contract.md b/content/10.quick-start/_hello-zksync/_foundry_deploy_contract.md
new file mode 100644
index 00000000..51380e35
--- /dev/null
+++ b/content/10.quick-start/_hello-zksync/_foundry_deploy_contract.md
@@ -0,0 +1,154 @@
+---
+title: Foundry | Deploy Contract
+---
+
+:display-partial{path = "/_partials/_environment-setup-with-foundry"}
+
+## Set up your wallet
+
+:display-partial{path = "/quick-start/_partials/_setup-wallet"}
+
+## Compile your first contract
+
+This guide
+introduces a crowdfunding campaign contract aimed at supporting Zeek's inventive ventures.
+
+Let's start by reviewing the starter contract in the [`src/` directory](https://github.com/dutterbutter/zksync-foundry-quickstart-guide/blob/main/src/Crowdfund.sol).
+
+::drop-panel
+  ::panel{label="CrowdfundingCampaign.sol"}
+    ```solidity
+    // SPDX-License-Identifier: MIT
+    pragma solidity ^0.8.0;
+
+    contract CrowdfundingCampaign {
+        address public owner;
+        uint256 public fundingGoal;
+        uint256 public totalFundsRaised;
+        mapping(address => uint256) public contributions;
+
+        event ContributionReceived(address contributor, uint256 amount);
+        event GoalReached(uint256 totalFundsRaised);
+
+        constructor(uint256 _fundingGoal) {
+            owner = msg.sender;
+            fundingGoal = _fundingGoal;
+        }
+
+        function contribute() public payable {
+            require(msg.value > 0, "Contribution must be greater than 0");
+            contributions[msg.sender] += msg.value;
+            totalFundsRaised += msg.value;
+
+            emit ContributionReceived(msg.sender, msg.value);
+
+            if (totalFundsRaised >= fundingGoal) {
+                emit GoalReached(totalFundsRaised);
+            }
+        }
+
+        function withdrawFunds() public {
+            require(msg.sender == owner, "Only the owner can withdraw funds");
+            require(totalFundsRaised >= fundingGoal, "Funding goal not reached");
+
+            uint256 amount = address(this).balance;
+            totalFundsRaised = 0;
+
+            (bool success, ) = payable(owner).call{value: amount}("");
+            require(success, "Transfer failed.");
+        }
+
+        function getTotalFundsRaised() public view returns (uint256) {
+            return totalFundsRaised;
+        }
+
+        function getFundingGoal() public view returns (uint256) {
+            return fundingGoal;
+        }
+    }
+    ```
+  ::
+::
+
+The `CrowdfundingCampaign` contract is designed for project crowdfunding.
+Owned and deployed with a set funding goal, it features:
+
+- A constructor to initialize the campaign's funding target.
+- The `contribute` method to log funds, triggering `ContributionReceived` and `GoalReached` events.
+- The `withdrawFunds` method, allowing the owner to collect accumulated funds post-goal achievement.
+
+Smart contracts deployed to zkSync must be compiled using our custom compiler.
+For this particular guide we are making use of `zksolc`.
+
+To compile the contracts in the project, run the following command:
+
+```bash
+forge build --zksync
+```
+
+Upon successful compilation, you'll receive output detailing the
+`zksolc` and `solc` versions used during compiling and the number
+of Solidity files compiled.
+
+```bash
+[⠒] Compiling...
+[⠃] Compiling 2 files with 0.8.20
+[⠊] Solc 0.8.20 finished in 736.48ms
+Compiler run successful!
+Compiling contracts for zkSync Era with zksolc v1.4.0
+```
+
+The compiled zkEVM artifacts will be located in the `/zkout` folder, and the solc artifacts will be
+located in the `/out` folder.
+
+### Deploy the CrowdfundingCampaign contract
+
+The deployment script is located at [`/script/Deploy.s.sol`](https://github.com/dutterbutter/zksync-foundry-quickstart-guide/blob/main/script/Deploy.s.sol).
+
+```solidity
+// SPDX-License-Identifier: UNLICENSED
+pragma solidity ^0.8.13;
+
+import "forge-std/Script.sol";
+import "../src/Crowdfund.sol";
+
+contract DeployCrowdfundContract is Script {
+    function run() external {
+        uint256 deployerPrivateKey = vm.envUint("WALLET_PRIVATE_KEY");
+        vm.startBroadcast(deployerPrivateKey);
+
+        uint256 fundingGoalInWei = 0.02 ether;
+        new CrowdfundingCampaign(fundingGoalInWei);
+
+        vm.stopBroadcast();
+    }
+}
+```
+
+**Key Components:**
+
+- **Constructor Argument:** The `CrowdfundingCampaign` contract is initialized with
+a single constructor argument, `fundingGoalInWei`.
+- **Broadcast Method:** The deployment uses `vm.startBroadcast(deployerPrivateKey)` to begin
+the transaction broadcast and `vm.stopBroadcast()` to end it, facilitating the actual deployment of the contract on the blockchain.
+
+Execute the deployment command.
+
+```bash
+forge script script/Deploy.s.sol:DeployCrowdfundContract --rpc-url zkSyncSepoliaTestnet --broadcast --zksync
+# To deploy the contract on local in-memory node:
+# forge script script/Deploy.s.sol:DeployCrowdfundContract --rpc-url inMemoryNode --broadcast --zksync
+```
+
+Upon successful deployment, you'll receive output detailing the deployment process,
+including the contract address, transaction hash, and block number deployed to:
+
+```bash
+...
+✅  [Success]Hash: 0x69f5f1f0f5b3fa12ed2fbab4d6bb6edc02bbfff2f8c414d8171cc8295250296c
+Contract Address: 0xB0C0d3d02c270b6ABe4862EA90bBa1Af192314a8
+Block: 1491370
+Paid: 0.0001168854 ETH (1168854 gas * 0.1 gwei)
+```
+
+🥳 Congratulations! Your smart contract is now deployed. 🚀
diff --git a/content/10.quick-start/_hello-zksync/_hardhat_deploy_contract.md b/content/10.quick-start/_hello-zksync/_hardhat_deploy_contract.md
new file mode 100644
index 00000000..c701f7f8
--- /dev/null
+++ b/content/10.quick-start/_hello-zksync/_hardhat_deploy_contract.md
@@ -0,0 +1,194 @@
+---
+title: Hardhat | Deploy Contract
+---
+
+Run the following command in your terminal to initialize the project.
+
+<!-- TODO: @dutterbutter determine best approach to leverage zksync cli for project
+bootstrapping for this guide series. -->
+
+```sh
+git clone https://github.com/dutterbutter/zksync-quickstart-guide.git
+cd zksync-quickstart-guide
+```
+
+Install the dependencies:
+
+::code-group
+
+```bash [npm]
+npm install
+```
+
+```bash [yarn]
+yarn install
+```
+
+```bash [pnpm]
+pnpm install
+```
+
+```bash [bun]
+bun install
+```
+
+::
+
+## Set up your wallet
+
+:display-partial{path="quick-start/_partials/_setup-wallet"}
+
+## Compile the CrowdfundingCampaign.sol contract
+
+This guide introduces a crowdfunding campaign contract aimed at supporting Zeek's inventive ventures.
+Let's start by reviewing the starter contract in the [`contracts/` directory](https://github.com/dutterbutter/zksync-quickstart-guide/blob/main/contracts/Crowdfund.sol).
+
+::drop-panel
+  ::panel{label="CrowdfundingCampaign.sol"}
+    ```solidity
+    // SPDX-License-Identifier: MIT
+    pragma solidity ^0.8.0;
+
+    contract CrowdfundingCampaign {
+        address public owner;
+        uint256 public fundingGoal;
+        uint256 public totalFundsRaised;
+        mapping(address => uint256) public contributions;
+
+        event ContributionReceived(address contributor, uint256 amount);
+        event GoalReached(uint256 totalFundsRaised);
+
+        constructor(uint256 _fundingGoal) {
+            owner = msg.sender;
+            fundingGoal = _fundingGoal;
+        }
+
+        function contribute() public payable {
+            require(msg.value > 0, "Contribution must be greater than 0");
+            contributions[msg.sender] += msg.value;
+            totalFundsRaised += msg.value;
+
+            emit ContributionReceived(msg.sender, msg.value);
+
+            if (totalFundsRaised >= fundingGoal) {
+                emit GoalReached(totalFundsRaised);
+            }
+        }
+
+        function withdrawFunds() public {
+            require(msg.sender == owner, "Only the owner can withdraw funds");
+            require(totalFundsRaised >= fundingGoal, "Funding goal not reached");
+
+            uint256 amount = address(this).balance;
+            totalFundsRaised = 0;
+
+            (bool success, ) = payable(owner).call{value: amount}("");
+            require(success, "Transfer failed.");
+        }
+
+        function getTotalFundsRaised() public view returns (uint256) {
+            return totalFundsRaised;
+        }
+
+        function getFundingGoal() public view returns (uint256) {
+            return fundingGoal;
+        }
+    }
+    ```
+  ::
+::
+
+The `CrowdfundingCampaign` contract is designed for project crowdfunding.
+This contract features:
+
+- A constructor to initialize the campaign's funding target.
+- The `contribute` method to log funds, triggering `ContributionReceived` and `GoalReached` events.
+- The `withdrawFunds` method, allowing the owner to collect accumulated funds post-goal achievement.
+
+:display-partial{path = "/_partials/_compile-solidity-contracts"}
+
+Upon successful compilation, you'll receive output detailing the
+`zksolc` and `solc` versions used during compiling and the number
+of Solidity files compiled.
+
+```bash
+Compiling contracts for zkSync Era with zksolc v1.4.0 and solc v0.8.17
+Compiling 1 Solidity file
+Successfully compiled 1 Solidity file
+```
+
+The compiled artifacts will be located in the `/artifacts-zk` folder.
+
+## Deploy the contract
+
+The deployment script is located at [`/deploy/deploy.ts`](https://github.com/dutterbutter/zksync-quickstart-guide/blob/main/deploy/deploy.ts).
+
+```typescript
+import { deployContract } from "./utils";
+
+// An example of a basic deploy script
+// It will deploy a CrowdfundingCampaign contract to selected network
+// `parseEther` converts ether to wei, and `.toString()` ensures serialization compatibility.
+export default async function () {
+  const contractArtifactName = "CrowdfundingCampaign";
+  const constructorArguments = [ethers.parseEther('.02').toString()];
+  await deployContract(contractArtifactName, constructorArguments);
+}
+```
+
+**Key Components:**
+
+- **contractArtifactName:** Identifies the `CrowdfundingCampaign` contract for deployment.
+- **constructorArguments:** Sets initialization parameters for the contract. In this case,
+the fundraising goal, converted from ether to `wei` to match Solidity's `uint256` type.
+
+1. Execute the deployment command corresponding to your package manager. The default command
+deploys to the configured network in your Hardhat setup. For local deployment, append
+`--network inMemoryNode` to deploy to the local in-memory node running.
+
+::code-group
+
+```bash [npm]
+npm run hardhat deploy-zksync --script deploy.ts
+# To deploy the contract on local in-memory node:
+# npm run hardhat deploy-zksync --script deploy.ts --network inMemoryNode
+```
+
+```bash [yarn]
+yarn hardhat deploy-zksync --script deploy.ts
+# To deploy the contract on local in-memory node:
+# yarn hardhat deploy-zksync --script deploy.ts --network inMemoryNode
+```
+
+```bash [pnpm]
+pnpm run hardhat deploy-zksync --script deploy.ts
+# To deploy the contract on local in-memory node:
+# pnpm run hardhat deploy-zksync --script deploy.ts --network inMemoryNode
+```
+
+```bash [bun]
+bun run hardhat deploy-zksync --script deploy.ts
+# To deploy the contract on local in-memory node:
+# bun run hardhat deploy-zksync --script deploy.ts --network inMemoryNode
+```
+
+::
+
+Upon successful deployment, you'll receive output detailing the deployment process,
+including the contract address, source, and encoded constructor arguments:
+
+```bash
+Starting deployment process of "CrowdfundingCampaign"...
+Estimated deployment cost: 0.000501 ETH
+
+"CrowdfundingCampaign" was successfully deployed:
+ - Contract address: 0x4E3404F21b29d069539e15f8f9E712CeAE39d90C
+ - Contract source: contracts/Crowdfund.sol:CrowdfundingCampaign
+ - Encoded constructor arguments: 0x00000000000000000000000000000000000000000000000000470de4df820000
+
+Requesting contract verification...
+Your verification ID is: 10067
+Contract successfully verified on zkSync block explorer!
+```
+
+🥳 Congratulations! Your smart contract is now deployed. 🚀
diff --git a/content/10.quick-start/_partials/_setup-wallet.md b/content/10.quick-start/_partials/_setup-wallet.md
new file mode 100644
index 00000000..e740dab6
--- /dev/null
+++ b/content/10.quick-start/_partials/_setup-wallet.md
@@ -0,0 +1,10 @@
+---
+title: Set up your wallet
+---
+
+Deploying contracts on the zkSync Sepolia testnet requires having testnet ETH.
+If you're working within the local development environment,
+you can utilize pre-configured rich wallets and skip this step.
+For testnet deployments, you should have your wallet funded from the [previous step](/quick-start#fund-your-wallet).
+
+Ensure your project is configured to [use your wallet via the `.env` file](/quick-start#fund-your-wallet).
diff --git a/content/10.quick-start/_paymasters/_approval_paymaster_flow.md b/content/10.quick-start/_paymasters/_approval_paymaster_flow.md
new file mode 100644
index 00000000..9f54594d
--- /dev/null
+++ b/content/10.quick-start/_paymasters/_approval_paymaster_flow.md
@@ -0,0 +1,379 @@
+---
+title: Approval Paymaster
+description: Learn to deploy contract factories in the zkSync environment.
+---
+
+<!-- TODO: @dutterbutter determine best approach to leverate zksync cli for project
+bootstrapping for this guide series. -->
+Run the following command in your terminal to initialize the project.
+
+```sh
+git clone https://github.com/dutterbutter/zksync-quickstart-guide.git
+cd zksync-quickstart-guide
+git checkout db/contract-paymaster
+```
+
+Install the dependencies:
+
+::code-group
+
+```bash [npm]
+npm install
+```
+
+```bash [yarn]
+yarn install
+
+```
+
+```bash [pnpm]
+pnpm install
+```
+
+```bash [bun]
+bun install
+```
+
+::
+
+## Set up your wallet
+
+:display-partial{path = "/quick-start/_partials/_setup-wallet"}
+
+---
+
+## Understanding the `ApprovalPaymaster` contract
+
+Let's start by reviewing the `ApprovalPaymaster.sol` contract in the `contracts/` directory:
+
+```solidity
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.0;
+
+import {IPaymaster, ExecutionResult, PAYMASTER_VALIDATION_SUCCESS_MAGIC} from "@matterlabs/zksync-contracts/l2/system-contracts/interfaces/IPaymaster.sol";
+import {IPaymasterFlow} from "@matterlabs/zksync-contracts/l2/system-contracts/interfaces/IPaymasterFlow.sol";
+import {TransactionHelper, Transaction} from "@matterlabs/zksync-contracts/l2/system-contracts/libraries/TransactionHelper.sol";
+import "@matterlabs/zksync-contracts/l2/system-contracts/Constants.sol";
+import "@openzeppelin/contracts/access/Ownable.sol";
+
+/// @notice This contract does not include any validations other than using the paymaster general flow.
+contract GaslessPaymaster is IPaymaster, Ownable {
+    modifier onlyBootloader() {
+        require(
+            msg.sender == BOOTLOADER_FORMAL_ADDRESS,
+            "Only bootloader can call this method"
+        );
+        // Continue execution if called from the bootloader.
+        _;
+    }
+
+    function validateAndPayForPaymasterTransaction(
+        bytes32,
+        bytes32,
+        Transaction calldata _transaction
+    )
+        external
+        payable
+        onlyBootloader
+        returns (bytes4 magic, bytes memory context)
+    {
+        // By default we consider the transaction as accepted.
+        magic = PAYMASTER_VALIDATION_SUCCESS_MAGIC;
+        require(
+            _transaction.paymasterInput.length >= 4,
+            "The standard paymaster input must be at least 4 bytes long"
+        );
+
+        bytes4 paymasterInputSelector = bytes4(
+            _transaction.paymasterInput[0:4]
+        );
+        if (paymasterInputSelector == IPaymasterFlow.general.selector) {
+            // Note, that while the minimal amount of ETH needed is tx.gasPrice * tx.gasLimit,
+            // neither paymaster nor account are allowed to access this context variable.
+            uint256 requiredETH = _transaction.gasLimit *
+                _transaction.maxFeePerGas;
+
+            // The bootloader never returns any data, so it can safely be ignored here.
+            (bool success, ) = payable(BOOTLOADER_FORMAL_ADDRESS).call{
+                value: requiredETH
+            }("");
+            require(
+                success,
+                "Failed to transfer tx fee to the Bootloader. Paymaster balance might not be enough."
+            );
+        } else {
+            revert("Unsupported paymaster flow in paymasterParams.");
+        }
+    }
+
+    function postTransaction(
+        bytes calldata _context,
+        Transaction calldata _transaction,
+        bytes32,
+        bytes32,
+        ExecutionResult _txResult,
+        uint256 _maxRefundedGas
+    ) external payable override onlyBootloader {
+        // Refunds are not supported yet.
+    }
+
+    function withdraw(address payable _to) external onlyOwner {
+        // send paymaster funds to the owner
+        uint256 balance = address(this).balance;
+        (bool success, ) = _to.call{value: balance}("");
+        require(success, "Failed to withdraw funds from paymaster.");
+    }
+
+    receive() external payable {}
+}
+```
+
+**Key components:**
+
+- The `GaslessPaymaster` contract ensures that transaction fees are handled automatically without user intervention.
+- **`validateAndPayForPaymasterTransaction` Method:** This mandatory method assesses whether the paymaster agrees to cover the
+transaction fees. If affirmative, it transfers the necessary funds
+(calculated as tx.gasprice * tx.gasLimit) to the operator. It returns a context for the `postTransaction` method.
+- **`postTransaction`** Method: An optional method invoked
+post-transaction execution, provided the transaction doesn't fail
+due to out-of-gas errors. It receives several parameters, including the transaction's context and result, aiding in finalizing paymaster duties.
+- **`onlyBootloader`** Modifier: Ensures that certain methods are
+exclusively callable by the system's bootloader, adding an extra layer of security and control.
+
+---
+
+## Compile and deploy the `ApprovalPaymaster` contract
+
+:display-partial{path = "/_partials/_compile-solidity-contracts"}
+
+Upon successful compilation, you'll receive output detailing the
+`zksolc` and `solc` versions used during compiling and the number
+of Solidity files compiled.
+
+```bash
+Compiling contracts for zkSync Era with zksolc v1.4.0 and solc v0.8.17
+Compiling 1 Solidity file
+Successfully compiled 1 Solidity file
+```
+
+The compiled artifacts will be located in the `/artifacts-zk` folder.
+
+The script to deploy the `GaslessPaymaster` contract is located at `/deploy/deploy.ts`.
+
+```typescript
+import { deployContract, getWallet, getProvider } from "./utils";
+import { ethers } from "ethers";
+
+// An example of a basic deploy script
+// It will deploy a CrowdfundingCampaign contract to selected network
+// `parseEther` converts ether to wei, and `.toString()` ensures serialization compatibility.
+export default async function() {
+  const contractArtifactName = "GaslessPaymaster";
+  const constructorArguments = [];
+  const contract = await deployContract(
+    contractArtifactName,
+    constructorArguments
+  );
+  const wallet = getWallet();
+  const provider = getProvider();
+
+  // Supplying paymaster with ETH
+  await (
+    await wallet.sendTransaction({
+      to: contract.target,
+      value: ethers.parseEther("0.005"),
+    })
+  ).wait();
+
+  let paymasterBalance = await provider.getBalance(contract.target.toString());
+  console.log(`Paymaster ETH balance is now ${paymasterBalance.toString()}`);
+}
+```
+
+**Key Components:**
+
+- **`deployContract` Method:** Utilized for deploying the `GaslessPaymaster` contract. This method takes the name of the
+contract and any constructor arguments needed for initialization,
+mirroring the deployment process used for the `CrowdfundingCampaign` contract.
+- **Funding the Paymaster:** An important step where the deployed `GaslessPaymaster` contract is funded with ETH
+to cover transaction fees for users. The script sends a transaction
+from the deployer's wallet to the paymaster contract, ensuring it has sufficient balance to operate.
+
+Execute the deployment command corresponding to your package manager. The default command
+deploys to the configured network in your Hardhat setup. For local deployment, append
+`--network inMemoryNode` to deploy to the local in-memory node running.
+
+::code-group
+
+```bash [npm]
+npm run hardhat deploy-zksync --script deployGaslessPaymaster.ts
+# To deploy the contract on local in-memory node:
+# npm run hardhat deploy-zksync --script deployGaslessPaymaster.ts --network inMemoryNode
+```
+
+```bash [yarn]
+yarn hardhat deploy-zksync --script deployGaslessPaymaster.ts
+# To deploy the contract on local in-memory node:
+# yarn hardhat deploy-zksync --script deployGaslessPaymaster.ts --network inMemoryNode
+```
+
+```bash [pnpm]
+pnpm run hardhat deploy-zksync --script deployGaslessPaymaster.ts
+# To deploy the contract on local in-memory node:
+# pnpm run hardhat deploy-zksync --script deployGaslessPaymaster.ts --network inMemoryNode
+```
+
+```bash [bun]
+bun run hardhat deploy-zksync --script deployGaslessPaymaster.ts
+# To deploy the contract on local in-memory node:
+# bun run hardhat deploy-zksync --script deployGaslessPaymaster.ts --network inMemoryNode
+```
+
+::
+
+Upon successful deployment, you'll receive output detailing the deployment process,
+including the contract address, source, and encoded constructor arguments:
+
+```bash
+Starting deployment process of "GaslessPaymaster"...
+Estimated deployment cost: 0.0004922112 ETH
+
+"GaslessPaymaster" was successfully deployed:
+ - Contract address: 0x6f72f0d7bDba2E2a923beC09fBEE64cD134680F2
+ - Contract source: contracts/GaslessPaymaster.sol:GaslessPaymaster
+ - Encoded constructor arguments: 0x
+
+Requesting contract verification...
+Your verification ID is: 10634
+Contract successfully verified on zkSync block explorer!
+Paymaster ETH balance is now 5000000000000000
+```
+
+---
+
+## Interact with the `ApprovalPaymaster` contract
+
+This section will navigate you through the steps to interact with the `GaslessPaymaster` contract,
+using it to cover transaction fees for your operation.
+
+The interaction script is situated in the `/deploy/interact/` directory, named `interactWithPaymaster.ts`.
+
+Ensure the `CONTRACT_ADDRESS` and `PAYMASTER_ADDRESS` variables are set to your deployed contract and paymaster addresses, respectively.
+
+::drop-panel
+  ::panel{label="interactWithPaymaster.ts"}
+
+  ```typescript
+  import * as hre from "hardhat";
+  import { getWallet, getProvider } from "../utils";
+  import { ethers } from "ethers";
+  import { utils } from "zksync-ethers";
+
+  // Address of the contract to interact with
+  const CONTRACT_ADDRESS = "YOUR-CONTRACT-ADDRESS";
+  const PAYMASTER_ADDRESS = "YOUR-PAYMASTER-ADDRESS";
+  if (!CONTRACT_ADDRESS || !PAYMASTER_ADDRESS)
+      throw new Error("Contract and Paymaster addresses are required.");
+
+  export default async function() {
+    console.log(`Running script to interact with contract ${CONTRACT_ADDRESS} using paymaster ${PAYMASTER_ADDRESS}`);
+
+    // Load compiled contract info
+    const contractArtifact = await hre.artifacts.readArtifact(
+      "CrowdfundingCampaignV2"
+    );
+
+    // Initialize contract instance for interaction
+    const contract = new ethers.Contract(
+      CONTRACT_ADDRESS,
+      contractArtifact.abi,
+      getWallet()
+    );
+
+    const provider = getProvider();
+    let balanceBeforeTransaction = await provider.getBalance(getWallet().address);
+    console.log(`Wallet balance before contribution: ${ethers.formatEther(balanceBeforeTransaction)} ETH`);
+
+    const contributionAmount = ethers.parseEther("0.01");
+    // Get paymaster params
+    const paymasterParams = utils.getPaymasterParams(PAYMASTER_ADDRESS, {
+      type: "General",
+      innerInput: new Uint8Array(),
+    });
+
+    const gasLimit = await contract.contribute.estimateGas({
+      value: contributionAmount,
+      customData: {
+        gasPerPubdata: utils.DEFAULT_GAS_PER_PUBDATA_LIMIT,
+        paymasterParams: paymasterParams,
+      },
+    });
+
+    const transaction = await contract.contribute({
+      value: contributionAmount,
+      maxPriorityFeePerGas: 0n,
+      maxFeePerGas: await provider.getGasPrice(),
+      gasLimit,
+      // Pass the paymaster params as custom data
+      customData: {
+        gasPerPubdata: utils.DEFAULT_GAS_PER_PUBDATA_LIMIT,
+        paymasterParams,
+      },
+    });
+    console.log(`Transaction hash: ${transaction.hash}`);
+
+    await transaction.wait();
+
+    let balanceAfterTransaction = await provider.getBalance(getWallet().address);
+    // Check the wallet balance after the transaction
+    // We only pay the contribution amount, so the balance should be less than before
+    // Gas fees are covered by the paymaster
+    console.log(`Wallet balance after contribution: ${ethers.formatEther(balanceAfterTransaction)} ETH`);
+  }
+  ```
+
+  ::
+::
+
+**Key Components:**
+
+- **Paymaster Parameters:** Before executing transactions that involve the contract, the script prepares paymaster parameters using
+`getPaymasterParams`. This specifies the paymaster contract to be
+used and the type of paymaster flow, which in this case is `General`.
+
+- **Transaction with Paymaster:** Demonstrated by the `contribute` function call, the script shows how to include paymaster parameters
+in transactions. This allows the paymaster to cover transaction
+fees, providing a seamless experience for users.
+
+Execute the command corresponding to your package manager:
+
+::code-group
+
+```bash [npm]
+npm run hardhat deploy-zksync --script interact/interactWithPaymaster.ts
+```
+
+```bash [yarn]
+yarn hardhat deploy-zksync --script interact/interactWithPaymaster.ts
+```
+
+```bash [pnpm]
+pnpm run hardhat deploy-zksync --script interact/interactWithPaymaster.ts
+```
+
+```bash [bun]
+bun run hardhat deploy-zksync --script interact/interactWithPaymaster.ts
+```
+
+::
+
+Upon successful usage, you'll receive output detailing the transaction:
+
+```bash
+Running script to interact with contract 0x68E8533acE01019CB8D07Eca822369D5De71b74D using paymaster 0x6f72f0d7bDba2E2a923beC09fBEE64cD134680F2
+Wallet balance before contribution: 5.879909434005856127 ETH
+Transaction hash: 0x41c463abf7905552b69b25e7918374aab27f2d7e8cbebe212a0eb6ef8deb81e8
+Wallet balance after contribution: 5.869909434005856127 ETH
+```
+
+🎉 Great job! You've successfully interacted with the `CrowdfundingCampaignV2` using a paymaster to cover the transaction fees.
diff --git a/content/10.quick-start/_paymasters/_general_paymaster_flow.md b/content/10.quick-start/_paymasters/_general_paymaster_flow.md
new file mode 100644
index 00000000..2f72f00a
--- /dev/null
+++ b/content/10.quick-start/_paymasters/_general_paymaster_flow.md
@@ -0,0 +1,382 @@
+---
+title: General Paymaster
+description: Learn to deploy contract factories in the zkSync environment.
+---
+
+<!-- TODO: @dutterbutter determine best approach to leverate zksync cli for project
+bootstrapping for this guide series. -->
+Run the following command in your terminal to initialize the project.
+
+```sh
+git clone https://github.com/dutterbutter/zksync-quickstart-guide.git
+cd zksync-quickstart-guide
+git checkout db/contract-paymaster
+```
+
+Install the dependencies:
+
+::code-group
+
+```bash [npm]
+npm install
+```
+
+```bash [yarn]
+yarn install
+```
+
+```bash [pnpm]
+pnpm install
+```
+
+```bash [bun]
+bun install
+```
+
+::
+
+## Set up your wallet
+
+:display-partial{path = "/quick-start/_partials/_setup-wallet"}
+
+---
+
+## Understanding the `GeneralPaymaster` contract
+
+Let's start by reviewing the `GeneralPaymaster.sol` contract in the `contracts/` directory:
+
+::drop-panel
+  ::panel{label="GeneralPaymaster.sol"}
+    ```solidity
+    // SPDX-License-Identifier: MIT
+    pragma solidity ^0.8.0;
+
+    import {IPaymaster, ExecutionResult, PAYMASTER_VALIDATION_SUCCESS_MAGIC} from "@matterlabs/zksync-contracts/l2/system-contracts/interfaces/IPaymaster.sol";
+    import {IPaymasterFlow} from "@matterlabs/zksync-contracts/l2/system-contracts/interfaces/IPaymasterFlow.sol";
+    import {TransactionHelper, Transaction} from "@matterlabs/zksync-contracts/l2/system-contracts/libraries/TransactionHelper.sol";
+    import "@matterlabs/zksync-contracts/l2/system-contracts/Constants.sol";
+    import "@openzeppelin/contracts/access/Ownable.sol";
+
+    /// @notice This contract does not include any validations other than using the paymaster general flow.
+    contract GaslessPaymaster is IPaymaster, Ownable {
+        modifier onlyBootloader() {
+            require(
+                msg.sender == BOOTLOADER_FORMAL_ADDRESS,
+                "Only bootloader can call this method"
+            );
+            // Continue execution if called from the bootloader.
+            _;
+        }
+
+        function validateAndPayForPaymasterTransaction(
+            bytes32,
+            bytes32,
+            Transaction calldata _transaction
+        )
+            external
+            payable
+            onlyBootloader
+            returns (bytes4 magic, bytes memory context)
+        {
+            // By default we consider the transaction as accepted.
+            magic = PAYMASTER_VALIDATION_SUCCESS_MAGIC;
+            require(
+                _transaction.paymasterInput.length >= 4,
+                "The standard paymaster input must be at least 4 bytes long"
+            );
+
+            bytes4 paymasterInputSelector = bytes4(
+                _transaction.paymasterInput[0:4]
+            );
+            if (paymasterInputSelector == IPaymasterFlow.general.selector) {
+                // Note, that while the minimal amount of ETH needed is tx.gasPrice * tx.gasLimit,
+                // neither paymaster nor account are allowed to access this context variable.
+                uint256 requiredETH = _transaction.gasLimit *
+                    _transaction.maxFeePerGas;
+
+                // The bootloader never returns any data, so it can safely be ignored here.
+                (bool success, ) = payable(BOOTLOADER_FORMAL_ADDRESS).call{
+                    value: requiredETH
+                }("");
+                require(
+                    success,
+                    "Failed to transfer tx fee to the Bootloader. Paymaster balance might not be enough."
+                );
+            } else {
+                revert("Unsupported paymaster flow in paymasterParams.");
+            }
+        }
+
+        function postTransaction(
+            bytes calldata _context,
+            Transaction calldata _transaction,
+            bytes32,
+            bytes32,
+            ExecutionResult _txResult,
+            uint256 _maxRefundedGas
+        ) external payable override onlyBootloader {
+            // Refunds are not supported yet.
+        }
+
+        function withdraw(address payable _to) external onlyOwner {
+            // send paymaster funds to the owner
+            uint256 balance = address(this).balance;
+            (bool success, ) = _to.call{value: balance}("");
+            require(success, "Failed to withdraw funds from paymaster.");
+        }
+
+        receive() external payable {}
+    }
+    ```
+  ::
+::
+
+**Key components:**
+
+- The `GaslessPaymaster` contract ensures that transaction fees are handled automatically without user intervention.
+- **`validateAndPayForPaymasterTransaction` Method:** This mandatory method assesses whether the paymaster agrees to cover the
+transaction fees. If affirmative, it transfers the necessary funds
+(calculated as tx.gasprice * tx.gasLimit) to the operator. It returns a context for the `postTransaction` method.
+- **`postTransaction`** Method: An optional method invoked
+post-transaction execution, provided the transaction doesn't fail
+due to out-of-gas errors. It receives several parameters, including the transaction's context and result, aiding in finalizing paymaster duties.
+- **`onlyBootloader`** Modifier: Ensures that certain methods are
+exclusively callable by the system's bootloader, adding an extra layer of security and control.
+
+---
+
+## Compile and deploy the `GeneralPaymaster` contract
+
+:display-partial{path = "/_partials/_compile-solidity-contracts"}
+
+Upon successful compilation, you'll receive output detailing the
+`zksolc` and `solc` versions used during compiling and the number
+of Solidity files compiled.
+
+```bash
+Compiling contracts for zkSync Era with zksolc v1.4.0 and solc v0.8.17
+Compiling 4 Solidity file
+Successfully compiled 4 Solidity file
+```
+
+The compiled artifacts will be located in the `/artifacts-zk` folder.
+
+The script to deploy the `GaslessPaymaster` is located at `/deploy/deploy.ts`.
+
+```typescript
+import { deployContract, getWallet, getProvider } from "./utils";
+import { ethers } from "ethers";
+
+// An example of a basic deploy script
+// It will deploy a CrowdfundingCampaign contract to selected network
+// `parseEther` converts ether to wei, and `.toString()` ensures serialization compatibility.
+export default async function() {
+  const contractArtifactName = "GaslessPaymaster";
+  const constructorArguments = [];
+  const contract = await deployContract(
+    contractArtifactName,
+    constructorArguments
+  );
+  const wallet = getWallet();
+  const provider = getProvider();
+
+  // Supplying paymaster with ETH
+  await (
+    await wallet.sendTransaction({
+      to: contract.target,
+      value: ethers.parseEther("0.005"),
+    })
+  ).wait();
+
+  let paymasterBalance = await provider.getBalance(contract.target.toString());
+  console.log(`Paymaster ETH balance is now ${paymasterBalance.toString()}`);
+}
+```
+
+**Key Components:**
+
+- **`deployContract` Method:** Utilized for deploying the `GaslessPaymaster` contract. This method takes the name of the
+contract and any constructor arguments needed for initialization,
+mirroring the deployment process used for the `CrowdfundingCampaign` contract.
+- **Funding the Paymaster:** An important step where the deployed `GaslessPaymaster` contract is funded with ETH
+to cover transaction fees for users. The script sends a transaction
+from the deployer's wallet to the paymaster contract, ensuring it has sufficient balance to operate.
+
+Execute the deployment command corresponding to your package manager. The default command
+deploys to the configured network in your Hardhat setup. For local deployment, append
+`--network inMemoryNode` to deploy to the local in-memory node running.
+
+::code-group
+
+```bash [npm]
+npm run hardhat deploy-zksync --script deployGaslessPaymaster.ts
+# To deploy the contract on local in-memory node:
+# npm run hardhat deploy-zksync --script deployGaslessPaymaster.ts --network inMemoryNode
+```
+
+```bash [yarn]
+yarn hardhat deploy-zksync --script deployGaslessPaymaster.ts
+# To deploy the contract on local in-memory node:
+# yarn hardhat deploy-zksync --script deployGaslessPaymaster.ts --network inMemoryNode
+```
+
+```bash [pnpm]
+pnpm run hardhat deploy-zksync --script deployGaslessPaymaster.ts
+# To deploy the contract on local in-memory node:
+# pnpm run hardhat deploy-zksync --script deployGaslessPaymaster.ts --network inMemoryNode
+```
+
+```bash [bun]
+bun run hardhat deploy-zksync --script deployGaslessPaymaster.ts
+# To deploy the contract on local in-memory node:
+# bun run hardhat deploy-zksync --script deployGaslessPaymaster.ts --network inMemoryNode
+```
+
+::
+
+Upon successful deployment, you'll receive output detailing the deployment process,
+including the contract address, source, and encoded constructor arguments:
+
+```bash
+Starting deployment process of "GaslessPaymaster"...
+Estimated deployment cost: 0.0004922112 ETH
+
+"GaslessPaymaster" was successfully deployed:
+ - Contract address: 0x6f72f0d7bDba2E2a923beC09fBEE64cD134680F2
+ - Contract source: contracts/GaslessPaymaster.sol:GaslessPaymaster
+ - Encoded constructor arguments: 0x
+
+Requesting contract verification...
+Your verification ID is: 10634
+Contract successfully verified on zkSync block explorer!
+Paymaster ETH balance is now 5000000000000000
+```
+
+---
+
+## Interact with the GeneralPaymaster contract
+
+This section will navigate you through the steps to interact with the `GeneralPaymaster` contract,
+using it to cover transaction fees for your operation.
+
+The interaction script is situated in the `/deploy/interact/` directory, named `interactWithPaymaster.ts`.
+
+Ensure the `CONTRACT_ADDRESS` and `PAYMASTER_ADDRESS` variables are set to your deployed contract and paymaster addresses, respectively.
+
+::drop-panel
+  ::panel{label="interactWithPaymaster.ts"}
+
+  ```typescript
+  import * as hre from "hardhat";
+  import { getWallet, getProvider } from "../utils";
+  import { ethers } from "ethers";
+  import { utils } from "zksync-ethers";
+
+  // Address of the contract to interact with
+  const CONTRACT_ADDRESS = "YOUR-CONTRACT-ADDRESS";
+  const PAYMASTER_ADDRESS = "YOUR-PAYMASTER-ADDRESS";
+  if (!CONTRACT_ADDRESS || !PAYMASTER_ADDRESS)
+      throw new Error("Contract and Paymaster addresses are required.");
+
+  export default async function() {
+    console.log(`Running script to interact with contract ${CONTRACT_ADDRESS} using paymaster ${PAYMASTER_ADDRESS}`);
+
+    // Load compiled contract info
+    const contractArtifact = await hre.artifacts.readArtifact(
+      "CrowdfundingCampaignV2"
+    );
+
+    // Initialize contract instance for interaction
+    const contract = new ethers.Contract(
+      CONTRACT_ADDRESS,
+      contractArtifact.abi,
+      getWallet()
+    );
+
+    const provider = getProvider();
+    let balanceBeforeTransaction = await provider.getBalance(getWallet().address);
+    console.log(`Wallet balance before contribution: ${ethers.formatEther(balanceBeforeTransaction)} ETH`);
+
+    const contributionAmount = ethers.parseEther("0.01");
+    // Get paymaster params
+    const paymasterParams = utils.getPaymasterParams(PAYMASTER_ADDRESS, {
+      type: "General",
+      innerInput: new Uint8Array(),
+    });
+
+    const gasLimit = await contract.contribute.estimateGas({
+      value: contributionAmount,
+      customData: {
+        gasPerPubdata: utils.DEFAULT_GAS_PER_PUBDATA_LIMIT,
+        paymasterParams: paymasterParams,
+      },
+    });
+
+    const transaction = await contract.contribute({
+      value: contributionAmount,
+      maxPriorityFeePerGas: 0n,
+      maxFeePerGas: await provider.getGasPrice(),
+      gasLimit,
+      // Pass the paymaster params as custom data
+      customData: {
+        gasPerPubdata: utils.DEFAULT_GAS_PER_PUBDATA_LIMIT,
+        paymasterParams,
+      },
+    });
+    console.log(`Transaction hash: ${transaction.hash}`);
+
+    await transaction.wait();
+
+    let balanceAfterTransaction = await provider.getBalance(getWallet().address);
+    // Check the wallet balance after the transaction
+    // We only pay the contribution amount, so the balance should be less than before
+    // Gas fees are covered by the paymaster
+    console.log(`Wallet balance after contribution: ${ethers.formatEther(balanceAfterTransaction)} ETH`);
+  }
+  ```
+
+  ::
+::
+
+**Key Components:**
+
+- **Paymaster Parameters:** Before executing transactions that involve the contract, the script prepares paymaster parameters using
+`getPaymasterParams`. This specifies the paymaster contract to be
+used and the type of paymaster flow, which in this case is `General`.
+
+- **Transaction with Paymaster:** Demonstrated by the `contribute` function call, the script shows how to include paymaster parameters
+in transactions. This allows the paymaster to cover transaction
+fees, providing a seamless experience for users.
+
+Execute the command corresponding to your package manager:
+
+::code-group
+
+```bash [npm]
+npm run hardhat deploy-zksync --script interact/interactWithPaymaster.ts
+```
+
+```bash [yarn]
+yarn hardhat deploy-zksync --script interact/interactWithPaymaster.ts
+```
+
+```bash [pnpm]
+pnpm run hardhat deploy-zksync --script interact/interactWithPaymaster.ts
+```
+
+```bash [bun]
+bun run hardhat deploy-zksync --script interact/interactWithPaymaster.ts
+```
+
+::
+
+Upon successful usage, you'll receive output detailing the transaction:
+
+```bash
+Running script to interact with contract 0x68E8533acE01019CB8D07Eca822369D5De71b74D using paymaster 0x6f72f0d7bDba2E2a923beC09fBEE64cD134680F2
+Wallet balance before contribution: 5.879909434005856127 ETH
+Transaction hash: 0x41c463abf7905552b69b25e7918374aab27f2d7e8cbebe212a0eb6ef8deb81e8
+Wallet balance after contribution: 5.869909434005856127 ETH
+```
+
+🎉 Great job! You've successfully interacted with the `CrowdfundingCampaignV2` using a paymaster to cover the transaction fees.
diff --git a/content/10.quick-start/_testing/_foundry_contract_testing.md b/content/10.quick-start/_testing/_foundry_contract_testing.md
new file mode 100644
index 00000000..dcf115e5
--- /dev/null
+++ b/content/10.quick-start/_testing/_foundry_contract_testing.md
@@ -0,0 +1,209 @@
+---
+title: Hardhat | Contract Testing
+---
+
+<!-- TODO: @dutterbutter update to simplify the project init step -->
+Run the following command in your terminal to initialize the Foundry project.
+
+```sh
+git clone https://github.com/dutterbutter/zksync-foundry-quickstart-guide
+cd zksync-foundry-quickstart-guide
+git checkout db/contract-testing
+```
+
+---
+
+## Test the `CrowdfundingCampaign` contract
+
+Now that our setup is complete, it's time to focus on the core of this
+guide - testing our `CrowdfundingCampaign.sol` contract. Here's a quick
+refresher on its structure:
+
+::drop-panel
+  ::panel{label="CrowdfundingCampaign.sol"}
+    ```solidity
+    // SPDX-License-Identifier: MIT
+    pragma solidity ^0.8.0;
+
+    contract CrowdfundingCampaign {
+        address public owner;
+        uint256 public fundingGoal;
+        uint256 public totalFundsRaised;
+        mapping(address => uint256) public contributions;
+
+        event ContributionReceived(address contributor, uint256 amount);
+        event GoalReached(uint256 totalFundsRaised);
+
+        constructor(uint256 _fundingGoal) {
+            owner = msg.sender;
+            fundingGoal = _fundingGoal;
+        }
+
+        function contribute() public payable {
+            require(msg.value > 0, "Contribution must be greater than 0");
+            contributions[msg.sender] += msg.value;
+            totalFundsRaised += msg.value;
+
+            emit ContributionReceived(msg.sender, msg.value);
+
+            if (totalFundsRaised >= fundingGoal) {
+                emit GoalReached(totalFundsRaised);
+            }
+        }
+
+        function withdrawFunds() public {
+            require(msg.sender == owner, "Only the owner can withdraw funds");
+            require(totalFundsRaised >= fundingGoal, "Funding goal not reached");
+
+            uint256 amount = address(this).balance;
+            totalFundsRaised = 0;
+
+            (bool success, ) = payable(owner).call{value: amount}("");
+            require(success, "Transfer failed.");
+        }
+
+        function getTotalFundsRaised() public view returns (uint256) {
+            return totalFundsRaised;
+        }
+
+        function getFundingGoal() public view returns (uint256) {
+            return fundingGoal;
+        }
+    }
+    ```
+  ::
+::
+
+Thorough testing involves scrutinizing every function and aspect of our contract,
+including potential failure scenarios. In this guide, we'll focus in on the `contribute`
+method to ensure it's tested.
+
+As a challenge to hone your testing skills further,
+consider devising additional tests for the `withdrawFunds`, `getTotalFundsRaised`,
+and `getFundingGoal` methods, expanding your test coverage and reinforcing the
+reliability of the contract.
+
+### Compile contract
+
+Smart contracts deployed to zkSync must be compiled using our custom compiler.
+For this particular guide we are making use of `zksolc`.
+
+To compile the contracts in the project, run the following command:
+
+```bash
+forge build --zksync
+```
+
+Upon successful compilation, you'll receive output detailing the
+`zksolc` and `solc` versions used during compiling and the number
+of Solidity files compiled.
+
+```bash
+[⠒] Compiling...
+[⠃] Compiling 22 files with 0.8.20
+[⠊] Solc 0.8.20 finished in 736.48ms
+Compiler run successful!
+Compiling contracts for zkSync Era with zksolc v1.4.0
+```
+
+The compiled zkEVM artifacts will be located in the `/zkout` folder, and the solc artifacts will be
+located in the `/out` folder.
+
+### Run the test command
+
+This section describes the testing `CrowdfundingCampaign.sol` contract. Let's
+start by reviewing the tests for `CrowdfundingCampaign.sol` contract provided
+during the initialization step in the `/test` directory, specifically the
+[`CrowdfundingCampaign.t.sol` file](https://github.com/dutterbutter/zksync-foundry-quickstart-guide/blob/db/contract-testing/test/CrowdfundingCampaign.t.sol).
+
+```solidity
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.0;
+
+import "forge-std/Test.sol";
+import "forge-std/console.sol";
+import "../src/CrowdfundingCampaign.sol";
+
+contract CrowdfundingCampaignTest is Test {
+    CrowdfundingCampaign campaign;
+    event GoalReached(uint256 totalFundsRaised);
+    address owner;
+    address addr1;
+    address addr2;
+
+    function setUp() public {
+        owner = address(this);
+
+        addr1 = vm.addr(1);
+        addr2 = vm.addr(2);
+
+        campaign = new CrowdfundingCampaign(1 ether);
+        console.log("CrowdfundingCampaign deployed at: %s", address(campaign));
+    }
+
+    function test_RejectZeroContributions() public {
+        vm.expectRevert("Contribution must be greater than 0");
+        campaign.contribute{value: 0}();
+    }
+
+    function test_AggregateContributions() public {
+        uint256 initialTotal = campaign.getTotalFundsRaised();
+
+        vm.prank(addr1);
+        vm.deal(addr1, 2 ether);
+        campaign.contribute{value: 0.5 ether}();
+
+        vm.prank(addr2);
+        vm.deal(addr2, 2 ether);
+        campaign.contribute{value: 0.3 ether}();
+
+        assertEq(campaign.getTotalFundsRaised(), initialTotal + 0.8 ether);
+    }
+
+    function test_EmitGoalReachedWhenFundingGoalMet() public {
+        vm.prank(addr1);
+        vm.deal(addr1, 2 ether);
+        vm.expectEmit(true, true, false, true);
+        emit GoalReached(1 ether);
+        campaign.contribute{value: 1 ether}();
+    }
+}
+```
+
+- **Environment Setup**: Leverages Foundry's `Test` contract and setup functions
+to prepare the test environment, ensuring a fresh state for each test case.
+- **Deployment and Address Simulation**: Deploys the `CrowdfundingCampaign` contract
+within the test setup and simulates addresses using Foundry's `vm.addr()` function for
+various test actors.
+
+**`contribute` Method Tests:**
+
+- **Zero Contribution Validation**: Asserts that the contract rejects contribution
+attempts with zero value, testing the contract's input validation logic.
+- **Contribution Aggregation**: Confirms the contract's ability to correctly tally
+contributions from various addresses, ensuring accurate tracking of the total funds raised.
+- **Event Emission Upon Goal Achievement**: Utilizes Foundry's `vm.expectEmit` to
+anticipate the `GoalReached` event when the funding goal is met, validating the
+contract's event logic and state transitions.
+
+Execute the test command:
+
+```bash
+forge test --zksync
+```
+
+Upon completion, the test suite will provide a summary of all executed tests,
+indicating their success or failure:
+
+```bash
+Ran 3 tests for test/CrowdfundingCampaign.t.sol:CrowdfundingCampaignTest
+[PASS] test_AggregateContributions() (gas: 29204)
+[PASS] test_EmitGoalReachedWhenFundingGoalMet() (gas: 18862)
+[PASS] test_RejectZeroContributions() (gas: 8148)
+Suite result: ok. 3 passed; 0 failed; 0 skipped; finished in 44.03ms (43.94ms CPU time)
+
+Ran 1 test suite in 48.11ms (44.03ms CPU time): 3 tests passed, 0 failed, 0 skipped (3 total tests)
+```
+
+🎉 Congratulations! The `contribute` method of the `CrowdfundingCampaign` contract
+has been thoroughly tested and is ready for action.
diff --git a/content/10.quick-start/_testing/_hardhat_contract_testing.md b/content/10.quick-start/_testing/_hardhat_contract_testing.md
new file mode 100644
index 00000000..12a42141
--- /dev/null
+++ b/content/10.quick-start/_testing/_hardhat_contract_testing.md
@@ -0,0 +1,261 @@
+---
+title: Hardhat | Contract Testing
+---
+<!-- TODO: @dutterbutter determine best approach to leverate zksync cli for project
+bootstrapping for this guide series. -->
+Run the following command in your terminal to initialize the project.
+
+  ```sh
+  git clone https://github.com/dutterbutter/zksync-quickstart-guide.git
+  cd zksync-quickstart-guide
+  git checkout db/contract-testing
+  ```
+
+  Install the dependencies:
+
+  ::code-group
+
+  ```bash [npm]
+  npm install
+  ```
+
+  ```bash [yarn]
+  yarn install
+  ```
+
+  ```bash [pnpm]
+  pnpm install
+  ```
+
+  ```bash [bun]
+  bun install
+  ```
+
+  ::
+
+---
+
+## Local Era Node
+
+While setting up a local development environment was previously optional, testing contracts requires
+a more structured setup. We'll use `hardhat-zksync` to run tests against an In-memory node,
+which operates seamlessly within a separate process for an optimized testing workflow.
+
+If you have not set up your local era node yet, follow the instructions in the [Getting Started](/quick-start#setup-era-local-node-optional) section.
+
+Within the `hardhat.config.ts`, you'll observe the `zksync` flag set to `true` under the
+`hardhat` network, indicating the integration with zkSync's testing environment.
+
+```ts
+hardhat: {
+  zksync: true,
+},
+```
+
+To use the In-memory node for testing, ensure the `hardhat` network is selected with
+the `zksync` flag enabled. This setup initiates the node alongside your tests and ensures
+it terminates once testing is complete. The node's port allocation starts at the default
+`8011`, facilitating smooth and isolated test execution.
+
+Secondly within the `hardhat.config.ts`, you'll observe the importing of
+`@nomicfoundation/hardhat-chai-matchers`. This plugin provides Hardhat with an extended
+suite of assertion methods tailored for contract testing, significantly improving the testing
+toolkit available for your project.
+
+```typescript
+import "@nomicfoundation/hardhat-chai-matchers";
+```
+
+### Test Wallet Configuration
+
+For testing purposes, we use pre-configured, well-funded wallets. During this testing guide, we will use the following pre-configured wallet,
+which eliminates the need for manual funding or setup:
+
+- **Account Address:** `0x36615Cf349d7F6344891B1e7CA7C72883F5dc049`
+- **Private Key:** `0x7726827caac94a7f9e1b160f7ea819f172f7b6f9d2a97f992c38edeab82d4110`
+
+This streamlined approach allows us to focus on writing and running effective tests.
+
+---
+
+## Compile the `CrowdfundingCampaign` contract
+
+Now that our setup is complete, it's time to focus on the core of this
+guide - testing our `CrowdfundingCampaign.sol` contract. Here's a quick
+refresher on its structure:
+
+::drop-panel
+  ::panel{label="CrowdfundingCampaign.sol"}
+    ```solidity
+    // SPDX-License-Identifier: MIT
+    pragma solidity ^0.8.0;
+
+    contract CrowdfundingCampaign {
+        address public owner;
+        uint256 public fundingGoal;
+        uint256 public totalFundsRaised;
+        mapping(address => uint256) public contributions;
+
+        event ContributionReceived(address contributor, uint256 amount);
+        event GoalReached(uint256 totalFundsRaised);
+
+        constructor(uint256 _fundingGoal) {
+            owner = msg.sender;
+            fundingGoal = _fundingGoal;
+        }
+
+        function contribute() public payable {
+            require(msg.value > 0, "Contribution must be greater than 0");
+            contributions[msg.sender] += msg.value;
+            totalFundsRaised += msg.value;
+
+            emit ContributionReceived(msg.sender, msg.value);
+
+            if (totalFundsRaised >= fundingGoal) {
+                emit GoalReached(totalFundsRaised);
+            }
+        }
+
+        function withdrawFunds() public {
+            require(msg.sender == owner, "Only the owner can withdraw funds");
+            require(totalFundsRaised >= fundingGoal, "Funding goal not reached");
+
+            uint256 amount = address(this).balance;
+            totalFundsRaised = 0;
+
+            (bool success, ) = payable(owner).call{value: amount}("");
+            require(success, "Transfer failed.");
+        }
+
+        function getTotalFundsRaised() public view returns (uint256) {
+            return totalFundsRaised;
+        }
+
+        function getFundingGoal() public view returns (uint256) {
+            return fundingGoal;
+        }
+    }
+    ```
+  ::
+::
+
+Thorough testing involves scrutinizing every function and aspect of our contract,
+including potential failure scenarios. In this guide, we'll focus in on the `contribute`
+method to ensure it's tested.
+
+As a challenge to hone your testing skills further,
+consider writing additional tests for the `withdrawFunds`, `getTotalFundsRaised`,
+and `getFundingGoal` methods, expanding your test coverage and reinforcing the
+reliability of the contract.
+
+:display-partial{path = "/_partials/_compile-solidity-contracts"}
+
+Upon successful compilation, you'll receive output detailing the
+`zksolc` and `solc` versions used during compiling and the number
+of Solidity files compiled.
+
+```bash
+Compiling contracts for zkSync Era with zksolc v1.4.0 and solc v0.8.17
+Compiling 2 Solidity file
+Successfully compiled 2 Solidity file
+```
+
+The compiled artifacts will be located in the `/artifacts-zk` folder.
+
+---
+
+## Test `CrowdfundingCampaign`
+
+This section describes testing the `CrowdfundingCampaign.sol` contract. Let's
+start by reviewing the tests for `CrowdfundingCampaign.sol` contract provided
+during the initialization step in the `/tests` directory, specifically the
+[`crowdFunding.test.ts` file](https://github.com/dutterbutter/zksync-quickstart-guide/blob/db/contract-testing/test/crowdFunding.test.ts).
+
+```typescript
+import { expect } from "chai";
+import { ethers } from "hardhat";
+import { getWallet, LOCAL_RICH_WALLETS, deployContract } from "../deploy/utils";
+
+describe("CrowdfundingCampaign", function () {
+  let campaign;
+  let owner, addr1, addr2;
+
+  beforeEach(async function () {
+    owner = getWallet(LOCAL_RICH_WALLETS[0].privateKey);
+    addr1 = getWallet(LOCAL_RICH_WALLETS[1].privateKey);
+    addr2 = getWallet(LOCAL_RICH_WALLETS[2].privateKey);
+    const fundingGoalInWei = ethers.parseEther('1').toString();
+    campaign = await deployContract("CrowdfundingCampaign", [fundingGoalInWei], { wallet: owner, silent: true });
+  });
+
+  describe("Contribute", function () {
+    it("should reject contributions of 0", async function () {
+      await expect(campaign.connect(addr1).contribute({ value: ethers.parseEther("0") })).to.be.revertedWith("Contribution must be greater than 0");
+    });
+
+    it("should aggregate contributions in totalFundsRaised", async function () {
+      await campaign.connect(addr1).contribute({ value: ethers.parseEther("0.5") });
+      await campaign.connect(addr2).contribute({ value: ethers.parseEther("0.3") });
+      expect(await campaign.getTotalFundsRaised()).to.equal(ethers.parseEther("0.8"));
+    });
+
+    it("should emit GoalReached event when funding goal is met", async function () {
+      await expect(campaign.connect(addr1).contribute({ value: ethers.parseEther("1") }))
+        .to.emit(campaign, "GoalReached")
+        .withArgs(ethers.parseEther("1"));
+    });
+  });
+});
+```
+
+- **Initialization**: Each test case initializes with fresh contract instances and predefined
+rich wallet accounts to simulate various contributors and the contract owner.
+- **Deployment**: The `CrowdfundingCampaign` contract is deployed using the `deployContract`
+utility, setting a specific funding goal for each test scenario.
+
+**`contribute` Method Tests:**
+
+- **Zero Contributions**: Verifies that the contract correctly rejects contribution attempts with
+zero value, ensuring the integrity of the contribution process.
+- **Funds Aggregation**: Tests the contract's ability to accurately aggregate contributions from
+multiple addresses and update the `totalFundsRaised` accordingly.
+- **Goal Achievement**: Checks for the `GoalReached` event emission upon meeting the funding goal,
+confirming the contract's responsiveness to achieving its set target.
+
+Execute the test command corresponding to your package manager:
+
+::code-group
+
+```bash [npm]
+npm run hardhat test --network hardhat
+```
+
+```bash [yarn]
+yarn hardhat test --network hardhat
+```
+
+```bash [pnpm]
+pnpm run hardhat test --network hardhat
+```
+
+```bash [bun]
+bun run hardhat test --network hardhat
+```
+
+::
+
+Upon completion, the test suite will provide a summary of all executed tests,
+indicating their success or failure:
+
+```bash
+  CrowdfundingCampaign
+    Contribute
+      ✔ should reject contributions of 0 (45ms)
+      ✔ should aggregate contributions in totalFundsRaised (213ms)
+      ✔ should emit GoalReached event when funding goal is met (113ms)
+
+  3 passing (1s)
+```
+
+🎉 Congratulations! The `contribute` method of the `CrowdfundingCampaign` contract
+has been thoroughly tested and is ready for action.
diff --git a/content/10.quick-start/_upgrading/_beacon/_foundry_beacon_contract_upgradability.md b/content/10.quick-start/_upgrading/_beacon/_foundry_beacon_contract_upgradability.md
new file mode 100644
index 00000000..6876ce71
--- /dev/null
+++ b/content/10.quick-start/_upgrading/_beacon/_foundry_beacon_contract_upgradability.md
@@ -0,0 +1,5 @@
+---
+title: Foundry | Contract Upgrade
+---
+
+Coming soon!
diff --git a/content/10.quick-start/_upgrading/_beacon/_hardhat_beacon_contract_upgradability.md b/content/10.quick-start/_upgrading/_beacon/_hardhat_beacon_contract_upgradability.md
new file mode 100644
index 00000000..2c47f564
--- /dev/null
+++ b/content/10.quick-start/_upgrading/_beacon/_hardhat_beacon_contract_upgradability.md
@@ -0,0 +1,444 @@
+---
+title: Hardhat | Contract Upgrading
+---
+
+<!-- TODO: @dutterbutter determine best approach to leverate zksync cli for project
+bootstrapping for this guide series. -->
+Run the following command in your terminal to initialize the project.
+
+```sh
+git clone https://github.com/dutterbutter/zksync-quickstart-guide.git
+cd zksync-quickstart-guide
+git checkout db/contract-upgrade
+```
+
+Install the dependencies:
+
+::code-group
+
+```bash [npm]
+npm install
+```
+
+```bash [yarn]
+yarn install
+```
+
+```bash [pnpm]
+pnpm install
+```
+
+```bash [bun]
+bun install
+```
+
+::
+
+## Set up your wallet
+
+:display-partial{path = "/quick-start/_partials/_setup-wallet"}
+
+---
+
+## Adapt `CrowdfundingCampaign.sol` contract for upgradability
+
+To adapt our `CrowdfundingCampaign.sol` contract for upgradability, we are
+transitioning to a proxy pattern. This approach separates the
+contract's logic (which can be upgraded) from its persistent state
+(stored in the proxy).
+
+In the `contracts/` directory you'll observe the refactored the [`CrowdfundingCampaign` contract](https://github.com/dutterbutter/zksync-quickstart-guide/blob/db/contract-upgrade/contracts/CrowdfundingCampaign.sol)
+which initializes state variables through an
+`initialize` function instead of the constructor, in line with the proxy pattern.
+
+**Updated Contract Structure:**
+
+```solidity
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.0;
+
+import "@openzeppelin/contracts/proxy/utils/Initializable.sol";
+
+contract CrowdfundingCampaign is Initializable {
+    address public owner;
+    uint256 public fundingGoal;
+    mapping(address => uint256) public contributions;
+
+    event ContributionReceived(address contributor, uint256 amount);
+    event GoalReached(uint256 totalFundsRaised);
+
+    // Remove constructor in favour of initialize method
+    function initialize(uint256 _fundingGoal) public initializer {
+        owner = msg.sender;
+        fundingGoal = _fundingGoal;
+    }
+
+    function contribute() public payable {
+        // contribution logic remains the same
+    }
+
+    function withdrawFunds() public {
+        // withdrawFunds logic remains the same
+    }
+
+    function getTotalFundsRaised() public view returns (uint256) {
+        // getTotalFundsRaised remains the same
+    }
+
+    function getFundingGoal() public view returns (uint256) {
+        // getFundingGoal remains the same
+    }
+}
+```
+
+**Key Modifications:**
+
+- **Initializable**: Inherits from OpenZeppelin's `Initializable` to ensure the `initialize` function
+can only be called once, similar to a constructor.
+- **Initialize Function**: Replaces the constructor for setting initial state, facilitating upgrades
+through new logic contracts.
+- **Proxy Pattern**: Utilizes a proxy contract to delegate calls to this logic contract,
+allowing for future upgrades without losing the contract's state.
+
+This restructuring prepares the `CrowdfundingCampaign` contract for upgradeability.
+
+---
+
+## Compile the updated `CrowdfundingCampaign` contract
+
+Now that the `CrowdfundingCampaign` contract is adapted for contract upgradability, let's proceed to deploy
+the contract so we may upgrade it in later steps. Since we've made changes to our contract we will
+need to re-compile.
+
+To compile the contracts in the project, run the following command:
+
+::code-group
+
+```bash [npm]
+npm run compile
+```
+
+```bash [yarn]
+yarn compile
+```
+
+```bash [pnpm]
+pnpm run compile
+```
+
+```bash [bun]
+bun run compile
+```
+
+::
+
+Upon successful compilation, you'll receive output detailing the
+`zksolc` and `solc` versions used during compiling and the number
+of Solidity files compiled.
+
+```bash
+Compiling contracts for zkSync Era with zksolc v1.4.0 and solc v0.8.17
+Compiling 3 Solidity file
+Successfully compiled 3 Solidity file
+```
+
+The compiled artifacts will be located in the `/artifacts-zk` folder.
+
+## Deploy the beacon and contract
+
+You'll find the necessary deployment script at [`/deploy/deployBeaconProxy.ts`](https://github.com/dutterbutter/zksync-quickstart-guide/blob/db/contract-upgrade/deploy/deployBeaconProxy.ts).
+
+```typescript
+import { getWallet } from "./utils";
+import { Deployer } from '@matterlabs/hardhat-zksync';
+import { ethers } from "ethers";
+import { HardhatRuntimeEnvironment } from "hardhat/types";
+
+export default async function (hre: HardhatRuntimeEnvironment) {
+    const wallet = getWallet();
+    const deployer = new Deployer(hre, wallet);
+
+    const contractArtifact = await deployer.loadArtifact("CrowdfundingCampaign");
+    const fundingGoalInWei = ethers.parseEther('0.1').toString();
+
+    const beacon = await hre.zkUpgrades.deployBeacon(
+        getWallet(),
+        contractArtifact
+    );
+    await beacon.waitForDeployment();
+
+    const crowdfunding = await hre.zkUpgrades.deployBeaconProxy(deployer.zkWallet,
+        await beacon.getAddress(), contractArtifact, [fundingGoalInWei]);
+
+    await crowdfunding.waitForDeployment();
+}
+```
+
+**Key Components:**
+
+- **`deployBeacon` Method:** Initiates the deployment of a beacon contract,
+which acts as a central point for managing future upgrades of the `CrowdfundingCampaign`
+contract. The beacon's address is a critical component as it links the deployed proxy
+to the actual contract logic.
+
+- **`deployBeaconProxy` Method:** This step involves deploying the beacon proxy,
+which serves as the user-facing contract instance. It references the beacon for its logic,
+allowing for seamless upgrades without altering the proxy's address.
+The `fundingGoalInWei parameter`, converted from ether to wei, is passed during
+this step to initialize the contract with a funding goal.
+
+Execute the deployment command corresponding to your package manager. The default command
+deploys to the configured network in your Hardhat setup. For local deployment, append
+`--network inMemoryNode` to deploy to the local in-memory node running.
+
+::code-group
+
+```bash [npm]
+npm run hardhat deploy-zksync --script deployBeaconProxy.ts
+# To deploy the contract on local in-memory node:
+# npm run hardhat deploy-zksync --script deployBeaconProxy.ts --network inMemoryNode
+```
+
+```bash [yarn]
+yarn hardhat deploy-zksync --script deployBeaconProxy.ts
+# To deploy the contract on local in-memory node:
+# yarn hardhat deploy-zksync --script deployBeaconProxy.ts --network inMemoryNode
+```
+
+```bash [pnpm]
+pnpm run hardhat deploy-zksync --script deployBeaconProxy.ts
+# To deploy the contract on local in-memory node:
+# pnpm run hardhat deploy-zksync --script deployBeaconProxy.ts --network inMemoryNode
+```
+
+```bash [bun]
+bun run hardhat deploy-zksync --script deployBeaconProxy.ts
+# To deploy the contract on local in-memory node:
+# bun run hardhat deploy-zksync --script deployBeaconProxy.ts --network inMemoryNode
+```
+
+::
+
+Upon successful deployment, you'll receive output detailing the deployment process,
+including the contract addresses of the implementation
+contract, the admin contract, and the beacon
+proxy contract.
+
+```bash
+Beacon impl deployed at 0xE3F814fa915A75bA47230537726C99f6517Da58e
+Beacon deployed at:  0x26410Bebf5Df7398DCBC5f00e9EBBa0Ddf471C72
+Beacon proxy deployed at:  0xD58FA9Fb362Abf69cFc68A3545fD227165DAc167
+```
+
+---
+
+## Compile the `CrowdfundingCampaignV2` Contract
+
+With our initial setup deployed, we're ready to upgrade our `CrowdfundingCampaign.sol`
+contract by incorporating a deadline for contributions. This addition not only brings
+a new layer of functionality but also introduces the concept of time-based conditions
+through a `modifier`.
+<!-- TODO: explain what a modifier is.
+I still don't know what it means from the following section. -->
+
+**Current Contract Overview:**
+
+The existing version of our contract allows for open-ended contributions towards a
+funding goal, without any time constraints.
+
+**Proposed Upgrade:**
+
+We're introducing a `deadline` variable, initialized at contract deployment, to establish a
+clear timeframe for accepting contributions. The `withinDeadline` modifier will then enforce
+this constraint, ensuring contributions are made within the allowed period.
+
+**Enhanced Contract:**
+
+The upgraded contract, [`CrowdfundingCampaignV2.sol`](https://github.com/dutterbutter/zksync-quickstart-guide/blob/db/contract-upgrade/contracts/CrowdfundingCampaignV2.sol),
+located in the `/contracts` directory,
+incorporates these changes:
+
+- **Deadline Variable:** A new state variable deadline defines the campaign's end time,
+enhancing the contract with time-based logic.
+
+- **Initialization Logic:** An additional initialization method, `initializeV2`, sets the deadline
+based on a duration provided during the upgrade. This function ensures that the upgrade is
+backward-compatible and maintains the contract's integrity.
+
+- **Contribution Logic with Deadline:** The `contribute` method now includes a `withinDeadline` modifier,
+ensuring all contributions are made within the set timeframe.
+
+- **Deadline Enforcement:** The `withinDeadline` modifier checks the current time against the deadline,
+safeguarding the contract from late contributions.
+
+**Deadline Extension Capability:**
+
+To provide flexibility, a new function allows the owner to extend the deadline,
+offering adaptability to changing campaign needs.
+
+```solidity
+function extendDeadline(uint256 _newDuration) public {
+    require(msg.sender == owner, "Only the owner can extend the deadline");
+    deadline = block.timestamp + _newDuration;
+}
+```
+
+This upgrade not only introduces the element of time to the campaign but also
+exemplifies the use of `modifiers` for enforcing contract conditions.
+
+:display-partial{path = "/_partials/_compile-solidity-contracts"}
+
+Upon successful compilation, you'll receive output detailing the
+`zksolc` and `solc` versions used during compiling and the number
+of Solidity files compiled.
+
+```bash
+Compiling contracts for zkSync Era with zksolc v1.4.0 and solc v0.8.17
+Compiling 4 Solidity file
+Successfully compiled 4 Solidity file
+```
+
+The compiled artifacts will be located in the `/artifacts-zk` folder.
+
+## Upgrade to `CrowdfundingCampaignV2`
+
+This section describes the upgrade process to `CrowdfundingCampaignV2.sol` contract. Let's
+start by reviewing the [`upgradeBeaconCrowdfundingCampaign.ts`](https://github.com/dutterbutter/zksync-quickstart-guide/blob/db/contract-upgrade/deploy/upgrade-scripts/upgradeBeaconCrowdfundingCampaign.ts)
+script in the `deploy/upgrade-scripts` directory:
+
+Make sure to replace `YOUR_BEACON_ADDRESS_HERE` with the address of your deployed beacon and
+`YOUR_PROXY_ADDRESS_HERE` with the actual address of your
+deployed Beacon Proxy from the previous deployment step.
+
+```typescript
+import { getWallet } from "../utils";
+import { Deployer } from '@matterlabs/hardhat-zksync';
+import { HardhatRuntimeEnvironment } from "hardhat/types";
+import * as zk from 'zksync-ethers';
+import { Contract } from 'ethers';
+
+export default async function (hre: HardhatRuntimeEnvironment) {
+    const wallet = getWallet();
+    const deployer = new Deployer(hre, wallet);
+
+    // Placeholder for the deployed beacon address
+    const beaconAddress = 'YOUR_BEACON_ADDRESS_HERE';
+
+    const contractV2Artifact = await deployer.loadArtifact('CrowdfundingCampaignV2');
+
+    // Upgrade the proxy to V2
+    await hre.zkUpgrades.upgradeBeacon(deployer.zkWallet, beaconAddress, contractV2Artifact);
+
+    console.log('Successfully upgraded crowdfundingCampaign to crowdfundingCampaignV2');
+
+    const attachTo = new zk.ContractFactory<any[], Contract>(
+        crowdfundingCampaignV2.abi,
+        crowdfundingCampaignV2.bytecode,
+        deployer.zkWallet,
+        deployer.deploymentType,
+    );
+
+    // Placeholder for the deployed beacon proxy address
+    const proxyAddress = 'YOUR_PROXY_ADDRESS_HERE';
+
+    const upgradedContract  = attachTo.attach(proxyAddress);
+
+    upgradedContract.connect(deployer.zkWallet);
+    // wait some time before the next call
+    await new Promise((resolve) => setTimeout(resolve, 2000));
+
+    // Initialize V2 with a new campaign duration
+    const durationInSeconds = 30 * 24 * 60 * 60; // For example, setting a 30-day duration
+    const initTx = await upgradedContract.initializeV2(durationInSeconds);
+    const receipt = await initTx.wait();
+
+   console.log(`CrowdfundingCampaignV2 initialized. Transaction Hash: ${receipt.hash}`);
+}
+```
+
+**Key Components:**
+
+- **`upgradeBeacon`**: This method from the `hre.zkUpgrades` module is used to update the beacon contract
+with the new version of the contract logic, `CrowdfundingCampaignV2`.
+It ensures that all proxies pointing to this beacon will now execute the updated contract code.
+- **`initializeV2`:** This method is specifically called post-upgrade to initialize or reconfigure any new state
+variables or logic introduced in the `CrowdfundingCampaignV2`.
+Here, it's used to set a new campaign duration, seamlessly
+integrating new functionalities while retaining the existing contract state and funds.
+
+Execute the test command corresponding to your package manager:
+
+::code-group
+
+```bash [npm]
+npm run hardhat deploy-zksync --script upgrade-scripts/upgradeBeaconCrowdfundingCampaign.ts
+```
+
+```bash [yarn]
+yarn hardhat deploy-zksync --script upgrade-scripts/upgradeBeaconCrowdfundingCampaign.ts
+```
+
+```bash [pnpm]
+pnpm run hardhat deploy-zksync --script upgrade-scripts/upgradeBeaconCrowdfundingCampaign.ts
+```
+
+```bash [bun]
+bun run hardhat deploy-zksync --script upgrade-scripts/upgradeBeaconCrowdfundingCampaign.ts
+```
+
+::
+
+Upon successful deployment, you'll receive output detailing the upgrade process,
+including the new beacon address, and transaction hash:
+
+```bash
+New beacon impl deployed at 0x58BD5adb462CF087E5838d53aE38A3Fe0EAf7A31
+Successfully upgraded crowdfundingCampaign to crowdfundingCampaignV2 0x26410Bebf5Df7398DCBC5f00e9EBBa0Ddf471C72
+CrowdfundingCampaignV2 initialized! 0x5f3131c77fcac19390f5f644a3ad1f0e7719dee4b4b5b4746c992de00db743f7
+Fundraising goal: 100000000000000000
+```
+
+---
+
+## Verify upgradable contracts
+
+For the verification of our upgradable contracts, it's essential to utilize the proxy address that was specified in our
+upgrade script.
+
+To proceed with verification, execute the following command:
+
+::code-group
+
+```bash [npm]
+npm run hardhat verify <BEACON-PROXY-ADDRESS>
+```
+
+```bash [yarn]
+yarn hardhat verify <BEACON-PROXY-ADDRESS>
+```
+
+```bash [pnpm]
+pnpm run hardhat verify <BEACON-PROXY-ADDRESS>
+```
+
+```bash [bun]
+bun run hardhat verify <BEACON-PROXY-ADDRESS>
+```
+
+::
+
+Upon successful verification, you'll receive output detailing the verification process:
+
+```bash
+Verifying implementation: 0x58BD5adb462CF087E5838d53aE38A3Fe0EAf7A31
+Your verification ID is: 10547
+Contract successfully verified on zkSync block explorer!
+Verifying beacon: 0x26410Bebf5Df7398DCBC5f00e9EBBa0Ddf471C72
+Your verification ID is: 10548
+Contract successfully verified on zkSync block explorer!
+Verifying beacon proxy: 0xD58FA9Fb362Abf69cFc68A3545fD227165DAc167
+Your verification ID is: 10549
+Contract successfully verified on zkSync block explorer!
+```
+
+🎉 Congratulations! The `CrowdfundingCampaignV2` contract has been upgraded and verified!
diff --git a/content/10.quick-start/_upgrading/_beacon_proxy_contract_upgradability.md b/content/10.quick-start/_upgrading/_beacon_proxy_contract_upgradability.md
new file mode 100644
index 00000000..0c10b584
--- /dev/null
+++ b/content/10.quick-start/_upgrading/_beacon_proxy_contract_upgradability.md
@@ -0,0 +1,34 @@
+---
+title: Beacon Proxy Contract Upgradeability
+---
+
+### What is a beacon proxy upgradeable contract?
+Beacon Proxy Upgradeable Contracts leverage a beacon to manage upgrades, allowing
+for centralized logic updates across multiple proxies. The structure includes:
+
+1. **Beacon Contract**: Acts as the central point holding the address of the current logic contract.
+It enables updating the logic for all associated proxies through a single transaction.
+1. **Proxy Contracts**: These lightweight contracts delegate calls to the logic contract address
+provided by the beacon, maintaining their own state and balance.
+1. **Logic Contract**: Contains the executable business logic, which can be updated by changing
+the beacon's reference without altering individual proxies.
+1. **Admin Address**: Authorized to update the logic contract address in the beacon, ensuring controlled and secure upgrades.
+
+This arrangement allows multiple proxy contracts to be upgraded simultaneously by updating
+the logic contract address in the beacon, streamlining the upgrade process. It preserves
+the state and balance of each proxy contract, offering an efficient way to roll out new
+features or fixes while maintaining a uniform interface for users.
+
+---
+
+::content-switcher
+---
+items: [{
+  label: 'Hardhat',
+  partial: '_upgrading/_beacon/_hardhat_beacon_contract_upgradability'
+}, {
+  label: 'Foundry',
+  partial: '_upgrading/_beacon/_foundry_beacon_contract_upgradability'
+}]
+---
+::
diff --git a/content/10.quick-start/_upgrading/_transparent/_foundry_transparent_contract_upgradability.md b/content/10.quick-start/_upgrading/_transparent/_foundry_transparent_contract_upgradability.md
new file mode 100644
index 00000000..6876ce71
--- /dev/null
+++ b/content/10.quick-start/_upgrading/_transparent/_foundry_transparent_contract_upgradability.md
@@ -0,0 +1,5 @@
+---
+title: Foundry | Contract Upgrade
+---
+
+Coming soon!
diff --git a/content/10.quick-start/_upgrading/_transparent/_hardhat_transparent_contract_upgradability.md b/content/10.quick-start/_upgrading/_transparent/_hardhat_transparent_contract_upgradability.md
new file mode 100644
index 00000000..80b0421d
--- /dev/null
+++ b/content/10.quick-start/_upgrading/_transparent/_hardhat_transparent_contract_upgradability.md
@@ -0,0 +1,427 @@
+---
+title: Hardhat | Contract Upgrading
+---
+<!-- TODO: @dutterbutter determine best approach to leverate zksync cli for project
+bootstrapping for this guide series. -->
+Run the following command in your terminal to initialize the project.
+
+```sh
+git clone https://github.com/dutterbutter/zksync-quickstart-guide.git
+cd zksync-quickstart-guide
+git checkout db/contract-upgrade
+```
+
+Install the dependencies:
+
+::code-group
+
+```bash [npm]
+npm install
+```
+
+```bash [yarn]
+yarn install
+```
+
+```bash [pnpm]
+pnpm install
+```
+
+```bash [bun]
+bun install
+```
+
+::
+
+---
+
+## Set up your wallet
+
+:display-partial{path = "/quick-start/_partials/_setup-wallet"}
+
+---
+
+## Adapt `CrowdfundingCampaign.sol` contract for upgradability
+
+To adapt our `CrowdfundingCampaign.sol` contract for upgradability, we're
+transitioning to a proxy pattern. This approach separates the
+contract's logic (which can be upgraded) from its persistent state
+(stored in the proxy).
+
+### Refactoring for Proxy Compatibility
+
+In the `contracts/` directory you'll observe the refactored the [`CrowdfundingCampaign` contract](https://github.com/dutterbutter/zksync-quickstart-guide/blob/db/contract-upgrade/contracts/CrowdfundingCampaign.sol)
+which initializes state variables through an
+`initialize` function instead of the constructor, in line with the
+Transparent Proxy pattern.
+
+**Updated Contract Structure:**
+
+```solidity
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.0;
+
+import "@openzeppelin/contracts/proxy/utils/Initializable.sol";
+
+contract CrowdfundingCampaign is Initializable {
+    address public owner;
+    uint256 public fundingGoal;
+    mapping(address => uint256) public contributions;
+
+    event ContributionReceived(address contributor, uint256 amount);
+    event GoalReached(uint256 totalFundsRaised);
+
+    // Remove constructor in favour of initialize method
+    function initialize(uint256 _fundingGoal) public initializer {
+        owner = msg.sender;
+        fundingGoal = _fundingGoal;
+    }
+
+    function contribute() public payable {
+        // contribution logic remains the same
+    }
+
+    function withdrawFunds() public {
+        // withdrawFunds logic remains the same
+    }
+
+    function getTotalFundsRaised() public view returns (uint256) {
+        // getTotalFundsRaised remains the same
+    }
+
+    function getFundingGoal() public view returns (uint256) {
+        // getFundingGoal remains the same
+    }
+}
+```
+
+**Key Modifications:**
+
+- **Initializable**: Inherits from OpenZeppelin's `Initializable` to ensure the `initialize` function
+can only be called once, similar to a constructor.
+- **Initialize Function**: Replaces the constructor for setting initial state, facilitating upgrades
+through new logic contracts.
+- **Proxy Pattern**: Utilizes a proxy contract to delegate calls to this logic contract,
+allowing for future upgrades without losing the contract's state.
+
+This restructuring prepares the `CrowdfundingCampaign` contract for upgradability.
+
+---
+
+## Deploy the `CrowdfundingCampaign` contract
+
+Now that the `CrowdfundingCampaign` contract is adapted for contract upgradability, let's proceed to deploy
+the contract so we may upgrade it in later steps. Since we've made changes to our contract we will
+need to re-compile.
+
+To compile the contracts in the project, run the following command:
+
+::code-group
+
+```bash [npm]
+npm run compile
+```
+
+```bash [yarn]
+yarn compile
+```
+
+```bash [pnpm]
+pnpm run compile
+```
+
+```bash [bun]
+bun run compile
+```
+
+::
+
+Upon successful compilation, you'll receive output detailing the
+`zksolc` and `solc` versions used during compiling and the number
+of Solidity files compiled.
+
+```bash
+Compiling contracts for zkSync Era with zksolc v1.4.0 and solc v0.8.17
+Compiling 3 Solidity file
+Successfully compiled 3 Solidity file
+```
+
+The compiled artifacts will be located in the `/artifacts-zk` folder.
+
+The deployment script is located at [`/deploy/deployTransparentProxy.ts`](https://github.com/dutterbutter/zksync-quickstart-guide/blob/db/contract-upgrade/deploy/deployTransparentProxy.ts).
+
+```typescript
+import { getWallet } from "./utils";
+import { Deployer } from '@matterlabs/hardhat-zksync';
+import { ethers } from "ethers";
+import { HardhatRuntimeEnvironment } from "hardhat/types";
+
+export default async function (hre: HardhatRuntimeEnvironment) {
+    const wallet = getWallet();
+    const deployer = new Deployer(hre, wallet);
+
+    const contractArtifact = await deployer.loadArtifact("CrowdfundingCampaign");
+    const fundingGoalInWei = ethers.parseEther('0.1').toString();
+    // Deploy the contract using a transparent proxy
+    const crowdfunding = await hre.zkUpgrades.deployProxy(
+        getWallet(),
+        contractArtifact,
+        [fundingGoalInWei],
+        { initializer: 'initialize' }
+    );
+
+    await crowdfunding.waitForDeployment();
+}
+```
+
+**Key Components:**
+
+- **`hre.zkUpgrades.deployProxy`**: The method call to deploy the `CrowdfundingCampaign`
+contract via a transparent proxy, leveraging Hardhat's runtime environment for zkSync upgrades.
+This ensures the deployed contract can be upgraded in the future without losing its state or funds.
+- **`initializer`**: Specifies the initialization method of the contract, `initialize` in this case,
+which is required for setting up the proxy's state upon deployment.
+
+Execute the deployment command corresponding to your package manager. The default command
+deploys to the configured network in your Hardhat setup. For local deployment, append
+`--network inMemoryNode` to deploy to the local in-memory node running.
+
+::code-group
+
+```bash [npm]
+npm run hardhat deploy-zksync --script deployTransparentProxy.ts
+# To deploy the contract on local in-memory node:
+# npm run hardhat deploy-zksync --script deployTransparentProxy.ts --network inMemoryNode
+```
+
+```bash [yarn]
+yarn hardhat deploy-zksync --script deployTransparentProxy.ts
+# To deploy the contract on local in-memory node:
+# yarn hardhat deploy-zksync --script deployTransparentProxy.ts --network inMemoryNode
+```
+
+```bash [pnpm]
+pnpm run hardhat deploy-zksync --script deployTransparentProxy.ts
+# To deploy the contract on local in-memory node:
+# pnpm run hardhat deploy-zksync --script deployTransparentProxy.ts --network inMemoryNode
+```
+
+```bash [bun]
+bun run hardhat deploy-zksync --script deployTransparentProxy.ts
+# To deploy the contract on local in-memory node:
+# bun run hardhat deploy-zksync --script deployTransparentProxy.ts --network inMemoryNode
+```
+
+::
+
+Upon successful deployment, you'll receive output detailing the deployment process,
+including the contract addresses of the implementation
+contract, the admin contract, and the transparent
+proxy contract.
+
+```bash
+Implementation contract was deployed to 0xE3F814fa915A75bA47230537726C99f6517Da58e
+Admin was deployed to 0x05198D9f93cBDfa3e332776019115512d8e0c809
+Transparent proxy was deployed to 0x68E8533acE01019CB8D07Eca822369D5De71b74D
+```
+
+---
+
+## Upgrade the `CrowdfundingCampaign` Contract
+
+With our initial setup deployed, we're ready to update our `CrowdfundingCampaign.sol`
+contract by incorporating a deadline for contributions. This addition not only brings
+a new layer of functionality but also introduces the concept of time-based conditions
+through a `modifier`.
+
+**Current Contract Overview:**
+
+The existing version of our contract allows for open-ended contributions towards a
+funding goal, without any time constraints.
+
+**Proposed Upgrade:**
+
+We're introducing a `deadline` variable, initialized at contract deployment, to establish a
+clear timeframe for accepting contributions. The `withinDeadline` modifier will then enforce
+this constraint, ensuring contributions are made within the allowed period.
+
+**Enhanced Contract:**
+
+The upgraded contract, [`CrowdfundingCampaignV2.sol`](https://github.com/dutterbutter/zksync-quickstart-guide/blob/db/contract-upgrade/contracts/CrowdfundingCampaignV2.sol),
+located in the `/contracts` directory, incorporates these changes:
+
+- **Deadline Variable:** A new state variable deadline defines the campaign's end time,
+enhancing the contract with time-based logic.
+
+- **Initialization Logic:** An additional initialization method, `initializeV2`, sets the deadline
+based on a duration provided during the upgrade. This function ensures that the upgrade is
+backward-compatible and maintains the contract's integrity.
+
+- **Contribution Logic with Deadline:** The `contribute` method now includes a `withinDeadline` modifier,
+ensuring all contributions are made within the set timeframe.
+
+- **Deadline Enforcement:** The `withinDeadline` modifier checks the current time against the deadline,
+safeguarding the contract from late contributions.
+
+**Deadline Extension Capability:**
+
+To provide flexibility, a new function allows the owner to extend the deadline,
+offering adaptability to changing campaign needs.
+
+```solidity
+function extendDeadline(uint256 _newDuration) public {
+    require(msg.sender == owner, "Only the owner can extend the deadline");
+    deadline = block.timestamp + _newDuration;
+}
+```
+
+This upgrade not only introduces the element of time to the campaign but also
+exemplifies the use of `modifiers` for enforcing contract conditions.
+<!-- TODO: maybe make this a callout and link to what modifiers are. -->
+
+### Compile contract
+:display-partial{path = "/_partials/_compile-solidity-contracts"}
+
+Upon successful compilation, you'll receive output detailing the
+`zksolc` and `solc` versions used during compiling and the number
+of Solidity files compiled.
+
+```bash
+Compiling contracts for zkSync Era with zksolc v1.4.0 and solc v0.8.17
+Compiling 4 Solidity file
+Successfully compiled 4 Solidity file
+```
+
+The compiled artifacts will be located in the `/artifacts-zk` folder.
+
+### Upgrade to `CrowdfundingCampaignV2`
+
+This section guides you through upgrading the `CrowdfundingCampaign` contract
+to its second version, `CrowdfundingCampaignV2`.
+Review the [`upgradeCrowdfundingCampaign.ts`](https://github.com/dutterbutter/zksync-quickstart-guide/blob/db/contract-upgrade/deploy/upgrade-scripts/upgradeCrowdfundingCampaign.ts)
+script located within the `deploy/upgrade-scripts` directory to begin.
+
+Replace `YOUR_PROXY_ADDRESS_HERE` with the actual address of your
+deployed Transparent Proxy from the previous deployment step.
+
+```typescript
+import { getWallet } from "../utils";
+import { Deployer } from '@matterlabs/hardhat-zksync';
+import { HardhatRuntimeEnvironment } from "hardhat/types";
+
+export default async function (hre: HardhatRuntimeEnvironment) {
+    const wallet = getWallet();
+    const deployer = new Deployer(hre, wallet);
+
+    // Placeholder for the deployed proxy address
+    const proxyAddress = 'YOUR_PROXY_ADDRESS_HERE';
+
+    const contractV2Artifact = await deployer.loadArtifact('CrowdfundingCampaignV2');
+
+    // Upgrade the proxy to V2
+    const upgradedContract = await hre.zkUpgrades.upgradeProxy(deployer.zkWallet, proxyAddress, contractV2Artifact);
+
+    console.log('Successfully upgraded crowdfundingCampaign to crowdfundingCampaignV2');
+
+    upgradedContract.connect(deployer.zkWallet);
+    // wait some time before the next call
+    await new Promise((resolve) => setTimeout(resolve, 2000));
+
+    // Initialize V2 with a new campaign duration
+    const durationInSeconds = 30 * 24 * 60 * 60; // For example, setting a 30-day duration
+    const initTx = await upgradedContract.initializeV2(durationInSeconds);
+    const receipt = await initTx.wait();
+
+    console.log(`CrowdfundingCampaignV2 initialized. Transaction Hash: ${receipt.hash}`);
+}
+```
+
+**Key Components:**
+
+- **`upgradeProxy`:** A critical method from the `hre.zkUpgrades` module that
+performs the contract upgrade. It takes the wallet, the proxy address, and the
+new contract artifact as arguments to transition the proxy to use the `CrowdfundingCampaignV2` logic.
+
+- **`initializeV2`:** Post-upgrade, this function is invoked to initialize the new
+variables or logic introduced in `CrowdfundingCampaignV2`. In this example,
+it sets a new campaign duration, illustrating how contract upgrades can add
+functionalities without losing the existing state or funds.
+
+Execute the command corresponding to your package manager:
+
+::code-group
+
+```bash [npm]
+npm run hardhat deploy-zksync --script upgrade-scripts/upgradeCrowdfundingCampaign.ts
+```
+
+```bash [yarn]
+yarn hardhat deploy-zksync --script upgrade-scripts/upgradeCrowdfundingCampaign.ts
+```
+
+```bash [pnpm]
+pnpm run hardhat deploy-zksync --script upgrade-scripts/upgradeCrowdfundingCampaign.ts
+```
+
+```bash [bun]
+bun run hardhat deploy-zksync --script upgrade-scripts/upgradeCrowdfundingCampaign.ts
+```
+
+::
+
+Upon successful deployment, you'll receive output detailing the upgrade process,
+including the contract address, and transaction hash:
+
+```bash
+Contract successfully upgraded to 0x58BD5adb462CF087E5838d53aE38A3Fe0EAf7A31 with tx 0xe30c017c52376507ab55bb51bc27eb300832dc46b8b9ac14549d2f9014cee97e
+Successfully upgraded crowdfundingCampaign to crowdfundingCampaignV2
+CrowdfundingCampaignV2 initialized! 0x5adfe360187195d98d3603a82a20ffe7304cd4dec030d1bdf456fa1690879668
+Fundraising goal: 100000000000000000
+```
+
+---
+
+## Verify upgradable contracts
+
+For the verification of our upgradable contracts, it's essential to utilize the proxy address that was specified in our
+upgrade script.
+
+To proceed with verification, execute the following command:
+
+Replace <PROXY_ADDRESS> with the actual proxy address from your deployment.
+
+::code-group
+
+```bash [npm]
+npm run hardhat verify <PROXY-ADDRESS>
+```
+
+```bash [yarn]
+yarn hardhat verify <PROXY-ADDRESS>
+```
+
+```bash [pnpm]
+pnpm run hardhat verify <PROXY-ADDRESS>
+```
+
+```bash [bun]
+bun run hardhat verify <PROXY-ADDRESS>
+```
+
+::
+
+Upon successful verification, you'll receive output detailing the verification process:
+
+```bash
+Verifying implementation: 0x58BD5adb462CF087E5838d53aE38A3Fe0EAf7A31
+Your verification ID is: 10543
+Contract successfully verified on zkSync block explorer!
+Verifying proxy: 0x68E8533acE01019CB8D07Eca822369D5De71b74D
+Your verification ID is: 10544
+Contract successfully verified on zkSync block explorer!
+Verifying proxy admin: 0x05198D9f93cBDfa3e332776019115512d8e0c809
+Your verification ID is: 10545
+Contract successfully verified on zkSync block explorer!
+```
+
+🎉 Congratulations! The `CrowdfundingCampaignV2` contract has been upgraded and verified!
diff --git a/content/10.quick-start/_upgrading/_transparent_proxy_contract_upgradability.md b/content/10.quick-start/_upgrading/_transparent_proxy_contract_upgradability.md
new file mode 100644
index 00000000..e9cfbbe3
--- /dev/null
+++ b/content/10.quick-start/_upgrading/_transparent_proxy_contract_upgradability.md
@@ -0,0 +1,33 @@
+---
+title: Transparent Upgradeable Proxy Contract
+---
+
+### What is a transparent upgradeable proxy contract?
+Transparent upgradeable contracts utilize the proxy pattern to facilitate post-deployment
+logic updates while preventing accidental function collisions. They consist of:
+
+1. **Proxy Contract**: Manages storage, balance, and delegates calls to the logic contract,
+except for those by the admin, ensuring clear separation between user and administrative interactions.
+1. **Logic Contract**: Houses the actual business logic, upgradeable by swapping out for new versions.
+1. **Admin Address**: Holds the rights to upgrade the logic contract, with its commands executed
+exclusively by the proxy to prevent unintended logic execution.
+
+This setup ensures only non-administrative calls reach the logic contract, allowing
+for safe and seamless upgrades. By switching the logic contract to a newer version
+while keeping the original proxy intact, the contract's state and balance are preserved.
+This facilitates improvements or bug fixes without changing the proxy, maintaining a
+consistent user interface.
+
+---
+
+::content-switcher
+---
+items: [{
+  label: 'Hardhat',
+  partial: '_upgrading/_transparent/_hardhat_transparent_contract_upgradability'
+}, {
+  label: 'Foundry',
+  partial: '_upgrading/_transparent/_foundry_transparent_contract_upgradability'
+}]
+---
+::
diff --git a/content/10.quick-start/_upgrading/_uups/_foundry_uups_contract_upgradability.md b/content/10.quick-start/_upgrading/_uups/_foundry_uups_contract_upgradability.md
new file mode 100644
index 00000000..6876ce71
--- /dev/null
+++ b/content/10.quick-start/_upgrading/_uups/_foundry_uups_contract_upgradability.md
@@ -0,0 +1,5 @@
+---
+title: Foundry | Contract Upgrade
+---
+
+Coming soon!
diff --git a/content/10.quick-start/_upgrading/_uups/_hardhat_uups_contract_upgradability.md b/content/10.quick-start/_upgrading/_uups/_hardhat_uups_contract_upgradability.md
new file mode 100644
index 00000000..8cf68141
--- /dev/null
+++ b/content/10.quick-start/_upgrading/_uups/_hardhat_uups_contract_upgradability.md
@@ -0,0 +1,426 @@
+---
+title: Hardhat | Contract Upgrading
+---
+
+<!-- TODO: @dutterbutter determine best approach to leverate zksync cli for project
+bootstrapping for this guide series. -->
+Run the following command in your terminal to initialize the project.
+
+```sh
+git clone https://github.com/dutterbutter/zksync-quickstart-guide.git
+cd zksync-quickstart-guide
+git checkout db/contract-upgrade
+```
+
+Install the dependencies:
+
+::code-group
+
+```bash [npm]
+npm install
+```
+
+```bash [yarn]
+yarn install
+```
+
+```bash [pnpm]
+pnpm install
+```
+
+```bash [bun]
+bun install
+```
+
+::
+
+## Set up your wallet
+
+:display-partial{path="quick-start/_partials/_setup-wallet"}
+
+---
+
+## Adapt the `CrowdfundingCampaign.sol` for UUPS Upgradability
+
+To align the `CrowdfundingCampaign.sol` contract with UUPS (Universal Upgradeable Proxy Standard) upgradability,
+we're integrating OpenZeppelin's UUPSUpgradeable contracts. This method offers a more secure and gas-efficient
+approach to contract upgrades by embedding the upgrade logic within the contract itself.
+
+### Refactoring for UUPS Compatibility
+
+We've refactored the contract to support UUPS upgradability, ensuring the contract's logic
+is upgradeable while maintaining a persistent state. This is achieved by utilizing initializer
+functions and the UUPS upgrade mechanism.
+
+**UUPS-Enabled Contract Structure:**
+
+```solidity
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.0;
+
+// Import UUPS from OpenZeppelin
+import "@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol";
+import "@openzeppelin/contracts-upgradeable/proxy/utils/UUPSUpgradeable.sol";
+import "@openzeppelin/contracts-upgradeable/access/OwnableUpgradeable.sol";
+
+contract CrowdfundingCampaign_UUPS is Initializable, UUPSUpgradeable, OwnableUpgradeable {
+    uint256 public fundingGoal;
+    uint256 public totalFundsRaised;
+    mapping(address => uint256) public contributions;
+
+    event ContributionReceived(address contributor, uint256 amount);
+    event GoalReached(uint256 totalFundsRaised);
+
+    // Initializer function, replaces constructor for upgradeable contracts
+    function initialize(uint256 _fundingGoal) public initializer {
+        __Ownable_init(); // Initialize ownership to the deployer
+        __UUPSUpgradeable_init(); // Initialize UUPS upgradeability
+
+        fundingGoal = _fundingGoal;
+    }
+
+    function contribute() public payable {
+        // Contribution logic remains the same
+    }
+
+    function withdrawFunds() public onlyOwner {
+        // WithdrawFunds logic remains the same
+    }
+
+    function getTotalFundsRaised() public view returns (uint256) {
+        // getTotalFundsRaised remains the same
+    }
+
+    function getFundingGoal() public view returns (uint256) {
+        // getFundingGoal remains the same
+    }
+
+    // Ensure only the owner can upgrade the contract
+    function _authorizeUpgrade(address newImplementation) internal override onlyOwner {}
+}
+```
+
+**Key Adaptations:**
+
+- **Initializable & UUPSUpgradeable**: The contract inherits from `Initializable` and `UUPSUpgradeable`,
+ensuring initialization follows the proxy pattern and enabling the UUPS upgrade mechanism.
+- **OwnableUpgradeable**: Utilizes `OwnableUpgradeable` to manage ownership through an initializer,
+important for secure upgrade authorization.
+- **_authorizeUpgrade**: A safeguard function ensuring only the contract owner can perform upgrades,
+reinforcing the contract's security.
+
+By adopting the UUPS pattern, the [`CrowdfundingCampaign_UUPS`](https://github.com/dutterbutter/zksync-quickstart-guide/blob/db/contract-upgrade/contracts/CrowdfundingCampaign_UUPS.sol)
+contract becomes efficiently upgradeable, offering enhanced security and reduced gas costs, setting a solid foundation for future enhancements.
+
+---
+
+## Compile the `CrowdfundingCampaign_UUPS` contract
+
+Now that the `CrowdfundingCampaign_UUPS` contract is adapted for contract upgradability, let's proceed to deploy
+the contract so we may upgrade it in later steps. Since we've made changes to our contract we will
+need to re-compile.
+
+To compile the contracts in the project, run the following command:
+
+::code-group
+
+```bash [npm]
+npm run compile
+```
+
+```bash [yarn]
+yarn compile
+```
+
+```bash [pnpm]
+pnpm run compile
+```
+
+```bash [bun]
+bun run compile
+```
+
+::
+
+Upon successful compilation, you'll receive output detailing the
+`zksolc` and `solc` versions used during compiling and the number
+of Solidity files compiled.
+
+```bash
+Compiling contracts for zkSync Era with zksolc v1.4.0 and solc v0.8.17
+Compiling 4 Solidity file
+Successfully compiled 4 Solidity file
+```
+
+The compiled artifacts will be located in the `/artifacts-zk` folder.
+
+## Deploy the updated contract
+
+The script to deploy the `CrowdfundingCampaign_UUPS` contract is located at [`/deploy/deployUUPS.ts`](https://github.com/dutterbutter/zksync-quickstart-guide/blob/db/contract-upgrade/deploy/deployUUPS.ts).
+
+```typescript
+import { getWallet } from "./utils";
+import { Deployer } from '@matterlabs/hardhat-zksync';
+import { ethers } from "ethers";
+import { HardhatRuntimeEnvironment } from "hardhat/types";
+
+export default async function (hre: HardhatRuntimeEnvironment) {
+    const wallet = getWallet();
+    const deployer = new Deployer(hre, wallet);
+
+    const contractArtifact = await deployer.loadArtifact("CrowdfundingCampaign_UUPS");
+    const fundingGoalInWei = ethers.parseEther('0.1').toString();
+
+    const crowdfunding = await hre.zkUpgrades.deployProxy(
+        getWallet(),
+        contractArtifact,
+        [fundingGoalInWei],
+        { initializer: 'initialize' }
+    );
+
+    await crowdfunding.waitForDeployment();
+}
+```
+
+**Key Components:**
+
+- **`deployProxy` Method:** This method is responsible for deploying the `CrowdfundingCampaign`
+contract as a UUPS upgradeable contract. It initializes the contract with the specified parameters,
+such as the `fundingGoalInWei`, ensuring that the contract is ready for immediate use after deployment.
+The use of the UUPS pattern provides a secure and efficient mechanism for future upgrades.
+
+- **`initializer` Option:** Specifies the initialization method of the contract, in this case, `initialize`.
+This is used for setting up the initial state of the contract upon deployment, particularly important
+for upgradeable contracts where constructor usage is not possible.
+
+Execute the deployment command corresponding to your package manager. The default command
+deploys to the configured network in your Hardhat setup. For local deployment, append
+`--network inMemoryNode` to deploy to the local in-memory node running.
+
+::code-group
+
+```bash [npm]
+npm run hardhat deploy-zksync --script deployUUPS.ts
+# To deploy the contract on local in-memory node:
+# npm run hardhat deploy-zksync --script deployUUPS.ts --network inMemoryNode
+```
+
+```bash [yarn]
+yarn hardhat deploy-zksync --script deployUUPS.ts
+# To deploy the contract on local in-memory node:
+# yarn hardhat deploy-zksync --script deployUUPS.ts --network inMemoryNode
+```
+
+```bash [pnpm]
+pnpm run hardhat deploy-zksync --script deployUUPS.ts
+# To deploy the contract on local in-memory node:
+# pnpm run hardhat deploy-zksync --script deployUUPS.ts --network inMemoryNode
+```
+
+```bash [bun]
+bun run hardhat deploy-zksync --script deployUUPS.ts
+# To deploy the contract on local in-memory node:
+# bun run hardhat deploy-zksync --script deployUUPS.ts --network inMemoryNode
+```
+
+::
+
+Upon successful deployment, you'll receive output detailing the deployment process,
+including the contract addresses of the implementation
+contract, the admin contract, and the transparent
+proxy contract.
+
+```bash
+Implementation contract was deployed to 0xF0De77041F3cF6D9C905A10ce59858b17E57E3B9
+UUPS proxy was deployed to 0x56882194aAe8E4B6d18cD84e4D7B0F807e0100Cb
+```
+
+---
+
+## Upgrade to the `CrowdfundingCampaignV2_UUPS` Contract
+
+With our initial setup deployed, we're ready to upgrade our `CrowdfundingCampaign_UUPS.sol`
+contract by incorporating a deadline for contributions. This addition not only brings
+a new layer of functionality but also introduces the concept of time-based conditions
+through a `modifier`.
+
+**Current Contract Overview:**
+
+The existing version of our contract allows for open-ended contributions towards a
+funding goal, without any time constraints.
+
+**Proposed Upgrade:**
+
+We're introducing a `deadline` variable, initialized at contract deployment, to establish a
+clear timeframe for accepting contributions. The `withinDeadline` modifier will then enforce
+this constraint, ensuring contributions are made within the allowed period.
+
+**Enhanced Contract:**
+
+The upgraded contract, [`CrowdfundingCampaignV2_UUPS.sol`](https://github.com/dutterbutter/zksync-quickstart-guide/blob/db/contract-upgrade/contracts/CrowdfundingCampaignV2_UUPS.sol),
+located in the `/contracts` directory, incorporates these changes:
+
+- **Deadline Variable:** A new state variable deadline defines the campaign's end time,
+enhancing the contract with time-based logic.
+
+- **Initialization Logic:** An additional initialization method, `initializeV2`, sets the deadline
+based on a duration provided during the upgrade. This function ensures that the upgrade is
+backward-compatible and maintains the contract's integrity.
+
+- **Contribution Logic with Deadline:** The `contribute` method now includes a `withinDeadline` modifier,
+ensuring all contributions are made within the set timeframe.
+
+- **Deadline Enforcement:** The `withinDeadline` modifier checks the current time against the deadline,
+safeguarding the contract from late contributions.
+
+**Deadline Extension Capability:**
+
+To provide flexibility, a new function allows the owner to extend the deadline,
+offering adaptability to changing campaign needs.
+
+```solidity
+function extendDeadline(uint256 _newDuration) public {
+    require(msg.sender == owner, "Only the owner can extend the deadline");
+    deadline = block.timestamp + _newDuration;
+}
+```
+
+This upgrade not only introduces the element of time to the campaign but also
+exemplifies the use of `modifiers` for enforcing contract conditions.
+
+### Compile the `CrowdfundingCampaignV2_UUPS` contract
+
+:display-partial{path = "/_partials/_compile-solidity-contracts"}
+
+Upon successful compilation, you'll receive output detailing the
+`zksolc` and `solc` versions used during compiling and the number
+of Solidity files compiled.
+
+```bash
+Compiling contracts for zkSync Era with zksolc v1.4.0 and solc v0.8.17
+Compiling 4 Solidity file
+Successfully compiled 4 Solidity file
+```
+
+The compiled artifacts will be located in the `/artifacts-zk` folder.
+
+### Upgrade to `CrowdfundingCampaignV2_UUPS`
+
+This section describes the initiating the upgrade to `CrowdfundingCampaignV2_UUPS.sol` contract.
+Let's start by reviewing the [`upgradeUUPSCrowdfundingCampaign.ts`](https://github.com/dutterbutter/zksync-quickstart-guide/blob/db/contract-upgrade/deploy/upgrade-scripts/upgradeUUPSCrowdfundingCampaign.ts)
+script in the `deploy/upgrade-scripts` directory:
+
+Replace `YOUR_PROXY_ADDRESS_HERE` with the actual address of your
+deployed Transparent Proxy from the previous deployment step.
+
+```typescript
+import { getWallet } from "../utils";
+import { Deployer } from '@matterlabs/hardhat-zksync';
+import { HardhatRuntimeEnvironment } from "hardhat/types";
+
+export default async function (hre: HardhatRuntimeEnvironment) {
+    const wallet = getWallet();
+    const deployer = new Deployer(hre, wallet);
+
+    // Placeholder for the deployed proxy address
+    const proxyAddress = 'YOUR_PROXY_ADDRESS_HERE';
+
+    // Upgrade the proxy to V2
+    const contractV2Artifact = await deployer.loadArtifact('CrowdfundingCampaignV2_UUPS');
+    const upgradedContract = await hre.zkUpgrades.upgradeProxy(deployer.zkWallet, proxyAddress, contractV2Artifact);
+    console.log('Successfully upgraded crowdfundingCampaign_UUPS to crowdfundingCampaignV2_UUPS');
+
+    upgradedContract.connect(deployer.zkWallet);
+    // wait some time before the next call
+    await new Promise((resolve) => setTimeout(resolve, 2000));
+
+    const durationInSeconds = 30 * 24 * 60 * 60; // For example, setting a 30-day duration
+
+    const initTx = await upgradedContract.initializeV2(durationInSeconds);
+    const receipt = await initTx.wait();
+
+    console.log('CrowdfundingCampaignV2_UUPS initialized!', receipt.hash);
+}
+```
+
+**Key Components:**
+
+- **`upgradeProxy`:** A critical method from the `hre.zkUpgrades` module that
+performs the contract upgrade. It takes the wallet, the proxy address, and the
+new contract artifact as arguments to transition the proxy to use the `CrowdfundingCampaignV2_UUPS` logic.
+
+- **`initializeV2`:** Post-upgrade, this function is invoked to initialize the new
+variables or logic introduced in `CrowdfundingCampaignV2_UUPS`. In this example,
+it sets a new campaign duration, illustrating how contract upgrades can add
+functionalities without losing the existing state or funds.
+
+Execute the test command corresponding to your package manager:
+
+::code-group
+
+```bash [npm]
+npm run hardhat deploy-zksync --script upgrade-scripts/upgradeUUPSCrowdfundingCampaign.ts
+```
+
+```bash [yarn]
+yarn hardhat deploy-zksync --script upgrade-scripts/upgradeUUPSCrowdfundingCampaign.ts
+```
+
+```bash [pnpm]
+pnpm run hardhat deploy-zksync --script upgrade-scripts/upgradeUUPSCrowdfundingCampaign.ts
+```
+
+```bash [bun]
+bun run hardhat deploy-zksync --script upgrade-scripts/upgradeUUPSCrowdfundingCampaign.ts
+```
+
+::
+
+Upon successful deployment, you'll receive output detailing the upgrade process,
+including the new beacon address, and transaction hash:
+
+```bash
+Contract successfully upgraded to 0x9BE22706966D717d7b0C8aEC99A1a9d1b3bFeC50 with tx 0x24ad582828b23b98d207ec7c057cd6a9c911bea22dbe85e0affd7479b00d90e9
+Successfully upgraded crowdfundingCampaign_UUPS to crowdfundingCampaignV2_UUPS
+CrowdfundingCampaignV2_UUPS initialized! 0xab959f588b64dc6dee1e94d5fa0da2ae205c7438cf097d26d3ba73690e2b09e8
+```
+
+---
+
+## Verify upgradable contracts
+
+To verify our upgradable contracts we need to the proxy address we previously used in our upgrade script.
+With that execute the following command:
+
+::code-group
+
+```bash [npm]
+npm run hardhat verify <PROXY-ADDRESS>
+```
+
+```bash [yarn]
+yarn hardhat verify <PROXY-ADDRESS>
+```
+
+```bash [pnpm]
+pnpm run hardhat verify <PROXY-ADDRESS>
+```
+
+```bash [bun]
+bun run hardhat verify <PROXY-ADDRESS>
+```
+
+::
+
+Upon successful verification, you'll receive output detailing the verification process:
+
+```bash
+Verifying implementation: 0x9BE22706966D717d7b0C8aEC99A1a9d1b3bFeC50
+Your verification ID is: 10618
+Contract successfully verified on zkSync block explorer!
+Verifying proxy: 0x91921fDb0F8942c18eCeE4E3896b369ca0650483
+Your verification ID is: 10619
+Contract successfully verified on zkSync block explorer!
+```
+
+🎉 Congratulations! The `CrowdfundingCampaignV2_UUPS` contract has been upgraded and verified!
diff --git a/content/10.quick-start/_upgrading/_uups_contract_upgradability.md b/content/10.quick-start/_upgrading/_uups_contract_upgradability.md
new file mode 100644
index 00000000..44c6049a
--- /dev/null
+++ b/content/10.quick-start/_upgrading/_uups_contract_upgradability.md
@@ -0,0 +1,35 @@
+---
+title: UUPS Proxy Contract Upgradeability
+---
+
+### What is a UUPS upgradeable contract?
+UUPS (Universal Upgradeable Proxy Standard) Upgradeable Contracts embed the upgrade logic
+within the contract itself, simplifying upgrades and enhancing security. The components are:
+
+1. **Proxy Contract**: Contains minimal logic, primarily delegating calls to the implementation
+contract. Unlike other proxies, it doesn't require a separate upgrade function.
+1. **Implementation Contract**: Houses the business logic and the upgrade functionality,
+enabling the contract to upgrade itself from within.
+1. **Admin Role**: Assigned to an entity with the authority to initiate upgrades, ensuring
+controlled access to the upgrade function.
+
+In UUPS contracts, upgrades are performed by invoking the upgrade function within the
+implementation contract, which updates the proxy's reference to point to a new implementation.
+This self-contained approach minimizes the proxy's complexity and gas costs, while the
+implementation contract's built-in upgrade mechanism ensures only authorized upgrades.
+The contract's state remains intact across upgrades, facilitating continuous improvement
+with a stable user experience.
+
+---
+
+::content-switcher
+---
+items: [{
+  label: 'Hardhat',
+  partial: '_upgrading/_uups/_hardhat_uups_contract_upgradability'
+}, {
+  label: 'Foundry',
+  partial: '_upgrading/_uups/_foundry_uups_contract_upgradability'
+}]
+---
+::
diff --git a/content/90.contributing-to-documentation/30.documentation-styleguide.md b/content/90.contributing-to-documentation/30.documentation-styleguide.md
index af681990..7312f895 100644
--- a/content/90.contributing-to-documentation/30.documentation-styleguide.md
+++ b/content/90.contributing-to-documentation/30.documentation-styleguide.md
@@ -119,14 +119,14 @@ A callout should not contain anything essential to understanding the main conten
 
 #### Example
 ::callout{icon="i-heroicons-exclamation-triangle" color="amber"}
-This is a `callout` with full **markdown** support. It can be used to link to [another page](/getting-started/installation).
+This is a `callout` with full **markdown** support. It can be used to link to [another page](/quick-start).
 ::
 
 #### Code
 
 ```md
 ::callout{icon="i-heroicons-exclamation-triangle" color="amber"}
-This is a `callout` with full **markdown** support. It can be used to link to [another page](/getting-started/installation).
+This is a `callout` with full **markdown** support. It can be used to link to [another page](/quick-start).
 ::
 ```
 
@@ -180,12 +180,12 @@ in the `ui.icons.collections` property.
 ## Links
 
 Internal links are generated by the `/content` directory structure and the name of the markdown file.
-For example, the file `/content/10.getting-started/20.overview.md` is defined as the path `/getting-started/overview`.
+For example, the file `/content/1.quick-start/2.deploy-contract.md` is defined as the path `/quick-start/deploy-contract`.
 
 Link to internal pages using markdown format.
 
 ```md
-[Getting Started](/getting-started/overview)
+[Getting Started](/quick-start)
 ```
 
 ### Anchor Tags
@@ -195,7 +195,7 @@ Link to the page the anchor point is located in and add
 the name of the anchor tag separated by dashes.
 
 ```md
-[Getting Started](/getting-started/overview#learn-more)
+[Getting Started](/quick-start)
 ```
 
 ### External Links
diff --git a/content/_partials/_compile-solidity-contracts.md b/content/_partials/_compile-solidity-contracts.md
new file mode 100644
index 00000000..27e6d4fa
--- /dev/null
+++ b/content/_partials/_compile-solidity-contracts.md
@@ -0,0 +1,28 @@
+---
+title: Compile Solidity Contract
+---
+
+Smart contracts deployed to zkSync must be compiled using our custom compiler.
+`zksolc` is the compiler used for Solidity.
+
+To compile the contracts in a project, run the following command:
+
+::code-group
+
+```bash [npm]
+npm run compile
+```
+
+```bash [yarn]
+yarn compile
+```
+
+```bash [pnpm]
+pnpm run compile
+```
+
+```bash [bun]
+bun run compile
+```
+
+::
diff --git a/content/_partials/_environment-setup-with-foundry.md b/content/_partials/_environment-setup-with-foundry.md
new file mode 100644
index 00000000..7829370c
--- /dev/null
+++ b/content/_partials/_environment-setup-with-foundry.md
@@ -0,0 +1,17 @@
+---
+title: Foundry-zksync Installation
+---
+
+::callout{icon="i-heroicons-information-circle-16-solid" color="amber"}
+`foundry-zksync` is still in an alpha stage, so some features might not be fully supported
+yet and may not work as fully intended. It is open-sourced and contributions are welcomed.
+::
+<!-- TODO: @dutterbutter
+Need to update to include prerequisite of Foundry installation
+This should be a simple curl request but needs to be setup by devops  -->
+
+Run the following command in your terminal to create a new Foundry project using `foundry-zksync`.
+
+  ```sh
+  forge init --template https://github.com/dutterbutter/zksync-foundry-quickstart-guide
+  ```
diff --git a/content/_partials/setting-up-your-wallet.md b/content/_partials/setting-up-your-wallet.md
deleted file mode 100644
index 31817176..00000000
--- a/content/_partials/setting-up-your-wallet.md
+++ /dev/null
@@ -1,9 +0,0 @@
----
-title: Setting up your wallet
----
-
-Here's how to setup your wallet, follow the instructions below:
-
-1. Download wallet
-2. ???
-3. Profit
diff --git a/content/index.yml b/content/index.yml
index a86206b1..0769ee37 100644
--- a/content/index.yml
+++ b/content/index.yml
@@ -15,7 +15,7 @@ hero:
     - label: Start building on zkSync
       icon: i-heroicons-arrow-right-20-solid
       trailing: true
-      to: '/getting-started'
+      to: '/quick-start'
       size: lg
     # - label: Use this template
     #   icon: i-simple-icons-github
diff --git a/cspell-config/cspell-blockchain.txt b/cspell-config/cspell-blockchain.txt
index 51c929a7..cbeb9ae1 100644
--- a/cspell-config/cspell-blockchain.txt
+++ b/cspell-config/cspell-blockchain.txt
@@ -3,6 +3,13 @@ EVM
 ethereum
 keccak
 merkle
+upgradability
+Initializable
+initializable
+UUPS
+merkle
+uups
+Sepolia
 Weth
 Geth
 gwei
diff --git a/cspell-config/cspell-dev.txt b/cspell-config/cspell-dev.txt
index eeecf5c2..3f79c14c 100644
--- a/cspell-config/cspell-dev.txt
+++ b/cspell-config/cspell-dev.txt
@@ -14,3 +14,22 @@ Vue
 
 // devs
 dutterbutter
+zksolc
+zkvyper
+ZKEVM
+zkout
+nomicfoundation
+Nuxt
+nuxi
+nuxt
+nuxtdotjs
+nuxtjs
+!NuxtUI
+!NuxtContent
+NVMe
+rocksdb
+Vue
+!vue
+
+// devs
+dutterbutter
diff --git a/cspell-config/cspell-zksync.txt b/cspell-config/cspell-zksync.txt
index 411022fc..57a020f8 100644
--- a/cspell-config/cspell-zksync.txt
+++ b/cspell-config/cspell-zksync.txt
@@ -4,3 +4,9 @@ MatterLabs
 zkSync
 zksync
 zksync-cli
+Zeek
+MatterLabs
+zkSync
+zksync
+zksync-cli
+zksync
\ No newline at end of file
diff --git a/nuxt.config.ts b/nuxt.config.ts
index 1393e068..0bb7baff 100644
--- a/nuxt.config.ts
+++ b/nuxt.config.ts
@@ -3,7 +3,15 @@ import { zksyncIcons } from './assets/zksync-icons';
 // https://nuxt.com/docs/api/configuration/nuxt-config
 export default defineNuxtConfig({
   extends: ['@nuxt/ui-pro'],
-  modules: ['@nuxt/content', '@nuxt/ui', '@nuxt/fonts', '@nuxthq/studio', 'nuxt-og-image'],
+  modules: [
+    '@nuxt/content',
+    '@nuxt/ui',
+    '@nuxt/fonts',
+    '@nuxthq/studio',
+    'nuxt-og-image',
+    'nuxt-headlessui',
+    '@nuxt/devtools',
+  ],
   hooks: {
     // Define `@nuxt/ui` components as global to use them in `.md` (feel free to add those you need)
     'components:extend': (components) => {
diff --git a/package.json b/package.json
index 02d16b01..caa80a62 100644
--- a/package.json
+++ b/package.json
@@ -7,6 +7,7 @@
   "author": "Matter Labs",
   "homepage": "https://zksync.io",
   "devDependencies": {
+    "@nuxt/devtools": "^1.1.5",
     "@nuxt/eslint-config": "^0.2.0",
     "@nuxthq/studio": "^1.0.13",
     "@types/bun": "^1.0.8",
@@ -21,6 +22,7 @@
     "husky": "^9.0.11",
     "markdownlint": "^0.33.0",
     "markdownlint-cli2": "^0.12.1",
+    "nuxt-headlessui": "^1.2.0",
     "particles.vue3": "^2.12.0",
     "prettier": "^3.1.0",
     "prettier-eslint": "^16.1.2",
@@ -34,6 +36,7 @@
   "dependencies": {
     "@iconify-json/heroicons": "^1.1.20",
     "@iconify-json/simple-icons": "^1.1.95",
+    "@iconify-json/zondicons": "^1.1.8",
     "@nuxt/content": "^2.12.1",
     "@nuxt/fonts": "^0.3.0",
     "@nuxt/ui-pro": "^1.0.2",