feat(urls): configurable base domain via --base-domain

Target a non-decentraland.* deployment (e.g. interconnected.online) by
resolving every backend host through DecentralandUrlsSource.ResolveDomain,
which swaps the whole decentraland.{ENV} host token for a custom base domain
supplied by the --base-domain app arg (AppArgsFlags.BASE_DOMAIN). The default
path is byte-identical, swapping only the {ENV} TLD.

Consumers that follow the resolved domain: teleport validation
(ChatEnvironmentValidator), realm trust (DeepLinkAllowlist), the main-realm
comms fallback (RealmController), the realm-name server list (RealmNamesMap),
the pre-login feature-flag whitelist URL (GetFeatureFlagsUrl), the
smart-wearable content fallback (SmartWearableCache), and the local scene
adapter (LocalGateKeeperSceneAdapter). Gateway routing already follows it: the
transform runs on the {ENV} template and ResolveDomain rewrites the whole
token, gateway host included. The default "Empty place" no longer hardcodes a
peer.decentraland.org thumbnail and falls back to the built-in placeholder.

Characterization tests pin every DecentralandUrl across org/zone/custom
domains and gateway routing (gatekeeper family included); unit tests cover
custom-domain teleport validation and deep-link realm trust.

Author: eordano

Explorer/Assets/DCL/Chat/Commands/ChatEnvironmentValidator.cs

@@ -7,10 +7,12 @@ namespace DCL.Chat.Commands
     public class ChatEnvironmentValidator
     {
         private readonly DecentralandEnvironment dclEnvironment;
+        private readonly string realmDomainSuffix;
 
-        public ChatEnvironmentValidator(DecentralandEnvironment dclEnvironment)
+        public ChatEnvironmentValidator(DecentralandEnvironment dclEnvironment, string realmDomainSuffix)
         {
             this.dclEnvironment = dclEnvironment;
+            this.realmDomainSuffix = realmDomainSuffix;
         }
 
         public Result ValidateTeleport(string realmToTeleportTo)
@@ -21,12 +23,12 @@ public Result ValidateTeleport(string realmToTeleportTo)
                     return Result.ErrorResult(
                         "🔴 Error. You cannot change realms in the Today environment. Please restart DCL with the desired environment");
                 case DecentralandEnvironment.Zone:
-                    return HostHasSuffix(realmToTeleportTo, IDecentralandUrlsSource.ZONE_DOMAIN)
+                    return HostHasSuffix(realmToTeleportTo, realmDomainSuffix)
                         ? Result.SuccessResult()
                         : Result.ErrorResult(
                             "🔴 Error. You cannot teleport to other realms that are not Zone in Zone environment. Please restart DCL with the desired environment");
                 case DecentralandEnvironment.Org:
-                    return HostHasSuffix(realmToTeleportTo, IDecentralandUrlsSource.ORG_DOMAIN)
+                    return HostHasSuffix(realmToTeleportTo, realmDomainSuffix)
                         ? Result.SuccessResult()
                         : Result.ErrorResult(
                             "🔴 Error. You cannot teleport to other realms that are not Org or World in Org environment. Please restart DCL with the desired environment");

Explorer/Assets/DCL/Chat/Commands/Tests/ChatTeleporterShould.cs

@@ -40,7 +40,7 @@ public void SetUp()
             IScenesCache scenesCache = Substitute.For<IScenesCache>();
             scenesCache.CurrentParcel.Returns(currentParcel);
 
-            chatTeleporter = new ChatTeleporter(realmNavigator, new ChatEnvironmentValidator(DecentralandEnvironment.Org), urlsSource, scenesCache);
+            chatTeleporter = new ChatTeleporter(realmNavigator, new ChatEnvironmentValidator(DecentralandEnvironment.Org, IDecentralandUrlsSource.ORG_DOMAIN), urlsSource, scenesCache);
         }
 
         [Test]

Explorer/Assets/DCL/Infrastructure/Global/AppArgs/AppArgsFlags.cs

