@decentnetwork/beagle 0.1.17 → 0.1.19

package/dist/desktop/app.js

@@ -1,4 +1,4 @@
-window.__DK_UI_VERSION="0.1.16";
+window.__DK_UI_VERSION="0.1.19";
 const ICON_PATHS = {
   // ---- tab bar (the four must feel like one set) ----
   users: '<path d="M16 21v-2a4 4 0 0 0-4-4H6a4 4 0 0 0-4 4v2"/><circle cx="9" cy="7" r="4"/><path d="M22 21v-2a4 4 0 0 0-3-3.87"/><path d="M16 3.13a4 4 0 0 1 0 7.75"/>',
@@ -2800,10 +2800,93 @@ function DkEditModal({ T, me, onClose, onSave }) {
   };
   return /* @__PURE__ */ React.createElement("div", { onClick: onClose, style: { position: "fixed", inset: 0, zIndex: 90, background: "color-mix(in oklab, #000, transparent 38%)", display: "flex", alignItems: "center", justifyContent: "center", padding: 24 } }, /* @__PURE__ */ React.createElement("div", { onClick: (e) => e.stopPropagation(), style: { width: 440, maxWidth: "92vw", background: "var(--panel)", border: "1px solid var(--line)", borderRadius: 16, padding: 22, display: "flex", flexDirection: "column", gap: 14 } }, /* @__PURE__ */ React.createElement("div", { style: { display: "flex", alignItems: "center" } }, /* @__PURE__ */ React.createElement("span", { style: { fontFamily: "var(--mono)", fontSize: 13, fontWeight: 700, color: "var(--text)" } }, T.editProfile), /* @__PURE__ */ React.createElement("div", { style: { flex: 1 } }), /* @__PURE__ */ React.createElement(Btn, { icon: "x", size: "sm", onClick: onClose })), /* @__PURE__ */ React.createElement("label", { style: { display: "flex", flexDirection: "column", gap: 6 } }, /* @__PURE__ */ React.createElement("span", { style: lbl }, "display name"), /* @__PURE__ */ React.createElement("input", { value: name, onChange: (e) => setName(e.target.value), onKeyDown: onKey, autoFocus: true, maxLength: 48, style: field })), /* @__PURE__ */ React.createElement("label", { style: { display: "flex", flexDirection: "column", gap: 6 } }, /* @__PURE__ */ React.createElement("span", { style: lbl }, "status message"), /* @__PURE__ */ React.createElement("input", { value: desc, onChange: (e) => setDesc(e.target.value), onKeyDown: onKey, maxLength: 120, placeholder: "optional \u2014 a short bio friends will see", style: field })), /* @__PURE__ */ React.createElement("div", { style: { fontFamily: "var(--ui)", fontSize: 11.5, color: "var(--faint)" } }, "Your userid (the unique identity) can't change \u2014 only the display name + status."), /* @__PURE__ */ React.createElement("div", { style: { display: "flex", justifyContent: "flex-end", gap: 8, marginTop: 2 } }, /* @__PURE__ */ React.createElement(Btn, { size: "sm", onClick: onClose }, T.cancel || "cancel"), /* @__PURE__ */ React.createElement(Btn, { tone: "accent", size: "sm", onClick: save }, T.save || "save"))));
 }
