Add smart contract functionality page #1130

brunopgalvao · 2025-10-21T14:16:33Z

📝 Description

Resolves #1045

🔍 Review Preference

Choose one:

✅ I have time to handle formatting/style feedback myself
⚡ Docs team handles formatting (check "Allow edits from maintainers")

🤖 AI-Ready Docs

If content changed, regenerate AI files:

✅ I ran python3 scripts/generate_llms.py
⚡ Docs team will regenerate (check "Allow edits from maintainers")

✅ Checklist

Changes tested
PaperMoon Style Guide followed

github-actions · 2025-10-22T17:49:16Z

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


-For a real-world example of how these pallets are implemented in production, you can check Moonbeam's implementation of [`pallet-evm`](https://github.com/moonbeam-foundation/moonbeam/blob/9e2ddbc9ae8bf65f11701e7ccde50075e5fe2790/runtime/moonbeam/src/lib.rs#L532){target=\_blank} and [`pallet-ethereum`](https://github.com/moonbeam-foundation/moonbeam/blob/9e2ddbc9ae8bf65f11701e7ccde50075e5fe2790/runtime/moonbeam/src/lib.rs#L698){target=\_blank}.
+**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 and REVM backends


Issue: External link missing backslash in target attribute.

Suggested change

- **[`pallet-revive`](https://github.com/paritytech/polkadot-sdk/tree/master/substrate/frame/revive){target=\_blank}** - Provides the core smart contract execution environment with PolkaVM and REVM backends

[`pallet-revive`](https://github.com/paritytech/polkadot-sdk/tree/master/substrate/frame/revive){target=\_blank}

**[`pallet-revive`](https://github.com/paritytech/polkadot-sdk/tree/master/substrate/frame/revive){target=\_blank}** - Provides the core smart contract execution environment with PolkaVM and REVM backends

github-actions · 2025-10-22T17:49:17Z

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


-## Wasm Smart Contracts
+**Optional 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


Issue: External link missing backslash in target attribute.

Suggested change

- **[`pallet-revive-eth-rpc`](https://crates.io/crates/pallet-revive-eth-rpc){target=\_blank}** - Adds full Ethereum RPC compatibility for Ethereum tooling integration

**[`pallet-revive-eth-rpc`](https://crates.io/crates/pallet-revive-eth-rpc){target=\_blank}** - Adds full Ethereum RPC compatibility for Ethereum tooling integration

github-actions · 2025-10-22T17:49:18Z

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

+**Dual Execution Model:**

-<div class="grid cards" markdown>
+1. **PolkaVM Backend**: Executes PolkaVM bytecode with native performance optimization, precise gas metering, and enhanced security features


Issue: Missing period at end of full sentence list item.

Suggested change

1. **PolkaVM Backend**: Executes PolkaVM bytecode with native performance optimization, precise gas metering, and enhanced security features

1. **PolkaVM Backend**: Executes PolkaVM bytecode with native performance optimization, precise gas metering, and enhanced security features.

github-actions · 2025-10-22T17:49:18Z

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


-<div class="grid cards" markdown>
+1. **PolkaVM Backend**: Executes PolkaVM bytecode with native performance optimization, precise gas metering, and enhanced security features
+2. **REVM Backend**: Executes EVM bytecode for compatibility with existing Ethereum contracts, ensuring seamless migration


Issue: Missing period at end of full sentence list item.

Suggested change

2. **REVM Backend**: Executes EVM bytecode for compatibility with existing Ethereum contracts, ensuring seamless migration

2. **REVM Backend**: Executes EVM bytecode for compatibility with existing Ethereum contracts, ensuring seamless migration.

github-actions · 2025-10-22T17:49:20Z

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

+
+## pallet-contracts (Legacy)
+
+[`pallet-contracts`](https://docs.rs/pallet-contracts/latest/pallet_contracts/index.html#contracts-pallet){target=\_blank} is the original Wasm-based smart contract pallet for Polkadot SDK chains. While still functional, it's considered legacy as development efforts have shifted to pallet-revive.


Issue: External link missing backslash in target attribute.

Suggested change

[`pallet-contracts`](https://docs.rs/pallet-contracts/latest/pallet_contracts/index.html#contracts-pallet){target=\_blank} is the original Wasm-based smart contract pallet for Polkadot SDK chains. While still functional, it's considered legacy as development efforts have shifted to pallet-revive.

[pallet-contracts](https://docs.rs/pallet-contracts/latest/pallet_contracts/index.html#contracts-pallet){target=\_blank} is the original Wasm-based smart contract pallet for Polkadot SDK chains. While still functional, it's consider...

nhussein11 · 2025-10-22T18:07:29Z

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

+- **[`pallet-revive`](https://github.com/paritytech/polkadot-sdk/tree/master/substrate/frame/revive){target=\_blank}** - Provides the core smart contract execution environment with PolkaVM and REVM backends

-## Wasm Smart Contracts
+**Optional RPC Adapter:**


I'd say this isn't optional. More importantly, it's crucial because otherwise you'll only be able to send Substrate-type transactions.

Let's remove the "Optional".

nhussein11 · 2025-10-22T18:07:59Z

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

+### Supported Languages and Compilers

- **[`pallet-contracts`](https://docs.rs/pallet-contracts/latest/pallet_contracts/index.html#contracts-pallet){target=\_blank}**: Provides the Wasm smart contract execution environment.
+pallet-revive accepts smart contracts from multiple languages and compilation paths:


Here I'd say that it supports any language that can be compiled down to RISC-V

I think this is fine here especially because we want to focus on Solidity (REVM/PVM). Later on in this page on line 41 I state: "Any language that can compile to PolkaVM bytecode and utilize pallet-revive's host functions (via pallet-revive-uapi) is supported."

nhussein11 · 2025-10-22T18:08:44Z

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

+| Language | Compiler | Output Bytecode | Execution Backend | Performance |
+|----------|----------|-----------------|-------------------|-------------|
+| Solidity | `resolc` | PolkaVM | PolkaVM | Optimal |
+| Solidity | `solc` | EVM | REVM | Compatible |


not sure if "performance/compatible" makes sense

Remove the "Performance" column.

nhussein11 · 2025-10-22T18:09:12Z

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

+| Rust (ink!) | `cargo-contract` | PolkaVM | PolkaVM | Optimal |

-For a real-world example of how this pallet is implemented in production, you can check Astar's implementation of [`pallet-contracts`](https://github.com/AstarNetwork/Astar/blob/b6f7a408d31377130c3713ed52941a06b5436402/runtime/astar/src/lib.rs#L693){target=\_blank}.
+Any language that can compile to PolkaVM bytecode and utilize pallet-revive's host functions (via `pallet-revive-uapi`) is supported.


is there a link for pallet-revive-uapi

https://paritytech.github.io/polkadot-sdk/master/pallet_revive_uapi/index.html

nhussein11 · 2025-10-22T18:10:01Z

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

+**Dual Execution Model:**

-<div class="grid cards" markdown>
+1. **PolkaVM Backend**: Executes PolkaVM bytecode with native performance optimization, precise gas metering, and enhanced security features


Haha, I would definitely NOT say that the gas metering is precise

Okay haha. We can say: "Executes PolkaVM bytecode with native performance optimization."

nhussein11 · 2025-10-22T18:12:04Z

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

+### Implementation Examples

-    [:octicons-arrow-right-24: Reference](/smart-contracts/get-started/)
+See real-world implementation in the [Asset Hub system parachain runtime](https://github.com/polkadot-fellows/runtimes/blob/8914a1c70ce2a821f1d4646feaab462204e01b26/system-parachains/asset-hubs/asset-hub-kusama/src/lib.rs#L1180-L1209){target=\_blank} in the Polkadot Fellows repository.


maybe this should be "Polkadot Hub TestNet", and be pointed to passet hub

I believe the passet hub runtime is just the asset hub runtime:

https://github.com/paseo-network/runtimes/tree/main/system-parachains

And yes we can say "Polkadot Hub TestNet" and replace with the following link:

https://github.com/paseo-network/runtimes/blob/c965c42a4e0bc9d1e9cc0a340322bc3b8e347bcf/system-parachains/asset-hub-paseo/src/lib.rs#L1122-L1157

nhussein11 · 2025-10-22T18:13:19Z

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


-For a real-world example of how these pallets are implemented in production, you can check Moonbeam's implementation of [`pallet-evm`](https://github.com/moonbeam-foundation/moonbeam/blob/9e2ddbc9ae8bf65f11701e7ccde50075e5fe2790/runtime/moonbeam/src/lib.rs#L532){target=\_blank} and [`pallet-ethereum`](https://github.com/moonbeam-foundation/moonbeam/blob/9e2ddbc9ae8bf65f11701e7ccde50075e5fe2790/runtime/moonbeam/src/lib.rs#L698){target=\_blank}.
+**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 and REVM backends


Maybe you could briefly explain or add a reference for both, polkavm and revm

Yes. Link "PolkaVM" to: https://github.com/polkadot-developers/polkadot-docs/blob/71e1b51bb42ef55e20c2f3b953db86e8c26cd591/smart-contracts/for-eth-devs/dual-vm-stack.md#upgrade-to-polkavm

And "REVM" to: https://github.com/polkadot-developers/polkadot-docs/blob/71e1b51bb42ef55e20c2f3b953db86e8c26cd591/smart-contracts/for-eth-devs/dual-vm-stack.md#migrate-from-evm

nhussein11 · 2025-10-22T18:14:06Z

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

+
+Frontier offers flexible integration depending on your compatibility needs:
+
+#### EVM Execution Only


This can be deferred to the regulators, but I believe we tend to avoid using 4 hashtags "####".

nhussein11 · 2025-10-22T18:14:32Z

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

+
+- **[`pallet-evm`](https://github.com/polkadot-evm/frontier/tree/master/frame/evm){target=\_blank}** - Provides the core EVM execution environment
+
+This configuration allows EVM contract execution but requires using Polkadot SDK-specific APIs for interaction.


Out of curiosity, what's the reason of this?

This is if you want to create a Substrate chain with an EVM and use extrinsics instead of Eth RPC style transactions. Basically you want an EVM but you don't care about Eth compatibility.

nhussein11 · 2025-10-22T18:15:53Z

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

+### Key Benefits of Full Integration
+
+- **Ethereum tooling compatibility**: Full compatibility with MetaMask, Hardhat, Remix, Truffle, and other Ethereum development tools
+- **Zero-friction migration**: Deploy existing Ethereum dapps with minimal or no modifications


Instead of "Zero", I'd say "Minimal". WDYT? just to be safe haha

add smart contract supoort page

23af944

brunopgalvao self-assigned this Oct 21, 2025

brunopgalvao added B0 - Needs Review Pull request is ready for review C1 - Medium Medium priority task A0 - New Content Pull request contains new content pages labels Oct 21, 2025

brunopgalvao had a problem deploying to n8n-sending October 21, 2025 14:16 — with GitHub Actions Failure

brunopgalvao requested a review from nhussein11 October 21, 2025 14:17

brunopgalvao marked this pull request as ready for review October 21, 2025 14:17

brunopgalvao requested a review from a team as a code owner October 21, 2025 14:17

brunopgalvao changed the title ~~Add smart contract support page~~ Add smart contract functionality page Oct 21, 2025

brunopgalvao had a problem deploying to n8n-sending October 22, 2025 15:23 — with GitHub Actions Failure

brunopgalvao temporarily deployed to n8n-sending October 22, 2025 17:43 — with GitHub Actions Inactive

brunopgalvao temporarily deployed to n8n-receiving October 22, 2025 17:49 — with GitHub Actions Inactive

github-actions bot reviewed Oct 22, 2025

View reviewed changes

nhussein11 reviewed Oct 22, 2025

View reviewed changes

polkadot-developers deleted a comment from github-actions bot Oct 23, 2025

kapetan3sid assigned Telucero Oct 23, 2025

	- [`pallet-revive`](https://github.com/paritytech/polkadot-sdk/tree/master/substrate/frame/revive){target=\_blank} - Provides the core smart contract execution environment with PolkaVM and REVM backends
	[`pallet-revive`](https://github.com/paritytech/polkadot-sdk/tree/master/substrate/frame/revive){target=\_blank}
	[`pallet-revive`](https://github.com/paritytech/polkadot-sdk/tree/master/substrate/frame/revive){target=\_blank} - Provides the core smart contract execution environment with PolkaVM and REVM backends

	- [`pallet-revive-eth-rpc`](https://crates.io/crates/pallet-revive-eth-rpc){target=\_blank} - Adds full Ethereum RPC compatibility for Ethereum tooling integration
	[`pallet-revive-eth-rpc`](https://crates.io/crates/pallet-revive-eth-rpc){target=\_blank} - Adds full Ethereum RPC compatibility for Ethereum tooling integration

	1. PolkaVM Backend: Executes PolkaVM bytecode with native performance optimization, precise gas metering, and enhanced security features
	1. PolkaVM Backend: Executes PolkaVM bytecode with native performance optimization, precise gas metering, and enhanced security features.

	2. REVM Backend: Executes EVM bytecode for compatibility with existing Ethereum contracts, ensuring seamless migration
	2. REVM Backend: Executes EVM bytecode for compatibility with existing Ethereum contracts, ensuring seamless migration.


		## pallet-contracts (Legacy)

		[`pallet-contracts`](https://docs.rs/pallet-contracts/latest/pallet_contracts/index.html#contracts-pallet){target=\_blank} is the original Wasm-based smart contract pallet for Polkadot SDK chains. While still functional, it's considered legacy as development efforts have shifted to pallet-revive.

	[`pallet-contracts`](https://docs.rs/pallet-contracts/latest/pallet_contracts/index.html#contracts-pallet){target=\_blank} is the original Wasm-based smart contract pallet for Polkadot SDK chains. While still functional, it's considered legacy as development efforts have shifted to pallet-revive.
	[pallet-contracts](https://docs.rs/pallet-contracts/latest/pallet_contracts/index.html#contracts-pallet){target=\_blank} is the original Wasm-based smart contract pallet for Polkadot SDK chains. While still functional, it's consider...


		Frontier offers flexible integration depending on your compatibility needs:

		#### EVM Execution Only


		- [`pallet-evm`](https://github.com/polkadot-evm/frontier/tree/master/frame/evm){target=\_blank} - Provides the core EVM execution environment

		This configuration allows EVM contract execution but requires using Polkadot SDK-specific APIs for interaction.

Uh oh!

Add smart contract functionality page #1130

Are you sure you want to change the base?

Add smart contract functionality page #1130

Uh oh!

Conversation

brunopgalvao commented Oct 21, 2025

📝 Description

🔍 Review Preference

🤖 AI-Ready Docs

✅ Checklist

Uh oh!

github-actions bot Oct 22, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot Oct 22, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot Oct 22, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot Oct 22, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot Oct 22, 2025

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants