zkEVM - Adding new doc

Author: EmpieichO

docs/img/cdk/high-level-architecture/bridging-class-diagram.png

@@ -2,78 +2,99 @@
 comments: true
 ---
 
-Polygon Faucet is a tool provided by Polygon and ecosystem partners, such as Alchemy and Quicknode, that allows you to obtain free MATIC tokens on the testnets and get started with the Polygon network. These test tokens enable you to work with Polygon features without having to spend actual MATIC tokens on the mainnet.
+The Polygon Faucet is a tool provided by Polygon and ecosystem partners like Alchemy, QuickNode, and GetBlock. It enables developers to acquire free MATIC/ETH test tokens on the PoS Amoy and zkEVM Cardona testnets. Start deploying and testing your dApps on the Polygon network with test tokens that allow you to explore Polygon features without spending actual MATIC tokens on the mainnet.
 
-Additionally, you can also receive Polygon zkEVM testnet ETH on Polygon Faucet.
+Polygon Faucet drips:
 
-!!! info
-      Tokens on testnet networks like Amoy, Sepolia, and Cardona have no value as they are only used for testing purposes.
+- MATIC on PoS Amoy and Ethereum Sepolia.
+- Test ETH on zkEVM Cardona.
 
-We have listed several faucet tools you can use to receive MATIC testnet tokens in the sections below:
+!!! info "Testnet tokens hold no real-world value"
+      Tokens on testnets such as PoS Amoy, Ethereum Sepolia, and zkEVM Cardona hold no real value and are solely used for testing purposes.
 
