@glyphteck/veyl 0.35.0 → 1.0.0

package/dist/cli.js

@@ -447,6 +447,34 @@ var init_legal = __esm(() => {
   };
 });
 
+// ../../shared/actioncopy.js
+var ACCOUNT_DELETE_PREPARE = "you should export or empty your wallet first.", ACCOUNT_DELETE_CONDITION = "if you delete your account,", ACCOUNT_DELETE_CONSEQUENCE = "you will permanently lose access to your funds and chats.", PASSKEY_DELETE_PENDING = "deleting a pending link disables it.", PASSKEY_DELETE_VERIFIED = "deleting a verified passkey will log out any session currently using it.", PASSKEY_DELETE_LIMITS = "you can’t delete the passkey used by this session or the account’s last passkey.", ACCOUNT_DELETE_COPY, BLOCK_USER_BODY = "they will no longer be able to message you, and this chat will be permanently deleted.", UNBLOCK_USER_BODY = "they will be able to message you again.", CHAT_DELETE_BODY = "this chat will be permanently deleted.", PASSKEY_DELETE_COPY, WALLET_EXPORT_COPY, WITHDRAWAL_COPY, LOGOUT_ALL_DEVICES_BODY = "This will sign your account out on every connected device. If you suspect someone else has access, logging out may not be enough: they may already have copied your wallet recovery phrase or other sensitive information. Move your funds to a safe wallet only you control as soon as possible, then remove sensitive information from this account. Information already copied to another device cannot be erased remotely.";
+var init_actioncopy = __esm(() => {
+  ACCOUNT_DELETE_COPY = Object.freeze({
+    prepare: ACCOUNT_DELETE_PREPARE,
+    condition: ACCOUNT_DELETE_CONDITION,
+    consequence: ACCOUNT_DELETE_CONSEQUENCE,
+    body: `${ACCOUNT_DELETE_PREPARE} ${ACCOUNT_DELETE_CONDITION} ${ACCOUNT_DELETE_CONSEQUENCE}`
+  });
+  PASSKEY_DELETE_COPY = Object.freeze({
+    pendingBody: PASSKEY_DELETE_PENDING,
+    body: PASSKEY_DELETE_VERIFIED,
+    description: `${PASSKEY_DELETE_PENDING} ${PASSKEY_DELETE_VERIFIED}`,
+    infoBody: `${PASSKEY_DELETE_PENDING} ${PASSKEY_DELETE_LIMITS} ${PASSKEY_DELETE_VERIFIED}`
+  });
+  WALLET_EXPORT_COPY = Object.freeze({
+    networkLead: "this is not a bitcoin wallet.",
+    networkBody: "you cannot use it like a normal bitcoin wallet. you can only use it with the spark network: with a new account on this platform, on a different platform that uses spark wallets, or directly through the spark sdk.",
+    withdrawBody: "if you do not want to use this account anymore, withdraw your funds back to a bitcoin wallet instead.",
+    secretBody: "the mnemonic gives full control of this Spark wallet. reveal it only somewhere private."
+  });
+  WITHDRAWAL_COPY = Object.freeze({
+    feeBody: "you can withdraw your funds back to any bitcoin address. bitcoin transactions are not free. validators need to get paid.",
+    reviewBody: "veyl gets a live Spark withdrawal quote after you press withdraw. review the destination address, the amount leaving your wallet, the quoted fee, and the amount that reaches the address before confirming.",
+    irreversibleBody: "once confirmed, bitcoin withdrawals are irreversible."
+  });
+});
+
 // src/commands.js
 import { Buffer as Buffer2 } from "node:buffer";
 import { chmod, readFile, writeFile } from "node:fs/promises";
