Merge branch 'main' into dependabot/github_actions/actions/setup-node-4.3.0

Author: MiguelLZPF

.github/pull_request_template.md

@@ -0,0 +1,40 @@
+## Description
+
+Summarize the change and the issue fixed. Include motivation and context. List dependencies. 📝
+
+Fixes # (issue) 🛠️
+
+## Type of change
+
+-   [ ] Bug fix 🐞
+-   [ ] New feature ✨
+-   [ ] Breaking change 💥
+-   [ ] Documentation update 📖
+-   [ ] Refactor 🔧
+
+## Testing
+
+Describe tests and instructions to reproduce. 🧪
+
+-   [ ] Local Tests (npm run test)
+-   [ ] Manual (CLI or web interface)
+-   [ ] Local GitHub Actions (act pull_request)
+
+**Node version**:
+
+-   [ ] 18
+-   [ ] 20
+-   [x] 22
+-   [ ] 23
+
+### Test Results (if any)
+
+## Checklist
+
+-   [ ] Style Guidelines followed ✅
+-   [ ] Self-Reviewed 👀
+-   [ ] Documentation Updated 📚
+-   [ ] **Linters** - No New Warnings ⚠️
+-   [ ] Effective Tests Added ✔️
+-   [ ] Local Tests Pass ✅
+-   [ ] No reduction of **Coverage**

.github/workflows/all.publish.yml

@@ -13,7 +13,7 @@ jobs:
 
     steps:
       - name: Harden Runner
-        uses: step-security/harden-runner@4d991eb9b905ef189e4c376166672c3f2f230481 # v2.11.0
+        uses: step-security/harden-runner@c6295a65d1254861815972266d5933fd6e532bdf # v2.11.1
         with:
           egress-policy: audit
 

.github/workflows/all.test.yml

@@ -38,7 +38,7 @@ jobs:
 
     steps:
       - name: Harden Runner
-        uses: step-security/harden-runner@4d991eb9b905ef189e4c376166672c3f2f230481 # v2.11.0
+        uses: step-security/harden-runner@c6295a65d1254861815972266d5933fd6e532bdf # v2.11.1
         with:
           egress-policy: audit
 

.gitignore

@@ -85,7 +85,6 @@ web_modules/
 
 # Next.js build output
 .next
-out
 
 # Nuxt.js build / generate output
 .nuxt

.husky/pre-commit

@@ -1 +1,2 @@
-npm run pre-commit:sdk
+npm run pre-commit:contracts
+npm run pre-commit:sdk

README.md

@@ -8,19 +8,19 @@
 
 ### Table of Contents
 
-- **[Development manifesto](#development-manifesto)**<br>
-- **[Prerequisites](#prerequisites)**<br>
-- **[Installation](#installation)**<br>
-- **[Build](#build)**<br>
-- **[Setting Up the Environment](#setting-up-the-environment)**<br>
-  - **[Required Environment Variables](#required-environment-variables)**<br>
-  - **[Optional Environment Variables (Hedera Wallet Connect)](#optional-environment-variables-hedera-wallet-connect)**<br>
-  - **[Steps to set up the `.env` file](#steps-to-set-up-the-env-file)**<br>
-- **[Run](#run)**<br>
-- **[Support](#support)**<br>
-- **[Contributing](#contributing)**<br>
-- **[Code of conduct](#code-of-conduct)**<br>
-- **[License](#license)**<br>
+-   **[Development manifesto](#development-manifesto)**<br>
+-   **[Prerequisites](#prerequisites)**<br>
+-   **[Installation](#installation)**<br>
+-   **[Build](#build)**<br>
+-   **[Setting Up the Environment](#setting-up-the-environment)**<br>
+    -   **[Required Environment Variables](#required-environment-variables)**<br>
+    -   **[Optional Environment Variables (Hedera Wallet Connect)](#optional-environment-variables-hedera-wallet-connect)**<br>
+    -   **[Steps to set up the `.env` file](#steps-to-set-up-the-env-file)**<br>
+-   **[Run](#run)**<br>
+-   **[Support](#support)**<br>
+-   **[Contributing](#contributing)**<br>
+-   **[Code of conduct](#code-of-conduct)**<br>
+-   **[License](#license)**<br>
 
 # Development manifesto
 
@@ -34,9 +34,9 @@ By using DDD (Domain-Driven Design), we aim to create a shared language among al
 
 Ensure the following tools are installed with these versions:
 
-- **Node:**`v20.17.0`
-- **NPM:** `v10.8.3`
-- **Yarn:** `v1.22.22`
+-   **Node:**`v20.17.0`
+-   **NPM:** `v10.8.3`
+-   **Yarn:** `v1.22.22`
 
 # Installation
 
@@ -71,72 +71,72 @@ To run the project, you'll need to configure environment variables in the `.env`
 
 ### _General Settings_
 
-- **`REACT_APP_EQUITY_CONFIG_ID`**: Configuration Id for Equities.
-- **`REACT_APP_EQUITY_CONFIG_VERSION`**: Equity Version.
-- **`REACT_APP_BOND_CONFIG_ID`**: configuration Id for Bonds.
-- **`REACT_APP_BOND_CONFIG_VERSION`**: Bond Version.
-- **`REACT_APP_SHOW_DISCLAIMER`**: Set this value to `"true"` to show a disclaimer in the application.
+-   **`REACT_APP_EQUITY_CONFIG_ID`**: Configuration Id for Equities.
+-   **`REACT_APP_EQUITY_CONFIG_VERSION`**: Equity Version.
+-   **`REACT_APP_BOND_CONFIG_ID`**: configuration Id for Bonds.
+-   **`REACT_APP_BOND_CONFIG_VERSION`**: Bond Version.
+-   **`REACT_APP_SHOW_DISCLAIMER`**: Set this value to `"true"` to show a disclaimer in the application.
 
 ### _Network Configuration_
 
-- **`REACT_APP_MIRROR_NODE`**: The URL of the Hedera Mirror Node API used to query historical data from the Hedera testnet. Example: `https://testnet.mirrornode.hedera.com/api/v1/`
-- **`REACT_APP_RPC_NODE`**: The RPC node URL used to communicate with the Hedera testnet. Example: `https://testnet.hashio.io/api`
-- **`REACT_APP_RPC_RESOLVER`**: The Hedera testnet account ID for the resolver. Example: `0.0.5479997`
-- **`REACT_APP_RPC_FACTORY`**: The Hedera testnet account ID for the factory. Example: `0.0.5480051`
+-   **`REACT_APP_MIRROR_NODE`**: The URL of the Hedera Mirror Node API used to query historical data from the Hedera testnet. Example: `https://testnet.mirrornode.hedera.com/api/v1/`
+-   **`REACT_APP_RPC_NODE`**: The RPC node URL used to communicate with the Hedera testnet. Example: `https://testnet.hashio.io/api`
+-   **`REACT_APP_RPC_RESOLVER`**: The Hedera testnet account ID for the resolver. Example: `0.0.5479997`
+-   **`REACT_APP_RPC_FACTORY`**: The Hedera testnet account ID for the factory. Example: `0.0.5480051`
 
 ## Optional Environment Variables (Hedera Wallet Connect)
 
 These variables are only required if you are integrating Hedera Wallet Connect for decentralized application (dApp) interactions. If not needed, they can be omitted.
 
-- **`REACT_APP_PROJECT_ID`**: Project ID for Wallet Connect integration. You can obtain it from the [WalletConnect website](https://walletconnect.com/).
-- **`REACT_APP_DAPP_NAME`**: The name of your dApp as displayed in Wallet Connect.
-- **`REACT_APP_DAPP_DESCRIPTION`**: A description of your dApp, typically displayed in Wallet Connect.
-- **`REACT_APP_DAPP_URL`**: The URL of your dApp that will be referenced in Wallet Connect.
-- **`REACT_APP_DAPP_ICONS`**: An array of URLs pointing to icons for the dApp, typically used in Wallet Connect interfaces. Example: `['https://stablecoinstudio.com/static/media/hedera-hbar-logo.4fd73fb360de0fc15d378e0c3ebe6c80.svg']`
+-   **`REACT_APP_PROJECT_ID`**: Project ID for Wallet Connect integration. You can obtain it from the [WalletConnect website](https://walletconnect.com/).
+-   **`REACT_APP_DAPP_NAME`**: The name of your dApp as displayed in Wallet Connect.
+-   **`REACT_APP_DAPP_DESCRIPTION`**: A description of your dApp, typically displayed in Wallet Connect.
+-   **`REACT_APP_DAPP_URL`**: The URL of your dApp that will be referenced in Wallet Connect.
+-   **`REACT_APP_DAPP_ICONS`**: An array of URLs pointing to icons for the dApp, typically used in Wallet Connect interfaces. Example: `['https://stablecoinstudio.com/static/media/hedera-hbar-logo.4fd73fb360de0fc15d378e0c3ebe6c80.svg']`
 
 ## Steps to set up the `.env` file:
 
 1. Navigate to the `web` module folder.
 2. Copy the `.env.sample` file to create a new `.env` file:
 
-   ```bash
-   cp .env.sample .env
-   ```
+    ```bash
+    cp .env.sample .env
+    ```
 
 3. Open the `.env` file in your preferred text editor.
 4. Replace the placeholder values with your actual environment settings. For example:
 
-   ```bash
-   REACT_APP_EQUITY_CONFIG_ID='0x0000000000000000000000000000000000000000000000000000000000000001'
-   REACT_APP_EQUITY_CONFIG_VERSION="0"
-   REACT_APP_BOND_CONFIG_ID="0x0000000000000000000000000000000000000000000000000000000000000002"
-   REACT_APP_BOND_CONFIG_VERSION="0"
-   REACT_APP_SHOW_DISCLAIMER="true"
-
-   REACT_APP_MIRROR_NODE="https://testnet.mirrornode.hedera.com/api/v1/"
-   REACT_APP_RPC_NODE="https://testnet.hashio.io/api"
-   REACT_APP_RPC_RESOLVER='0.0.5479997'
-   REACT_APP_RPC_FACTORY='0.0.5480051'
-
-   REACT_APP_PROJECT_ID="your_project_id_from_walletconnect"
-   REACT_APP_DAPP_NAME="Asset Tokenization Studio"
-   REACT_APP_DAPP_DESCRIPTION="Asset Tokenization Studio. Built on Hedera Hashgraph."
-   REACT_APP_DAPP_URL="https://wc.ats.com/"
-   REACT_APP_DAPP_ICONS='["https://stablecoinstudio.com/static/media/hedera-hbar-logo.4fd73fb360de0fc15d378e0c3ebe6c80.svg"]'
-   ```
+    ```bash
+    REACT_APP_EQUITY_CONFIG_ID='0x0000000000000000000000000000000000000000000000000000000000000001'
+    REACT_APP_EQUITY_CONFIG_VERSION="0"
+    REACT_APP_BOND_CONFIG_ID="0x0000000000000000000000000000000000000000000000000000000000000002"
+    REACT_APP_BOND_CONFIG_VERSION="0"
+    REACT_APP_SHOW_DISCLAIMER="true"
+
+    REACT_APP_MIRROR_NODE="https://testnet.mirrornode.hedera.com/api/v1/"
+    REACT_APP_RPC_NODE="https://testnet.hashio.io/api"
+    REACT_APP_RPC_RESOLVER='0.0.5827968'
+    REACT_APP_RPC_FACTORY='0.0.5828112'
+
+    REACT_APP_PROJECT_ID="your_project_id_from_walletconnect"
+    REACT_APP_DAPP_NAME="Asset Tokenization Studio"
+    REACT_APP_DAPP_DESCRIPTION="Asset Tokenization Studio. Built on Hedera Hashgraph."
+    REACT_APP_DAPP_URL="https://wc.ats.com/"
+    REACT_APP_DAPP_ICONS='["https://stablecoinstudio.com/static/media/hedera-hbar-logo.4fd73fb360de0fc15d378e0c3ebe6c80.svg"]'
+    ```
 
 5. Save the file and proceed with running the application.
 
 # Run
 
 In order to run the application locally:
 
-- Clone the repository
-- Install the application as described in the _Installation_ section
-- Create a ".env" file in the _web_ module (using the ".env.sample" file as a template)
-- Open a terminal and go to the _web_ folder
-- Run the command : **yarn dev**
-- Open a browser and type in the URL displayed in the terminal (by default it will be : _http://localhost:5173_)
+-   Clone the repository
+-   Install the application as described in the _Installation_ section
+-   Create a ".env" file in the _web_ module (using the ".env.sample" file as a template)
+-   Open a terminal and go to the _web_ folder
+-   Run the command : **yarn dev**
+-   Open a browser and type in the URL displayed in the terminal (by default it will be : _http://localhost:5173_)
 
 # Support
 

addLicence.js

@@ -1,36 +1,95 @@
 #!/usr/bin/env node
-const fs = require("fs-extra");
-const glob = require("glob");
-
-// Function to prepend content to each TypeScript file
-async function prependContentToFiles(rootDirectory, contentFile, fileExtension) {
-  try {
-    // Read the content to be prepended
-    const content = await fs.readFile(contentFile, "utf8");
-    const comment = `/*\n${content}\n*/\n\n`;
-
-    // Find all TypeScript files in the specified root directory, excluding node_modules
-    const files = glob.sync(`${rootDirectory}/**/*.${fileExtension}`, {
-      ignore: "**/node_modules/**", // Exclude node_modules
-    });
-
-    // Prepend the comment to each file
-    for (const file of files) {
-      const existingContent = await fs.readFile(file, "utf8");
-
-      // Check if the license header is already present at the beginning of the file
-      if (!existingContent.startsWith(comment)) {
-        // If not, prepend the comment
-        await fs.writeFile(file, comment + existingContent);
-        console.log(`Prepended content to ${file}`);
-      } else {
-        console.log(`License header already exists in ${file}, skipping.`);
-      }
+const { promises: fs } = require('fs');
+const path = require('path');
+
+async function findFiles(dir, extension) {
+    let files = [];
+    try {
+        const entries = await fs.readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                if (entry.name === 'node_modules') continue;
+                files = files.concat(await findFiles(fullPath, extension));
+            } else if (
+                entry.isFile() &&
+                path.extname(fullPath) === `.${extension}`
+            ) {
+                files.push(fullPath);
+            }
+        }
+    } catch (error) {
+        console.error(`Error reading directory ${dir}:`, error);
+    }
+    return files;
+}
+
+function normalizeLicenseContent(content) {
+    return content
+        .trim()
+        .replace(/\r\n/g, '\n') // Normalize line endings
+        .split('\n')
+        .map((line) => line.trim().replace(/^\*/, '').trim())
+        .join('\n')
+        .replace(/\s+/g, ' ')
+        .replace(/\n+/g, '\n');
+}
+
+async function prependContentToFiles(
+    rootDirectory,
+    contentFile,
+    fileExtension
+) {
+    try {
+        const content = await fs.readFile(contentFile, 'utf8');
+        const comment = `/*\n${content}\n*/\n\n`;
+
+        // Create normalized version for comparison
+        const licenseNormalized = normalizeLicenseContent(content);
+
+        const files = await findFiles(rootDirectory, fileExtension);
+        if (files.length === 0) {
+            console.log('No matching files found.');
+            return;
+        }
+
+        for (const file of files) {
+            try {
+                const existingContent = await fs.readFile(file, 'utf8');
+
+                // Check for existing license using more sophisticated detection
+                const existingHeaderMatch =
+                    existingContent.match(/^\/\*[\s\S]*?\*\//);
+                let hasExistingLicense = false;
+
+                if (existingHeaderMatch) {
+                    const existingHeader = existingHeaderMatch[0];
+                    const existingNormalized = normalizeLicenseContent(
+                        existingHeader
+                            .replace(/^\/\*+/, '')
+                            .replace(/\*+\/$/, '')
+                    );
+
+                    // Compare normalized content
+                    hasExistingLicense =
+                        existingNormalized === licenseNormalized;
+                }
+
+                if (!hasExistingLicense) {
+                    await fs.writeFile(file, comment + existingContent);
+                    console.log(`Prepended content to ${file}`);
+                } else {
+                    console.log(
+                        `Valid license header already exists in ${file}, skipping.`
+                    );
+                }
+            } catch (error) {
+                console.error(`Error processing file ${file}:`, error);
+            }
+        }
+    } catch (error) {
+        console.error('Error:', error);
     }
-  } catch (error) {
-    console.error("Error:", error);
-  }
 }
 
-// Usage example: Applies to all `.ts` files in the current directory and its subdirectories, excluding node_modules
-prependContentToFiles("./", "./LICENSE", "ts");
+prependContentToFiles('./', './LICENSE', 'ts');