-- [Polygon faucet](https://faucet.polygon.technology/)
-- [Alchemy Polygon Amoy MATIC faucet](https://www.alchemy.com/faucets/polygon-amoy)
-- [QuickNode Polygon faucet](https://faucet.quicknode.com/polygon)
+Several faucet tools are available to receive test MATIC and ETH on Sepolia-anchored Polygon networks:
 
-In addition, the faucet also has Polygon zkEVM testnet ETH tokens.
+|          Faucet          | Supported networks                                                                                                    |
+| :----------------------: | --------------------------------------------------------------------------------------------------------------------- |
+|      Polygon Faucet      | [zkEVM Cardona, PoS Amoy, Ethereum Sepolia](https://faucet.polygon.technology)                                                 |
+|         Alchemy Faucet         | [PoS Amoy](https://www.alchemy.com/faucets/polygon-amoy) \| [Ethereum Sepolia](https://www.alchemy.com/faucets/ethereum-sepolia) |
+| QuickNode Polygon Faucet | [PoS Amoy](https://faucet.quicknode.com/polygon/amoy)                                                                 |
+|     GetBlock Faucet      | [PoS Amoy](https://getblock.io/faucet/matic-amoy/) \| [Ethereum Sepolia](https://getblock.io/faucet/eth-sepolia)                 |  
 
-## Polygon faucet
+## Polygon Faucet
 
-- Navigate to [faucet.polygon.technology](https://faucet.polygon.technology/).
+- Start by navigating to [faucet.polygon.technology](https://faucet.polygon.technology/) and connecting/verifying your Discord by selecting **Connect Discord** in the top-right corner of the page.
 
-   ![img](../../img/tools/gas/faucet.png)
+   <center>
+   ![img](../../img/tools/gas/faucet.png){width=70%}
+   </center>
 
-- Select one of the blockchain testnet networks:
+- Select one of the blockchain testnet networks from the drop-down list:
 
-      - Polygon zkEVM (Cardona) testnet
-      - Sepolia Ethereum testnet
-      - Amoy Polygon PoS testnet
+      - **Polygon zkEVM (Cardona)**
+      - **Polygon PoS Amoy (Amoy)**
+      - **Sepolia**
 
 - Select the type of token you want to receive:
 
-      - **zkEVM ETH**: Testnet ETH on the Cardona testnet.
-      - **MATIC token**: Testnet MATIC on the Amoy and Sepolia testnets.
+      - **zkEVM ETH**: Testnet ETH on zkEVM Cardona.
+      - **MATIC**: Testnet MATIC on the PoS Amoy and Ethereum Sepolia.
 
-- Once done, copy your wallet address and click on **Paste** to paste it in the text box. Typing is disabled to prevent entering a wrong address. 
+- Once done, copy your wallet address and select **Paste** to paste it in the text box. Typing is disabled to prevent entering a wrong address. 
 
-- Click on the **Submit** button. 
+- Select **Submit**. 
 
-- Click **Confirm** to finalize the transaction. Recheck the details.
+- Verify the details and select **Confirm** to finalize the transaction.
 
-   ![img](../../img/tools/gas/confirm-transaction.png)
+   <center>
+   ![img](../../img/tools/gas/confirm-transaction.png){width=50%}
+   </center>
 
 !!! danger
 
       If you don't have enough MATIC testnet tokens in your account to pay for the gas fees, the transaction may fail. If you require testnet tokens in bulk, please fill out [this form](https://docs.google.com/forms/d/e/1FAIpQLSe4npoGldJknEs9EBtPaV3AS-0HTso2IuMWDCiMmLEMCx8euQ/viewform).
 
 - Testnet tokens usually arrive within 1 to 2 minutes.
 
-   ![img](../../img/tools/gas/success.png)
+   <center>
+   ![img](../../img/tools/gas/success.png){width=50%}
+   </center>
 
-## Alchemy MATIC faucet
+## Alchemy Faucet
 
-!!! tip "GET 0.5 Amoy MATIC"
+!!! tip "Get 0.5 Amoy MATIC"
       If you sign up or log in with an Alchemy account, you get 0.5 MATIC per day. Without an account, you get 0.2.
 
 - You can request MATIC tokens from Alchemy's Amoy Faucet. In order to receive testnet tokens, head over to the [Alchemy Polygon Amoy MATIC faucet](https://www.alchemy.com/faucets/polygon-amoy), enter your wallet address and hit the **Send Me MATIC** button.
 
    ![img](../../img/tools/gas/alchemy-faucet1.png)
 
-- Check the transaction hash as soon as you finish requesting your MATIC, and view the transaction details on [Polygonscan](https://mumbai.polygonscan.com/).
+- Check the transaction hash as soon as you finish requesting your MATIC, and view the transaction details on [Polygonscan](https://amoy.polygonscan.com/).
 
 ## QuickNode Polygon Faucet
 
 In order to receive Amoy MATIC tokens using QuickNode faucet,
 
-- Head over to the [QuickNode Polygon Faucet](https://faucet.quicknode.com/polygon). Connect your Coinbase, MetaMask or Phantom wallet by clicking on **Connect Wallet**. Select **Amoy** and click **Continue**.
+- Head over to the [QuickNode Polygon Faucet](https://faucet.quicknode.com/polygon). Connect your Coinbase, MetaMask, or Phantom wallet by clicking on **Connect Wallet**. Then, choose **Amoy**, and finally select **Continue**.
 
-   ![img](../../img/tools/gas/quicknode-faucet2.png)
+   <center>
+   ![img](../../img/tools/gas/quicknode-faucet2.png){width=80%}
+   </center>
 
-   !!! tip "Get 2x MATIC"
-      If you tweet the [drip faucet URL](https://faucet.quicknode.com/drip) along with your wallet address, you get 2X more MATIC testnet tokens.
+!!! tip "Get 2x MATIC"
+      Tweet the [drip faucet URL](https://faucet.quicknode.com/drip) with your wallet address to get *twice* as many MATIC testnet tokens.
 
-- You can also view your transaction details on [Polygonscan](https://mumbai.polygonscan.com/) by clicking on the TxHash.
+- Click on the transaction hash to view transaction details on [Polygonscan](https://amoy.polygonscan.com/).
 
-!!! tip "Join the Polygon Discord community"
+## GetBlock Polygon Faucet
 
-      Make sure to connect with the [Polygon Discord community](https://discord.gg/0xPolygon) for news, tips, and help.
+Head over to the [GetBlock Polygon Faucet](https://getblock.io/faucet/matic-amoy/) to acquire Amoy MATIC tokens using the GetBlock faucet.
+
+Please register or login to request free testnet tokens.
+
+!!! tip "Get additional tokens" 
+    If you tweet about the [GetBlock Faucet](https://getblock.io/faucet/matic-amoy/), you can claim additional PoS Amoy testnet tokens.
+
+## Discord community
+
+Make sure to connect with the [Polygon Discord community](https://discord.gg/0xPolygon) for news, tips, and help.

docs/img/cdk/high-level-architecture/exit-root-class-diagram.png

@@ -1,3 +1,5 @@
+![Polygon Solidity smart contract bridging architecture](../../../../img/cdk/high-level-architecture/bridging-class-diagram.png)
+
 The unified bridge transfers assets and messages between networks (L1, L2) by calling bridge and claim functions on the [PolygonZkEVMBridgeV2.sol](https://github.com/0xPolygonHermez/zkevm-contracts/blob/main/contracts/v2/PolygonZkEVMBridgeV2.sol) contract whose deployment address is an [upgradeable proxy](https://etherscan.io/address/0x2a3DD3EB832aF982ec71669E178424b10Dca2EDe#code). Interaction with the actual contract happens via the proxy.
 
 This contract is deployed on L1 and there is also one deployed on every L2 network. It communicates closely with an exit root manager contract specific to L1 or L2.

docs/img/cdk/high-level-architecture/smart-contracts-full-view.png

@@ -1,3 +1,7 @@
+The class diagram below describes how the exit root contracts communicate with the bridge and the rollup manager.
+
+![Polygon Solidity smart contract bridging architecture](../../../../img/cdk/high-level-architecture/exit-root-class-diagram.png)
+
 An exit tree is a binary, append-only, sparse Merkle tree (SMT) whose leaf nodes store bridging data. The exit trees have a depth of 32.
 
 The Merkle root of an exit tree is known as the exit tree root, and it is the fingerprint of all the information recorded in the exit tree's leaf nodes. 

docs/tools/gas/matic-faucet.md

@@ -2,13 +2,11 @@
 comments: true
 ---
 
-<!-- https://excalidraw.com/#json=JKZp9QEihifF_B7Z41Dfv,FVNhqQKi9PA1jM0kzUoCsQ" -->
-
 ## Polygon smart contract architecture
 
 Chain stacks at the node level direct transaction data to the L2 and L1 networks via smart contract calls. The system stores state in binary tree structures containing verifiable local and global exit roots.
 
-The diagram below details the Polygon Solidity smart contract architecture. 
+The diagram below details the Polygon Solidity smart contract architecture minus the bridging contracts. 
 
 ![Polygon Solidity smart contract architecture](../../../../img/cdk/high-level-architecture/smart-contracts-full-view.png)
 
@@ -39,6 +37,10 @@ The [PolygonRollupManager.sol](https://github.com/0xPolygonHermez/zkevm-contract
 
 ## Bridge 
 
+The class diagram below describes the unified bridge interactions.
+
+![Polygon Solidity smart contract bridging architecture](../../../../img/cdk/high-level-architecture/bridging-class-diagram.png)
+
 The unified bridge contract [PolygonZkEVMBridgeV2.sol](https://github.com/0xPolygonHermez/zkevm-contracts/blob/main/contracts/v2/PolygonZkEVMBridgeV2.sol) is responsible for bridging and claiming activity across L1 and L2 chains. 
 
 <center>
@@ -49,6 +51,10 @@ In the L1 network, the bridge also manages the complex exit root mechanism gover
 
 ## Global exit roots
 
+The class diagram below describes the exit root interactions.
+
+![Polygon Solidity smart contract bridging architecture](../../../../img/cdk/high-level-architecture/exit-root-class-diagram.png)
+
 System state as a whole is stored on binary trees with data and/or exit roots written into their leaves. 
 
 Local updates at the leaf-level trigger exit root updates at the top of the trees which are then available to the global exit root trees and the consensus contracts via the L1 bridge contract.