@le-space/ui 0.8.0 → 0.9.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@le-space/ui",
-  "version": "0.8.0",
+  "version": "0.9.1",
   "description": "Floating Aleph Relay Button UI components for Svelte and React.",
   "license": "MIT",
   "type": "module",
@@ -44,8 +44,8 @@
     "url": "https://github.com/NiKrause/relay-button/issues"
   },
   "dependencies": {
-    "@le-space/browser": "0.8.0",
-    "@le-space/core": "0.8.0",
+    "@le-space/browser": "0.9.1",
+    "@le-space/core": "0.9.1",
     "viem": "^2.53.1"
   },
   "peerDependencies": {

package/react/index.d.ts

@@ -1,5 +1,8 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
+type CrnSource = 'list' | 'aggregate';
+type CrnSourcePreference = 'auto' | 'aggregate' | 'list';
+
 type MessageStatus = 'processed' | 'pending' | 'rejected' | 'removing' | 'removed' | 'unknown';
 interface BalanceResponse {
     address: string;
@@ -222,6 +225,12 @@ interface SponsorRelayProps {
     apiHost?: string;
     apiHosts?: string | readonly string[];
     crnListUrl?: string;
+    /**
+     * Which CRN source to read. `auto` falls back to the corechannel aggregate
+     * when crns.json is down, `aggregate` skips crns.json, `list` disables the
+     * fallback. `localStorage.LE_SPACE_CRN_SOURCE` overrides this at runtime.
+     */
+    crnSource?: CrnSourcePreference;
     schedulerApiHost?: string;
     twoN6ApiHost?: string;
 }
@@ -346,6 +355,8 @@ interface SponsorRelayState {
     pricingSummary: SponsorRelayPricingSummary;
     balance: BalanceResponse | null;
     crns: Crn[];
+    /** Which source the current `crns` came from; `null` until the first load. */
+    crnSource: CrnSource | null;
     selectedCrn: Crn | null;
     crnOptions: Array<{
         hash: string;

package/react/index.js

@@ -43,7 +43,7 @@ var RECENT_INSTANCE_RUNTIME_GRACE_MS = 10 * 60 * 1e3;
 var DEPLOYMENT_PENDING_WARNING_MS = 3 * 60 * 1e3;
 
 // src/shared/package-version.ts
-var UI_PACKAGE_VERSION = "0.8.0";
+var UI_PACKAGE_VERSION = "0.9.1";
 
 // src/shared/format.ts
 function shortHash(value, head = 8, tail = 6) {
@@ -141,6 +141,8 @@ var DEFAULT_ALEPH_API_HOSTS = [
 ];
 var DEFAULT_ALEPH_API_HOST = DEFAULT_ALEPH_API_HOSTS[0] ?? "https://api2.aleph.im";
 var DEFAULT_CRN_LIST_URL = "https://crns-list.aleph.sh/crns.json";
+var DEFAULT_CRN_AGGREGATE_ADDRESS = "0xa1B3bb7d2332383D96b7796B908fB7f7F3c2Be10";
+var DEFAULT_CRN_AGGREGATE_KEY = "corechannel";
 var DEFAULT_ALEPH_SCHEDULER_API_HOST = "https://scheduler.api.aleph.cloud";
 var DEFAULT_2N6_API_HOST = "https://api.2n6.me";
 function normalizeMessageStatus(status) {
@@ -195,7 +197,7 @@ async function fetchBalance(address, apiHost = DEFAULT_ALEPH_API_HOST) {
   if (!response.ok) throw new Error(`Balance request failed: ${response.status}`);
   return await response.json();
 }
-async function fetchCrns(url = DEFAULT_CRN_LIST_URL) {
+async function fetchCrnsFromList(url = DEFAULT_CRN_LIST_URL) {
   const requestUrl = new URL(url);
   requestUrl.searchParams.set("filter_inactive", "true");
   const response = await fetchWithTimeout(requestUrl, { cache: "no-cache" });
@@ -203,6 +205,130 @@ async function fetchCrns(url = DEFAULT_CRN_LIST_URL) {
   const payload = await response.json();
   return payload.crns ?? [];
 }
+function asFiniteNumber(value) {
+  if (value == null || value === "") return null;
+  const numeric = typeof value === "number" ? value : Number(value);
+  return Number.isFinite(numeric) ? numeric : null;
+}
+function normalizeCrnAddress(value) {
+  const address = asString(value);
+  if (!address) return null;
+  const withScheme = /^https?:\/\//i.test(address) ? address : `https://${address}`;
+  try {
+    return new URL(withScheme).toString().replace(/\/+$/, "");
+  } catch {
+    return null;
+  }
+}
+function mapResourceNodesToCrns(resourceNodes) {
+  if (!Array.isArray(resourceNodes)) return [];
+  const crns = [];
+  for (const node of resourceNodes) {
+    if (!node || typeof node !== "object") continue;
+    const entry = node;
+    const hash = asString(entry.hash);
+    const address = normalizeCrnAddress(entry.address);
+    const type = asString(entry.type)?.toLowerCase();
+    const status = asString(entry.status)?.toLowerCase();
+    if (!hash || !address) continue;
+    if (entry.inactive_since != null || entry.locked === true) continue;
+    if (type && type !== "compute") continue;
+    if (status && status !== "linked" && status !== "active") continue;
+    if (!asString(entry.parent)) continue;
+    const score = asFiniteNumber(entry.score) ?? asFiniteNumber(entry.scoreV1);
+    const performance = asFiniteNumber(entry.performance);
+    const decentralization = asFiniteNumber(entry.decentralization);
+    crns.push({
+      hash,
+      address,
+      name: asString(entry.name) ?? hash,
+      ...score == null ? {} : { score },
+      ...performance == null ? {} : { performance },
+      ...decentralization == null ? {} : { decentralization }
+    });
+  }
+  return crns;
+}
+async function fetchCrnsFromAggregate(apiHosts = DEFAULT_ALEPH_API_HOSTS, address = DEFAULT_CRN_AGGREGATE_ADDRESS) {
+  const hosts = apiHosts.length > 0 ? apiHosts : DEFAULT_ALEPH_API_HOSTS;
+  let lastError = null;
+  for (const apiHost of hosts) {
+    try {
+      const url = new URL(`/api/v0/aggregates/${address}.json`, apiHost);
+      url.searchParams.set("keys", DEFAULT_CRN_AGGREGATE_KEY);
+      const response = await fetchWithTimeout(url, { cache: "no-cache" });
+      if (!response.ok) {
+        lastError = new Error(`CRN aggregate request failed: ${response.status}`);
+        continue;
+      }
+      const payload = await response.json();
+      const crns = mapResourceNodesToCrns(payload?.data?.corechannel?.resource_nodes);
+      if (crns.length > 0) return crns;
+      lastError = new Error("CRN aggregate contained no deployable resource nodes");
+    } catch (error) {
+      lastError = error;
+    }
+  }
+  throw lastError instanceof Error ? lastError : new Error(String(lastError ?? "CRN aggregate request failed"));
+}
+async function fetchCrnsWithSource(url = DEFAULT_CRN_LIST_URL, options = {}) {
+  const apiHosts = options.apiHosts ?? DEFAULT_ALEPH_API_HOSTS;
+  const source = options.source ?? "auto";
+  if (source === "aggregate") {
+    return {
+      crns: await fetchCrnsFromAggregate(apiHosts, options.aggregateAddress),
+      source: "aggregate"
+    };
+  }
+  let listError;
+  try {
+    const crns = await fetchCrnsFromList(url);
+    if (crns.length > 0) return { crns, source: "list" };
+    listError = new Error("CRN list returned no entries");
+  } catch (error) {
+    listError = error instanceof Error ? error : new Error(String(error));
+  }
+  if (source === "list") throw listError;
+  return {
+    crns: await fetchCrnsFromAggregate(apiHosts, options.aggregateAddress),
+    source: "aggregate",
+    listError
+  };
+}
+async function fetchCrns(url = DEFAULT_CRN_LIST_URL, options = {}) {
+  return (await fetchCrnsWithSource(url, options)).crns;
+}
+async function probeCrnAvailability(crn) {
+  const address = String(crn.address ?? "").trim();
+  if (!address) return "unreachable";
+  const lookup = await fetchCrnExecutionMap(address);
+  if (lookup.payload !== null) return "reachable";
+  return lookup.blocked ? "unknown" : "unreachable";
+}
+async function filterReachableCrns(crns, options = {}) {
+  const limit = Math.max(1, Number(options.limit) || 5);
+  const probed = crns.slice(0, limit);
+  if (probed.length === 0) return [...crns];
+  const verdicts = await Promise.all(
+    probed.map(async (crn) => {
+      try {
+        return { crn, verdict: await probeCrnAvailability(crn) };
+      } catch {
+        return { crn, verdict: "unknown" };
+      }
+    })
+  );
+  const kept = verdicts.filter((entry) => entry.verdict !== "unreachable").map((entry) => entry.crn);
+  if (kept.length === 0) {
+    options.onDiagnostic?.(`No CRN answered its executions endpoint (${probed.length} probed); keeping the unverified order`);
+    return [...crns];
+  }
+  const dropped = probed.length - kept.length;
+  if (dropped > 0) {
+    options.onDiagnostic?.(`Skipping ${dropped} unreachable CRN${dropped === 1 ? "" : "s"} of ${probed.length} probed`);
+  }
+  return [...kept, ...crns.slice(limit)];
+}
 async function fetchInstances(address, apiHost = DEFAULT_ALEPH_API_HOST) {
   const url = new URL("/api/v0/messages.json", apiHost);
   url.searchParams.set("msgTypes", "INSTANCE");
@@ -857,18 +983,23 @@ function createAlephBrowserClient(options = {}) {
   const apiHosts = options.apiHosts === void 0 && options.apiHost === void 0 ? [...DEFAULT_ALEPH_API_HOSTS] : normalizeApiHosts(options.apiHosts, options.apiHost ?? DEFAULT_ALEPH_API_HOST);
   const apiHost = apiHosts[0] ?? DEFAULT_ALEPH_API_HOST;
   const crnListUrl = options.crnListUrl ?? DEFAULT_CRN_LIST_URL;
+  const crnSource = options.crnSource ?? "auto";
   const schedulerApiHost = options.schedulerApiHost ?? DEFAULT_ALEPH_SCHEDULER_API_HOST;
   const twoN6ApiHost = options.twoN6ApiHost ?? DEFAULT_2N6_API_HOST;
   return {
     apiHost,
     apiHosts,
     crnListUrl,
+    crnSource,
     schedulerApiHost,
     fetchBalance(address) {
       return withApiHostFallback(apiHosts, (host) => fetchBalance(address, host));
     },
     fetchCrns() {
-      return fetchCrns(crnListUrl);
+      return fetchCrns(crnListUrl, { apiHosts, source: crnSource });
+    },
+    fetchCrnsWithSource(source) {
+      return fetchCrnsWithSource(crnListUrl, { apiHosts, source: source ?? crnSource });
     },
     fetchInstances(address) {
       return withApiHostFallback(apiHosts, (host) => fetchInstances(address, host));
@@ -943,6 +1074,15 @@ var DEFAULT_ALEPH_API_HOST2 = "https://api.aleph.im";
 
 // ../core/src/crns.ts
 var DEFAULT_CRN_LIST_URL2 = "https://crns-list.aleph.sh/crns.json";
+var DEFAULT_CRN_AGGREGATE_ADDRESS2 = "0xa1B3bb7d2332383D96b7796B908fB7f7F3c2Be10";
+var DEFAULT_CRN_AGGREGATE_KEY2 = "corechannel";
+var DEFAULT_CRN_AGGREGATE_API_HOSTS = [
+  "https://api2.aleph.im",
+  "https://api.aleph.im"
+];
+function asString2(value) {
+  return typeof value === "string" && value.trim() ? value.trim() : null;
+}
 function compatibleCrns(crns, excludedHashes = []) {
   const excluded = new Set(excludedHashes.filter(Boolean));
   return [...crns].filter((crn) => {
@@ -976,7 +1116,7 @@ function filterDeployableCrns(crns, options = {}) {
     compatibleCrns(crns, options.excludedHashes).filter((crn) => hasCrnCapacity(crn, options.spec))
   );
 }
-async function fetchCrns2(options) {
+async function fetchCrnsFromList2(options) {
   const requestUrl = new URL(options.url ?? DEFAULT_CRN_LIST_URL2);
   requestUrl.searchParams.set("filter_inactive", "true");
   const response = await options.fetch(requestUrl.toString(), {
@@ -988,6 +1128,101 @@ async function fetchCrns2(options) {
   const payload = await response.json();
   return Array.isArray(payload?.crns) ? payload.crns : [];
 }
+function normalizeCrnAddress2(value) {
+  const address = asString2(value);
+  if (!address) return null;
+  const withScheme = /^https?:\/\//i.test(address) ? address : `https://${address}`;
+  try {
+    return new URL(withScheme).toString().replace(/\/+$/, "");
+  } catch {
+    return null;
+  }
+}
+function aggregateScore(node) {
+  for (const candidate of [node.score, node.scoreV1]) {
+    if (candidate == null || candidate === "") continue;
+    const numeric = typeof candidate === "number" ? candidate : Number(candidate);
+    if (Number.isFinite(numeric)) return numeric;
+  }
+  return null;
+}
+function isDeployableResourceNode(node) {
+  if (!asString2(node.hash)) return false;
+  if (!normalizeCrnAddress2(node.address)) return false;
+  if (node.inactive_since != null) return false;
+  if (node.locked === true) return false;
+  const type = asString2(node.type)?.toLowerCase();
+  if (type && type !== "compute") return false;
+  const status = asString2(node.status)?.toLowerCase();
+  if (status && status !== "linked" && status !== "active") return false;
+  return Boolean(asString2(node.parent));
+}
+function mapResourceNodesToCrns2(resourceNodes) {
+  if (!Array.isArray(resourceNodes)) return [];
+  return resourceNodes.filter((node) => Boolean(node) && typeof node === "object").filter(isDeployableResourceNode).map((node) => {
+    const record = {
+      hash: asString2(node.hash),
+      address: normalizeCrnAddress2(node.address)
+    };
+    const name = asString2(node.name);
+    if (name) record.name = name;
+    const score = aggregateScore(node);
+    if (score != null) record.score = score;
+    return record;
+  });
+}
+async function fetchCrnsFromAggregate2(options) {
+  const apiHosts = options.apiHosts?.length ? options.apiHosts : DEFAULT_CRN_AGGREGATE_API_HOSTS;
+  const address = options.address ?? DEFAULT_CRN_AGGREGATE_ADDRESS2;
+  const aggregateKey = options.aggregateKey ?? DEFAULT_CRN_AGGREGATE_KEY2;
+  let lastError = null;
+  for (const apiHost of apiHosts) {
+    try {
+      const url = new URL(`/api/v0/aggregates/${address}.json`, apiHost);
+      url.searchParams.set("keys", aggregateKey);
+      const response = await options.fetch(url.toString(), { cache: "no-cache" });
+      if (!response.ok) {
+        lastError = new Error(`CRN aggregate request failed: ${response.status}`);
+        continue;
+      }
+      const payload = await response.json();
+      const crns = mapResourceNodesToCrns2(payload?.data?.corechannel?.resource_nodes);
+      if (crns.length > 0) return crns;
+      lastError = new Error("CRN aggregate contained no deployable resource nodes");
+    } catch (error) {
+      lastError = error;
+    }
+  }
+  throw lastError instanceof Error ? lastError : new Error(String(lastError ?? "CRN aggregate request failed"));
+}
+async function fetchCrnsWithSource2(options) {
+  const aggregateOptions = {
+    fetch: options.fetch,
+    apiHosts: options.aggregateApiHosts,
+    address: options.aggregateAddress
+  };
+  if (options.preferAggregate) {
+    return { crns: await fetchCrnsFromAggregate2(aggregateOptions), source: "aggregate" };
+  }
+  let listError;
+  try {
+    const crns = await fetchCrnsFromList2({ url: options.url, fetch: options.fetch });
+    if (crns.length > 0) return { crns, source: "list" };
+    listError = new Error("CRN list returned no entries");
+  } catch (error) {
+    listError = error instanceof Error ? error : new Error(String(error));
+  }
+  options.onDiagnostic?.(`CRN list unavailable (${listError.message}); falling back to the ${DEFAULT_CRN_AGGREGATE_KEY2} aggregate`);
+  try {
+    return { crns: await fetchCrnsFromAggregate2(aggregateOptions), source: "aggregate", listError };
+  } catch (aggregateError) {
+    const message = aggregateError instanceof Error ? aggregateError.message : String(aggregateError);
+    throw new Error(`${listError.message}; CRN aggregate fallback failed: ${message}`);
+  }
+}
+async function fetchCrns2(options) {
+  return (await fetchCrnsWithSource2(options)).crns;
+}
 
 // ../core/src/port-forwarding.ts
 var DEFAULT_INSTANCE_PORT_FORWARDS = [
@@ -1077,7 +1312,7 @@ async function fetchPortForwardAggregate(address, options) {
 }
 
 // ../core/src/aleph-normalizers.ts
-function asString2(value) {
+function asString3(value) {
   return typeof value === "string" && value.trim() ? value : null;
 }
 function asNumber2(value) {
@@ -1092,7 +1327,7 @@ function normalizeMessageStatus2(status) {
   return "unknown";
 }
 function normalizeProxyUrl2(value) {
-  const stringValue = asString2(value);
+  const stringValue = asString3(value);
   if (!stringValue) return null;
   if (/^https?:\/\//i.test(stringValue)) return stringValue;
   return `https://${stringValue}`;
@@ -1187,22 +1422,22 @@ function normalizeExecution2(item, crnUrl) {
       version: "v2",
       running: typeof v2Item.running === "boolean" ? v2Item.running : void 0,
       networking: {
-        ipv4_network: asString2(networking.ipv4_network),
-        host_ipv4: asString2(networking.host_ipv4),
-        ipv6_network: asString2(networking.ipv6_network),
-        ipv6_ip: asString2(networking.ipv6_ip),
-        ipv4_ip: asString2(networking.ipv4_ip),
+        ipv4_network: asString3(networking.ipv4_network),
+        host_ipv4: asString3(networking.host_ipv4),
+        ipv6_network: asString3(networking.ipv6_network),
+        ipv6_ip: asString3(networking.ipv6_ip),
+        ipv4_ip: asString3(networking.ipv4_ip),
         proxy_url: extractProxyUrl2(v2Item, networking),
         mapped_ports: mappedPorts2
       },
       status: v2Item.status ? {
-        defined_at: asString2(v2Item.status.defined_at),
-        preparing_at: asString2(v2Item.status.preparing_at),
-        prepared_at: asString2(v2Item.status.prepared_at),
-        starting_at: asString2(v2Item.status.starting_at),
-        started_at: asString2(v2Item.status.started_at),
-        stopping_at: asString2(v2Item.status.stopping_at),
-        stopped_at: asString2(v2Item.status.stopped_at)
+        defined_at: asString3(v2Item.status.defined_at),
+        preparing_at: asString3(v2Item.status.preparing_at),
+        prepared_at: asString3(v2Item.status.prepared_at),
+        starting_at: asString3(v2Item.status.starting_at),
+        started_at: asString3(v2Item.status.started_at),
+        stopping_at: asString3(v2Item.status.stopping_at),
+        stopped_at: asString3(v2Item.status.stopped_at)
       } : null
     };
   }
@@ -1210,8 +1445,8 @@ function normalizeExecution2(item, crnUrl) {
     crnUrl,
     version: "v1",
     networking: {
-      ipv4: networking && "ipv4" in networking ? asString2(networking.ipv4) : null,
-      ipv6: networking && "ipv6" in networking ? asString2(networking.ipv6) : null
+      ipv4: networking && "ipv4" in networking ? asString3(networking.ipv4) : null,
+      ipv6: networking && "ipv6" in networking ? asString3(networking.ipv6) : null
     },
     status: null
   };
@@ -1373,7 +1608,7 @@ async function broadcastAlephMessage2(message, options) {
 // ../core/src/runtime.ts
 var DEFAULT_SCHEDULER_ALLOCATION_URL = "https://scheduler.api.aleph.cloud/api/v0/allocation";
 var DEFAULT_TWO_N_SIX_HASH_URL = "https://api.2n6.me/api/hash";
-function asString3(value) {
+function asString4(value) {
   return typeof value === "string" && value.trim() ? value.trim() : null;
 }
 function asNumber3(value) {
@@ -1415,17 +1650,17 @@ async function fetchSchedulerAllocation2(itemHash, options) {
   const node = payload?.node;
   return {
     source: "scheduler",
-    crnHash: asString3(node?.node_id),
-    crnUrl: asString3(node?.url),
+    crnHash: asString4(node?.node_id),
+    crnUrl: asString4(node?.url),
     node: node ? {
-      node_id: asString3(node.node_id) ?? void 0,
-      url: asString3(node.url) ?? void 0,
-      ipv6: asString3(node.ipv6),
+      node_id: asString4(node.node_id) ?? void 0,
+      url: asString4(node.url) ?? void 0,
+      ipv6: asString4(node.ipv6),
       supports_ipv6: typeof node.supports_ipv6 === "boolean" ? node.supports_ipv6 : void 0
     } : null,
-    vmIpv6: asString3(payload?.vm_ipv6),
+    vmIpv6: asString4(payload?.vm_ipv6),
     period: payload?.period ? {
-      start_timestamp: asString3(payload.period.start_timestamp) ?? void 0,
+      start_timestamp: asString4(payload.period.start_timestamp) ?? void 0,
       duration_seconds: asNumber3(payload.period.duration_seconds) ?? void 0
     } : null
   };
@@ -1440,7 +1675,7 @@ async function fetch2n6WebAccessUrl2(itemHash, options) {
   return {
     url: normalizeProxyUrl2(payload?.url ?? payload?.subdomain),
     active: typeof payload?.active === "boolean" ? payload.active : null,
-    subdomain: asString3(payload?.subdomain)
+    subdomain: asString4(payload?.subdomain)
   };
 }
 async function fetchCrnExecutionMap2(crnUrl, options) {
@@ -1660,7 +1895,7 @@ function utf8Hex(value) {
 function normalizeHexSignature(signature) {
   return signature.startsWith("0x") ? signature : `0x${signature}`;
 }
-function asString4(value) {
+function asString5(value) {
   return typeof value === "string" && value.trim() ? value.trim() : null;
 }
 function trimTrailingSlashes(value) {
@@ -1737,14 +1972,14 @@ async function fetchInstanceNodeHash(args) {
     apiHost: args.apiHost
   });
   const payload = envelope;
-  return asString4(payload?.content?.requirements?.node?.node_hash) ?? asString4(payload?.message?.content?.requirements?.node?.node_hash) ?? null;
+  return asString5(payload?.content?.requirements?.node?.node_hash) ?? asString5(payload?.message?.content?.requirements?.node?.node_hash) ?? null;
 }
 async function resolveInstanceCrn(args) {
-  const providedCrnUrl = asString4(args.crnUrl);
+  const providedCrnUrl = asString5(args.crnUrl);
   if (providedCrnUrl) {
     return {
       crnUrl: trimTrailingSlashes(providedCrnUrl),
-      crnHash: asString4(args.crnHash),
+      crnHash: asString5(args.crnHash),
       source: "provided"
     };
   }
@@ -1755,11 +1990,11 @@ async function resolveInstanceCrn(args) {
   if (allocation?.crnUrl) {
     return {
       crnUrl: trimTrailingSlashes(allocation.crnUrl),
-      crnHash: asString4(allocation.crnHash),
+      crnHash: asString5(allocation.crnHash),
       source: "scheduler"
     };
   }
-  const manualCrnHash = asString4(args.crnHash) ?? await fetchInstanceNodeHash({
+  const manualCrnHash = asString5(args.crnHash) ?? await fetchInstanceNodeHash({
     instanceHash: args.instanceHash,
     fetch: args.fetch,
     apiHost: args.apiHost ?? DEFAULT_ALEPH_API_HOST2
@@ -3825,6 +4060,7 @@ function defaultState(props = {}) {
     },
     balance: null,
     crns: [],
+    crnSource: null,
     selectedCrn: null,
     crnOptions: [],
     crnPinnedByUser: false,
@@ -3854,6 +4090,17 @@ function isDebugEnabled(props) {
     return false;
   }
 }
+function crnSourcePreference(props) {
+  const fromStorage = (() => {
+    try {
+      return globalThis.localStorage?.getItem("LE_SPACE_CRN_SOURCE") ?? null;
+    } catch {
+      return null;
+    }
+  })();
+  const raw = (fromStorage ?? props.crnSource ?? "auto").trim().toLowerCase();
+  return raw === "aggregate" || raw === "list" ? raw : "auto";
+}
 async function sha256Hex(payload) {
   const digest = await globalThis.crypto.subtle.digest(
     "SHA-256",
@@ -3869,6 +4116,17 @@ function hostnameOfUrl(value) {
     return null;
   }
 }
+var INSTANCE_ADDRESS_TIMEOUT_MS = 1e4;
+function describeInstanceAddressFailure(error, sourceUrl) {
+  const raw = error instanceof Error ? error.message : String(error);
+  if (error instanceof Error && error.name === "AbortError") {
+    return `${sourceUrl} did not answer within ${INSTANCE_ADDRESS_TIMEOUT_MS / 1e3}s. Press Refresh to try again.`;
+  }
+  if (error instanceof TypeError || /failed to fetch|load failed|networkerror/i.test(raw)) {
+    return `${sourceUrl} closed the connection without answering. Relays built before rootfs 0.8.0 do not serve an address document, and their proxy hangs up instead of returning 404 \u2014 redeploying from a current rootfs fixes it. (${raw})`;
+  }
+  return raw;
+}
 function emptyInstanceAddresses() {
   return {
     status: "idle",
@@ -4230,6 +4488,7 @@ var SponsorRelayController = class {
       apiHost: props.apiHost,
       apiHosts: props.apiHosts,
       crnListUrl: props.crnListUrl,
+      crnSource: crnSourcePreference(props),
       schedulerApiHost: props.schedulerApiHost,
       twoN6ApiHost: props.twoN6ApiHost
     });
@@ -5452,10 +5711,18 @@ var SponsorRelayController = class {
       statusText: currentProfile === "ucan-store" ? "Refreshing service deployment data" : "Refreshing relay deployment data"
     });
     try {
-      const [pricingSummary, crns] = await Promise.all([
+      const [pricingSummary, crnList] = await Promise.all([
         fetchInstancePricing(this.client.apiHost),
-        this.client.fetchCrns()
+        this.client.fetchCrnsWithSource(crnSourcePreference(this.props))
       ]);
+      const { crns, source: crnSource } = crnList;
+      if (crnList.listError) {
+        this.trace("crns:fallback", {
+          source: crnSource,
+          count: crns.length,
+          listError: crnList.listError.message
+        });
+      }
       const manifestState = await resolveManifest({
         manifestUrl: this.state.manifestUrl,
         manifestJson: this.state.manifestJson
@@ -5605,6 +5872,7 @@ var SponsorRelayController = class {
         },
         balance,
         crns,
+        crnSource,
         instances,
         bootstrapRegistrations,
         orphanBootstrapRegistrations,
@@ -5682,10 +5950,21 @@ var SponsorRelayController = class {
         }
       });
       const preferredCrnHash = this.state.selectedCrn?.hash ?? null;
-      const orderedCrns = [
+      const rankedCrns = [
         ...compatibleCrns2.filter((crn) => crn.hash === preferredCrnHash),
         ...compatibleCrns2.filter((crn) => crn.hash !== preferredCrnHash)
       ].slice(0, 5);
+      const orderedCrns = this.state.crnSource === "aggregate" ? await filterReachableCrns(rankedCrns, {
+        limit: rankedCrns.length,
+        onDiagnostic: (message) => this.trace("crns:probe", { message })
+      }).then(
+        (reachable) => preferredCrnHash && !reachable.some((crn) => crn.hash === preferredCrnHash) ? [
+          ...rankedCrns.filter(
+            (crn) => crn.hash === preferredCrnHash
+          ),
+          ...reachable
+        ] : reachable
+      ) : rankedCrns;
       if (orderedCrns.length === 0) {
         throw new Error(
           "No compatible CRN is currently available for this tier."
@@ -6220,14 +6499,21 @@ var SponsorRelayController = class {
       sourceUrl,
       error: null
     });
+    const abort = new AbortController();
+    const timeout = globalThis.setTimeout(
+      () => abort.abort(),
+      INSTANCE_ADDRESS_TIMEOUT_MS
+    );
     try {
-      const abort = new AbortController();
-      const timeout = globalThis.setTimeout(() => abort.abort(), 1e4);
-      const response = await fetch(sourceUrl, {
-        cache: "no-cache",
-        signal: abort.signal
-      });
-      globalThis.clearTimeout(timeout);
+      let response;
+      try {
+        response = await fetch(sourceUrl, {
+          cache: "no-cache",
+          signal: abort.signal
+        });
+      } finally {
+        globalThis.clearTimeout(timeout);
+      }
       if (response.status === 404) {
         this.patchInstanceAddresses(instanceHash, {
           ...emptyInstanceAddresses(),
@@ -6254,7 +6540,7 @@ var SponsorRelayController = class {
         ...this.state.instanceAddresses[instanceHash] ?? emptyInstanceAddresses(),
         status: "error",
         sourceUrl,
-        error: error instanceof Error ? error.message : String(error)
+        error: describeInstanceAddressFailure(error, sourceUrl)
       });
     }
   }
@@ -6485,6 +6771,7 @@ function useSponsorRelayController(props) {
       props.apiHost,
       props.apiHosts,
       props.crnListUrl,
+      props.crnSource,
       props.debug,
       props.instanceName,
       props.manifestJson,

package/shared/index.d.ts

@@ -1,3 +1,6 @@
+type CrnSource = 'list' | 'aggregate';
+type CrnSourcePreference = 'auto' | 'aggregate' | 'list';
+
 type MessageStatus = 'processed' | 'pending' | 'rejected' | 'removing' | 'removed' | 'unknown';
 interface BalanceResponse {
     address: string;
@@ -220,6 +223,12 @@ interface SponsorRelayProps {
     apiHost?: string;
     apiHosts?: string | readonly string[];
     crnListUrl?: string;
+    /**
+     * Which CRN source to read. `auto` falls back to the corechannel aggregate
+     * when crns.json is down, `aggregate` skips crns.json, `list` disables the
+     * fallback. `localStorage.LE_SPACE_CRN_SOURCE` overrides this at runtime.
+     */
+    crnSource?: CrnSourcePreference;
     schedulerApiHost?: string;
     twoN6ApiHost?: string;
 }
@@ -344,6 +353,8 @@ interface SponsorRelayState {
     pricingSummary: SponsorRelayPricingSummary;
     balance: BalanceResponse | null;
     crns: Crn[];
+    /** Which source the current `crns` came from; `null` until the first load. */
+    crnSource: CrnSource | null;
     selectedCrn: Crn | null;
     crnOptions: Array<{
         hash: string;
@@ -386,7 +397,7 @@ declare const STALE_INSTANCE_ALLOCATION_COOLDOWN_MS: number;
 declare const RECENT_INSTANCE_RUNTIME_GRACE_MS: number;
 declare const DEPLOYMENT_PENDING_WARNING_MS: number;
 
-declare const UI_PACKAGE_VERSION = "0.8.0";
+declare const UI_PACKAGE_VERSION = "0.9.1";
 
 interface RootfsRequiredPortForward {
     port: number;

package/shared/index.js

@@ -42,7 +42,7 @@ var RECENT_INSTANCE_RUNTIME_GRACE_MS = 10 * 60 * 1e3;
 var DEPLOYMENT_PENDING_WARNING_MS = 3 * 60 * 1e3;
 
 // src/shared/package-version.ts
-var UI_PACKAGE_VERSION = "0.8.0";
+var UI_PACKAGE_VERSION = "0.9.1";
 
 // src/shared/format.ts
 function shortHash(value, head = 8, tail = 6) {
@@ -140,6 +140,8 @@ var DEFAULT_ALEPH_API_HOSTS = [
 ];
 var DEFAULT_ALEPH_API_HOST = DEFAULT_ALEPH_API_HOSTS[0] ?? "https://api2.aleph.im";
 var DEFAULT_CRN_LIST_URL = "https://crns-list.aleph.sh/crns.json";
+var DEFAULT_CRN_AGGREGATE_ADDRESS = "0xa1B3bb7d2332383D96b7796B908fB7f7F3c2Be10";
+var DEFAULT_CRN_AGGREGATE_KEY = "corechannel";
 var DEFAULT_ALEPH_SCHEDULER_API_HOST = "https://scheduler.api.aleph.cloud";
 var DEFAULT_2N6_API_HOST = "https://api.2n6.me";
 function normalizeMessageStatus(status) {
@@ -194,7 +196,7 @@ async function fetchBalance(address, apiHost = DEFAULT_ALEPH_API_HOST) {
   if (!response.ok) throw new Error(`Balance request failed: ${response.status}`);
   return await response.json();
 }
-async function fetchCrns(url = DEFAULT_CRN_LIST_URL) {
+async function fetchCrnsFromList(url = DEFAULT_CRN_LIST_URL) {
   const requestUrl = new URL(url);
   requestUrl.searchParams.set("filter_inactive", "true");
   const response = await fetchWithTimeout(requestUrl, { cache: "no-cache" });
@@ -202,6 +204,130 @@ async function fetchCrns(url = DEFAULT_CRN_LIST_URL) {
   const payload = await response.json();
   return payload.crns ?? [];
 }
+function asFiniteNumber(value) {
+  if (value == null || value === "") return null;
+  const numeric = typeof value === "number" ? value : Number(value);
+  return Number.isFinite(numeric) ? numeric : null;
+}
+function normalizeCrnAddress(value) {
+  const address = asString(value);
+  if (!address) return null;
+  const withScheme = /^https?:\/\//i.test(address) ? address : `https://${address}`;
+  try {
+    return new URL(withScheme).toString().replace(/\/+$/, "");
+  } catch {
+    return null;
+  }
+}
+function mapResourceNodesToCrns(resourceNodes) {
+  if (!Array.isArray(resourceNodes)) return [];
+  const crns = [];
+  for (const node of resourceNodes) {
+    if (!node || typeof node !== "object") continue;
+    const entry = node;
+    const hash = asString(entry.hash);
+    const address = normalizeCrnAddress(entry.address);
+    const type = asString(entry.type)?.toLowerCase();
+    const status = asString(entry.status)?.toLowerCase();
+    if (!hash || !address) continue;
+    if (entry.inactive_since != null || entry.locked === true) continue;
+    if (type && type !== "compute") continue;
+    if (status && status !== "linked" && status !== "active") continue;
+    if (!asString(entry.parent)) continue;
+    const score = asFiniteNumber(entry.score) ?? asFiniteNumber(entry.scoreV1);
+    const performance = asFiniteNumber(entry.performance);
+    const decentralization = asFiniteNumber(entry.decentralization);
+    crns.push({
+      hash,
+      address,
+      name: asString(entry.name) ?? hash,
+      ...score == null ? {} : { score },
+      ...performance == null ? {} : { performance },
+      ...decentralization == null ? {} : { decentralization }
+    });
+  }
+  return crns;
+}
+async function fetchCrnsFromAggregate(apiHosts = DEFAULT_ALEPH_API_HOSTS, address = DEFAULT_CRN_AGGREGATE_ADDRESS) {
+  const hosts = apiHosts.length > 0 ? apiHosts : DEFAULT_ALEPH_API_HOSTS;
+  let lastError = null;
+  for (const apiHost of hosts) {
+    try {
+      const url = new URL(`/api/v0/aggregates/${address}.json`, apiHost);
+      url.searchParams.set("keys", DEFAULT_CRN_AGGREGATE_KEY);
+      const response = await fetchWithTimeout(url, { cache: "no-cache" });
+      if (!response.ok) {
+        lastError = new Error(`CRN aggregate request failed: ${response.status}`);
+        continue;
+      }
+      const payload = await response.json();
+      const crns = mapResourceNodesToCrns(payload?.data?.corechannel?.resource_nodes);
+      if (crns.length > 0) return crns;
+      lastError = new Error("CRN aggregate contained no deployable resource nodes");
+    } catch (error) {
+      lastError = error;
+    }
+  }
+  throw lastError instanceof Error ? lastError : new Error(String(lastError ?? "CRN aggregate request failed"));
+}
+async function fetchCrnsWithSource(url = DEFAULT_CRN_LIST_URL, options = {}) {
+  const apiHosts = options.apiHosts ?? DEFAULT_ALEPH_API_HOSTS;
+  const source = options.source ?? "auto";
+  if (source === "aggregate") {
+    return {
+      crns: await fetchCrnsFromAggregate(apiHosts, options.aggregateAddress),
+      source: "aggregate"
+    };
+  }
+  let listError;
+  try {
+    const crns = await fetchCrnsFromList(url);
+    if (crns.length > 0) return { crns, source: "list" };
+    listError = new Error("CRN list returned no entries");
+  } catch (error) {
+    listError = error instanceof Error ? error : new Error(String(error));
+  }
+  if (source === "list") throw listError;
+  return {
+    crns: await fetchCrnsFromAggregate(apiHosts, options.aggregateAddress),
+    source: "aggregate",
+    listError
+  };
+}
+async function fetchCrns(url = DEFAULT_CRN_LIST_URL, options = {}) {
+  return (await fetchCrnsWithSource(url, options)).crns;
+}
+async function probeCrnAvailability(crn) {
+  const address = String(crn.address ?? "").trim();
+  if (!address) return "unreachable";
+  const lookup = await fetchCrnExecutionMap(address);
+  if (lookup.payload !== null) return "reachable";
+  return lookup.blocked ? "unknown" : "unreachable";
+}
+async function filterReachableCrns(crns, options = {}) {
+  const limit = Math.max(1, Number(options.limit) || 5);
+  const probed = crns.slice(0, limit);
+  if (probed.length === 0) return [...crns];
+  const verdicts = await Promise.all(
+    probed.map(async (crn) => {
+      try {
+        return { crn, verdict: await probeCrnAvailability(crn) };
+      } catch {
+        return { crn, verdict: "unknown" };
+      }
+    })
+  );
+  const kept = verdicts.filter((entry) => entry.verdict !== "unreachable").map((entry) => entry.crn);
+  if (kept.length === 0) {
+    options.onDiagnostic?.(`No CRN answered its executions endpoint (${probed.length} probed); keeping the unverified order`);
+    return [...crns];
+  }
+  const dropped = probed.length - kept.length;
+  if (dropped > 0) {
+    options.onDiagnostic?.(`Skipping ${dropped} unreachable CRN${dropped === 1 ? "" : "s"} of ${probed.length} probed`);
+  }
+  return [...kept, ...crns.slice(limit)];
+}
 async function fetchInstances(address, apiHost = DEFAULT_ALEPH_API_HOST) {
   const url = new URL("/api/v0/messages.json", apiHost);
   url.searchParams.set("msgTypes", "INSTANCE");
@@ -856,18 +982,23 @@ function createAlephBrowserClient(options = {}) {
   const apiHosts = options.apiHosts === void 0 && options.apiHost === void 0 ? [...DEFAULT_ALEPH_API_HOSTS] : normalizeApiHosts(options.apiHosts, options.apiHost ?? DEFAULT_ALEPH_API_HOST);
   const apiHost = apiHosts[0] ?? DEFAULT_ALEPH_API_HOST;
   const crnListUrl = options.crnListUrl ?? DEFAULT_CRN_LIST_URL;
+  const crnSource = options.crnSource ?? "auto";
   const schedulerApiHost = options.schedulerApiHost ?? DEFAULT_ALEPH_SCHEDULER_API_HOST;
   const twoN6ApiHost = options.twoN6ApiHost ?? DEFAULT_2N6_API_HOST;
   return {
     apiHost,
     apiHosts,
     crnListUrl,
+    crnSource,
     schedulerApiHost,
     fetchBalance(address) {
       return withApiHostFallback(apiHosts, (host) => fetchBalance(address, host));
     },
     fetchCrns() {
-      return fetchCrns(crnListUrl);
+      return fetchCrns(crnListUrl, { apiHosts, source: crnSource });
+    },
+    fetchCrnsWithSource(source) {
+      return fetchCrnsWithSource(crnListUrl, { apiHosts, source: source ?? crnSource });
     },
     fetchInstances(address) {
       return withApiHostFallback(apiHosts, (host) => fetchInstances(address, host));
@@ -942,6 +1073,15 @@ var DEFAULT_ALEPH_API_HOST2 = "https://api.aleph.im";
 
 // ../core/src/crns.ts
 var DEFAULT_CRN_LIST_URL2 = "https://crns-list.aleph.sh/crns.json";
+var DEFAULT_CRN_AGGREGATE_ADDRESS2 = "0xa1B3bb7d2332383D96b7796B908fB7f7F3c2Be10";
+var DEFAULT_CRN_AGGREGATE_KEY2 = "corechannel";
+var DEFAULT_CRN_AGGREGATE_API_HOSTS = [
+  "https://api2.aleph.im",
+  "https://api.aleph.im"
+];
+function asString2(value) {
+  return typeof value === "string" && value.trim() ? value.trim() : null;
+}
 function compatibleCrns(crns, excludedHashes = []) {
   const excluded = new Set(excludedHashes.filter(Boolean));
   return [...crns].filter((crn) => {
@@ -975,7 +1115,7 @@ function filterDeployableCrns(crns, options = {}) {
     compatibleCrns(crns, options.excludedHashes).filter((crn) => hasCrnCapacity(crn, options.spec))
   );
 }
-async function fetchCrns2(options) {
+async function fetchCrnsFromList2(options) {
   const requestUrl = new URL(options.url ?? DEFAULT_CRN_LIST_URL2);
   requestUrl.searchParams.set("filter_inactive", "true");
   const response = await options.fetch(requestUrl.toString(), {
@@ -987,6 +1127,101 @@ async function fetchCrns2(options) {
   const payload = await response.json();
   return Array.isArray(payload?.crns) ? payload.crns : [];
 }
+function normalizeCrnAddress2(value) {
+  const address = asString2(value);
+  if (!address) return null;
+  const withScheme = /^https?:\/\//i.test(address) ? address : `https://${address}`;
+  try {
+    return new URL(withScheme).toString().replace(/\/+$/, "");
+  } catch {
+    return null;
+  }
+}
+function aggregateScore(node) {
+  for (const candidate of [node.score, node.scoreV1]) {
+    if (candidate == null || candidate === "") continue;
+    const numeric = typeof candidate === "number" ? candidate : Number(candidate);
+    if (Number.isFinite(numeric)) return numeric;
+  }
+  return null;
+}
+function isDeployableResourceNode(node) {
+  if (!asString2(node.hash)) return false;
+  if (!normalizeCrnAddress2(node.address)) return false;
+  if (node.inactive_since != null) return false;
+  if (node.locked === true) return false;
+  const type = asString2(node.type)?.toLowerCase();
+  if (type && type !== "compute") return false;
+  const status = asString2(node.status)?.toLowerCase();
+  if (status && status !== "linked" && status !== "active") return false;
+  return Boolean(asString2(node.parent));
+}
+function mapResourceNodesToCrns2(resourceNodes) {
+  if (!Array.isArray(resourceNodes)) return [];
+  return resourceNodes.filter((node) => Boolean(node) && typeof node === "object").filter(isDeployableResourceNode).map((node) => {
+    const record = {
+      hash: asString2(node.hash),
+      address: normalizeCrnAddress2(node.address)
+    };
+    const name = asString2(node.name);
+    if (name) record.name = name;
+    const score = aggregateScore(node);
+    if (score != null) record.score = score;
+    return record;
+  });
+}
+async function fetchCrnsFromAggregate2(options) {
+  const apiHosts = options.apiHosts?.length ? options.apiHosts : DEFAULT_CRN_AGGREGATE_API_HOSTS;
+  const address = options.address ?? DEFAULT_CRN_AGGREGATE_ADDRESS2;
+  const aggregateKey = options.aggregateKey ?? DEFAULT_CRN_AGGREGATE_KEY2;
+  let lastError = null;
+  for (const apiHost of apiHosts) {
+    try {
+      const url = new URL(`/api/v0/aggregates/${address}.json`, apiHost);
+      url.searchParams.set("keys", aggregateKey);
+      const response = await options.fetch(url.toString(), { cache: "no-cache" });
+      if (!response.ok) {
+        lastError = new Error(`CRN aggregate request failed: ${response.status}`);
+        continue;
+      }
+      const payload = await response.json();
+      const crns = mapResourceNodesToCrns2(payload?.data?.corechannel?.resource_nodes);
+      if (crns.length > 0) return crns;
+      lastError = new Error("CRN aggregate contained no deployable resource nodes");
+    } catch (error) {
+      lastError = error;
+    }
+  }
+  throw lastError instanceof Error ? lastError : new Error(String(lastError ?? "CRN aggregate request failed"));
+}
+async function fetchCrnsWithSource2(options) {
+  const aggregateOptions = {
+    fetch: options.fetch,
+    apiHosts: options.aggregateApiHosts,
+    address: options.aggregateAddress
+  };
+  if (options.preferAggregate) {
+    return { crns: await fetchCrnsFromAggregate2(aggregateOptions), source: "aggregate" };
+  }
+  let listError;
+  try {
+    const crns = await fetchCrnsFromList2({ url: options.url, fetch: options.fetch });
+    if (crns.length > 0) return { crns, source: "list" };
+    listError = new Error("CRN list returned no entries");
+  } catch (error) {
+    listError = error instanceof Error ? error : new Error(String(error));
+  }
+  options.onDiagnostic?.(`CRN list unavailable (${listError.message}); falling back to the ${DEFAULT_CRN_AGGREGATE_KEY2} aggregate`);
+  try {
+    return { crns: await fetchCrnsFromAggregate2(aggregateOptions), source: "aggregate", listError };
+  } catch (aggregateError) {
+    const message = aggregateError instanceof Error ? aggregateError.message : String(aggregateError);
+    throw new Error(`${listError.message}; CRN aggregate fallback failed: ${message}`);
+  }
+}
+async function fetchCrns2(options) {
+  return (await fetchCrnsWithSource2(options)).crns;
+}
 
 // ../core/src/port-forwarding.ts
 var DEFAULT_INSTANCE_PORT_FORWARDS = [
@@ -1076,7 +1311,7 @@ async function fetchPortForwardAggregate(address, options) {
 }
 
 // ../core/src/aleph-normalizers.ts
-function asString2(value) {
+function asString3(value) {
   return typeof value === "string" && value.trim() ? value : null;
 }
 function asNumber2(value) {
@@ -1091,7 +1326,7 @@ function normalizeMessageStatus2(status) {
   return "unknown";
 }
 function normalizeProxyUrl2(value) {
-  const stringValue = asString2(value);
+  const stringValue = asString3(value);
   if (!stringValue) return null;
   if (/^https?:\/\//i.test(stringValue)) return stringValue;
   return `https://${stringValue}`;
@@ -1186,22 +1421,22 @@ function normalizeExecution2(item, crnUrl) {
       version: "v2",
       running: typeof v2Item.running === "boolean" ? v2Item.running : void 0,
       networking: {
-        ipv4_network: asString2(networking.ipv4_network),
-        host_ipv4: asString2(networking.host_ipv4),
-        ipv6_network: asString2(networking.ipv6_network),
-        ipv6_ip: asString2(networking.ipv6_ip),
-        ipv4_ip: asString2(networking.ipv4_ip),
+        ipv4_network: asString3(networking.ipv4_network),
+        host_ipv4: asString3(networking.host_ipv4),
+        ipv6_network: asString3(networking.ipv6_network),
+        ipv6_ip: asString3(networking.ipv6_ip),
+        ipv4_ip: asString3(networking.ipv4_ip),
         proxy_url: extractProxyUrl2(v2Item, networking),
         mapped_ports: mappedPorts2
       },
       status: v2Item.status ? {
-        defined_at: asString2(v2Item.status.defined_at),
-        preparing_at: asString2(v2Item.status.preparing_at),
-        prepared_at: asString2(v2Item.status.prepared_at),
-        starting_at: asString2(v2Item.status.starting_at),
-        started_at: asString2(v2Item.status.started_at),
-        stopping_at: asString2(v2Item.status.stopping_at),
-        stopped_at: asString2(v2Item.status.stopped_at)
+        defined_at: asString3(v2Item.status.defined_at),
+        preparing_at: asString3(v2Item.status.preparing_at),
+        prepared_at: asString3(v2Item.status.prepared_at),
+        starting_at: asString3(v2Item.status.starting_at),
+        started_at: asString3(v2Item.status.started_at),
+        stopping_at: asString3(v2Item.status.stopping_at),
+        stopped_at: asString3(v2Item.status.stopped_at)
       } : null
     };
   }
@@ -1209,8 +1444,8 @@ function normalizeExecution2(item, crnUrl) {
     crnUrl,
     version: "v1",
     networking: {
-      ipv4: networking && "ipv4" in networking ? asString2(networking.ipv4) : null,
-      ipv6: networking && "ipv6" in networking ? asString2(networking.ipv6) : null
+      ipv4: networking && "ipv4" in networking ? asString3(networking.ipv4) : null,
+      ipv6: networking && "ipv6" in networking ? asString3(networking.ipv6) : null
     },
     status: null
   };
@@ -1372,7 +1607,7 @@ async function broadcastAlephMessage2(message, options) {
 // ../core/src/runtime.ts
 var DEFAULT_SCHEDULER_ALLOCATION_URL = "https://scheduler.api.aleph.cloud/api/v0/allocation";
 var DEFAULT_TWO_N_SIX_HASH_URL = "https://api.2n6.me/api/hash";
-function asString3(value) {
+function asString4(value) {
   return typeof value === "string" && value.trim() ? value.trim() : null;
 }
 function asNumber3(value) {
@@ -1414,17 +1649,17 @@ async function fetchSchedulerAllocation2(itemHash, options) {
   const node = payload?.node;
   return {
     source: "scheduler",
-    crnHash: asString3(node?.node_id),
-    crnUrl: asString3(node?.url),
+    crnHash: asString4(node?.node_id),
+    crnUrl: asString4(node?.url),
     node: node ? {
-      node_id: asString3(node.node_id) ?? void 0,
-      url: asString3(node.url) ?? void 0,
-      ipv6: asString3(node.ipv6),
+      node_id: asString4(node.node_id) ?? void 0,
+      url: asString4(node.url) ?? void 0,
+      ipv6: asString4(node.ipv6),
       supports_ipv6: typeof node.supports_ipv6 === "boolean" ? node.supports_ipv6 : void 0
     } : null,
-    vmIpv6: asString3(payload?.vm_ipv6),
+    vmIpv6: asString4(payload?.vm_ipv6),
     period: payload?.period ? {
-      start_timestamp: asString3(payload.period.start_timestamp) ?? void 0,
+      start_timestamp: asString4(payload.period.start_timestamp) ?? void 0,
       duration_seconds: asNumber3(payload.period.duration_seconds) ?? void 0
     } : null
   };
@@ -1439,7 +1674,7 @@ async function fetch2n6WebAccessUrl2(itemHash, options) {
   return {
     url: normalizeProxyUrl2(payload?.url ?? payload?.subdomain),
     active: typeof payload?.active === "boolean" ? payload.active : null,
-    subdomain: asString3(payload?.subdomain)
+    subdomain: asString4(payload?.subdomain)
   };
 }
 async function fetchCrnExecutionMap2(crnUrl, options) {
@@ -1659,7 +1894,7 @@ function utf8Hex(value) {
 function normalizeHexSignature(signature) {
   return signature.startsWith("0x") ? signature : `0x${signature}`;
 }
-function asString4(value) {
+function asString5(value) {
   return typeof value === "string" && value.trim() ? value.trim() : null;
 }
 function trimTrailingSlashes(value) {
@@ -1736,14 +1971,14 @@ async function fetchInstanceNodeHash(args) {
     apiHost: args.apiHost
   });
   const payload = envelope;
-  return asString4(payload?.content?.requirements?.node?.node_hash) ?? asString4(payload?.message?.content?.requirements?.node?.node_hash) ?? null;
+  return asString5(payload?.content?.requirements?.node?.node_hash) ?? asString5(payload?.message?.content?.requirements?.node?.node_hash) ?? null;
 }
 async function resolveInstanceCrn(args) {
-  const providedCrnUrl = asString4(args.crnUrl);
+  const providedCrnUrl = asString5(args.crnUrl);
   if (providedCrnUrl) {
     return {
       crnUrl: trimTrailingSlashes(providedCrnUrl),
-      crnHash: asString4(args.crnHash),
+      crnHash: asString5(args.crnHash),
       source: "provided"
     };
   }
@@ -1754,11 +1989,11 @@ async function resolveInstanceCrn(args) {
   if (allocation?.crnUrl) {
     return {
       crnUrl: trimTrailingSlashes(allocation.crnUrl),
-      crnHash: asString4(allocation.crnHash),
+      crnHash: asString5(allocation.crnHash),
       source: "scheduler"
     };
   }
-  const manualCrnHash = asString4(args.crnHash) ?? await fetchInstanceNodeHash({
+  const manualCrnHash = asString5(args.crnHash) ?? await fetchInstanceNodeHash({
     instanceHash: args.instanceHash,
     fetch: args.fetch,
     apiHost: args.apiHost ?? DEFAULT_ALEPH_API_HOST2
@@ -3824,6 +4059,7 @@ function defaultState(props = {}) {
     },
     balance: null,
     crns: [],
+    crnSource: null,
     selectedCrn: null,
     crnOptions: [],
     crnPinnedByUser: false,
@@ -3853,6 +4089,17 @@ function isDebugEnabled(props) {
     return false;
   }
 }
+function crnSourcePreference(props) {
+  const fromStorage = (() => {
+    try {
+      return globalThis.localStorage?.getItem("LE_SPACE_CRN_SOURCE") ?? null;
+    } catch {
+      return null;
+    }
+  })();
+  const raw = (fromStorage ?? props.crnSource ?? "auto").trim().toLowerCase();
+  return raw === "aggregate" || raw === "list" ? raw : "auto";
+}
 async function sha256Hex(payload) {
   const digest = await globalThis.crypto.subtle.digest(
     "SHA-256",
@@ -3868,6 +4115,17 @@ function hostnameOfUrl(value) {
     return null;
   }
 }
+var INSTANCE_ADDRESS_TIMEOUT_MS = 1e4;
+function describeInstanceAddressFailure(error, sourceUrl) {
+  const raw = error instanceof Error ? error.message : String(error);
+  if (error instanceof Error && error.name === "AbortError") {
+    return `${sourceUrl} did not answer within ${INSTANCE_ADDRESS_TIMEOUT_MS / 1e3}s. Press Refresh to try again.`;
+  }
+  if (error instanceof TypeError || /failed to fetch|load failed|networkerror/i.test(raw)) {
+    return `${sourceUrl} closed the connection without answering. Relays built before rootfs 0.8.0 do not serve an address document, and their proxy hangs up instead of returning 404 \u2014 redeploying from a current rootfs fixes it. (${raw})`;
+  }
+  return raw;
+}
 function emptyInstanceAddresses() {
   return {
     status: "idle",
@@ -4229,6 +4487,7 @@ var SponsorRelayController = class {
       apiHost: props.apiHost,
       apiHosts: props.apiHosts,
       crnListUrl: props.crnListUrl,
+      crnSource: crnSourcePreference(props),
       schedulerApiHost: props.schedulerApiHost,
       twoN6ApiHost: props.twoN6ApiHost
     });
@@ -5451,10 +5710,18 @@ var SponsorRelayController = class {
       statusText: currentProfile === "ucan-store" ? "Refreshing service deployment data" : "Refreshing relay deployment data"
     });
     try {
-      const [pricingSummary, crns] = await Promise.all([
+      const [pricingSummary, crnList] = await Promise.all([
         fetchInstancePricing(this.client.apiHost),
-        this.client.fetchCrns()
+        this.client.fetchCrnsWithSource(crnSourcePreference(this.props))
       ]);
+      const { crns, source: crnSource } = crnList;
+      if (crnList.listError) {
+        this.trace("crns:fallback", {
+          source: crnSource,
+          count: crns.length,
+          listError: crnList.listError.message
+        });
+      }
       const manifestState = await resolveManifest({
         manifestUrl: this.state.manifestUrl,
         manifestJson: this.state.manifestJson
@@ -5604,6 +5871,7 @@ var SponsorRelayController = class {
         },
         balance,
         crns,
+        crnSource,
         instances,
         bootstrapRegistrations,
         orphanBootstrapRegistrations,
@@ -5681,10 +5949,21 @@ var SponsorRelayController = class {
         }
       });
       const preferredCrnHash = this.state.selectedCrn?.hash ?? null;
-      const orderedCrns = [
+      const rankedCrns = [
         ...compatibleCrns2.filter((crn) => crn.hash === preferredCrnHash),
         ...compatibleCrns2.filter((crn) => crn.hash !== preferredCrnHash)
       ].slice(0, 5);
+      const orderedCrns = this.state.crnSource === "aggregate" ? await filterReachableCrns(rankedCrns, {
+        limit: rankedCrns.length,
+        onDiagnostic: (message) => this.trace("crns:probe", { message })
+      }).then(
+        (reachable) => preferredCrnHash && !reachable.some((crn) => crn.hash === preferredCrnHash) ? [
+          ...rankedCrns.filter(
+            (crn) => crn.hash === preferredCrnHash
+          ),
+          ...reachable
+        ] : reachable
+      ) : rankedCrns;
       if (orderedCrns.length === 0) {
         throw new Error(
           "No compatible CRN is currently available for this tier."
@@ -6219,14 +6498,21 @@ var SponsorRelayController = class {
       sourceUrl,
       error: null
     });
+    const abort = new AbortController();
+    const timeout = globalThis.setTimeout(
+      () => abort.abort(),
+      INSTANCE_ADDRESS_TIMEOUT_MS
+    );
     try {
-      const abort = new AbortController();
-      const timeout = globalThis.setTimeout(() => abort.abort(), 1e4);
-      const response = await fetch(sourceUrl, {
-        cache: "no-cache",
-        signal: abort.signal
-      });
-      globalThis.clearTimeout(timeout);
+      let response;
+      try {
+        response = await fetch(sourceUrl, {
+          cache: "no-cache",
+          signal: abort.signal
+        });
+      } finally {
+        globalThis.clearTimeout(timeout);
+      }
       if (response.status === 404) {
         this.patchInstanceAddresses(instanceHash, {
           ...emptyInstanceAddresses(),
@@ -6253,7 +6539,7 @@ var SponsorRelayController = class {
         ...this.state.instanceAddresses[instanceHash] ?? emptyInstanceAddresses(),
         status: "error",
         sourceUrl,
-        error: error instanceof Error ? error.message : String(error)
+        error: describeInstanceAddressFailure(error, sourceUrl)
       });
     }
   }

package/svelte/SponsorRelayFab.svelte

@@ -20,6 +20,7 @@ export let version = ''
 export let apiHost = undefined
 export let apiHosts = undefined
   export let crnListUrl = undefined
+  export let crnSource = undefined
   export let schedulerApiHost = undefined
   export let twoN6ApiHost = undefined
 
@@ -35,6 +36,7 @@ export let apiHosts = undefined
   apiHost,
   apiHosts,
     crnListUrl,
+    crnSource,
     schedulerApiHost,
     twoN6ApiHost
   })