@@ -614,6 +642,7 @@ function cliHelpLines() {
 }
 var stringProp, numberProp, booleanProp, objectProp, stringArrayProp, MIME_BY_EXTENSION, TYPE_BY_MIME, optionsOnly = (_args, context) => ({ ...context.commandOptions }), firstArg = (key) => (args, context) => ({ ...context.commandOptions, [key]: args[0] }), peerInput, peerMessageInput = (args, context) => ({ ...context.commandOptions, peer: args[0], message: args.slice(1).join(" ") }), peerMessageIdInput = (args, context) => ({ ...context.commandOptions, peer: args[0], messageId: args[1] }), peerCidInput = (args, context) => ({ ...context.commandOptions, peer: args[0], cid: args[1] }), peerMessageActionInput = (args, context) => ({ ...context.commandOptions, peer: args[0], messageId: args[1], message: args.slice(2).join(" ") }), peerEmojiInput = (args, context) => ({ ...context.commandOptions, peer: args[0], messageId: args[1], emoji: args.slice(2).join(" ") }), peerSatsInput = (args, context) => ({ ...context.commandOptions, peer: args[0], sats: args[1] }), invoiceInput, requestInput, idInput, withdrawalInput = (args, context) => ({ ...context.commandOptions, address: args[0], sats: args[1] }), inviteLinkInput = (args, context) => ({ ...context.commandOptions, kind: args[0], sats: args[1] }), HEADLESS_COMMANDS, commandByName, cliPaths, MCP_TOOLS, groups, COMMANDS;
 var init_commands = __esm(() => {
+  init_actioncopy();
   stringProp = Object.freeze({ type: "string" });
   numberProp = Object.freeze({ type: "number" });
   booleanProp = Object.freeze({ type: "boolean" });
@@ -690,12 +719,12 @@ var init_commands = __esm(() => {
       invokeCli: async (client, input, context) => client.account.acceptTerms({ ...input, termsVersion: await context.acceptTerms(input.termsVersion) })
     }),
     command({ name: "account_logout", group: "account", apiName: "logout", description: "Lock and sign out this runtime.", usage: "account logout", cliInput: optionsOnly, access: "write", invoke: (client) => client.account.logout() }),
-    command({ name: "account_logout_all", group: "account", apiName: "logoutAll", description: "Revoke all product auth sessions.", usage: "account logout-all", cliInput: optionsOnly, access: "destructive", invoke: (client) => client.account.logoutAll() }),
-    command({ name: "account_delete", group: "account", apiName: "delete", description: "Delete the account, chats, and local profile.", properties: { confirm: booleanProp }, required: ["confirm"], usage: "account delete", cliInput: optionsOnly, access: "destructive", invoke: (client, input) => client.account.delete(input) }),
+    command({ name: "account_logout_all", group: "account", apiName: "logoutAll", description: LOGOUT_ALL_DEVICES_BODY, usage: "account logout-all", cliInput: optionsOnly, access: "destructive", invoke: (client) => client.account.logoutAll() }),
+    command({ name: "account_delete", group: "account", apiName: "delete", description: ACCOUNT_DELETE_COPY.body, properties: { confirm: booleanProp }, required: ["confirm"], usage: "account delete", cliInput: optionsOnly, access: "destructive", invoke: (client, input) => client.account.delete(input) }),
     command({ name: "vault_create", group: "vault", apiName: "create", description: "Create and upload a locally encrypted vault.", properties: { secret: stringProp, saveSecret: booleanProp }, usage: "vault create", cliInput: vaultInput, access: "write", secret: true, invoke: (client, input) => client.vault.create(input) }),
     command({ name: "vault_unlock", group: "vault", apiName: "unlock", description: "Unlock the local vault.", properties: { secret: stringProp }, usage: "vault unlock", cliInput: vaultInput, access: "write", secret: true, invoke: (client, input) => client.vault.unlock(input) }),
     command({ name: "vault_lock", group: "vault", apiName: "lock", description: "Lock wallet and chat state.", usage: "vault lock", cliInput: optionsOnly, access: "write", invoke: (client) => client.vault.lock() }),
-    command({ name: "vault_export", group: "vault", apiName: "export", description: "Export the Spark wallet mnemonic.", properties: { secret: stringProp }, usage: "vault export", cliInput: vaultInput, mcp: false, secret: true, invoke: (client, input) => client.vault.export(input) }),
+    command({ name: "vault_export", group: "vault", apiName: "export", description: WALLET_EXPORT_COPY.secretBody, properties: { secret: stringProp }, usage: "vault export", cliInput: vaultInput, mcp: false, secret: true, invoke: (client, input) => client.vault.export(input) }),
     command({ name: "profile_show", group: "profile", apiName: "show", description: "Show the public account profile.", usage: "profile show", cliInput: optionsOnly, invoke: (client) => client.profile.show() }),
     command({
       name: "profile_avatar_set",
@@ -721,8 +750,8 @@ var init_commands = __esm(() => {
     command({ name: "peers_search", group: "peers", apiName: "search", description: "Search public Veyl profiles.", properties: { query: stringProp, count: numberProp }, required: ["query"], usage: "peers search <query>", cliInput: (args, context) => ({ ...context.commandOptions, query: args.join(" ") }), invoke: (client, input) => client.peers.search(input.query, input) }),
     command({ name: "peers_list", group: "peers", apiName: "list", description: "List recent peers.", properties: { count: numberProp, recent: booleanProp }, usage: "peers list", cliInput: optionsOnly, invoke: (client, input) => client.peers.list(input) }),
     command({ name: "peers_blocked", group: "peers", apiName: "blocked", description: "List blocked peers.", usage: "peers blocked", cliInput: optionsOnly, invoke: (client) => client.peers.blocked() }),
-    command({ name: "peers_block", group: "peers", apiName: "block", description: "Block a peer and hide their local chat.", properties: { peer: stringProp }, required: ["peer"], usage: "peers block @name", cliInput: peerInput, access: "destructive", invoke: (client, input) => client.peers.block(input.peer) }),
-    command({ name: "peers_unblock", group: "peers", apiName: "unblock", description: "Unblock a peer.", properties: { peer: stringProp }, required: ["peer"], usage: "peers unblock @name", cliInput: peerInput, access: "write", invoke: (client, input) => client.peers.unblock(input.peer) }),
+    command({ name: "peers_block", group: "peers", apiName: "block", description: BLOCK_USER_BODY, properties: { peer: stringProp }, required: ["peer"], usage: "peers block @name", cliInput: peerInput, access: "destructive", invoke: (client, input) => client.peers.block(input.peer) }),
+    command({ name: "peers_unblock", group: "peers", apiName: "unblock", description: UNBLOCK_USER_BODY, properties: { peer: stringProp }, required: ["peer"], usage: "peers unblock @name", cliInput: peerInput, access: "write", invoke: (client, input) => client.peers.unblock(input.peer) }),
     command({ name: "chat_list", group: "chat", apiName: "list", description: "List chats.", properties: { count: numberProp }, usage: "chat list", cliInput: optionsOnly, invoke: (client, input) => client.chat.list(input) }),
     command({ name: "chat_messages", group: "chat", apiName: "messages", clientMethods: ["read"], description: "Read messages and mark the latest peer message as read.", properties: { peer: stringProp, count: numberProp }, required: ["peer"], usage: "chat messages @name", cliInput: peerInput, access: "write", invoke: (client, input) => client.chat.read(input.peer, input) }),
     command({ name: "chat_mark_read", group: "chat", apiName: "markRead", description: "Mark the latest peer message as read.", properties: { peer: stringProp }, required: ["peer"], usage: "chat mark-read @name", cliInput: peerInput, access: "write", invoke: (client, input) => client.chat.markRead(input.peer, input) }),
@@ -735,7 +764,7 @@ var init_commands = __esm(() => {
     command({ name: "chat_unsave", group: "chat", apiName: "unsave", description: "Return one message to temporary retention.", properties: { peer: stringProp, messageId: stringProp }, required: ["peer", "messageId"], usage: "chat unsave @name message-id", cliInput: peerMessageIdInput, access: "write", invoke: (client, { peer, messageId, ...options }) => client.chat.unsave(peer, messageId, options) }),
     command({ name: "chat_edit", group: "chat", apiName: "edit", clientMethods: ["update"], description: "Edit a text message you sent.", properties: { peer: stringProp, messageId: stringProp, message: stringProp }, required: ["peer", "messageId", "message"], usage: "chat edit @name message-id message", cliInput: peerMessageActionInput, access: "write", invoke: (client, { peer, messageId, message, ...options }) => client.chat.update(peer, messageId, message, options) }),
     command({ name: "chat_delete_message", group: "chat", apiName: "deleteMessage", clientMethods: ["delete"], description: "Delete one message immediately.", properties: { peer: stringProp, messageId: stringProp }, required: ["peer", "messageId"], usage: "chat delete-message @name message-id", cliInput: peerMessageIdInput, access: "destructive", invoke: (client, { peer, messageId, ...options }) => client.chat.delete(peer, messageId, options) }),
-    command({ name: "chat_delete", group: "chat", apiName: "deleteChat", description: "Delete one chat.", properties: { peer: stringProp, cleanup: booleanProp }, required: ["peer"], usage: "chat delete @name", cliInput: peerInput, access: "destructive", invoke: (client, input) => client.chat.deleteChat(input.peer, input) }),
+    command({ name: "chat_delete", group: "chat", apiName: "deleteChat", description: CHAT_DELETE_BODY, properties: { peer: stringProp, cleanup: booleanProp }, required: ["peer"], usage: "chat delete @name", cliInput: peerInput, access: "destructive", invoke: (client, input) => client.chat.deleteChat(input.peer, input) }),
     command({ name: "chat_retention", group: "chat", apiName: "retention", description: "Set chat retention to seen or 24h.", properties: { peer: stringProp, retention: stringProp }, required: ["peer", "retention"], usage: "chat retention @name seen|24h", cliInput: (args, context) => ({ ...context.commandOptions, peer: args[0], retention: args[1] }), access: "write", invoke: (client, input) => client.chat.retention(input.peer, input.retention, input) }),
     command({
       name: "chat_send_file",
@@ -820,12 +849,12 @@ var init_commands = __esm(() => {
     command({ name: "lightning_send", group: "lightning", apiName: "send", description: "Read a Lightning send request.", properties: { id: stringProp }, required: ["id"], usage: "lightning send id", cliInput: idInput, money: true, invoke: (client, input) => client.lightning.send(input.id, input) }),
     command({ name: "withdrawal_quote", group: "withdrawal", apiName: "quote", description: "Quote an on-chain withdrawal.", properties: { address: stringProp, sats: numberProp }, required: ["address", "sats"], usage: "withdrawal quote address sats", cliInput: withdrawalInput, access: "write", money: true, invoke: (client, input) => client.withdrawal.quote(input.address, input.sats, input) }),
     command({ name: "withdrawal_prepare", group: "withdrawal", apiName: "prepare", description: "Prepare an on-chain withdrawal review.", properties: { address: stringProp, sats: numberProp, speed: stringProp, deductFeeFromWithdrawalAmount: booleanProp }, required: ["address", "sats"], usage: "withdrawal prepare address sats", cliInput: withdrawalInput, access: "write", money: true, invoke: (client, input) => client.withdrawal.prepare(input.address, input.sats, input) }),
-    command({ name: "withdrawal_confirm", group: "withdrawal", apiName: "confirm", description: "Confirm an on-chain withdrawal.", properties: { address: stringProp, sats: numberProp, speed: stringProp, feeQuoteId: stringProp, feeAmountSats: numberProp, deductFeeFromWithdrawalAmount: booleanProp }, required: ["address", "sats"], usage: "withdrawal confirm address sats", cliInput: withdrawalInput, access: "destructive", money: true, invoke: (client, input) => client.withdrawal.confirm(input.address, input.sats, input) }),
+    command({ name: "withdrawal_confirm", group: "withdrawal", apiName: "confirm", description: WITHDRAWAL_COPY.irreversibleBody, properties: { address: stringProp, sats: numberProp, speed: stringProp, feeQuoteId: stringProp, feeAmountSats: numberProp, deductFeeFromWithdrawalAmount: booleanProp }, required: ["address", "sats"], usage: "withdrawal confirm address sats", cliInput: withdrawalInput, access: "destructive", money: true, invoke: (client, input) => client.withdrawal.confirm(input.address, input.sats, input) }),
     command({ name: "invite_link", group: "invite", apiName: "link", description: "Create a join, chat, send, or request invite link.", properties: { kind: stringProp, sats: numberProp }, usage: "invite link [join|chat|send|request] [sats]", cliInput: inviteLinkInput, invoke: (client, input) => client.invite.link(input) }),
     command({ name: "invite_read", group: "invite", apiName: "read", description: "Parse a Veyl invite URL.", properties: { value: stringProp }, required: ["value"], usage: "invite read url", cliInput: firstArg("value"), invoke: (client, input) => client.invite.read(input.value) }),
     command({ name: "passkeys_list", group: "passkeys", apiName: "list", description: "List passkeys and pending links.", usage: "passkeys list", cliInput: optionsOnly, invoke: (client, input) => client.passkeys.list(input) }),
     command({ name: "passkeys_link", group: "passkeys", apiName: "link", clientMethods: ["createLink"], description: "Create a one-time passkey link.", properties: { webUrl: stringProp }, usage: "passkeys link", cliInput: optionsOnly, mcp: false, access: "write", secret: true, invoke: (client, input) => client.passkeys.createLink(input) }),
-    command({ name: "passkeys_delete", group: "passkeys", apiName: "delete", description: "Delete a pending link or verified passkey.", properties: { id: stringProp, webUrl: stringProp }, required: ["id"], usage: "passkeys delete id", cliInput: (args, context) => ({ ...context.commandOptions, id: args[0], webUrl: context.options.webUrl, onUrl: context.onPasskeyUrl }), access: "destructive", invoke: (client, input) => client.passkeys.delete(input.id, input) }),
+    command({ name: "passkeys_delete", group: "passkeys", apiName: "delete", description: PASSKEY_DELETE_COPY.description, properties: { id: stringProp, webUrl: stringProp }, required: ["id"], usage: "passkeys delete id", cliInput: (args, context) => ({ ...context.commandOptions, id: args[0], webUrl: context.options.webUrl, onUrl: context.onPasskeyUrl }), access: "destructive", invoke: (client, input) => client.passkeys.delete(input.id, input) }),
     command({ name: "support_feedback", group: "support", apiName: "feedback", description: "Send product feedback.", properties: { message: stringProp, type: stringProp, context: stringProp }, required: ["message"], usage: "support feedback message", cliInput: (args, context) => ({ ...context.commandOptions, message: args.join(" ") }), access: "write", invoke: (client, input) => client.support.feedback(input.message, input) }),
     command({ name: "support_bug", group: "support", apiName: "bug", description: "Submit a bug report.", properties: { message: stringProp }, required: ["message"], usage: "support bug message", cliInput: (args, context) => ({ ...context.commandOptions, message: args.join(" ") }), access: "write", invoke: (client, input) => client.support.bug(input.message, input) }),
     command({ name: "support_report", group: "support", apiName: "report", description: "Report a peer or one harmful message.", properties: { peer: stringProp, messageId: stringProp, note: stringProp, includeAttachment: booleanProp }, required: ["peer"], usage: "support report @name [message-id]", cliInput: (args, context) => ({ ...context.commandOptions, peer: args[0], messageId: args[1] }), access: "write", invoke: (client, input) => client.support.report(input.peer, input) }),
@@ -980,7 +1009,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "veyl",
-    version: "0.35.0",
+    version: "1.0.0",
     private: true,
     license: "Apache-2.0",
     workspaces: {
@@ -104546,7 +104575,7 @@ var init_config = __esm(() => {
   LOCAL_PROFILE_CACHE_MAX_AGE_MS = 30 * DAY_MS;
   LOCAL_AVATAR_CACHE_MAX_BYTES = 128 * MIB_BYTES;
   LOCAL_AVATAR_CACHE_MAX_AGE_MS = 30 * DAY_MS;
-  AVATAR_IMAGE_MAX_BYTES = 8 * MIB_BYTES;
+  AVATAR_IMAGE_MAX_BYTES = 256 * KIB_BYTES;
   CHAT_READY_DOWNLOAD_MAX_BYTES = 8 * MIB_BYTES;
   CHAT_MESSAGE_FILE_CACHE_MAX_BYTES = 64 * MIB_BYTES;
   CHAT_UNSAVED_TTL_MS = CHAT_UNSAVED_TTL_DAYS * DAY_MS;
@@ -106991,18 +107020,13 @@ var init_values = __esm(() => {
 
 // ../../shared/avatar.js
 function readAvatarVersion(value) {
-  if (value == null || value === "" || typeof value !== "number" && typeof value !== "string") {
-    return null;
-  }
-  const version = Number(value);
-  return Number.isSafeInteger(version) && version >= 0 ? version : null;
+  const version = typeof value === "string" ? value.trim().toLowerCase() : "";
+  return AVATAR_VERSION_RE.test(version) ? version : null;
 }
-function avatarUrlWithVersion(url, version) {
-  if (!url)
-    return null;
-  return version == null ? url : `${url}${url.includes("?") ? "&" : "?"}v=${encodeURIComponent(String(version))}`;
-}
-var init_avatar = () => {};
+var AVATAR_VERSION_RE;
+var init_avatar = __esm(() => {
+  AVATAR_VERSION_RE = /^[0-9a-f]{64}$/;
+});
 
 // ../../shared/moderation.js
 function banUntilMs(ban) {
@@ -107280,11 +107304,16 @@ function createUser({ cloud, network, avatarCache = null, diag = null, onSession
     markDiag(diag, "user.avatar.fetch.start", { force: !!force, persist: !!persist, hasVersion: avatarVersion != null });
     try {
       const promise = (async () => {
-        const nextAvatar = await cloud.peer.avatar.url(uid, { version: avatarVersion });
-        if (persist && avatarVersion != null) {
-          cloud.peer.avatar.read(uid).then((bytes) => writeCachedAvatar(uid, { version: avatarVersion, bytes })).catch(() => {});
+        if (persist && avatarVersion != null && avatarCache && typeof cloud.peer.avatar.read === "function") {
+          try {
+            const bytes = await cloud.peer.avatar.read(uid, { version: avatarVersion });
+            const cachedAvatar = await writeCachedAvatar(uid, { version: avatarVersion, bytes });
+            if (cachedAvatar) {
+              return cachedAvatar;
+            }
+          } catch {}
         }
-        return nextAvatar;
+        return cloud.peer.avatar.url(uid, { version: avatarVersion });
       })().then((nextAvatar) => {
         markDone(diag, "user.avatar.fetch", startedAt, { found: !!nextAvatar, hasVersion: avatarVersion != null });
         if (!nextAvatar || avatarFetch.uid !== uid || avatarFetch.key !== key) {
@@ -107624,10 +107653,12 @@ function createUser({ cloud, network, avatarCache = null, diag = null, onSession
   }
   function refetchAvatar(options = {}) {
     const requestedVersion = readAvatarVersion(options?.version);
-    const optimistic = options?.optimistic === true;
-    const nextVersion = requestedVersion ?? (optimistic && state.avatarVersion != null ? state.avatarVersion + 1 : state.avatarVersion);
-    const persist = options?.persist ?? !(optimistic && requestedVersion == null);
-    return fetchAvatar(state.uid, { force: true, persist, version: nextVersion });
+    const nextVersion = requestedVersion ?? state.avatarVersion;
+    return fetchAvatar(state.uid, {
+      force: options?.force === true || state.avatarVersion !== nextVersion || !state.avatar,
+      persist: options?.persist !== false,
+      version: nextVersion
+    });
   }
   function setNetwork(nextNetwork) {
     if (activeNetwork === nextNetwork)
@@ -110045,7 +110076,7 @@ function sameSigningKeys(left, right) {
 function sameChatShape(a, b) {
   if (!a || !b)
     return a === b;
-  return a.id === b.id && a.protocol === b.protocol && a.linkId === b.linkId && a.entryId === b.entryId && a.peerChatPK === b.peerChatPK && a.peerUid === b.peerUid && sameSigningKeys(a.signingKeysByChatKey, b.signingKeysByChatKey) && a.ts === b.ts && a.startMs === b.startMs && a.unseen === b.unseen && a.settings?.retention === b.settings?.retention && sameChatPreview(a.preview, b.preview);
+  return a.id === b.id && a.protocol === b.protocol && a.linkId === b.linkId && a.entryId === b.entryId && a.peerChatPK === b.peerChatPK && a.peerUid === b.peerUid && sameSigningKeys(a.signingKeysByChatKey, b.signingKeysByChatKey) && a.signerShared === b.signerShared && a.ts === b.ts && a.startMs === b.startMs && a.unseen === b.unseen && a.settings?.retention === b.settings?.retention && sameChatPreview(a.preview, b.preview);
 }
 function sameChats(prev, next) {
   if (prev.length !== next.length)
@@ -110404,8 +110435,10 @@ function emptyPayload() {
     chatsById: {},
     profilesByUid: {},
     mediaByKey: {},
+    walletBalance: null,
     resumeRoute: null,
-    lastCameraFacing: null
+    lastCameraFacing: null,
+    cloaked: false
   };
 }
 function isObject3(value) {
@@ -110466,8 +110499,26 @@ function normalizePayload(value) {
     chatsById: isObject3(input.chatsById) ? input.chatsById : {},
     profilesByUid: isObject3(input.profilesByUid) ? input.profilesByUid : {},
     mediaByKey: isObject3(input.mediaByKey) ? input.mediaByKey : {},
+    walletBalance: cleanWalletBalance(input.walletBalance),
     resumeRoute: cleanResumeRoute(input.resumeRoute),
-    lastCameraFacing: cleanCameraFacing(input.lastCameraFacing)
+    lastCameraFacing: cleanCameraFacing(input.lastCameraFacing),
+    cloaked: input.cloaked === true
+  };
+}
+function cleanWalletBalance(value) {
+  if (!isObject3(value))
+    return null;
+  const walletPK = cleanText(value.walletPK).toLowerCase();
+  const network = cleanText(value.network).toLowerCase();
+  const balance = Number(value.balance);
+  if (!walletPK || !network || !Number.isSafeInteger(balance) || balance < 0) {
+    return null;
+  }
+  return {
+    walletPK,
+    network,
+    balance,
+    savedAt: Number.isFinite(value.savedAt) ? value.savedAt : 0
   };
 }
 function cleanResumeRoute(route) {
@@ -110913,8 +110964,8 @@ function stateFromPayload(payload, { chatId, selfChatPublicKey, peerChatPublicKe
   if (!cleanOlder.length && !cleanLive.length) {
     return { rejectReason: "empty-message-cache" };
   }
-  const historyStartReached = payload.historyStartReached === true && payload.truncated !== true;
-  const payloadHasOlder = historyStartReached ? false : payload.hasOlder === true || payload.truncated === true;
+  const historyStartReached = payload.historyStartReached === true;
+  const payloadHasOlder = payload.hasOlder === true || payload.truncated === true;
   const partialOlderThan = partial ? markerFromMessage(cleanOlder[0]) : null;
   return {
     historyMessages: cleanOlder,
@@ -111059,7 +111110,7 @@ function writeCachedMessageState(cache, { stateVersion = null, chatId, selfChatP
       signingKeysVersion: cleanText(signingKeysVersion),
       savedAt: Date.now(),
       hasOlder: nextHasOlder === true || compacted.truncated,
-      historyStartReached: nextHistoryStartReached === true && compacted.truncated !== true,
+      historyStartReached: nextHistoryStartReached === true,
       olderThan: serializeMarker(storedOlderThan),
       olderLoaded: nextOlderLoaded === true || compacted.historyMessages.length > 0,
       latestServerPage: batchFromLive(compacted.latestMessages, expiredKeys, deletedKeys, nextServerBatch),
@@ -111318,6 +111369,36 @@ var init_chats2 = __esm(() => {
   "use client";
 });
 
+// ../../shared/cache/localdata/balance.js
+function normalizedBalance(value) {
+  const balance = Number(value);
+  return Number.isSafeInteger(balance) && balance >= 0 ? balance : null;
+}
+function writeCachedWalletBalance(cache, { walletPK = null, network = null, balance = null } = {}) {
+  const nextWalletPK = lowerText(walletPK);
+  const nextNetwork = lowerText(network);
+  const nextBalance = normalizedBalance(balance);
+  if (!cache || !nextWalletPK || !nextNetwork || nextBalance == null) {
+    return Promise.resolve(false);
+  }
+  const current = cache.read?.()?.walletBalance;
+  if (sameText(current?.walletPK, nextWalletPK) && sameText(current?.network, nextNetwork) && normalizedBalance(current?.balance) === nextBalance) {
+    return Promise.resolve(false);
+  }
+  return cache.patch((draft) => {
+    draft.walletBalance = {
+      walletPK: nextWalletPK,
+      network: nextNetwork,
+      balance: nextBalance,
+      savedAt: Date.now()
+    };
+    return draft;
+  }).then(() => true);
+}
+var init_balance = __esm(() => {
+  "use client";
+});
+
 // ../../shared/cache/localdata/profiles.js
 function isUsableProfile(profile, now = Date.now()) {
   if (!profile?.uid || !profile.walletPK && !profile.chatPK) {
@@ -111558,24 +111639,26 @@ async function readCachedTransferHeadState(cache, { walletPK = null } = {}) {
   const stored = cache ? await cache.readPart(TX_HEAD_PART).catch(() => null) : null;
   return stateFromPayload2(stored, { walletPK, source: "head" });
 }
-function writeCachedTransferState(cache, { transfers, walletPK = null, serverEndReached = false, nextOffset = null, oldestTxMs = null } = {}) {
-  if (!cache || !Array.isArray(transfers)) {
-    return Promise.resolve(false);
+function cachedTransferPayloads({ transfers, walletPK = null, serverEndReached = false, historyCount = null, nextOffset = null, oldestTxMs = null } = {}) {
+  if (!Array.isArray(transfers)) {
+    return null;
   }
   const nextWalletPK = lowerText(walletPK);
   if (!nextWalletPK) {
-    return Promise.resolve(false);
+    return null;
   }
   const visible = [...transfers].filter((tx) => tx?.id && isVisibleTransfer(tx) && transferBelongsToWallet(tx, nextWalletPK)).sort((a, b) => txCreatedMs(b) - txCreatedMs(a));
   const sorted2 = visible.slice(0, Math.max(1, WALLET_TRANSFER_CACHE_LIMIT)).map(jsonClean);
   const capped = sorted2.length < visible.length;
+  const knownHistoryCount = Math.max(sorted2.length, Math.floor(Number(historyCount) || 0));
+  const complete = serverEndReached === true && !capped && sorted2.length >= knownHistoryCount;
   const fullPayload = {
     version: CACHE_VERSION,
     walletPK: nextWalletPK,
-    serverEndReached: serverEndReached === true && !capped,
-    historyCount: sorted2.length,
+    serverEndReached: complete,
+    historyCount: knownHistoryCount,
     nextOffset: Number.isFinite(nextOffset) ? nextOffset : sorted2.length,
-    oldestTxMs: serverEndReached === true && !capped && Number.isFinite(oldestTxMs) ? oldestTxMs : null,
+    oldestTxMs: complete && Number.isFinite(oldestTxMs) ? oldestTxMs : null,
     savedAt: Date.now(),
     transfers: sorted2
   };
@@ -111584,7 +111667,24 @@ function writeCachedTransferState(cache, { transfers, walletPK = null, serverEnd
     ...fullPayload,
     transfers: headTransfers
   };
-  return Promise.all([cache.writePart(TX_HEAD_PART, headPayload), cache.writePart(TX_PART, fullPayload)]).then((results) => results.some(Boolean));
+  return { fullPayload, headPayload };
+}
+function writeCachedTransferHeadState(cache, state = {}) {
+  if (!cache) {
+    return Promise.resolve(false);
+  }
+  const payloads = cachedTransferPayloads(state);
+  return payloads ? cache.writePart(TX_HEAD_PART, payloads.headPayload) : Promise.resolve(false);
+}
+function writeCachedTransferState(cache, state = {}) {
+  if (!cache) {
+    return Promise.resolve(false);
+  }
+  const payloads = cachedTransferPayloads(state);
+  if (!payloads) {
+    return Promise.resolve(false);
+  }
+  return Promise.all([cache.writePart(TX_HEAD_PART, payloads.headPayload), cache.writePart(TX_PART, payloads.fullPayload)]).then((results) => results.some(Boolean));
 }
 var TX_PART = "wallet-transfers", TX_HEAD_PART = "wallet-transfers-head", CACHE_VERSION = 2, CACHE_HEAD_LIMIT;
 var init_transfers = __esm(() => {
@@ -112060,6 +112160,7 @@ var init_vault2 = __esm(() => {
 // ../../shared/cache/localdata.js
 var init_localdata = __esm(() => {
   init_chats2();
+  init_balance();
   init_media();
   init_messages2();
   init_profiles();
@@ -112137,7 +112238,8 @@ function makeOwnChatEntry(pair, fields = {}) {
     preview: fields.preview || null,
     saved: fields.saved || null,
     readMs: Number.isFinite(fields.readMs) ? fields.readMs : null,
-    startMs: Number.isFinite(fields.startMs) ? fields.startMs : null
+    startMs: Number.isFinite(fields.startMs) ? fields.startMs : null,
+    signerShared: fields.signerShared === true
   };
 }
 var CHAT_ENTRY_VERSION = 1;
@@ -112902,7 +113004,25 @@ async function setChatRead(cloud, uid, chatPrivKey, chatId, readMs, options = {}
     body: await sealOwnChatEntry(chatPrivKey, entryId, {
       ...entry,
       readMs: Math.max(currentReadMs, nextReadMs),
-      ...hasPreviewPatch ? { preview: preview2 || null } : {}
+      ...hasPreviewPatch ? { preview: preview2 || null } : {},
+      ...options.signerShared === true ? { signerShared: true } : {}
+    })
+  });
+  return true;
+}
+async function setChatSignerShared(cloud, uid, chatPrivKey, chatId) {
+  if (!cloud || !uid || !chatPrivKey || !chatId) {
+    return false;
+  }
+  const entryId = ownChatEntryId(chatPrivKey, chatId);
+  const entry = await readOwnEntry(cloud, uid, chatPrivKey, entryId);
+  if (!entry?.chatId || entry.signerShared === true) {
+    return entry?.signerShared === true;
+  }
+  await cloud.user.chats.write(uid, entryId, {
+    body: await sealOwnChatEntry(chatPrivKey, entryId, {
+      ...entry,
+      signerShared: true
     })
   });
   return true;
@@ -112945,7 +113065,8 @@ async function ownEntryWrite(cloud, uid, chatPrivKey, pair, fields = {}) {
     preview: fields.preview || existing?.preview,
     saved: existing?.saved || null,
     readMs: existing?.readMs,
-    startMs: existing?.startMs
+    startMs: existing?.startMs,
+    signerShared: fields.signerShared === true || existing?.signerShared === true
   });
   const tsMs = timestampMs(fields.ts, null);
   return {
@@ -113040,10 +113161,22 @@ async function sendMsg(cloud, senderPubkey, senderPrivkey, receiverChatPK, messa
       messageId,
       message: msgData,
       ownerEntry,
-      inbox: ping ? { recipientUid: recipientProfile?.uid, ping } : null,
+      inbox: ping ? { recipientUid: recipientProfile?.uid, ping, notify: options?.notify !== false } : null,
       onCommitted: typeof options?.onCommitted === "function" ? (committed) => options.onCommitted({ ...committed, message: sentMessage, preview: preview2 }) : undefined
     });
-    return { chatId, msgId: messageId, cid: head.cid, message: sentMessage, preview: preview2, ...write?.skipped ? { skipped: true } : {} };
+    const delivered = options?.ping === true ? !!ping && write?.delivered !== false : write?.delivered !== false;
+    if (ping && delivered && ownerEntry && options?.ownEntry?.signerShared !== true) {
+      await setChatSignerShared(cloud, cleanText(options?.senderUid), senderPrivkey, chatId).catch(() => false);
+    }
+    return {
+      chatId,
+      msgId: messageId,
+      cid: head.cid,
+      message: sentMessage,
+      preview: preview2,
+      delivered,
+      ...write?.skipped ? { skipped: true } : {}
+    };
   });
 }
 async function sendReadReceipt(cloud, senderPubkey, senderPrivkey, receiverChatPK, target, options = {}) {
@@ -113052,7 +113185,13 @@ async function sendReadReceipt(cloud, senderPubkey, senderPrivkey, receiverChatP
     cid: makeCid(),
     s: senderPubkey
   };
-  return sendMsg(cloud, senderPubkey, senderPrivkey, receiverChatPK, receipt, { ...options, updatePreview: false, ping: false });
+  return sendMsg(cloud, senderPubkey, senderPrivkey, receiverChatPK, receipt, {
+    ...options,
+    updatePreview: false,
+    ping: options?.ping === true,
+    pingKind: "read",
+    notify: false
+  });
 }
 async function sendReaction(cloud, senderPubkey, senderPrivkey, receiverChatPK, target, emoji, options = {}) {
   const reaction = {
@@ -113669,7 +113808,7 @@ function messageExpiryGroups(messages, selfChatPublicKey, seenAt) {
     { messages: day, expiresAt: seenAt + AFTER_SEEN_MS }
   ].filter((group) => group.messages.length);
 }
-function createChatSeen({ cloud, uid, chatBanned, chatPK, chatPrivateKey, localCache, pendingReadRef, readCacheRef, readWriteInterval, getChatRetention, setChats, diag }) {
+function createChatSeen({ cloud, uid, chatBanned, chatPK, chatPrivateKey, localCache, pendingReadRef, readCacheRef, readWriteInterval, getChatRetention, sendOptionsForPeer, setChats, diag }) {
   const scheduleRead = (chatId, message, previewMs, sendReceipt, expiryMessages = []) => {
     scheduleReadWrite({
       pendingRead: pendingReadRef.current,
@@ -113680,24 +113819,37 @@ function createChatSeen({ cloud, uid, chatBanned, chatPK, chatPrivateKey, localC
       expiryMessages: sendReceipt ? expiryMessages : [],
       interval: readWriteInterval,
       write: async (pending) => {
+        let receiptError = null;
+        let receiptResult = null;
+        let introduceSigner = false;
+        if (pending.receipt) {
+          const sendOptions = sendOptionsForPeer(pending.receipt.peerChatPK);
+          introduceSigner = sendOptions?.signerShared !== true;
+          try {
+            receiptResult = await sendReadReceipt(cloud, chatPK, chatPrivateKey, pending.receipt.peerChatPK, pending.receipt.target, {
+              chatId,
+              retention: getChatRetention(chatId),
+              senderUid: uid,
+              receiverUid: sendOptions?.receiverUid,
+              ping: introduceSigner
+            });
+          } catch (error) {
+            receiptError = error;
+          }
+        }
         const writes = [
           setChatRead(cloud, uid, chatPrivateKey, chatId, pending.previewMs, {
-            preview: (currentPreview) => withChatPreviewOpened(currentPreview, pending.message, pending.previewMs, chatPK) || currentPreview
+            preview: (currentPreview) => withChatPreviewOpened(currentPreview, pending.message, pending.previewMs, chatPK) || currentPreview,
+            signerShared: introduceSigner && receiptResult?.delivered === true
           })
         ];
         if (pending.receipt) {
-          writes.push(sendReadReceipt(cloud, chatPK, chatPrivateKey, pending.receipt.peerChatPK, pending.receipt.target, {
-            chatId,
-            retention: getChatRetention(chatId),
-            senderUid: uid
-          }));
           for (const group of messageExpiryGroups(pending.expiryMessages, chatPK, pending.expirySeenAt)) {
             writes.push(setMessageExpiry(cloud, chatId, group.messages, group.expiresAt));
           }
         }
         const results = await Promise.allSettled(writes);
         const ownerError = results[0]?.status === "rejected" ? results[0].reason : null;
-        const receiptError = pending.receipt && results[1]?.status === "rejected" ? results[1].reason : null;
         if (ownerError) {
           markError(diag, "chat.read.state.write", Date.now(), ownerError);
         }
@@ -113705,7 +113857,7 @@ function createChatSeen({ cloud, uid, chatBanned, chatPK, chatPrivateKey, localC
           readCacheRef.current.delete(chatId);
           markError(diag, "chat.read.receipt.write", Date.now(), receiptError);
         }
-        for (const result of results.slice(pending.receipt ? 2 : 1)) {
+        for (const result of results.slice(1)) {
           if (result?.status === "rejected") {
             markError(diag, "chat.message.expiry.write", Date.now(), result.reason);
           }
@@ -115756,7 +115908,11 @@ function readableEntryWindow(entries, pageSize, chatPK, peerChatPK, options = {}
   const limitCount = positiveInt(pageSize, MSG_BATCH_SIZE);
   const projectedEntries = readableProjectedEntries(source, chatPK, peerChatPK, options);
   if (!projectedEntries.length) {
-    return { count: 0, entries: [], start: 0 };
+    return {
+      count: 0,
+      entries: source.filter((entry) => isProjectionSupportMsg(entry?.message)),
+      start: 0
+    };
   }
   const indexes = projectedEntries.map((entry) => entry.index);
   const projectedByIndex = new Map(projectedEntries.map((entry) => [entry.index, entry.message]));
@@ -118116,6 +118272,7 @@ function chatFromPing(ping, entryId, existing, preview2, userChatPK, ms, options
     saved: existing?.saved || null,
     readMs,
     startMs,
+    signerShared: existing?.signerShared === true,
     preview: visiblePreview,
     ts,
     unseen: visiblePreview ? isChatUnseenForUser({ preview: visiblePreview, readMs }, userChatPK) : false
@@ -118174,7 +118331,8 @@ async function savePing(cloud, uid, userChatPK, userPrivKey, ping, options = {})
     settings: chatSettingsFromPreview(existing?.settings, preview2),
     preview: preview2 || existing?.preview,
     readMs: existing?.readMs,
-    startMs: existing ? existing.startMs : timestampMs(options.startPreview?.ts ?? preview2?.ts, null, { positive: true })
+    startMs: existing ? existing.startMs : timestampMs(options.startPreview?.ts ?? preview2?.ts, null, { positive: true }),
+    signerShared: existing?.signerShared === true
   });
   const body = await sealOwnChatEntry(userPrivKey, entryId, entry);
   const record = { body };
@@ -118184,14 +118342,16 @@ async function savePing(cloud, uid, userChatPK, userPrivKey, ping, options = {})
   await cloud.user.chats.write(uid, entryId, record);
   return true;
 }
-function chatWithReadPreview(existing, preview2, userChatPK) {
-  if (!existing?.id || !preview2) {
+function chatWithReadPreview(existing, preview2, userChatPK, fields = {}) {
+  if (!existing?.id) {
     return null;
   }
   return {
     ...existing,
-    preview: preview2,
-    unseen: isChatUnseenForUser({ preview: preview2, readMs: existing.readMs }, userChatPK)
+    signingKeysByChatKey: fields.signingKeysByChatKey || existing.signingKeysByChatKey,
+    peerUid: fields.peerUid || existing.peerUid,
+    preview: preview2 || existing.preview,
+    unseen: preview2 ? isChatUnseenForUser({ preview: preview2, readMs: existing.readMs }, userChatPK) : existing.unseen
   };
 }
 function patchReadPingPreview(existing, receiptPreview, userChatPK) {
@@ -118272,6 +118432,8 @@ async function processInbox(cloud, uid, userChatPK, userPrivKey, options = {}) {
       let current = chatsById.get(group.chatId) || null;
       let wrote = false;
       let handled = false;
+      const identityPing = group.message?.ping || group.read?.ping || group.delete?.ping;
+      const peerUid2 = await resolvePingUid(cloud, identityPing?.payload);
       if (group.message) {
         const item = group.message;
         const entryId = ownChatEntryId(userPrivKey, item.chatId);
@@ -118292,7 +118454,8 @@ async function processInbox(cloud, uid, userChatPK, userPrivKey, options = {}) {
           signingKeysByChatKey,
           preview: preview2,
           startPreview,
-          tsMs: item.ms
+          tsMs: item.ms,
+          peerUid: peerUid2
         });
       }
       if (group.read) {
@@ -118302,22 +118465,24 @@ async function processInbox(cloud, uid, userChatPK, userPrivKey, options = {}) {
         const signingKeysByChatKey = pingSigningKeys(item.ping, existing);
         const receiptPreview = await readPingMsg(cloud, userChatPK, userPrivKey, item.ping, signingKeysByChatKey);
         const openedPreview = patchReadPingPreview(existing, receiptPreview, userChatPK);
-        const chat = chatWithReadPreview(current, openedPreview, userChatPK);
+        const chat = chatWithReadPreview(current || existing, openedPreview, userChatPK, {
+          signingKeysByChatKey,
+          peerUid: peerUid2
+        });
         handled = true;
-        if (openedPreview) {
-          if (chat) {
-            current = chat;
-            chatsById.set(chat.id, chat);
-            options.onPingChat?.(chat);
-          }
-          const writeExisting = chat || existing;
-          wrote = await savePing(cloud, uid, userChatPK, userPrivKey, item.ping, {
-            existing: writeExisting,
-            signingKeysByChatKey,
-            preview: openedPreview,
-            writeTs: false
-          }) || wrote;
+        if (chat) {
+          current = chat;
+          chatsById.set(chat.id, chat);
+          options.onPingChat?.(chat);
         }
+        const writeExisting = chat || existing;
+        wrote = await savePing(cloud, uid, userChatPK, userPrivKey, item.ping, {
+          existing: writeExisting,
+          signingKeysByChatKey,
+          preview: openedPreview || existing?.preview || null,
+          writeTs: false,
+          peerUid: peerUid2
+        }) || wrote;
       }
       if (group.delete) {
         const item = group.delete;
@@ -118338,7 +118503,8 @@ async function processInbox(cloud, uid, userChatPK, userPrivKey, options = {}) {
           wrote = await savePing(cloud, uid, userChatPK, userPrivKey, item.ping, {
             existing: writeExisting,
             signingKeysByChatKey,
-            preview: deletedPreview
+            preview: deletedPreview,
+            peerUid: peerUid2
           }) || wrote;
         }
       }
@@ -118744,6 +118910,7 @@ async function decryptChatEntry(entryRecord, userChatPK, userPrivKey) {
     saved: entry.saved || null,
     readMs,
     startMs,
+    signerShared: entry.signerShared === true,
     preview: visiblePreview,
     ts,
     unseen: visiblePreview ? isChatUnseenForUser({ preview: visiblePreview, readMs }, userChatPK) : false
@@ -119530,6 +119697,7 @@ function createChatList({
       chatExists: !!peerChat?.id || hasServerChatForPeer(peerChatPK),
       receiverUid: peerChat?.peerUid || "",
       peerSigningPublicKey: peerChat?.signingKeysByChatKey?.[peerChatPK] || "",
+      signerShared: peerChat?.signerShared === true,
       ownEntry: peerChat?.entryId ? peerChat : null
     };
   };
@@ -120227,6 +120395,7 @@ function createChatSession({
       readCacheRef,
       readWriteInterval,
       getChatRetention,
+      sendOptionsForPeer,
       setChats,
       diag
     });
@@ -121371,7 +121540,7 @@ function createPeersApi({ cloud, network, avatarCache = null }) {
     }
     if (avatarVersion != null && typeof cloud.peer.avatar.read === "function") {
       try {
-        const bytes = await cloud.peer.avatar.read(uid);
+        const bytes = await cloud.peer.avatar.read(uid, { version: avatarVersion });
         const cachedSource = await writeCachedAvatar(uid, avatarVersion, bytes);
         if (cachedSource) {
           return cachedSource;
@@ -121908,6 +122077,10 @@ function getSatsBalance(result) {
   }
   return satsBalance;
 }
+function displayBalanceValue(value) {
+  const balance = Number(value);
+  return Number.isSafeInteger(balance) && balance >= 0 ? balance : null;
+}
 function samePlainObject(a, b) {
   if (a === b) {
     return true;
@@ -121936,9 +122109,10 @@ function sameTokenBalances(a, b) {
   }
   return true;
 }
-function createWalletBalance({ wallet, diag, onChange = null }) {
+function createWalletBalance({ wallet, diag, initialDisplayBalance = null, onBalance = null, onChange = null }) {
   let snapshot = {
     balance: null,
+    displayBalance: displayBalanceValue(initialDisplayBalance),
     satsBalance: null,
     tokenBalances: new Map,
     balanceReady: false,
@@ -121948,10 +122122,28 @@ function createWalletBalance({ wallet, diag, onChange = null }) {
     snapshot = { ...snapshot, ...changes };
     onChange?.();
   };
+  const publishDisplayBalance = (changes, value, trusted = false) => {
+    const displayBalance = displayBalanceValue(value);
+    if (displayBalance == null || !trusted && !snapshot.balanceReady) {
+      return null;
+    }
+    if (!Object.is(snapshot.displayBalance, displayBalance)) {
+      changes.displayBalance = displayBalance;
+    }
+    return displayBalance;
+  };
   const setBalance = (nextBalance) => {
     const value = typeof nextBalance === "function" ? nextBalance(snapshot.balance) : nextBalance;
+    const changes = {};
     if (!Object.is(snapshot.balance, value)) {
-      publish({ balance: value });
+      changes.balance = value;
+    }
+    const displayBalance = publishDisplayBalance(changes, value);
+    if (Object.keys(changes).length) {
+      publish(changes);
+    }
+    if (displayBalance != null) {
+      onBalance?.(displayBalance);
     }
   };
   const setTokenBalances = (nextTokenBalances) => {
@@ -121960,12 +122152,13 @@ function createWalletBalance({ wallet, diag, onChange = null }) {
       publish({ tokenBalances: new Map(source) });
     }
   };
-  const setBalanceResult = (result) => {
+  const setBalanceResult = (result, { ready = false } = {}) => {
     const changes = {};
     const nextBalance = getBalanceValue(result);
     if (nextBalance != null && !Object.is(snapshot.balance, nextBalance)) {
       changes.balance = nextBalance;
     }
+    const nextDisplayBalance = publishDisplayBalance(changes, nextBalance, true);
     const nextSatsBalance = getSatsBalance(result);
     if (nextSatsBalance && !samePlainObject(snapshot.satsBalance, nextSatsBalance)) {
       changes.satsBalance = nextSatsBalance;
@@ -121974,9 +122167,15 @@ function createWalletBalance({ wallet, diag, onChange = null }) {
     if (nextTokenBalances && !sameTokenBalances(snapshot.tokenBalances, nextTokenBalances)) {
       changes.tokenBalances = new Map(nextTokenBalances);
     }
+    if (ready && !snapshot.balanceReady) {
+      changes.balanceReady = true;
+    }
     if (Object.keys(changes).length) {
       publish(changes);
     }
+    if (nextDisplayBalance != null) {
+      onBalance?.(nextDisplayBalance);
+    }
   };
   const setSatsBalanceResult = (nextSatsBalance) => {
     if (!nextSatsBalance || typeof nextSatsBalance !== "object") {
@@ -121989,9 +122188,13 @@ function createWalletBalance({ wallet, diag, onChange = null }) {
     if (nextSatsBalance.available != null && !Object.is(snapshot.balance, nextSatsBalance.available)) {
       changes.balance = nextSatsBalance.available;
     }
+    const nextDisplayBalance = publishDisplayBalance(changes, nextSatsBalance.available);
     if (Object.keys(changes).length) {
       publish(changes);
     }
+    if (nextDisplayBalance != null) {
+      onBalance?.(nextDisplayBalance);
+    }
   };
   const getBalance = async () => {
     if (!wallet) {
@@ -122005,7 +122208,7 @@ function createWalletBalance({ wallet, diag, onChange = null }) {
     }
     try {
       const result = await wallet.getBalance();
-      setBalanceResult(result);
+      setBalanceResult(result, { ready: true });
       markDone(diag, "wallet.balance", startedAt, { hasBalance: getBalanceValue(result) != null, hasSatsBalance: !!getSatsBalance(result), hasTokenBalances: !!getTokenBalances(result) });
     } catch (error) {
       markError(diag, "wallet.balance", startedAt, error);
@@ -122025,6 +122228,7 @@ function createWalletBalance({ wallet, diag, onChange = null }) {
   const reset = () => {
     snapshot = {
       balance: null,
+      displayBalance: null,
       satsBalance: null,
       tokenBalances: new Map,
       balanceReady: false,
@@ -122041,7 +122245,7 @@ function createWalletBalance({ wallet, diag, onChange = null }) {
     setSatsBalanceResult
   };
 }
-var init_balance = () => {};
+var init_balance2 = () => {};
 
 // ../../shared/wallet/deposits.js
 async function getClaimableDepositUtxos(wallet, options = {}) {
@@ -123819,8 +124023,8 @@ function pendingTransfers(transfers = []) {
 function pendingTransferIds(transfers = []) {
   return pendingTransfers(transfers).map((tx) => String(tx.id));
 }
-function pendingIncomingWalletTransfers(transfers = []) {
-  return pendingTransfers(transfers).filter((tx) => isIncomingTransfer(tx) && isWalletTransfer(tx));
+function pendingIncomingTransfers(transfers = []) {
+  return pendingTransfers(transfers).filter(isIncomingTransfer);
 }
 function uniqueIds(ids = []) {
   return [...new Set((Array.isArray(ids) ? ids : [ids]).map((id) => String(id || "")).filter(Boolean))];
@@ -123915,7 +124119,7 @@ function adaptiveClaimBatchSize(maxBatchSize, queueDepth) {
   }
   return 1;
 }
-function createWalletTransferSession({ wallet, walletPK, localCache, claimIncomingTransfers, pendingClaimBatchSize = null, eagerOutgoingStatusRefresh = false, eagerCacheHistory = true, transferStore, appState = null, deferBackgroundWork = null, backgroundSignal = null, diag }) {
+function createWalletTransferSession({ wallet, walletPK, localCache, claimIncomingTransfers, pendingClaimBatchSize = null, eagerOutgoingStatusRefresh = false, eagerCacheHistory = true, transferStore, appState = null, deferBackgroundWork = null, backgroundSignal = null, refreshBalance = null, diag }) {
   if (!transferStore || typeof transferStore.subscribe !== "function" || typeof transferStore.getSnapshot !== "function" || typeof transferStore.getCacheState !== "function" || typeof transferStore.setHistory !== "function") {
     throw new Error("createWalletTransferSession requires transferStore");
   }
@@ -123980,7 +124184,7 @@ function createWalletTransferSession({ wallet, walletPK, localCache, claimIncomi
   const cacheHydrateKeyRef = { current: "" };
   const cacheHydratePromiseRef = { current: null };
   const fullCacheHydratePromiseRef = { current: null };
-  const cacheWriteRef = { current: { timer: null, cache: null, state: null } };
+  const cacheWriteRef = { current: { timer: null, cache: null, state: null, fullHistory: false } };
   const cacheDirtyRef = { current: false };
   const lastFetchAtRef = { current: 0 };
   const claimBatchSize = Math.max(1, Number(pendingClaimBatchSize) || PENDING_TRANSFER_CLAIM_BATCH_SIZE);
@@ -124308,9 +124512,9 @@ function createWalletTransferSession({ wallet, walletPK, localCache, claimIncomi
       return false;
     }
     const cachedTransfers = filterTransfersForWallet(cached.transfers, walletPKRef.current);
-    const cachedPendingIncoming = pendingIncomingWalletTransfers(cachedTransfers);
-    const cachedPending = pendingTransfers(cachedTransfers);
-    const cachedPublishTransfers = cachedTransfers;
+    const cachedPublishTransfers = !publish && historyTransfersRef.current.length ? mergeTransferPageForWallet(historyTransfersRef.current, cachedTransfers, walletPKRef.current, "append") : cachedTransfers;
+    const cachedPendingIncoming = pendingIncomingTransfers(cachedPublishTransfers);
+    const cachedPending = pendingTransfers(cachedPublishTransfers);
     rememberPendingTransferIds(cachedPending.map((tx) => tx.id));
     markDiag(diag, label, {
       elapsedMs: Date.now() - startedAt,
@@ -124449,9 +124653,11 @@ function createWalletTransferSession({ wallet, walletPK, localCache, claimIncomi
     pending.timer = null;
     const cache = pending.cache;
     const state = pending.state;
+    const fullHistory = pending.fullHistory;
     pending.state = null;
     if (cache && state) {
-      writeCachedTransferState(cache, state);
+      const write = fullHistory ? writeCachedTransferState : writeCachedTransferHeadState;
+      write(cache, state);
     }
   };
   const queueWalletFetch = (read) => {
@@ -124556,7 +124762,7 @@ function createWalletTransferSession({ wallet, walletPK, localCache, claimIncomi
     return pendingQueryPromiseRef.current;
   };
   const pendingIncomingClaimCandidates = (sourceTransfers = []) => {
-    return pendingIncomingWalletTransfers(sourceTransfers).filter((tx) => {
+    return pendingIncomingTransfers(sourceTransfers).filter((tx) => {
       const id = String(tx?.id || "");
       return id && !claimedTransferIdsRef.current.has(id);
     });
@@ -124772,6 +124978,9 @@ function createWalletTransferSession({ wallet, walletPK, localCache, claimIncomi
         batchClaimedIds.push(...staged);
         flushClaimed();
         const uniqueBatchClaimedIds = uniqueIds(batchClaimedIds);
+        if (uniqueBatchClaimedIds.length && typeof refreshBalance === "function") {
+          await refreshBalance();
+        }
         const unclaimedIds = candidateIds.filter((id) => !uniqueBatchClaimedIds.includes(id) && !claimedTransferIdsRef.current.has(id));
         if (unclaimedIds.length) {
           const elapsedMs = Date.now() - startedAt;
@@ -125294,7 +125503,7 @@ function createWalletTransferSession({ wallet, walletPK, localCache, claimIncomi
     try {
       await yieldToUi();
       const pendingTransfers2 = await getPendingTransfersSnapshot();
-      const incomingTransfers = pendingIncomingWalletTransfers(pendingTransfers2);
+      const incomingTransfers = pendingIncomingTransfers(pendingTransfers2);
       const claimCandidates = pendingIncomingClaimCandidates(incomingTransfers);
       if (!incomingTransfers.length) {
         markDone(diag, "wallet.pendingTxs.active", startedAt, { pending: 0, claimed: 0, reason });
@@ -125639,7 +125848,7 @@ function createWalletTransferSession({ wallet, walletPK, localCache, claimIncomi
     if (cacheWriteRef.current.timer) {
       clearTimeout(cacheWriteRef.current.timer);
     }
-    cacheWriteRef.current = { timer: null, cache: null, state: null };
+    cacheWriteRef.current = { timer: null, cache: null, state: null, fullHistory: false };
     cacheDirtyRef.current = false;
   };
   const startCacheHydration = () => {
@@ -125697,12 +125906,10 @@ function createWalletTransferSession({ wallet, walletPK, localCache, claimIncomi
     if (!cacheDirtyRef.current && !cacheWriteRef.current.timer) {
       return;
     }
-    if (historyTransfersRef.current.length < knownHistoryCountRef.current) {
-      return;
-    }
     cacheDirtyRef.current = false;
     cacheWriteRef.current.cache = localCache;
     cacheWriteRef.current.state = transferStore.getCacheState();
+    cacheWriteRef.current.fullHistory = historyTransfersRef.current.length >= knownHistoryCountRef.current;
     if (cacheWriteRef.current.timer) {
       clearTimeout(cacheWriteRef.current.timer);
     }
@@ -125731,7 +125938,7 @@ function createWalletTransferSession({ wallet, walletPK, localCache, claimIncomi
       serverHistoryComplete: serverHistoryCompleteRef.current,
       hasMoreTxs: !historyComplete,
       hasPendingTxs,
-      hasPendingIncomingTxs: pendingIncomingWalletTransfers(transfersRef.current).length > 0,
+      hasPendingIncomingTxs: pendingIncomingTransfers(transfersRef.current).length > 0,
       beginSdkActivity,
       getRecentTxs,
       claimPendingIncomingTransfers: claimPendingIncomingTransfers2,
@@ -126087,6 +126294,7 @@ function createWalletSession({
   deferBackgroundWork = null,
   appState = null,
   transferStore,
+  cachedBalance = null,
   ghostWallet = true,
   diag = null
 }) {
@@ -126104,6 +126312,7 @@ function createWalletSession({
   const txSubscriptions = createFieldSubscriptions(() => publishedSnapshot?.txValue);
   let polling = null;
   let readyDiag = null;
+  let refreshWalletBalance = null;
   const transferSession = createWalletTransferSession({
     wallet,
     walletPK,
@@ -126116,6 +126325,7 @@ function createWalletSession({
     appState,
     deferBackgroundWork,
     backgroundSignal: backgroundAbort.signal,
+    refreshBalance: () => refreshWalletBalance?.(),
     diag
   });
   const getTransferState = () => transferSession.getSnapshot();
@@ -126135,7 +126345,16 @@ function createWalletSession({
       listener();
     }
   };
-  const balance = createWalletBalance({ wallet, diag, onChange: publish });
+  const balance = createWalletBalance({
+    wallet,
+    diag,
+    initialDisplayBalance: cachedBalance,
+    onBalance: (value) => {
+      writeCachedWalletBalance(localCache, { walletPK, network, balance: value }).catch(() => {});
+    },
+    onChange: publish
+  });
+  refreshWalletBalance = balance.getBalance;
   const funding = createFundingAddress({ wallet, network, diag, onChange: publish });
   const updateWalletData = createWalletData({
     wallet,
@@ -126216,6 +126435,7 @@ function createWalletSession({
       wallet,
       network,
       balance: balanceState.balance,
+      displayBalance: balanceState.displayBalance,
       satsBalance: balanceState.satsBalance,
       tokenBalances: balanceState.tokenBalances,
       fundingAddress: funding.getSnapshot(),
@@ -126314,7 +126534,7 @@ function createWalletSession({
   };
 }
 var init_session4 = __esm(() => {
-  init_balance();
+  init_balance2();
   init_claims();
   init_funding();
   init_lightning();
@@ -126323,6 +126543,7 @@ var init_session4 = __esm(() => {
   init_send2();
   init_transfers2();
   init_withdraw();
+  init_localdata();
 });
 
 // ../../shared/wallet/transferstore.js
@@ -126531,6 +126752,7 @@ function createTransferStore() {
         transfers: state.historyTransfers,
         walletPK: state.walletPK,
         serverEndReached: state.serverEndReached,
+        historyCount: state.historyCount,
         nextOffset: state.nextOffset,
         oldestTxMs: state.serverEndReached ? state.oldestVerifiedTxMs : null
       };
@@ -170014,9 +170236,13 @@ function peerRecordFromDoc(snap) {
 function peerRecordsFromSnapshot(snapshot) {
   return snapshot.docs.map(peerRecordFromDoc).filter(Boolean);
 }
-function avatarPath(uid) {
+function avatarPath(uid, version8) {
   requireUid(uid);
-  return `${uid}/avatar.webp`;
+  const avatarVersion = readAvatarVersion(version8);
+  if (!avatarVersion) {
+    throw new Error("avatar version required");
+  }
+  return `${uid}/avatars/${avatarVersion}.webp`;
 }
 function reportEvidencePath(reporter, targetUid, evidenceId) {
   if (!reporter || !targetUid || !evidenceId) {
@@ -170082,6 +170308,7 @@ function createFirebaseCloud({ db, auth: auth2, getAuth: getAuth2, functions: fu
   }
   let activeVaultSigner = null;
   const localSessionTerminations = new Set;
+  const pendingAvatars = new Map;
   function pageTs(value) {
     if (value instanceof Timestamp2) {
       return value;
@@ -170350,6 +170577,7 @@ function createFirebaseCloud({ db, auth: auth2, getAuth: getAuth2, functions: fu
     }, onError);
   }
   async function logout() {
+    pendingAvatars.clear();
     await signOut(requireAuth());
     return true;
   }
@@ -170483,25 +170711,45 @@ function createFirebaseCloud({ db, auth: auth2, getAuth: getAuth2, functions: fu
     await callFunction("acceptAgreement");
     return true;
   }
-  async function writeProfileAvatar(uid, avatar) {
+  async function setProfileAvatar(uid, data) {
     requireUid(uid);
-    await updateDoc(doc(db, "profiles", uid), { avatar });
-    return true;
-  }
-  async function uploadProfileAvatar(uid, data, { contentType = "image/webp" } = {}) {
-    const targetStorage = requireStorage2();
-    const path = avatarPath(uid);
-    const result = typeof uploadStorageBytes === "function" ? await uploadStorageBytes(targetStorage, path, data, { contentType }) : await uploadBytes(ref(targetStorage, path), typeof Blob !== "undefined" && data instanceof Blob ? data : toBytes2(data, "upload bytes"), { contentType });
-    const url = await getDownloadURL(ref(targetStorage, path));
-    return {
-      url,
-      generation: result?.metadata?.generation ?? result?.generation ?? null
-    };
-  }
-  async function deleteProfileAvatar(uid) {
-    const targetStorage = requireStorage2();
-    await deleteObject(ref(targetStorage, avatarPath(uid)));
-    return true;
+    if (requireAuth().currentUser?.uid !== uid) {
+      throw new Error("avatar account mismatch");
+    }
+    if (data == null) {
+      pendingAvatars.delete(uid);
+      const result = await callFunction("setAvatar", { body: null });
+      if (result?.avatar != null) {
+        throw new Error("avatar clear returned invalid state");
+      }
+      return { version: null };
+    }
+    const bytes = new Uint8Array(encryptedBytes(data, "avatar bytes"));
+    const pending = { bytes, version: null, promise: null };
+    const entries = pendingAvatars.get(uid) || [];
+    pendingAvatars.set(uid, [...entries, pending]);
+    pending.promise = callFunction("setAvatar", {
+      body: cloudBytesBase64(bytes, "avatar bytes")
+    }).then((result) => {
+      const version8 = readAvatarVersion(result?.avatar);
+      if (!version8) {
+        throw new Error("avatar publish returned invalid version");
+      }
+      pending.version = version8;
+      return version8;
+    });
+    try {
+      return { version: await pending.promise };
+    } catch (error) {
+      const active = pendingAvatars.get(uid) || [];
+      const remaining = active.filter((entry) => entry !== pending);
+      if (remaining.length) {
+        pendingAvatars.set(uid, remaining);
+      } else {
+        pendingAvatars.delete(uid);
+      }
+      throw error;
+    }
   }
   async function writeProfileIdentity(identity) {
     if (!identity || typeof identity !== "object" || Array.isArray(identity)) {
@@ -170638,13 +170886,28 @@ function createFirebaseCloud({ db, auth: auth2, getAuth: getAuth2, functions: fu
       onUpdate?.(snap.exists() ? snap.data()?.active === true : false, { exists: snap.exists() });
     }, onError);
   }
-  async function readPeerAvatar(uid) {
-    return readStorageFile(avatarPath(uid));
+  async function readPeerAvatar(uid, { version: version8 = null } = {}) {
+    const avatarVersion = readAvatarVersion(version8);
+    const entries = pendingAvatars.get(uid) || [];
+    if (entries.length) {
+      await Promise.allSettled(entries.map((entry) => entry.promise));
+      const pending = entries.find((entry) => entry.version === avatarVersion);
+      if (pending) {
+        const active = pendingAvatars.get(uid) || [];
+        const remaining = active.filter((entry) => entry !== pending);
+        if (remaining.length) {
+          pendingAvatars.set(uid, remaining);
+        } else {
+          pendingAvatars.delete(uid);
+        }
+        return new Uint8Array(pending.bytes);
+      }
+    }
+    return readStorageFile(avatarPath(uid, avatarVersion));
   }
   async function peerAvatarUrl(uid, { version: version8 = null } = {}) {
     const targetStorage = requireStorage2();
-    const url = await getDownloadURL(ref(targetStorage, avatarPath(uid)));
-    return avatarUrlWithVersion(url, version8);
+    return getDownloadURL(ref(targetStorage, avatarPath(uid, version8)));
   }
   function profileQueryField(field2, { network } = {}) {
     if (field2 === "walletPK") {
@@ -171103,12 +171366,13 @@ function createFirebaseCloud({ db, auth: auth2, getAuth: getAuth2, functions: fu
       }
     };
   }
-  async function pushInbox(recipientUid, ping) {
+  async function pushInbox(recipientUid, ping, options2 = {}) {
     requireUid(recipientUid);
     if (!ping)
       throw new Error("inbox ping required");
     await callFunction("push", {
       recipientUid,
+      notify: options2?.notify !== false,
       ping: {
         v: ping.v,
         epk: ping.epk,
@@ -171147,7 +171411,9 @@ function createFirebaseCloud({ db, auth: auth2, getAuth: getAuth2, functions: fu
     payload.onCommitted?.({ chatId, messageId });
     let delivered = true;
     if (payload.inbox?.recipientUid && payload.inbox?.ping) {
-      delivered = await pushInbox(payload.inbox.recipientUid, payload.inbox.ping).then(() => true, () => false);
+      delivered = await pushInbox(payload.inbox.recipientUid, payload.inbox.ping, {
+        notify: payload.inbox.notify !== false
+      }).then(() => true, () => false);
     }
     return { chatId, messageId, delivered };
   }
@@ -171400,18 +171666,19 @@ function createFirebaseCloud({ db, auth: auth2, getAuth: getAuth2, functions: fu
   }
   async function banAdminUser(uid, feature = "chat") {
     requireUid(uid);
-    await setDoc(doc(db, "moderation", uid), { banned: { [feature]: { until: null } } }, { merge: true });
     if (feature === "avatar") {
-      await deleteProfileAvatar(uid).catch((error) => {
-        if (error?.code !== "storage/object-not-found") {
-          throw error;
-        }
-      });
+      await callFunction("setAvatarModeration", { uid, banned: true });
+      return true;
     }
+    await setDoc(doc(db, "moderation", uid), { banned: { [feature]: { until: null } } }, { merge: true });
     return true;
   }
   async function unbanAdminUser(uid, feature = "chat") {
     requireUid(uid);
+    if (feature === "avatar") {
+      await callFunction("setAvatarModeration", { uid, banned: false });
+      return true;
+    }
     await setDoc(doc(db, "moderation", uid), { banned: { [feature]: deleteField() } }, { merge: true });
     return true;
   }
@@ -171449,9 +171716,7 @@ function createFirebaseCloud({ db, auth: auth2, getAuth: getAuth2, functions: fu
           write: writeProfileIdentity
         },
         avatar: {
-          write: writeProfileAvatar,
-          upload: uploadProfileAvatar,
-          delete: deleteProfileAvatar
+          set: setProfileAvatar
         }
       },
       private: {
@@ -174041,13 +174306,6 @@ function cleanMessage(value, limit2, label = "message") {
     throw new Error(`${label} must be ${limit2} characters or fewer`);
   return message;
 }
-function readAvatarGeneration(value) {
-  const version8 = Number(value);
-  if (!Number.isSafeInteger(version8) || version8 <= 0) {
-    throw new Error("avatar upload did not return a valid generation");
-  }
-  return version8;
-}
 function passkeyRows(linksList, passkeys, currentPasskeyId) {
   return [...linksList, ...passkeys].sort((left, right) => (right.createdAt || 0) - (left.createdAt || 0)).map((row) => ({
     ...row,
@@ -174135,23 +174393,17 @@ function createRuntimeProductActions({
       const user = await getUser();
       if (!data)
         throw new Error("avatar data required");
-      const result = await cloud.user.profile.avatar.upload(user.uid, data, {
-        contentType: options2.contentType || "image/webp"
-      });
-      const avatarVersion = readAvatarGeneration(result?.generation);
-      await cloud.user.profile.avatar.write(user.uid, avatarVersion);
-      await user.refetchAvatar?.({ version: avatarVersion, optimistic: true });
-      return { avatar: result?.url || null, avatarVersion };
+      if (options2.contentType && options2.contentType !== "image/webp") {
+        throw new Error("avatar content type must be image/webp");
+      }
+      const result = await cloud.user.profile.avatar.set(user.uid, data);
+      await user.refetchAvatar?.({ version: result.version });
+      const updated = await getUser();
+      return { avatar: updated.avatar || null, avatarVersion: result.version };
     },
     async deleteAvatar() {
       const user = await getUser();
-      try {
-        await cloud.user.profile.avatar.delete(user.uid);
-      } catch (error) {
-        if (error?.code !== "storage/object-not-found")
-          throw error;
-      }
-      await cloud.user.profile.avatar.write(user.uid, null);
+      await cloud.user.profile.avatar.set(user.uid, null);
       user.clearAvatar?.();
       return { deleted: true };
     }