0xPolygon · nadimkobeissi · Nov 27, 2023 · Nov 28, 2023 · Nov 28, 2023 · Nov 28, 2023
diff --git a/.github/workflows/dev_deployment.yml b/.github/workflows/dev_deployment.yml
@@ -0,0 +1,74 @@
+name: Docs Dev Deployment
+on:
+  push:
+    branches: ['dev']
+  workflow_dispatch:
+
+jobs:
+  deploy_staging:
+    name: Dev Deployment
+    permissions:
+      id-token: write
+      contents: write
+    environment: dev
+    runs-on: ubuntu-latest
+    env:
+      AWS_REGION: eu-west-1
+      ECR_REPOSITORY: docs-dev-ecr
+      ECS_SERVICE: docs-dev-ecs-service
+      ECS_CLUSTER: frontend-dev-ecs-cluster
+      ECS_TASK_DEFINITION: dev-taskdef.json
+      CONTAINER_NAME: docs-dev
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+        with:
+          submodules: true
+
+      - name: Configure AWS credentials
+        uses: aws-actions/configure-aws-credentials@v1-node16
+        with:
+          aws-region: ${{ env.AWS_REGION }}
+          role-to-assume: arn:aws:iam::605436358845:role/docs-dev-GithubActionsRole
+          role-session-name: GithubActionsSession
+
+      - name: Login to Amazon ECR
+        id: login-ecr
+        uses: aws-actions/amazon-ecr-login@v1
+
+      - name: Use Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.11'
+
+      - name: pip Install
+        run: pip install -r requirements.txt --no-cache-dir
+
+      - name: Build mkdocs
+        run: mkdocs build
+
+      - name: Build, tag, and push image to Amazon ECR
+        id: build-image
+        env:
+          ECR_REGISTRY: ${{ steps.login-ecr.outputs.registry }}
+          IMAGE_TAG: ${{ github.sha }}
+        run: |
+          docker build -t $ECR_REGISTRY/$ECR_REPOSITORY:$IMAGE_TAG -f Dockerfile.nginx .
+          docker push $ECR_REGISTRY/$ECR_REPOSITORY:$IMAGE_TAG
+          echo "image=$ECR_REGISTRY/$ECR_REPOSITORY:$IMAGE_TAG" >> $GITHUB_OUTPUT
+
+      - name: Fill in the new image ID in the Amazon ECS task definition
+        id: task-def
+        uses: aws-actions/amazon-ecs-render-task-definition@v1
+        with:
+          task-definition: ${{ env.ECS_TASK_DEFINITION }}
+          container-name: ${{ env.CONTAINER_NAME }}
+          image: ${{ steps.build-image.outputs.image }}
+
+      - name: Deploy Amazon ECS task definition
+        uses: aws-actions/amazon-ecs-deploy-task-definition@v1
+        with:
+          task-definition: ${{ steps.task-def.outputs.task-definition }}
+          service: ${{ env.ECS_SERVICE }}
+          cluster: ${{ env.ECS_CLUSTER }}
+          wait-for-service-stability: true
diff --git a/.github/workflows/main_to_dev_merge.yml b/.github/workflows/main_to_dev_merge.yml
@@ -0,0 +1,21 @@
+name: Merge Main to Dev
+
+on:
+  schedule:
+    - cron: '0 0 * * *'  # Run daily at midnight UTC
+
+jobs:
+  merge:
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v2
+
+    - name: Merge Main to Dev
+      run: |
+        git checkout dev
+        git pull origin dev
+        git fetch origin main
+        git merge origin/main --no-edit
+        git push origin dev
diff --git a/.github/workflows/prod_deployment.yml b/.github/workflows/prod_deployment.yml
@@ -0,0 +1,81 @@
+name: Prod Deployment
+
+on:
+  workflow_dispatch:
+    inputs:
+      stage:
+        description: 'Stage to deploy (production)'
+        required: true
+      run_production:
+        description: 'Staging deployment completed (yes, no)'
+        required: true
+
+jobs:
+  deploy_prod:
+    name: Prod Deployment
+    permissions:
+      id-token: write
+      contents: write
+    environment: prod
+    runs-on: ubuntu-latest
+    if: github.event_name == 'workflow_dispatch' && github.event.inputs.stage == 'production' && github.event.inputs.run_production == 'yes'
+    env:
+      AWS_REGION: eu-west-1
+      ECR_REPOSITORY: docs-ecr
+      ECS_SERVICE: docs-ecs-service
+      ECS_CLUSTER: frontend-prod-ecs-cluster
+      ECS_TASK_DEFINITION: prod-taskdef.json
+      CONTAINER_NAME: docs
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+        with:
+          submodules: true
+
+      - name: Configure AWS credentials
+        uses: aws-actions/configure-aws-credentials@v1-node16
+        with:
+          aws-region: ${{ env.AWS_REGION }}
+          role-to-assume: arn:aws:iam::042947190491:role/docs-GithubActionsRole
+          role-session-name: GithubActionsSession
+
+      - name: Login to Amazon ECR
+        id: login-ecr
+        uses: aws-actions/amazon-ecr-login@v1
+
+      - name: Use Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.11'
+
+      - name: pip Install
+        run: pip install -r requirements.txt --no-cache-dir
+
+      - name: Build mkdocs
+        run: mkdocs build
+
+      - name: Build, tag, and push image to Amazon ECR
+        id: build-image
+        env:
+          ECR_REGISTRY: ${{ steps.login-ecr.outputs.registry }}
+          IMAGE_TAG: ${{ github.sha }}
+        run: |
+          docker build -t $ECR_REGISTRY/$ECR_REPOSITORY:$IMAGE_TAG -f Dockerfile.nginx .
+          docker push $ECR_REGISTRY/$ECR_REPOSITORY:$IMAGE_TAG
+          echo "image=$ECR_REGISTRY/$ECR_REPOSITORY:$IMAGE_TAG" >> $GITHUB_OUTPUT
+
+      - name: Fill in the new image ID in the Amazon ECS task definition
+        id: task-def
+        uses: aws-actions/amazon-ecs-render-task-definition@v1
+        with:
+          task-definition: ${{ env.ECS_TASK_DEFINITION }}
+          container-name: ${{ env.CONTAINER_NAME }}
+          image: ${{ steps.build-image.outputs.image }}
+
+      - name: Deploy Amazon ECS task definition
+        uses: aws-actions/amazon-ecs-deploy-task-definition@v1
+        with:
+          task-definition: ${{ steps.task-def.outputs.task-definition }}
+          service: ${{ env.ECS_SERVICE }}
+          cluster: ${{ env.ECS_CLUSTER }}
+          wait-for-service-stability: true
diff --git a/.github/workflows/staging_deployment.yml b/.github/workflows/staging_deployment.yml
@@ -0,0 +1,74 @@
+name: Staging Deployment
+on:
+  push:
+    branches: ['main']
+  workflow_dispatch:
+
+jobs:
+  deploy_staging:
+    name: Staging Deployment
+    permissions:
+      id-token: write
+      contents: write
+    environment: staging
+    runs-on: ubuntu-latest
+    env:
+      AWS_REGION: eu-west-1
+      ECR_REPOSITORY: docs-staging-ecr
+      ECS_SERVICE: docs-staging-ecs-service
+      ECS_CLUSTER: frontend-staging-ecs-cluster
+      ECS_TASK_DEFINITION: staging-taskdef.json
+      CONTAINER_NAME: docs-staging
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+        with:
+          submodules: true
+
+      - name: Configure AWS credentials
+        uses: aws-actions/configure-aws-credentials@v1-node16
+        with:
+          aws-region: ${{ env.AWS_REGION }}
+          role-to-assume: arn:aws:iam::070528468658:role/docs-staging-GithubActionsRole
+          role-session-name: GithubActionsSession
+
+      - name: Login to Amazon ECR
+        id: login-ecr
+        uses: aws-actions/amazon-ecr-login@v1
+
+      - name: Use Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.11'
+
+      - name: pip Install
+        run: pip install -r requirements.txt --no-cache-dir
+
+      - name: Build mkdocs
+        run: mkdocs build
+
+      - name: Build, tag, and push image to Amazon ECR
+        id: build-image
+        env:
+          ECR_REGISTRY: ${{ steps.login-ecr.outputs.registry }}
+          IMAGE_TAG: ${{ github.sha }}
+        run: |
+          docker build -t $ECR_REGISTRY/$ECR_REPOSITORY:$IMAGE_TAG -f Dockerfile.nginx .
+          docker push $ECR_REGISTRY/$ECR_REPOSITORY:$IMAGE_TAG
+          echo "image=$ECR_REGISTRY/$ECR_REPOSITORY:$IMAGE_TAG" >> $GITHUB_OUTPUT
+
+      - name: Fill in the new image ID in the Amazon ECS task definition
+        id: task-def
+        uses: aws-actions/amazon-ecs-render-task-definition@v1
+        with:
+          task-definition: ${{ env.ECS_TASK_DEFINITION }}
+          container-name: ${{ env.CONTAINER_NAME }}
+          image: ${{ steps.build-image.outputs.image }}
+
+      - name: Deploy Amazon ECS task definition
+        uses: aws-actions/amazon-ecs-deploy-task-definition@v1
+        with:
+          task-definition: ${{ steps.task-def.outputs.task-definition }}
+          service: ${{ env.ECS_SERVICE }}
+          cluster: ${{ env.ECS_CLUSTER }}
+          wait-for-service-stability: true
diff --git a/Dockerfile.nginx b/Dockerfile.nginx
@@ -0,0 +1,14 @@
+#Serve the app with NGINX
+FROM nginx:alpine
+
+# Copy the build files from the build folder to /usr/share/nginx/html
+COPY site /usr/share/nginx/html
+
+#Replace default nginx.conf with custom configuration
+COPY nginx.conf /etc/nginx/conf.d/default.conf
+
+# Expose the desired port (default is 80 for NGINX)
+EXPOSE 80
+
+# Start NGINX
+CMD ["nginx", "-g", "daemon off;"]
diff --git a/dev-taskdef.json b/dev-taskdef.json
@@ -0,0 +1,95 @@
+{
+	"requiresCompatibilities": [
+		"FARGATE"
+	],
+	"inferenceAccelerators": [],
+	"containerDefinitions": [{
+		"dnsSearchDomains": null,
+		"environmentFiles": [],
+		"entryPoint": null,
+		"portMappings": [{
+			"hostPort": 80,
+			"protocol": "tcp",
+			"containerPort": 80
+		}],
+		"command": null,
+		"linuxParameters": null,
+		"cpu": 0,
+		"environment": null,
+		"resourceRequirements": null,
+		"ulimits": null,
+		"dnsServers": null,
+		"mountPoints": null,
+		"workingDirectory": null,
+		"secrets": null,
+		"dockerSecurityOptions": null,
+		"memory": null,
+		"memoryReservation": null,
+		"volumesFrom": null,
+		"stopTimeout": null,
+		"image": "test",
+		"startTimeout": null,
+		"firelensConfiguration": null,
+		"dependsOn": null,
+		"disableNetworking": null,
+		"interactive": null,
+		"healthCheck": null,
+		"essential": true,
+		"links": null,
+		"hostname": null,
+		"extraHosts": null,
+		"pseudoTerminal": null,
+		"user": null,
+		"readonlyRootFilesystem": null,
+		"dockerLabels": null,
+		"systemControls": null,
+		"privileged": null,
+		"name": "docs-dev",
+		"repositoryCredentials": {
+			"credentialsParameter": ""
+		}
+	}],
+	"volumes": [],
+	"networkMode": "awsvpc",
+	"memory": "1024",
+	"cpu": "512",
+	"executionRoleArn": "arn:aws:iam::605436358845:role/docs-dev-TaskRole",
+	"family": "docs-dev-taskdefinition",
+	"taskRoleArn": "arn:aws:iam::605436358845:role/docs-dev-TaskRole",
+	"runtimePlatform": {
+		"operatingSystemFamily": "LINUX"
+	},
+	"tags": [{
+			"key": "Role",
+			"value": "frontend-application"
+		},
+		{
+			"key": "ParentService",
+			"value": "docs-dev"
+		},
+		{
+			"key": "Environment",
+			"value": "dev"
+		},
+		{
+			"key": "Service",
+			"value": "docs-dev.polygon.technology"
+		},
+		{
+			"key": "Host",
+			"value": "AWS"
+		},
+		{
+			"key": "IAC",
+			"value": "terraform-workspace-aws-dev-applications-eu-west-1-apps-docs-dev-polygon-technology"
+		},
+		{
+			"key": "Team",
+			"value": "documentation"
+		},
+		{
+			"key": "Name",
+			"value": "docs-dev-taskdefinition"
+		}
+	]
+}
diff --git a/docs/img/zkvm/01L2-overview-l2-state-management.png b/docs/img/zkvm/01L2-overview-l2-state-management.png
diff --git a/docs/img/zkvm/01circom-witness-zkprover.png b/docs/img/zkvm/01circom-witness-zkprover.png
diff --git a/docs/img/zkvm/01msm-evm-components.png b/docs/img/zkvm/01msm-evm-components.png
diff --git a/docs/img/zkvm/01prf-rec-pil-stark.png b/docs/img/zkvm/01prf-rec-pil-stark.png
diff --git a/docs/img/zkvm/01pzb-polygon-zkevm-schema.png b/docs/img/zkvm/01pzb-polygon-zkevm-schema.png
diff --git a/docs/img/zkvm/02circom-overall-context.png b/docs/img/zkvm/02circom-overall-context.png
diff --git a/docs/img/zkvm/02l2-l2-state-timeline.png b/docs/img/zkvm/02l2-l2-state-timeline.png
diff --git a/docs/img/zkvm/02msm-prover-structure.png b/docs/img/zkvm/02msm-prover-structure.png
diff --git a/docs/img/zkvm/02prf-rec-simple-composition.png b/docs/img/zkvm/02prf-rec-simple-composition.png
diff --git a/docs/img/zkvm/02pzb-global-exit-tree.png b/docs/img/zkvm/02pzb-global-exit-tree.png
diff --git a/docs/img/zkvm/03circom-simple-arith-circuit.png b/docs/img/zkvm/03circom-simple-arith-circuit.png
diff --git a/docs/img/zkvm/03l2-sequencing-batches.png b/docs/img/zkvm/03l2-sequencing-batches.png
diff --git a/docs/img/zkvm/03msm-state-transition-gen-regs.png b/docs/img/zkvm/03msm-state-transition-gen-regs.png
diff --git a/docs/img/zkvm/03prf-rec-setup-phase-rec.png b/docs/img/zkvm/03prf-rec-setup-phase-rec.png
diff --git a/docs/img/zkvm/03pzb-exit-leaf-add-L1-L2.png b/docs/img/zkvm/03pzb-exit-leaf-add-L1-L2.png
diff --git a/docs/img/zkvm/04circom-batch-prover.png b/docs/img/zkvm/04circom-batch-prover.png
diff --git a/docs/img/zkvm/04msm-simple-state-transition.png b/docs/img/zkvm/04msm-simple-state-transition.png
diff --git a/docs/img/zkvm/04prf-rec-proving-phase-rec.png b/docs/img/zkvm/04prf-rec-proving-phase-rec.png
diff --git a/docs/img/zkvm/04pzb-overall-interact-bridge-scs.png b/docs/img/zkvm/04pzb-overall-interact-bridge-scs.png
diff --git a/docs/img/zkvm/05circom-forming-batch.png b/docs/img/zkvm/05circom-forming-batch.png
diff --git a/docs/img/zkvm/05l2-off-chain-on-chain-trans.png b/docs/img/zkvm/05l2-off-chain-on-chain-trans.png
diff --git a/docs/img/zkvm/05msm-addr-reg-contexts.png b/docs/img/zkvm/05msm-addr-reg-contexts.png
diff --git a/docs/img/zkvm/05prf-rec-binary-aggreg-eg.png b/docs/img/zkvm/05prf-rec-binary-aggreg-eg.png
diff --git a/docs/img/zkvm/05pzb-l2-related-scs.png b/docs/img/zkvm/05pzb-l2-related-scs.png
diff --git a/docs/img/zkvm/06circom-typical-recursive-prover.png b/docs/img/zkvm/06circom-typical-recursive-prover.png
diff --git a/docs/img/zkvm/06l2-actor-income-outcomes.png b/docs/img/zkvm/06l2-actor-income-outcomes.png
diff --git a/docs/img/zkvm/06msm-eth-state-trie.png b/docs/img/zkvm/06msm-eth-state-trie.png
diff --git a/docs/img/zkvm/06prf-rec-setup-s2c-detail.png b/docs/img/zkvm/06prf-rec-setup-s2c-detail.png
diff --git a/docs/img/zkvm/06pzb-complete-asset-flow-l1-l2.png b/docs/img/zkvm/06pzb-complete-asset-flow-l1-l2.png
diff --git a/docs/img/zkvm/07l2-batch-fee-var.png b/docs/img/zkvm/07l2-batch-fee-var.png
diff --git a/docs/img/zkvm/07msm-zkevm-state-trie.png b/docs/img/zkvm/07msm-zkevm-state-trie.png
diff --git a/docs/img/zkvm/07prf-rec-inputs-stark-verifier-circuit.png b/docs/img/zkvm/07prf-rec-inputs-stark-verifier-circuit.png
diff --git a/docs/img/zkvm/08l2-batches-below-time-target.png b/docs/img/zkvm/08l2-batches-below-time-target.png
diff --git a/docs/img/zkvm/08msm-zkevm-memory-regions.png b/docs/img/zkvm/08msm-zkevm-memory-regions.png
diff --git a/docs/img/zkvm/08prf-rec-setup-step-c2s.png b/docs/img/zkvm/08prf-rec-setup-step-c2s.png
diff --git a/docs/img/zkvm/09l2-forced-batch-seq-flow.png b/docs/img/zkvm/09l2-forced-batch-seq-flow.png
diff --git a/docs/img/zkvm/09msm-evm-zkevm-mem-align.png b/docs/img/zkvm/09msm-evm-zkevm-mem-align.png
diff --git a/docs/img/zkvm/09prf-rec-stark-prf-rec-step.png b/docs/img/zkvm/09prf-rec-stark-prf-rec-step.png
diff --git a/docs/img/zkvm/10l2-diff-trustd-virtual-state.png b/docs/img/zkvm/10l2-diff-trustd-virtual-state.png
diff --git a/docs/img/zkvm/10msm-zkevm-stack-slots.png b/docs/img/zkvm/10msm-zkevm-stack-slots.png
diff --git a/docs/img/zkvm/10prf-rec-proving-arch-outline.png b/docs/img/zkvm/10prf-rec-proving-arch-outline.png
diff --git a/docs/img/zkvm/11l2-stages-timeline-pending.png b/docs/img/zkvm/11l2-stages-timeline-pending.png
diff --git a/docs/img/zkvm/11prf-rec-build-zkevm-stark.png b/docs/img/zkvm/11prf-rec-build-zkevm-stark.png
diff --git a/docs/img/zkvm/12prf-rec-convert-verification-to-circuit.png b/docs/img/zkvm/12prf-rec-convert-verification-to-circuit.png
diff --git a/docs/img/zkvm/13prf-rec-convert-zkevm-verifier-to-stark.png b/docs/img/zkvm/13prf-rec-convert-zkevm-verifier-to-stark.png
diff --git a/docs/img/zkvm/14prf-rec-convert-stark-to-circuit-verifier.png b/docs/img/zkvm/14prf-rec-convert-stark-to-circuit-verifier.png
diff --git a/docs/img/zkvm/15prf-rec-convert-circuit-to-assoc-stark.png b/docs/img/zkvm/15prf-rec-convert-circuit-to-assoc-stark.png
diff --git a/docs/img/zkvm/16prf-rec-recursive2-circuit.png b/docs/img/zkvm/16prf-rec-recursive2-circuit.png
diff --git a/docs/img/zkvm/17prf-rec-stark-to-circuit-recursive2.png b/docs/img/zkvm/17prf-rec-stark-to-circuit-recursive2.png
diff --git a/docs/img/zkvm/18prf-rec-recursive2-circuit-2-stark.png b/docs/img/zkvm/18prf-rec-recursive2-circuit-2-stark.png
diff --git a/docs/img/zkvm/19prf-rec-recursive2-stark-to-recursivef-circuit.png b/docs/img/zkvm/19prf-rec-recursive2-stark-to-recursivef-circuit.png
diff --git a/docs/img/zkvm/20prf-rec-recursivef-circuit-2-stark.png b/docs/img/zkvm/20prf-rec-recursivef-circuit-2-stark.png
diff --git a/docs/img/zkvm/21prf-rec-recursivef-stark-to-final-circom.png b/docs/img/zkvm/21prf-rec-recursivef-stark-to-final-circom.png
diff --git a/docs/img/zkvm/22prf-rec-generation-stark-proof-for-recursivef.png b/docs/img/zkvm/22prf-rec-generation-stark-proof-for-recursivef.png
diff --git a/docs/img/zkvm/23prf-rec-generation-stark-proof-for-c12.png b/docs/img/zkvm/23prf-rec-generation-stark-proof-for-c12.png
diff --git a/docs/img/zkvm/24prf-rec-generation-stark-proof-for-recursive1.png b/docs/img/zkvm/24prf-rec-generation-stark-proof-for-recursive1.png
diff --git a/docs/img/zkvm/25prf-rec-generation-stark-proof-for-recursive2.png b/docs/img/zkvm/25prf-rec-generation-stark-proof-for-recursive2.png
diff --git a/docs/img/zkvm/26prf-rec-generation-zkevm-proof.png b/docs/img/zkvm/26prf-rec-generation-zkevm-proof.png
diff --git a/docs/img/zkvm/fib10-pil-eg-mfibonacci.png b/docs/img/zkvm/fib10-pil-eg-mfibonacci.png
diff --git a/docs/img/zkvm/fib11-pilcom-res-mfibon.png b/docs/img/zkvm/fib11-pilcom-res-mfibon.png
diff --git a/docs/img/zkvm/fib12-inside-parsed-pil.png b/docs/img/zkvm/fib12-inside-parsed-pil.png
diff --git a/docs/img/zkvm/fib13-pil-stark-setup.png b/docs/img/zkvm/fib13-pil-stark-setup.png
diff --git a/docs/img/zkvm/fib14-pil-stark-in-prover.png b/docs/img/zkvm/fib14-pil-stark-in-prover.png
diff --git a/docs/img/zkvm/fib15-pil-stark-in-verifier.png b/docs/img/zkvm/fib15-pil-stark-in-verifier.png
diff --git a/docs/img/zkvm/fib17-mfib-pil-w-pubs.png b/docs/img/zkvm/fib17-mfib-pil-w-pubs.png
diff --git a/docs/img/zkvm/fib18-non-empt-pubs-field.png b/docs/img/zkvm/fib18-non-empt-pubs-field.png
diff --git a/docs/img/zkvm/fib19-init-node-project.png b/docs/img/zkvm/fib19-init-node-project.png
diff --git a/docs/img/zkvm/fib20-dependncs-install-mfib.png b/docs/img/zkvm/fib20-dependncs-install-mfib.png
diff --git a/docs/img/zkvm/fib4-deterministic-compt.png b/docs/img/zkvm/fib4-deterministic-compt.png
diff --git a/docs/img/zkvm/fib5-design-approach-outline.png b/docs/img/zkvm/fib5-design-approach-outline.png
diff --git a/docs/img/zkvm/fib6-mfibon-sm-2-regs.png b/docs/img/zkvm/fib6-mfibon-sm-2-regs.png
diff --git a/docs/img/zkvm/fib7-mfibon-sm-3-regs.png b/docs/img/zkvm/fib7-mfibon-sm-3-regs.png
diff --git a/docs/img/zkvm/fib8-code-eg-exec-trace.png b/docs/img/zkvm/fib8-code-eg-exec-trace.png
diff --git a/docs/img/zkvm/fib9-stark-prf-sizes-times.png b/docs/img/zkvm/fib9-stark-prf-sizes-times.png
diff --git a/docs/img/zkvm/fig-micro-pro-pic.png b/docs/img/zkvm/fig-micro-pro-pic.png
diff --git a/docs/img/zkvm/fig1-zkprv-and-node.png b/docs/img/zkvm/fig1-zkprv-and-node.png
diff --git a/docs/img/zkvm/fig2-actions-sec-sm.png b/docs/img/zkvm/fig2-actions-sec-sm.png
diff --git a/docs/img/zkvm/fig3-zkNode-arch.png b/docs/img/zkvm/fig3-zkNode-arch.png
diff --git a/docs/img/zkvm/fig5-main-prts-zkpr.png b/docs/img/zkvm/fig5-main-prts-zkpr.png
diff --git a/docs/img/zkvm/gen1-typical-gen-sm.png b/docs/img/zkvm/gen1-typical-gen-sm.png
diff --git a/docs/img/zkvm/gen3-gen-sm-w-input-instrctn.png b/docs/img/zkvm/gen3-gen-sm-w-input-instrctn.png
diff --git a/docs/img/zkvm/gen4-sm-alg-processor.png b/docs/img/zkvm/gen4-sm-alg-processor.png
diff --git a/docs/img/zkvm/gen5-sm-exec-broader-contxt.png b/docs/img/zkvm/gen5-sm-exec-broader-contxt.png
diff --git a/docs/img/zkvm/gen6-pil-4instrct-prog.png b/docs/img/zkvm/gen6-pil-4instrct-prog.png
diff --git a/docs/img/zkvm/gen7-state-machine-w-zkpc.png b/docs/img/zkvm/gen7-state-machine-w-zkpc.png
diff --git a/docs/img/zkvm/gen8-end-prog-w-loop.png b/docs/img/zkvm/gen8-end-prog-w-loop.png
diff --git a/docs/img/zkvm/governance-tree.png b/docs/img/zkvm/governance-tree.png
diff --git a/docs/img/zkvm/lxly-1-v1-asset-transfer.png b/docs/img/zkvm/lxly-1-v1-asset-transfer.png
diff --git a/docs/img/zkvm/lxly-2-new-bridge-design.png b/docs/img/zkvm/lxly-2-new-bridge-design.png
diff --git a/docs/img/zkvm/lxly-3-flow-rollupmanager.png b/docs/img/zkvm/lxly-3-flow-rollupmanager.png
diff --git a/docs/img/zkvm/plook-ops-mainSM-copy.png b/docs/img/zkvm/plook-ops-mainSM-copy.png
diff --git a/docs/img/zkvm/plookup-generic-sm-pil.png b/docs/img/zkvm/plookup-generic-sm-pil.png
diff --git a/docs/img/zkvm/security-council-overview.png b/docs/img/zkvm/security-council-overview.png
diff --git a/docs/img/zkvm/tup-pattern.png b/docs/img/zkvm/tup-pattern.png
diff --git a/docs/img/zkvm/upgrade-overview.png b/docs/img/zkvm/upgrade-overview.png
diff --git a/docs/zkEVM/architecture/architecture.md b/docs/zkEVM/architecture/architecture.md
@@ -36,11 +36,12 @@ The strategic implementation of the contract-based consensus promises to ensure
 - Is **protected from malicious attacks**, especially by validators
 - Maintains a fair balance between overall validation effort and network value
 