@@ -22,6 +22,7 @@ public static class AppArgsFlags
         public const string REALM = "realm";
         public const string COMMS_ADAPTER = "comms-adapter";
         public const string GATEKEEPER_URL = "gatekeeper-url";
+        public const string BASE_DOMAIN = "base-domain";
         public const string LOCAL_SCENE = "local-scene";
         public const string POSITION = "position";
         public const string SPAWN_POINT = "spawnpoint";

Explorer/Assets/DCL/Infrastructure/Global/AppArgs/DeepLinkAllowlist.cs

@@ -165,6 +165,13 @@ public static class DeepLinkAllowlist
         // means loopback-only — the safe default when feature flags are unavailable (e.g. before they are fetched).
         private static HashSet<string> whitelistedWorlds = new();
 
+        // Extra first-party base domain (set from --base-domain), trusted for realm hosting exactly like the
+        // decentraland.* domains. Null = decentraland-only.
+        private static string? customBaseDomain;
+
+        public static void SetCustomBaseDomain(string? domain) =>
+            customBaseDomain = string.IsNullOrWhiteSpace(domain) ? null : domain.Trim();
+
         public static bool IsPermitted(string key) =>
             PERMITTED_KEYS.Contains(key);
 
@@ -221,6 +228,12 @@ public static bool IsRealmWhitelisted(string? realm)
         // is what rejects lookalikes such as "decentraland.org.attacker.com" and "evil-decentraland.org".
         private static bool IsDecentralandHost(string host)
         {
+            if (customBaseDomain != null
+                && host.Length > customBaseDomain.Length
+                && host[host.Length - customBaseDomain.Length - 1] == '.'
+                && host.EndsWith(customBaseDomain, StringComparison.OrdinalIgnoreCase))
+                return true;
+
             // Indexed loop, not foreach: enumerating the IReadOnlyList would allocate an enumerator.
             IReadOnlyList<string> domains = IDecentralandUrlsSource.ALL_DOMAINS;
 

Explorer/Assets/DCL/Infrastructure/Global/AppArgs/Tests/AppArgsTests.cs

@@ -10,6 +10,7 @@ public void TearDown()
         {
             // Reset the cached/overridden world whitelist so tests don't leak state into one another.
             DeepLinkAllowlist.SetWhitelistedWorlds(null);
+            DeepLinkAllowlist.SetCustomBaseDomain(null);
         }
 
         [Test]
@@ -281,6 +282,19 @@ public void ClassifyRealmAsWhitelisted(string realm, bool expected)
             Assert.AreEqual(expected, DeepLinkAllowlist.IsRealmWhitelisted(realm));
         }
 
