Merge branch 'master' into 0xlucca/update-deps-050625

Author: 0xLucca

.CONTRIBUTING.md

@@ -68,7 +68,7 @@ To set up the structure, follow these steps:
 
     This command will install all dependencies listed in the `requirements.txt` file.
 
-2. Switch to the polkadot-docs directory and use [npm](https://docs.npmjs.com/about-npm) to install dependencies:
+2. Switch to the `polkadot-docs` directory and use [npm](https://docs.npmjs.com/about-npm) to install dependencies:
 
     ```bash
     cd polkadot-docs && npm install

.snippets/code/Cargo.lock

@@ -4,15 +4,9 @@
   <br />
   <span data-ty>active toolchain</span>
   <span data-ty>----------------</span>
-  <br />
-  <span data-ty>stable-x86_64-apple-darwin (default)</span>
-  <span data-ty>rustc 1.81.0 (eeb90cda1 2024-09-04)</span>
-  <br />
-  <span data-ty>...</span>
-  <br />
-  <span data-ty>active toolchain</span>
-  <span data-ty>----------------</span>
-  <br />
-  <span data-ty>nightly-x86_64-apple-darwin (overridden by +toolchain on the command line)</span>
-  <span data-ty>rustc 1.83.0-nightly (6c6d21008 2024-09-22)</span>
+  <span data-ty>name: stable-aarch64-apple-darwin</span>
+  <span data-ty>active because: it's the default toolchain</span>
+  <span data-ty>installed targets:</span>
+  <span data-ty>  aarch64-apple-darwin</span>
+  <span data-ty>  wasm32-unknown-unknown</span>
 </div>

.snippets/code/develop/parachains/get-started/install-polkadot-sdk/termynal-2.html

@@ -0,0 +1,19 @@
+// SPDX-License-Identifier: MIT
+
+pragma solidity ^0.8.0;
+
+contract Incrementer {
+    uint256 public number;
+
+    constructor(uint256 _initialNumber) {
+        number = _initialNumber;
+    }
+
+    function increment(uint256 _value) public {
+        number = number + _value;
+    }
+
+    function reset() public {
+        number = 0;
+    }
+}

.snippets/code/develop/smart-contracts/contract-verification/Incrementer.sol

@@ -0,0 +1,38 @@
+// hardhat.config.js
+require('@nomicfoundation/hardhat-toolbox');
+
+require('@parity/hardhat-polkadot');
+
+/** @type import('hardhat/config').HardhatUserConfig */
+module.exports = {
+  solidity: '0.8.28',
+  resolc: {
+    compilerSource: 'binary',
+    settings: {
+      compilerPath: 'INSERT_PATH_TO_RESOLC_COMPILER',
+    },
+  },
+  networks: {
+    hardhat: {
+      polkavm: true,
+      nodeConfig: {
+        nodeBinaryPath: 'INSERT_PATH_TO_SUBSTRATE_NODE',
+        rpcPort: 8000,
+        dev: true,
+      },
+      adapterConfig: {
+        adapterBinaryPath: 'INSERT_PATH_TO_ETH_RPC_ADAPTER',
+        dev: true,
+      },
+    },
+    localNode: {
+      polkavm: true,
+      url: `http://127.0.0.1:8545`,
+    },
+    polkadotHubTestnet: {
+      polkavm: true,
+      url: 'https://testnet-passet-hub-eth-rpc.polkadot.io',
+      accounts: [process.env.PRIVATE_KEY],
+    },
+  },
+};

.snippets/code/develop/smart-contracts/dev-environments/hardhat/binary-hardhat.config.js

@@ -0,0 +1,11 @@
+const { JsonRpcProvider } = require('ethers');
+const provider = new JsonRpcProvider('http://localhost:8545');
+const wallet = new ethers.Wallet('INSERT_PRIVATE_KEY', provider);
+
+// Deploy using direct provider instead of Hardhat's wrapper
+const ContractFactory = new ethers.ContractFactory(
+  contractABI,
+  contractBytecode,
+  wallet,
+);
+const contract = await ContractFactory.deploy(...constructorArgs);

.snippets/code/develop/smart-contracts/dev-environments/hardhat/disclaimer-json-rpc-provider-alternative.js

