@umbra-privacy/ceremony 0.2.3 → 0.2.6

package/dist/index.js

@@ -4,7 +4,7 @@
 import { render } from "ink";
 
 // src/components/App.tsx
-import { useEffect as useEffect4, useState as useState4 } from "react";
+import { useEffect as useEffect5, useState as useState5 } from "react";
 import { Box as Box7, Text as Text7, useApp, useInput as useInput2 } from "ink";
 
 // src/cleanup.ts
@@ -90,26 +90,20 @@ var api = {
   },
   // Slot polling
   myTurn(ceremonyId2, trackId, token) {
-    return request(
-      `/api/ceremonies/${ceremonyId2}/tracks/${trackId}/my-turn`,
-      { headers: bearer(token) }
-    );
+    return request(`/api/ceremonies/${ceremonyId2}/tracks/${trackId}/my-turn`, {
+      headers: bearer(token)
+    });
   },
   // Contribution
   signalUploaded(ceremonyId2, trackId, contributionId, token) {
-    return request(
-      `/api/ceremonies/${ceremonyId2}/tracks/${trackId}/signal-uploaded`,
-      {
-        method: "POST",
-        headers: bearer(token),
-        body: JSON.stringify({ contribution_id: contributionId })
-      }
-    );
+    return request(`/api/ceremonies/${ceremonyId2}/tracks/${trackId}/signal-uploaded`, {
+      method: "POST",
+      headers: bearer(token),
+      body: JSON.stringify({ contribution_id: contributionId })
+    });
   },
   getReceipt(ceremonyId2, contributionId) {
-    return request(
-      `/api/ceremonies/${ceremonyId2}/contributions/${contributionId}/receipt`
-    );
+    return request(`/api/ceremonies/${ceremonyId2}/contributions/${contributionId}/receipt`);
   },
   // Admin — signed-request flow. Caller supplies the 64-byte Solana keypair
   // bytes (32 secret + 32 public). The helper fetches a one-time challenge,