+function DkEnsCard({ T, me }) {
+  const [st, setSt] = React.useState({ loading: true });
+  const [label, setLabel] = React.useState("");
+  const [busy, setBusy] = React.useState(false);
+  const [msg, setMsg] = React.useState(null);
+  const reload = () => {
+    fetch("/api/ens-name").then((r) => r.json()).then((d) => {
+      setSt({ loading: false, registered: !!d.registered, record: d.record || null, mineOwned: !!d.mineOwned });
+      if (d.registered && d.record && d.record.name)
+        setLabel(d.record.name.replace(/\.beagles\.eth$/i, ""));
+    }).catch((e) => setSt({ loading: false, error: String(e && e.message || e) }));
+  };
+  React.useEffect(() => {
+    reload();
+  }, []);
+  const post = (url, body) => {
+    setBusy(true);
+    setMsg(null);
+    return fetch(url, { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify(body) }).then((r) => r.json()).then((d) => {
+      setMsg(d.ok ? { tone: "ok", text: T.ensDone || "saved" } : { tone: "err", text: d.error || "failed" });
+      if (d.ok)
+        reload();
+      return d;
+    }).catch((e) => {
+      setMsg({ tone: "err", text: String(e && e.message || e) });
+    }).finally(() => setBusy(false));
+  };
+  const register = () => {
+    const l = label.trim();
+    if (l)
+      post("/api/ens-register", { name: l, displayName: me.name });
+  };
+  const bind = (chain, address) => post("/api/ens-bind-wallet", { chain, address });
+  const bindEth = async () => {
+    const eth = window.ethereum;
+    if (!eth) {
+      setMsg({ tone: "err", text: T.ensNoEthWallet || "no Ethereum wallet extension found (MetaMask\u2026)" });
+      return;
+    }
+    try {
+      const a = await eth.request({ method: "eth_requestAccounts" });
+      if (a && a[0])
+        bind("eth", a[0]);
+    } catch (e) {
+      setMsg({ tone: "err", text: String(e && e.message || e) });
+    }
+  };
+  const bindSol = async () => {
+    const sol = window.phantom && window.phantom.solana || window.solana;
+    if (!sol) {
+      setMsg({ tone: "err", text: T.ensNoSolWallet || "no Solana wallet extension found (Phantom\u2026)" });
+      return;
+    }
+    try {
+      const r = await sol.connect();
+      const a = r && r.publicKey && r.publicKey.toString();
+      if (a)
+        bind("sol", a);
+    } catch (e) {
+      setMsg({ tone: "err", text: String(e && e.message || e) });
+    }
+  };
+  const field = { flex: 1, minWidth: 0, height: 34, borderRadius: 8, border: "1px solid var(--line)", background: "var(--panel-2)", color: "var(--text)", fontFamily: "var(--mono)", fontSize: 13, padding: "0 10px", outline: "none" };
+  const row = { display: "flex", alignItems: "center", gap: 10, padding: "12px 16px", borderBottom: "1px solid var(--line)" };
+  const rec = st.record;
+  const boundEth = rec && rec.addresses && rec.addresses["60"];
+  const boundSol = rec && rec.addresses && rec.addresses["501"];
+  const walletRow = (lbl, bound, onBind, last) => /* @__PURE__ */ React.createElement("div", { style: { ...row, borderBottom: last ? "none" : row.borderBottom } }, /* @__PURE__ */ React.createElement("span", { style: { width: 130, flexShrink: 0, fontFamily: "var(--mono)", fontSize: 11.5, fontWeight: 600, color: "var(--faint)", textTransform: "uppercase", letterSpacing: 0.5 } }, lbl), bound ? /* @__PURE__ */ React.createElement(React.Fragment, null, /* @__PURE__ */ React.createElement("span", { style: { flex: 1, minWidth: 0, fontFamily: "var(--mono)", fontSize: 12.5, color: "var(--text)", overflow: "hidden", textOverflow: "ellipsis", whiteSpace: "nowrap" } }, bound), /* @__PURE__ */ React.createElement(CopyBtn, { value: bound, copiedText: T.copied, copyFailedText: T.copyFailed, copyTitle: T.copy })) : /* @__PURE__ */ React.createElement("span", { style: { flex: 1, fontFamily: "var(--ui)", fontSize: 12, color: "var(--faint)" } }, T.ensNotBound || "not bound"), /* @__PURE__ */ React.createElement(Btn, { size: "sm", disabled: busy || !st.mineOwned, onClick: onBind }, bound ? T.ensRebind || "rebind" : T.ensBind || "bind"));
+  return /* @__PURE__ */ React.createElement(Card, { label: T.ensCard || "Name \xB7 beagles.eth" }, st.loading ? /* @__PURE__ */ React.createElement("div", { style: { padding: "14px 16px", fontFamily: "var(--ui)", fontSize: 12.5, color: "var(--faint)" } }, T.dirLoading || "loading\u2026") : /* @__PURE__ */ React.createElement(React.Fragment, null, /* @__PURE__ */ React.createElement("div", { style: row }, /* @__PURE__ */ React.createElement("span", { style: { width: 130, flexShrink: 0, fontFamily: "var(--mono)", fontSize: 11.5, fontWeight: 600, color: "var(--faint)", textTransform: "uppercase", letterSpacing: 0.5 } }, T.ensName || "name"), /* @__PURE__ */ React.createElement(
+    "input",
+    {
+      value: label,
+      onChange: (e) => setLabel(e.target.value),
+      placeholder: T.ensPlaceholder || "yourname",
+      disabled: busy,
+      onKeyDown: (e) => {
+        if (e.key === "Enter")
+          register();
+      },
+      style: field
+    }
+  ), /* @__PURE__ */ React.createElement("span", { style: { fontFamily: "var(--mono)", fontSize: 12.5, color: "var(--dim)", flexShrink: 0 } }, ".beagles.eth"), /* @__PURE__ */ React.createElement(Btn, { tone: "accent", size: "sm", disabled: busy || !label.trim(), onClick: register }, busy ? "\u2026" : st.registered && st.mineOwned ? T.ensUpdate || "update" : T.ensRegister || "register")), st.registered && !st.mineOwned && /* @__PURE__ */ React.createElement("div", { style: { padding: "10px 16px", borderBottom: "1px solid var(--line)", fontFamily: "var(--ui)", fontSize: 11.5, color: "var(--faint)" } }, (T.ensWalletOwned || "registered via your mobile wallet as") + " ", /* @__PURE__ */ React.createElement("span", { style: { fontFamily: "var(--mono)" } }, rec && rec.name)), walletRow(T.ensEth || "ethereum", boundEth, bindEth, false), walletRow(T.ensSol || "solana", boundSol, bindSol, !msg), msg && /* @__PURE__ */ React.createElement("div", { style: { padding: "10px 16px", fontFamily: "var(--ui)", fontSize: 12, color: msg.tone === "ok" ? "var(--online)" : "var(--danger)" } }, msg.text)));
+}
 function ProfileTab({ T, me, onEdit }) {
   const [qr, setQr] = React.useState(null);
   const [editing, setEditing] = React.useState(false);
-  return /* @__PURE__ */ React.createElement("div", { style: { flex: 1, overflow: "auto", background: "var(--bg)" } }, /* @__PURE__ */ React.createElement("div", { style: { maxWidth: 760, margin: "0 auto", padding: "24px 28px 60px", display: "flex", flexDirection: "column", gap: 24 } }, /* @__PURE__ */ React.createElement("div", { style: { display: "flex", alignItems: "center", gap: 18, padding: "20px 22px", borderRadius: 14, background: "var(--panel)", border: "1px solid var(--line)" } }, /* @__PURE__ */ React.createElement("div", { style: { position: "relative" } }, /* @__PURE__ */ React.createElement(DkIdenticon, { seed: me.userId, size: 68, radius: 16 }), /* @__PURE__ */ React.createElement("span", { style: { position: "absolute", right: -3, bottom: -3, width: 18, height: 18, borderRadius: 999, background: "var(--online)", border: "3px solid var(--panel)" } })), /* @__PURE__ */ React.createElement("div", { style: { flex: 1, minWidth: 0 } }, /* @__PURE__ */ React.createElement("div", { style: { display: "flex", alignItems: "center", gap: 10 } }, /* @__PURE__ */ React.createElement("span", { style: { fontFamily: "var(--mono)", fontSize: 22, fontWeight: 700, letterSpacing: -0.5, color: "var(--text)" } }, me.name), /* @__PURE__ */ React.createElement(Tag, { tone: "ok" }, "online"), me.isExit && /* @__PURE__ */ React.createElement(Tag, { tone: "warn" }, "exit", me.exitRegion ? ` \xB7 ${me.exitRegion.toUpperCase()}` : "")), /* @__PURE__ */ React.createElement("div", { style: { fontFamily: "var(--mono)", fontSize: 13, color: "var(--dim)", marginTop: 4 } }, me.handle), me.description ? /* @__PURE__ */ React.createElement("div", { style: { fontFamily: "var(--ui)", fontSize: 12.5, color: "var(--faint)", marginTop: 3 } }, me.description) : null), /* @__PURE__ */ React.createElement(Btn, { icon: "edit", onClick: () => setEditing(true) }, T.editProfile)), /* @__PURE__ */ React.createElement(Card, { label: T.identity }, /* @__PURE__ */ React.createElement(FieldRow, { T, label: T.userId, value: me.userId, copy: true, qr: true, onQr: (v, l) => setQr({ value: v, label: l }) }), /* @__PURE__ */ React.createElement(FieldRow, { T, label: T.carrierAddr, value: me.carrier, copy: true, qr: true, onQr: (v, l) => setQr({ value: v, label: l }) }), /* @__PURE__ */ React.createElement(FieldRow, { T, label: T.netKey, value: me.netKey, copy: true, last: true })), typeof me.autoAccept === "boolean" && /* @__PURE__ */ React.createElement(Card, { label: T && T.friendsSettings || "Friends" }, /* @__PURE__ */ React.createElement("label", { style: { display: "flex", alignItems: "center", gap: 13, padding: "14px 16px", cursor: "pointer" } }, /* @__PURE__ */ React.createElement(
+  return /* @__PURE__ */ React.createElement("div", { style: { flex: 1, overflow: "auto", background: "var(--bg)" } }, /* @__PURE__ */ React.createElement("div", { style: { maxWidth: 760, margin: "0 auto", padding: "24px 28px 60px", display: "flex", flexDirection: "column", gap: 24 } }, /* @__PURE__ */ React.createElement("div", { style: { display: "flex", alignItems: "center", gap: 18, padding: "20px 22px", borderRadius: 14, background: "var(--panel)", border: "1px solid var(--line)" } }, /* @__PURE__ */ React.createElement("div", { style: { position: "relative" } }, /* @__PURE__ */ React.createElement(DkIdenticon, { seed: me.userId, size: 68, radius: 16 }), /* @__PURE__ */ React.createElement("span", { style: { position: "absolute", right: -3, bottom: -3, width: 18, height: 18, borderRadius: 999, background: "var(--online)", border: "3px solid var(--panel)" } })), /* @__PURE__ */ React.createElement("div", { style: { flex: 1, minWidth: 0 } }, /* @__PURE__ */ React.createElement("div", { style: { display: "flex", alignItems: "center", gap: 10 } }, /* @__PURE__ */ React.createElement("span", { style: { fontFamily: "var(--mono)", fontSize: 22, fontWeight: 700, letterSpacing: -0.5, color: "var(--text)" } }, me.name), /* @__PURE__ */ React.createElement(Tag, { tone: "ok" }, "online"), me.isExit && /* @__PURE__ */ React.createElement(Tag, { tone: "warn" }, "exit", me.exitRegion ? ` \xB7 ${me.exitRegion.toUpperCase()}` : "")), /* @__PURE__ */ React.createElement("div", { style: { fontFamily: "var(--mono)", fontSize: 13, color: "var(--dim)", marginTop: 4 } }, me.handle), me.description ? /* @__PURE__ */ React.createElement("div", { style: { fontFamily: "var(--ui)", fontSize: 12.5, color: "var(--faint)", marginTop: 3 } }, me.description) : null), /* @__PURE__ */ React.createElement(Btn, { icon: "edit", onClick: () => setEditing(true) }, T.editProfile)), /* @__PURE__ */ React.createElement(Card, { label: T.identity }, /* @__PURE__ */ React.createElement(FieldRow, { T, label: T.userId, value: me.userId, copy: true, qr: true, onQr: (v, l) => setQr({ value: v, label: l }) }), /* @__PURE__ */ React.createElement(FieldRow, { T, label: T.carrierAddr, value: me.carrier, copy: true, qr: true, onQr: (v, l) => setQr({ value: v, label: l }) }), /* @__PURE__ */ React.createElement(FieldRow, { T, label: T.netKey, value: me.netKey, copy: true, last: true })), /* @__PURE__ */ React.createElement(DkEnsCard, { T, me }), typeof me.autoAccept === "boolean" && /* @__PURE__ */ React.createElement(Card, { label: T && T.friendsSettings || "Friends" }, /* @__PURE__ */ React.createElement("label", { style: { display: "flex", alignItems: "center", gap: 13, padding: "14px 16px", cursor: "pointer" } }, /* @__PURE__ */ React.createElement(
     "input",
     {
       type: "checkbox",
@@ -2822,6 +2905,112 @@ function ProfileTab({ T, me, onEdit }) {
   } }));
 }
 Object.assign(window, { ProfileTab });
+function DkDirAvatar({ p, size }) {
+  const [broken, setBroken] = React.useState(false);
+  if (p.avatar && !broken) {
+    return /* @__PURE__ */ React.createElement(
+      "img",
+      {
+        src: p.avatar,
+        alt: "",
+        width: size,
+        height: size,
+        onError: () => setBroken(true),
+        style: { width: size, height: size, borderRadius: Math.round(size / 4), objectFit: "cover", flexShrink: 0, background: "var(--panel-2)" }
+      }
+    );
+  }
+  return /* @__PURE__ */ React.createElement(DkIdenticon, { seed: p.userid || p.name, size, radius: Math.round(size / 4) });
+}
+function DkDirRow({ p, T, isFriend, isMe, onAdd, onOpenChat }) {
+  const [state, setState] = React.useState(null);
+  const add = () => {
+    setState("busy");
+    Promise.resolve(onAdd(p.address)).then((r) => setState(r && r.ok === false ? r.error || T.addFailed || "failed" : "sent")).catch((e) => setState(String(e && e.message || e)));
+  };
+  const btn = (label, onClick, disabled) => /* @__PURE__ */ React.createElement(
+    "button",
+    {
+      onClick,
+      disabled,
+      style: {
+        padding: "5px 11px",
+        borderRadius: 8,
+        border: "1px solid var(--line)",
+        flexShrink: 0,
+        background: disabled ? "transparent" : "var(--accent)",
+        color: disabled ? "var(--faint)" : "#fff",
+        fontFamily: "var(--ui)",
+        fontSize: 12,
+        cursor: disabled ? "default" : "pointer"
+      }
+    },
+    label
+  );
+  return /* @__PURE__ */ React.createElement("div", { style: { display: "flex", alignItems: "center", gap: 11, padding: "var(--row-pad)", borderBottom: "1px solid var(--line)" } }, /* @__PURE__ */ React.createElement(DkDirAvatar, { p, size: 34 }), /* @__PURE__ */ React.createElement("div", { style: { flex: 1, minWidth: 0, display: "flex", flexDirection: "column", gap: 2 } }, /* @__PURE__ */ React.createElement("div", { style: { display: "flex", alignItems: "baseline", gap: 8, minWidth: 0 } }, /* @__PURE__ */ React.createElement("span", { style: { fontFamily: "var(--ui)", fontSize: 13.5, fontWeight: 600, color: "var(--text)", whiteSpace: "nowrap", overflow: "hidden", textOverflow: "ellipsis" } }, p.name), p.points != null && /* @__PURE__ */ React.createElement("span", { style: { fontFamily: "var(--mono)", fontSize: 11, color: "var(--accent)", flexShrink: 0 } }, p.points.toLocaleString(), " pts"), p.ens && p.ens !== p.name && /* @__PURE__ */ React.createElement("span", { style: { fontFamily: "var(--mono)", fontSize: 11, color: "var(--faint)", whiteSpace: "nowrap", overflow: "hidden", textOverflow: "ellipsis" } }, p.ens)), /* @__PURE__ */ React.createElement("div", { style: { display: "flex", alignItems: "center", gap: 8, minWidth: 0 } }, /* @__PURE__ */ React.createElement(Mono, { size: 10.5, dim: true, copy: p.userid, title: p.userid }, shortKey(p.userid, 10, 6)), p.description && /* @__PURE__ */ React.createElement("span", { style: { fontFamily: "var(--ui)", fontSize: 11, color: "var(--faint)", whiteSpace: "nowrap", overflow: "hidden", textOverflow: "ellipsis" } }, p.description))), isMe ? /* @__PURE__ */ React.createElement(Tag, null, T.dirMe || "me") : isFriend ? btn(T.dirOpenChat || "chat", () => onOpenChat(p.userid), false) : state === "sent" ? /* @__PURE__ */ React.createElement(Tag, { tone: "accent" }, T.dirSent || "requested") : state && state !== "busy" ? /* @__PURE__ */ React.createElement("span", { title: state, style: { fontFamily: "var(--ui)", fontSize: 11, color: "var(--warn, #f59e0b)", flexShrink: 0 } }, T.addFailed || "failed") : btn(state === "busy" ? "\u2026" : T.dirAdd || "Add", add, state === "busy"));
+}
+function DiscoverTab({ T, kind, peers, meId, onAdd, onOpenChat }) {
+  const [list, setList] = React.useState(null);
+  const [err, setErr] = React.useState(null);
+  const [q, setQ] = React.useState("");
+  React.useEffect(() => {
+    let dead = false;
+    setList(null);
+    setErr(null);
+    fetch(kind === "recommended" ? "/api/discover-recommended" : "/api/discover-registered").then((r) => r.json()).then((d) => {
+      if (dead)
+        return;
+      if (d.ok)
+        setList(d.list || []);
+      else
+        setErr(d.error || "load failed");
+    }).catch((e) => {
+      if (!dead)
+        setErr(String(e && e.message || e));
+    });
+    return () => {
+      dead = true;
+    };
+  }, [kind]);
+  const friendIds = React.useMemo(() => {
+    const s = /* @__PURE__ */ new Set();
+    for (const p of peers || []) {
+      if (p.id)
+        s.add(p.id);
+      if (p.userId)
+        s.add(p.userId);
+    }
+    return s;
+  }, [peers]);
+  const shown = React.useMemo(() => {
+    if (!list)
+      return [];
+    const needle = q.trim().toLowerCase();
+    if (!needle)
+      return list;
+    return list.filter((p) => (p.name || "").toLowerCase().includes(needle) || (p.ens || "").toLowerCase().includes(needle) || (p.userid || "").toLowerCase().includes(needle));
+  }, [list, q]);
+  return /* @__PURE__ */ React.createElement("div", { style: { flex: 1, minHeight: 0, display: "flex", flexDirection: "column", background: "var(--bg)" } }, /* @__PURE__ */ React.createElement("div", { style: { flexShrink: 0, display: "flex", alignItems: "center", gap: 10, padding: "10px 14px", borderBottom: "1px solid var(--line)", background: "var(--panel)" } }, /* @__PURE__ */ React.createElement(Icon, { name: "search", size: 15, stroke: 2, color: "var(--faint)" }), /* @__PURE__ */ React.createElement(
+    "input",
+    {
+      value: q,
+      onChange: (e) => setQ(e.target.value),
+      placeholder: T.dirSearch || "search name / userid",
+      style: { flex: 1, background: "transparent", border: "none", outline: "none", color: "var(--text)", fontFamily: "var(--ui)", fontSize: 13 }
+    }
+  ), list && /* @__PURE__ */ React.createElement("span", { style: { fontFamily: "var(--mono)", fontSize: 11.5, color: "var(--faint)" } }, shown.length, "/", list.length)), /* @__PURE__ */ React.createElement("div", { style: { flex: 1, minHeight: 0, overflowY: "auto" } }, err ? /* @__PURE__ */ React.createElement("div", { style: { padding: 22, fontFamily: "var(--ui)", fontSize: 12.5, color: "var(--faint)" } }, (T.dirError || "Could not load the directory:") + " " + err) : !list ? /* @__PURE__ */ React.createElement("div", { style: { padding: 22, fontFamily: "var(--ui)", fontSize: 12.5, color: "var(--faint)" } }, T.dirLoading || "loading\u2026") : shown.length === 0 ? /* @__PURE__ */ React.createElement("div", { style: { padding: 22, fontFamily: "var(--ui)", fontSize: 12.5, color: "var(--faint)" } }, T.dirEmpty || "nobody here") : shown.map((p) => /* @__PURE__ */ React.createElement(
+    DkDirRow,
+    {
+      key: p.userid,
+      p,
+      T,
+      isMe: !!meId && p.userid === meId,
+      isFriend: friendIds.has(p.userid),
+      onAdd,
+      onOpenChat
+    }
+  ))));
+}
 const DK_FILE_RTC_KIND = "file";
 const DK_FILE_RTC_CHUNK = 16 * 1024;
 const DK_FILE_RTC_OPEN_TIMEOUT_MS = 2e4;
@@ -3645,7 +3834,17 @@ const STR = {
     chat: "Chat",
     network: "Network",
     profile: "Profile",
-    addPlaceholder: "paste a friend's carrier address\u2026",
+    recommended: "Discover",
+    registered: "Names",
+    dirAdd: "Add",
+    dirSent: "requested",
+    dirOpenChat: "chat",
+    dirMe: "me",
+    dirSearch: "search name / userid\u2026",
+    dirLoading: "loading directory\u2026",
+    dirEmpty: "nobody matches",
+    dirError: "Could not load the directory:",
+    addPlaceholder: "carrier address or name.beagles.eth\u2026",
     add: "Add",
     search: "search peers / ip\u2026",
     addSending: "sending friend-request\u2026",
@@ -3716,6 +3915,20 @@ const STR = {
     userId: "user id",
     carrierAddr: "carrier address",
     netKey: "network key",
+    ensCard: "Name \xB7 beagles.eth",
+    ensName: "name",
+    ensPlaceholder: "yourname",
+    ensRegister: "register",
+    ensUpdate: "update",
+    ensDone: "saved",
+    ensEth: "ethereum",
+    ensSol: "solana",
+    ensBind: "bind",
+    ensRebind: "rebind",
+    ensNotBound: "not bound",
+    ensNoEthWallet: "no Ethereum wallet extension found (MetaMask\u2026)",
+    ensNoSolWallet: "no Solana wallet extension found (Phantom\u2026)",
+    ensWalletOwned: "registered via your mobile wallet as",
     virtualIp: "virtual ip",
     version: "version",
     editProfile: "edit",
@@ -3746,7 +3959,17 @@ const STR = {
     chat: "\u804A\u5929",
     network: "\u7F51\u7EDC",
     profile: "\u6211\u7684",
-    addPlaceholder: "\u7C98\u8D34\u597D\u53CB\u7684 carrier \u5730\u5740\u2026",
+    recommended: "\u63A8\u8350",
+    registered: "\u540D\u5F55",
+    dirAdd: "\u52A0\u597D\u53CB",
+    dirSent: "\u5DF2\u8BF7\u6C42",
+    dirOpenChat: "\u4F1A\u8BDD",
+    dirMe: "\u6211",
+    dirSearch: "\u641C\u7D22\u540D\u5B57 / userid\u2026",
+    dirLoading: "\u6B63\u5728\u52A0\u8F7D\u540D\u5355\u2026",
+    dirEmpty: "\u6CA1\u6709\u5339\u914D\u7684\u4EBA",
+    dirError: "\u540D\u5355\u52A0\u8F7D\u5931\u8D25\uFF1A",
+    addPlaceholder: "carrier \u5730\u5740\u6216 \u540D\u5B57.beagles.eth\u2026",
     add: "\u6DFB\u52A0",
     search: "\u641C\u7D22\u597D\u53CB / IP\u2026",
     addSending: "\u6B63\u5728\u53D1\u9001\u597D\u53CB\u8BF7\u6C42\u2026",
@@ -3817,6 +4040,20 @@ const STR = {
     userId: "\u7528\u6237 ID",
     carrierAddr: "Carrier \u5730\u5740",
     netKey: "\u7F51\u7EDC\u516C\u94A5",
+    ensCard: "\u540D\u5B57 \xB7 beagles.eth",
+    ensName: "\u540D\u5B57",
+    ensPlaceholder: "\u4F60\u7684\u540D\u5B57",
+    ensRegister: "\u6CE8\u518C",
+    ensUpdate: "\u66F4\u65B0",
+    ensDone: "\u5DF2\u4FDD\u5B58",
+    ensEth: "ethereum",
+    ensSol: "solana",
+    ensBind: "\u7ED1\u5B9A",
+    ensRebind: "\u91CD\u65B0\u7ED1\u5B9A",
+    ensNotBound: "\u672A\u7ED1\u5B9A",
+    ensNoEthWallet: "\u672A\u68C0\u6D4B\u5230\u4EE5\u592A\u574A\u94B1\u5305\u63D2\u4EF6(MetaMask \u7B49)",
+    ensNoSolWallet: "\u672A\u68C0\u6D4B\u5230 Solana \u94B1\u5305\u63D2\u4EF6(Phantom \u7B49)",
+    ensWalletOwned: "\u5DF2\u901A\u8FC7\u624B\u673A\u94B1\u5305\u6CE8\u518C\u4E3A",
     virtualIp: "\u865A\u62DF IP",
     version: "\u7248\u672C",
     editProfile: "\u7F16\u8F91",
@@ -4035,10 +4272,12 @@ function DkApp() {
   const onOpenNet = () => setTab("network");
   const nav = [
     { id: "chat", icon: "message", label: T.chat },
+    { id: "recommended", icon: "sparkles", label: T.recommended },
+    { id: "registered", icon: "at", label: T.registered },
     { id: "network", icon: "network", label: T.network },
     { id: "profile", icon: "userRound", label: T.profile }
   ];
-  return /* @__PURE__ */ React.createElement("div", { style: { ...vars, "--row-pad": rowPad, position: "fixed", inset: 0, display: "flex", background: "var(--bg)", color: "var(--text)", fontFamily: "var(--ui)" } }, /* @__PURE__ */ React.createElement("div", { style: { width: 68, flexShrink: 0, borderRight: "1px solid var(--line)", background: "var(--rail)", display: "flex", flexDirection: "column", alignItems: "center", padding: "14px 0", gap: 8 } }, /* @__PURE__ */ React.createElement("div", { style: { width: 38, height: 38, borderRadius: 10, background: "var(--accent)", display: "flex", alignItems: "center", justifyContent: "center", marginBottom: 8 } }, /* @__PURE__ */ React.createElement(Icon, { name: "terminal", size: 20, color: "#fff", stroke: 2.2 })), nav.map((n) => /* @__PURE__ */ React.createElement(RailBtn, { key: n.id, icon: n.icon, label: n.label, active: tab === n.id, soon: n.soon, onClick: () => setTab(n.id) })), /* @__PURE__ */ React.createElement("div", { style: { flex: 1 } }), /* @__PURE__ */ React.createElement("div", { style: { position: "relative" } }, /* @__PURE__ */ React.createElement(DkAvatar, { peer: { ...me, id: me.userId, agent: false }, size: 36, radius: 9 }))), /* @__PURE__ */ React.createElement("div", { style: { flex: 1, minWidth: 0, minHeight: 0, display: "flex", flexDirection: "column" } }, /* @__PURE__ */ React.createElement("div", { style: { height: 46, flexShrink: 0, borderBottom: "1px solid var(--line)", background: "var(--panel)", display: "flex", alignItems: "center", gap: 12, padding: "0 16px" } }, /* @__PURE__ */ React.createElement("svg", { width: 20, height: 20, viewBox: "0 0 24 24", fill: "none", stroke: "var(--accent)", strokeWidth: 2.2, strokeLinecap: "round", strokeLinejoin: "round", style: { display: "block", flexShrink: 0 } }, /* @__PURE__ */ React.createElement("path", { d: "m4.5 17 6-6-6-6" }), /* @__PURE__ */ React.createElement("path", { d: "M12 18.5h7.5" })), /* @__PURE__ */ React.createElement("span", { style: { fontFamily: "var(--mono)", fontSize: 14, fontWeight: 700, letterSpacing: -0.3, color: "var(--text)" } }, "beagle"), /* @__PURE__ */ React.createElement("span", { style: { fontFamily: "var(--mono)", fontSize: 12, color: "var(--faint)" } }, "\xB7 ", nav.find((n) => n.id === tab).label.toLowerCase()), /* @__PURE__ */ React.createElement("div", { style: { flex: 1 } }), /* @__PURE__ */ React.createElement(Tag, { tone: "accent" }, me.channel, " \xB7 lan ", me.lanVer), /* @__PURE__ */ React.createElement("div", { style: { display: "flex", alignItems: "center", gap: 7, padding: "0 4px" } }, /* @__PURE__ */ React.createElement(StatusDot, { online: me.online }), /* @__PURE__ */ React.createElement(Mono, { size: 12.5, copy: me.ip }, me.ip)), /* @__PURE__ */ React.createElement("span", { style: { width: 1, height: 22, background: "var(--line)" } }), /* @__PURE__ */ React.createElement("div", { style: { display: "flex", alignItems: "center", gap: 8 } }, /* @__PURE__ */ React.createElement(DkAvatar, { peer: { ...me, id: me.userId, agent: false }, size: 26, radius: 7 }), /* @__PURE__ */ React.createElement("span", { style: { fontFamily: "var(--mono)", fontSize: 12.5, fontWeight: 600, color: "var(--text)" } }, me.name))), tab === "chat" && /* @__PURE__ */ React.createElement(ChatTab, { T, lang: t.lang, peers, requests, activeId, thread: data.threads[activeId], onSelect, onAct, onAdd, onSend, onSendFile, onSendRtcFile, onAlias, onRemove, onOpenNet, onCall, onReloadThread: () => activeId && data.loadThread(activeId), prefillAddr: pendingAddr, onPrefillConsumed: () => setPendingAddr("") }), tab === "network" && /* @__PURE__ */ React.createElement(NetworkTab, { T, me, peers, exits, activeExit, reqCount: requests.length, onSetExit, onOpenChat, backend, onArmLan: armLan, onCancelLan: cancelLan }), tab === "profile" && /* @__PURE__ */ React.createElement(ProfileTab, { T, me, onEdit })), /* @__PURE__ */ React.createElement(TweaksPanel, null, /* @__PURE__ */ React.createElement(TweakSection, { label: t.lang === "zh" ? "\u5916\u89C2" : "Appearance" }), /* @__PURE__ */ React.createElement(
+  return /* @__PURE__ */ React.createElement("div", { style: { ...vars, "--row-pad": rowPad, position: "fixed", inset: 0, display: "flex", background: "var(--bg)", color: "var(--text)", fontFamily: "var(--ui)" } }, /* @__PURE__ */ React.createElement("div", { style: { width: 68, flexShrink: 0, borderRight: "1px solid var(--line)", background: "var(--rail)", display: "flex", flexDirection: "column", alignItems: "center", padding: "14px 0", gap: 8 } }, /* @__PURE__ */ React.createElement("div", { style: { width: 38, height: 38, borderRadius: 10, background: "var(--accent)", display: "flex", alignItems: "center", justifyContent: "center", marginBottom: 8 } }, /* @__PURE__ */ React.createElement(Icon, { name: "terminal", size: 20, color: "#fff", stroke: 2.2 })), nav.map((n) => /* @__PURE__ */ React.createElement(RailBtn, { key: n.id, icon: n.icon, label: n.label, active: tab === n.id, soon: n.soon, onClick: () => setTab(n.id) })), /* @__PURE__ */ React.createElement("div", { style: { flex: 1 } }), /* @__PURE__ */ React.createElement("div", { style: { position: "relative" } }, /* @__PURE__ */ React.createElement(DkAvatar, { peer: { ...me, id: me.userId, agent: false }, size: 36, radius: 9 }))), /* @__PURE__ */ React.createElement("div", { style: { flex: 1, minWidth: 0, minHeight: 0, display: "flex", flexDirection: "column" } }, /* @__PURE__ */ React.createElement("div", { style: { height: 46, flexShrink: 0, borderBottom: "1px solid var(--line)", background: "var(--panel)", display: "flex", alignItems: "center", gap: 12, padding: "0 16px" } }, /* @__PURE__ */ React.createElement("svg", { width: 20, height: 20, viewBox: "0 0 24 24", fill: "none", stroke: "var(--accent)", strokeWidth: 2.2, strokeLinecap: "round", strokeLinejoin: "round", style: { display: "block", flexShrink: 0 } }, /* @__PURE__ */ React.createElement("path", { d: "m4.5 17 6-6-6-6" }), /* @__PURE__ */ React.createElement("path", { d: "M12 18.5h7.5" })), /* @__PURE__ */ React.createElement("span", { style: { fontFamily: "var(--mono)", fontSize: 14, fontWeight: 700, letterSpacing: -0.3, color: "var(--text)" } }, "beagle"), /* @__PURE__ */ React.createElement("span", { style: { fontFamily: "var(--mono)", fontSize: 12, color: "var(--faint)" } }, "\xB7 ", nav.find((n) => n.id === tab).label.toLowerCase()), /* @__PURE__ */ React.createElement("div", { style: { flex: 1 } }), /* @__PURE__ */ React.createElement(Tag, { tone: "accent" }, me.channel, " \xB7 lan ", me.lanVer), /* @__PURE__ */ React.createElement("div", { style: { display: "flex", alignItems: "center", gap: 7, padding: "0 4px" } }, /* @__PURE__ */ React.createElement(StatusDot, { online: me.online }), /* @__PURE__ */ React.createElement(Mono, { size: 12.5, copy: me.ip }, me.ip)), /* @__PURE__ */ React.createElement("span", { style: { width: 1, height: 22, background: "var(--line)" } }), /* @__PURE__ */ React.createElement("div", { style: { display: "flex", alignItems: "center", gap: 8 } }, /* @__PURE__ */ React.createElement(DkAvatar, { peer: { ...me, id: me.userId, agent: false }, size: 26, radius: 7 }), /* @__PURE__ */ React.createElement("span", { style: { fontFamily: "var(--mono)", fontSize: 12.5, fontWeight: 600, color: "var(--text)" } }, me.name))), tab === "chat" && /* @__PURE__ */ React.createElement(ChatTab, { T, lang: t.lang, peers, requests, activeId, thread: data.threads[activeId], onSelect, onAct, onAdd, onSend, onSendFile, onSendRtcFile, onAlias, onRemove, onOpenNet, onCall, onReloadThread: () => activeId && data.loadThread(activeId), prefillAddr: pendingAddr, onPrefillConsumed: () => setPendingAddr("") }), tab === "recommended" && /* @__PURE__ */ React.createElement(DiscoverTab, { T, kind: "recommended", peers, meId: me.userId, onAdd, onOpenChat }), tab === "registered" && /* @__PURE__ */ React.createElement(DiscoverTab, { T, kind: "registered", peers, meId: me.userId, onAdd, onOpenChat }), tab === "network" && /* @__PURE__ */ React.createElement(NetworkTab, { T, me, peers, exits, activeExit, reqCount: requests.length, onSetExit, onOpenChat, backend, onArmLan: armLan, onCancelLan: cancelLan }), tab === "profile" && /* @__PURE__ */ React.createElement(ProfileTab, { T, me, onEdit })), /* @__PURE__ */ React.createElement(TweaksPanel, null, /* @__PURE__ */ React.createElement(TweakSection, { label: t.lang === "zh" ? "\u5916\u89C2" : "Appearance" }), /* @__PURE__ */ React.createElement(
     TweakRadio,
     {
       label: t.lang === "zh" ? "\u4E3B\u9898" : "Theme",

package/dist/server.js

@@ -29,6 +29,88 @@ const DESKTOP_DIR = join(dirname(fileURLToPath(import.meta.url)), "desktop");
 // (which probes all exits on each poll) stays responsive over a lossy mesh.
 const EXIT_PROBE_PORT = 8888;
 const EXIT_PROBE_TIMEOUT_MS = 2000;
+/** Server-side fetch for the discovery directories (leaderboard / ENS names),
+ *  with a small TTL cache so tab switches don't hammer the upstreams. */
+const DISCOVER_CACHE_TTL_MS = 5 * 60_000;
+const discoverCache = new Map();
+async function fetchDiscoverJson(url) {
+    const hit = discoverCache.get(url);
+    if (hit && Date.now() - hit.at < DISCOVER_CACHE_TTL_MS)
+        return hit.body;
+    const ctl = new AbortController();
+    const timer = setTimeout(() => ctl.abort(), 10_000);
+    try {
+        const r = await fetch(url, { signal: ctl.signal });
+        if (!r.ok)
+            throw new Error(`upstream ${r.status}`);
+        const body = await r.json();
+        discoverCache.set(url, { at: Date.now(), body });
+        return body;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+// ── beagles.eth names (ens-gateway worker) ──────────────────────────────────
+// The same registry the mobile apps register into. Web-side registration
+// signs the record with THIS node's Carrier identity (XEdDSA via the backend
+// `sign` op) — the gateway verifies it the same way Sign in with Decent does.
+const ENS_GATEWAY = process.env.BEAGLE_ENS_GATEWAY || "https://ens-gateway.beaglechat.workers.dev";
+async function ensFetchJson(path) {
+    const ctl = new AbortController();
+    const timer = setTimeout(() => ctl.abort(), 10_000);
+    try {
+        const r = await fetch(`${ENS_GATEWAY}${path}`, { signal: ctl.signal });
+        if (!r.ok)
+            return null;
+        const d = (await r.json());
+        return d && typeof d === "object" && d.name ? d : null;
+    }
+    catch {
+        return null;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/** Sign a name record with the Carrier identity and POST it to the gateway.
+ *  The record itself (as a JSON string) is what gets signed; the gateway
+ *  re-parses `signature.message` and verifies against `owner` inside it. */
+async function ensSignAndSet(call, record) {
+    const message = JSON.stringify(record);
+    const signed = await call({ op: "sign", text: message });
+    if (!signed.ok)
+        return { ok: false, error: signed.error || "identity sign failed" };
+    const sig = signed.data?.sig ?? "";
+    if (!sig)
+        return { ok: false, error: "identity sign returned no signature" };
+    const payload = {
+        ...record,
+        expiration: Math.floor(Date.now() / 1000) + 3600,
+        signature: { hash: sig, signerAddress: record.owner, message },
+    };
+    const ctl = new AbortController();
+    const timer = setTimeout(() => ctl.abort(), 15_000);
+    try {
+        const r = await fetch(`${ENS_GATEWAY}/set`, {
+            method: "POST",
+            headers: { "content-type": "application/json" },
+            body: JSON.stringify(payload),
+            signal: ctl.signal,
+        });
+        const d = (await r.json().catch(() => null));
+        if (!r.ok || !d?.success) {
+            return { ok: false, error: typeof d?.error === "string" ? d.error : `gateway HTTP ${r.status}` };
+        }
+        return { ok: true };
+    }
+    catch (e) {
+        return { ok: false, error: e instanceof Error ? e.message : String(e) };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
 /** True only when the request came from the local machine. Used to gate the
  *  "Sign in with Decent" routes so binding the UI to a LAN IP can't expose
  *  identity signing to other hosts. The popup always runs in the local user's
@@ -342,6 +424,116 @@ export function startBeagleServer(opts) {
                 });
                 return;
             }
+            // ── beagles.eth name registration ──
+            // Register/update this node's *.beagles.eth name and bind wallet
+            // addresses into the record. The write routes trigger identity
+            // signatures, so they're LOCALHOST-ONLY like /connect.
+            if (url === "/api/ens-register" || url === "/api/ens-bind-wallet") {
+                if (!isLocalRequest(req)) {
+                    sendJson(res, 403, { ok: false, error: "identity signing is available only on this machine (localhost)" });
+                    return;
+                }
+            }
+            if (req.method === "GET" && url === "/api/ens-name") {
+                const diag = await opts.call({ op: "diag" });
+                const identity = (diag.ok ? diag.data?.identity : null) ?? {};
+                if (!identity.userid) {
+                    sendJson(res, 502, { ok: false, error: "identity unavailable" });
+                    return;
+                }
+                const rec = await ensFetchJson(`/getAddress/${encodeURIComponent(identity.userid)}`);
+                sendJson(res, 200, { ok: true, registered: !!rec, record: rec, mineOwned: !!rec && rec.owner === identity.userid });
+                return;
+            }
+            if (req.method === "POST" && url === "/api/ens-register") {
+                const body = await readBody(req);
+                const rawName = typeof body.name === "string" ? body.name.trim().toLowerCase() : "";
+                const label = rawName.replace(/\.beagles\.eth$/, "");
+                if (!/^[a-z0-9-]{1,63}$/.test(label)) {
+                    sendJson(res, 400, { ok: false, error: "name must be 1-63 chars of a-z, 0-9, hyphen" });
+                    return;
+                }
+                const fullName = `${label}.beagles.eth`;
+                const diag = await opts.call({ op: "diag" });
+                const identity = (diag.ok ? diag.data?.identity : null) ?? {};
+                if (!identity.userid || !identity.address) {
+                    sendJson(res, 502, { ok: false, error: "identity unavailable" });
+                    return;
+                }
+                const existing = await ensFetchJson(`/get/${encodeURIComponent(fullName)}`);
+                if (existing && existing.owner !== identity.userid) {
+                    sendJson(res, 409, { ok: false, error: `'${fullName}' is already taken` });
+                    return;
+                }
+                // Carry wallet binds forward: from the same record on update, or from
+                // my previous record when re-registering under a new label.
+                const mine = existing ?? (await ensFetchJson(`/getAddress/${encodeURIComponent(identity.userid)}`));
+                const carried = mine && mine.owner === identity.userid ? mine : null;
+                const displayName = (typeof body.displayName === "string" && body.displayName.trim().slice(0, 64)) || label;
+                const description = (typeof body.description === "string" && body.description.trim().slice(0, 200)) ||
+                    carried?.texts?.description ||
+                    `${displayName}'s Beagle Chat Profile`;
+                const r = await ensSignAndSet(opts.call, {
+                    name: fullName,
+                    owner: identity.userid,
+                    addresses: carried?.addresses ?? {},
+                    texts: {
+                        ...(carried?.texts ?? {}),
+                        description,
+                        displayName,
+                        carrierAddress: identity.address,
+                        carrierUserId: identity.userid,
+                    },
+                    referee: carried?.referee ?? "",
+                    nft: carried?.nft ?? "",
+                    nftid: carried?.nftid ?? 0,
+                });
+                sendJson(res, r.ok ? 200 : 502, r.ok ? { ok: true, name: fullName } : { ok: false, error: r.error });
+                return;
+            }
+            if (req.method === "POST" && url === "/api/ens-bind-wallet") {
+                const body = await readBody(req);
+                const coinType = body.chain === "eth" ? "60" : body.chain === "sol" ? "501" : null;
+                const addr = typeof body.address === "string" ? body.address.trim() : "";
+                const remove = addr === "";
+                const okAddr = remove
+                    || (coinType === "60" ? /^0x[0-9a-fA-F]{40}$/.test(addr) : /^[1-9A-HJ-NP-Za-km-z]{32,44}$/.test(addr));
+                if (!coinType || !okAddr) {
+                    sendJson(res, 400, { ok: false, error: "invalid chain or address" });
+                    return;
+                }
+                const diag = await opts.call({ op: "diag" });
+                const identity = (diag.ok ? diag.data?.identity : null) ?? {};
+                if (!identity.userid) {
+                    sendJson(res, 502, { ok: false, error: "identity unavailable" });
+                    return;
+                }
+                const mine = await ensFetchJson(`/getAddress/${encodeURIComponent(identity.userid)}`);
+                if (!mine) {
+                    sendJson(res, 404, { ok: false, error: "register a name first" });
+                    return;
+                }
+                if (mine.owner !== identity.userid) {
+                    sendJson(res, 403, { ok: false, error: "this name was registered by your mobile wallet — bind addresses there" });
+                    return;
+                }
+                const addresses = { ...(mine.addresses ?? {}) };
+                if (remove)
+                    delete addresses[coinType];
+                else
+                    addresses[coinType] = addr;
+                const r = await ensSignAndSet(opts.call, {
+                    name: mine.name,
+                    owner: identity.userid,
+                    addresses,
+                    texts: mine.texts ?? {},
+                    referee: mine.referee ?? "",
+                    nft: mine.nft ?? "",
+                    nftid: mine.nftid ?? 0,
+                });
+                sendJson(res, r.ok ? 200 : 502, r.ok ? { ok: true, addresses } : { ok: false, error: r.error });
+                return;
+            }
             // Delete file/chat messages by id (removes their on-disk files too).
             if (req.method === "POST" && url === "/api/file-delete") {
                 const body = await readBody(req);
@@ -619,6 +811,50 @@ export function startBeagleServer(opts) {
                 sendJson(res, 200, { friends });
                 return;
             }
+            // People-discovery directories, proxied server-side: the browser can't
+            // fetch these origins (CORS), and the cache keeps us polite upstream.
+            // recommended = points leaderboard; registered = mobile-app ENS names.
+            if (req.method === "GET" && url === "/api/discover-recommended") {
+                try {
+                    const raw = (await fetchDiscoverJson("https://points.beagle.chat/leaderboard"));
+                    const list = (Array.isArray(raw) ? raw : [])
+                        .map((e) => ({
+                        userid: typeof e.account === "string" ? e.account : "",
+                        address: typeof e.carrier_address === "string" ? e.carrier_address : "",
+                        name: (typeof e.name === "string" && e.name) || (typeof e.ens_name === "string" && e.ens_name) || "",
+                        avatar: typeof e.avatar === "string" && /^https:\/\//.test(e.avatar) ? e.avatar : null,
+                        points: typeof e.points === "number" ? e.points : null,
+                    }))
+                        .filter((e) => e.userid && e.address);
+                    sendJson(res, 200, { ok: true, list });
+                }
+                catch (err) {
+                    sendJson(res, 502, { ok: false, error: String(err?.message ?? err) });
+                }
+                return;
+            }
+            if (req.method === "GET" && url === "/api/discover-registered") {
+                try {
+                    const raw = (await fetchDiscoverJson("https://ens-gateway.beaglechat.workers.dev/names"));
+                    const list = Object.entries(raw && typeof raw === "object" ? raw : {})
+                        .map(([ens, v]) => {
+                        const t = v?.texts ?? {};
+                        return {
+                            userid: t.carrierUserId ?? "",
+                            address: t.carrierAddress ?? "",
+                            name: t.displayName || ens,
+                            ens,
+                            description: t.description || null,
+                        };
+                    })
+                        .filter((e) => e.userid && e.address);
+                    sendJson(res, 200, { ok: true, list });
+                }
+                catch (err) {
+                    sendJson(res, 502, { ok: false, error: String(err?.message ?? err) });
+                }
+                return;
+            }
             // One bootstrap call for the desktop UI: composes the design's DK_*
             // shapes (me / peers / requests / exits) from diag + friends-list +
             // ipam + routes, so the client data layer is a single poll.
@@ -990,6 +1226,31 @@ export function startBeagleServer(opts) {
             }
             if (req.method === "POST" && url === "/api/add") {
                 let { address } = await readBody(req);
+                // Accept a *.beagles.eth name (or bare label): resolve it to the
+                // Carrier address via the ens-gateway registry the mobile apps
+                // register into. Anything with a dot/space or too short to be a
+                // userid (44) / address (52) is treated as a name.
+                {
+                    const raw = String(address ?? "").trim();
+                    if (raw && (raw.includes(".") || raw.includes(" ") || raw.length < 40)) {
+                        const full = raw.includes(".") ? raw : `${raw}.beagles.eth`;
+                        const norm = (s) => s.toLowerCase().replace(/\s+/g, "");
+                        try {
+                            const names = (await fetchDiscoverJson("https://ens-gateway.beaglechat.workers.dev/names"));
+                            const hit = Object.entries(names ?? {}).find(([k]) => norm(k) === norm(full));
+                            const carrier = hit?.[1]?.texts?.carrierAddress;
+                            if (!carrier) {
+                                sendJson(res, 400, { ok: false, error: `name '${full}' is not registered on beagles.eth` });
+                                return;
+                            }
+                            address = carrier;
+                        }
+                        catch (e) {
+                            sendJson(res, 502, { ok: false, error: `name lookup failed: ${e instanceof Error ? e.message : String(e)}` });
+                            return;
+                        }
+                    }
+                }
                 // Accept a 44-char userid too: the address is userid's pubkey plus a
                 // derivable suffix (nospam=0 network-wide + checksum), and users
                 // frequently have only the userid — it's what every other surface

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decentnetwork/beagle",
-  "version": "0.1.17",
+  "version": "0.1.19",
   "description": "Beagle — P2P chat, file transfer and calls for regular users, on the Decent Network. No admin privilege required.",
   "type": "module",
   "main": "./dist/index.js",