chore: hotfix ats scs deployment scripts and update doc (#904)

Signed-off-by: jaime-iobermudez <jaime.bermudez@io.builders>
Signed-off-by: Mario Francia <mariofranciarius@gmail.com>
Signed-off-by: Luigi Navarro <luigi@io.builders>
Co-authored-by: Mario Francia <mariofranciarius@gmail.com>
Co-authored-by: Luigi Navarro <luigi@io.builders>

Author: 3 people

README.md

@@ -230,7 +230,7 @@ This will remove previous build artifacts and reinstall dependencies before buil
 
 Each application has its own .env configuration file.
 
-- ATS Web App: apps/ats/web/.env.local
+- ATS Web App: apps/ats/web/.env
   Defines Hedera endpoints, resolver and factory IDs, and WalletConnect settings.
 
 - Mass Payout Backend: apps/mass-payout/backend/.env
@@ -239,7 +239,7 @@ Each application has its own .env configuration file.
 - Mass Payout Frontend: apps/mass-payout/frontend/.env
   Requires VITE_API_URL and VITE_PORT.
 
-Sample files are provided (.env.sample or .env.example) in each module.
+Sample files are provided as `.env.example` in each module.
 
 ## Development Workflows
 

apps/ats/web/.env.sample apps/ats/web/.env.exampleapps/ats/web/.env.sample renamed to apps/ats/web/.env.example

@@ -1,19 +1,35 @@
+# ATS Web Application - Environment Variables
+#
+# Copy this file to .env and fill in your values.
+# Preconfigured for Hedera Testnet.
+
 # * General
+# Configuration IDs for token types (from the Business Logic Resolver deployment)
 REACT_APP_EQUITY_CONFIG_ID='0x0000000000000000000000000000000000000000000000000000000000000001'
 REACT_APP_EQUITY_CONFIG_VERSION='0'
 REACT_APP_BOND_CONFIG_ID='0x0000000000000000000000000000000000000000000000000000000000000002'
 REACT_APP_BOND_CONFIG_VERSION='0'
+
+# Show cookie disclaimer popup (true/false)
 REACT_APP_SHOW_DISCLAIMER="true"
 
 # * Network Configuration
+# Hedera Mirror Node - used for querying historical data and account info
 REACT_APP_MIRROR_NODE='https://testnet.mirrornode.hedera.com/api/v1/'
+
+# Hedera JSON-RPC Relay - used for contract interactions
 REACT_APP_RPC_NODE='https://testnet.hashio.io/api'
 
-# * Smart Contract Addresses (Version 2.0.1)
+# * Smart Contract Addresses
+# Replace with your deployed contract IDs (Hedera format: 0.0.XXXXX)
+# See packages/ats/contracts for deployment instructions
 REACT_APP_RPC_RESOLVER='0.0.7511642'
 REACT_APP_RPC_FACTORY='0.0.7512002'
 
-# * Hedera Wallet Connnect
+# * Hedera WalletConnect
+# Required for HashPack, Blade, and other WalletConnect-compatible wallets.
+# Not needed if only using MetaMask (connects directly).
+# Get your project ID from https://cloud.walletconnect.com
 REACT_APP_PROJECT_ID='1a2b3c4d [...] 9a0b1c2d3e4f'
 REACT_APP_DAPP_NAME='Asset Tokenization Studio'
 REACT_APP_DAPP_DESCRIPTION='Asset Tokenization Studio. Built on Hedera Hashgraph.'

apps/ats/web/README.md

@@ -49,7 +49,7 @@ npm install
 # Environment Variables
 
 Environment variables should be included in a ".env" file located in `apps/ats/web/`.
-Please refer to ".env.sample" to see the list of variables that must be defined alongside some default values that you could use to start up the application.
+Please refer to ".env.example" to see the list of variables that must be defined alongside some default values that you could use to start up the application.
 
 Below is a description of what each variable represents.
 

docs/ats/developer-guides/contracts/deployed-addresses.md

@@ -23,111 +23,13 @@ Latest deployed smart contract addresses for Asset Tokenization Studio.
 | Factory Proxy          | 0.0.7708432 | 0x5fA65CA30d1984701F10476664327f97c864A9D3 | [View on HashScan](https://hashscan.io/testnet/contract/0.0.7708432) |
 | Factory Implementation | 0.0.7708430 | 0x3803219f13E23998FdDCa67AdA60EeB8E62eEEA8 | [View on HashScan](https://hashscan.io/testnet/contract/0.0.7708430) |
 
-### Token Configurations
-
-| Configuration                               | Config ID | Version | Facet Count |
-| ------------------------------------------- | --------- | ------- | ----------- |
-| Equity                                      | 0x01      | 1       | 44          |
-| Bond (Standard)                             | 0x02      | 1       | 47          |
-| Bond Fixed Rate                             | 0x03      | 1       | 48          |
-| Bond KPI Linked Rate                        | 0x04      | 1       | 48          |
-| Bond Sustainability Performance Target Rate | 0x05      | 1       | 49          |
-
-> **Note**: v4.0.0 introduces four bond types with different interest rate mechanisms. See [Creating Bonds](../../user-guides/creating-bond.md) for details on each bond type.
-
-## Usage in Web App
-
-Configure these addresses in your `.env.local` file:
-
-```bash
-# Smart Contract Version: 4.0.0
-REACT_APP_RPC_RESOLVER='0.0.7707874'
-REACT_APP_RPC_FACTORY='0.0.7708432'
-```
-
-See the complete `.env.sample` in `apps/ats/web/.env.sample` for all required environment variables.
-
-## Usage in SDK
-
-When initializing the SDK, provide these addresses in the configuration:
-
-```typescript
-import { Network, InitializationRequest } from "@hashgraph/asset-tokenization-sdk";
-
-const initRequest = new InitializationRequest({
-  network: "testnet",
-  configuration: {
-    resolverAddress: "0.0.7707874",
-    factoryAddress: "0.0.7708432",
-  },
-  // ... other configuration
-});
-
-await Network.init(initRequest);
-```
-
-See the [SDK Integration Guide](../sdk-integration.md) for complete initialization examples.
-
-## Contract Information
-
-### Business Logic Resolver (BLR) Proxy
-
-The BLR acts as a central registry that maps Business Logic Keys (BLK) to versioned facet implementations. Tokens query the resolver to determine which logic version to execute.
-
-### Factory Proxy
-
-The Factory contract deploys new security tokens using the Diamond Pattern. It creates the token proxy and links it to the appropriate configuration in the Business Logic Resolver.
-
-### ProxyAdmin
-
-Manages upgrade permissions for both the BLR Proxy and Factory Proxy contracts.
-
-## Deployment Statistics
-
-| Metric                | Value      |
-| --------------------- | ---------- |
-| Total Facets Deployed | 192        |
-| Configurations        | 5          |
-| Deployment Date       | 2026-01-22 |
-
 ## Version History
 
 | Version | BLR Proxy   | Factory Proxy | Release Date |
 | ------- | ----------- | ------------- | ------------ |
 | 4.0.0   | 0.0.7707874 | 0.0.7708432   | 2026-01-22   |
 | 2.0.1   | 0.0.7511642 | 0.0.7512002   | 2024-12-23   |
 
-## Deployment Files
-
-Complete deployment outputs including all facet addresses are stored in the repository:
-
-```
-packages/ats/contracts/deployments/
-├── hedera-testnet/
-│   ├── newBlr-2026-01-22T11-09-49.json   # Latest v4.0.0 deployment
-│   └── ...                                # Previous deployments
-└── hedera-mainnet/
-    └── ...
-```
-
-Each deployment file contains:
-
-- Infrastructure contract addresses (ProxyAdmin, BLR, Factory)
-- All facet addresses with their resolver keys
-- Configuration details for each token type
-- Hedera Contract IDs and EVM addresses
-
-**Example**: To get all facet addresses from a deployment:
-
-```bash
-# View the deployment file
-cat packages/ats/contracts/deployments/hedera-testnet/newBlr-2026-01-22T11-09-49.json
-
-# Extract specific facet address using jq
-jq '.facets[] | select(.name == "BondUSAFacet")' \
-  packages/ats/contracts/deployments/hedera-testnet/newBlr-2026-01-22T11-09-49.json
-```
-
 ## Related Resources
 
 - [Contract Architecture](./index.md) - Understanding the diamond pattern