Merge branch 'main' of https://github.com/0xPolygon/polygon-docs into di/agglayer

Author: kmurphypolygon

docs/img/tools/oracles/api3/dapi-1.png

@@ -17,21 +17,21 @@ Polygon gas station has been deployed both on the Polygon mainnet & Amoy testnet
 
 You can send `GET` requests using the following URLs to fetch gas price recommendations from the gas oracle:
 
-- Amoy testnet: https://gasstation-testnet.polygon.technology/amoy
-- zkEVM Cardona: https://gasstation-testnet.polygon.technology/zkevm/cardona
+- Amoy testnet: https://gasstation.polygon.technology/amoy
+- zkEVM Cardona: https://gasstation.polygon.technology/zkevm/cardona
 
 Use the Amoy testnet below to get gas price recommendations:
 
 #### cURL
 
 ```bash
-curl https://gasstation-testnet.polygon.technology/amoy
+curl https://gasstation.polygon.technology/amoy
 ```
 
 #### JavaScript
 
 ```javascript
-fetch('https://gasstation-testnet.polygon.technology/amoy')
+fetch('https://gasstation.polygon.technology/amoy')
   .then(response => response.json())
   .then(json => console.log(json))
 ```
@@ -40,7 +40,7 @@ fetch('https://gasstation-testnet.polygon.technology/amoy')
 
 ```python
 import requests
-requests.get('https://gasstation-testnet.polygon.technology/amoy').json()
+requests.get('https://gasstation.polygon.technology/amoy').json()
 ```
 
 ### Mainnet

docs/img/tools/oracles/api3/dapi-2.png

@@ -14,7 +14,7 @@ It takes three main components of the Polygon zkEVM protocol to enable transacti
 
 ### Trusted sequencer
 
-The trusted sequencer receives L2 transactions from users, orders them, generates blocks of trasactions, fills batches, and submits them to the consensus contract's storage slots in the form of sequences.
+The trusted sequencer receives L2 transactions from users, orders them, generates blocks of transactions, fills batches, and submits them to the consensus contract's storage slots in the form of sequences.
 
 The trusted sequencer processes batches and distributes them to L2 network nodes to achieve immediate finality and reduce costs associated with high network usage, all before submitting them to L1.
 

docs/img/tools/oracles/api3/dapi-5.png

@@ -69,6 +69,8 @@ nav:
   - zkEVM:
       - zkEVM: zkEVM/index.md
       - Overview: zkEVM/overview.md
+      - Releases: 
+        - Etrog upgrade: zkEVM/architecture/protocol/etrog-upgrade.md
       - Build:
         - Get started: zkEVM/get-started/index.md
         - Quick start: zkEVM/get-started/quick-start.md
@@ -156,31 +158,29 @@ nav:
         #- Bridge service: zkEVM/architecture/high-level/bridge-service.md
       - Architecture low-level:
         - Architecture: zkEVM/architecture/index.md
-        - Upgrades:
-          - Etrog upgrade: zkEVM/architecture/protocol/etrog-upgrade.md
-        - Effective gas price:
-          - Effective gas price: zkEVM/architecture/effective-gas/index.md
-          - Effective gas price strategy: zkEVM/architecture/effective-gas/zkevm-egp-strat.md
-          - User transaction flow:
-            - User transaction flow: zkEVM/architecture/effective-gas/user-tx-flow/index.md
-            - RPC transaction flow: zkEVM/architecture/effective-gas/user-tx-flow/rpc-flow-egp.md
-            - Sequencer transaction flow: zkEVM/architecture/effective-gas/user-tx-flow/sequencer-flow-egp.md
-          - Implementing EGP strategy: zkEVM/architecture/effective-gas/implement-egp-strat.md
-          - Transaction prioritization: zkEVM/architecture/effective-gas/tx-prioritization-egp.md
         - zkEVM protocol:
           - zkEVM protocol: zkEVM/architecture/protocol/index.md
-          - State management: zkEVM/architecture/protocol/state-management.md
-          - Transaction life cycle:
-            - Submit transactions: zkEVM/architecture/protocol/transaction-life-cycle/submit-transaction.md
-            - Transaction execution: zkEVM/architecture/protocol/transaction-life-cycle/transaction-execution.md
-            - Transaction batching: zkEVM/architecture/protocol/transaction-life-cycle/transaction-batching.md
-            - Batch sequencing: zkEVM/architecture/protocol/transaction-life-cycle/batch-sequencing.md
-            - Batch aggregation: zkEVM/architecture/protocol/transaction-life-cycle/batch-aggregation.md
-          - Sequencing batches: zkEVM/architecture/protocol/sequencing-batches.md
-          - Incentive mechanism: zkEVM/architecture/protocol/incentive-mechanism.md
-          - Protocol upgradability: zkEVM/architecture/protocol/upgradability.md
+          - zkNode: zkEVM/architecture/zknode/index.md
+          - State management: 
+            - State management: zkEVM/architecture/protocol/state-management.md
+            - Transaction life cycle:
+              - Submit transactions: zkEVM/architecture/protocol/transaction-life-cycle/submit-transaction.md
+              - Transaction execution: zkEVM/architecture/protocol/transaction-life-cycle/transaction-execution.md
+              - Transaction batching: zkEVM/architecture/protocol/transaction-life-cycle/transaction-batching.md
+              - Batch sequencing: zkEVM/architecture/protocol/transaction-life-cycle/batch-sequencing.md
+              - Batch aggregation: zkEVM/architecture/protocol/transaction-life-cycle/batch-aggregation.md
+            - Sequencing batches: zkEVM/architecture/protocol/sequencing-batches.md
+            - Data streamer:
+              - Overall design: zkEVM/architecture/data-streamer/data-streamer-design.md
+              - Data streamer protocols: zkEVM/architecture/data-streamer/data-streamer-protocols.md
+              - Bookmarks: zkEVM/architecture/data-streamer/bookmarks.md
+              - Protocol messages: zkEVM/architecture/data-streamer/client-server-messages.md
+              - Stream file: zkEVM/architecture/data-streamer/stream-file.md
+              - How rollbacks work: zkEVM/architecture/data-streamer/how-rollbacks-work.md
           - Admin role and governance: zkEVM/architecture/protocol/admin-role.md
