move the admotion

0xlukem · 0xlukem · commit ef2e0fa1cac3 · 2025-06-23T16:09:26.000-03:00
diff --git a/develop/smart-contracts/libraries/viem.md b/develop/smart-contracts/libraries/viem.md
@@ -9,6 +9,8 @@ description: This guide covers deploying and interacting with contracts on Polka
 
 [viem](https://viem.sh/){target=\_blank} is a lightweight TypeScript library designed for interacting with Ethereum-compatible blockchains. This comprehensive guide will walk you through using viem to interact with and deploy smart contracts to Polkadot Hub.
 
+--8<-- 'text/smart-contracts/polkaVM-warning.md'
+
 ## Prerequisites
 
 Before getting started, ensure you have the following installed:
@@ -53,8 +55,6 @@ npm init -y
 
 Install viem along with other necessary dependencies, including [@parity/revive](https://www.npmjs.com/package/@parity/revive){target=\_blank}, which enables to compile smart contracts to [PolkaVM](/polkadot-protocol/smart-contract-basics/polkavm-design/#polkavm){target=\_blank} bytecode:
 
---8<-- 'text/smart-contracts/polkaVM-warning.md'
-
 ```bash
 # Install viem and Revive
 npm install viem @parity/revive
diff --git a/develop/smart-contracts/libraries/web3-js.md b/develop/smart-contracts/libraries/web3-js.md
@@ -14,6 +14,8 @@ Interacting with blockchains typically requires an interface between your applic
 
 This guide is intended for developers who are familiar with JavaScript and want to interact with the Polkadot Hub using Web3.js.
 
+--8<-- 'text/smart-contracts/polkaVM-warning.md'
+
 ## Prerequisites
 
 Before getting started, ensure you have the following installed:
@@ -97,8 +99,6 @@ For instance, to fetch the latest block number of the chain, you can use the fol
 
 Polkadot Hub requires contracts to be compiled to [PolkaVM](/polkadot-protocol/smart-contract-basics/polkavm-design/){target=\_blank} bytecode. This is achieved using the [`revive`](https://github.com/paritytech/revive){target=\_blank} compiler. Install the [`@parity/revive`](https://github.com/paritytech/js-revive){target=\_blank} library as a development dependency:
 
---8<-- 'text/smart-contracts/polkaVM-warning.md'
-
 ```bash
 npm install --save-dev @parity/revive
 ```
diff --git a/develop/smart-contracts/libraries/web3-py.md b/develop/smart-contracts/libraries/web3-py.md
@@ -11,6 +11,8 @@ Interacting with blockchains typically requires an interface between your applic
 
 This guide illustrates how to utilize Web3.py for interactions with Polkadot Hub.
 
+--8<-- 'text/smart-contracts/polkaVM-warning.md'
+
 ## Set Up the Project
 
 1. To start working with Web3.py, begin by initializing your project:
@@ -63,8 +65,6 @@ Before deploying your contracts, make sure you've compiled them and obtained two
 - An ABI (.json) file, which provides a JSON interface describing the contract's functions and how to interact with it
 - A bytecode (.polkavm) file, which contains the low-level machine code executable on [PolkaVM](/polkadot-protocol/smart-contract-basics/polkavm-design#polkavm){target=\_blank} that represents the compiled smart contract ready for blockchain deployment
 
---8<-- 'text/smart-contracts/polkaVM-warning.md'
-
 To follow this guide, you can use the following solidity contract as an example:
 
 ```solidity title="Storage.sol"
diff --git a/develop/smart-contracts/precompiles/index.md b/develop/smart-contracts/precompiles/index.md
@@ -11,6 +11,8 @@ Precompiles serve a dual purpose in the Polkadot ecosystem: they not only enable
 
 This article explores how Polkadot leverages precompiles within the Revive pallet to enhance efficiency and how they will extend functionality for developers in the future, including planned access to native features like Cross-Consensus Messaging (XCM).
 
+--8<-- 'text/smart-contracts/polkaVM-warning.md'
+
 ## What are Precompiles?
 
 Precompiles are special contract implementations that run directly at the runtime level rather than as on-chain PolkaVM contracts. In typical EVM environments, precompiles provide essential cryptographic and utility functionality at addresses that start with specific patterns. Revive follows this design pattern but with its own implementation optimized for PolkaVM.
@@ -37,8 +39,6 @@ flowchart LR
     classDef edgeLabel background:#eceff3;
 ```
 
---8<-- 'text/smart-contracts/polkaVM-warning.md'
-
 ## Standard Precompiles in Polkadot Hub
 
 Revive implements the standard set of Ethereum precompiles:
diff --git a/polkadot-protocol/smart-contract-basics/polkavm-design.md b/polkadot-protocol/smart-contract-basics/polkavm-design.md
@@ -9,6 +9,8 @@ description: Discover PolkaVM, a high-performance smart contract VM for Polkadot
 
 The Asset Hub smart contracts solution includes multiple components to ensure Ethereum compatibility and high performance. Its architecture allows for integration with current Ethereum tools, while its innovative virtual machine design enhances performance characteristics.
 
+--8<-- 'text/smart-contracts/polkaVM-warning.md'
+
 ## PolkaVM
 
 [**PolkaVM**](https://github.com/paritytech/polkavm){target=\_blank} is a custom virtual machine optimized for performance with [RISC-V-based](https://en.wikipedia.org/wiki/RISC-V){target=\_blank} architecture, supporting Solidity and additional high-performance languages. It serves as the core execution environment, integrated directly within the runtime. It features:
@@ -20,8 +22,6 @@ The Asset Hub smart contracts solution includes multiple components to ensure Et
 
 The interpreter remains particularly beneficial for contracts with minimal code execution, as it eliminates JIT compilation overhead and enables immediate code execution through lazy interpretation.
 
---8<-- 'text/smart-contracts/polkaVM-warning.md'
-
 ## Architecture
 
 The smart contract solution consists of the following key components that work together to enable Ethereum compatibility on Polkadot-based chains:
diff --git a/tutorials/smart-contracts/demo-aplications/deploying-uniswap-v2.md b/tutorials/smart-contracts/demo-aplications/deploying-uniswap-v2.md
@@ -11,6 +11,8 @@ Decentralized exchanges (DEXs) are a cornerstone of the DeFi ecosystem, allowing
 
 This tutorial will guide you through how Uniswap V2 works so you can take advantage of it in your projects deployed to Polkadot Hub. By understanding these contracts, you'll gain hands-on experience with one of the most influential DeFi protocols and understand how it functions across blockchain ecosystems.
 
+--8<-- 'text/smart-contracts/polkaVM-warning.md'
+
 ## Prerequisites
 
 Before starting, make sure you have:
@@ -32,8 +34,6 @@ Let's start by cloning the Uniswap V2 project:
     cd polkavm-hardhat-examples/uniswap-v2-polkadot/
     ```
 
-    --8<-- 'text/smart-contracts/polkaVM-warning.md'
-
 2. Install the required dependencies:
 
     ```bash
diff --git a/tutorials/smart-contracts/deploy-erc20.md b/tutorials/smart-contracts/deploy-erc20.md
@@ -10,10 +10,10 @@ tutorial_badge: Beginner
 
 [ERC-20](https://eips.ethereum.org/EIPS/eip-20){target=\_blank} tokens are fungible tokens commonly used for creating cryptocurrencies, governance tokens, and staking mechanisms. Polkadot Hub enables easy token deployment with Ethereum-compatible smart contracts via PolkaVM.
 
---8<-- 'text/smart-contracts/polkaVM-warning.md'
-
 This tutorial covers deploying an ERC-20 contract on the Polkadot Hub TestNet using [Polkadot Remix IDE](https://remix.polkadot.io){target=\_blank}, a web-based development tool. [OpenZeppelin's ERC-20 contracts]({{ dependencies.repositories.open_zeppelin_contracts.repository_url}}/tree/{{ dependencies.repositories.open_zeppelin_contracts.version}}/contracts/token/ERC20){target=\_blank} are used for security and compliance.
 
+--8<-- 'text/smart-contracts/polkaVM-warning.md'
+
 ## Prerequisites
 
 Before starting, make sure you have:
diff --git a/tutorials/smart-contracts/deploy-nft.md b/tutorials/smart-contracts/deploy-nft.md
@@ -10,10 +10,10 @@ tutorial_badge: Beginner
 
 Non-Fungible Tokens (NFTs) represent unique digital assets commonly used for digital art, collectibles, gaming, and identity verification. Polkadot Hub supports Ethereum-compatible smart contracts through PolkaVM, enabling straightforward NFT deployment.
 
---8<-- 'text/smart-contracts/polkaVM-warning.md'
-
 This tutorial guides you through deploying an [ERC-721](https://eips.ethereum.org/EIPS/eip-721){target=\_blank} NFT contract on the Polkadot Hub TestNet using the [Polkadot Remix IDE](https://remix.polkadot.io){target=\_blank}, a web-based development environment. To ensure security and standard compliance, it uses [OpenZeppelin's NFT contracts]({{ dependencies.repositories.open_zeppelin_contracts.repository_url}}/tree/{{ dependencies.repositories.open_zeppelin_contracts.version}}){target=\_blank} implementation.
 
+--8<-- 'text/smart-contracts/polkaVM-warning.md'
+
 ## Prerequisites
 
 Before starting, make sure you have:
diff --git a/tutorials/smart-contracts/index.md b/tutorials/smart-contracts/index.md
@@ -8,6 +8,8 @@ template: index-page.html
 
 Get started with deploying and interacting with smart contracts on Polkadot through practical, hands-on tutorials. Whether you're a beginner or an experienced developer, these guides will help you navigate the entire development lifecycle.
 
+--8<-- 'text/smart-contracts/polkaVM-warning.md'
+
 ## What to Expect from These Tutorials
 
 - **Beginner to advanced** – suitable for developers of all levels
@@ -24,8 +26,6 @@ Jump into the tutorials and learn how to:
 
 Choose a tutorial below and start coding today!
 
---8<-- 'text/smart-contracts/polkaVM-warning.md'
-
 ## In This Section
 
 :::INSERT_IN_THIS_SECTION:::
diff --git a/tutorials/smart-contracts/launch-your-first-project/create-dapp-ethers-js.md b/tutorials/smart-contracts/launch-your-first-project/create-dapp-ethers-js.md
@@ -12,6 +12,8 @@ Decentralized applications (dApps) have become a cornerstone of the Web3 ecosyst
 
 In this tutorial, you'll build a complete dApp that interacts with a smart contract deployed on the Polkadot Hub TestNet. It will use [Ethers.js](/develop/smart-contracts/libraries/ethers-js){target=\_blank} to interact with the blockchain and [Next.js](https://nextjs.org/){target=\_blank} as the frontend framework. By the end of this tutorial, you'll have a functional dApp that allows users to connect their wallets, read data from the blockchain, and execute transactions.
 
+--8<-- 'text/smart-contracts/polkaVM-warning.md'
+
 ## Prerequisites
 
 Before you begin, make sure you have:
@@ -182,5 +184,4 @@ To get started right away with a working example, you can clone the repository a
 ```
 git clone https://github.com/polkadot-developers/polkavm-storage-contract-dapps.git -b v0.0.2
 cd polkavm-storage-contract-dapps/ethers-dapp
-```
---8<-- 'text/smart-contracts/polkaVM-warning.md'
+```
diff --git a/tutorials/smart-contracts/launch-your-first-project/create-dapp-viem.md b/tutorials/smart-contracts/launch-your-first-project/create-dapp-viem.md
@@ -10,6 +10,8 @@ Decentralized applications (dApps) are a key component of the Web3 ecosystem, en
 
 This tutorial will guide you through building a fully functional dApp that interacts with a smart contract on Polkadot Hub. You'll use [Viem](https://viem.sh/){target=\_blank} for blockchain interactions and [Next.js](https://nextjs.org/){target=\_blank} for the frontend. By the end, you'll have a dApp that lets users connect their wallets, retrieve on-chain data, and execute transactions.
 
+--8<-- 'text/smart-contracts/polkaVM-warning.md'
+
 ## Prerequisites
 
 Before getting started, ensure you have the following:
@@ -204,8 +206,6 @@ git clone https://github.com/polkadot-developers/polkavm-storage-contract-dapps.
 cd polkavm-storage-contract-dapps/viem-dapp
 ```
 
---8<-- 'text/smart-contracts/polkaVM-warning.md'
-
 ## Where to Go Next
 
 <div class="grid cards" markdown>
diff --git a/tutorials/smart-contracts/launch-your-first-project/test-and-deploy-with-hardhat.md b/tutorials/smart-contracts/launch-your-first-project/test-and-deploy-with-hardhat.md
@@ -10,6 +10,8 @@ tutorial_badge: Intermediate
 
 After creating a smart contract, the next crucial steps are testing and deployment. Proper testing ensures your contract behaves as expected, while deployment makes your contract available on the blockchain. This tutorial will guide you through using Hardhat, a popular development environment, to test and deploy the `Storage.sol` contract you created in the [Create a Smart Contract](/tutorials/smart-contracts/launch-your-first-project/create-contracts/){target=\_blank} tutorial. For more information about Hardhat usage, check the [Hardhat guide](/develop/smart-contracts/dev-environments/hardhat/){target=\_blank}.
 
+--8<-- 'text/smart-contracts/polkaVM-warning.md'
+
 ## Prerequisites
 
 Before starting, make sure you have:
@@ -71,8 +73,6 @@ Let's start by setting up Hardhat for your Storage contract project:
     - `localNode` - runs a PolkaVM instance on `http://127.0.0.1:8545` for local development and testing
     - `passetHub` - connects to the the Polkadot Hub TestNet network using a predefined RPC URL and a private key stored in environment variables
 
-    --8<-- 'text/smart-contracts/polkaVM-warning.md'
-
 7. Export your private key and save it in your Hardhat environment:
 
     ```bash