@@ -252,6 +246,38 @@ async function recordContribution(trackId, contribution) {
 
 // src/components/Header.tsx
 import { Box, Text } from "ink";
+
+// src/labels.ts
+function ceremonyStatusLabel(status) {
+  switch (status) {
+    case "open":
+      return "open";
+    case "initialized":
+      return "not yet open";
+    case "finalizing":
+      return "closing";
+    case "completed":
+      return "complete";
+    default:
+      return status;
+  }
+}
+function trackStatusLabel(status) {
+  switch (status) {
+    case "open":
+      return "open";
+    case "initializing":
+      return "preparing";
+    case "awaiting_beacon":
+      return "awaiting beacon";
+    case "finalized":
+      return "complete";
+    default:
+      return status;
+  }
+}
+
+// src/components/Header.tsx
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 var STATUS_COLOR = {
   open: "green",
@@ -264,10 +290,10 @@ function Header({ ceremony, subtitle }) {
     /* @__PURE__ */ jsxs(Box, { children: [
       /* @__PURE__ */ jsx(Text, { bold: true, color: "cyan", children: "\u25C6 Umbra Ceremony TUI" }),
       ceremony && /* @__PURE__ */ jsxs(Fragment, { children: [
-        /* @__PURE__ */ jsx(Text, { dimColor: true, children: "  \xB7  " }),
+        /* @__PURE__ */ jsx(Text, { dimColor: true, children: " \xB7 " }),
         /* @__PURE__ */ jsx(Text, { bold: true, children: ceremony.name }),
-        /* @__PURE__ */ jsx(Text, { dimColor: true, children: "  [" }),
-        /* @__PURE__ */ jsx(Text, { color: STATUS_COLOR[ceremony.status] ?? "white", children: ceremony.status }),
+        /* @__PURE__ */ jsx(Text, { dimColor: true, children: " [" }),
+        /* @__PURE__ */ jsx(Text, { color: STATUS_COLOR[ceremony.status] ?? "white", children: ceremonyStatusLabel(ceremony.status) }),
         /* @__PURE__ */ jsx(Text, { dimColor: true, children: "]" })
       ] })
     ] }),
@@ -289,22 +315,61 @@ function Header({ ceremony, subtitle }) {
 }
 
 // src/components/QueueView.tsx
-import { useEffect, useRef, useState } from "react";
+import { useEffect as useEffect2, useRef, useState as useState2 } from "react";
 import { Box as Box2, Text as Text2 } from "ink";
 import Spinner from "ink-spinner";
-import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
+
+// src/hooks/useCyclingMessage.ts
+import { useEffect, useState } from "react";
+function useCyclingMessage(messages, intervalMs = 2500, active = true) {
+  const [idx, setIdx] = useState(0);
+  useEffect(() => {
+    if (!active || messages.length <= 1) return;
+    const t = setInterval(() => setIdx((i) => (i + 1) % messages.length), intervalMs);
+    return () => clearInterval(t);
+  }, [active, intervalMs, messages.length]);
+  return messages[idx] ?? messages[0] ?? "";
+}
+var COMPUTING_MESSAGES = [
+  "summoning fresh entropy",
+  "shuffling response bytes",
+  "tickling bn128 pairings",
+  "applying tau locally",
+  "folding contribution proof",
+  "blinding the trapdoor",
+  "sealing the bellman response"
+];
+var VERIFYING_MESSAGES = [
+  "worker pulling your response from S3",
+  "importing bellman contribution into a new zkey",
+  "checking the contribution's pairing proof",
+  "writing the next zkey",
+  "uploading the new zkey",
+  "anchoring contribution hash in the audit chain",
+  "almost there \u2014 finalising your receipt"
+];
+var EXPORTING_MESSAGES = [
+  "preparing your challenge file",
+  "extracting bellman params from the current zkey",
+  "wrapping the zkey for handoff",
+  "stamping a sha256 over the challenge bundle",
+  "presigning your download URL"
+];
+
+// src/components/QueueView.tsx
+import { Fragment as Fragment2, jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
 var POLL_FAST_MS = 5e3;
 var POLL_SLOW_MS = 15e3;
 function QueueView({ ceremonyId: ceremonyId2, trackId, token, onReady, onError }) {
-  const [status, setStatus] = useState(null);
-  const [pollErr, setPollErr] = useState(null);
-  const [tick, setTick] = useState(0);
+  const [status, setStatus] = useState2(null);
+  const [pollErr, setPollErr] = useState2(null);
+  const [tick, setTick] = useState2(0);
   const timeoutRef = useRef(null);
-  useEffect(() => {
+  useEffect2(() => {
     const id = setInterval(() => setTick((t) => (t + 1) % 4), 500);
     return () => clearInterval(id);
   }, []);
-  useEffect(() => {
+  useEffect2(() => {
     let cancelled = false;
     async function poll() {
       try {
@@ -342,7 +407,10 @@ function QueueView({ ceremonyId: ceremonyId2, trackId, token, onReady, onError }
     ] });
   }
   const waitMins = Math.ceil((status.estimated_wait_secs ?? 0) / 60);
-  const expiresAt = status.slot_expires_at ? new Date(status.slot_expires_at).toLocaleTimeString([], { hour: "2-digit", minute: "2-digit" }) : null;
+  const expiresAt = status.slot_expires_at ? new Date(status.slot_expires_at).toLocaleTimeString([], {
+    hour: "2-digit",
+    minute: "2-digit"
+  }) : null;
   const fastPoll = status.queue_position <= 2;
   return /* @__PURE__ */ jsxs2(Box2, { flexDirection: "column", gap: 1, children: [
     /* @__PURE__ */ jsxs2(Box2, { gap: 2, children: [
@@ -366,17 +434,13 @@ function QueueView({ ceremonyId: ceremonyId2, trackId, token, onReady, onError }
         ] })
       ] })
     ] }),
-    status.status === "exporting" || status.status === "your_turn" || status.status === "ready_to_download" ? /* @__PURE__ */ jsx2(Box2, { flexDirection: "column", children: /* @__PURE__ */ jsx2(Text2, { color: "green", children: status.status === "exporting" ? "Preparing your challenge file \u2014 hang tight..." : "Challenge ready \u2014 loading contribution flow..." }) }) : status.active_since ? /* @__PURE__ */ jsx2(Box2, { flexDirection: "column", children: /* @__PURE__ */ jsxs2(Text2, { dimColor: true, children: [
+    status.status === "exporting" || status.status === "your_turn" || status.status === "ready_to_download" ? /* @__PURE__ */ jsx2(ExportingMessage, { status: status.status }) : status.active_since ? /* @__PURE__ */ jsx2(Box2, { flexDirection: "column", children: /* @__PURE__ */ jsxs2(Text2, { dimColor: true, children: [
       "Another contributor is active",
       expiresAt ? ` \xB7 slot expires at ${expiresAt}` : ""
     ] }) }) : status.queue_position > 1 ? (
       // Slot is idle but people are ahead — they joined and left without releasing.
       // timeout_watchdog will clear each stale slot after contribution_timeout_secs.
-      /* @__PURE__ */ jsxs2(Text2, { dimColor: true, children: [
-        "Slot is idle \u2014 waiting for positions ahead to respond or time out",
-        " ",
-        "(up to ~5 min each)"
-      ] })
+      /* @__PURE__ */ jsx2(Text2, { dimColor: true, children: "Slot is idle \u2014 waiting for positions ahead to respond or time out (up to ~5 min each)" })
     ) : (
       // Position 1, slot idle — advance_queue should fire shortly.
       /* @__PURE__ */ jsx2(Text2, { dimColor: true, children: "Slot is idle \u2014 your turn is being prepared..." })
@@ -394,9 +458,21 @@ function QueueView({ ceremonyId: ceremonyId2, trackId, token, onReady, onError }
     ] })
   ] });
 }
+function ExportingMessage({ status }) {
+  const exportingMsg = useCyclingMessage(EXPORTING_MESSAGES, 2500, status === "exporting");
+  return /* @__PURE__ */ jsx2(Box2, { flexDirection: "column", children: status === "exporting" ? /* @__PURE__ */ jsxs2(Fragment2, { children: [
+    /* @__PURE__ */ jsxs2(Text2, { color: "green", children: [
+      /* @__PURE__ */ jsx2(Spinner, { type: "dots" }),
+      " ",
+      exportingMsg,
+      "\u2026"
+    ] }),
+    /* @__PURE__ */ jsx2(Text2, { dimColor: true, children: "Your slot is active. The worker is preparing the challenge file just for you." })
+  ] }) : /* @__PURE__ */ jsx2(Text2, { color: "green", children: "Challenge ready \u2014 loading contribution flow\u2026" }) });
+}
 
 // src/components/EntropyCollector.tsx
-import { useRef as useRef2, useState as useState2 } from "react";
+import { useRef as useRef2, useState as useState3 } from "react";
 import { Box as Box3, Text as Text3, useInput } from "ink";
 
 // src/entropy.ts
@@ -417,8 +493,8 @@ function buildEntropyFromKeystrokes(chars, timingsNs) {
 import { jsx as jsx3, jsxs as jsxs3 } from "react/jsx-runtime";
 var TARGET = 20;
 function EntropyCollector({ onComplete, onError }) {
-  const [count, setCount] = useState2(0);
-  const [done, setDone] = useState2(false);
+  const [count, setCount] = useState3(0);
+  const [done, setDone] = useState3(false);
   const charsRef = useRef2([]);
   const timingsRef = useRef2([]);
   const lastRef = useRef2(process.hrtime.bigint());
@@ -460,7 +536,7 @@ function EntropyCollector({ onComplete, onError }) {
     /* @__PURE__ */ jsx3(Text3, { bold: true, children: "Type anything to generate entropy:" }),
     /* @__PURE__ */ jsx3(Text3, { dimColor: true, children: "Keystroke timing (nanosecond intervals) is the randomness source." }),
     /* @__PURE__ */ jsxs3(Box3, { marginTop: 1, children: [
-      /* @__PURE__ */ jsx3(Text3, { dimColor: true, children: "  > " }),
+      /* @__PURE__ */ jsx3(Text3, { dimColor: true, children: " > " }),
       /* @__PURE__ */ jsx3(Text3, { color: "green", children: stars }),
       /* @__PURE__ */ jsx3(Text3, { color: "yellow", children: "\u2588" })
     ] }),
@@ -475,7 +551,7 @@ function EntropyCollector({ onComplete, onError }) {
         /* @__PURE__ */ jsxs3(Text3, { dimColor: true, children: [
           "/",
           TARGET,
-          " keystrokes  (",
+          " keystrokes (",
           pct,
           "%)"
         ] })
@@ -486,7 +562,7 @@ function EntropyCollector({ onComplete, onError }) {
 }
 
 // src/components/ContributeFlow.tsx
-import { useEffect as useEffect3, useState as useState3 } from "react";
+import { useEffect as useEffect4, useState as useState4 } from "react";
 import { Box as Box4, Text as Text4 } from "ink";
 import Spinner2 from "ink-spinner";
 import { tmpdir as tmpdir2 } from "os";
@@ -525,8 +601,8 @@ var STEP_INDEX = {
 };
 function ContributeFlow(props) {
   const { ceremonyId: ceremonyId2, trackId, token, slotStatus, entropy, displayName: displayName2 } = props;
-  const [step, setStep] = useState3({ name: "downloading", bytesReceived: 0, total: null });
-  useEffect3(() => {
+  const [step, setStep] = useState4({ name: "downloading", bytesReceived: 0, total: null });
+  useEffect4(() => {
     let cancelled = false;
     const challengePath = join4(tmpdir2(), `ceremony-challenge-${Date.now()}.mpcparams`);
     let responsePath = null;
@@ -572,9 +648,11 @@ function ContributeFlow(props) {
         await api.signalUploaded(ceremonyId2, trackId, slotStatus.contribution_id, token);
         if (cancelled) return;
         setStep({ name: "verifying", attempt: 1 });
+        const TOTAL_POLLS = 100;
+        const FAST_POLLS = 10;
         let receipt = null;
         let lastErr = null;
-        for (let i = 0; i < 30; i++) {
+        for (let i = 0; i < TOTAL_POLLS; i++) {
           if (cancelled) return;
           setStep({ name: "verifying", attempt: i + 1 });
           try {
@@ -583,7 +661,8 @@ function ContributeFlow(props) {
             break;
           } catch (err) {
             lastErr = err instanceof Error ? err : new Error(String(err));
-            await new Promise((r) => setTimeout(r, 3e3));
+            const delay = i < FAST_POLLS ? 3e3 : 1e4;
+            await new Promise((r) => setTimeout(r, delay));
           }
         }
         if (cancelled) return;
@@ -604,6 +683,8 @@ function ContributeFlow(props) {
     };
   }, []);
   const currentIdx = STEP_INDEX[step.name] ?? 0;
+  const computingMsg = useCyclingMessage(COMPUTING_MESSAGES, 2500, step.name === "computing");
+  const verifyingMsg = useCyclingMessage(VERIFYING_MESSAGES, 3e3, step.name === "verifying");
   return /* @__PURE__ */ jsx4(Box4, { flexDirection: "column", gap: 1, children: STEP_LABELS.map((label, i) => {
     const isDone = i < currentIdx;
     const isActive = i === currentIdx;
@@ -618,7 +699,8 @@ function ContributeFlow(props) {
       const filled = Math.round(pct / 5);
       const bar = "\u2588".repeat(filled) + "\u2591".repeat(20 - filled);
       detail = /* @__PURE__ */ jsxs4(Text4, { dimColor: true, children: [
-        "  [",
+        " ",
+        "[",
         bar,
         "] ",
         pct,
@@ -626,10 +708,23 @@ function ContributeFlow(props) {
       ] });
     }
     if (isActive && step.name === "verifying") {
+      const elapsed = step.attempt <= 10 ? step.attempt * 3 : 10 * 3 + (step.attempt - 10) * 10;
+      const mins = Math.floor(elapsed / 60);
+      const secs = elapsed % 60;
+      const time = mins > 0 ? `${mins}m ${secs.toString().padStart(2, "0")}s` : `${secs}s`;
       detail = /* @__PURE__ */ jsxs4(Text4, { dimColor: true, children: [
-        "  worker verifying... (",
-        step.attempt,
-        "/30)"
+        " ",
+        verifyingMsg,
+        "\u2026 (",
+        time,
+        " elapsed)"
+      ] });
+    }
+    if (isActive && step.name === "computing") {
+      detail = /* @__PURE__ */ jsxs4(Text4, { dimColor: true, children: [
+        " ",
+        computingMsg,
+        "\u2026"
       ] });
     }
     return /* @__PURE__ */ jsxs4(Box4, { flexDirection: "column", children: [
@@ -644,8 +739,7 @@ function ContributeFlow(props) {
             children: [
               label.charAt(0).toUpperCase() + label.slice(1),
               " ",
-              isActive && label === "computing" && /* @__PURE__ */ jsx4(Text4, { dimColor: true, children: "(entropy stays local)" }),
-              isActive && label === "uploading" && /* @__PURE__ */ jsx4(Text4, { dimColor: true, children: "(~544 bytes)" })
+              isActive && label === "computing" && /* @__PURE__ */ jsx4(Text4, { dimColor: true, children: "(entropy stays local)" })
             ]
           }
         )
@@ -662,25 +756,25 @@ function Attestation({ contribution }) {
   const hashShort = contribution.contributionHash ? `${contribution.contributionHash.slice(0, 16)}...${contribution.contributionHash.slice(-8)}` : "(pending verification)";
   const verifiedAt = contribution.verifiedAt ? new Date(contribution.verifiedAt).toLocaleString() : null;
   return /* @__PURE__ */ jsxs5(Box5, { flexDirection: "column", gap: 1, children: [
-    /* @__PURE__ */ jsx5(Text5, { bold: true, color: "green", children: "\u2713  Contribution verified!" }),
+    /* @__PURE__ */ jsx5(Text5, { bold: true, color: "green", children: "\u2713 Contribution verified!" }),
     /* @__PURE__ */ jsxs5(Box5, { flexDirection: "column", gap: 0, children: [
       /* @__PURE__ */ jsxs5(Box5, { gap: 2, children: [
         /* @__PURE__ */ jsx5(Text5, { dimColor: true, children: "Circuit" }),
         /* @__PURE__ */ jsx5(Text5, { bold: true, children: contribution.circuitName })
       ] }),
       /* @__PURE__ */ jsxs5(Box5, { gap: 2, children: [
-        /* @__PURE__ */ jsx5(Text5, { dimColor: true, children: "Round  " }),
+        /* @__PURE__ */ jsx5(Text5, { dimColor: true, children: "Round " }),
         /* @__PURE__ */ jsxs5(Text5, { bold: true, children: [
           "#",
           contribution.sequenceNumber
         ] })
       ] }),
       /* @__PURE__ */ jsxs5(Box5, { gap: 2, children: [
-        /* @__PURE__ */ jsx5(Text5, { dimColor: true, children: "Hash   " }),
+        /* @__PURE__ */ jsx5(Text5, { dimColor: true, children: "Hash " }),
         /* @__PURE__ */ jsx5(Text5, { color: "cyan", children: hashShort })
       ] }),
       verifiedAt && /* @__PURE__ */ jsxs5(Box5, { gap: 2, children: [
-        /* @__PURE__ */ jsx5(Text5, { dimColor: true, children: "Time   " }),
+        /* @__PURE__ */ jsx5(Text5, { dimColor: true, children: "Time " }),
         /* @__PURE__ */ jsx5(Text5, { dimColor: true, children: verifiedAt })
       ] })
     ] }),
@@ -721,19 +815,19 @@ var NAME_MAX_LEN = 100;
 var NAME_VALID_RE = /^[\p{L}\p{N} _.\-]*$/u;
 function App({ ceremonyId: initialCeremonyId, displayName: initialDisplayName }) {
   const { exit } = useApp();
-  const [activeCeremonyId, setActiveCeremonyId] = useState4(initialCeremonyId);
-  const [displayName2, setDisplayName] = useState4(initialDisplayName ?? "anonymous");
-  const [nameSet, setNameSet] = useState4(initialDisplayName !== void 0);
-  const [screen, setScreen] = useState4(
+  const [activeCeremonyId, setActiveCeremonyId] = useState5(initialCeremonyId);
+  const [displayName2, setDisplayName] = useState5(initialDisplayName ?? "anonymous");
+  const [nameSet, setNameSet] = useState5(initialDisplayName !== void 0);
+  const [screen, setScreen] = useState5(
     initialDisplayName === void 0 ? { name: "name-input", value: "" } : initialCeremonyId ? { name: "loading" } : { name: "ceremony-picker", ceremonies: [], loading: true }
   );
-  const [ceremony, setCeremony] = useState4(null);
-  const [session, setSession] = useState4(null);
-  const [contributed, setContributed] = useState4({});
-  const [selectedIdx, setSelectedIdx] = useState4(0);
-  const [tab, setTab] = useState4(0);
-  const [showInfo, setShowInfo] = useState4(false);
-  useEffect4(() => {
+  const [ceremony, setCeremony] = useState5(null);
+  const [session, setSession] = useState5(null);
+  const [contributed, setContributed] = useState5({});
+  const [selectedIdx, setSelectedIdx] = useState5(0);
+  const [tab, setTab] = useState5(0);
+  const [showInfo, setShowInfo] = useState5(false);
+  useEffect5(() => {
     if (!nameSet) return;
     if (!initialCeremonyId) {
       loadCeremonies();
@@ -747,7 +841,11 @@ function App({ ceremonyId: initialCeremonyId, displayName: initialDisplayName })
       setScreen({ name: "ceremony-picker", ceremonies, loading: false });
       setSelectedIdx(0);
     } catch (e) {
-      setScreen({ name: "error", message: e.message ?? "Failed to load ceremonies.", recoverable: false });
+      setScreen({
+        name: "error",
+        message: e.message ?? "Failed to load ceremonies.",
+        recoverable: false
+      });
     }
   }
   async function boot(cId) {
@@ -769,7 +867,11 @@ function App({ ceremonyId: initialCeremonyId, displayName: initialDisplayName })
     try {
       const { tracks } = await api.listTracks(cId, s.session_token);
       if (tracks.length === 0) {
-        setScreen({ name: "error", message: "No tracks found in this ceremony.", recoverable: false });
+        setScreen({
+          name: "error",
+          message: "No tracks found in this ceremony.",
+          recoverable: false
+        });
         return;
       }
       setSelectedIdx(0);
@@ -782,17 +884,29 @@ function App({ ceremonyId: initialCeremonyId, displayName: initialDisplayName })
           setSession(fresh);
           const { tracks } = await api.listTracks(cId, fresh.session_token);
           if (tracks.length === 0) {
-            setScreen({ name: "error", message: "No tracks found in this ceremony.", recoverable: false });
+            setScreen({
+              name: "error",
+              message: "No tracks found in this ceremony.",
+              recoverable: false
+            });
             return;
           }
           setSelectedIdx(0);
           setScreen({ name: "tracks", tracks });
         } catch (e2) {
-          setScreen({ name: "error", message: e2.message ?? "Failed to load tracks.", recoverable: false });
+          setScreen({
+            name: "error",
+            message: e2.message ?? "Failed to load tracks.",
+            recoverable: false
+          });
         }
         return;
       }
-      setScreen({ name: "error", message: e.message ?? "Failed to load tracks.", recoverable: false });
+      setScreen({
+        name: "error",
+        message: e.message ?? "Failed to load tracks.",
+        recoverable: false
+      });
     }
   }
   function commitName(raw) {
@@ -805,10 +919,9 @@ function App({ ceremonyId: initialCeremonyId, displayName: initialDisplayName })
     );
   }
   function randomAnonName() {
-    const hex = Array.from(
-      { length: 6 },
-      () => Math.floor(Math.random() * 16).toString(16)
-    ).join("");
+    const hex = Array.from({ length: 6 }, () => Math.floor(Math.random() * 16).toString(16)).join(
+      ""
+    );
     return `anon-${hex}`;
   }
   async function joinTrack(track) {
@@ -818,7 +931,11 @@ function App({ ceremonyId: initialCeremonyId, displayName: initialDisplayName })
       await api.joinQueue(activeCeremonyId, track.id, session.session_token);
     } catch (e) {
       if (e.code !== "ALREADY_IN_QUEUE") {
-        setScreen({ name: "error", message: e.message ?? "Failed to join queue.", recoverable: true });
+        setScreen({
+          name: "error",
+          message: e.message ?? "Failed to join queue.",
+          recoverable: true
+        });
         return;
       }
     }
@@ -833,7 +950,7 @@ function App({ ceremonyId: initialCeremonyId, displayName: initialDisplayName })
     setScreen({ name: "ceremony-picker", ceremonies: [], loading: true });
     loadCeremonies();
   }
-  useEffect4(() => {
+  useEffect5(() => {
     if (screen.name === "queue" && session) {
       const { trackId } = screen;
       setQueueCleanup(() => {
@@ -990,6 +1107,7 @@ function App({ ceremonyId: initialCeremonyId, displayName: initialDisplayName })
           const isSelected = i === selectedIdx;
           const isOpen = c.status === "open";
           const statusColor = c.status === "open" ? "green" : c.status === "completed" ? "cyan" : "yellow";
+          const statusLabel = ceremonyStatusLabel(c.status);
           return /* @__PURE__ */ jsxs7(Box7, { gap: 2, children: [
             /* @__PURE__ */ jsxs7(Text7, { color: isSelected ? "cyan" : isOpen ? void 0 : "gray", children: [
               isSelected ? "\u25B6 " : "  ",
@@ -997,7 +1115,7 @@ function App({ ceremonyId: initialCeremonyId, displayName: initialDisplayName })
             ] }),
             /* @__PURE__ */ jsxs7(Text7, { color: statusColor, children: [
               "[",
-              c.status,
+              statusLabel,
               "]"
             ] }),
             /* @__PURE__ */ jsxs7(Text7, { dimColor: true, children: [
@@ -1017,20 +1135,23 @@ function App({ ceremonyId: initialCeremonyId, displayName: initialDisplayName })
           if (!c) return null;
           if (c.status === "initialized") {
             return /* @__PURE__ */ jsxs7(Text7, { color: "yellow", children: [
-              "  Not open yet \u2014 admin: run  initialize ",
-              "<id>",
-              "  then  open ",
-              "<id>",
-              "  to start contributions."
+              "  ",
+              "This ceremony is not yet open for contributions. The Umbra team is still preparing the circuits \u2014 please check back shortly."
             ] });
           }
           if (c.status === "finalizing") {
-            return /* @__PURE__ */ jsx7(Text7, { color: "yellow", children: "  Contribution phase is closed \u2014 ceremony is applying the final beacon." });
+            return /* @__PURE__ */ jsxs7(Text7, { color: "yellow", children: [
+              "  ",
+              "Contributions are closed. The ceremony is computing the final verification key \u2014 no further contributions can be added."
+            ] });
           }
           if (c.status === "completed") {
-            return /* @__PURE__ */ jsx7(Text7, { color: "cyan", children: "  Ceremony complete \u2014 verification keys are available." });
+            return /* @__PURE__ */ jsxs7(Text7, { color: "cyan", children: [
+              "  ",
+              "Ceremony complete. The verification keys are finalised \u2014 thank you to everyone who contributed."
+            ] });
           }
-          return /* @__PURE__ */ jsx7(Text7, { dimColor: true, children: "\u2191/\u2193 select  \xB7  Enter join  \xB7  Q quit" });
+          return /* @__PURE__ */ jsx7(Text7, { dimColor: true, children: "\u2191/\u2193 select \xB7 Enter join \xB7 Q quit" });
         })()
       ] })
     ] });
@@ -1046,7 +1167,7 @@ function App({ ceremonyId: initialCeremonyId, displayName: initialDisplayName })
     return /* @__PURE__ */ jsxs7(Box7, { flexDirection: "column", children: [
       /* @__PURE__ */ jsx7(Header, { ceremony }),
       /* @__PURE__ */ jsxs7(Text7, { color: "red", bold: true, children: [
-        "\u2717  ",
+        "\u2717 ",
         screen.message
       ] }),
       /* @__PURE__ */ jsx7(Text7, { dimColor: true, children: backHint })
@@ -1055,12 +1176,14 @@ function App({ ceremonyId: initialCeremonyId, displayName: initialDisplayName })
   if (screen.name === "tracks") {
     const { tracks } = screen;
     const openTracks = tracks.filter((t) => t.status === "open");
-    const myContributions = Object.values(contributed).filter((c) => c.ceremonyId === activeCeremonyId);
+    const myContributions = Object.values(contributed).filter(
+      (c) => c.ceremonyId === activeCeremonyId
+    );
     const TabBar = () => /* @__PURE__ */ jsxs7(Box7, { gap: 1, marginBottom: 1, children: [
       /* @__PURE__ */ jsx7(Text7, { bold: tab === 0, color: tab === 0 ? "cyan" : void 0, dimColor: tab !== 0, children: tab === 0 ? "[ Dashboard ]" : "  Dashboard  " }),
       /* @__PURE__ */ jsx7(Text7, { dimColor: true, children: "|" }),
       /* @__PURE__ */ jsx7(Text7, { bold: tab === 1, color: tab === 1 ? "cyan" : void 0, dimColor: tab !== 1, children: tab === 1 ? `[ My Contributions (${myContributions.length}) ]` : `  My Contributions (${myContributions.length})  ` }),
-      /* @__PURE__ */ jsx7(Text7, { dimColor: true, children: "  Tab to switch" })
+      /* @__PURE__ */ jsx7(Text7, { dimColor: true, children: " Tab to switch" })
     ] });
     return /* @__PURE__ */ jsxs7(Box7, { flexDirection: "column", children: [
       /* @__PURE__ */ jsx7(Header, { ceremony }),
@@ -1072,10 +1195,10 @@ function App({ ceremonyId: initialCeremonyId, displayName: initialDisplayName })
             "  CIRCUIT".padEnd(30),
             "TOTAL".padEnd(10),
             "QUEUE".padEnd(8),
-            "STATUS".padEnd(14),
+            "STATUS".padEnd(16),
             "MY CONTRIBUTIONS"
           ] }),
-          /* @__PURE__ */ jsx7(Text7, { dimColor: true, children: "  " + "\u2500".repeat(68) }),
+          /* @__PURE__ */ jsx7(Text7, { dimColor: true, children: "  " + "\u2500".repeat(70) }),
           tracks.map((t, i) => {
             const isSelected = i === selectedIdx;
             const canContribute = t.status === "open";
@@ -1089,21 +1212,21 @@ function App({ ceremonyId: initialCeremonyId, displayName: initialDisplayName })
                 String(t.contribution_count).padEnd(10),
                 String(t.queue_depth).padEnd(8)
               ] }),
-              /* @__PURE__ */ jsx7(Text7, { color: statusColor, children: t.status.padEnd(14) }),
+              /* @__PURE__ */ jsx7(Text7, { color: statusColor, children: trackStatusLabel(t.status).padEnd(16) }),
               myContrib ? isSelected ? /* @__PURE__ */ jsxs7(Text7, { color: "green", children: [
                 "\u2713 contributed (round #",
                 myContrib.sequenceNumber,
-                ")  \u2014 already done"
+                ") \u2014 already done"
               ] }) : /* @__PURE__ */ jsxs7(Text7, { color: "green", children: [
-                "\u2713 contributed  (round #",
+                "\u2713 contributed (round #",
                 myContrib.sequenceNumber,
                 ")"
               ] }) : canContribute ? isSelected ? /* @__PURE__ */ jsx7(Text7, { color: "yellow", children: "\u2190 Enter to contribute" }) : /* @__PURE__ */ jsx7(Text7, { dimColor: true, children: "not contributed" }) : /* @__PURE__ */ jsx7(Text7, { dimColor: true, children: "\u2014" })
             ] }, t.id);
           }),
-          /* @__PURE__ */ jsx7(Text7, { dimColor: true, children: "  " + "\u2500".repeat(68) }),
-          openTracks.length === 0 ? /* @__PURE__ */ jsx7(Text7, { color: "yellow", children: "No open tracks \u2014 ceremony may be finalizing or complete." }) : /* @__PURE__ */ jsxs7(Text7, { dimColor: true, children: [
-            "\u2191/\u2193 select  \xB7  Enter contribute  \xB7  R refresh  \xB7  Q quit",
+          /* @__PURE__ */ jsx7(Text7, { dimColor: true, children: "  " + "\u2500".repeat(70) }),
+          openTracks.length === 0 ? /* @__PURE__ */ jsx7(Text7, { color: "yellow", children: "No circuits are open for contributions right now \u2014 the ceremony may be closing or already complete." }) : /* @__PURE__ */ jsxs7(Text7, { dimColor: true, children: [
+            "\u2191/\u2193 select \xB7 Enter contribute \xB7 R refresh \xB7 Q quit",
             !initialCeremonyId ? "  \xB7  \u232B back to ceremony list" : ""
           ] })
         ] })
@@ -1122,7 +1245,7 @@ function App({ ceremonyId: initialCeremonyId, displayName: initialDisplayName })
           /* @__PURE__ */ jsx7(Text7, { dimColor: true, children: "  " + "\u2500".repeat(68) }),
           myContributions.map((c, i) => /* @__PURE__ */ jsxs7(Box7, { flexDirection: "column", children: [
             /* @__PURE__ */ jsxs7(Box7, { children: [
-              /* @__PURE__ */ jsx7(Text7, { color: "green", children: "  \u2713 " }),
+              /* @__PURE__ */ jsx7(Text7, { color: "green", children: " \u2713 " }),
               /* @__PURE__ */ jsx7(Text7, { bold: true, children: c.circuitName.padEnd(24) }),
               /* @__PURE__ */ jsx7(Text7, { color: "yellow", children: "#" + c.sequenceNumber + " " }),
               /* @__PURE__ */ jsx7(Text7, { color: "cyan", children: c.contributionHash ? c.contributionHash.slice(0, 16) + "..." : "(pending)" })
@@ -1139,7 +1262,7 @@ function App({ ceremonyId: initialCeremonyId, displayName: initialDisplayName })
             " contribution",
             myContributions.length !== 1 ? "s" : "",
             "  \xB7  ",
-            "Tab to switch  \xB7  Q to quit"
+            "Tab to switch \xB7 Q to quit"
           ] })
         ] }) })
       )
@@ -1157,7 +1280,7 @@ function App({ ceremonyId: initialCeremonyId, displayName: initialDisplayName })
     return /* @__PURE__ */ jsxs7(Box7, { flexDirection: "column", children: [
       /* @__PURE__ */ jsx7(Header, { ceremony, subtitle: `Circuit: ${circuitName}` }),
       priorContrib && /* @__PURE__ */ jsx7(Box7, { marginBottom: 1, paddingX: 1, children: /* @__PURE__ */ jsxs7(Text7, { color: "yellow", children: [
-        "\u26A0  You already contributed to this circuit (round #",
+        "\u26A0 You already contributed to this circuit (round #",
         priorContrib.sequenceNumber,
         ").",
         " ",
@@ -1173,7 +1296,7 @@ function App({ ceremonyId: initialCeremonyId, displayName: initialDisplayName })
           onError: (e) => setScreen({ name: "error", message: e.message, recoverable: true })
         }
       ),
-      /* @__PURE__ */ jsx7(Text7, { dimColor: true, children: "\u232B Backspace to go back  \xB7  Q to quit" })
+      /* @__PURE__ */ jsx7(Text7, { dimColor: true, children: "\u232B Backspace to go back \xB7 Q to quit" })
     ] });
   }
   if (screen.name === "entropy") {
@@ -1225,7 +1348,7 @@ function App({ ceremonyId: initialCeremonyId, displayName: initialDisplayName })
     return /* @__PURE__ */ jsxs7(Box7, { flexDirection: "column", children: [
       /* @__PURE__ */ jsx7(Header, { ceremony }),
       /* @__PURE__ */ jsx7(Attestation, { contribution }),
-      /* @__PURE__ */ jsx7(Box7, { marginTop: 1, children: /* @__PURE__ */ jsx7(Text7, { dimColor: true, children: "\u232B Backspace / B = contribute to another circuit  \xB7  Q to quit" }) })
+      /* @__PURE__ */ jsx7(Box7, { marginTop: 1, children: /* @__PURE__ */ jsx7(Text7, { dimColor: true, children: "\u232B Backspace / B = contribute to another circuit \xB7 Q to quit" }) })
     ] });
   }
   return null;
@@ -1256,10 +1379,9 @@ process.on("SIGTERM", () => {
     process.exit(0);
   });
 });
-var { waitUntilExit } = render(
-  /* @__PURE__ */ jsx8(App, { ceremonyId, displayName }),
-  { exitOnCtrlC: false }
-);
+var { waitUntilExit } = render(/* @__PURE__ */ jsx8(App, { ceremonyId, displayName }), {
+  exitOnCtrlC: false
+});
 await waitUntilExit();
 restoreScreen();
 process.exit(0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umbra-privacy/ceremony",
-  "version": "0.2.3",
+  "version": "0.2.6",
   "description": "Terminal UI for the Umbra Phase 2 trusted setup ceremony",
   "type": "module",
   "bin": {