Skip to content

Refocus smart contracts docs on REVM/Solidity#1332

Merged
eshaben merged 16 commits intostaging/product-iafrom
bruno/revm-first
Dec 23, 2025
Merged

Refocus smart contracts docs on REVM/Solidity#1332
eshaben merged 16 commits intostaging/product-iafrom
bruno/revm-first

Conversation

@brunopgalvao
Copy link
Contributor

@brunopgalvao brunopgalvao commented Dec 16, 2025

Summary

  • Rename PolkaVM to PVM across documentation for consistency
  • Refocus smart contracts documentation to position Polkadot Hub as a Solidity platform with full Ethereum compatibility via REVM
  • De-prioritize PVM mentions (brief mentions only for advanced use cases)
  • Rename dual-vm-stack.md to ethereum-compatibility.md
  • Simplify contract deployment docs to focus on standard EVM workflow
  • Fix hardhat init command (npx hardhat --init)

Update all references from PolkaVM to PVM in source documentation,
AI/LLM files, and generated content for consistency.
Change npx hardhat init to npx hardhat --init for correct
initialization syntax.
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.
- Rename dual-vm-stack.md to ethereum-compatibility.md
- Rewrite as "Ethereum Compatibility" page with brief PVM section
- Simplify contract-deployment.md to focus on standard EVM deployment
- Remove PVM references from explorers.md
- Update cookbook descriptions to remove PVM mentions
- Regenerate AI files
@brunopgalvao brunopgalvao self-assigned this Dec 16, 2025
@brunopgalvao brunopgalvao added B0 - Needs Review Pull request is ready for review C1 - Medium Medium priority task A3 - Quick Fixes Pull request contains small fixes (i.e., fixing a typo, removing old images, etc.) labels Dec 16, 2025
@brunopgalvao brunopgalvao marked this pull request as ready for review December 16, 2025 05:46
@brunopgalvao brunopgalvao requested a review from a team as a code owner December 16, 2025 05:46
@brunopgalvao brunopgalvao requested a review from eshaben December 16, 2025 05:46
github-actions[bot]

This comment was marked as off-topic.

Remove the extra dashes from 'npx hardhat --init' to the correct
'npx hardhat init' command.
Replace practical tool commands with conceptual content covering:
- Deployment model (CREATE/CREATE2 opcodes)
- Transaction processing architecture
- Gas estimation behavior and multi-dimensional resource model
- Storage model and deposits
- Address derivation algorithms
- Finality considerations

This aligns the page with the for-eth-devs section's purpose of providing
theoretical guidance rather than practical how-to instructions.
Restore the original REVM vs PVM deployment comparison content.
Restore the original REVM and PVM dual-VM architecture content.
@eshaben eshaben requested a review from 0xlukem December 23, 2025 03:47
@eshaben
Copy link
Collaborator

eshaben commented Dec 23, 2025

@0xlukem this is good to go, can you pls give final approval?

Copy link
Contributor

@0xlukem 0xlukem left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🚢

@0xlukem 0xlukem added B1 - Ready to Merge Pull request is ready to be merged and removed B0 - Needs Review Pull request is ready for review labels Dec 23, 2025
@eshaben eshaben merged commit 6baefa1 into staging/product-ia Dec 23, 2025
3 of 4 checks passed
@eshaben eshaben deleted the bruno/revm-first branch December 23, 2025 16:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

A3 - Quick Fixes Pull request contains small fixes (i.e., fixing a typo, removing old images, etc.) B1 - Ready to Merge Pull request is ready to be merged C1 - Medium Medium priority task

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants