Refocus smart contracts docs on REVM/Solidity

.ai/categories/reference.md

@@ -279,9 +279,9 @@ Polkadot Cloud is a platform for deploying resilient, customizable and scalable
 
 Polkadot Hub is a Layer 1 platform that serves as the primary entry point to the Polkadot ecosystem, providing essential functionality without requiring parachain deployment. It offers core services including smart contracts, identity management, staking, governance, and interoperability with other ecosystems, making it simple and fast for both builders and users to get started in Web3.
 
-## PolkaVM
+## PVM
 
-PolkaVM is a custom virtual machine optimized for performance, leveraging a RISC-V-based architecture to support Solidity and any language that compiles to RISC-V. It is specifically designed for the Polkadot ecosystem, enabling smart contract deployment and execution.
+The Polkadot Virtual Machine (PVM) is a custom virtual machine optimized for performance, leveraging a RISC-V-based architecture to support Solidity and any language that compiles to RISC-V. It is specifically designed for the Polkadot ecosystem, enabling smart contract deployment and execution.
 
 ## Relay Chain
 

.ai/pages/node-infrastructure-run-a-node-polkadot-hub-rpc.md

@@ -9,9 +9,7 @@ url: https://docs.polkadot.com/node-infrastructure/run-a-node/polkadot-hub-rpc/
 
 ## Introduction
 
-Polkadot Hub is the gateway to the Polkadot network, providing access to core services such as asset management, governance, and cross-chain messaging. Running your own RPC node gives developers and applications direct access to these services while also supporting infrastructure tasks like block indexing and SDK tool compatibility.
-
-
+[Polkadot Hub](/reference/polkadot-hub/){target=\_blank} is the gateway to the Polkadot network, providing access to core services such as asset management, governance, and cross-chain messaging. Running your own RPC node gives developers and applications direct access to these services while also supporting infrastructure tasks like block indexing and SDK tool compatibility.
 
 Through the Polkadot SDK node RPC (WebSocket port 9944, HTTP port 9933), your node serves as the bridge between the network and applications. This page guides you through setting up a node from scratch, including hardware requirements and deployment options using Docker or systemd.
 

.ai/pages/node-infrastructure-run-a-validator-staking-mechanics-rewards.md

@@ -17,8 +17,7 @@ This guide explains the payout scheme, factors influencing rewards, and how mult
 
 The Polkadot ecosystem measures its reward cycles in a unit called an era. Kusama eras are approximately 6 hours long, and Polkadot eras are 24 hours long. At the end of each era, validators are paid proportionally to the amount of era points they have collected. Era points are reward points earned for payable actions like:
 
-- Issuing validity statements for parachain blocks.
-
+- Issuing validity statements for [parachain blocks](/reference/parachains/blocks-transactions-fees/blocks/){target=\_blank}.
 - Producing a non-uncle block in the relay chain.
 - Producing a reference to a previously unreferenced uncle block.
 - Producing a referenced uncle block.

.ai/pages/parachains-customize-runtime-add-smart-contract-functionality.md

@@ -13,18 +13,18 @@ When building your custom blockchain with the Polkadot SDK, you can add smart co
 
 This guide covers three approaches to adding smart contracts to your blockchain:
 
-- **[`pallet-revive`](#pallet-revive)**: Modern unified solution supporting both PolkaVM and EVM bytecode
+- **[`pallet-revive`](#pallet-revive)**: Modern unified solution supporting both PVM and EVM bytecode
 - **[Frontier](#frontier)**: Ethereum compatibility layer for Polkadot SDK-based chains
 - **[`pallet-contracts`](#pallet-contracts-legacy)**: Wasm smart contract support
 
 ## pallet-revive
 
-[`pallet-revive`](https://github.com/paritytech/polkadot-sdk/tree/master/substrate/frame/revive){target=\_blank} is the modern smart contract solution for Polkadot SDK-based chains. It provides a unified execution environment that supports both PolkaVM and EVM bytecode through dual execution backends.
+[`pallet-revive`](https://github.com/paritytech/polkadot-sdk/tree/master/substrate/frame/revive){target=\_blank} is the modern smart contract solution for Polkadot SDK-based chains. It provides a unified execution environment that supports both PVM and EVM bytecode through dual execution backends.
 
 ### Core Components
 
 **Essential Pallet:**
-**[`pallet-revive`](https://github.com/paritytech/polkadot-sdk/tree/master/substrate/frame/revive){target=\_blank}** provides the core smart contract execution environment with [PolkaVM](https://github.com/polkadot-developers/polkadot-docs/blob/71e1b51bb42ef55e20c2f3b953db86e8c26cd591/smart-contracts/for-eth-devs/dual-vm-stack.md#upgrade-to-polkavm){target=\_blank} and [REVM](https://github.com/polkadot-developers/polkadot-docs/blob/71e1b51bb42ef55e20c2f3b953db86e8c26cd591/smart-contracts/for-eth-devs/dual-vm-stack.md#migrate-from-evm){target=\_blank} backends.
+**[`pallet-revive`](https://github.com/paritytech/polkadot-sdk/tree/master/substrate/frame/revive){target=\_blank}** provides the core smart contract execution environment with [PVM](https://github.com/polkadot-developers/polkadot-docs/blob/71e1b51bb42ef55e20c2f3b953db86e8c26cd591/smart-contracts/for-eth-devs/dual-vm-stack.md#upgrade-to-polkavm){target=\_blank} and [REVM](https://github.com/polkadot-developers/polkadot-docs/blob/71e1b51bb42ef55e20c2f3b953db86e8c26cd591/smart-contracts/for-eth-devs/dual-vm-stack.md#migrate-from-evm){target=\_blank} backends.
 
 **RPC Adapter:**
 **[`pallet-revive-eth-rpc`](https://crates.io/crates/pallet-revive-eth-rpc){target=\_blank}** adds full Ethereum RPC compatibility for Ethereum tooling integration.
@@ -33,25 +33,25 @@ This guide covers three approaches to adding smart contracts to your blockchain:
 
 `pallet-revive` accepts smart contracts from multiple languages and compilation paths:
 
-| Language | Compiler | Output Bytecode | Execution Backend |
-|----------|----------|-----------------|-------------------|
-| Solidity | `resolc` | PolkaVM | PolkaVM |
-| Solidity | `solc` | EVM | REVM |
-| Rust (ink!) | `cargo-contract` | PolkaVM | PolkaVM | 
+| Language    | Compiler         | Output Bytecode | Execution Backend |
+|-------------|------------------|-----------------|-------------------|
+| Solidity    | `resolc`         | PVM             | PVM               |
+| Solidity    | `solc`           | EVM             | REVM              |
+| Rust (ink!) | `cargo-contract` | PVM             | PVM               |
 
-Any language that can compile to PolkaVM bytecode and utilize `pallet-revive`'s host functions (via [`pallet-revive-uapi`](https://paritytech.github.io/polkadot-sdk/master/pallet_revive_uapi/index.html){target=\_blank}) is supported.
+Any language that can compile to PVM bytecode and utilize `pallet-revive`'s host functions (via [`pallet-revive-uapi`](https://paritytech.github.io/polkadot-sdk/master/pallet_revive_uapi/index.html){target=\_blank}) is supported.
 
 ### How It Works
 
 **Dual Execution Model:**
 
-1. **PolkaVM Backend**: Executes PolkaVM bytecode with native performance optimization.
+1. **PVM Backend**: Executes PVM bytecode with native performance optimization.
 2. **REVM Backend**: Implements EVM bytecode for compatibility with existing Ethereum contracts, ensuring seamless migration.
 
 ### Key Benefits
 
-- **Unified platform**: Deploys both PolkaVM-optimized and EVM-compatible contracts using a single pallet.
-- **Performance**: PolkaVM execution provides improved performance compared to the traditional EVM, leveraging the [RISC-V](https://en.wikipedia.org/wiki/RISC-V){target=\_blank} architecture to map instructions to the CPU and requires little transpiling.
+- **Unified platform**: Deploys both PVM-optimized and EVM-compatible contracts using a single pallet.
+- **Performance**: PVM execution provides improved performance compared to the traditional EVM, leveraging the [RISC-V](https://en.wikipedia.org/wiki/RISC-V){target=\_blank} architecture to map instructions to the CPU and requires little transpiling.
 - **Ethereum compatibility**: Supports full integration with Ethereum tooling via RPC adapter.
 
 ### Implementation Examples

.ai/pages/parachains-customize-runtime-pallet-development-pallet-testing.md

@@ -31,9 +31,7 @@ Before you begin, ensure you:
 
 ## Understanding FRAME Testing Tools
 
-[FRAME](https://paritytech.github.io/polkadot-sdk/master/polkadot_sdk_docs/polkadot_sdk/frame_runtime/index.html){target=\_blank} provides specialized testing macros and utilities that make pallet testing more efficient.
-
-
+[FRAME (Framework for Runtime Aggregation of Modularized Entities)](/reference/glossary/#frame-framework-for-runtime-aggregation-of-modularized-entities){target=\_blank} provides specialized testing macros and utilities that make pallet testing more efficient.
 
 ### Assertion Macros
 

.ai/pages/parachains-customize-runtime.md

@@ -9,9 +9,7 @@ url: https://docs.polkadot.com/parachains/customize-runtime/
 
 ## Introduction
 
-A blockchain runtime is more than just a fixed set of rules—it's a dynamic foundation that you can shape to match your specific needs. With Polkadot SDK's [FRAME (Framework for Runtime Aggregation of Modularized Entities)](https://paritytech.github.io/polkadot-sdk/master/polkadot_sdk_docs/polkadot_sdk/frame_runtime/index.html){target=\_blank}, customizing your runtime is straightforward and modular. Instead of building everything from scratch, you combine pre-built pallets with your own custom logic to create a runtime suited to your blockchain's purpose.
-
-
+A blockchain runtime is more than just a fixed set of rules—it's a dynamic foundation that you can shape to match your specific needs. With Polkadot SDK's [FRAME (Framework for Runtime Aggregation of Modularized Entities)](/reference/glossary/#frame-framework-for-runtime-aggregation-of-modularized-entities){target=\_blank}, customizing your runtime is straightforward and modular. Instead of building everything from scratch, you combine pre-built pallets with your own custom logic to create a runtime suited to your blockchain's purpose.
 
 This overview explains how runtime customization works, introduces the building blocks you'll use, and guides you through the key patterns for extending your runtime.
 

.ai/pages/parachains-interoperability-get-started.md

@@ -83,9 +83,7 @@ The message consists of three instructions described as follows:
 
     The first instruction takes as an input the MultiAsset that should be withdrawn. The MultiAsset describes the native parachain token with the `Here` keyword. The `amount` parameter is the number of tokens that are transferred. The withdrawal account depends on the origin of the message. In this example the origin of the message is Alice. The `WithdrawAsset` instruction moves `amount` number of native tokens from Alice's account into the holding register.
 
-- **[BuyExecution](https://github.com/polkadot-fellows/xcm-format?tab=readme-ov-file#buyexecution){target=\_blank}**: Allocates fees to cover the execution weight of the XCM instructions.
-
-
+- **[BuyExecution](https://github.com/polkadot-fellows/xcm-format?tab=readme-ov-file#buyexecution){target=\_blank}**: Allocates fees to cover the execution [weight](/reference/glossary/#weight){target=\_blank} of the XCM instructions.
 
     ```rust
         BuyExecution { 

.ai/pages/parachains-launch-a-parachain-deploy-to-polkadot.md

@@ -100,9 +100,7 @@ Ensure that this command is executed twice to generate the keys for both the acc
 
 ## Generate the Chain Specification
 
-Polkadot SDK-based parachains are defined by a file called the chain specification, or chain spec for short. There are two types of chain spec files:
-
-
+Polkadot SDK-based parachains are defined by a file called the [chain specification](/reference/glossary/#chain-specification){target=\_blank}, or chain spec for short. There are two types of chain spec files:
 
 - **Plain chain spec**: A human-readable JSON file that can be modified to suit your parachain's requirements. It serves as a template for initial configuration and includes human-readable keys and structures.
 - **Raw chain spec**: A binary-encoded file used to start your parachain node. This file is generated from the plain chain spec and contains the encoded information necessary for the parachain node to synchronize with the blockchain network. It ensures compatibility across different runtime versions by providing data in a format directly interpretable by the node's runtime, regardless of upgrades since the chain's genesis.

.ai/pages/parachains-runtime-maintenance-unlock-parachains.md

@@ -96,8 +96,7 @@ You can identify your parachain's sovereign account using either of these method
 
         - For parent/child chains use the prefix `0x70617261` (which decodes to `b"para"`).
 
-    2. Encode your parachain ID as a u32 SCALE value:
-
+    2. Encode your parachain ID as a u32 [SCALE](/reference/parachains/data-encoding/#data-types){target=\_blank} value:
 
         - For parachain 2006, this would be `d6070000`.
 

.ai/pages/reference-glossary.md

@@ -275,9 +275,9 @@ Polkadot Cloud is a platform for deploying resilient, customizable and scalable
 
 Polkadot Hub is a Layer 1 platform that serves as the primary entry point to the Polkadot ecosystem, providing essential functionality without requiring parachain deployment. It offers core services including smart contracts, identity management, staking, governance, and interoperability with other ecosystems, making it simple and fast for both builders and users to get started in Web3.
 
-## PolkaVM
+## PVM
 
-PolkaVM is a custom virtual machine optimized for performance, leveraging a RISC-V-based architecture to support Solidity and any language that compiles to RISC-V. It is specifically designed for the Polkadot ecosystem, enabling smart contract deployment and execution.
+The Polkadot Virtual Machine (PVM) is a custom virtual machine optimized for performance, leveraging a RISC-V-based architecture to support Solidity and any language that compiles to RISC-V. It is specifically designed for the Polkadot ecosystem, enabling smart contract deployment and execution.
 
 ## Relay Chain
 

.ai/pages/reference-polkadot-hub-smart-contracts.md

@@ -39,8 +39,8 @@ With PVM, developers can:
 
 PolkaVM delivers maximum performance for computationally intensive contracts, offering a native, high-throughput option for Ethereum-style developers on Polkadot Hub.
 
-!!! smartcontract "PolkaVM Preview Release"
-    PolkaVM smart contracts with Ethereum compatibility are in **early-stage development and may be unstable or incomplete**.
+!!! smartcontract "PVM Preview Release"
+    PVM smart contracts with Ethereum compatibility are in **early-stage development and may be unstable or incomplete**.
 ## Where to Go Next
 
 <div class="grid cards" markdown>

.ai/pages/smart-contracts-cookbook-smart-contracts-.deploy-basic-pvm.md

@@ -1,6 +1,6 @@
 ---
 title: Deploy a Basic Contract to Polkadot Hub
-description: Learn how to deploy a basic smart contract to Polkadot Hub using the PolkaVM.
+description: Learn how to deploy a basic smart contract to Polkadot Hub using the PVM.
 categories: Smart Contracts
 url: https://docs.polkadot.com/smart-contracts/cookbook/smart-contracts/.deploy-basic-pvm/
 ---
@@ -9,9 +9,9 @@ url: https://docs.polkadot.com/smart-contracts/cookbook/smart-contracts/.deploy-
 
 ## Introduction
 
-Deploying smart contracts to [Polkadot Hub](/smart-contracts/overview/#smart-contract-development){target=\_blank} can be accomplished through various tools and environments, each suited to different development workflows. This guide demonstrates how to deploy a basic PolkaVM (PVM) smart contract using four popular approaches: JavaScript with [Ethers.js](https://docs.ethers.org/v6/){target=\_blank}, [Remix IDE](https://remix.live/){target=\_blank}, [Hardhat](https://hardhat.org/){target=\_blank}, and [Foundry](https://getfoundry.sh/){target=\_blank}.
+Deploying smart contracts to [Polkadot Hub](/smart-contracts/overview/#smart-contract-development){target=\_blank} can be accomplished through various tools and environments, each suited to different development workflows. This guide demonstrates how to deploy a basic PVM smart contract using four popular approaches: JavaScript with [Ethers.js](https://docs.ethers.org/v6/){target=\_blank}, [Remix IDE](https://remix.live/){target=\_blank}, [Hardhat](https://hardhat.org/){target=\_blank}, and [Foundry](https://getfoundry.sh/){target=\_blank}.
 
-All these tools leverage the `revive` compiler to transform Solidity smart contracts into PolkaVM bytecode, making them compatible with Polkadot Hub's native smart contract environment. Whether you prefer working with lightweight JavaScript libraries, visual browser-based IDEs, comprehensive development frameworks, or fast command-line toolkits, this guide covers the deployment process for each approach.
+All these tools leverage the `revive` compiler to transform Solidity smart contracts into PVM bytecode, making them compatible with Polkadot Hub's native smart contract environment. Whether you prefer working with lightweight JavaScript libraries, visual browser-based IDEs, comprehensive development frameworks, or fast command-line toolkits, this guide covers the deployment process for each approach.
 
 **Prerequisites:**
 
@@ -463,7 +463,7 @@ This guide has demonstrated four different approaches to deploying smart contrac
 - **Hardhat**: Perfect for professional workflows requiring comprehensive testing and debugging
 - **Foundry**: Excellent for developers who prefer fast, command-line driven development
 
-All approaches use the `resolc` compiler to generate PolkaVM-compatible bytecode, ensuring your contracts run natively on Polkadot Hub. Choose the tool that best fits your workflow and project requirements.
+All approaches use the `resolc` compiler to generate PVM-compatible bytecode, ensuring your contracts run natively on Polkadot Hub. Choose the tool that best fits your workflow and project requirements.
 
 ### Next Steps
 

.ai/pages/smart-contracts-cookbook-smart-contracts-deploy-erc20-erc20-hardhat.md

@@ -1,6 +1,6 @@
 ---
 title: Deploy an ERC-20 Using Hardhat
-description: Deploy an ERC-20 token on Polkadot Hub using PolkaVM. This guide covers contract creation, compilation, deployment, and interaction via Hardhat.
+description: Deploy an ERC-20 token on Polkadot Hub using PVM. This guide covers contract creation, compilation, deployment, and interaction via Hardhat.
 categories: Basics, Smart Contracts
 url: https://docs.polkadot.com/smart-contracts/cookbook/smart-contracts/deploy-erc20/erc20-hardhat/
 ---