@le-space/ui 0.6.23 → 0.6.25

package/README.md

@@ -4,7 +4,7 @@ Floating Aleph relay deployment UI components for Svelte and React.
 
 Primary goals:
 
-- Svelte-first floating `Sponsor Relay` panel
+- Svelte-first floating `Relay Button` panel
 - lightweight React wrapper
 - shared controller and browser-safe Aleph helpers
 - minimal host configuration beyond a rootfs manifest URL

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@le-space/ui",
-  "version": "0.6.23",
-  "description": "Floating Aleph sponsor relay UI components for Svelte and React.",
+  "version": "0.6.25",
+  "description": "Floating Aleph Relay Button UI components for Svelte and React.",
   "license": "MIT",
   "type": "module",
   "files": [
@@ -44,8 +44,8 @@
     "url": "https://github.com/NiKrause/relay-button/issues"
   },
   "dependencies": {
-    "@le-space/browser": "0.6.23",
-    "@le-space/core": "0.6.23",
+    "@le-space/browser": "0.6.25",
+    "@le-space/core": "0.6.25",
     "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.23";
+var UI_PACKAGE_VERSION = "0.6.25";
 
 // 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,
@@ -2472,8 +2486,7 @@ import { keccak256, recoverMessageAddress, stringToHex } from "viem";
 var DEFAULT_ALEPH_API_HOST3 = "https://api.aleph.im";
 var DEFAULT_ALEPH_BOOTSTRAP_CHANNEL = "simple-todo";
 var DEFAULT_ALEPH_BOOTSTRAP_REF = "simple-todo-bootstrap";
-var DEFAULT_ALEPH_BOOTSTRAP_POST_TYPE = "relay-bootstrap";
-var DEFAULT_ALEPH_BOOTSTRAP_COMPACT_POST_TYPE = "relay-bootstrap-v2";
+var DEFAULT_ALEPH_BOOTSTRAP_POST_TYPE = "relay-bootstrap-v2";
 var DEFAULT_BOOTSTRAP_MAX_AGE_MS = 7 * 24 * 60 * 60 * 1e3;
 var DEFAULT_BOOTSTRAP_PAGINATION = 50;
 var DEFAULT_BOOTSTRAP_COMPACT_MULTIADDR_LIMIT = 3;
@@ -2507,9 +2520,6 @@ function serializeRelayProofPayload(payload) {
 function relayBootstrapMultiaddrsHash(addrs) {
   return keccak256(stringToHex(JSON.stringify(dedupeMultiaddrs(addrs))));
 }
-function compactPostType(postType) {
-  return (postType ?? DEFAULT_ALEPH_BOOTSTRAP_COMPACT_POST_TYPE) === DEFAULT_ALEPH_BOOTSTRAP_COMPACT_POST_TYPE;
-}
 function browserMultiaddrPreference(addr) {
   const normalized = addr.toLowerCase();
   if (normalized.includes("/tcp/443/tls/ws/")) return 0;
@@ -2739,8 +2749,6 @@ function normalizeRelayBootstrapPostRecord(value) {
 function buildRelayBootstrapPostContent(args) {
   const now = args.now ?? Date.now() / 1e3;
   const updatedAt = args.now ?? Date.now();
-  const postType = args.postType ?? DEFAULT_ALEPH_BOOTSTRAP_POST_TYPE;
-  const compact = args.compact ?? compactPostType(postType);
   const fullMultiaddrs = filterPublicMultiaddrs(args.multiaddrs);
   const fullBrowserMultiaddrs = args.browserMultiaddrs ? filterPublicMultiaddrs(args.browserMultiaddrs, {
     browserDialableOnly: true
@@ -2750,13 +2758,13 @@ function buildRelayBootstrapPostContent(args) {
     args.compactMultiaddrLimit
   );
   return {
-    type: postType,
+    type: DEFAULT_ALEPH_BOOTSTRAP_POST_TYPE,
     address: args.sender,
     ...args.ref ? { ref: args.ref } : {},
     content: {
       peerId: args.peerId,
-      multiaddrs: compact ? compactMultiaddrs : fullMultiaddrs,
-      browserMultiaddrs: compact ? void 0 : fullBrowserMultiaddrs,
+      multiaddrs: compactMultiaddrs,
+      browserMultiaddrs: void 0,
       registrationId: args.registrationId,
       profile: args.profile,
       version: args.version,
@@ -2779,14 +2787,12 @@ async function createRelayBootstrapPost(args) {
     browserMultiaddrs: args.browserMultiaddrs,
     registrationId: args.registrationId,
     ref: args.ref ?? DEFAULT_ALEPH_BOOTSTRAP_REF,
-    postType: args.postType ?? DEFAULT_ALEPH_BOOTSTRAP_POST_TYPE,
     profile: args.profile,
     version: args.version,
     ownerAddress: args.ownerAddress,
     publisherAddress: args.publisherAddress,
     authorization: args.authorization,
     relayProof: args.relayProof,
-    compact: args.compact,
     compactMultiaddrLimit: args.compactMultiaddrLimit,
     now: nowMillis
   });
@@ -2833,12 +2839,11 @@ async function signRelayBootstrapProof(args) {
     fullBrowserMultiaddrs && fullBrowserMultiaddrs.length > 0 ? fullBrowserMultiaddrs : fullMultiaddrs,
     args.compactMultiaddrLimit
   );
-  const compact = args.compact ?? false;
   const payload = {
     peerId: args.peerId,
-    multiaddrs: compact ? void 0 : fullMultiaddrs,
-    browserMultiaddrs: compact ? void 0 : fullBrowserMultiaddrs,
-    multiaddrsHash: compact ? relayBootstrapMultiaddrsHash(compactMultiaddrs) : void 0,
+    multiaddrs: void 0,
+    browserMultiaddrs: void 0,
+    multiaddrsHash: relayBootstrapMultiaddrsHash(compactMultiaddrs),
     registrationId: args.registrationId,
     profile: args.profile,
     version: args.version,
@@ -2868,10 +2873,7 @@ async function fetchAlephBootstrapPosts(options = {}) {
     options.channel ?? DEFAULT_ALEPH_BOOTSTRAP_CHANNEL
   );
   url.searchParams.set("refs", options.ref ?? DEFAULT_ALEPH_BOOTSTRAP_REF);
-  url.searchParams.set(
-    "types",
-    options.postType ?? DEFAULT_ALEPH_BOOTSTRAP_POST_TYPE
-  );
+  url.searchParams.set("types", DEFAULT_ALEPH_BOOTSTRAP_POST_TYPE);
   url.searchParams.set(
     "pagination",
     String(options.pagination ?? DEFAULT_BOOTSTRAP_PAGINATION)
@@ -2885,7 +2887,21 @@ async function fetchAlephBootstrapPosts(options = {}) {
     throw new Error(`Aleph bootstrap post lookup failed: ${response.status}`);
   }
   const payload = await response.json();
-  return (payload.posts ?? []).map((entry) => normalizeRelayBootstrapPostRecord(entry)).filter((entry) => entry != null).sort((left, right) => compareRelayBootstrapPostRecency(right, left));
+  const posts = (payload.posts ?? []).map((entry) => normalizeRelayBootstrapPostRecord(entry)).filter((entry) => entry != null).sort((left, right) => compareRelayBootstrapPostRecency(right, left));
+  posts.forEach(assertSupportedRelayBootstrapPost);
+  return posts;
+}
+function assertSupportedRelayBootstrapPost(post) {
+  if (post.type === "relay-bootstrap") {
+    throw new Error(
+      "Legacy relay-bootstrap record encountered. Only relay-bootstrap-v2 is supported."
+    );
+  }
+  if (post.type && post.type !== DEFAULT_ALEPH_BOOTSTRAP_POST_TYPE) {
+    throw new Error(
+      `Unsupported relay bootstrap post type: ${post.type}. Expected ${DEFAULT_ALEPH_BOOTSTRAP_POST_TYPE}.`
+    );
+  }
 }
 function compareRelayBootstrapPostRecency(left, right) {
   const leftUpdatedAt = left.content?.updatedAt ?? 0;
@@ -2907,6 +2923,7 @@ function selectCurrentRelayBootstrapPosts(posts, options = {}) {
   const now = options.now ?? Date.now();
   const selected = /* @__PURE__ */ new Map();
   for (const post of posts) {
+    assertSupportedRelayBootstrapPost(post);
     const content = post.content;
     if (!content) continue;
     if (now - content.updatedAt > maxAgeMs) continue;
@@ -2932,14 +2949,12 @@ async function waitForRelayBootstrapRegistration(args) {
   const expectedSender = args.sender?.trim().toLowerCase() || null;
   const expectedRegistrationId = args.registrationId?.trim() || null;
   const expectedPeerId = args.peerId?.trim() || null;
-  const postType = args.postType ?? DEFAULT_ALEPH_BOOTSTRAP_COMPACT_POST_TYPE;
   const sleepImpl = args.sleep ?? sleep;
   for (let attempt = 0; attempt < attempts; attempt += 1) {
     const posts = await fetchAlephBootstrapPosts({
       apiHost: args.apiHost ?? DEFAULT_ALEPH_API_HOST3,
       channel: args.channel,
       ref: args.ref,
-      postType,
       fetch: args.fetch
     });
     const currentPosts = selectCurrentRelayBootstrapPosts(posts);
@@ -2978,8 +2993,6 @@ async function waitForRelayBootstrapRegistration(args) {
 async function publishRelayBootstrapRegistration(args) {
   const publisherAddress = args.publisherAddress ?? args.sender;
   const ownerAddress = args.ownerAddress;
-  const postType = args.postType ?? DEFAULT_ALEPH_BOOTSTRAP_COMPACT_POST_TYPE;
-  const compact = postType === DEFAULT_ALEPH_BOOTSTRAP_COMPACT_POST_TYPE;
   let ownerAuthorization = args.ownerAuthorization;
   let relayProof = args.relayProof;
   if (!ownerAuthorization && ownerAddress && args.ownerSigner) {
@@ -3006,7 +3019,6 @@ async function publishRelayBootstrapRegistration(args) {
       profile: args.profile,
       version: args.version,
       updatedAt: args.now ?? Date.now(),
-      compact,
       compactMultiaddrLimit: args.compactMultiaddrLimit,
       signer: args.publisherSigner
     });
@@ -3019,14 +3031,12 @@ async function publishRelayBootstrapRegistration(args) {
     registrationId: args.registrationId,
     channel: args.channel,
     ref: args.ref,
-    postType,
     profile: args.profile,
     version: args.version,
     ownerAddress,
     publisherAddress,
     authorization: ownerAuthorization,
     relayProof,
-    compact,
     compactMultiaddrLimit: args.compactMultiaddrLimit,
     now: args.now,
     hasher: args.hasher
@@ -3049,18 +3059,12 @@ async function publishRelayBootstrapRegistration(args) {
   let forgottenHashes = [];
   let forgetResult;
   if (args.forgetPrevious && args.registrationId) {
-    const previousPostTypes = compact ? [postType, DEFAULT_ALEPH_BOOTSTRAP_POST_TYPE] : [postType];
-    const previousPosts = (await Promise.all(
-      previousPostTypes.map(
-        (previousPostType) => fetchAlephBootstrapPosts({
-          apiHost: args.apiHost ?? DEFAULT_ALEPH_API_HOST3,
-          channel: args.channel,
-          ref: args.ref,
-          postType: previousPostType,
-          fetch: args.fetch
-        })
-      )
-    )).flat();
+    const previousPosts = await fetchAlephBootstrapPosts({
+      apiHost: args.apiHost ?? DEFAULT_ALEPH_API_HOST3,
+      channel: args.channel,
+      ref: args.ref,
+      fetch: args.fetch
+    });
     const forgottenHashSet = new Set(
       previousPosts.filter((post) => {
         const hash = post.itemHash ?? post.hash;
@@ -3662,7 +3666,9 @@ function draftUcanStoreBootstrapErrors(args) {
   const errors = [];
   const { input } = args;
   if (!args.operatorAddress) {
-    errors.push("Connect MetaMask before configuring the ucan-store bootstrap package.");
+    errors.push(
+      "Connect MetaMask before configuring the ucan-store bootstrap package."
+    );
   }
   if (!input.adminDid.trim().startsWith("did:")) {
     errors.push("Admin DID must be a non-empty DID string.");
@@ -3713,7 +3719,9 @@ function buildUcanStoreBootstrapPackage(args) {
     serviceDid: args.input.serviceDid.trim() || null,
     spaceDid: args.input.spaceDid.trim(),
     rootDelegationProof: args.input.rootDelegationProof.trim(),
-    allowedCapabilities: parseAllowedCapabilities(args.input.allowedCapabilities),
+    allowedCapabilities: parseAllowedCapabilities(
+      args.input.allowedCapabilities
+    ),
     defaultUserDelegationExpiration: parseOptionalExpiration(
       args.input.defaultUserDelegationExpiration
     ),
@@ -3752,7 +3760,9 @@ function defaultState(props = {}) {
     instanceName: props.instanceName ?? DEFAULT_INSTANCE_NAME,
     ucanStoreBootstrap: defaultUcanStoreBootstrapInput(props),
     tierId: DEFAULT_TIER_ID,
-    showAdvanced: Boolean(props.manifestJson?.trim() || props.sshPublicKey?.trim()),
+    showAdvanced: Boolean(
+      props.manifestJson?.trim() || props.sshPublicKey?.trim()
+    ),
     showInstances: props.showInstances ?? true,
     showPasteManifest: Boolean(props.manifestJson?.trim()),
     busy: {
@@ -3836,48 +3846,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 ?? "Rootfs verified on Aleph."
+      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) {
@@ -4165,7 +4182,9 @@ var SponsorRelayController = class {
     const profile = bootstrapRelayProfileForManifest(this.state.manifest);
     if (!profile && deploymentProfile !== "ucan-store") return;
     if (profile && !this.state.wallet.address) {
-      throw new Error("A connected wallet is required to register relay bootstrap addresses.");
+      throw new Error(
+        "A connected wallet is required to register relay bootstrap addresses."
+      );
     }
     const runtimeHostIpv4 = args.runtime.hostIpv4;
     if (!runtimeHostIpv4) {
@@ -4189,7 +4208,9 @@ var SponsorRelayController = class {
       }
       const walletAddress2 = this.state.wallet.address;
       if (!walletAddress2) {
-        throw new Error("A connected wallet is required to configure the ucan-store bootstrap package.");
+        throw new Error(
+          "A connected wallet is required to configure the ucan-store bootstrap package."
+        );
       }
       const bootstrapValidation = buildUcanStoreBootstrapPackage({
         input: this.state.ucanStoreBootstrap,
@@ -4304,7 +4325,9 @@ var SponsorRelayController = class {
     if (!profile) return;
     const walletAddress = this.state.wallet.address;
     if (!walletAddress) {
-      throw new Error("A connected wallet is required to register relay bootstrap addresses.");
+      throw new Error(
+        "A connected wallet is required to register relay bootstrap addresses."
+      );
     }
     let bootstrapSignalRelayMetadata = null;
     if (profile === "orbitdb-relay") {
@@ -4350,7 +4373,9 @@ var SponsorRelayController = class {
       const tcpPort = mappedPorts2["9091"]?.host ?? 0;
       const wsPort = mappedPorts2["9092"]?.host ?? mappedPorts2["443"]?.host ?? 0;
       if (!tcpPort || !wsPort) {
-        throw new Error("OrbitDB relay runtime is missing required mapped TCP/WS ports.");
+        throw new Error(
+          "OrbitDB relay runtime is missing required mapped TCP/WS ports."
+        );
       }
       const configureResult = await configureOrbitdbRelaySetup2({
         hostIpv4: runtimeHostIpv4,
@@ -4373,7 +4398,9 @@ var SponsorRelayController = class {
       }
     } else {
       if (!args.deploymentToken) {
-        throw new Error("Missing deployment token for Aleph bootstrap config handoff.");
+        throw new Error(
+          "Missing deployment token for Aleph bootstrap config handoff."
+        );
       }
       if (runtime.proxyUrl && runtime.webAccess?.active !== true) {
         this.emitProgress({
@@ -4599,7 +4626,19 @@ var SponsorRelayController = class {
         });
         return;
       }
-      throw new Error("Relay metadata did not include a peer ID and public multiaddrs.");
+      throw new Error(
+        "Relay metadata did not include a peer ID and public multiaddrs."
+      );
+    }
+    if (profile === "uc-go-peer") {
+      const browserDialableMultiaddrs = relayMetadata.browserBootstrapMultiaddrs.filter(
+        (multiaddr) => /\/(?:tls\/ws|wss)\/p2p\//.test(multiaddr) || /\/(?:webtransport|webrtc-direct)\//.test(multiaddr) && /\/certhash\//.test(multiaddr)
+      );
+      if (browserDialableMultiaddrs.length === 0) {
+        throw new Error(
+          "Relay metadata did not include a browser-dialable WSS address or a WebTransport/WebRTC Direct address with certhash."
+        );
+      }
     }
     const { peerId } = relayMetadata;
     const registrationId = createRelayBootstrapRegistrationId(
@@ -5151,18 +5190,10 @@ var SponsorRelayController = class {
         const [nextBalance, rawInstances, rawBootstrapPosts] = await Promise.all([
           this.client.fetchBalance(this.state.wallet.address),
           this.state.showInstances ? this.client.fetchInstances(this.state.wallet.address) : Promise.resolve([]),
-          bootstrapEnabled ? Promise.all(
-            [
-              DEFAULT_ALEPH_BOOTSTRAP_COMPACT_POST_TYPE,
-              DEFAULT_ALEPH_BOOTSTRAP_POST_TYPE
-            ].map(
-              (postType) => fetchAlephBootstrapPosts({
-                apiHost: this.client.apiHost,
-                postType,
-                fetch
-              }).catch(() => [])
-            )
-          ).then((pages) => pages.flat()) : Promise.resolve([])
+          bootstrapEnabled ? fetchAlephBootstrapPosts({
+            apiHost: this.client.apiHost,
+            fetch
+          }) : Promise.resolve([])
         ]);
         balance = nextBalance;
         instances = await Promise.all(
@@ -5226,7 +5257,9 @@ var SponsorRelayController = class {
         const activeInstanceHashes = new Set(
           instances.map((entry) => entry.instance.item_hash)
         );
-        bootstrapRegistrations = selectCurrentRelayBootstrapPosts(rawBootstrapPosts).filter(
+        bootstrapRegistrations = selectCurrentRelayBootstrapPosts(
+          rawBootstrapPosts
+        ).filter(
           (entry) => relayBootstrapMatchesCurrentWallet(
             entry,
             normalizedWalletAddress,
@@ -5249,7 +5282,9 @@ var SponsorRelayController = class {
               peerId: entry.content.peerId,
               registrationId: entry.content.registrationId,
               multiaddrs: Array.isArray(entry.content.multiaddrs) ? entry.content.multiaddrs : [],
-              browserMultiaddrs: Array.isArray(entry.content.browserMultiaddrs) ? entry.content.browserMultiaddrs : [],
+              browserMultiaddrs: Array.isArray(
+                entry.content.browserMultiaddrs
+              ) ? entry.content.browserMultiaddrs : [],
               ownerAddress: typeof entry.content.ownerAddress === "string" ? entry.content.ownerAddress : void 0,
               publisherAddress: typeof entry.content.publisherAddress === "string" ? entry.content.publisherAddress : void 0,
               updatedAt: entry.content.updatedAt
@@ -5370,7 +5405,9 @@ var SponsorRelayController = class {
         ...compatibleCrns2.filter((crn) => crn.hash !== preferredCrnHash)
       ].slice(0, 5);
       if (orderedCrns.length === 0) {
-        throw new Error("No compatible CRN is currently available for this tier.");
+        throw new Error(
+          "No compatible CRN is currently available for this tier."
+        );
       }
       const attemptErrors = [];
       let lastError = null;
@@ -5803,7 +5840,7 @@ var SponsorRelayController = class {
             await forgetAlephMessages({
               sender: this.state.wallet.address,
               hashes: [attemptItemHash],
-              reason: `Discard failed Sponsor Relay deployment attempt on ${attemptLabel}`,
+              reason: `Discard failed Relay Button deployment attempt on ${attemptLabel}`,
               signer: personalSign,
               hasher: sha256Hex,
               fetch: (url, init) => fetch(url, init).then(async (response) => ({
@@ -5913,7 +5950,7 @@ var SponsorRelayController = class {
       await forgetAlephMessages({
         sender: this.state.wallet.address,
         hashes: hashesToForget,
-        reason: linkedRegistrationCount > 0 ? `Deleted instance and ${linkedRegistrationCount} linked relay bootstrap registration${linkedRegistrationCount === 1 ? "" : "s"} from Sponsor Relay panel` : "Deleted from Sponsor Relay panel",
+        reason: linkedRegistrationCount > 0 ? `Deleted instance and ${linkedRegistrationCount} linked relay bootstrap registration${linkedRegistrationCount === 1 ? "" : "s"} from Relay Button panel` : "Deleted from Relay Button panel",
         signer: personalSign,
         hasher: sha256Hex,
         fetch: asJsonFetch,
@@ -5982,7 +6019,7 @@ var SponsorRelayController = class {
       await forgetAlephMessages({
         sender: this.state.wallet.address,
         hashes: [registrationHash],
-        reason: "Deleted orphan relay bootstrap registration from Sponsor Relay panel",
+        reason: "Deleted orphan relay bootstrap registration from Relay Button panel",
         signer: personalSign,
         hasher: sha256Hex,
         fetch: asJsonFetch,
@@ -6187,7 +6224,7 @@ function supportsBootstrapUi(state) {
   return stateDeploymentProfile(state) !== "ucan-store";
 }
 function deploymentPanelTitle(state) {
-  return stateDeploymentProfile(state) === "ucan-store" ? "Sponsor Service" : "Sponsor Relay";
+  return stateDeploymentProfile(state) === "ucan-store" ? "Sponsor Service" : "Relay Button";
 }
 function deploymentLauncherLabel(state, compactInlineLabel, launcherMode) {
   if (launcherMode === "inline" && compactInlineLabel) {
@@ -6397,7 +6434,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 +7120,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.23";
+declare const UI_PACKAGE_VERSION = "0.6.25";
 
 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.6.23";
+var UI_PACKAGE_VERSION = "0.6.25";
 
 // 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,
@@ -2471,8 +2485,7 @@ import { keccak256, recoverMessageAddress, stringToHex } from "viem";
 var DEFAULT_ALEPH_API_HOST3 = "https://api.aleph.im";
 var DEFAULT_ALEPH_BOOTSTRAP_CHANNEL = "simple-todo";
 var DEFAULT_ALEPH_BOOTSTRAP_REF = "simple-todo-bootstrap";
-var DEFAULT_ALEPH_BOOTSTRAP_POST_TYPE = "relay-bootstrap";
-var DEFAULT_ALEPH_BOOTSTRAP_COMPACT_POST_TYPE = "relay-bootstrap-v2";
+var DEFAULT_ALEPH_BOOTSTRAP_POST_TYPE = "relay-bootstrap-v2";
 var DEFAULT_BOOTSTRAP_MAX_AGE_MS = 7 * 24 * 60 * 60 * 1e3;
 var DEFAULT_BOOTSTRAP_PAGINATION = 50;
 var DEFAULT_BOOTSTRAP_COMPACT_MULTIADDR_LIMIT = 3;
@@ -2506,9 +2519,6 @@ function serializeRelayProofPayload(payload) {
 function relayBootstrapMultiaddrsHash(addrs) {
   return keccak256(stringToHex(JSON.stringify(dedupeMultiaddrs(addrs))));
 }
-function compactPostType(postType) {
-  return (postType ?? DEFAULT_ALEPH_BOOTSTRAP_COMPACT_POST_TYPE) === DEFAULT_ALEPH_BOOTSTRAP_COMPACT_POST_TYPE;
-}
 function browserMultiaddrPreference(addr) {
   const normalized = addr.toLowerCase();
   if (normalized.includes("/tcp/443/tls/ws/")) return 0;
@@ -2738,8 +2748,6 @@ function normalizeRelayBootstrapPostRecord(value) {
 function buildRelayBootstrapPostContent(args) {
   const now = args.now ?? Date.now() / 1e3;
   const updatedAt = args.now ?? Date.now();
-  const postType = args.postType ?? DEFAULT_ALEPH_BOOTSTRAP_POST_TYPE;
-  const compact = args.compact ?? compactPostType(postType);
   const fullMultiaddrs = filterPublicMultiaddrs(args.multiaddrs);
   const fullBrowserMultiaddrs = args.browserMultiaddrs ? filterPublicMultiaddrs(args.browserMultiaddrs, {
     browserDialableOnly: true
@@ -2749,13 +2757,13 @@ function buildRelayBootstrapPostContent(args) {
     args.compactMultiaddrLimit
   );
   return {
-    type: postType,
+    type: DEFAULT_ALEPH_BOOTSTRAP_POST_TYPE,
     address: args.sender,
     ...args.ref ? { ref: args.ref } : {},
     content: {
       peerId: args.peerId,
-      multiaddrs: compact ? compactMultiaddrs : fullMultiaddrs,
-      browserMultiaddrs: compact ? void 0 : fullBrowserMultiaddrs,
+      multiaddrs: compactMultiaddrs,
+      browserMultiaddrs: void 0,
       registrationId: args.registrationId,
       profile: args.profile,
       version: args.version,
@@ -2778,14 +2786,12 @@ async function createRelayBootstrapPost(args) {
     browserMultiaddrs: args.browserMultiaddrs,
     registrationId: args.registrationId,
     ref: args.ref ?? DEFAULT_ALEPH_BOOTSTRAP_REF,
-    postType: args.postType ?? DEFAULT_ALEPH_BOOTSTRAP_POST_TYPE,
     profile: args.profile,
     version: args.version,
     ownerAddress: args.ownerAddress,
     publisherAddress: args.publisherAddress,
     authorization: args.authorization,
     relayProof: args.relayProof,
-    compact: args.compact,
     compactMultiaddrLimit: args.compactMultiaddrLimit,
     now: nowMillis
   });
@@ -2832,12 +2838,11 @@ async function signRelayBootstrapProof(args) {
     fullBrowserMultiaddrs && fullBrowserMultiaddrs.length > 0 ? fullBrowserMultiaddrs : fullMultiaddrs,
     args.compactMultiaddrLimit
   );
-  const compact = args.compact ?? false;
   const payload = {
     peerId: args.peerId,
-    multiaddrs: compact ? void 0 : fullMultiaddrs,
-    browserMultiaddrs: compact ? void 0 : fullBrowserMultiaddrs,
-    multiaddrsHash: compact ? relayBootstrapMultiaddrsHash(compactMultiaddrs) : void 0,
+    multiaddrs: void 0,
+    browserMultiaddrs: void 0,
+    multiaddrsHash: relayBootstrapMultiaddrsHash(compactMultiaddrs),
     registrationId: args.registrationId,
     profile: args.profile,
     version: args.version,
@@ -2867,10 +2872,7 @@ async function fetchAlephBootstrapPosts(options = {}) {
     options.channel ?? DEFAULT_ALEPH_BOOTSTRAP_CHANNEL
   );
   url.searchParams.set("refs", options.ref ?? DEFAULT_ALEPH_BOOTSTRAP_REF);
-  url.searchParams.set(
-    "types",
-    options.postType ?? DEFAULT_ALEPH_BOOTSTRAP_POST_TYPE
-  );
+  url.searchParams.set("types", DEFAULT_ALEPH_BOOTSTRAP_POST_TYPE);
   url.searchParams.set(
     "pagination",
     String(options.pagination ?? DEFAULT_BOOTSTRAP_PAGINATION)
@@ -2884,7 +2886,21 @@ async function fetchAlephBootstrapPosts(options = {}) {
     throw new Error(`Aleph bootstrap post lookup failed: ${response.status}`);
   }
   const payload = await response.json();
-  return (payload.posts ?? []).map((entry) => normalizeRelayBootstrapPostRecord(entry)).filter((entry) => entry != null).sort((left, right) => compareRelayBootstrapPostRecency(right, left));
+  const posts = (payload.posts ?? []).map((entry) => normalizeRelayBootstrapPostRecord(entry)).filter((entry) => entry != null).sort((left, right) => compareRelayBootstrapPostRecency(right, left));
+  posts.forEach(assertSupportedRelayBootstrapPost);
+  return posts;
+}
+function assertSupportedRelayBootstrapPost(post) {
+  if (post.type === "relay-bootstrap") {
+    throw new Error(
+      "Legacy relay-bootstrap record encountered. Only relay-bootstrap-v2 is supported."
+    );
+  }
+  if (post.type && post.type !== DEFAULT_ALEPH_BOOTSTRAP_POST_TYPE) {
+    throw new Error(
+      `Unsupported relay bootstrap post type: ${post.type}. Expected ${DEFAULT_ALEPH_BOOTSTRAP_POST_TYPE}.`
+    );
+  }
 }
 function compareRelayBootstrapPostRecency(left, right) {
   const leftUpdatedAt = left.content?.updatedAt ?? 0;
@@ -2906,6 +2922,7 @@ function selectCurrentRelayBootstrapPosts(posts, options = {}) {
   const now = options.now ?? Date.now();
   const selected = /* @__PURE__ */ new Map();
   for (const post of posts) {
+    assertSupportedRelayBootstrapPost(post);
     const content = post.content;
     if (!content) continue;
     if (now - content.updatedAt > maxAgeMs) continue;
@@ -2931,14 +2948,12 @@ async function waitForRelayBootstrapRegistration(args) {
   const expectedSender = args.sender?.trim().toLowerCase() || null;
   const expectedRegistrationId = args.registrationId?.trim() || null;
   const expectedPeerId = args.peerId?.trim() || null;
-  const postType = args.postType ?? DEFAULT_ALEPH_BOOTSTRAP_COMPACT_POST_TYPE;
   const sleepImpl = args.sleep ?? sleep;
   for (let attempt = 0; attempt < attempts; attempt += 1) {
     const posts = await fetchAlephBootstrapPosts({
       apiHost: args.apiHost ?? DEFAULT_ALEPH_API_HOST3,
       channel: args.channel,
       ref: args.ref,
-      postType,
       fetch: args.fetch
     });
     const currentPosts = selectCurrentRelayBootstrapPosts(posts);
@@ -2977,8 +2992,6 @@ async function waitForRelayBootstrapRegistration(args) {
 async function publishRelayBootstrapRegistration(args) {
   const publisherAddress = args.publisherAddress ?? args.sender;
   const ownerAddress = args.ownerAddress;
-  const postType = args.postType ?? DEFAULT_ALEPH_BOOTSTRAP_COMPACT_POST_TYPE;
-  const compact = postType === DEFAULT_ALEPH_BOOTSTRAP_COMPACT_POST_TYPE;
   let ownerAuthorization = args.ownerAuthorization;
   let relayProof = args.relayProof;
   if (!ownerAuthorization && ownerAddress && args.ownerSigner) {
@@ -3005,7 +3018,6 @@ async function publishRelayBootstrapRegistration(args) {
       profile: args.profile,
       version: args.version,
       updatedAt: args.now ?? Date.now(),
-      compact,
       compactMultiaddrLimit: args.compactMultiaddrLimit,
       signer: args.publisherSigner
     });
@@ -3018,14 +3030,12 @@ async function publishRelayBootstrapRegistration(args) {
     registrationId: args.registrationId,
     channel: args.channel,
     ref: args.ref,
-    postType,
     profile: args.profile,
     version: args.version,
     ownerAddress,
     publisherAddress,
     authorization: ownerAuthorization,
     relayProof,
-    compact,
     compactMultiaddrLimit: args.compactMultiaddrLimit,
     now: args.now,
     hasher: args.hasher
@@ -3048,18 +3058,12 @@ async function publishRelayBootstrapRegistration(args) {
   let forgottenHashes = [];
   let forgetResult;
   if (args.forgetPrevious && args.registrationId) {
-    const previousPostTypes = compact ? [postType, DEFAULT_ALEPH_BOOTSTRAP_POST_TYPE] : [postType];
-    const previousPosts = (await Promise.all(
-      previousPostTypes.map(
-        (previousPostType) => fetchAlephBootstrapPosts({
-          apiHost: args.apiHost ?? DEFAULT_ALEPH_API_HOST3,
-          channel: args.channel,
-          ref: args.ref,
-          postType: previousPostType,
-          fetch: args.fetch
-        })
-      )
-    )).flat();
+    const previousPosts = await fetchAlephBootstrapPosts({
+      apiHost: args.apiHost ?? DEFAULT_ALEPH_API_HOST3,
+      channel: args.channel,
+      ref: args.ref,
+      fetch: args.fetch
+    });
     const forgottenHashSet = new Set(
       previousPosts.filter((post) => {
         const hash = post.itemHash ?? post.hash;
@@ -3661,7 +3665,9 @@ function draftUcanStoreBootstrapErrors(args) {
   const errors = [];
   const { input } = args;
   if (!args.operatorAddress) {
-    errors.push("Connect MetaMask before configuring the ucan-store bootstrap package.");
+    errors.push(
+      "Connect MetaMask before configuring the ucan-store bootstrap package."
+    );
   }
   if (!input.adminDid.trim().startsWith("did:")) {
     errors.push("Admin DID must be a non-empty DID string.");
@@ -3712,7 +3718,9 @@ function buildUcanStoreBootstrapPackage(args) {
     serviceDid: args.input.serviceDid.trim() || null,
     spaceDid: args.input.spaceDid.trim(),
     rootDelegationProof: args.input.rootDelegationProof.trim(),
-    allowedCapabilities: parseAllowedCapabilities(args.input.allowedCapabilities),
+    allowedCapabilities: parseAllowedCapabilities(
+      args.input.allowedCapabilities
+    ),
     defaultUserDelegationExpiration: parseOptionalExpiration(
       args.input.defaultUserDelegationExpiration
     ),
@@ -3751,7 +3759,9 @@ function defaultState(props = {}) {
     instanceName: props.instanceName ?? DEFAULT_INSTANCE_NAME,
     ucanStoreBootstrap: defaultUcanStoreBootstrapInput(props),
     tierId: DEFAULT_TIER_ID,
-    showAdvanced: Boolean(props.manifestJson?.trim() || props.sshPublicKey?.trim()),
+    showAdvanced: Boolean(
+      props.manifestJson?.trim() || props.sshPublicKey?.trim()
+    ),
     showInstances: props.showInstances ?? true,
     showPasteManifest: Boolean(props.manifestJson?.trim()),
     busy: {
@@ -3835,48 +3845,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 ?? "Rootfs verified on Aleph."
+      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) {
@@ -4164,7 +4181,9 @@ var SponsorRelayController = class {
     const profile = bootstrapRelayProfileForManifest(this.state.manifest);
     if (!profile && deploymentProfile !== "ucan-store") return;
     if (profile && !this.state.wallet.address) {
-      throw new Error("A connected wallet is required to register relay bootstrap addresses.");
+      throw new Error(
+        "A connected wallet is required to register relay bootstrap addresses."
+      );
     }
     const runtimeHostIpv4 = args.runtime.hostIpv4;
     if (!runtimeHostIpv4) {
@@ -4188,7 +4207,9 @@ var SponsorRelayController = class {
       }
       const walletAddress2 = this.state.wallet.address;
       if (!walletAddress2) {
-        throw new Error("A connected wallet is required to configure the ucan-store bootstrap package.");
+        throw new Error(
+          "A connected wallet is required to configure the ucan-store bootstrap package."
+        );
       }
       const bootstrapValidation = buildUcanStoreBootstrapPackage({
         input: this.state.ucanStoreBootstrap,
@@ -4303,7 +4324,9 @@ var SponsorRelayController = class {
     if (!profile) return;
     const walletAddress = this.state.wallet.address;
     if (!walletAddress) {
-      throw new Error("A connected wallet is required to register relay bootstrap addresses.");
+      throw new Error(
+        "A connected wallet is required to register relay bootstrap addresses."
+      );
     }
     let bootstrapSignalRelayMetadata = null;
     if (profile === "orbitdb-relay") {
@@ -4349,7 +4372,9 @@ var SponsorRelayController = class {
       const tcpPort = mappedPorts2["9091"]?.host ?? 0;
       const wsPort = mappedPorts2["9092"]?.host ?? mappedPorts2["443"]?.host ?? 0;
       if (!tcpPort || !wsPort) {
-        throw new Error("OrbitDB relay runtime is missing required mapped TCP/WS ports.");
+        throw new Error(
+          "OrbitDB relay runtime is missing required mapped TCP/WS ports."
+        );
       }
       const configureResult = await configureOrbitdbRelaySetup2({
         hostIpv4: runtimeHostIpv4,
@@ -4372,7 +4397,9 @@ var SponsorRelayController = class {
       }
     } else {
       if (!args.deploymentToken) {
-        throw new Error("Missing deployment token for Aleph bootstrap config handoff.");
+        throw new Error(
+          "Missing deployment token for Aleph bootstrap config handoff."
+        );
       }
       if (runtime.proxyUrl && runtime.webAccess?.active !== true) {
         this.emitProgress({
@@ -4598,7 +4625,19 @@ var SponsorRelayController = class {
         });
         return;
       }
-      throw new Error("Relay metadata did not include a peer ID and public multiaddrs.");
+      throw new Error(
+        "Relay metadata did not include a peer ID and public multiaddrs."
+      );
+    }
+    if (profile === "uc-go-peer") {
+      const browserDialableMultiaddrs = relayMetadata.browserBootstrapMultiaddrs.filter(
+        (multiaddr) => /\/(?:tls\/ws|wss)\/p2p\//.test(multiaddr) || /\/(?:webtransport|webrtc-direct)\//.test(multiaddr) && /\/certhash\//.test(multiaddr)
+      );
+      if (browserDialableMultiaddrs.length === 0) {
+        throw new Error(
+          "Relay metadata did not include a browser-dialable WSS address or a WebTransport/WebRTC Direct address with certhash."
+        );
+      }
     }
     const { peerId } = relayMetadata;
     const registrationId = createRelayBootstrapRegistrationId(
@@ -5150,18 +5189,10 @@ var SponsorRelayController = class {
         const [nextBalance, rawInstances, rawBootstrapPosts] = await Promise.all([
           this.client.fetchBalance(this.state.wallet.address),
           this.state.showInstances ? this.client.fetchInstances(this.state.wallet.address) : Promise.resolve([]),
-          bootstrapEnabled ? Promise.all(
-            [
-              DEFAULT_ALEPH_BOOTSTRAP_COMPACT_POST_TYPE,
-              DEFAULT_ALEPH_BOOTSTRAP_POST_TYPE
-            ].map(
-              (postType) => fetchAlephBootstrapPosts({
-                apiHost: this.client.apiHost,
-                postType,
-                fetch
-              }).catch(() => [])
-            )
-          ).then((pages) => pages.flat()) : Promise.resolve([])
+          bootstrapEnabled ? fetchAlephBootstrapPosts({
+            apiHost: this.client.apiHost,
+            fetch
+          }) : Promise.resolve([])
         ]);
         balance = nextBalance;
         instances = await Promise.all(
@@ -5225,7 +5256,9 @@ var SponsorRelayController = class {
         const activeInstanceHashes = new Set(
           instances.map((entry) => entry.instance.item_hash)
         );
-        bootstrapRegistrations = selectCurrentRelayBootstrapPosts(rawBootstrapPosts).filter(
+        bootstrapRegistrations = selectCurrentRelayBootstrapPosts(
+          rawBootstrapPosts
+        ).filter(
           (entry) => relayBootstrapMatchesCurrentWallet(
             entry,
             normalizedWalletAddress,
@@ -5248,7 +5281,9 @@ var SponsorRelayController = class {
               peerId: entry.content.peerId,
               registrationId: entry.content.registrationId,
               multiaddrs: Array.isArray(entry.content.multiaddrs) ? entry.content.multiaddrs : [],
-              browserMultiaddrs: Array.isArray(entry.content.browserMultiaddrs) ? entry.content.browserMultiaddrs : [],
+              browserMultiaddrs: Array.isArray(
+                entry.content.browserMultiaddrs
+              ) ? entry.content.browserMultiaddrs : [],
               ownerAddress: typeof entry.content.ownerAddress === "string" ? entry.content.ownerAddress : void 0,
               publisherAddress: typeof entry.content.publisherAddress === "string" ? entry.content.publisherAddress : void 0,
               updatedAt: entry.content.updatedAt
@@ -5369,7 +5404,9 @@ var SponsorRelayController = class {
         ...compatibleCrns2.filter((crn) => crn.hash !== preferredCrnHash)
       ].slice(0, 5);
       if (orderedCrns.length === 0) {
-        throw new Error("No compatible CRN is currently available for this tier.");
+        throw new Error(
+          "No compatible CRN is currently available for this tier."
+        );
       }
       const attemptErrors = [];
       let lastError = null;
@@ -5802,7 +5839,7 @@ var SponsorRelayController = class {
             await forgetAlephMessages({
               sender: this.state.wallet.address,
               hashes: [attemptItemHash],
-              reason: `Discard failed Sponsor Relay deployment attempt on ${attemptLabel}`,
+              reason: `Discard failed Relay Button deployment attempt on ${attemptLabel}`,
               signer: personalSign,
               hasher: sha256Hex,
               fetch: (url, init) => fetch(url, init).then(async (response) => ({
@@ -5912,7 +5949,7 @@ var SponsorRelayController = class {
       await forgetAlephMessages({
         sender: this.state.wallet.address,
         hashes: hashesToForget,
-        reason: linkedRegistrationCount > 0 ? `Deleted instance and ${linkedRegistrationCount} linked relay bootstrap registration${linkedRegistrationCount === 1 ? "" : "s"} from Sponsor Relay panel` : "Deleted from Sponsor Relay panel",
+        reason: linkedRegistrationCount > 0 ? `Deleted instance and ${linkedRegistrationCount} linked relay bootstrap registration${linkedRegistrationCount === 1 ? "" : "s"} from Relay Button panel` : "Deleted from Relay Button panel",
         signer: personalSign,
         hasher: sha256Hex,
         fetch: asJsonFetch,
@@ -5981,7 +6018,7 @@ var SponsorRelayController = class {
       await forgetAlephMessages({
         sender: this.state.wallet.address,
         hashes: [registrationHash],
-        reason: "Deleted orphan relay bootstrap registration from Sponsor Relay panel",
+        reason: "Deleted orphan relay bootstrap registration from Relay Button panel",
         signer: personalSign,
         hasher: sha256Hex,
         fetch: asJsonFetch,

package/svelte/SponsorRelayFab.svelte

@@ -51,7 +51,7 @@ export let apiHosts = undefined
   }
 
   function deploymentTitle() {
-    return deploymentProfile() === 'ucan-store' ? 'Sponsor Service' : 'Sponsor Relay'
+    return deploymentProfile() === 'ucan-store' ? 'Service Button' : 'Relay Button'
   }
 
   function deploymentInstanceFallbackLabel() {
@@ -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,

package/svelte/components/LauncherButton.svelte

@@ -5,7 +5,7 @@
 </script>
 
 <button class={`launcher ${mode} ${open ? 'open' : ''}`} type="button" on:click={onToggle}>
-  <span>Sponsor Relay</span>
+  <span>Relay Button</span>
 </button>
 
 <style>