@@ -0,0 +1,20 @@
+<div id="termynal" data-termynal>
+  <span data-ty="input"><span class="file-path"></span>npx hardhat node</span>
+  <br />
+  <span data-ty>Starting server at 127.0.0.1:8000</span>
+  <span data-ty>../bin/substrate-node --rpc-port=8000 --dev</span>
+  <span data-ty>Starting the Eth RPC Adapter at 127.0.0.1:8545</span>
+  <span data-ty>../bin/eth-rpc --node-rpc-url=ws://localhost:8000 --dev</span>
+  <span data-ty>2025-05-29 13:00:32 Running in --dev mode, RPC CORS has been disabled.</span>
+  <span data-ty>2025-05-29 13:00:32 Running in --dev mode, RPC CORS has been disabled.</span>
+  <span data-ty>2025-05-29 13:00:32 🌐 Connecting to node at: ws://localhost:8000 ...</span>
+  <span data-ty>2025-05-29 13:00:32 Substrate Node</span>
+  <span data-ty>2025-05-29 13:00:32 ✌️ version 3.0.0-dev-f73c228b7a1</span>
+  <span data-ty>2025-05-29 13:00:32 ❤️ by Parity Technologies &lt;[email protected]&gt;, 2017-2025</span>
+  <span data-ty>2025-05-29 13:00:32 📋 Chain specification: Development</span>
+  <span data-ty>2025-05-29 13:00:32 🏷 Node name: electric-activity-4221</span>
+  <span data-ty>2025-05-29 13:00:32 👤 Role: AUTHORITY</span>
+  <span data-ty>2025-05-29 13:00:32 💾 Database: RocksDb at /var/folders/f4/7rdt2m9d7j361dm453cpggbm0000gn/T/substrateOaoecu/chains/dev/db/full</span>
+  <span data-ty>2025-05-29 13:00:36 [0] 💸 generated 1 npos voters, 1 from validators and 0 nominators</span>
+  <span data-ty>...</span>
+</div>

.snippets/code/develop/smart-contracts/dev-environments/hardhat/hardhat-node-output.html

@@ -0,0 +1,35 @@
+// hardhat.config.js
+require('@nomicfoundation/hardhat-toolbox');
+
+require('@parity/hardhat-polkadot');
+
+/** @type import('hardhat/config').HardhatUserConfig */
+module.exports = {
+  solidity: '0.8.28',
+  resolc: {
+    compilerSource: 'npm',
+  },
+  networks: {
+    hardhat: {
+      polkavm: true,
+      nodeConfig: {
+        nodeBinaryPath: 'INSERT_PATH_TO_SUBSTRATE_NODE',
+        rpcPort: 8000,
+        dev: true,
+      },
+      adapterConfig: {
+        adapterBinaryPath: 'INSERT_PATH_TO_ETH_RPC_ADAPTER',
+        dev: true,
+      },
+    },
+    localNode: {
+      polkavm: true,
+      url: `http://127.0.0.1:8545`,
+    },
+    polkadotHubTestnet: {
+      polkavm: true,
+      url: 'https://testnet-passet-hub-eth-rpc.polkadot.io',
+      accounts: [vars.get('PRIVATE_KEY')],
+    },
+  },
+};

.snippets/code/develop/smart-contracts/dev-environments/hardhat/hardhat.config.js

@@ -0,0 +1,34 @@
+const hre = require('hardhat');
+
+async function main() {
+  // Get the contract factory
+  const MyToken = await hre.ethers.getContractFactory('MyToken');
+
+  // Replace with your deployed contract address
+  const contractAddress = 'INSERT_CONTRACT_ADDRESS';
+
+  // Attach to existing contract
+  const token = await MyToken.attach(contractAddress);
+
+  // Get signers
+  const [deployer] = await hre.ethers.getSigners();
+
+  // Read contract state
+  const name = await token.name();
+  const symbol = await token.symbol();
+  const totalSupply = await token.totalSupply();
+  const balance = await token.balanceOf(deployer.address);
+
+  console.log(`Token: ${name} (${symbol})`);
+  console.log(
+    `Total Supply: ${hre.ethers.formatUnits(totalSupply, 18)} tokens`,
+  );
+  console.log(
+    `Deployer Balance: ${hre.ethers.formatUnits(balance, 18)} tokens`,
+  );
+}
+
+main().catch((error) => {
+  console.error(error);
+  process.exitCode = 1;
+});

.snippets/code/develop/smart-contracts/dev-environments/hardhat/interact.js

@@ -0,0 +1,18 @@
+// This setup uses Hardhat Ignition to manage smart contract deployments.
+// Learn more about it at https://hardhat.org/ignition
+
+const { buildModule } = require('@nomicfoundation/hardhat-ignition/modules');
+
+const JAN_1ST_2030 = 18934560000000;
+const ONE_GWEI = 1_000_000_000n;
+
+module.exports = buildModule('LockModule', (m) => {
+  const unlockTime = m.getParameter('unlockTime', JAN_1ST_2030);
+  const lockedAmount = m.getParameter('lockedAmount', ONE_GWEI);
+
+  const lock = m.contract('Lock', [unlockTime], {
+    value: lockedAmount,
+  });
+
+  return { lock };
+});