-          - Upgrade process: zkEVM/architecture/protocol/upgrade-process.md
+          - Upgrades:
+            - Protocol upgradability: zkEVM/architecture/protocol/upgradability.md
+            - Upgrade process: zkEVM/architecture/protocol/upgrade-process.md
           - Security council: zkEVM/architecture/protocol/security-council.md
           - Malfunction resistance:
             - Force batches: zkEVM/architecture/protocol/malfunction-resistance/sequencer-resistance.md
@@ -193,30 +193,20 @@ nav:
             - Updating rollups: zkEVM/architecture/protocol/unified-LxLy/ulxly-updating-rollups.md
             - Global exit trees: zkEVM/architecture/protocol/unified-LxLy/ulxly-exit-trees-node.md
             - Cross-chain exchanges: zkEVM/architecture/protocol/unified-LxLy/ulxly-interchain-exchanges.md
-        - zkNode: zkEVM/architecture/zknode/index.md
-        - Data streamer:
-          - Overall design: zkEVM/architecture/data-streamer/data-streamer-design.md
-          - Data streamer protocols: zkEVM/architecture/data-streamer/data-streamer-protocols.md
-          - Bookmarks: zkEVM/architecture/data-streamer/bookmarks.md
-          - Protocol messages: zkEVM/architecture/data-streamer/client-server-messages.md
-          - Stream file: zkEVM/architecture/data-streamer/stream-file.md
-          - How rollbacks work: zkEVM/architecture/data-streamer/how-rollbacks-work.md
-        - The proving system:
-          - Introduction: zkEVM/architecture/proving-system/intro-proving-sys.md
-          - Executor: zkEVM/architecture/proving-system/the-executor-comp.md
-          - Polynomial identity language: zkEVM/architecture/proving-system/polynom-identity-lang.md
-          - Execution trace design: zkEVM/architecture/proving-system/execution-trace-design.md
-          - Selector columns: zkEVM/architecture/proving-system/exec-selector-columns.md
-          - zkEVM and execution traces: zkEVM/architecture/proving-system/exec-trace-and-zkevm.md
-          - Using lookup tables: zkEVM/architecture/proving-system/secondary-sms-lookup-tables.md
-          - Recapitulation: zkEVM/architecture/proving-system/prover-and-verifier-recap.md
-        - L2 state tree concept: 
-          - L2 state tree concept: zkEVM/architecture/l2-state-tree/index.md
-        - Proving system inputs:
-          - Proving system inputs: zkEVM/architecture/proving-inputs/index.md
         - zkProver:
           - zkProver: zkEVM/architecture/zkprover/index.md
-          - Main state machine: 
+          - zkProver design:
+            - Introduction: zkEVM/architecture/proving-system/intro-proving-sys.md
+            - Executor: zkEVM/architecture/proving-system/the-executor-comp.md
+            - Proving system inputs: zkEVM/architecture/proving-system/proving-inputs.md
+            - Polynomial identity language: zkEVM/architecture/proving-system/polynom-identity-lang.md
+            - Execution trace design: zkEVM/architecture/proving-system/execution-trace-design.md
+            - Selector columns: zkEVM/architecture/proving-system/exec-selector-columns.md
+            - zkEVM and execution traces: zkEVM/architecture/proving-system/exec-trace-and-zkevm.md
+            - Using lookup tables: zkEVM/architecture/proving-system/secondary-sms-lookup-tables.md
+            - L2 state tree concept: zkEVM/architecture/proving-system/l2-state-tree.md
+            - Recapitulation: zkEVM/architecture/proving-system/prover-and-verifier-recap.md
+          - Main state machine:
             - Main state machine: zkEVM/architecture/zkprover/main-state-machine/index.md
             - As a processor: zkEVM/architecture/zkprover/main-state-machine/processor.md
           - STARK recursion:
@@ -247,6 +237,17 @@ nav:
             - Bits2Field state machine: zkEVM/architecture/zkprover/hashing-state-machines/bits2field-sm.md
             - Keccak-f state machine: zkEVM/architecture/zkprover/hashing-state-machines/keccakf-sm.md
             - Poseidon state machine: zkEVM/architecture/zkprover/hashing-state-machines/poseidon-sm.md
+        - Tokenomics:
+          - Incentive mechanism: zkEVM/architecture/protocol/incentive-mechanism.md
+          - Effective gas price:
+            - Effective gas price: zkEVM/architecture/effective-gas/index.md
+            - Effective gas price strategy: zkEVM/architecture/effective-gas/zkevm-egp-strat.md
+            - User transaction flow:
+              - User transaction flow: zkEVM/architecture/effective-gas/user-tx-flow/index.md
+              - RPC transaction flow: zkEVM/architecture/effective-gas/user-tx-flow/rpc-flow-egp.md
+              - Sequencer transaction flow: zkEVM/architecture/effective-gas/user-tx-flow/sequencer-flow-egp.md
+            - Implementing EGP strategy: zkEVM/architecture/effective-gas/implement-egp-strat.md
+            - Transaction prioritization: zkEVM/architecture/effective-gas/tx-prioritization-egp.md
       - Specification:
         - Specification: zkEVM/spec/index.md
         - Polynomial Identity Language: