Merge pull request 0xPolygon#7 from 0xPolygon/empieichO/zkevmdocs_edit

updating zkEVM 'Get started' and 'How to'

Author: kmurphypolygon

docs/tools/using-web3modal.md

@@ -0,0 +1,40 @@
+
+:::caution Risks
+
+Check the list of potential risks associated with the use of Polygon zkEVM in the [<ins>Risks FAQ</ins>](/zkevm/risk-disclosure.md) section.
+
+:::
+
+
+## Get Started with Web3Modal
+
+:::caution Content disclaimer
+
+Please view the third-party content disclaimer [<ins>here</ins>](https://github.com/0xPolygon/wiki/blob/master/CONTENT_DISCLAIMER.md).
+
+:::
+
+### Overview
+
+[<ins>Web3Modal</ins>](https://web3modal.com/) is a simple and intuitive SDK that provides a drop-in UI to enable users of any wallet to seamlessly log in to applications, offering a unified and smooth experience. It features a streamlined wallet selection interface with automatic detection of various wallet types, including mobile, extension, desktop, and web app wallets.
+
+### Code Sandbox for Polygon
+
+The Web3Modal team has prepared a [<ins>Polygon Code Sandbox</ins>](https://codesandbox.io/p/sandbox/web3modal-v3-polygon-7264l5?file=/src/main.tsx:9,19-9,50). It’s a straightforward way for developers to integrate and get hands-on experience with Polygon.
+
+### How to Integrate
+
+1. **Visit Web3Modal:** Go to [<ins>Web3Modal's official website</ins>](https://web3modal.com/) to explore its features and capabilities.
+2. **Explore the Code Sandbox:** Utilize the [<ins>Polygon Code Sandbox</ins>](https://codesandbox.io/p/sandbox/web3modal-v3-polygon-7264l5?file=/src/main.tsx:9,19-9,50) to demo and understand the integration process.
+3. **Follow the Documentation:** Refer to the provided documentation and instructions to integrate Web3Modal into your projects and leverage its features effectively.
+
+## zkEVM Support
+
+If you need help with anything related to the Polygon zkEVM, you can raise a ticket on the [Polygon Support](https://support.polygon.technology/support/tickets/new) portal, and check out the [Knowledge base](https://support.polygon.technology/support/solutions/folders/82000694871) to view the most common queries about the zkEVM. Additionally, you can reach out to the support team available on the **#zkevm-support** channel on the [Polygon Discord server](https://discord.com/invite/XvpHAxZ). Instructions for raising a zkEVM support ticket are as follows:
+
+1. Join the **Polygon Discord** server [here](https://discord.gg/0xPolygon).
+2. Accept the invite sent via DM.
+3. Take the **Member** role under **#roles**.
+4. Navigate to the **#zkevm-support** channel.
+
+You can now contact the zkEVM support staff with your questions and concerns. We will actively monitor for issues and work to resolve them as soon as possible.

docs/zkEVM/autocode-smart-contract.md

@@ -0,0 +1,40 @@
+This document explains how to automatically write a smart contract using the OpenZeppelin Wizard. The resulting smart contract code can either be integrated with Remix by Clicking the **Open in Remix** button, or copied to a clipboard and pasted in the user's intended IDE.
+
+## Getting Started
+
+Navigate to the [OpenZeppelin Wizard](https://wizard.openzeppelin.com) in your browser. First thing to notice is the **Solidity Wizard** and **Cairo Wizard** buttons.
+
+One can choose any of the following tabs to begin creating an out-of-box smart contract code in either Solidity (for EVM chains) or Cairo (useful for Starknet). These are:
+
+- **ERC20** for writing an ERC-20 token smart contract
+- **ERC721** for writing an NFT token smart contract
+- **ERC1155** for writing an ERC-1155 token smart contract
+- **Governor** for creating a DAO
+- **Custom** for writing a customized smart contract
+
+## Writing An NFT Contract
+
+For illustration purposes, we will be creating a NFT smart contract.
+
+Suppose you wanted to create a `Mintable`, `Burnable` ERC721 token and specify an appropriate license for it.
+
+1. Select the **ERC721** tab.
+
+2. Give your NFT a name and a symbol by filling the `Name` and `Symbol` fields.
+
+3. Use the check-boxes on the left to select features of your token
+
+  - Put a tick on the `Mintable` check-box
+  - Put a tick on the `Auto Increment Ids` check-box, this ensures uniqueness of each minted NFT
+  - Put a tick on the `Burnable` check-box
+  - Either leave the **default MIT license** or type the license of your choice
+
+  Notice that new lines of code are automatically written each time a feature is selected.
+
+## Voila! Contract Ready
+
+With the resulting lines of code, you now have the NFT token contract written in Solidity. As mentioned above, this source code can now be ported to an IDE of your choice or opened directly in Remix.
+
+The below figure depicts the auto-written NFT smart contract code.
+
+![The End-Product NFT Source Code](img/end-product-nft-code.png)

docs/zkEVM/bridge-to-zkevm.md

@@ -0,0 +1,44 @@
+
+:::caution Risks
+
+Check the list of potential risks associated with the use of Polygon zkEVM in the [<ins>Disclosures</ins>](/troubleshooting/risk-disclosures.md) section.
+
+:::
+
+Users can deposit assets from Ethereum and transact off-chain on Polygon zkEVM. For moving assets across chains (L1 &harr; zkEVM), you will need to use the zkEVM Bridge. The bridge interface is available for both Mainnet Beta and Testnet in the [Polygon Wallet Suite](https://wallet.polygon.technology/zkEVM/bridge). 
+
+<!-- Also, bridging can be done with the help of [MaticJS](/docs/develop/ethereum-polygon/matic-js/zkevm/initialize-zkevm/) SDK. -->
+
+The next video is a guide on how to bridge tokens from L1 to the zkEVM Testnet. The same video applies to the zkEVM Mainnet.
+
+<video loop autoplay width="100%" height="100%" controls="true" >
+  <source type="video/mp4" src="/zkEVM/img/zkevmwallettestnet.mp4"></source>
+  <p>Your browser does not support the video element.</p>
+</video>
+
+## Step-by-Step Guide
+
+Follow this step-by-step guide on how to bridge assets from Ethereum to Polygon zkEVM Mainnet and vice-versa. Or, from an Ethereum testnet to zkEVM testnet, and conversely.
+
+- On the [Polygon Wallet Suite website](https://wallet.polygon.technology/), select the zkEVM tab, which is next to the Proof-of-Stake tab:
+
+![Figure: wallet](/zkEVM/img/zkwallet-1.jpg)
+
+- Click on the **Bridge** module to access the zkEVM environment.
+
+- Set the amount of tokens to transfer from Ethereum network to zkEVM Mainnet (Or, from an Ethereum testnet to zkEVM testnet).
+
+![Figure: bridge2](/zkEVM/img/bridge2.jpg)
+
+- Recent transactions and pending transactions can be viewed on the right hand side of the page.
+- Click the `Bridge ETH to zkEVM testnet` button to proceed. This is followed by Metamask's prompt to approve gas to be spent.
+
+![Figure: metamask1](/zkEVM/img/metamask1.jpg)
+
+- Click `Confirm` to approve the bridge transaction.
+
+- And allow a few moments for your transaction to be processed.
+
+- Once it is completed, past and pending transactions can be viewed by clicking the "Transactions" button located on the left side of the menu.
+
+![Figure: tx-history](/zkEVM/img/transaction-history.jpg)

docs/zkEVM/connect-wallet.md

@@ -0,0 +1,27 @@
+
+:::caution Risks
+
+Check the list of potential risks associated with the use of Polygon zkEVM in the [<ins>Disclosures</ins>](troubleshooting/risk-disclosures.md) section.
+
+:::
+
+
+Add the **Polygon zkEVM** network to your wallet in order to interact with either the mainnet or the testnet.
+
+Navigate to `Add network` in your wallet, and enter the respective network details as given in the below table:
+
+| Network | RPC URL | ChainID | Block Explorer URL | Currency |
+| ------- | ------------------------------- | ---------------- | ---------------- | ----- |
+| Polygon zkEVM | `https://zkevm-rpc.com` | `1101` | `https://zkevm.polygonscan.com/` | **ETH** |
+| zkEVM Testnet | `https://rpc.public.zkevm-test.net` | `1442` | `https://testnet-zkevm.polygonscan.com` | **ETH** |
+
+Here is a video tutorial on **how to add Polygon zkEVM Testnet to MetaMask and deploy smart contracts**:
+
+<video loop width="100%" height="100%" controls="true" >
+  <source type="video/mp4" src="/zkEVM/img/tutorial.mp4"></source>
+  <p>Your browser does not support the video element.</p>
+</video>
+
+Once the wallet is connected, the next step is to bridge crypto assets from Ethereum to zkEVM.
+
+For testnet purposes, you can use the zkEVM faucet to get testnet tokens.