refactor(archive): move historical contracts and adapters to archive directory

- Archived multiple non-EVM adapters (Algorand, Hedera, Tron, TON, Cosmos, Solana) and compliance contracts (IndyVerifier) to `archive/solidity/contracts/`.
- Updated documentation to reflect the historical status of archived components.
- Adjusted `foundry.toml` and `README.md` for clarity on historical dependencies and configurations.
- Enhanced Makefile and package.json scripts for improved contract testing and building processes.
- Removed obsolete contracts (AlltraCustomBridge, CommodityCCIPBridge, ISO4217WCCIPBridge, VaultBridgeAdapter) from the main directory.
- Updated implementation reports to indicate archived status for various components.

scripts/lib/deployment/dotenv.sh

@@ -9,7 +9,8 @@
 # So: use repo-root .env by default; set ENV_FILE to use a different file.
 
 _LIB_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-[[ -z "${PROJECT_ROOT:-}" ]] && PROJECT_ROOT="$(cd "$_LIB_DIR/../.." && pwd)"
+[[ -z "${PROJECT_ROOT:-}" ]] && PROJECT_ROOT="$(cd "$_LIB_DIR/../../.." && pwd)"
+source "$_LIB_DIR/../forge-scope.sh"
 
 # Preferred .env: ENV_FILE if set and readable; else PROJECT_ROOT/.env (repo root).
 load_deployment_env() {

scripts/lib/forge-scope.sh

@@ -0,0 +1,45 @@
+#!/usr/bin/env bash
+
+if [[ -n "${FORGE_SCOPE_HELPER_LOADED:-}" ]]; then
+  return 0
+fi
+
+FORGE_SCOPE_HELPER_LOADED=1
+
+forge_scope_repo_root() {
+  local helper_dir
+  helper_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+  if [[ -n "${PROJECT_ROOT:-}" ]]; then
+    printf '%s\n' "$PROJECT_ROOT"
+    return 0
+  fi
+
+  if [[ -n "${REPO_ROOT:-}" ]]; then
+    printf '%s\n' "$REPO_ROOT"
+    return 0
+  fi
+
+  printf '%s\n' "$(cd "$helper_dir/../.." && pwd)"
+}
+
+forge_scoped() {
+  local root
+  root="$(forge_scope_repo_root)"
+  bash "$root/scripts/forge/scope.sh" "$@"
+}
+
+forge() {
+  if [[ $# -gt 0 ]]; then
+    case "$1" in
+      build|test|script)
+        local subcommand="$1"
+        shift
+        forge_scoped "$subcommand" "$@"
+        return $?
+        ;;
+    esac
+  fi
+
+  command forge "$@"
+}

scripts/lib/init.sh

@@ -31,9 +31,9 @@ source "${LIB_DIR}/common/error-handling.sh" 2>/dev/null || true
 source "${LIB_DIR}/config/env.sh"
 source "${LIB_DIR}/config/regions.sh"
 source "${LIB_DIR}/azure/cli.sh" 2>/dev/null || true
+source "${LIB_DIR}/forge-scope.sh"
 
 # Log that libraries are loaded (only in debug mode)
 # Use default 1 if LOG_LEVEL is unset or not numeric (e.g. from .env)
 _ll="${LOG_LEVEL:-1}"
 [[ "$_ll" =~ ^[0-9]+$ ]] && [ "$_ll" -le 0 ] && log_debug "Common libraries loaded from ${LIB_DIR}" || true
-