Add "Dual Virtual Machine" page (new IA) #1028
Closed
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
* Include Ubuntu Rust setup commands * Using tabs instead of headers to differentiate OS and ran scripts/generate_llms.py * Regenerate llms files
* fix url * llms
* Update hardhat.md added Node version recommendation in pre-reqs so it's more prominent * LLM updates re: Node version LLM updates re: Node version
The Security and Release Team links were swapped in the html reference
* adds script to output .md pages to /.ai/, adds ai_exclude flag to needed pages, adds initial batch of ai files * adds Tutorial tag to relevant pages, updates scripts for generating new llms files (still need category files) * adds category file generation * updates main llms script, removes deprecated LLMs files * adds estimated token count to category bundle outputs * adds variable for base url for ai artifact files * wired up existing UI, updated default file outputs * update f string copy to match file renaming * updates check-llms workflow to verify llms.txt as llms-full.txt is deprecated with these changes * fresh llms * updates urls for prod * update scripts per feedback (remove bundle from file path) * Fix filepaths to remove bundle * remove log line that is no longer needed * patch to remove source repos and optional resources from llms.txt, WIP README * patch script to output llms-full.jsonl to root of docs repo (too big to download via browser like other /.ai/ files) * updates README * tweaking workflow for new full site file use * removes Tutorial category (we can figure out how we want to manage tagging these in future ticket). * updated llms * remove ai_exclude flag and tags, update README * remove blank end lines * update generate category script to only output md format (will explore other formats in future ticket) * updates per feedback, fresh llms * formatting * remove tutorial.md bundle file as not needed at this time. * update to fix errant hyphen in front of code snippets, ran fresh llm files with the corrections in place * remove check for 'ai_exclude' flag * remove ai exclude tag * remove Tutorial tags, fresh llms * updates script to fix formatting issue in output files, fresh llms * update code comment * missed a file save! * improved README * fresh llms
… contracts section. Introduced REVM and PolkaVM backends, detailing their features, use cases, and shared infrastructure for developers.
nhussein11
force-pushed
the
nhussein11/add-dual-virtual-machine-sc
branch
from
26f95ba to
18f24ac
Compare
nhussein11
added
B0 - Needs Review
* Update hardhat.md added Node version recommendation in pre-reqs so it's more prominent * LLM updates re: Node version LLM updates re: Node version * Update hardhat to recommend Node 22.5 Node 22.5 version required for latest plugin version (released a couple of days ago) to avoid Websocket issues. Also to fix indentation :) * update LLM files with node version for hardhat update LLM files with node version for hardhat
…kflows (#974) * Improve CONTRIBUTING workflow * Update workflow * Update workflow * Update wording to be clear and concise * Update .CONTRIBUTING.md Co-authored-by: Erin Shaben <[email protected]> * Update .CONTRIBUTING.md Co-authored-by: Erin Shaben <[email protected]> * Update .CONTRIBUTING.md Co-authored-by: Erin Shaben <[email protected]> * Update .CONTRIBUTING.md Co-authored-by: Erin Shaben <[email protected]> * Update .CONTRIBUTING.md Co-authored-by: Erin Shaben <[email protected]> * Update .CONTRIBUTING.md Co-authored-by: Erin Shaben <[email protected]> * Update .CONTRIBUTING.md Co-authored-by: Erin Shaben <[email protected]> * Update README.md Co-authored-by: Erin Shaben <[email protected]> * Update .CONTRIBUTING.md Co-authored-by: Erin Shaben <[email protected]> * Update .CONTRIBUTING.md Co-authored-by: Erin Shaben <[email protected]> * Update .CONTRIBUTING.md Co-authored-by: Erin Shaben <[email protected]> * Update .CONTRIBUTING.md Co-authored-by: Erin Shaben <[email protected]> * Update .CONTRIBUTING.md Co-authored-by: Erin Shaben <[email protected]> * Update .CONTRIBUTING.md Co-authored-by: Erin Shaben <[email protected]> * Update .CONTRIBUTING.md Co-authored-by: Erin Shaben <[email protected]> * Update .CONTRIBUTING.md Co-authored-by: Erin Shaben <[email protected]> * Update .CONTRIBUTING.md Co-authored-by: Erin Shaben <[email protected]> * Update .CONTRIBUTING.md Co-authored-by: Erin Shaben <[email protected]> * Update .CONTRIBUTING.md Co-authored-by: Erin Shaben <[email protected]> * Update .CONTRIBUTING.md Co-authored-by: Erin Shaben <[email protected]> * Update .CONTRIBUTING.md Co-authored-by: Erin Shaben <[email protected]> * Update .CONTRIBUTING.md Co-authored-by: Erin Shaben <[email protected]> * Update .CONTRIBUTING.md Co-authored-by: Erin Shaben <[email protected]> * Update content * Update .CONTRIBUTING.md Co-authored-by: Erin Shaben <[email protected]> * Update .CONTRIBUTING.md Co-authored-by: Erin Shaben <[email protected]> * Update .CONTRIBUTING.md Co-authored-by: Erin Shaben <[email protected]> * Update .CONTRIBUTING.md Co-authored-by: Erin Shaben <[email protected]> * Update .CONTRIBUTING.md Co-authored-by: Erin Shaben <[email protected]> * Update .CONTRIBUTING.md Co-authored-by: Erin Shaben <[email protected]> * Update README.md Co-authored-by: Erin Shaben <[email protected]> * Update README.md Co-authored-by: Erin Shaben <[email protected]> * Update README.md Co-authored-by: Erin Shaben <[email protected]> * add termynal element * Update content * Update .CONTRIBUTING.md Co-authored-by: Erin Shaben <[email protected]> * Update content --------- Co-authored-by: Erin Shaben <[email protected]>
* Add polkadart * Update develop/toolkit/api-libraries/polkadart.md Co-authored-by: Nicolás Hussein <[email protected]> * PR feedback * Update develop/toolkit/api-libraries/polkadart.md Co-authored-by: Taylor Lucero <[email protected]> * Update develop/toolkit/api-libraries/polkadart.md Co-authored-by: Taylor Lucero <[email protected]> * Update develop/toolkit/api-libraries/polkadart.md Co-authored-by: Taylor Lucero <[email protected]> * Update develop/toolkit/api-libraries/polkadart.md Co-authored-by: Taylor Lucero <[email protected]> * Update develop/toolkit/api-libraries/polkadart.md Co-authored-by: Taylor Lucero <[email protected]> * Update develop/toolkit/api-libraries/polkadart.md Co-authored-by: Taylor Lucero <[email protected]> * Update .nav.yml --------- Co-authored-by: Nicolás Hussein <[email protected]> Co-authored-by: Taylor Lucero <[email protected]>
* add install command * add llms files
* Update validator onboarding images and documentation * fix: typo * fix: llms * docs: Update validator activation instructions in onboarding guide * fix: llms * docs: Update validator activation steps to include bond amount requirement * fix: llms * fix: start validating page * fix: last image * fix: llms * fix * fix: llms * fresh llms * llms check * fresh llms --------- Co-authored-by: DAWN KELLY <[email protected]>
* WIP: Creating ParaSpell transfer guide * WIP * Add ParaSpell transfer guide * Update develop/toolkit/interoperability/paraspell/index.md Co-authored-by: Nicolás Hussein <[email protected]> * Update develop/toolkit/interoperability/paraspell/paraspell-xcm-sdk.md Co-authored-by: Nicolás Hussein <[email protected]> * Update develop/toolkit/interoperability/paraspell/paraspell-xcm-sdk.md Co-authored-by: Nicolás Hussein <[email protected]> * Update develop/toolkit/interoperability/paraspell/paraspell-xcm-sdk.md Co-authored-by: Nicolás Hussein <[email protected]> * Update develop/toolkit/interoperability/paraspell/paraspell-xcm-sdk.md Co-authored-by: Nicolás Hussein <[email protected]> * Update content * Update content * Update develop/toolkit/interoperability/paraspell-xcm-sdk/teleport-from-asset-hub-to-relay-chain.md Co-authored-by: Taylor Lucero <[email protected]> * Update develop/toolkit/interoperability/paraspell-xcm-sdk/teleport-from-asset-hub-to-relay-chain.md Co-authored-by: Taylor Lucero <[email protected]> * Update develop/toolkit/interoperability/paraspell-xcm-sdk/teleport-from-asset-hub-to-relay-chain.md Co-authored-by: Taylor Lucero <[email protected]> * Update develop/toolkit/interoperability/paraspell-xcm-sdk/teleport-from-asset-hub-to-relay-chain.md Co-authored-by: Taylor Lucero <[email protected]> * Update develop/toolkit/interoperability/paraspell-xcm-sdk/teleport-from-asset-hub-to-relay-chain.md Co-authored-by: Taylor Lucero <[email protected]> * Update develop/toolkit/interoperability/paraspell-xcm-sdk/index.md Co-authored-by: Taylor Lucero <[email protected]> * Update content * Update content * Update develop/toolkit/interoperability/paraspell-xcm-sdk/teleport-from-asset-hub-to-bridge-hub.md Co-authored-by: Nicolás Hussein <[email protected]> * Update content * llms * Revise for AH to People Chain * Update title * Fix content * Revise content to generic XCM transfer between parachains * Pin dependencies * Update wording in content * Update content to reflect generic nature of tutorial * Update code according to feedback * Update content * Update develop/toolkit/interoperability/paraspell-xcm-sdk/transfer-tokens-between-parachains.md Co-authored-by: Dawn Kelly <[email protected]> * Update develop/toolkit/interoperability/paraspell-xcm-sdk/transfer-tokens-between-parachains.md Co-authored-by: Dawn Kelly <[email protected]> * Update develop/toolkit/interoperability/paraspell-xcm-sdk/transfer-tokens-between-parachains.md Co-authored-by: Dawn Kelly <[email protected]> * Update develop/toolkit/interoperability/paraspell-xcm-sdk/transfer-tokens-between-parachains.md Co-authored-by: Dawn Kelly <[email protected]> * python3 scripts/generate_llms.py * Update develop/toolkit/interoperability/paraspell-xcm-sdk/transfer-tokens-between-parachains.md Co-authored-by: Dawn Kelly <[email protected]> * Update develop/toolkit/interoperability/paraspell-xcm-sdk/transfer-tokens-between-parachains.md Co-authored-by: Dawn Kelly <[email protected]> * Update develop/toolkit/interoperability/paraspell-xcm-sdk/transfer-tokens-between-parachains.md Co-authored-by: Dawn Kelly <[email protected]> * Update develop/toolkit/interoperability/paraspell-xcm-sdk/transfer-tokens-between-parachains.md Co-authored-by: Dawn Kelly <[email protected]> * Update develop/toolkit/interoperability/paraspell-xcm-sdk/transfer-tokens-between-parachains.md Co-authored-by: Dawn Kelly <[email protected]> * Update develop/toolkit/interoperability/paraspell-xcm-sdk/transfer-tokens-between-parachains.md Co-authored-by: Dawn Kelly <[email protected]> * Update develop/toolkit/interoperability/paraspell-xcm-sdk/transfer-tokens-between-parachains.md Co-authored-by: Dawn Kelly <[email protected]> * Update develop/toolkit/interoperability/paraspell-xcm-sdk/transfer-tokens-between-parachains.md Co-authored-by: Dawn Kelly <[email protected]> * Update develop/toolkit/interoperability/paraspell-xcm-sdk/transfer-tokens-between-parachains.md Co-authored-by: Dawn Kelly <[email protected]> * Update develop/toolkit/interoperability/paraspell-xcm-sdk/transfer-tokens-between-parachains.md Co-authored-by: Dawn Kelly <[email protected]> * Update develop/toolkit/interoperability/paraspell-xcm-sdk/transfer-tokens-between-parachains.md Co-authored-by: Dawn Kelly <[email protected]> * Update develop/toolkit/interoperability/paraspell-xcm-sdk/transfer-tokens-between-parachains.md Co-authored-by: Dawn Kelly <[email protected]> * Update develop/toolkit/interoperability/paraspell-xcm-sdk/transfer-tokens-between-parachains.md Co-authored-by: Dawn Kelly <[email protected]> * Update develop/toolkit/interoperability/paraspell-xcm-sdk/transfer-tokens-between-parachains.md Co-authored-by: Dawn Kelly <[email protected]> * Update develop/toolkit/interoperability/paraspell-xcm-sdk/transfer-tokens-between-parachains.md Co-authored-by: Dawn Kelly <[email protected]> * Update develop/toolkit/interoperability/paraspell-xcm-sdk/transfer-tokens-between-parachains.md Co-authored-by: Dawn Kelly <[email protected]> * Update develop/toolkit/interoperability/paraspell-xcm-sdk/transfer-tokens-between-parachains.md Co-authored-by: Dawn Kelly <[email protected]> * Update content --------- Co-authored-by: Nicolás Hussein <[email protected]> Co-authored-by: Taylor Lucero <[email protected]> Co-authored-by: Dawn Kelly <[email protected]>
* Add tutorial for paying transaction fees with different tokens * fix: llms * Remove tutorial and code snippets for paying transaction fees with different tokens * fix: llms * Update tutorial for sending transactions with alternative fee payment token and adjust navigation link * Enhance tutorial for sending transactions with alternative fee payment token by adding TypeScript module configuration step * fix: llms * Refine tutorial for sending transactions with alternative fee payment token by clarifying implementation steps and enhancing readability * fix: llms * Refine tutorial title for sending transactions with alternative fee payment token to improve clarity * Apply suggestions from code review Co-authored-by: Taylor Lucero <[email protected]> * fix: llms * Apply suggestions from code review Co-authored-by: Taylor Lucero <[email protected]> * fix: title * fix: llms --------- Co-authored-by: Taylor Lucero <[email protected]>
brunopgalvao
approved these changes
Oct 7, 2025
* adds `generate_ai_pages.py` with indentation respected and yaml/yml wrapper * updates script to ouput to /ai/pages dir, adds generate_llms_txt.py * removes deprecated script * adds generate_category_bundles.py script + generated files * adds generate_site_index.py + resulting files * delete deprecated script, add main script for llm file pipeline * remove deprecated category files * update to use files in /ai/categories for table * update workflow * fresh llms * Update ai/pages/tutorials-smart-contracts-demo-aplications-deploying-uniswap-v2.md Co-authored-by: Copilot <[email protected]> * fresh llms * fixes duplicate terminal outputs, fresh llm files --------- Co-authored-by: Copilot <[email protected]>
* update scripts to use /.ai/ instead of /ai/ * run llms to generate outut to /.ai/ * delete /ai/ * update config * llms
…n of the Ethereum Virtual Machine, enhancing clarity for developers.
* add n8n script * test * test * revert --------- Co-authored-by: Taylor Lucero <[email protected]>
* mermaid fix * fix * fix * llms
* fix minor issues * llms
|
@dawnkelly09 can you please resolve merge conflicts? |
Since it is not in alphabetical order anyway, as far as I know "Polkadart" should be before "Polkadot-API" Dart, comes before TypeScript, Python comes before TypeScript, and so on, but it seems the only "error" is that Dedot is listed first. If you don't mind us making this change @sinzii ? I really appreciate all your hard work.
* Copy js file from copy-to-llm (#909) Co-authored-by: Leonardo Custodio <[email protected]> * script review, added TODOs and comments re: updates to work with resolved Markdown files we will use for per-page content * updates comment * tweaks to script to prep for per page md file wireup * continue updating script to use new generated files * iterating on script * WIP * fresh llms * adds view icons to table * removes deprecated placeholder files * whitespace * fresh llms * removes view icons, fresh llms * fresh llms * updates exports, cleans up code * update exports * clean, clean, clean the code * remove debug window for prod * code clean up * more clean up * formatting/styling clean up * apply review feedback * fresh llms * clean code, remove deprecated script * script clean up and testing * script clean up, fresh llms * clean up contents, prettier --------- Co-authored-by: Leonardo Custodio <[email protected]>
* removes unneeded checks and processing to reduce console noise and confusing errors. * prettier * remove extra normalizing check * patch remove deprecated logic * patch the patches * pathcy patch patcherson * clean and patch * remove blank line at end * patching stuff * patch error handling * patch error handling * Apply suggestion from @Copilot Co-authored-by: Copilot <[email protected]> --------- Co-authored-by: Copilot <[email protected]>
* Add Wallet Tools section with LunoKit integration library Add a new "Wallet Tools" section for libraries and SDKs that help developers quickly and easily integrate wallet functionality into their dApps. Add LunoKit - a React library that simplifies wallet integration with unified API for 9+ Polkadot wallets, pre-built components, TypeScript support, and compatibility with major Polkadot APIs. Helps developers add wallet functionality without building from scratch.LunoKit is supported by the Web3 Foundation Grants Program. * fix: llms * fix: site-index * fix: merge conflicts --------- Co-authored-by: nhussein11 <[email protected]>
There was a problem hiding this comment.
Pull Request Overview
This PR introduces a comprehensive "Dual Virtual Machine" documentation page for the new Information Architecture, covering smart contract development on Polkadot Hub using PolkaVM alongside existing parachain development resources, tools, and integrations.
Key Changes
- Added smart contracts documentation covering wallets, precompiles, libraries, and development environments for Polkadot Hub
- Introduced extensive toolkit documentation for parachains including RPC calls, remote proxies, light clients, fork chains, and E2E testing
- Added comprehensive interoperability and integration guides covering XCM tools, storage, oracles, indexers, and wallets
Reviewed Changes
Copilot reviewed 100 out of 299 changed files in this pull request and generated no comments.
Show a summary per file
| File | Description |
|---|---|
| develop-toolkit-parachains-rpc-calls.md | Documents RPC call methods and usage for interacting with Polkadot SDK chains |
| develop-toolkit-parachains-remote-proxies.md | Explains remote proxy architecture and implementation for cross-chain proxy functionality |
| develop-toolkit-parachains-quickstart.md | Landing page for parachain development quickstart section |
| develop-toolkit-parachains-quickstart-pop-cli.md | Guide for using Pop CLI to bootstrap parachain projects |
| develop-toolkit-parachains-polkadot-omni-node.md | Documentation for running parachains using the polkadot-omni-node binary |
| develop-toolkit-parachains-light-clients.md | Overview of light client functionality and implementations |
| develop-toolkit-parachains-fork-chains.md | Introduction to forking live chains for testing purposes |
| develop-toolkit-parachains-fork-chains-chopsticks.md | Landing page for Chopsticks fork chain tooling |
| develop-toolkit-parachains-fork-chains-chopsticks-get-started.md | Installation and configuration guide for Chopsticks |
| develop-toolkit-parachains-e2e-testing.md | Landing page for E2E testing tools |
| develop-toolkit-parachains-e2e-testing-moonwall.md | Guide for E2E testing with Moonwall framework |
| develop-toolkit-interoperability.md | Landing page for interoperability tools and XCM ecosystem |
| develop-toolkit-interoperability-xcm-tools.md | Overview of XCM tools including ParaSpell, Moonbeam SDK, and others |
| develop-toolkit-interoperability-paraspell-xcm-sdk.md | Introduction to ParaSpell XCM SDK |
| develop-toolkit-interoperability-paraspell-xcm-sdk-transfer-tokens-between-parachains.md | Tutorial for cross-chain token transfers using ParaSpell |
| develop-toolkit-integrations.md | Landing page for integration solutions |
| develop-toolkit-integrations-wallets.md | Overview of hot and cold wallet solutions |
| develop-toolkit-integrations-transaction-construction.md | Guide for constructing, signing, and broadcasting transactions |
| develop-toolkit-integrations-storage.md | Documentation for decentralized storage solutions |
| develop-toolkit-integrations-oracles.md | Overview of oracle implementations |
| develop-toolkit-integrations-indexers.md | Documentation for blockchain indexer solutions |
| develop-toolkit-api-libraries.md | Landing page for API libraries |
| develop-toolkit-api-libraries-subxt.md | Guide for using Subxt Rust API |
| develop-toolkit-api-libraries-sidecar.md | Documentation for Sidecar REST API |
| develop-toolkit-api-libraries-py-substrate-interface.md | Guide for Python Substrate Interface |
| develop-toolkit-api-libraries-polkadot-js-api.md | Documentation for Polkadot.js API (maintenance mode) |
| develop-toolkit-api-libraries-polkadart.md | Guide for Polkadart Dart/Flutter SDK |
| develop-toolkit-api-libraries-papi.md | Documentation for Polkadot-API (PAPI) |
| develop-toolkit-api-libraries-dedot.md | Guide for Dedot TypeScript library |
| develop-smart-contracts.md | Landing page for smart contracts development |
| develop-smart-contracts-wallets.md | Guide for connecting wallets to Polkadot Hub |
| develop-smart-contracts-precompiles.md | Overview of precompiles in Polkadot Hub |
| develop-smart-contracts-precompiles-xcm-precompile.md | Guide for interacting with XCM precompile |
| develop-smart-contracts-precompiles-interact-with-precompiles.md | Tutorial for using standard precompiles |
| develop-smart-contracts-overview.md | Comprehensive overview of smart contract options |
| develop-smart-contracts-local-development-node.md | Setup guide for local Revive dev node |
| develop-smart-contracts-libraries.md | Comparison of smart contract libraries |
| develop-smart-contracts-libraries-web3-py.md | Guide for using Web3.py with Polkadot Hub |
| develop-smart-contracts-libraries-web3-js.md | Guide for using Web3.js (sunset warning) |
| develop-smart-contracts-libraries-wagmi.md | Guide for using Wagmi React Hooks |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
|
Closing in favor of #1145 |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This PR introduces the "Dual Virtual Machine" page for the new IA
This PR uses the eshaben/smart-contracts-1 as a source branch. Along with the eshaben/smart-contracts-1-redirects branch for polkadot-mkdocs