-:::tip Good to Know
+!!!tip
+    Good to Know
+
+    Possibilities of coupling the Consensus Contract (previously called Proof of Efficiency or PoE) with a PoS (Proof of Stake) are currently being explored. A detailed description is published on the [<ins>Ethereum Research</ins>](https://ethresear.ch/t/proof-of-efficiency-a-new-consensus-mechanism-for-zk-rollups/11988) website.
 
-Possibilities of coupling the Consensus Contract (previously called Proof of Efficiency or PoE) with a PoS (Proof of Stake) are currently being explored. A detailed description is published on the [<ins>Ethereum Research</ins>](https://ethresear.ch/t/proof-of-efficiency-a-new-consensus-mechanism-for-zk-rollups/11988) website.
 
-:::
 
 ### On-chain data availability
 
@@ -57,11 +58,9 @@ Unless, among other things, the proving module can be highly accelerated to miti
 
 The underlying protocol in zkEVM ensures that the state transitions are correct by employing a validity proof. To ensure that a set of pre-determined rules have been followed for allowing state transitions, the **Consensus Contract** (`PolygonZkEVM.sol`, deployed on L1) is utilized.
 
-:::info
-
-The **Consensus Contract** is currently deployed on both [<ins>Ethereum Mainnet</ins>](https://etherscan.io/address/0x5132A183E9F3CB7C848b0AAC5Ae0c4f0491B7aB2) and [<ins>Goerli Testnet</ins>](https://goerli.etherscan.io/address/0xa997cfD539E703921fD1e3Cf25b4c241a27a4c7A).
+!!!info
+    The **Consensus Contract** is currently deployed on both [<ins>Ethereum Mainnet</ins>](https://etherscan.io/address/0x5132A183E9F3CB7C848b0AAC5Ae0c4f0491B7aB2) and [<ins>Goerli Testnet</ins>](https://goerli.etherscan.io/address/0xa997cfD539E703921fD1e3Cf25b4c241a27a4c7A).
 
-:::
 
 A smart contract verifies the validity proofs to ensure that each transition is completed correctly. This is accomplished by employing zk-SNARK circuits. A system of this type requires two processes: **transaction batching** and **transaction validation**.