FIX - web3js refactor (#1244)

* fix: web3js refactor + llms

* Update smart-contracts/libraries/web3-js.md

* Update smart-contracts/libraries/web3-js.md

* Update smart-contracts/libraries/web3-js.md

* Update smart-contracts/libraries/web3-js.md

* edit file location

* remove unnecessary title

* update where to go next section

* llms

* fix: unneeded tip

* fix: wording

* fix: chain name to polkadotTestNet

---------

Co-authored-by: Erin Shaben <[email protected]>

Author: nhussein11

.ai/categories/smart-contracts.md

@@ -5209,15 +5209,15 @@
   },
   {
     "id": "smart-contracts-libraries-web3-js",
-    "title": "Web3.js",
+    "title": "Deploy Contracts to Polkadot Hub with Web3.js",
     "slug": "smart-contracts-libraries-web3-js",
     "categories": [
       "Smart Contracts",
       "Tooling"
     ],
     "raw_md_url": "https://raw.githubusercontent.com/polkadot-developers/polkadot-docs/master/.ai/pages/smart-contracts-libraries-web3-js.md",
     "html_url": "https://docs.polkadot.com/smart-contracts/libraries/web3-js/",
-    "preview": "!!! smartcontract \"PolkaVM Preview Release\" PolkaVM smart contracts with Ethereum compatibility are in **early-stage development and may be unstable or incomplete**. !!! warning Web3.js has been [sunset](https://blog.chainsafe.io/web3-js-sunset/){target=\\_blank}. You can find guides on using [Ethers.js](/smart-contracts/libraries/ethers-js/){target=\\_blank} and [viem](/smart-contracts/libraries/viem/){target=\\_blank} in the Libraries section.",
+    "preview": "!!! warning Web3.js has been [sunset](https://blog.chainsafe.io/web3-js-sunset/){target=\\_blank}. You can find guides on using [Ethers.js](/smart-contracts/libraries/ethers-js/){target=\\_blank} and [viem](/smart-contracts/libraries/viem/){target=\\_blank} in the Libraries section.",
     "outline": [
       {
         "depth": 2,
@@ -5254,10 +5254,20 @@
         "title": "Compile Contracts",
         "anchor": "compile-contracts"
       },
+      {
+        "depth": 3,
+        "title": "Sample Storage Smart Contract",
+        "anchor": "sample-storage-smart-contract"
+      },
+      {
+        "depth": 3,
+        "title": "Compile the Smart Contract",
+        "anchor": "compile-the-smart-contract"
+      },
       {
         "depth": 2,
-        "title": "Contract Deployment",
-        "anchor": "contract-deployment"
+        "title": "Deploy the Compiled Contract",
+        "anchor": "deploy-the-compiled-contract"
       },
       {
         "depth": 2,
@@ -5271,12 +5281,12 @@
       }
     ],
     "stats": {
-      "chars": 13266,
-      "words": 1579,
-      "headings": 10,
-      "estimated_token_count_total": 3035
+      "chars": 20325,
+      "words": 2290,
+      "headings": 12,
+      "estimated_token_count_total": 4600
     },
-    "hash": "sha256:f0d36333d0d3afff7f6374a61d0f6d1fb878c9ef4c4e4c24447745661dbe59d0",
+    "hash": "sha256:7cf1e07d1b8ef4e7b893398976907159a932f23f708d4e1d7ac1d09b80881787",
     "token_estimator": "heuristic-v1"
   },
   {

.ai/categories/tooling.md

@@ -1,37 +1,71 @@
-const { compile } = require('@parity/resolc');
-const { readFileSync, writeFileSync } = require('fs');
+const solc = require('solc');
+const { readFileSync, writeFileSync, mkdirSync, existsSync } = require('fs');
 const { basename, join } = require('path');
 
-const compileContract = async (solidityFilePath, outputDir) => {
+const ensureDir = (dirPath) => {
+  if (!existsSync(dirPath)) {
+    mkdirSync(dirPath, { recursive: true });
+  }
+};
+
+const compileContract = (solidityFilePath, abiDir, artifactsDir) => {
   try {
     // Read the Solidity file
     const source = readFileSync(solidityFilePath, 'utf8');
-
-    // Construct the input object for the compiler
+    const fileName = basename(solidityFilePath);
+    
+    // Construct the input object for the Solidity compiler
     const input = {
-      [basename(solidityFilePath)]: { content: source },
+      language: 'Solidity',
+      sources: {
+        [fileName]: {
+          content: source,
+        },
+      },
+      settings: {
+        outputSelection: {
+          '*': {
+            '*': ['abi', 'evm.bytecode'],
+          },
+        },
+      },
     };
-
-    console.log(`Compiling contract: ${basename(solidityFilePath)}...`);
-
+    
+    console.log(`Compiling contract: ${fileName}...`);
+    
     // Compile the contract
-    const out = await compile(input);
-
-    for (const contracts of Object.values(out.contracts)) {
-      for (const [name, contract] of Object.entries(contracts)) {
-        console.log(`Compiled contract: ${name}`);
+    const output = JSON.parse(solc.compile(JSON.stringify(input)));
+    
+    // Check for errors
+    if (output.errors) {
+      const errors = output.errors.filter(error => error.severity === 'error');
+      if (errors.length > 0) {
+        console.error('Compilation errors:');
+        errors.forEach(err => console.error(err.formattedMessage));
+        return;
+      }
+      // Show warnings
+      const warnings = output.errors.filter(error => error.severity === 'warning');
+      warnings.forEach(warn => console.warn(warn.formattedMessage));
+    }
+    
+    // Ensure output directories exist
+    ensureDir(abiDir);
+    ensureDir(artifactsDir);
 
+    // Process compiled contracts
+    for (const [sourceFile, contracts] of Object.entries(output.contracts)) {
+      for (const [contractName, contract] of Object.entries(contracts)) {
+        console.log(`Compiled contract: ${contractName}`);
+        
         // Write the ABI
-        const abiPath = join(outputDir, `${name}.json`);
+        const abiPath = join(abiDir, `${contractName}.json`);
         writeFileSync(abiPath, JSON.stringify(contract.abi, null, 2));
         console.log(`ABI saved to ${abiPath}`);
-
+        
         // Write the bytecode
-        const bytecodePath = join(outputDir, `${name}.polkavm`);
-        writeFileSync(
-          bytecodePath,
-          Buffer.from(contract.evm.bytecode.object, 'hex'),
-        );
+        const bytecodePath = join(artifactsDir, `${contractName}.bin`);
+        writeFileSync(bytecodePath, contract.evm.bytecode.object);
         console.log(`Bytecode saved to ${bytecodePath}`);
       }
     }
@@ -40,7 +74,8 @@ const compileContract = async (solidityFilePath, outputDir) => {
   }
 };
 
-const solidityFilePath = './Storage.sol';
-const outputDir = '.';
+const solidityFilePath = join(__dirname, '../contracts/Storage.sol');
+const abiDir = join(__dirname, '../abis');
+const artifactsDir = join(__dirname, '../artifacts');
 
-compileContract(solidityFilePath, outputDir);
+compileContract(solidityFilePath, abiDir, artifactsDir);

.ai/pages/smart-contracts-libraries-web3-js.md

@@ -1,82 +1,98 @@
-import { readFileSync } from 'fs';
-import { Web3 } from 'web3';
+const { writeFileSync, existsSync, readFileSync } = require('fs');
+const { join } = require('path');
+const { Web3 } = require('web3');
+
+const scriptsDir = __dirname;
+const abisDir = join(__dirname, '../abis');
+const artifactsDir = join(__dirname, '../artifacts');
+
+const createProvider = (rpcUrl, chainId, chainName) => {
+  const web3 = new Web3(rpcUrl);
+  return web3;
+};
 
 const getAbi = (contractName) => {
   try {
-    return JSON.parse(readFileSync(`${contractName}.json`), 'utf8');
+    const abiPath = join(abisDir, `${contractName}.json`);
+    return JSON.parse(readFileSync(abiPath, 'utf8'));
   } catch (error) {
     console.error(
-      `❌ Could not find ABI for contract ${contractName}:`,
-      error.message
+      `Could not find ABI for contract ${contractName}:`,
+      error.message,
     );
     throw error;
   }
 };
 
 const getByteCode = (contractName) => {
   try {
-    return `0x${readFileSync(`${contractName}.polkavm`).toString('hex')}`;
+    const bytecodePath = join(artifactsDir, `${contractName}.bin`);
+    const bytecode = readFileSync(bytecodePath, 'utf8').trim();
+    return bytecode.startsWith('0x') ? bytecode : `0x${bytecode}`;
   } catch (error) {
     console.error(
-      `❌ Could not find bytecode for contract ${contractName}:`,
-      error.message
+      `Could not find bytecode for contract ${contractName}:`,
+      error.message,
     );
     throw error;
   }
 };
 
-export const deploy = async (config) => {
+const deployContract = async (contractName, privateKey, providerConfig) => {
+  console.log(`Deploying ${contractName}...`);
   try {
-    // Initialize Web3 with RPC URL
-    const web3 = new Web3(config.rpcUrl);
+    const web3 = createProvider(
+      providerConfig.rpc,
+      providerConfig.chainId,
+      providerConfig.name,
+    );
 
-    // Prepare account
-    const account = web3.eth.accounts.privateKeyToAccount(config.privateKey);
+    const formattedPrivateKey = privateKey.startsWith('0x') ? privateKey : `0x${privateKey}`;
+    const account = web3.eth.accounts.privateKeyToAccount(formattedPrivateKey);
     web3.eth.accounts.wallet.add(account);
+    web3.eth.defaultAccount = account.address;
 
-    // Load abi
-    const abi = getAbi('Storage');
-
-    // Create contract instance
+    const abi = getAbi(contractName);
+    const bytecode = getByteCode(contractName);
     const contract = new web3.eth.Contract(abi);
-
-    // Prepare deployment
-    const deployTransaction = contract.deploy({
-      data: getByteCode('Storage'),
-      arguments: [], // Add constructor arguments if needed
+    const deployTx = contract.deploy({
+      data: bytecode,
     });
 
-    // Estimate gas
-    const gasEstimate = await deployTransaction.estimateGas({
-      from: account.address,
-    });
-
-    // Get current gas price
+    const gas = await deployTx.estimateGas();
     const gasPrice = await web3.eth.getGasPrice();
 
-    // Send deployment transaction
-    const deployedContract = await deployTransaction.send({
+    console.log(`Estimated gas: ${gas}`);
+    console.log(`Gas price: ${web3.utils.fromWei(gasPrice, 'gwei')} gwei`);
+
+    const deployedContract = await deployTx.send({
       from: account.address,
-      gas: gasEstimate,
+      gas: gas,
       gasPrice: gasPrice,
     });
 
-    // Log and return contract details
-    console.log(`Contract deployed at: ${deployedContract.options.address}`);
-    return deployedContract;
+    const address = deployedContract.options.address;
+    console.log(`Contract ${contractName} deployed at: ${address}`);
+
+    const addressesFile = join(scriptsDir, 'contract-address.json');
+    const addresses = existsSync(addressesFile)
+      ? JSON.parse(readFileSync(addressesFile, 'utf8'))
+      : {};
+
+    addresses[contractName] = address;
+    writeFileSync(addressesFile, JSON.stringify(addresses, null, 2), 'utf8');
   } catch (error) {
-    console.error('Deployment failed:', error);
-    throw error;
+    console.error(`Failed to deploy contract ${contractName}:`, error);
   }
 };
 
-// Example usage
-const deploymentConfig = {
-  rpcUrl: 'INSERT_RPC_URL',
-  privateKey: 'INSERT_PRIVATE_KEY',
-  contractName: 'INSERT_CONTRACT_NAME',
+const providerConfig = {
+  rpc: 'https://testnet-passet-hub-eth-rpc.polkadot.io', // TODO: replace to `https://services.polkadothub-rpc.com/testnet` when ready
+  chainId: 420420422,
+  name: 'polkadotTestNet',
 };
 
-deploy(deploymentConfig)
-  .then((contract) => console.log('Deployment successful'))
-  .catch((error) => console.error('Deployment error'));
+const privateKey = 'INSERT_PRIVATE_KEY';
+
+deployContract('Storage', privateKey, providerConfig);
+

.ai/site-index.json

@@ -8,7 +8,7 @@ const createProvider = (rpcUrl) => {
 const PROVIDER_RPC = {
   rpc: 'https://testnet-passet-hub-eth-rpc.polkadot.io',
   chainId: 420420422,
-  name: 'polkadot-hub-testnet',
+  name: 'polkadotTestNet',
 };
 
 const main = async () => {