+        [Test]
+        public void TrustCustomBaseDomainHostForWhitelistedRealm()
+        {
+            DeepLinkAllowlist.SetWhitelistedWorlds(new[] { "test-world.dcl.eth" });
+            const string REALM = "https://worlds-content-server.interconnected.online/world/test-world.dcl.eth";
+
+            DeepLinkAllowlist.SetCustomBaseDomain(null);
+            Assert.IsFalse(DeepLinkAllowlist.IsRealmWhitelisted(REALM), "a non-decentraland host is untrusted without --base-domain");
+
+            DeepLinkAllowlist.SetCustomBaseDomain("interconnected.online");
+            Assert.IsTrue(DeepLinkAllowlist.IsRealmWhitelisted(REALM), "the --base-domain host is trusted like decentraland.* once set");
+        }
+
         [Test]
         public void DeferDeepLinkUntilInitializeDeepLinksIsCalled()
         {

Explorer/Assets/DCL/Infrastructure/Global/Dynamic/BootstrapContainer.cs

@@ -133,7 +133,7 @@ await bootstrapContainer.InitializeContainerAsync<BootstrapContainer, BootstrapS
                 var cdpClient = ChromeDevToolHandler.New(applicationParametersParser.HasFlag(AppArgsFlags.LAUNCH_CDP_MONITOR_ON_START));
                 WebRequestsContainer? webRequestsContainer = await WebRequestsContainer.CreateAsync(settingsContainer, identityCache, debugContainer.Builder, decentralandUrlsSource, cdpClient, container.DiagnosticsContainer.SentrySampler, container.RealmClock, ct);
                 container.WebRequestsContainer = webRequestsContainer;
-                var realmUrls = new RealmUrls(realmLaunchSettings, new RealmNamesMap(webRequestsContainer.WebRequestController), decentralandUrlsSource);
+                var realmUrls = new RealmUrls(realmLaunchSettings, new RealmNamesMap(webRequestsContainer.WebRequestController, decentralandUrlsSource), decentralandUrlsSource);
 
                 container.Bootstrap = await CreateBootstrapperAsync(debugSettings, debugContainer, applicationParametersParser, splashScreen, realmUrls, diskCache, partialsDiskCache, container, webRequestsContainer, settingsContainer, realmLaunchSettings, world, container.settings.BuildData, dclVersion, ct);
                 container.CompositeWeb3Provider = CreateWeb3Dependencies(sceneLoaderSettings, web3AccountFactory, identityCache, browser, container.Analytics, decentralandUrlsSource, decentralandEnvironment, applicationParametersParser, webRequestsContainer.WebRequestController, container.DeeplinkSigninIdentityId, container.DeeplinkLoginAwaitingSigninRequestId);

Explorer/Assets/DCL/Infrastructure/Global/Dynamic/ChatContainer.cs

@@ -103,7 +103,10 @@ public static ChatContainer Create(
             var chatHistory = new ChatHistory();
             var chatEventBus = new ChatEventBus();
 
-            var chatTeleporter = new ChatTeleporter(realmNavigator, new ChatEnvironmentValidator(bootstrapContainer.Environment), bootstrapContainer.DecentralandUrlsSource, staticContainer.ScenesCache);
+            string realmDomainSuffix = bootstrapContainer.DecentralandUrlsSource
+                                                          .Url(DCL.Multiplayer.Connections.DecentralandUrls.DecentralandUrl.Host)
+                                                          .Replace("https://", string.Empty);
+            var chatTeleporter = new ChatTeleporter(realmNavigator, new ChatEnvironmentValidator(bootstrapContainer.Environment, realmDomainSuffix), bootstrapContainer.DecentralandUrlsSource, staticContainer.ScenesCache);
 
             var reloadSceneChatCommand = new ReloadSceneChatCommand(reloadSceneController, globalWorld, playerEntity, staticContainer.ScenesCache, teleportController, localSceneDevelopment);
 

Explorer/Assets/DCL/Infrastructure/Global/Dynamic/MainSceneLoader.cs

@@ -257,6 +257,8 @@ private async UniTask InitializeFlowAsync(CancellationToken ct)
 
             applicationParametersParser.TryGetValue(AppArgsFlags.GATEKEEPER_URL, out string? cliGatekeeperUrl);
             applicationParametersParser.TryGetValue(AppArgsFlags.OPTIMIZED_ASSETS_URL, out string? cliOptimizedAssetsUrl);
+            applicationParametersParser.TryGetValue(AppArgsFlags.BASE_DOMAIN, out string? cliBaseDomain);
+            DeepLinkAllowlist.SetCustomBaseDomain(cliBaseDomain);
 
             if (string.IsNullOrEmpty(cliOptimizedAssetsUrl) && launchSettings.useLocalAssetBundles)
                 cliOptimizedAssetsUrl = launchSettings.LocalAssetBundlesBaseUrl();
@@ -268,7 +270,8 @@ private async UniTask InitializeFlowAsync(CancellationToken ct)
                 debugSettings.GatekeeperMode,
                 debugSettings.CustomGatekeeperUrl,
                 cliGatekeeperUrl,
-                cliOptimizedAssetsUrl);
+                cliOptimizedAssetsUrl,
+                cliBaseDomain);
             DiagnosticInfoUtils.LogEnvironment(decentralandUrlsSource);
 
             splashScreen = await assetsProvisioner.ProvideInstanceAsync(splashScreenRef, ct: ct);
