@le-space/ui 0.6.22 → 0.6.24

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@le-space/ui",
-  "version": "0.6.22",
+  "version": "0.6.24",
   "description": "Floating Aleph sponsor relay 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.6.22",
-    "@le-space/core": "0.6.22",
+    "@le-space/browser": "0.6.24",
+    "@le-space/core": "0.6.24",
     "viem": "^2.53.1"
   },
   "peerDependencies": {

package/react/index.d.ts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
-type MessageStatus = 'processed' | 'pending' | 'rejected' | 'unknown';
+type MessageStatus = 'processed' | 'pending' | 'rejected' | 'removing' | 'removed' | 'unknown';
 interface BalanceResponse {
     address: string;
     balance: string;
@@ -235,6 +235,7 @@ interface SponsorRelayRootfsHealth {
     tone: SponsorRelayHealthTone;
     label: string;
     detail: string | null;
+    code?: 'manifest-invalid' | 'rootfs-not-found' | 'rootfs-verifying' | 'rootfs-pending' | 'rootfs-unavailable' | 'rootfs-ready';
 }
 interface CompactInstanceDetails {
     messageStatus: 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.6.22";
+var UI_PACKAGE_VERSION = "0.6.24";
 
 // src/shared/format.ts
 function shortHash(value, head = 8, tail = 6) {
@@ -647,7 +647,7 @@ async function verifyRootfsExists(itemHash, apiHost = DEFAULT_ALEPH_API_HOST) {
 function normalizeStatus(status) {
   if (typeof status !== "string") return "unknown";
   const normalized = status.toLowerCase();
-  if (normalized === "processed" || normalized === "pending" || normalized === "rejected") {
+  if (normalized === "processed" || normalized === "pending" || normalized === "rejected" || normalized === "removing" || normalized === "removed") {
     return normalized;
   }
   return "unknown";
@@ -672,6 +672,7 @@ function parseCidFromPayload(payload) {
 }
 function parseRejectionReason(payload) {
   const errorCode = typeof payload.error_code === "number" ? payload.error_code : null;
+  const reason = typeof payload.reason === "string" ? payload.reason.trim() : "";
   const details = payload.details && typeof payload.details === "object" ? payload.details : null;
   const rawErrors = Array.isArray(details?.errors) ? details.errors : [];
   const firstError = rawErrors[0] && typeof rawErrors[0] === "object" ? rawErrors[0] : null;
@@ -686,6 +687,18 @@ function parseRejectionReason(payload) {
       };
     }
   }
+  if (reason === "balance_insufficient") {
+    return {
+      rejectionErrorCode: errorCode,
+      rejectionReason: "The rootfs STORE is being removed because its publisher no longer has enough Aleph credits. Your connected MetaMask balance may be sufficient, but this manifest must point to a newly published, processed rootfs STORE."
+    };
+  }
+  if (reason) {
+    return {
+      rejectionErrorCode: errorCode,
+      rejectionReason: `Aleph marked the rootfs STORE as unavailable: ${reason.replaceAll("_", " ")}.`
+    };
+  }
   return {
     rejectionErrorCode: errorCode,
     rejectionReason: errorCode != null ? `Rejected by Aleph (error code ${errorCode}).` : null
@@ -727,11 +740,12 @@ async function resolveRootfsReference(itemHash, apiHost = DEFAULT_ALEPH_API_HOST
   const firstMessage = Array.isArray(payload.messages) && payload.messages[0] && typeof payload.messages[0] === "object" ? payload.messages[0] : null;
   const messageObject = payload.message && typeof payload.message === "object" ? payload.message : null;
   const cid = parseCidFromPayload(payload);
-  const rejection = normalizeStatus(payload.status) === "rejected" ? parseRejectionReason(payload) : { rejectionErrorCode: null, rejectionReason: null };
+  const messageStatus = normalizeStatus(payload.status);
+  const rejection = messageStatus === "processed" || messageStatus === "pending" ? { rejectionErrorCode: null, rejectionReason: null } : parseRejectionReason(payload);
   const gateway = cid ? await probeGateway(cid, gatewayBaseUrl) : { gatewayUrl: null, gatewayStatus: "unknown", gatewayError: null };
   return {
     itemHash,
-    messageStatus: normalizeStatus(payload.status),
+    messageStatus,
     messageType: String(payload.type || messageObject?.type || firstMessage?.type || "").toUpperCase() || null,
     cid,
     receptionTime: typeof payload.reception_time === "string" ? payload.reception_time : null,
@@ -3836,48 +3850,55 @@ function rootfsHealth(args) {
     return {
       tone: "error",
       label: "manifest invalid",
-      detail: args.manifestState.errors[0] ?? "Manifest could not be parsed."
+      detail: args.manifestState.errors[0] ?? "Manifest could not be parsed.",
+      code: "manifest-invalid"
     };
   }
   if (!args.rootfsVerified) {
     return {
       tone: "error",
       label: "not found on Aleph",
-      detail: "The manifest points to a rootfs STORE message that Aleph cannot find. Check that the manifest URL is correct and that the referenced rootfs was not forgotten."
+      detail: "The manifest points to a rootfs STORE message that Aleph cannot find. Check that the manifest URL is correct and that the referenced rootfs was not forgotten.",
+      code: "rootfs-not-found"
     };
   }
   if (!args.resolution) {
     return {
       tone: "caution",
       label: "verifying rootfs",
-      detail: "The rootfs reference is still being resolved."
+      detail: "The rootfs reference is still being resolved.",
+      code: "rootfs-verifying"
     };
   }
   if (args.resolution.messageStatus === "processed") {
     return {
       tone: "ok",
       label: "deployable",
-      detail: args.resolution.gatewayUrl
+      detail: args.resolution.gatewayUrl ?? "Rootfs verified on Aleph.",
+      code: "rootfs-ready"
     };
   }
   if (args.resolution.messageStatus === "pending" && args.resolution.gatewayStatus === "reachable") {
     return {
       tone: "caution",
       label: "pending but reachable",
-      detail: "Gateway probe succeeded even though Aleph still reports pending."
+      detail: "Gateway probe succeeded even though Aleph still reports pending.",
+      code: "rootfs-pending"
     };
   }
   if (args.resolution.messageStatus === "pending") {
     return {
       tone: "caution",
       label: "pending on Aleph",
-      detail: "Wait until the STORE message is processed."
+      detail: "Wait until the STORE message is processed.",
+      code: "rootfs-pending"
     };
   }
   return {
     tone: "error",
     label: "manifest rootfs not deployable",
-    detail: args.resolution.rejectionReason ?? (args.resolution.messageType === "STORE" ? "This manifest points to a rootfs STORE message that exists but is not deployable anymore, for example because it was forgotten or replaced. Double-check the manifest URL." : "Aleph rejected the rootfs reference. Double-check that the manifest URL points to the intended current rootfs.")
+    detail: args.resolution.rejectionReason ?? (args.resolution.messageType === "STORE" ? "This manifest points to a rootfs STORE message that exists but is not deployable anymore, for example because it was forgotten or replaced. Double-check the manifest URL." : "Aleph rejected the rootfs reference. Double-check that the manifest URL points to the intended current rootfs."),
+    code: "rootfs-unavailable"
   };
 }
 async function resolveManifest(args) {
@@ -6397,7 +6418,8 @@ function SponsorRelayFab(props) {
     maxHeight: "calc(100vh - 12.5rem)"
   };
   const launcherLabel = deploymentLauncherLabel(state, compactInlineLabel, launcherMode);
-  const deployCallToAction = state.wallet.connected ? state.busy.deploying ? "Deploying\u2026" : deploymentButtonLabel(state) : "Connect MetaMask";
+  const rootfsBlocked = state.rootfsHealth.tone === "error";
+  const deployCallToAction = state.wallet.connected ? state.busy.deploying ? "Deploying\u2026" : rootfsBlocked ? "Deployment blocked \u2014 Rootfs unavailable" : deploymentButtonLabel(state) : "Connect MetaMask";
   return /* @__PURE__ */ jsxs(Fragment, { children: [
     /* @__PURE__ */ jsx("style", { children: `@keyframes leSpaceRelayPulse { 0%, 100% { transform: scale(1); opacity: 0.74; } 50% { transform: scale(1.22); opacity: 1; } }` }),
     /* @__PURE__ */ jsxs(
@@ -7082,13 +7104,55 @@ function SponsorRelayFab(props) {
             )
           ] })
         ] }),
+        rootfsBlocked ? /* @__PURE__ */ jsxs(
+          "div",
+          {
+            role: "alert",
+            id: "relay-rootfs-deployment-blocker",
+            style: {
+              display: "grid",
+              gap: "0.55rem",
+              marginTop: "1rem",
+              padding: "0.9rem",
+              borderRadius: "1rem",
+              border: "1px solid rgba(248, 113, 113, 0.58)",
+              background: "rgba(127, 29, 29, 0.34)",
+              color: "#fee2e2"
+            },
+            children: [
+              /* @__PURE__ */ jsx("strong", { children: "Rootfs unavailable \u2014 deployment blocked" }),
+              /* @__PURE__ */ jsx("span", { style: { fontSize: "0.82rem", lineHeight: 1.45 }, children: state.rootfsHealth.detail }),
+              /* @__PURE__ */ jsxs("span", { style: { fontSize: "0.75rem", lineHeight: 1.4 }, children: [
+                "This is separate from the connected MetaMask balance. The manifest must reference an Aleph rootfs STORE with status ",
+                /* @__PURE__ */ jsx("code", { children: "processed" }),
+                "."
+              ] }),
+              state.manifest?.rootfsItemHash ? /* @__PURE__ */ jsxs("code", { style: { fontSize: "0.7rem", overflowWrap: "anywhere" }, children: [
+                "Rootfs: ",
+                state.manifest.rootfsItemHash,
+                state.rootfsResolution?.messageStatus ? ` \xB7 Aleph status: ${state.rootfsResolution.messageStatus}` : ""
+              ] }) : null,
+              /* @__PURE__ */ jsxs("div", { style: { display: "flex", flexWrap: "wrap", gap: "0.5rem" }, children: [
+                /* @__PURE__ */ jsx("button", { type: "button", onClick: () => void controller.refresh(), disabled: state.busy.refreshing, style: { ...secondaryButtonStyle, padding: "0.55rem 0.7rem" }, children: state.busy.refreshing ? "Checking\u2026" : "Retry validation" }),
+                /* @__PURE__ */ jsx("button", { type: "button", onClick: () => controller.setShowAdvanced(true), style: { ...secondaryButtonStyle, padding: "0.55rem 0.7rem" }, children: "Edit manifest URL" }),
+                /^https?:\/\//.test(state.manifestUrl) ? /* @__PURE__ */ jsx("a", { href: state.manifestUrl, target: "_blank", rel: "noreferrer", style: { color: "#bfdbfe", alignSelf: "center", fontSize: "0.78rem" }, children: "Open manifest" }) : null
+              ] })
+            ]
+          }
+        ) : null,
         /* @__PURE__ */ jsx(
           "button",
           {
             type: "button",
             onClick: () => void (state.wallet.connected ? controller.deploy() : controller.connectWallet()),
             disabled: state.wallet.connected ? state.busy.deploying || state.rootfsHealth.tone !== "ok" : state.busy.connectingWallet,
-            style: { ...primaryButtonStyle, width: "100%", marginTop: "1rem" },
+            "aria-describedby": rootfsBlocked ? "relay-rootfs-deployment-blocker" : void 0,
+            style: {
+              ...primaryButtonStyle,
+              width: "100%",
+              marginTop: "1rem",
+              ...rootfsBlocked ? { background: "rgba(148, 163, 184, 0.22)", borderColor: "rgba(248, 113, 113, 0.45)", color: "#fee2e2", boxShadow: "none", cursor: "not-allowed" } : {}
+            },
             children: deployCallToAction
           }
         ),

package/shared/index.d.ts

@@ -1,4 +1,4 @@
-type MessageStatus = 'processed' | 'pending' | 'rejected' | 'unknown';
+type MessageStatus = 'processed' | 'pending' | 'rejected' | 'removing' | 'removed' | 'unknown';
 interface BalanceResponse {
     address: string;
     balance: string;
@@ -233,6 +233,7 @@ interface SponsorRelayRootfsHealth {
     tone: SponsorRelayHealthTone;
     label: string;
     detail: string | null;
+    code?: 'manifest-invalid' | 'rootfs-not-found' | 'rootfs-verifying' | 'rootfs-pending' | 'rootfs-unavailable' | 'rootfs-ready';
 }
 interface CompactInstanceDetails {
     messageStatus: string;
@@ -331,7 +332,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.6.22";
+declare const UI_PACKAGE_VERSION = "0.6.24";
 
 interface RootfsRequiredPortForward {
     port: number;
@@ -367,6 +368,11 @@ declare function connectWallet(provider?: EthereumProviderLike | null): Promise<
 declare function personalSign(address: string, message: string, provider?: EthereumProviderLike | null): Promise<string>;
 declare function watchWallet(onChange: () => void, provider?: EthereumProviderLike | null): () => void;
 
+declare function rootfsHealth(args: {
+    manifestState: RootfsManifestState;
+    rootfsVerified: boolean;
+    resolution: SponsorRelayState["rootfsResolution"];
+}): SponsorRelayRootfsHealth;
 declare class SponsorRelayController {
     private state;
     private subscribers;
@@ -426,4 +432,4 @@ interface DeploymentProgressEmitter {
 }
 declare function createDeploymentProgressEmitter(): DeploymentProgressEmitter;
 
-export { type CompactBootstrapRegistrationRecord, type CompactInstanceDetails, type CompactInstanceRecord, DEFAULT_INSTANCE_NAME, DEFAULT_MANIFEST_URL, DEFAULT_TIER_ID, DEFAULT_UCAN_STORE_ALLOWED_CAPABILITIES, DEFAULT_UCAN_STORE_MAX_DELEGATION_EXPIRATION_SECONDS, DEFAULT_UCAN_STORE_PWA_ORIGIN, DEFAULT_UCAN_STORE_SERVICE_DID, DEFAULT_UCAN_STORE_SERVICE_ORIGIN, DEFAULT_UCAN_STORE_USER_DELEGATION_EXPIRATION_SECONDS, DEPLOYMENT_PENDING_WARNING_MS, type DeploymentProgressEmitter, type EthereumProviderLike, IDLE_DEPLOYMENT_PROGRESS, INSTANCE_RUNTIME_PENDING_REFRESH_MS, INSTANCE_RUNTIME_READY_REFRESH_MS, INSTANCE_RUNTIME_STALE_REFRESH_MS, MANIFEST_SOURCE_REFRESH_DEBOUNCE_MS, RECENT_INSTANCE_RUNTIME_GRACE_MS, REFRESH_INTERVAL_MS, ROOTFS_MISSING_STATE, STALE_INSTANCE_ALLOCATION_COOLDOWN_MS, SponsorRelayController, type SponsorRelayHealthTone, type SponsorRelayPricingSummary, type SponsorRelayProps, type SponsorRelayRootfsHealth, type SponsorRelayState, type SponsorRelaySubscriber, type SponsorRelayUcanStoreBootstrapInput, type SponsorRelayWalletState, UI_PACKAGE_VERSION, buildSshCommand, connectWallet, createDeploymentProgressEmitter, createSponsorRelayController, formatDateTime, formatNumber, formatTierSpecLabel, getEthereumProvider, joinMappedPorts, joinRequiredPortForwards, personalSign, resolveManifestSource, shortHash, toChecksumAddress, watchWallet };
+export { type CompactBootstrapRegistrationRecord, type CompactInstanceDetails, type CompactInstanceRecord, DEFAULT_INSTANCE_NAME, DEFAULT_MANIFEST_URL, DEFAULT_TIER_ID, DEFAULT_UCAN_STORE_ALLOWED_CAPABILITIES, DEFAULT_UCAN_STORE_MAX_DELEGATION_EXPIRATION_SECONDS, DEFAULT_UCAN_STORE_PWA_ORIGIN, DEFAULT_UCAN_STORE_SERVICE_DID, DEFAULT_UCAN_STORE_SERVICE_ORIGIN, DEFAULT_UCAN_STORE_USER_DELEGATION_EXPIRATION_SECONDS, DEPLOYMENT_PENDING_WARNING_MS, type DeploymentProgressEmitter, type EthereumProviderLike, IDLE_DEPLOYMENT_PROGRESS, INSTANCE_RUNTIME_PENDING_REFRESH_MS, INSTANCE_RUNTIME_READY_REFRESH_MS, INSTANCE_RUNTIME_STALE_REFRESH_MS, MANIFEST_SOURCE_REFRESH_DEBOUNCE_MS, RECENT_INSTANCE_RUNTIME_GRACE_MS, REFRESH_INTERVAL_MS, ROOTFS_MISSING_STATE, STALE_INSTANCE_ALLOCATION_COOLDOWN_MS, SponsorRelayController, type SponsorRelayHealthTone, type SponsorRelayPricingSummary, type SponsorRelayProps, type SponsorRelayRootfsHealth, type SponsorRelayState, type SponsorRelaySubscriber, type SponsorRelayUcanStoreBootstrapInput, type SponsorRelayWalletState, UI_PACKAGE_VERSION, buildSshCommand, connectWallet, createDeploymentProgressEmitter, createSponsorRelayController, formatDateTime, formatNumber, formatTierSpecLabel, getEthereumProvider, joinMappedPorts, joinRequiredPortForwards, personalSign, resolveManifestSource, rootfsHealth, shortHash, toChecksumAddress, watchWallet };

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.6.22";
+var UI_PACKAGE_VERSION = "0.6.24";
 
 // src/shared/format.ts
 function shortHash(value, head = 8, tail = 6) {
@@ -646,7 +646,7 @@ async function verifyRootfsExists(itemHash, apiHost = DEFAULT_ALEPH_API_HOST) {
 function normalizeStatus(status) {
   if (typeof status !== "string") return "unknown";
   const normalized = status.toLowerCase();
-  if (normalized === "processed" || normalized === "pending" || normalized === "rejected") {
+  if (normalized === "processed" || normalized === "pending" || normalized === "rejected" || normalized === "removing" || normalized === "removed") {
     return normalized;
   }
   return "unknown";
@@ -671,6 +671,7 @@ function parseCidFromPayload(payload) {
 }
 function parseRejectionReason(payload) {
   const errorCode = typeof payload.error_code === "number" ? payload.error_code : null;
+  const reason = typeof payload.reason === "string" ? payload.reason.trim() : "";
   const details = payload.details && typeof payload.details === "object" ? payload.details : null;
   const rawErrors = Array.isArray(details?.errors) ? details.errors : [];
   const firstError = rawErrors[0] && typeof rawErrors[0] === "object" ? rawErrors[0] : null;
@@ -685,6 +686,18 @@ function parseRejectionReason(payload) {
       };
     }
   }
+  if (reason === "balance_insufficient") {
+    return {
+      rejectionErrorCode: errorCode,
+      rejectionReason: "The rootfs STORE is being removed because its publisher no longer has enough Aleph credits. Your connected MetaMask balance may be sufficient, but this manifest must point to a newly published, processed rootfs STORE."
+    };
+  }
+  if (reason) {
+    return {
+      rejectionErrorCode: errorCode,
+      rejectionReason: `Aleph marked the rootfs STORE as unavailable: ${reason.replaceAll("_", " ")}.`
+    };
+  }
   return {
     rejectionErrorCode: errorCode,
     rejectionReason: errorCode != null ? `Rejected by Aleph (error code ${errorCode}).` : null
@@ -726,11 +739,12 @@ async function resolveRootfsReference(itemHash, apiHost = DEFAULT_ALEPH_API_HOST
   const firstMessage = Array.isArray(payload.messages) && payload.messages[0] && typeof payload.messages[0] === "object" ? payload.messages[0] : null;
   const messageObject = payload.message && typeof payload.message === "object" ? payload.message : null;
   const cid = parseCidFromPayload(payload);
-  const rejection = normalizeStatus(payload.status) === "rejected" ? parseRejectionReason(payload) : { rejectionErrorCode: null, rejectionReason: null };
+  const messageStatus = normalizeStatus(payload.status);
+  const rejection = messageStatus === "processed" || messageStatus === "pending" ? { rejectionErrorCode: null, rejectionReason: null } : parseRejectionReason(payload);
   const gateway = cid ? await probeGateway(cid, gatewayBaseUrl) : { gatewayUrl: null, gatewayStatus: "unknown", gatewayError: null };
   return {
     itemHash,
-    messageStatus: normalizeStatus(payload.status),
+    messageStatus,
     messageType: String(payload.type || messageObject?.type || firstMessage?.type || "").toUpperCase() || null,
     cid,
     receptionTime: typeof payload.reception_time === "string" ? payload.reception_time : null,
@@ -3835,48 +3849,55 @@ function rootfsHealth(args) {
     return {
       tone: "error",
       label: "manifest invalid",
-      detail: args.manifestState.errors[0] ?? "Manifest could not be parsed."
+      detail: args.manifestState.errors[0] ?? "Manifest could not be parsed.",
+      code: "manifest-invalid"
     };
   }
   if (!args.rootfsVerified) {
     return {
       tone: "error",
       label: "not found on Aleph",
-      detail: "The manifest points to a rootfs STORE message that Aleph cannot find. Check that the manifest URL is correct and that the referenced rootfs was not forgotten."
+      detail: "The manifest points to a rootfs STORE message that Aleph cannot find. Check that the manifest URL is correct and that the referenced rootfs was not forgotten.",
+      code: "rootfs-not-found"
     };
   }
   if (!args.resolution) {
     return {
       tone: "caution",
       label: "verifying rootfs",
-      detail: "The rootfs reference is still being resolved."
+      detail: "The rootfs reference is still being resolved.",
+      code: "rootfs-verifying"
     };
   }
   if (args.resolution.messageStatus === "processed") {
     return {
       tone: "ok",
       label: "deployable",
-      detail: args.resolution.gatewayUrl
+      detail: args.resolution.gatewayUrl ?? "Rootfs verified on Aleph.",
+      code: "rootfs-ready"
     };
   }
   if (args.resolution.messageStatus === "pending" && args.resolution.gatewayStatus === "reachable") {
     return {
       tone: "caution",
       label: "pending but reachable",
-      detail: "Gateway probe succeeded even though Aleph still reports pending."
+      detail: "Gateway probe succeeded even though Aleph still reports pending.",
+      code: "rootfs-pending"
     };
   }
   if (args.resolution.messageStatus === "pending") {
     return {
       tone: "caution",
       label: "pending on Aleph",
-      detail: "Wait until the STORE message is processed."
+      detail: "Wait until the STORE message is processed.",
+      code: "rootfs-pending"
     };
   }
   return {
     tone: "error",
     label: "manifest rootfs not deployable",
-    detail: args.resolution.rejectionReason ?? (args.resolution.messageType === "STORE" ? "This manifest points to a rootfs STORE message that exists but is not deployable anymore, for example because it was forgotten or replaced. Double-check the manifest URL." : "Aleph rejected the rootfs reference. Double-check that the manifest URL points to the intended current rootfs.")
+    detail: args.resolution.rejectionReason ?? (args.resolution.messageType === "STORE" ? "This manifest points to a rootfs STORE message that exists but is not deployable anymore, for example because it was forgotten or replaced. Double-check the manifest URL." : "Aleph rejected the rootfs reference. Double-check that the manifest URL points to the intended current rootfs."),
+    code: "rootfs-unavailable"
   };
 }
 async function resolveManifest(args) {
@@ -6060,6 +6081,7 @@ export {
   joinRequiredPortForwards,
   personalSign,
   resolveManifestSource,
+  rootfsHealth,
   shortHash,
   toChecksumAddress,
   watchWallet

package/svelte/SponsorRelayFab.svelte

@@ -62,6 +62,12 @@ export let apiHosts = undefined
     return deploymentProfile() === 'ucan-store' ? 'Deploy Service' : 'Deploy Relay'
   }
 
+  function deploymentCallToAction() {
+    if (state.busy.deploying) return 'Deploying…'
+    if (state.rootfsHealth.tone === 'error') return 'Deployment blocked — Rootfs unavailable'
+    return deploymentButtonLabel()
+  }
+
   function bootstrapUiEnabled() {
     return deploymentProfile() !== 'ucan-store'
   }
@@ -264,10 +270,28 @@ export let apiHosts = undefined
       </div>
     </div>
 
+    {#if state.rootfsHealth.tone === 'error'}
+      <div class="rootfs-blocker" id="relay-rootfs-deployment-blocker" role="alert">
+        <strong>Rootfs unavailable — deployment blocked</strong>
+        <p>{state.rootfsHealth.detail}</p>
+        <small>This is separate from the connected MetaMask balance. The manifest must reference an Aleph rootfs STORE with status <code>processed</code>.</small>
+        {#if state.manifest?.rootfsItemHash}
+          <code class="rootfs-reference">Rootfs: {state.manifest.rootfsItemHash}{state.rootfsResolution?.messageStatus ? ` · Aleph status: ${state.rootfsResolution.messageStatus}` : ''}</code>
+        {/if}
+        <div class="rootfs-actions">
+          <button class="refresh" type="button" on:click={() => controller.refresh()} disabled={state.busy.refreshing}>{state.busy.refreshing ? 'Checking…' : 'Retry validation'}</button>
+          <button class="refresh" type="button" on:click={() => controller.setShowAdvanced(true)}>Edit manifest URL</button>
+          {#if /^https?:\/\//.test(state.manifestUrl)}
+            <a href={state.manifestUrl} target="_blank" rel="noreferrer">Open manifest</a>
+          {/if}
+        </div>
+      </div>
+    {/if}
+
     <div class="actions">
       {#if state.wallet.connected}
-        <button class="primary" type="button" on:click={() => controller.deploy()} disabled={state.busy.deploying || state.rootfsHealth.tone !== 'ok'}>
-          {state.busy.deploying ? 'Deploying…' : deploymentButtonLabel()}
+        <button class:blocked={state.rootfsHealth.tone === 'error'} class="primary" type="button" aria-describedby={state.rootfsHealth.tone === 'error' ? 'relay-rootfs-deployment-blocker' : undefined} on:click={() => controller.deploy()} disabled={state.busy.deploying || state.rootfsHealth.tone !== 'ok'}>
+          {deploymentCallToAction()}
         </button>
       {:else}
         <button class="primary" type="button" on:click={() => controller.connectWallet()} disabled={state.busy.connectingWallet}>
@@ -470,6 +494,25 @@ export let apiHosts = undefined
     line-height: 1.35;
   }
 
+  .rootfs-blocker {
+    display: grid;
+    gap: 0.55rem;
+    margin-top: 1rem;
+    padding: 0.9rem;
+    border: 1px solid rgba(248, 113, 113, 0.58);
+    border-radius: 1rem;
+    background: rgba(127, 29, 29, 0.34);
+    color: #fee2e2;
+  }
+
+  .rootfs-blocker p,
+  .rootfs-blocker small { margin: 0; line-height: 1.45; }
+  .rootfs-reference { overflow-wrap: anywhere; font-size: 0.7rem; }
+  .rootfs-actions { display: flex; flex-wrap: wrap; gap: 0.5rem; align-items: center; }
+  .rootfs-actions .refresh { padding: 0.55rem 0.7rem; }
+  .rootfs-actions a { color: #bfdbfe; font-size: 0.78rem; }
+  .primary.blocked { border-color: rgba(248, 113, 113, 0.45); background: rgba(148, 163, 184, 0.22); color: #fee2e2; box-shadow: none; cursor: not-allowed; }
+
   .eyebrow,
   .field span,
   .metric-card span,