Skip to content

Commit a20832f

Browse files
committed
Refocus smart contracts overview on Solidity/REVM
Rewrite overview to position Polkadot Hub as a Solidity platform with full Ethereum compatibility via REVM. De-prioritize PVM to a brief note and remove ink! references.
1 parent f82857b commit a20832f

File tree

13 files changed

+211
-221
lines changed

13 files changed

+211
-221
lines changed

.ai/categories/basics.md

Lines changed: 19 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -2224,49 +2224,48 @@ Page Title: Smart Contracts Overview
22242224
22252225
- Source (raw): https://raw.githubusercontent.com/polkadot-developers/polkadot-docs/master/.ai/pages/smart-contracts-overview.md
22262226
- Canonical (HTML): https://docs.polkadot.com/smart-contracts/overview/
2227-
- Summary: Learn about smart contract development on Polkadot Hub with native PVM support, dual-VM execution, and seamless cross-chain capabilities.
2227+
- Summary: Learn about smart contract development on Polkadot Hub with full Ethereum compatibility, Solidity support, and seamless cross-chain capabilities.
22282228
22292229
# Smart Contracts on Polkadot Hub
22302230
22312231
## Introduction
22322232
2233-
Polkadot Hub provides a production-ready smart contract platform that combines Ethereum compatibility with the performance and cross-chain capabilities of the Polkadot ecosystem. Developers can deploy smart contracts directly on Polkadot Hub while using familiar Ethereum tooling, workflows, and programming languages.
2234-
2235-
Built with a dual-VM approach, Polkadot Hub offers two execution backends: REVM for unmodified EVM compatibility and native PVM for optimized computationally expensive workloads. This dual-VM architecture enables developers to migrate existing Ethereum contracts instantly or optimize for speed and efficiency with native execution.
2233+
Polkadot Hub is a production-ready Solidity smart contract platform that brings full Ethereum compatibility to the Polkadot ecosystem. Deploy your existing Ethereum contracts without modifications, use familiar tools like Hardhat and Remix, and gain access to Polkadot's cross-chain capabilities.
22362234
22372235
## Why Build on Polkadot Hub
22382236
2239-
### Ethereum Compatibility
2237+
### Full Ethereum Compatibility
22402238
2241-
Deploy existing Ethereum contracts with zero modifications while maintaining full compatibility with your existing development stack:
2239+
Polkadot Hub runs the REVM (Rust Ethereum Virtual Machine) backend, providing complete EVM compatibility. Your Solidity contracts work exactly as they do on Ethereum:
22422240
2241+
- **Zero modifications required**: Deploy existing Ethereum contracts directly without any code changes.
22432242
- **Complete JSON-RPC API support**: Use MetaMask, Hardhat, Remix, Foundry, and all standard Ethereum tooling.
22442243
- **Standard libraries**: Integrate Ethers.js, Web3.js, Viem, Wagmi, and Web3.py without changes.
2245-
- **Solidity development**: Write contracts in Solidity or migrate existing code directly.
2244+
- **Solidity development**: Write contracts in Solidity using the same patterns and best practices you already know.
22462245
- **Familiar workflows**: Maintain your existing deployment, testing, and monitoring processes.
22472246
2248-
### Performance Options
2249-
2250-
Choose between two execution backends:
2247+
### Cross-Chain Capabilities
22512248
2252-
- **REVM**: Run unmodified Ethereum contracts with full EVM/Ethereum compatibility.
2253-
- **PVM**: Compile to optimized RISC-V bytecode for enhanced performance and lower fees while keeping Ethereum-compatibility.
2249+
Smart contracts on Polkadot Hub can interact with any service in the Polkadot ecosystem through [XCM](/smart-contracts/precompiles/xcm/){target=\_blank}, enabling:
22542250
2255-
Both backends share the same RPC interface and tooling support, allowing seamless transitions. In addition, smart contracts can interact with Polkadot native services via [precompile contracts](/smart-contracts/precompiles/){target=\_blank}.
2251+
- Token transfers across parachains
2252+
- Remote execution on other chains
2253+
- Cross-chain composability without bridges or intermediaries
22562254
2257-
### Cross-VM & Cross-Chain Capabilities
2255+
### Native Polkadot Integration
22582256
2259-
Smart contracts written for one VM (for example, EVM) can interact directly with other smart contracts written for the RISC-V PVM, and back. This allows to use full EVM compatible contracts but extend to heavy/complex execution workloads to the PVM RISC-V backend.
2257+
Access Polkadot-native functionality directly from your Solidity contracts via [precompiles](/smart-contracts/precompiles/){target=\_blank}, including asset management, staking operations, and cross-chain messaging.
22602258
2261-
Furthermore, all smart contracts in Polkadot Hub can interact with any service in the Polkadot ecosystem through [XCM](/smart-contracts/precompiles/xcm/){target=\_blank}, enabling token transfers, remote execution, and cross-chain composability without bridges or intermediaries.
2259+
!!! note
2260+
Polkadot Hub also supports PVM (Polkadot Virtual Machine) as an alternative execution backend for advanced use cases.
22622261
22632262
## Other Smart Contract Environments
22642263
2265-
Beyond Polkadot Hub's native PVM support, the ecosystem offers two main alternatives for smart contract development:
2266-
2267-
- **EVM-compatible parachains**: Provide access to Ethereum's extensive developer ecosystem, smart contract portability, and established tooling like Hardhat, Remix, Foundry, and OpenZeppelin. The main options include Moonbeam (the first full Ethereum-compatible parachain serving as an interoperability hub), Astar (featuring dual VM support for both EVM and WebAssembly contracts), and Acala (DeFi-focused with enhanced Acala EVM+ offering advanced DeFi primitives).
2264+
Beyond Polkadot Hub, the ecosystem offers EVM-compatible parachains that provide access to Ethereum's extensive developer ecosystem with established tooling like Hardhat, Remix, Foundry, and OpenZeppelin:
22682265
2269-
- **Rust (ink!)**: ink! is a Rust-based framework that can compile to PVM. It uses [`#[ink(...)]`](https://use.ink/docs/v6/macros-attributes/){target=\_blank} attribute macros to create Polkadot SDK-compatible PVM bytecode, offering strong memory safety from Rust, an advanced type system, high-performance PVM execution, and platform independence with sandboxed security.
2266+
- **Moonbeam**: The first full Ethereum-compatible parachain, serving as an interoperability hub.
2267+
- **Astar**: Features dual VM support for both EVM and WebAssembly contracts.
2268+
- **Acala**: DeFi-focused with enhanced Acala EVM+ offering advanced DeFi primitives.
22702269
22712270
## Next Steps
22722271

.ai/categories/dapps.md

Lines changed: 19 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -3405,49 +3405,48 @@ Page Title: Smart Contracts Overview
34053405
34063406
- Source (raw): https://raw.githubusercontent.com/polkadot-developers/polkadot-docs/master/.ai/pages/smart-contracts-overview.md
34073407
- Canonical (HTML): https://docs.polkadot.com/smart-contracts/overview/
3408-
- Summary: Learn about smart contract development on Polkadot Hub with native PVM support, dual-VM execution, and seamless cross-chain capabilities.
3408+
- Summary: Learn about smart contract development on Polkadot Hub with full Ethereum compatibility, Solidity support, and seamless cross-chain capabilities.
34093409
34103410
# Smart Contracts on Polkadot Hub
34113411
34123412
## Introduction
34133413
3414-
Polkadot Hub provides a production-ready smart contract platform that combines Ethereum compatibility with the performance and cross-chain capabilities of the Polkadot ecosystem. Developers can deploy smart contracts directly on Polkadot Hub while using familiar Ethereum tooling, workflows, and programming languages.
3415-
3416-
Built with a dual-VM approach, Polkadot Hub offers two execution backends: REVM for unmodified EVM compatibility and native PVM for optimized computationally expensive workloads. This dual-VM architecture enables developers to migrate existing Ethereum contracts instantly or optimize for speed and efficiency with native execution.
3414+
Polkadot Hub is a production-ready Solidity smart contract platform that brings full Ethereum compatibility to the Polkadot ecosystem. Deploy your existing Ethereum contracts without modifications, use familiar tools like Hardhat and Remix, and gain access to Polkadot's cross-chain capabilities.
34173415
34183416
## Why Build on Polkadot Hub
34193417
3420-
### Ethereum Compatibility
3418+
### Full Ethereum Compatibility
34213419
3422-
Deploy existing Ethereum contracts with zero modifications while maintaining full compatibility with your existing development stack:
3420+
Polkadot Hub runs the REVM (Rust Ethereum Virtual Machine) backend, providing complete EVM compatibility. Your Solidity contracts work exactly as they do on Ethereum:
34233421
3422+
- **Zero modifications required**: Deploy existing Ethereum contracts directly without any code changes.
34243423
- **Complete JSON-RPC API support**: Use MetaMask, Hardhat, Remix, Foundry, and all standard Ethereum tooling.
34253424
- **Standard libraries**: Integrate Ethers.js, Web3.js, Viem, Wagmi, and Web3.py without changes.
3426-
- **Solidity development**: Write contracts in Solidity or migrate existing code directly.
3425+
- **Solidity development**: Write contracts in Solidity using the same patterns and best practices you already know.
34273426
- **Familiar workflows**: Maintain your existing deployment, testing, and monitoring processes.
34283427
3429-
### Performance Options
3430-
3431-
Choose between two execution backends:
3428+
### Cross-Chain Capabilities
34323429
3433-
- **REVM**: Run unmodified Ethereum contracts with full EVM/Ethereum compatibility.
3434-
- **PVM**: Compile to optimized RISC-V bytecode for enhanced performance and lower fees while keeping Ethereum-compatibility.
3430+
Smart contracts on Polkadot Hub can interact with any service in the Polkadot ecosystem through [XCM](/smart-contracts/precompiles/xcm/){target=\_blank}, enabling:
34353431
3436-
Both backends share the same RPC interface and tooling support, allowing seamless transitions. In addition, smart contracts can interact with Polkadot native services via [precompile contracts](/smart-contracts/precompiles/){target=\_blank}.
3432+
- Token transfers across parachains
3433+
- Remote execution on other chains
3434+
- Cross-chain composability without bridges or intermediaries
34373435
3438-
### Cross-VM & Cross-Chain Capabilities
3436+
### Native Polkadot Integration
34393437
3440-
Smart contracts written for one VM (for example, EVM) can interact directly with other smart contracts written for the RISC-V PVM, and back. This allows to use full EVM compatible contracts but extend to heavy/complex execution workloads to the PVM RISC-V backend.
3438+
Access Polkadot-native functionality directly from your Solidity contracts via [precompiles](/smart-contracts/precompiles/){target=\_blank}, including asset management, staking operations, and cross-chain messaging.
34413439
3442-
Furthermore, all smart contracts in Polkadot Hub can interact with any service in the Polkadot ecosystem through [XCM](/smart-contracts/precompiles/xcm/){target=\_blank}, enabling token transfers, remote execution, and cross-chain composability without bridges or intermediaries.
3440+
!!! note
3441+
Polkadot Hub also supports PVM (Polkadot Virtual Machine) as an alternative execution backend for advanced use cases.
34433442
34443443
## Other Smart Contract Environments
34453444
3446-
Beyond Polkadot Hub's native PVM support, the ecosystem offers two main alternatives for smart contract development:
3447-
3448-
- **EVM-compatible parachains**: Provide access to Ethereum's extensive developer ecosystem, smart contract portability, and established tooling like Hardhat, Remix, Foundry, and OpenZeppelin. The main options include Moonbeam (the first full Ethereum-compatible parachain serving as an interoperability hub), Astar (featuring dual VM support for both EVM and WebAssembly contracts), and Acala (DeFi-focused with enhanced Acala EVM+ offering advanced DeFi primitives).
3445+
Beyond Polkadot Hub, the ecosystem offers EVM-compatible parachains that provide access to Ethereum's extensive developer ecosystem with established tooling like Hardhat, Remix, Foundry, and OpenZeppelin:
34493446
3450-
- **Rust (ink!)**: ink! is a Rust-based framework that can compile to PVM. It uses [`#[ink(...)]`](https://use.ink/docs/v6/macros-attributes/){target=\_blank} attribute macros to create Polkadot SDK-compatible PVM bytecode, offering strong memory safety from Rust, an advanced type system, high-performance PVM execution, and platform independence with sandboxed security.
3447+
- **Moonbeam**: The first full Ethereum-compatible parachain, serving as an interoperability hub.
3448+
- **Astar**: Features dual VM support for both EVM and WebAssembly contracts.
3449+
- **Acala**: DeFi-focused with enhanced Acala EVM+ offering advanced DeFi primitives.
34513450
34523451
## Next Steps
34533452

.ai/categories/infrastructure.md

Lines changed: 19 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -6773,49 +6773,48 @@ Page Title: Smart Contracts Overview
67736773
67746774
- Source (raw): https://raw.githubusercontent.com/polkadot-developers/polkadot-docs/master/.ai/pages/smart-contracts-overview.md
67756775
- Canonical (HTML): https://docs.polkadot.com/smart-contracts/overview/
6776-
- Summary: Learn about smart contract development on Polkadot Hub with native PVM support, dual-VM execution, and seamless cross-chain capabilities.
6776+
- Summary: Learn about smart contract development on Polkadot Hub with full Ethereum compatibility, Solidity support, and seamless cross-chain capabilities.
67776777
67786778
# Smart Contracts on Polkadot Hub
67796779
67806780
## Introduction
67816781
6782-
Polkadot Hub provides a production-ready smart contract platform that combines Ethereum compatibility with the performance and cross-chain capabilities of the Polkadot ecosystem. Developers can deploy smart contracts directly on Polkadot Hub while using familiar Ethereum tooling, workflows, and programming languages.
6783-
6784-
Built with a dual-VM approach, Polkadot Hub offers two execution backends: REVM for unmodified EVM compatibility and native PVM for optimized computationally expensive workloads. This dual-VM architecture enables developers to migrate existing Ethereum contracts instantly or optimize for speed and efficiency with native execution.
6782+
Polkadot Hub is a production-ready Solidity smart contract platform that brings full Ethereum compatibility to the Polkadot ecosystem. Deploy your existing Ethereum contracts without modifications, use familiar tools like Hardhat and Remix, and gain access to Polkadot's cross-chain capabilities.
67856783
67866784
## Why Build on Polkadot Hub
67876785
6788-
### Ethereum Compatibility
6786+
### Full Ethereum Compatibility
67896787
6790-
Deploy existing Ethereum contracts with zero modifications while maintaining full compatibility with your existing development stack:
6788+
Polkadot Hub runs the REVM (Rust Ethereum Virtual Machine) backend, providing complete EVM compatibility. Your Solidity contracts work exactly as they do on Ethereum:
67916789
6790+
- **Zero modifications required**: Deploy existing Ethereum contracts directly without any code changes.
67926791
- **Complete JSON-RPC API support**: Use MetaMask, Hardhat, Remix, Foundry, and all standard Ethereum tooling.
67936792
- **Standard libraries**: Integrate Ethers.js, Web3.js, Viem, Wagmi, and Web3.py without changes.
6794-
- **Solidity development**: Write contracts in Solidity or migrate existing code directly.
6793+
- **Solidity development**: Write contracts in Solidity using the same patterns and best practices you already know.
67956794
- **Familiar workflows**: Maintain your existing deployment, testing, and monitoring processes.
67966795
6797-
### Performance Options
6798-
6799-
Choose between two execution backends:
6796+
### Cross-Chain Capabilities
68006797
6801-
- **REVM**: Run unmodified Ethereum contracts with full EVM/Ethereum compatibility.
6802-
- **PVM**: Compile to optimized RISC-V bytecode for enhanced performance and lower fees while keeping Ethereum-compatibility.
6798+
Smart contracts on Polkadot Hub can interact with any service in the Polkadot ecosystem through [XCM](/smart-contracts/precompiles/xcm/){target=\_blank}, enabling:
68036799
6804-
Both backends share the same RPC interface and tooling support, allowing seamless transitions. In addition, smart contracts can interact with Polkadot native services via [precompile contracts](/smart-contracts/precompiles/){target=\_blank}.
6800+
- Token transfers across parachains
6801+
- Remote execution on other chains
6802+
- Cross-chain composability without bridges or intermediaries
68056803
6806-
### Cross-VM & Cross-Chain Capabilities
6804+
### Native Polkadot Integration
68076805
6808-
Smart contracts written for one VM (for example, EVM) can interact directly with other smart contracts written for the RISC-V PVM, and back. This allows to use full EVM compatible contracts but extend to heavy/complex execution workloads to the PVM RISC-V backend.
6806+
Access Polkadot-native functionality directly from your Solidity contracts via [precompiles](/smart-contracts/precompiles/){target=\_blank}, including asset management, staking operations, and cross-chain messaging.
68096807
6810-
Furthermore, all smart contracts in Polkadot Hub can interact with any service in the Polkadot ecosystem through [XCM](/smart-contracts/precompiles/xcm/){target=\_blank}, enabling token transfers, remote execution, and cross-chain composability without bridges or intermediaries.
6808+
!!! note
6809+
Polkadot Hub also supports PVM (Polkadot Virtual Machine) as an alternative execution backend for advanced use cases.
68116810
68126811
## Other Smart Contract Environments
68136812
6814-
Beyond Polkadot Hub's native PVM support, the ecosystem offers two main alternatives for smart contract development:
6815-
6816-
- **EVM-compatible parachains**: Provide access to Ethereum's extensive developer ecosystem, smart contract portability, and established tooling like Hardhat, Remix, Foundry, and OpenZeppelin. The main options include Moonbeam (the first full Ethereum-compatible parachain serving as an interoperability hub), Astar (featuring dual VM support for both EVM and WebAssembly contracts), and Acala (DeFi-focused with enhanced Acala EVM+ offering advanced DeFi primitives).
6813+
Beyond Polkadot Hub, the ecosystem offers EVM-compatible parachains that provide access to Ethereum's extensive developer ecosystem with established tooling like Hardhat, Remix, Foundry, and OpenZeppelin:
68176814
6818-
- **Rust (ink!)**: ink! is a Rust-based framework that can compile to PVM. It uses [`#[ink(...)]`](https://use.ink/docs/v6/macros-attributes/){target=\_blank} attribute macros to create Polkadot SDK-compatible PVM bytecode, offering strong memory safety from Rust, an advanced type system, high-performance PVM execution, and platform independence with sandboxed security.
6815+
- **Moonbeam**: The first full Ethereum-compatible parachain, serving as an interoperability hub.
6816+
- **Astar**: Features dual VM support for both EVM and WebAssembly contracts.
6817+
- **Acala**: DeFi-focused with enhanced Acala EVM+ offering advanced DeFi primitives.
68196818
68206819
## Next Steps
68216820

0 commit comments

Comments
 (0)