Merge branch 'master' into nhussein11/estimate-fees

Author: nhussein11

.CONTRIBUTING.md

@@ -30,9 +30,9 @@ You may want to spin up a local version of the documentation site to preview you
 
 Building and serving the site requires cloning two repositories:
 
-- **[Polkadot MkDocs](https://github.com/papermoonio/polkadot-mkdocs)** - contains the MkDocs configuration files, theme overrides, and custom CSS for the Polkadot documentation site
+- **[Polkadot MkDocs](https://github.com/papermoonio/polkadot-mkdocs)**: Contains the MkDocs configuration files, theme overrides, and custom CSS for the Polkadot documentation site.
 
-- **[Polkadot Docs](https://github.com/polkadot-developers/polkadot-docs)** - the actual content is stored in the `polkadot-docs` repository and pulled into the `polkadot-mkdocs` directory during build
+- **[Polkadot Docs](https://github.com/polkadot-developers/polkadot-docs)**: The actual content is stored in the `polkadot-docs` repository and pulled into the `polkadot-mkdocs` directory during build.
 
 For everything to work correctly, the file structure needs to be as follows:
 
@@ -90,16 +90,16 @@ When adding new pages to the documentation site, it is important to ensure all r
 
 To create a new section of pages, you will first need to create a subdirectory with the desired name of the section. The root directory, and every subdirectory, must contain the following files:
 
-- `.pages` - defines the structure of the documentation site
-- `index.md` - a landing page which can be used to provide more context about the content in the section
+- **`.pages`**: Defines the structure of the documentation site.
+- **`index.md`**: A landing page which can be used to provide more context about the content in the section.
 
 #### Example `.pages` File
 
 ```markdown
 title: Application Developers
 nav: 
   - index.md
-  - 'Polkadot SDK': 'polkadot-sdk.md'
+  - **'Polkadot SDK'**: 'polkadot-sdk.md'
   - interact
   - tooling
 ```
@@ -108,10 +108,10 @@ This example would result in adding 'Application Developers' as a section with t
 
 Some important things to note:
 
-- The `title` field at the top of the page represents the display name for the section. This is displayed on the left-side navigation bar when viewing the site
-- The `index.md` page should always be the first item in the `nav` list
-- Files follow the convention of `'Display Name': 'file-name.md'`
-- Sections are listed by their directory name in the source code. For example, the Tooling section will be added to the navigation simply by using the directory name: `tooling`
+- The `title` field at the top of the page represents the display name for the section. This is displayed on the left-side navigation bar when viewing the site.
+- The `index.md` page should always be the first item in the `nav` list.
+- Files follow the convention of `'Display Name': 'file-name.md'`.
+- Sections are listed by their directory name in the source code. For example, the Tooling section will be added to the navigation simply by using the directory name: `tooling`.
 
 #### Example `index.md` File
 
@@ -126,22 +126,22 @@ description: Learn how to build and customize blockchains with Polkadot SDK. Exp
 
 Some important things to note:
 
-- The `title` represents the `<title>` tag and is used for SEO purposes
-- The `description` represents the meta-description and is also used for SEO purposes
+- The `title` represents the `<title>` tag and is used for SEO purposes.
+- The `description` represents the meta-description and is also used for SEO purposes.
 
 ### Adding Pages to Existing Section
 
 If you are adding pages to an existing section, the steps are simplified. However, it's essential to ensure you complete these steps to display the new page and its title on the documentation site correctly:
 
 - Add the new markdown page to the appropriate section. Note that the filename becomes part of the URL for this page. See the [style guide](https://github.com/papermoonio/documentation-style-guide/blob/main/style-guide.md#naming-conventions) for additional guidance on naming conventions.
 - Ensure the new content page includes the following:
-    - **`title`** - represents the `<title>` tag and is used for SEO purposes (not displayed on the published site) Titles have a maximum length of 45 characters.
-    - **`description`** - represents the meta-description and is also used for SEO purposes (not displayed on the published site). Descriptions should be 120-160 characters and should provide a preview into the page topic.
-    - **Page title** - an H1 heading title to be displayed at the top of the page
+    - **`title`**: Represents the `<title>` tag and is used for SEO purposes (not displayed on the published site) Titles have a maximum length of 45 characters.
+    - **`description`**: Represents the meta-description and is also used for SEO purposes (not displayed on the published site). Descriptions should be 120-160 characters and should provide a preview into the page topic.
+    - **Page title**: An H1 heading title to be displayed at the top of the page.
 
-    - **`## Checking Prerequisites` section** - if the guide requires the user to have specific developer tools installed, for example, Docker or MetaMask, it should be listed here
+    - **`## Checking Prerequisites` section**: If the guide requires the user to have specific developer tools installed, for example, Docker or MetaMask, it should be listed here.
 
-- Add the 'Display Name': 'file-name.md' for the new page to the `.pages` folder in the same subdirectory where you added the new page
+- **Add the 'Display Name'**: 'file-name.md' for the new page to the `.pages` folder in the same subdirectory where you added the new page.
 
 An example new content page might look like:
 
@@ -172,10 +172,10 @@ More resources for [SEO Optimization](#search-engine-optimization-seo) of titles
     git checkout -b INSERT_NEW_BRANCH_NAME
     ```
 
-2. Modify content as desired. Remember to place images and code snippets in the appropriate folders (see the following sections for details)
-3. Review the [style guide](https://github.com/papermoonio/documentation-style-guide/blob/main/style-guide.md) to ensure your new content meets the guidelines
-3. Once you commit and push all of your changes, open a pull request for the new content branch against the `main` branch
-4. Monitor notifications and pull requests for feedback from code owners. At least one approval is required before merging content
+2. Modify content as desired. Remember to place images and code snippets in the appropriate folders (see the following sections for details).
+3. Review the [style guide](https://github.com/papermoonio/documentation-style-guide/blob/main/style-guide.md) to ensure your new content meets the guidelines.
+3. Once you commit and push all of your changes, open a pull request for the new content branch against the `main` branch.
+4. Monitor notifications and pull requests for feedback from code owners. At least one approval is required before merging content.
 
 If your additions or modifications are limited to content on an existing page, there is no need to worry about the [`.pages`](#example-pages-file) or [`index.md`](#example-indexmd-file) files, as changes to page content don't affect these files.
 
@@ -222,11 +222,11 @@ In general, titles should be between 50 and 60 characters and descriptions shoul
 
 There are a few tools you may find useful for proofreading and editing your contributions:
 
-- **[Vale](https://vale.sh/)** - the `polkadot-mkdocs` repository contains configuration for Vale, an open source NLP-powered linter for text. The configuration is a work in progress with a growing custom dictionary tailored toward software engineering, blockchain, and Polkadot terms. Running Vale against your files locally can serve as a first round of feedback to speed up the review process
+- **[Vale](https://vale.sh/)**: The `polkadot-mkdocs` repository contains configuration for Vale, an open source NLP-powered linter for text. The configuration is a work in progress with a growing custom dictionary tailored toward software engineering, blockchain, and Polkadot terms. Running Vale against your files locally can serve as a first round of feedback to speed up the review process.
 
 To use Vale locally to screen your work:
 
-1. Visit the Vale site and follow the [installation instructions](https://vale.sh/docs/vale-cli/installation/) 
+1. Visit the Vale site and follow the [installation instructions](https://vale.sh/docs/vale-cli/installation/).
 2. From the `polkadot-mkdocs` directory, run the following in your terminal:
 
     ```bash
@@ -237,8 +237,8 @@ To use Vale locally to screen your work:
 
     ![Vale sample terminal output](images/contributing/vale-output-01.webp)
 
-3. You can use CMD+click to open the file with the flagged items. This is especially helpful if you run Vale against a directory with multiple files
+3. You can use CMD+click to open the file with the flagged items. This is especially helpful if you run Vale against a directory with multiple files.
 
-4. Each flag tells you the line and location of the flagged item, the level of the flag (error, warning, or suggestion), and a suggestion for how to resolve the flag
+4. Each flag tells you the line and location of the flagged item, the level of the flag (error, warning, or suggestion), and a suggestion for how to resolve the flag.
 
-5. Once you have addressed the flagged items and made edits as needed, you can complete the normal steps to commit your changes and open a pull request to review for merge
+5. Once you have addressed the flagged items and made edits as needed, you can complete the normal steps to commit your changes and open a pull request to review for merge.

.snippets/code/develop/toolkit/interoperability/asset-transfer-api/reference/transfer-arg-opts.md

@@ -18,8 +18,8 @@ Options for customizing the claim assets transaction. These options allow you to
 
     The Asset ID to pay fees on the current common good parachain. The defaults are as follows:
 
-    - Polkadot Asset Hub - `'DOT'`
-    - Kusama Asset Hub - `'KSM'`
+    - **Polkadot Asset Hub**: `'DOT'`
+    - **Kusama Asset Hub**: `'KSM'`
 
     ---
 

.snippets/code/develop/toolkit/interoperability/asset-transfer-api/reference/tx-result.md

@@ -133,6 +133,6 @@ A promise containing the result of constructing the transaction.
 
         The `ConstructedFormat` type is a conditional type that returns a specific type based on the value of the TxResult `format` field.
 
-        - **Payload format** - if the format field is set to `'payload'`, the `ConstructedFormat` type will return a [`GenericExtrinsicPayload`](https://github.com/polkadot-js/api/blob/v15.8.1/packages/types/src/extrinsic/ExtrinsicPayload.ts#L87){target=\_blank}
-        - **Call format** - if the format field is set to `'call'`, the `ConstructedFormat` type will return a hexadecimal string (`0x${string}`). This is the encoded representation of the extrinsic call
-        - **Submittable format** - if the format field is set to `'submittable'`, the `ConstructedFormat` type will return a [`SubmittableExtrinsic`](https://github.com/polkadot-js/api/blob/v15.8.1/packages/api-base/src/types/submittable.ts#L56){target=\_blank}. This is a Polkadot.js type that represents a transaction that can be submitted to the blockchain
+        - **Payload format**: If the format field is set to `'payload'`, the `ConstructedFormat` type will return a [`GenericExtrinsicPayload`](https://github.com/polkadot-js/api/blob/v15.8.1/packages/types/src/extrinsic/ExtrinsicPayload.ts#L87){target=\_blank}.
+        - **Call format**: If the format field is set to `'call'`, the `ConstructedFormat` type will return a hexadecimal string (`0x${string}`). This is the encoded representation of the extrinsic call.
+        - **Submittable format**: If the format field is set to `'submittable'`, the `ConstructedFormat` type will return a [`SubmittableExtrinsic`](https://github.com/polkadot-js/api/blob/v15.8.1/packages/api-base/src/types/submittable.ts#L56){target=\_blank}. This is a Polkadot.js type that represents a transaction that can be submitted to the blockchain.

.snippets/code/develop/toolkit/parachains/remote-proxies/remote-proxy-example.js

@@ -0,0 +1,81 @@
+import { ApiPromise, WsProvider } from '@polkadot/api';
+
+// Account configuration - replace with your addresses
+const RECIPIENT_ACCOUNT = 'INSERT_RECIPIENT_ACCOUNT';
+const PROXIED_ACCOUNT = 'INSERT_PROXIED_ACCOUNT';
+
+async function executeRemoteProxyTransaction() {
+  try {
+    // Establish connections to both chains
+    console.log('Connecting to Kusama relay chain...');
+    const kusamaProvider = new WsProvider(
+      'wss://kusama.public.curie.radiumblock.co/ws',
+    );
+    const kusamaApi = await ApiPromise.create({ provider: kusamaProvider });
+
+    console.log('Connecting to Kusama Asset Hub...');
+    const assetHubProvider = new WsProvider(
+      'wss://kusama-asset-hub-rpc.polkadot.io',
+    );
+    const assetHubApi = await ApiPromise.create({ provider: assetHubProvider });
+
+    // Step 1: Generate storage key for proxy definition
+    const proxyStorageKey = kusamaApi.query.proxy.proxies.key(PROXIED_ACCOUNT);
+    console.log(`Proxy storage key: ${proxyStorageKey}`);
+
+    // Step 2: Identify latest recognized block
+    const blockToRootMapping = JSON.parse(
+      await assetHubApi.query.remoteProxyRelayChain.blockToRoot(),
+    );
+    const latestRecognizedBlock =
+      blockToRootMapping[blockToRootMapping.length - 1][0];
+    const blockHash = await kusamaApi.rpc.chain.getBlockHash(
+      latestRecognizedBlock,
+    );
+
+    console.log(`Generating proof for block ${latestRecognizedBlock}`);
+
+    // Step 3: Create storage proof
+    const storageProof = JSON.parse(
+      await kusamaApi.rpc.state.getReadProof([proxyStorageKey], blockHash),
+    );
+
+    // Step 4: Define target transaction
+    const targetTransaction = assetHubApi.tx.balances.transferAll(
+      RECIPIENT_ACCOUNT,
+      false,
+    );
+
+    // Step 5: Construct remote proxy call
+    const remoteProxyCall = assetHubApi.tx.remoteProxyRelayChain.remoteProxy(
+      PROXIED_ACCOUNT,
+      null, // Proxy type filter (null accepts any compatible type)
+      targetTransaction.method,
+      {
+        RelayChain: {
+          proof: storageProof.proof,
+          block: latestRecognizedBlock,
+        },
+      },
+    );
+
+    console.log('\n✅ Remote proxy transaction constructed successfully!');
+    console.log('\n📋 Next steps:');
+    console.log('1. Copy the URL below');
+    console.log('2. Open in Polkadot.js Apps');
+    console.log('3. Submit the transaction within 1 minute');
+    console.log('\n🔗 Polkadot.js Apps URL:');
+    console.log(
+      `https://polkadot.js.org/apps/?rpc=wss%3A%2F%2Fkusama-asset-hub-rpc.polkadot.io#/extrinsics/decode/${remoteProxyCall.method.toHex()}`,
+    );
+
+    // Cleanup connections
+    await kusamaApi.disconnect();
+    await assetHubApi.disconnect();
+  } catch (error) {
+    console.error('❌ Remote proxy execution failed:', error.message);
+  }
+}
+
+// Execute the remote proxy workflow
+executeRemoteProxyTransaction();

.snippets/text/develop/smart-contracts/index/index-timeline.json

@@ -1,27 +1,27 @@
 [
     {
         "title": "Choose a Smart Contract Platform",
-        "content": "Select the platform that best fits your project requirements and development expertise: <br><br> - [**PolkaVM**](/develop/smart-contracts/overview#native-smart-contracts){target=_blank} - Native smart contracts on Polkadot Hub <br> - [**EVM (Parachain-based)**](/develop/smart-contracts/overview#parachain-contracts){target=_blank} - Ethereum Virtual Machine compatibility on parachains <br> - [**Rust (ink!)**](/develop/smart-contracts/overview#other-smart-contract-environments){target=_blank} - contracts using Rust and ink!",
+        "content": "Select the platform that best fits your project requirements and development expertise: <br><br> - [**PolkaVM**](/develop/smart-contracts/overview#native-smart-contracts){target=_blank}: Native smart contracts on Polkadot Hub <br> - [**EVM (parachain-based)**](/develop/smart-contracts/overview#parachain-contracts){target=_blank}: Ethereum Virtual Machine compatibility on parachains <br> - [**Rust (ink!)**](/develop/smart-contracts/overview#other-smart-contract-environments){target=_blank}: Contracts using Rust and ink!",
         "icon": ":fontawesome-solid-1:"
     },
     {
         "title": "Get Network Configuration Details",
-        "content": "Configure your development environment with the appropriate network settings for your chosen platform: <br><br> - **PolkaVM** - [Connect to Polkadot](/develop/smart-contracts/connect-to-polkadot/){target=_blank} <br> - **EVM** - [Moonbeam Documentation](https://docs.moonbeam.network/){target=_blank}, [Astar Documentation](https://docs.astar.network/){target=_blank}, [Acala Documentation](https://wiki.acala.network/){target=_blank} <br> - **Rust (ink!)** - for more information check the [ink! documentation](https://use.ink){target=_blank}",
+        "content": "Configure your development environment with the appropriate network settings for your chosen platform: <br><br> - **PolkaVM**: [Connect to Polkadot](/develop/smart-contracts/connect-to-polkadot/){target=_blank} <br> - **EVM**: [Moonbeam documentation](https://docs.moonbeam.network/){target=_blank}, [Astar documentation](https://docs.astar.network/){target=_blank}, [Acala documentation](https://wiki.acala.network/){target=_blank} <br> - **Rust (ink!)**: For more information, check the [ink! documentation](https://use.ink){target=_blank}",
         "icon": ":fontawesome-solid-2:"
     },
     {
         "title": "Set Up Your Development Environment",
-        "content": "Install and configure the necessary tools and frameworks for your chosen smart contract platform: <br><br> - **PolkaVM/EVM** - [Development Environments](/develop/smart-contracts/dev-environments/){target=_blank} <br> - **Rust (ink!)** - [Development Environment Setup](https://use.ink/getting-started/setup){target=_blank}",
+        "content": "Install and configure the necessary tools and frameworks for your chosen smart contract platform: <br><br> - **PolkaVM/EVM**: [Development Environments](/develop/smart-contracts/dev-environments/){target=_blank} <br> - **Rust (ink!)**: [Development Environment Setup](https://use.ink/getting-started/setup){target=_blank}",
         "icon": ":fontawesome-solid-3:"
     },
     {
         "title": "Write, Compile, Test, and Deploy Your Contracts",
-        "content": "Develop your smart contracts, test their functionality, and deploy them to your chosen network: <br><br> - **PolkaVM/EVM** - [Solidity Development Guide](https://docs.soliditylang.org/en/v0.8.29/introduction-to-smart-contracts.html){target=_blank} <br> - **Rust (ink!)** - [ink! Contract Structure](https://use.ink/basics/contract-template#librs){target=_blank}",
+        "content": "Develop your smart contracts, test their functionality, and deploy them to your chosen network: <br><br> - **PolkaVM/EVM**: [Solidity Development Guide](https://docs.soliditylang.org/en/v0.8.29/introduction-to-smart-contracts.html){target=_blank} <br> - **Rust (ink!)**: [ink! Contract Structure](https://use.ink/basics/contract-template#librs){target=_blank}",
         "icon": ":fontawesome-solid-4:"
     },
     {
         "title": "Interact With Your Deployed Contracts",
-        "content": "Utilize libraries and tools to interact with your deployed smart contracts and integrate them into applications: <br><br> - **PolkaVM/EVM** - [Contract Libraries](/develop/smart-contracts/libraries/) <br> - **Rust (ink!)** - [Contract Interaction](https://use.ink/getting-started/calling-your-contract){target=_blank}",
+        "content": "Utilize libraries and tools to interact with your deployed smart contracts and integrate them into applications: <br><br> - **PolkaVM/EVM**: [Contract Libraries](/develop/smart-contracts/libraries/) <br> - **Rust (ink!)**: [Contract Interaction](https://use.ink/getting-started/calling-your-contract){target=_blank}",
         "icon": ":fontawesome-solid-5:"
     }
 ]

ai-chatbot-policy.md

@@ -0,0 +1,12 @@
+---
+title: AI Chatbot Policy
+description: This AI chatbot policy outlines the terms, conditions, and guidelines you agree to when accessing or using the AI chatbot provided through this Website.
+hide:
+- toc
+- feedback
+- navigation
+---
+
+# AI Chatbot Policy
+
+--8<-- 'https://raw.githubusercontent.com/w3f/polkadot-wiki/refs/heads/master/docs/policies/chatbot-terms.md:5'