@le-space/ui 0.2.0 → 0.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@le-space/ui",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Floating Aleph sponsor relay UI components for Svelte and React.",
   "license": "MIT",
   "type": "module",
@@ -36,8 +36,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@le-space/browser": "0.2.0",
-    "@le-space/core": "0.2.0",
+    "@le-space/browser": "0.3.0",
+    "@le-space/core": "0.3.0",
     "viem": "^2.38.5"
   },
   "peerDependencies": {

package/react/index.d.ts

@@ -174,7 +174,7 @@ interface RootfsResolution {
     gatewayError?: string | null;
 }
 
-type DeploymentProgressStage = "idle" | "validating" | "loading-manifest" | "verifying-rootfs" | "loading-pricing" | "loading-balance" | "selecting-crn" | "building-message" | "signing-message" | "broadcasting" | "notifying-crn" | "waiting-for-aleph" | "deployment-confirmed" | "deployment-rejected" | "building-delete-message" | "signing-delete-message" | "broadcasting-delete" | "delete-completed" | "refreshing-instances" | "completed" | "error";
+type DeploymentProgressStage = "idle" | "validating" | "loading-manifest" | "verifying-rootfs" | "loading-pricing" | "loading-balance" | "selecting-crn" | "building-message" | "signing-message" | "broadcasting" | "notifying-crn" | "waiting-for-aleph" | "deployment-confirmed" | "deployment-rejected" | "publishing-bootstrap" | "building-delete-message" | "signing-delete-message" | "broadcasting-delete" | "delete-completed" | "refreshing-instances" | "completed" | "error";
 interface DeploymentProgressEvent {
     stage: DeploymentProgressStage;
     label: string;
@@ -310,6 +310,7 @@ declare class SponsorRelayController {
     private trace;
     private patch;
     private emitProgress;
+    private configureRelayBootstrapRegistration;
     private syncLatestDeploymentProgress;
     private canSkipRuntimeRefresh;
     private noteRuntimeRefreshResult;

package/react/index.js

@@ -1832,6 +1832,28 @@ async function waitForVmRuntime(args) {
 }
 
 // ../core/src/guest.ts
+async function defaultHttpProbe(fetch2, url, timeoutMs = 1e4) {
+  try {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), timeoutMs);
+    const response = await fetch2(url, {
+      method: "GET",
+      redirect: "follow",
+      signal: controller.signal
+    });
+    clearTimeout(timeout);
+    return {
+      ok: response.ok,
+      status: response.status,
+      url: response.url
+    };
+  } catch (error) {
+    return {
+      ok: false,
+      error: error instanceof Error ? error.message : String(error)
+    };
+  }
+}
 async function notifyCrnAllocation2(args) {
   const normalizedCrnUrl = typeof args.crnUrl === "string" ? args.crnUrl.trim().replace(/\/+$/, "") : "";
   if (!normalizedCrnUrl) {
@@ -1912,6 +1934,324 @@ async function notifyCrnAllocationWithRetry(args) {
     reason: "CRN allocation notify was not confirmed."
   };
 }
+async function waitForSetupEndpoint(args) {
+  const attempts = Math.max(1, Number(args.attempts ?? 15));
+  const delayMs = Math.max(0, Number(args.delayMs ?? 4e3));
+  const sleep = args.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+  const url = `http://${args.hostIpv4}:${args.setupPort}/health`;
+  let result = await defaultHttpProbe(
+    args.fetch,
+    url,
+    Number(args.httpTimeoutMs ?? 1e4)
+  );
+  args.onAttempt?.(result, 1, attempts);
+  for (let attempt = 1; attempt < attempts; attempt += 1) {
+    if (result.ok) return result;
+    await sleep(delayMs);
+    result = await defaultHttpProbe(
+      args.fetch,
+      url,
+      Number(args.httpTimeoutMs ?? 1e4)
+    );
+    args.onAttempt?.(result, attempt + 1, attempts);
+  }
+  return result;
+}
+async function configureUcGoPeer(args) {
+  const controller = new AbortController();
+  const timeout = setTimeout(
+    () => controller.abort(),
+    Number(args.timeoutMs ?? 18e4)
+  );
+  const payload = {
+    public_ipv4: args.hostIpv4,
+    public_ipv6: args.publicIpv6 ?? void 0,
+    proxy_url: args.proxyUrl ?? void 0,
+    tcp_port: args.tcpPort ?? void 0,
+    ws_port: args.wsPort ?? void 0,
+    udp_port: args.udpPort ?? void 0,
+    quic_port: args.quicPort ?? void 0,
+    webrtc_port: args.webrtcPort ?? void 0
+  };
+  try {
+    const response = await args.fetch(
+      `http://${args.hostIpv4}:${args.setupPort}/configure`,
+      {
+        method: "POST",
+        headers: {
+          "content-type": "application/json"
+        },
+        body: JSON.stringify(payload),
+        signal: controller.signal
+      }
+    );
+    const responsePayload = await response.json().catch(() => null);
+    if (!response.ok) {
+      throw new Error(
+        `Relay setup request failed: ${response.status} ${typeof responsePayload === "string" ? responsePayload : JSON.stringify(responsePayload ?? {})}`
+      );
+    }
+    return responsePayload;
+  } finally {
+    clearTimeout(timeout);
+  }
+}
+async function configureOrbitdbRelaySetup2(args) {
+  const controller = new AbortController();
+  const timeout = setTimeout(
+    () => controller.abort(),
+    Number(args.timeoutMs ?? 18e4)
+  );
+  const payload = {
+    public_ipv4: args.hostIpv4,
+    public_ipv6: args.publicIpv6 ?? void 0,
+    tcp_port: args.tcpPort,
+    ws_port: args.wsPort,
+    proxy_url: args.proxyUrl ?? void 0,
+    metrics_port: args.metricsPort ?? void 0,
+    metrics_https_port: args.metricsHttpsPort ?? void 0,
+    webrtc_port: args.webrtcPort ?? void 0,
+    quic_port: args.quicPort ?? void 0
+  };
+  try {
+    const response = await args.fetch(
+      `http://${args.hostIpv4}:${args.setupPort}/configure`,
+      {
+        method: "POST",
+        headers: {
+          "content-type": "application/json"
+        },
+        body: JSON.stringify(payload),
+        signal: controller.signal
+      }
+    );
+    const responsePayload = await response.json().catch(() => null);
+    if (!response.ok) {
+      throw new Error(
+        `Relay setup request failed: ${response.status} ${typeof responsePayload === "string" ? responsePayload : JSON.stringify(responsePayload ?? {})}`
+      );
+    }
+    return responsePayload;
+  } finally {
+    clearTimeout(timeout);
+  }
+}
+async function fetchUcGoPeerMetadata(args) {
+  const attempts = Math.max(1, Number(args.attempts ?? 60));
+  const delayMs = Math.max(0, Number(args.delayMs ?? 3e3));
+  const sleep = args.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+  let lastPayload = null;
+  for (let attempt = 0; attempt < attempts; attempt += 1) {
+    const controller = new AbortController();
+    const timeout = setTimeout(
+      () => controller.abort(),
+      Number(args.timeoutMs ?? 18e4)
+    );
+    try {
+      const response = await args.fetch(
+        `http://${args.hostIpv4}:${args.setupPort}/metadata`,
+        {
+          signal: controller.signal
+        }
+      );
+      const payload = await response.json().catch(() => null);
+      lastPayload = payload;
+      args.onAttempt?.(
+        payload,
+        Boolean(
+          response.ok && payload && typeof payload === "object" && payload.status === "ready"
+        ),
+        attempt + 1,
+        attempts
+      );
+      if (response.ok && payload && typeof payload === "object" && payload.status === "ready") {
+        return payload;
+      }
+      if (response.status >= 500) {
+        throw new Error(
+          `Relay metadata request failed: ${response.status} ${typeof payload === "string" ? payload : JSON.stringify(payload ?? {})}`
+        );
+      }
+    } finally {
+      clearTimeout(timeout);
+    }
+    if (attempt < attempts - 1) {
+      await sleep(delayMs);
+    }
+  }
+  throw new Error(
+    `Relay metadata did not become ready after ${attempts} attempts: ${typeof lastPayload === "string" ? lastPayload : JSON.stringify(lastPayload ?? {})}`
+  );
+}
+
+// ../aleph-bootstrap/src/index.ts
+var DEFAULT_ALEPH_API_HOST3 = "https://api2.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_BOOTSTRAP_MAX_AGE_MS = 7 * 24 * 60 * 60 * 1e3;
+function normalizeHost(host) {
+  return host.trim().toLowerCase();
+}
+function splitMultiaddr(addr) {
+  return addr.split("/").filter(Boolean);
+}
+function isPrivateIpv4(ip) {
+  const parts = ip.split(".").map((part) => Number(part));
+  if (parts.length !== 4 || parts.some((part) => !Number.isInteger(part) || part < 0 || part > 255)) {
+    return false;
+  }
+  if (parts[0] === 10) return true;
+  if (parts[0] === 127) return true;
+  if (parts[0] === 0) return true;
+  if (parts[0] === 169 && parts[1] === 254) return true;
+  if (parts[0] === 172 && parts[1] >= 16 && parts[1] <= 31) return true;
+  if (parts[0] === 192 && parts[1] === 168) return true;
+  if (parts[0] === 100 && parts[1] >= 64 && parts[1] <= 127) return true;
+  return false;
+}
+function isPrivateIpv6(ip) {
+  const normalized = ip.trim().toLowerCase();
+  return normalized === "::1" || normalized.startsWith("fc") || normalized.startsWith("fd") || normalized.startsWith("fe8") || normalized.startsWith("fe9") || normalized.startsWith("fea") || normalized.startsWith("feb");
+}
+function isLocalHostname(host) {
+  const normalized = normalizeHost(host);
+  return normalized === "localhost" || normalized.endsWith(".localhost") || normalized.endsWith(".local");
+}
+function hasPeerId(addr) {
+  return splitMultiaddr(addr).includes("p2p");
+}
+function isBrowserDialableMultiaddr(addr) {
+  const normalized = addr.toLowerCase();
+  return normalized.includes("/ws") || normalized.includes("/wss") || normalized.includes("/webtransport") || normalized.includes("/webrtc-direct");
+}
+function dedupeMultiaddrs(addrs) {
+  const seen = /* @__PURE__ */ new Set();
+  const result = [];
+  for (const value of addrs) {
+    const trimmed = value.trim();
+    if (!trimmed || seen.has(trimmed)) continue;
+    seen.add(trimmed);
+    result.push(trimmed);
+  }
+  return result;
+}
+function isPublicMultiaddr(addr) {
+  const parts = splitMultiaddr(addr);
+  for (let index = 0; index < parts.length; index += 1) {
+    const protocol = parts[index];
+    const value = parts[index + 1];
+    if (protocol === "ip4" && value) {
+      return !isPrivateIpv4(value);
+    }
+    if (protocol === "ip6" && value) {
+      return !isPrivateIpv6(value);
+    }
+    if ((protocol === "dns4" || protocol === "dns6" || protocol === "dnsaddr") && value) {
+      return !isLocalHostname(value);
+    }
+  }
+  return false;
+}
+function filterPublicMultiaddrs(addrs, options = {}) {
+  return dedupeMultiaddrs(addrs).filter((addr) => {
+    if (!isPublicMultiaddr(addr)) return false;
+    if (options.requirePeerId !== false && !hasPeerId(addr)) return false;
+    if (options.browserDialableOnly && !isBrowserDialableMultiaddr(addr)) {
+      return false;
+    }
+    return true;
+  });
+}
+function buildRelayBootstrapPostContent(args) {
+  const now = args.now ?? Date.now() / 1e3;
+  const updatedAt = args.now ?? Date.now();
+  return {
+    type: args.postType ?? DEFAULT_ALEPH_BOOTSTRAP_POST_TYPE,
+    address: args.sender,
+    ...args.ref ? { ref: args.ref } : {},
+    content: {
+      peerId: args.peerId,
+      multiaddrs: filterPublicMultiaddrs(args.multiaddrs),
+      browserMultiaddrs: args.browserMultiaddrs ? filterPublicMultiaddrs(args.browserMultiaddrs, {
+        browserDialableOnly: true
+      }) : void 0,
+      profile: args.profile,
+      version: args.version,
+      updatedAt: Math.round(updatedAt)
+    },
+    time: now
+  };
+}
+async function createRelayBootstrapPost(args) {
+  const nowMillis = args.now ?? Date.now();
+  const nowSeconds = nowMillis / 1e3;
+  const itemContent = buildRelayBootstrapPostContent({
+    sender: args.sender,
+    peerId: args.peerId,
+    multiaddrs: args.multiaddrs,
+    browserMultiaddrs: args.browserMultiaddrs,
+    ref: args.ref ?? DEFAULT_ALEPH_BOOTSTRAP_REF,
+    postType: args.postType ?? DEFAULT_ALEPH_BOOTSTRAP_POST_TYPE,
+    profile: args.profile,
+    version: args.version,
+    now: nowMillis
+  });
+  itemContent.time = nowSeconds;
+  const serialized = JSON.stringify(itemContent);
+  const itemHash = await args.hasher(serialized);
+  return {
+    channel: args.channel ?? DEFAULT_ALEPH_BOOTSTRAP_CHANNEL,
+    sender: args.sender,
+    chain: "ETH",
+    type: "POST",
+    time: nowSeconds,
+    item_type: "inline",
+    item_content: serialized,
+    item_hash: itemHash
+  };
+}
+
+// ../core/src/bootstrap-registration.ts
+async function publishRelayBootstrapRegistration(args) {
+  const unsigned = await createRelayBootstrapPost({
+    sender: args.sender,
+    peerId: args.peerId,
+    multiaddrs: args.multiaddrs,
+    browserMultiaddrs: args.browserMultiaddrs,
+    channel: args.channel,
+    ref: args.ref,
+    postType: args.postType,
+    profile: args.profile,
+    version: args.version,
+    now: args.now,
+    hasher: args.hasher
+  });
+  const content = JSON.parse(unsigned.item_content);
+  if ((content.content?.multiaddrs?.length ?? 0) === 0) {
+    return {
+      status: "skipped",
+      reason: "No public relay multiaddrs remained after filtering.",
+      publishedMultiaddrs: [],
+      publishedBrowserMultiaddrs: content.content?.browserMultiaddrs ?? []
+    };
+  }
+  const message = await signAlephMessage(unsigned, args.signer);
+  const { response, httpStatus } = await broadcastAlephMessage2(message, {
+    apiHost: args.apiHost ?? DEFAULT_ALEPH_API_HOST3,
+    sync: args.sync ?? true,
+    fetch: args.fetch
+  });
+  return {
+    status: "published",
+    itemHash: unsigned.item_hash,
+    message,
+    response,
+    httpStatus,
+    publishedMultiaddrs: content.content?.multiaddrs ?? [],
+    publishedBrowserMultiaddrs: content.content?.browserMultiaddrs ?? []
+  };
+}
 
 // src/shared/events.ts
 function createDeploymentProgressEmitter() {
@@ -2070,6 +2410,13 @@ async function resolveManifest(args) {
   if (pasted) return pasted;
   return loadRootfsManifest(args.manifestUrl);
 }
+function relayProfileForManifest(manifest) {
+  if (manifest?.profile === "uc-go-peer") return "uc-go-peer";
+  if (manifest?.profile === "orbitdb-relay-pinner") {
+    return "orbitdb-relay-pinner";
+  }
+  return null;
+}
 async function inspectInstanceRuntime(args) {
   const details = {
     messageStatus: String(
@@ -2339,6 +2686,145 @@ var SponsorRelayController = class {
     });
     this.progressEmitter.emit(nextEvent);
   }
+  async configureRelayBootstrapRegistration(args) {
+    const profile = relayProfileForManifest(this.state.manifest);
+    if (!profile) return;
+    if (!this.state.wallet.address) {
+      throw new Error("A connected wallet is required to register relay bootstrap addresses.");
+    }
+    if (!args.runtime.hostIpv4) {
+      throw new Error("Relay runtime did not expose a host IPv4 address.");
+    }
+    const mappedPorts2 = args.runtime.mappedPorts ?? {};
+    const setupPort = mappedPorts2["80"]?.host ?? null;
+    if (!setupPort) {
+      throw new Error("Relay runtime did not expose the temporary setup endpoint.");
+    }
+    this.emitProgress({
+      stage: "deployment-confirmed",
+      label: "Configuring relay",
+      progress: 93,
+      status: "info",
+      itemHash: args.itemHash,
+      detail: "Waiting for the guest setup endpoint before collecting relay metadata."
+    });
+    const setupHealth = await waitForSetupEndpoint({
+      hostIpv4: args.runtime.hostIpv4,
+      setupPort,
+      fetch: (url, init) => fetch(url, init),
+      attempts: 15,
+      delayMs: 4e3,
+      httpTimeoutMs: 1e4
+    });
+    if (!setupHealth.ok) {
+      throw new Error(
+        `Relay setup endpoint did not become reachable at http://${args.runtime.hostIpv4}:${setupPort}/health.`
+      );
+    }
+    this.emitProgress({
+      stage: "deployment-confirmed",
+      label: "Applying relay networking",
+      progress: 94,
+      status: "info",
+      itemHash: args.itemHash,
+      detail: "Publishing the host port mapping into the guest relay configuration."
+    });
+    if (profile === "orbitdb-relay-pinner") {
+      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.");
+      }
+      await configureOrbitdbRelaySetup2({
+        hostIpv4: args.runtime.hostIpv4,
+        publicIpv6: args.runtime.ipv6,
+        setupPort,
+        tcpPort,
+        wsPort,
+        proxyUrl: args.runtime.proxyUrl ?? void 0,
+        metricsPort: mappedPorts2["9090"]?.host ?? null,
+        metricsHttpsPort: mappedPorts2["443"]?.host ?? null,
+        webrtcPort: mappedPorts2["9093"]?.host ?? null,
+        quicPort: mappedPorts2["9094"]?.host ?? null,
+        fetch: (url, init) => fetch(url, init),
+        timeoutMs: 18e4
+      });
+    } else {
+      await configureUcGoPeer({
+        hostIpv4: args.runtime.hostIpv4,
+        publicIpv6: args.runtime.ipv6,
+        setupPort,
+        tcpPort: mappedPorts2["9095"]?.host ?? null,
+        wsPort: mappedPorts2["9097"]?.host ?? mappedPorts2["9095"]?.host ?? null,
+        udpPort: mappedPorts2["9095"]?.udp === true ? mappedPorts2["9095"]?.host ?? null : null,
+        quicPort: mappedPorts2["9095"]?.udp === true ? mappedPorts2["9095"]?.host ?? null : null,
+        webrtcPort: mappedPorts2["9095"]?.udp === true ? mappedPorts2["9095"]?.host ?? null : null,
+        proxyUrl: args.runtime.proxyUrl ?? void 0,
+        fetch: (url, init) => fetch(url, init),
+        timeoutMs: 18e4
+      });
+    }
+    this.emitProgress({
+      stage: "publishing-bootstrap",
+      label: "Reading relay multiaddrs",
+      progress: 95,
+      status: "info",
+      itemHash: args.itemHash,
+      detail: "Waiting for the relay to report its final public multiaddrs."
+    });
+    const metadataResult = await fetchUcGoPeerMetadata({
+      hostIpv4: args.runtime.hostIpv4,
+      setupPort,
+      fetch: (url, init) => fetch(url, init),
+      attempts: 80,
+      delayMs: 3e3,
+      timeoutMs: 24e4
+    });
+    const metadata = metadataResult && typeof metadataResult === "object" && metadataResult.metadata && typeof metadataResult.metadata === "object" ? metadataResult.metadata : null;
+    const peerId = typeof metadata?.peer_id === "string" ? metadata.peer_id : null;
+    const probeMultiaddrs = Array.isArray(metadata?.probe_multiaddrs) ? metadata.probe_multiaddrs.filter(
+      (entry) => typeof entry === "string"
+    ) : [];
+    const browserBootstrapMultiaddrs = Array.isArray(
+      metadata?.browser_bootstrap_multiaddrs
+    ) ? metadata.browser_bootstrap_multiaddrs.filter(
+      (entry) => typeof entry === "string"
+    ) : [];
+    if (!peerId || probeMultiaddrs.length === 0) {
+      throw new Error("Relay metadata did not include a peer ID and public multiaddrs.");
+    }
+    this.emitProgress({
+      stage: "publishing-bootstrap",
+      label: "Publishing bootstrap registration",
+      progress: 96,
+      status: "info",
+      itemHash: args.itemHash,
+      detail: "Writing the relay bootstrap registration to Aleph."
+    });
+    const publication = await publishRelayBootstrapRegistration({
+      sender: this.state.wallet.address,
+      signer: personalSign,
+      hasher: sha256Hex,
+      fetch: (url, init) => fetch(url, init).then(async (response) => ({
+        ok: response.ok,
+        status: response.status,
+        json: async () => await response.json()
+      })),
+      apiHost: this.client.apiHost,
+      peerId,
+      multiaddrs: probeMultiaddrs,
+      browserMultiaddrs: browserBootstrapMultiaddrs,
+      profile,
+      version: this.state.manifest?.version,
+      sync: true
+    });
+    this.trace("deploy:bootstrap-registration", {
+      itemHash: args.itemHash,
+      peerId,
+      metadata,
+      publication
+    });
+  }
   syncLatestDeploymentProgress(instances) {
     const itemHash = this.state.lastDeploymentHash;
     if (!itemHash) {
@@ -2947,6 +3433,10 @@ var SponsorRelayController = class {
         execution: runtime.execution ?? null,
         error: null
       });
+      await this.configureRelayBootstrapRegistration({
+        itemHash: result.itemHash,
+        runtime
+      });
       this.patch({
         busy: { deploying: false }
       });

package/shared/index.d.ts

@@ -172,7 +172,7 @@ interface RootfsResolution {
     gatewayError?: string | null;
 }
 
-type DeploymentProgressStage = "idle" | "validating" | "loading-manifest" | "verifying-rootfs" | "loading-pricing" | "loading-balance" | "selecting-crn" | "building-message" | "signing-message" | "broadcasting" | "notifying-crn" | "waiting-for-aleph" | "deployment-confirmed" | "deployment-rejected" | "building-delete-message" | "signing-delete-message" | "broadcasting-delete" | "delete-completed" | "refreshing-instances" | "completed" | "error";
+type DeploymentProgressStage = "idle" | "validating" | "loading-manifest" | "verifying-rootfs" | "loading-pricing" | "loading-balance" | "selecting-crn" | "building-message" | "signing-message" | "broadcasting" | "notifying-crn" | "waiting-for-aleph" | "deployment-confirmed" | "deployment-rejected" | "publishing-bootstrap" | "building-delete-message" | "signing-delete-message" | "broadcasting-delete" | "delete-completed" | "refreshing-instances" | "completed" | "error";
 interface DeploymentProgressEvent {
     stage: DeploymentProgressStage;
     label: string;
@@ -356,6 +356,7 @@ declare class SponsorRelayController {
     private trace;
     private patch;
     private emitProgress;
+    private configureRelayBootstrapRegistration;
     private syncLatestDeploymentProgress;
     private canSkipRuntimeRefresh;
     private noteRuntimeRefreshResult;

package/shared/index.js

@@ -1831,6 +1831,28 @@ async function waitForVmRuntime(args) {
 }
 
 // ../core/src/guest.ts
+async function defaultHttpProbe(fetch2, url, timeoutMs = 1e4) {
+  try {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), timeoutMs);
+    const response = await fetch2(url, {
+      method: "GET",
+      redirect: "follow",
+      signal: controller.signal
+    });
+    clearTimeout(timeout);
+    return {
+      ok: response.ok,
+      status: response.status,
+      url: response.url
+    };
+  } catch (error) {
+    return {
+      ok: false,
+      error: error instanceof Error ? error.message : String(error)
+    };
+  }
+}
 async function notifyCrnAllocation2(args) {
   const normalizedCrnUrl = typeof args.crnUrl === "string" ? args.crnUrl.trim().replace(/\/+$/, "") : "";
   if (!normalizedCrnUrl) {
@@ -1911,6 +1933,324 @@ async function notifyCrnAllocationWithRetry(args) {
     reason: "CRN allocation notify was not confirmed."
   };
 }
+async function waitForSetupEndpoint(args) {
+  const attempts = Math.max(1, Number(args.attempts ?? 15));
+  const delayMs = Math.max(0, Number(args.delayMs ?? 4e3));
+  const sleep = args.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+  const url = `http://${args.hostIpv4}:${args.setupPort}/health`;
+  let result = await defaultHttpProbe(
+    args.fetch,
+    url,
+    Number(args.httpTimeoutMs ?? 1e4)
+  );
+  args.onAttempt?.(result, 1, attempts);
+  for (let attempt = 1; attempt < attempts; attempt += 1) {
+    if (result.ok) return result;
+    await sleep(delayMs);
+    result = await defaultHttpProbe(
+      args.fetch,
+      url,
+      Number(args.httpTimeoutMs ?? 1e4)
+    );
+    args.onAttempt?.(result, attempt + 1, attempts);
+  }
+  return result;
+}
+async function configureUcGoPeer(args) {
+  const controller = new AbortController();
+  const timeout = setTimeout(
+    () => controller.abort(),
+    Number(args.timeoutMs ?? 18e4)
+  );
+  const payload = {
+    public_ipv4: args.hostIpv4,
+    public_ipv6: args.publicIpv6 ?? void 0,
+    proxy_url: args.proxyUrl ?? void 0,
+    tcp_port: args.tcpPort ?? void 0,
+    ws_port: args.wsPort ?? void 0,
+    udp_port: args.udpPort ?? void 0,
+    quic_port: args.quicPort ?? void 0,
+    webrtc_port: args.webrtcPort ?? void 0
+  };
+  try {
+    const response = await args.fetch(
+      `http://${args.hostIpv4}:${args.setupPort}/configure`,
+      {
+        method: "POST",
+        headers: {
+          "content-type": "application/json"
+        },
+        body: JSON.stringify(payload),
+        signal: controller.signal
+      }
+    );
+    const responsePayload = await response.json().catch(() => null);
+    if (!response.ok) {
+      throw new Error(
+        `Relay setup request failed: ${response.status} ${typeof responsePayload === "string" ? responsePayload : JSON.stringify(responsePayload ?? {})}`
+      );
+    }
+    return responsePayload;
+  } finally {
+    clearTimeout(timeout);
+  }
+}
+async function configureOrbitdbRelaySetup2(args) {
+  const controller = new AbortController();
+  const timeout = setTimeout(
+    () => controller.abort(),
+    Number(args.timeoutMs ?? 18e4)
+  );
+  const payload = {
+    public_ipv4: args.hostIpv4,
+    public_ipv6: args.publicIpv6 ?? void 0,
+    tcp_port: args.tcpPort,
+    ws_port: args.wsPort,
+    proxy_url: args.proxyUrl ?? void 0,
+    metrics_port: args.metricsPort ?? void 0,
+    metrics_https_port: args.metricsHttpsPort ?? void 0,
+    webrtc_port: args.webrtcPort ?? void 0,
+    quic_port: args.quicPort ?? void 0
+  };
+  try {
+    const response = await args.fetch(
+      `http://${args.hostIpv4}:${args.setupPort}/configure`,
+      {
+        method: "POST",
+        headers: {
+          "content-type": "application/json"
+        },
+        body: JSON.stringify(payload),
+        signal: controller.signal
+      }
+    );
+    const responsePayload = await response.json().catch(() => null);
+    if (!response.ok) {
+      throw new Error(
+        `Relay setup request failed: ${response.status} ${typeof responsePayload === "string" ? responsePayload : JSON.stringify(responsePayload ?? {})}`
+      );
+    }
+    return responsePayload;
+  } finally {
+    clearTimeout(timeout);
+  }
+}
+async function fetchUcGoPeerMetadata(args) {
+  const attempts = Math.max(1, Number(args.attempts ?? 60));
+  const delayMs = Math.max(0, Number(args.delayMs ?? 3e3));
+  const sleep = args.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+  let lastPayload = null;
+  for (let attempt = 0; attempt < attempts; attempt += 1) {
+    const controller = new AbortController();
+    const timeout = setTimeout(
+      () => controller.abort(),
+      Number(args.timeoutMs ?? 18e4)
+    );
+    try {
+      const response = await args.fetch(
+        `http://${args.hostIpv4}:${args.setupPort}/metadata`,
+        {
+          signal: controller.signal
+        }
+      );
+      const payload = await response.json().catch(() => null);
+      lastPayload = payload;
+      args.onAttempt?.(
+        payload,
+        Boolean(
+          response.ok && payload && typeof payload === "object" && payload.status === "ready"
+        ),
+        attempt + 1,
+        attempts
+      );
+      if (response.ok && payload && typeof payload === "object" && payload.status === "ready") {
+        return payload;
+      }
+      if (response.status >= 500) {
+        throw new Error(
+          `Relay metadata request failed: ${response.status} ${typeof payload === "string" ? payload : JSON.stringify(payload ?? {})}`
+        );
+      }
+    } finally {
+      clearTimeout(timeout);
+    }
+    if (attempt < attempts - 1) {
+      await sleep(delayMs);
+    }
+  }
+  throw new Error(
+    `Relay metadata did not become ready after ${attempts} attempts: ${typeof lastPayload === "string" ? lastPayload : JSON.stringify(lastPayload ?? {})}`
+  );
+}
+
+// ../aleph-bootstrap/src/index.ts
+var DEFAULT_ALEPH_API_HOST3 = "https://api2.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_BOOTSTRAP_MAX_AGE_MS = 7 * 24 * 60 * 60 * 1e3;
+function normalizeHost(host) {
+  return host.trim().toLowerCase();
+}
+function splitMultiaddr(addr) {
+  return addr.split("/").filter(Boolean);
+}
+function isPrivateIpv4(ip) {
+  const parts = ip.split(".").map((part) => Number(part));
+  if (parts.length !== 4 || parts.some((part) => !Number.isInteger(part) || part < 0 || part > 255)) {
+    return false;
+  }
+  if (parts[0] === 10) return true;
+  if (parts[0] === 127) return true;
+  if (parts[0] === 0) return true;
+  if (parts[0] === 169 && parts[1] === 254) return true;
+  if (parts[0] === 172 && parts[1] >= 16 && parts[1] <= 31) return true;
+  if (parts[0] === 192 && parts[1] === 168) return true;
+  if (parts[0] === 100 && parts[1] >= 64 && parts[1] <= 127) return true;
+  return false;
+}
+function isPrivateIpv6(ip) {
+  const normalized = ip.trim().toLowerCase();
+  return normalized === "::1" || normalized.startsWith("fc") || normalized.startsWith("fd") || normalized.startsWith("fe8") || normalized.startsWith("fe9") || normalized.startsWith("fea") || normalized.startsWith("feb");
+}
+function isLocalHostname(host) {
+  const normalized = normalizeHost(host);
+  return normalized === "localhost" || normalized.endsWith(".localhost") || normalized.endsWith(".local");
+}
+function hasPeerId(addr) {
+  return splitMultiaddr(addr).includes("p2p");
+}
+function isBrowserDialableMultiaddr(addr) {
+  const normalized = addr.toLowerCase();
+  return normalized.includes("/ws") || normalized.includes("/wss") || normalized.includes("/webtransport") || normalized.includes("/webrtc-direct");
+}
+function dedupeMultiaddrs(addrs) {
+  const seen = /* @__PURE__ */ new Set();
+  const result = [];
+  for (const value of addrs) {
+    const trimmed = value.trim();
+    if (!trimmed || seen.has(trimmed)) continue;
+    seen.add(trimmed);
+    result.push(trimmed);
+  }
+  return result;
+}
+function isPublicMultiaddr(addr) {
+  const parts = splitMultiaddr(addr);
+  for (let index = 0; index < parts.length; index += 1) {
+    const protocol = parts[index];
+    const value = parts[index + 1];
+    if (protocol === "ip4" && value) {
+      return !isPrivateIpv4(value);
+    }
+    if (protocol === "ip6" && value) {
+      return !isPrivateIpv6(value);
+    }
+    if ((protocol === "dns4" || protocol === "dns6" || protocol === "dnsaddr") && value) {
+      return !isLocalHostname(value);
+    }
+  }
+  return false;
+}
+function filterPublicMultiaddrs(addrs, options = {}) {
+  return dedupeMultiaddrs(addrs).filter((addr) => {
+    if (!isPublicMultiaddr(addr)) return false;
+    if (options.requirePeerId !== false && !hasPeerId(addr)) return false;
+    if (options.browserDialableOnly && !isBrowserDialableMultiaddr(addr)) {
+      return false;
+    }
+    return true;
+  });
+}
+function buildRelayBootstrapPostContent(args) {
+  const now = args.now ?? Date.now() / 1e3;
+  const updatedAt = args.now ?? Date.now();
+  return {
+    type: args.postType ?? DEFAULT_ALEPH_BOOTSTRAP_POST_TYPE,
+    address: args.sender,
+    ...args.ref ? { ref: args.ref } : {},
+    content: {
+      peerId: args.peerId,
+      multiaddrs: filterPublicMultiaddrs(args.multiaddrs),
+      browserMultiaddrs: args.browserMultiaddrs ? filterPublicMultiaddrs(args.browserMultiaddrs, {
+        browserDialableOnly: true
+      }) : void 0,
+      profile: args.profile,
+      version: args.version,
+      updatedAt: Math.round(updatedAt)
+    },
+    time: now
+  };
+}
+async function createRelayBootstrapPost(args) {
+  const nowMillis = args.now ?? Date.now();
+  const nowSeconds = nowMillis / 1e3;
+  const itemContent = buildRelayBootstrapPostContent({
+    sender: args.sender,
+    peerId: args.peerId,
+    multiaddrs: args.multiaddrs,
+    browserMultiaddrs: args.browserMultiaddrs,
+    ref: args.ref ?? DEFAULT_ALEPH_BOOTSTRAP_REF,
+    postType: args.postType ?? DEFAULT_ALEPH_BOOTSTRAP_POST_TYPE,
+    profile: args.profile,
+    version: args.version,
+    now: nowMillis
+  });
+  itemContent.time = nowSeconds;
+  const serialized = JSON.stringify(itemContent);
+  const itemHash = await args.hasher(serialized);
+  return {
+    channel: args.channel ?? DEFAULT_ALEPH_BOOTSTRAP_CHANNEL,
+    sender: args.sender,
+    chain: "ETH",
+    type: "POST",
+    time: nowSeconds,
+    item_type: "inline",
+    item_content: serialized,
+    item_hash: itemHash
+  };
+}
+
+// ../core/src/bootstrap-registration.ts
+async function publishRelayBootstrapRegistration(args) {
+  const unsigned = await createRelayBootstrapPost({
+    sender: args.sender,
+    peerId: args.peerId,
+    multiaddrs: args.multiaddrs,
+    browserMultiaddrs: args.browserMultiaddrs,
+    channel: args.channel,
+    ref: args.ref,
+    postType: args.postType,
+    profile: args.profile,
+    version: args.version,
+    now: args.now,
+    hasher: args.hasher
+  });
+  const content = JSON.parse(unsigned.item_content);
+  if ((content.content?.multiaddrs?.length ?? 0) === 0) {
+    return {
+      status: "skipped",
+      reason: "No public relay multiaddrs remained after filtering.",
+      publishedMultiaddrs: [],
+      publishedBrowserMultiaddrs: content.content?.browserMultiaddrs ?? []
+    };
+  }
+  const message = await signAlephMessage(unsigned, args.signer);
+  const { response, httpStatus } = await broadcastAlephMessage2(message, {
+    apiHost: args.apiHost ?? DEFAULT_ALEPH_API_HOST3,
+    sync: args.sync ?? true,
+    fetch: args.fetch
+  });
+  return {
+    status: "published",
+    itemHash: unsigned.item_hash,
+    message,
+    response,
+    httpStatus,
+    publishedMultiaddrs: content.content?.multiaddrs ?? [],
+    publishedBrowserMultiaddrs: content.content?.browserMultiaddrs ?? []
+  };
+}
 
 // src/shared/events.ts
 function createDeploymentProgressEmitter() {
@@ -2069,6 +2409,13 @@ async function resolveManifest(args) {
   if (pasted) return pasted;
   return loadRootfsManifest(args.manifestUrl);
 }
+function relayProfileForManifest(manifest) {
+  if (manifest?.profile === "uc-go-peer") return "uc-go-peer";
+  if (manifest?.profile === "orbitdb-relay-pinner") {
+    return "orbitdb-relay-pinner";
+  }
+  return null;
+}
 async function inspectInstanceRuntime(args) {
   const details = {
     messageStatus: String(
@@ -2338,6 +2685,145 @@ var SponsorRelayController = class {
     });
     this.progressEmitter.emit(nextEvent);
   }
+  async configureRelayBootstrapRegistration(args) {
+    const profile = relayProfileForManifest(this.state.manifest);
+    if (!profile) return;
+    if (!this.state.wallet.address) {
+      throw new Error("A connected wallet is required to register relay bootstrap addresses.");
+    }
+    if (!args.runtime.hostIpv4) {
+      throw new Error("Relay runtime did not expose a host IPv4 address.");
+    }
+    const mappedPorts2 = args.runtime.mappedPorts ?? {};
+    const setupPort = mappedPorts2["80"]?.host ?? null;
+    if (!setupPort) {
+      throw new Error("Relay runtime did not expose the temporary setup endpoint.");
+    }
+    this.emitProgress({
+      stage: "deployment-confirmed",
+      label: "Configuring relay",
+      progress: 93,
+      status: "info",
+      itemHash: args.itemHash,
+      detail: "Waiting for the guest setup endpoint before collecting relay metadata."
+    });
+    const setupHealth = await waitForSetupEndpoint({
+      hostIpv4: args.runtime.hostIpv4,
+      setupPort,
+      fetch: (url, init) => fetch(url, init),
+      attempts: 15,
+      delayMs: 4e3,
+      httpTimeoutMs: 1e4
+    });
+    if (!setupHealth.ok) {
+      throw new Error(
+        `Relay setup endpoint did not become reachable at http://${args.runtime.hostIpv4}:${setupPort}/health.`
+      );
+    }
+    this.emitProgress({
+      stage: "deployment-confirmed",
+      label: "Applying relay networking",
+      progress: 94,
+      status: "info",
+      itemHash: args.itemHash,
+      detail: "Publishing the host port mapping into the guest relay configuration."
+    });
+    if (profile === "orbitdb-relay-pinner") {
+      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.");
+      }
+      await configureOrbitdbRelaySetup2({
+        hostIpv4: args.runtime.hostIpv4,
+        publicIpv6: args.runtime.ipv6,
+        setupPort,
+        tcpPort,
+        wsPort,
+        proxyUrl: args.runtime.proxyUrl ?? void 0,
+        metricsPort: mappedPorts2["9090"]?.host ?? null,
+        metricsHttpsPort: mappedPorts2["443"]?.host ?? null,
+        webrtcPort: mappedPorts2["9093"]?.host ?? null,
+        quicPort: mappedPorts2["9094"]?.host ?? null,
+        fetch: (url, init) => fetch(url, init),
+        timeoutMs: 18e4
+      });
+    } else {
+      await configureUcGoPeer({
+        hostIpv4: args.runtime.hostIpv4,
+        publicIpv6: args.runtime.ipv6,
+        setupPort,
+        tcpPort: mappedPorts2["9095"]?.host ?? null,
+        wsPort: mappedPorts2["9097"]?.host ?? mappedPorts2["9095"]?.host ?? null,
+        udpPort: mappedPorts2["9095"]?.udp === true ? mappedPorts2["9095"]?.host ?? null : null,
+        quicPort: mappedPorts2["9095"]?.udp === true ? mappedPorts2["9095"]?.host ?? null : null,
+        webrtcPort: mappedPorts2["9095"]?.udp === true ? mappedPorts2["9095"]?.host ?? null : null,
+        proxyUrl: args.runtime.proxyUrl ?? void 0,
+        fetch: (url, init) => fetch(url, init),
+        timeoutMs: 18e4
+      });
+    }
+    this.emitProgress({
+      stage: "publishing-bootstrap",
+      label: "Reading relay multiaddrs",
+      progress: 95,
+      status: "info",
+      itemHash: args.itemHash,
+      detail: "Waiting for the relay to report its final public multiaddrs."
+    });
+    const metadataResult = await fetchUcGoPeerMetadata({
+      hostIpv4: args.runtime.hostIpv4,
+      setupPort,
+      fetch: (url, init) => fetch(url, init),
+      attempts: 80,
+      delayMs: 3e3,
+      timeoutMs: 24e4
+    });
+    const metadata = metadataResult && typeof metadataResult === "object" && metadataResult.metadata && typeof metadataResult.metadata === "object" ? metadataResult.metadata : null;
+    const peerId = typeof metadata?.peer_id === "string" ? metadata.peer_id : null;
+    const probeMultiaddrs = Array.isArray(metadata?.probe_multiaddrs) ? metadata.probe_multiaddrs.filter(
+      (entry) => typeof entry === "string"
+    ) : [];
+    const browserBootstrapMultiaddrs = Array.isArray(
+      metadata?.browser_bootstrap_multiaddrs
+    ) ? metadata.browser_bootstrap_multiaddrs.filter(
+      (entry) => typeof entry === "string"
+    ) : [];
+    if (!peerId || probeMultiaddrs.length === 0) {
+      throw new Error("Relay metadata did not include a peer ID and public multiaddrs.");
+    }
+    this.emitProgress({
+      stage: "publishing-bootstrap",
+      label: "Publishing bootstrap registration",
+      progress: 96,
+      status: "info",
+      itemHash: args.itemHash,
+      detail: "Writing the relay bootstrap registration to Aleph."
+    });
+    const publication = await publishRelayBootstrapRegistration({
+      sender: this.state.wallet.address,
+      signer: personalSign,
+      hasher: sha256Hex,
+      fetch: (url, init) => fetch(url, init).then(async (response) => ({
+        ok: response.ok,
+        status: response.status,
+        json: async () => await response.json()
+      })),
+      apiHost: this.client.apiHost,
+      peerId,
+      multiaddrs: probeMultiaddrs,
+      browserMultiaddrs: browserBootstrapMultiaddrs,
+      profile,
+      version: this.state.manifest?.version,
+      sync: true
+    });
+    this.trace("deploy:bootstrap-registration", {
+      itemHash: args.itemHash,
+      peerId,
+      metadata,
+      publication
+    });
+  }
   syncLatestDeploymentProgress(instances) {
     const itemHash = this.state.lastDeploymentHash;
     if (!itemHash) {
@@ -2946,6 +3432,10 @@ var SponsorRelayController = class {
         execution: runtime.execution ?? null,
         error: null
       });
+      await this.configureRelayBootstrapRegistration({
+        itemHash: result.itemHash,
+        runtime
+      });
       this.patch({
         busy: { deploying: false }
       });