@@ -538,9 +541,10 @@ private bool ShouldForceSingleRunningInstance(IAppArgs appArgs)
         private async UniTask InitializeDeepLinkWorldWhitelistAsync(IAppArgs appArgs, CancellationToken ct)
         {
             appArgs.TryGetValue(AppArgsFlags.FeatureFlags.URL, out string? featureFlagsOverride);
+            appArgs.TryGetValue(AppArgsFlags.BASE_DOMAIN, out string? cliBaseDomain);
 
             string featureFlagsBase = string.IsNullOrEmpty(featureFlagsOverride)
-                ? DecentralandUrlsSource.GetFeatureFlagsUrl(decentralandEnvironment)
+                ? DecentralandUrlsSource.GetFeatureFlagsUrl(decentralandEnvironment, cliBaseDomain)
                 : featureFlagsOverride.TrimEnd('/');
 
             IReadOnlyList<string> whitelistedWorlds = await DeepLinkWorldWhitelistProvider.FetchAsync($"{featureFlagsBase}/{FeatureFlagOptions.APP_NAME}.json", ct);

Explorer/Assets/DCL/Infrastructure/Global/Dynamic/RealmController.cs

@@ -371,9 +371,8 @@ private string ResolveHostname(URLDomain realm, ServerAbout about)
             else
                 hostname = about.comms == null
 
-                    // Consider it as the "main" realm which shares the comms with many catalysts
-                    // TODO: take in consideration the web3-network. If its sepolia then it should be .zone
-                    ? "realm-provider." + IDecentralandUrlsSource.ORG_DOMAIN
+                    // Consider it as the "main" realm which shares the comms with many catalysts.
+                    ? "realm-provider." + decentralandUrlsSource.Url(DecentralandUrl.Host).Replace("https://", string.Empty)
                     : new Uri(realm.Value).Host;
 
             return hostname;

Explorer/Assets/DCL/Infrastructure/Global/Dynamic/RealmUrl/Names/RealmNamesMap.cs

@@ -1,5 +1,6 @@
 using Cysharp.Threading.Tasks;
 using DCL.Diagnostics;
+using DCL.Multiplayer.Connections.DecentralandUrls;
 using DCL.Utilities.Extensions;
 using DCL.WebRequests;
 using System;
@@ -11,12 +12,14 @@ namespace Global.Dynamic.RealmUrl.Names
     public class RealmNamesMap : IRealmNamesMap
     {
         private readonly IWebRequestController webRequestController;
+        private readonly IDecentralandUrlsSource decentralandUrlsSource;
         private readonly Dictionary<string, string> cachedUrlToNameDictionary = new ();
         private IReadOnlyList<NodeDTO>? cachedNodes;
 
-        public RealmNamesMap(IWebRequestController webRequestController)
+        public RealmNamesMap(IWebRequestController webRequestController, IDecentralandUrlsSource decentralandUrlsSource)
         {
             this.webRequestController = webRequestController;
+            this.decentralandUrlsSource = decentralandUrlsSource;
         }
 
         public async UniTask<string> UrlFromNameAsync(string name, CancellationToken token)
@@ -38,7 +41,7 @@ private async UniTask<IReadOnlyList<NodeDTO>> NodesAsync(CancellationToken token
         {
             if (cachedNodes == null)
             {
-                CommonArguments arguments = "https://peer.decentraland.org/lambdas/contracts/servers";
+                CommonArguments arguments = decentralandUrlsSource.Url(DecentralandUrl.Servers);
 
                 cachedNodes = await webRequestController
                                    .GetAsync(arguments, token, ReportCategory.GENERIC_WEB_REQUEST)