@ghostlytools/sdk 1.13.0 → 1.13.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (38) hide show
  1. package/dist/bitcoinAddress-BIW3tpJG.js +4133 -0
  2. package/dist/bitcoinAddress-BIW3tpJG.js.map +1 -0
  3. package/dist/core.js +433 -2489
  4. package/dist/core.js.map +1 -1
  5. package/dist/index.js +3 -3
  6. package/dist/index.js.map +1 -1
  7. package/dist/{pairedTransports-CkYMAoYN.js → pairedTransports-BcTRg3tp.js} +28 -304
  8. package/dist/pairedTransports-BcTRg3tp.js.map +1 -0
  9. package/dist/testing.js +2 -2
  10. package/dist/types/browser/src/proofs/contract.d.ts +5 -0
  11. package/dist/types/browser/src/proofs/pkarrRelays.d.ts +4 -0
  12. package/dist/types/browser/src/proofs/verify.d.ts +3 -0
  13. package/dist/types/core/src/appStatements.d.ts +16 -0
  14. package/dist/types/core/src/canonicalJson.d.ts +9 -0
  15. package/dist/types/core/src/chatFiles.d.ts +7 -0
  16. package/dist/types/core/src/deviceInvite.d.ts +16 -2
  17. package/dist/types/core/src/dhtDelivery.d.ts +2 -0
  18. package/dist/types/core/src/domainProofs.d.ts +2 -1
  19. package/dist/types/core/src/engineErrors.d.ts +6 -0
  20. package/dist/types/core/src/ghostlink.d.ts +30 -0
  21. package/dist/types/core/src/groupCommunity.d.ts +25 -1
  22. package/dist/types/core/src/groupSession.d.ts +22 -2
  23. package/dist/types/core/src/identityProofs.d.ts +39 -2
  24. package/dist/types/core/src/index.d.ts +1 -1
  25. package/dist/types/core/src/link.d.ts +1 -1
  26. package/dist/types/core/src/linkPreview.d.ts +13 -1
  27. package/dist/types/core/src/linkTrace.d.ts +2 -0
  28. package/dist/types/core/src/localNames.d.ts +7 -0
  29. package/dist/types/core/src/relay.d.ts +27 -1
  30. package/dist/types/core/src/statusCards.d.ts +6 -0
  31. package/dist/types/core/src/transportSwitch.d.ts +7 -3
  32. package/dist/{verify-CSo7-43-.js → verify-DGJJAFTs.js} +24 -5
  33. package/dist/verify-DGJJAFTs.js.map +1 -0
  34. package/package.json +1 -1
  35. package/dist/bitcoinAddress-C2MAmcDT.js +0 -1225
  36. package/dist/bitcoinAddress-C2MAmcDT.js.map +0 -1
  37. package/dist/pairedTransports-CkYMAoYN.js.map +0 -1
  38. package/dist/verify-CSo7-43-.js.map +0 -1
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pairedTransports-BcTRg3tp.js","names":[],"sources":["../../core/src/crypto.ts","../../core/src/domainProofs.ts","../../core/src/localNames.ts","../../core/src/storeForward.ts","../../core/src/pairedTransports.ts"],"sourcesContent":["import { xsalsa20poly1305 } from \"@noble/ciphers/salsa.js\";\nimport { concatBytes, fromBase64, randomBytes, toBase64, utf8Decode, utf8Encode } from \"./bytes\";\n\nconst NONCE_LENGTH = 24;\nconst KEY_LENGTH = 32;\n\nexport function generateEncryptionKey(): Uint8Array {\n return randomBytes(KEY_LENGTH);\n}\n\n/**\n * NaCl secretbox (XSalsa20-Poly1305). Wire format matches the Rust\n * implementation in `apps/desktop/src/crypto.rs`: base64(nonce || box).\n */\nexport function encrypt(plaintext: string, key: Uint8Array): string {\n if (key.length !== KEY_LENGTH) throw new Error(\"Invalid key length: expected 32 bytes\");\n const nonce = randomBytes(NONCE_LENGTH);\n const box = xsalsa20poly1305(key, nonce).encrypt(utf8Encode(plaintext));\n return toBase64(concatBytes(nonce, box));\n}\n\n/** The length of what `encrypt` returns for a plaintext of this many UTF-8 bytes: base64 of nonce, box and 16-byte tag. */\nexport function sealedLength(plaintextBytes: number): number {\n return 4 * Math.ceil((NONCE_LENGTH + 16 + plaintextBytes) / 3);\n}\n\nexport function decrypt(encoded: string, key: Uint8Array): string {\n if (key.length !== KEY_LENGTH) throw new Error(\"Invalid key length: expected 32 bytes\");\n const combined = fromBase64(encoded);\n if (combined.length < NONCE_LENGTH + 1) throw new Error(\"Invalid ciphertext: too short\");\n const nonce = combined.subarray(0, NONCE_LENGTH);\n const box = combined.subarray(NONCE_LENGTH);\n return utf8Decode(xsalsa20poly1305(key, nonce).decrypt(box));\n}\n\nexport function tryDecrypt(encoded: string, key: Uint8Array): string | null {\n try {\n return decrypt(encoded, key);\n } catch {\n return null;\n }\n}\n","import { concatBytes, fromZ32, toZ32, utf8Decode, utf8Encode } from './bytes';\n\n/**\n * Domain identity proofs (draft WISP 304, docs/wisps/304-domain.md), the pure half.\n *\n * Under WISP 300 a proof authorizes a fresh Ed25519 *proof key* that only this\n * profile holds, through a statement the external identity vouches for. A\n * domain vouches by publishing: a DNS TXT record at `_ghostly.<domain>` or a\n * `/.well-known/ghostly.json` file names the proof key **and the statement id**\n * (SHA-256 of the statement), so the record commits to the exact binding —\n * subject, key, dates and nonce — not just to a key. Sharing with a contact is\n * then the contract's per-contact presentation, signed by the proof key.\n *\n * People who already run NIP-05 can use `/.well-known/nostr.json` instead: its\n * root name `_` must be the very Nostr key that signed the statement.\n *\n * The record names no participation key and no contact. Fetching, DNS over\n * HTTPS and caching live in `@ghostly/browser/proofs/domain`.\n */\n\nexport type DomainMethod = 'dns' | 'https' | 'nip05';\n/** What a record says: this Ghostly proof key, for this statement. */\nexport interface DomainRecord { key: string; proof: string }\n\nexport const DOMAIN_METHODS: readonly DomainMethod[] = ['dns', 'https', 'nip05'];\nexport const DNS_LABEL = '_ghostly';\nexport const WELL_KNOWN_PATH = '/.well-known/ghostly.json';\nexport const NIP05_PATH = '/.well-known/nostr.json?name=_';\n/** Everything read from a domain is bounded; these match the fetch limits. */\nexport const DOMAIN_FILE_MAX_BYTES = 16 * 1024;\nexport const DOMAIN_TXT_MAX_BYTES = 1024;\nexport const DOMAIN_MAX_RECORDS = 8;\n\nconst z32 = /^[ybndrfg8ejkmcpqxot1uwisza345h769]{52}$/;\nconst hex64 = /^[a-f0-9]{64}$/;\n\n// ---------------------------------------------------------------------------\n// Domain names\n\n/** Names that never resolve publicly (RFC 6761, 6762, 7686, 8375, 9476) or that\n * only ever mean a private network. A proof for them could only point inward. */\nconst SPECIAL_USE = ['localhost', 'local', 'internal', 'lan', 'home', 'corp', 'intranet', 'private',\n 'test', 'example', 'invalid', 'onion', 'alt', 'arpa'];\n\n/**\n * Normalizes what a person typed (\"Example.COM.\", \"https://example.com/\") into\n * a lowercase ASCII host name, or throws with a message fit for the UI.\n * Internationalized names become punycode (xn--), the form DNS carries.\n */\nexport function normalizeDomain(input: string): string {\n if (typeof input !== 'string') throw new Error('Enter a domain name, like example.com');\n let value = input.trim();\n if (!value || value.length > 300) throw new Error('Enter a domain name, like example.com');\n if (/^[a-z][a-z0-9+.-]*:\\/\\//i.test(value)) {\n let url: URL;\n try { url = new URL(value); } catch { throw new Error('Enter a domain name, like example.com'); }\n if (url.protocol !== 'https:' || url.username || url.password || url.port || (url.pathname !== '/' && url.pathname !== '') || url.search || url.hash)\n throw new Error('Enter only the domain name, without a path or port');\n value = url.hostname;\n } else {\n if (/[/:@?#\\s\\\\]/.test(value)) throw new Error('Enter only the domain name, without a path or port');\n try { value = new URL(`https://${value}`).hostname; } catch { throw new Error('That is not a valid domain name'); }\n }\n value = value.toLowerCase().replace(/\\.$/, '');\n if (value.length > 253 - DNS_LABEL.length - 1) throw new Error('That domain name is too long');\n const labels = value.split('.');\n if (labels.length < 2) throw new Error('Use a full domain name, like example.com');\n for (const label of labels) {\n if (!/^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$/.test(label)) throw new Error('That is not a valid domain name');\n }\n const tld = labels[labels.length - 1];\n if (/^[0-9]+$/.test(tld) || /^\\[/.test(value)) throw new Error('Use a domain name, not an IP address');\n if (SPECIAL_USE.includes(tld) || (labels.length >= 2 && labels.slice(-2).join('.') === 'home.arpa'))\n throw new Error('That name only works on private networks');\n return value;\n}\n\nexport const dnsProofName = (domain: string) => `${DNS_LABEL}.${normalizeDomain(domain)}`;\nexport const wellKnownUrl = (domain: string, method: 'https' | 'nip05' = 'https') =>\n `https://${normalizeDomain(domain)}${method === 'nip05' ? NIP05_PATH : WELL_KNOWN_PATH}`;\n\n// ---------------------------------------------------------------------------\n// Records\n\nexport function validDomainRecord(r: DomainRecord): boolean {\n if (!r || typeof r.key !== 'string' || typeof r.proof !== 'string' || !z32.test(r.key) || !hex64.test(r.proof)) return false;\n try { return toZ32(fromZ32(r.key)) === r.key; } catch { return false; }\n}\n\n/** The TXT record value, in the `tag=value; …` style people know from DKIM. */\nexport function domainTxtRecord(r: DomainRecord): string {\n if (!validDomainRecord(r)) throw new Error('Invalid domain record');\n return `v=ghostly1; key=${r.key}; proof=${r.proof}`;\n}\n\n/** Parses one TXT string. Undefined for anything that is not ours or not exactly\n * well-formed; unknown extra tags are ignored for forward compatibility. */\nexport function parseDomainTxt(value: string): DomainRecord | undefined {\n if (typeof value !== 'string' || utf8Encode(value).length > DOMAIN_TXT_MAX_BYTES) return;\n const tags = new Map<string, string>();\n const parts = value.split(';').map(p => p.trim()).filter(Boolean);\n for (const part of parts) {\n const eq = part.indexOf('=');\n if (eq < 1) return;\n const name = part.slice(0, eq).trim().toLowerCase();\n if (tags.has(name)) return;\n tags.set(name, part.slice(eq + 1).trim());\n }\n if (!parts[0]?.toLowerCase().startsWith('v=') || tags.get('v') !== 'ghostly1') return;\n const r = { key: tags.get('key'), proof: tags.get('proof') } as DomainRecord;\n return validDomainRecord(r) ? r : undefined;\n}\n\nconst addRecord = (list: DomainRecord[], r: DomainRecord) => {\n if (!list.some(x => x.key === r.key && x.proof === r.proof)) list.push(r);\n};\n\n/** All records among the first 32 TXT strings of `_ghostly.<domain>`; other strings are skipped. A TXT set has\n * no order, so every record is kept: the one a proof needs may come in any position. */\nexport function recordsFromTxt(values: string[]): DomainRecord[] {\n const out: DomainRecord[] = [];\n for (const value of values.slice(0, 32)) { const r = parseDomainTxt(value); if (r) addRecord(out, r); }\n return out;\n}\n\n/** The body of `/.well-known/ghostly.json`. */\nexport function domainWellKnownFile(records: DomainRecord[]): string {\n if (!records.length || records.length > DOMAIN_MAX_RECORDS || !records.every(validDomainRecord)) throw new Error('Invalid domain records');\n return JSON.stringify({ ghostly: 1, proofs: records.map(r => ({ key: r.key, proof: r.proof })) }, null, 2) + '\\n';\n}\n\nfunction parseJson(text: string): unknown {\n if (typeof text !== 'string' || utf8Encode(text).length > DOMAIN_FILE_MAX_BYTES) throw new Error('File too large');\n return JSON.parse(text);\n}\n\n/** Records from the first 32 entries of `ghostly.json`. Throws on a malformed file; [] when it names none. */\nexport function recordsFromWellKnown(text: string): DomainRecord[] {\n const body = parseJson(text) as { ghostly?: unknown; proofs?: unknown };\n if (!body || typeof body !== 'object' || Array.isArray(body) || body.ghostly !== 1 || !Array.isArray(body.proofs))\n throw new Error('Not a Ghostly domain file');\n const out: DomainRecord[] = [];\n for (const entry of body.proofs.slice(0, 32) as { key?: unknown; proof?: unknown }[]) {\n if (!entry || typeof entry !== 'object') continue;\n const r = { key: entry.key, proof: entry.proof } as DomainRecord;\n if (validDomainRecord(r)) addRecord(out, r);\n }\n return out;\n}\n\n/** NIP-05: only the root name `_` speaks for the domain itself. Undefined when absent. */\nexport function nip05RootKey(text: string): string | undefined {\n const body = parseJson(text) as { names?: unknown };\n if (!body || typeof body !== 'object' || !body.names || typeof body.names !== 'object' || Array.isArray(body.names))\n throw new Error('Not a NIP-05 file');\n const root = (body.names as Record<string, unknown>)['_'];\n return typeof root === 'string' && hex64.test(root) ? root : undefined;\n}\n\nexport const recordsName = (records: DomainRecord[], r: DomainRecord) => records.some(x => x.key === r.key && x.proof === r.proof);\n\n// ---------------------------------------------------------------------------\n// DNS over HTTPS (RFC 8484) wire messages\n\nexport const DNS_TYPE = { A: 1, CNAME: 5, TXT: 16, AAAA: 28 } as const;\nexport type DnsType = keyof typeof DNS_TYPE;\nexport interface DnsAnswer { name: string; type: number; ttl: number; data: Uint8Array }\nexport interface DnsResponse {\n /** 0 = NOERROR, 3 = NXDOMAIN; anything else is a failed lookup. */\n rcode: number;\n /** The resolver reports it validated the answer with DNSSEC. */\n authenticated: boolean;\n answers: DnsAnswer[];\n}\n\n/**\n * EDNS0 OPT record (RFC 6891) with one Client Subnet option of source prefix 0 (RFC 7871 §7.1.2): a resolver must\n * not add this device's subnet to its queries to the name's servers, as Google Public DNS otherwise does.\n */\nconst NO_CLIENT_SUBNET = Uint8Array.of(0, 0, 41, 1232 >> 8, 1232 & 0xff, 0, 0, 0, 0, 0, 8, 0, 8, 0, 4, 0, 1, 0, 0);\n\n/** A recursive query for one name and type. ID 0, as RFC 8484 recommends for caching;\n * the AD bit asks the resolver to report DNSSEC validation (RFC 6840 §5.7). */\nexport function encodeDnsQuery(name: string, type: DnsType): Uint8Array {\n const labels = name.replace(/\\.$/, '').split('.');\n const parts: Uint8Array[] = [Uint8Array.of(0, 0, 0x01, 0x20, 0, 1, 0, 0, 0, 0, 0, 1)];\n for (const label of labels) {\n const bytes = utf8Encode(label);\n if (!bytes.length || bytes.length > 63) throw new Error('Invalid DNS name');\n parts.push(Uint8Array.of(bytes.length), bytes);\n }\n const code = DNS_TYPE[type];\n parts.push(Uint8Array.of(0, code >> 8, code & 0xff, 0, 1), NO_CLIENT_SUBNET);\n return concatBytes(...parts);\n}\n\nfunction readName(data: Uint8Array, start: number): { name: string; next: number } {\n const labels: string[] = [];\n let pos = start, next = -1, jumps = 0, length = 0;\n for (;;) {\n if (pos >= data.length) throw new Error('DNS name out of bounds');\n const len = data[pos];\n if ((len & 0xc0) === 0xc0) {\n if (pos + 1 >= data.length) throw new Error('DNS pointer out of bounds');\n if (next < 0) next = pos + 2;\n pos = ((len & 0x3f) << 8) | data[pos + 1];\n if (++jumps > 32) throw new Error('DNS name loops');\n continue;\n }\n if (len & 0xc0) throw new Error('Unsupported DNS label');\n pos += 1;\n if (len === 0) break;\n if (pos + len > data.length) throw new Error('DNS label out of bounds');\n length += len + 1;\n if (length > 255) throw new Error('DNS name too long');\n labels.push(utf8Decode(data.subarray(pos, pos + len)).toLowerCase());\n pos += len;\n }\n return { name: labels.join('.'), next: next < 0 ? pos : next };\n}\n\n/**\n * Decodes a resolver's answer to `encodeDnsQuery(name, type)`. Refuses a reply\n * to another question or a truncated one, and keeps only records of the asked\n * type owned by the name or by the CNAME chain the answer itself follows.\n */\nexport function decodeDnsResponse(data: Uint8Array, name: string, type: DnsType): DnsResponse {\n if (data.length < 12) throw new Error('DNS response too short');\n const view = new DataView(data.buffer, data.byteOffset, data.byteLength);\n const flags = view.getUint16(2);\n if (!(flags & 0x8000) || (flags & 0x7800) || (flags & 0x0200)) throw new Error('Unusable DNS response');\n const questions = view.getUint16(4), count = view.getUint16(6);\n const want = name.replace(/\\.$/, '').toLowerCase(), code = DNS_TYPE[type];\n if (questions !== 1) throw new Error('DNS response is for another question');\n const q = readName(data, 12);\n if (q.name !== want || q.next + 4 > data.length || view.getUint16(q.next) !== code) throw new Error('DNS response is for another question');\n let pos = q.next + 4;\n const all: DnsAnswer[] = [];\n for (let i = 0; i < count && i < 64; i++) {\n const owner = readName(data, pos);\n pos = owner.next;\n if (pos + 10 > data.length) throw new Error('DNS record out of bounds');\n const rtype = view.getUint16(pos), ttl = view.getUint32(pos + 4), len = view.getUint16(pos + 8);\n pos += 10;\n if (pos + len > data.length) throw new Error('DNS record out of bounds');\n const rdata = rtype === DNS_TYPE.CNAME ? utf8Encode(readName(data, pos).name) : data.slice(pos, pos + len);\n all.push({ name: owner.name, type: rtype, ttl, data: rdata });\n pos += len;\n }\n const owners = new Set([want]);\n for (let hop = 0; hop < 8; hop++) {\n const cname = all.find(a => a.type === DNS_TYPE.CNAME && owners.has(a.name) && !owners.has(utf8Decode(a.data)));\n if (!cname) break;\n owners.add(utf8Decode(cname.data));\n }\n return { rcode: flags & 0x000f, authenticated: !!(flags & 0x0020), answers: all.filter(a => a.type === code && owners.has(a.name)) };\n}\n\n/** The TXT character-strings of one record, joined as RFC 7208 §3.3 does. */\nexport function txtValue(rdata: Uint8Array): string {\n const parts: Uint8Array[] = [];\n for (let p = 0; p < rdata.length;) {\n const len = rdata[p];\n if (p + 1 + len > rdata.length) throw new Error('DNS text out of bounds');\n parts.push(rdata.subarray(p + 1, p + 1 + len));\n p += 1 + len;\n }\n return new TextDecoder('utf-8', { fatal: true }).decode(concatBytes(...parts));\n}\n\n// ---------------------------------------------------------------------------\n// Addresses: a proof may only make a contact's app fetch from the public Internet\n\n/** False for loopback, private, link-local, shared (CGNAT), multicast, reserved\n * and unspecified addresses, including IPv4 embedded in IPv6, and for 6to4, Teredo and documentation IPv6, as\n * Desktop's link_preview::is_public and apps/ui/src/lib/localHost.ts refuse them. */\nexport function isPublicAddress(address: Uint8Array): boolean {\n if (address.length === 4) {\n const [a, b, c] = address;\n return !(a === 0 || a === 10 || a === 127 || a >= 224 ||\n (a === 100 && b >= 64 && b <= 127) || (a === 169 && b === 254) || (a === 172 && b >= 16 && b <= 31) ||\n (a === 192 && b === 168) || (a === 192 && b === 0 && c === 0) || (a === 198 && (b === 18 || b === 19)));\n }\n if (address.length !== 16) return false;\n const zeroTo = (n: number) => address.subarray(0, n).every(x => x === 0);\n if (zeroTo(15) && (address[15] === 0 || address[15] === 1)) return false; // :: and ::1\n if (zeroTo(10) && address[10] === 0xff && address[11] === 0xff) return isPublicAddress(address.subarray(12)); // ::ffff:a.b.c.d\n if (address[0] === 0x00 && address[1] === 0x64 && address[2] === 0xff && address[3] === 0x9b && address.subarray(4, 12).every(x => x === 0))\n return isPublicAddress(address.subarray(12)); // 64:ff9b::/96 NAT64\n if (zeroTo(12)) return false; // deprecated IPv4-compatible\n if ((address[0] & 0xfe) === 0xfc) return false; // fc00::/7 unique local\n if (address[0] === 0xfe && (address[1] & 0xc0) === 0x80) return false; // fe80::/10 link-local\n if (address[0] === 0xfe && (address[1] & 0xc0) === 0xc0) return false; // fec0::/10 site-local\n if (address[0] === 0xff) return false; // multicast\n if (address[0] === 0x01 && address.subarray(1, 8).every(x => x === 0)) return false; // 100::/64 discard\n if (address[0] === 0x20 && address[1] === 0x02) return false; // 2002::/16 6to4: carries an IPv4 address a gateway may reach\n if (address[0] === 0x20 && address[1] === 0x01 && address[2] === 0x00 && address[3] === 0x00) return false; // 2001::/32 Teredo, the same\n if (address[0] === 0x20 && address[1] === 0x01 && address[2] === 0x0d && address[3] === 0xb8) return false; // 2001:db8::/32 documentation\n return (address[0] & 0xe0) === 0x20; // only 2000::/3 is global unicast\n}\n","/**\n * Names only a local network answers (RFC 6762, RFC 8375, ICANN's .internal, and the usual router and company ones).\n * The same list as apps/ui/src/lib/localHost.ts and Desktop's apps/desktop/src/local_names.rs (a test there pins them).\n */\nexport const LOCAL_SUFFIXES = [\"localhost\", \"local\", \"internal\", \"lan\", \"home\", \"home.arpa\", \"localdomain\", \"intranet\", \"corp\"] as const;\n\n/** Whether a lowercase host with no trailing dot is one of `LOCAL_SUFFIXES` or under one. */\nexport const underLocalSuffix = (host: string): boolean => LOCAL_SUFFIXES.some(s => host === s || host.endsWith(`.${s}`));\n","import { ed25519, x25519 } from \"@noble/curves/ed25519.js\";\nimport { xsalsa20poly1305 } from \"@noble/ciphers/salsa.js\";\nimport { hkdf } from \"@noble/hashes/hkdf.js\";\nimport { sha256 } from \"@noble/hashes/sha2.js\";\nimport { concatBytes, fromBase64Url, randomBytes, toBase64Url, utf8Decode, utf8Encode } from \"./bytes\";\nimport { encrypt, tryDecrypt } from \"./crypto\";\nimport { isPublicAddress } from \"./domainProofs\";\nimport { identityFromSeed, identityFromSeedB64, publicKeyFromZ32, sign, verify, type Identity } from \"./identity\";\nimport type { LinkParams } from \"./invite\";\nimport { underLocalSuffix } from \"./localNames\";\nimport { measureRecords, MAX_DNS_PACKET_BYTES, type GhostRecord, type SignedPacket } from \"./pkarr\";\n\n/**\n * Store-and-forward for an away contact (WISP 404 draft, `hold/1`).\n *\n * What a person sends while the contact is away is sealed into a *bundle* (signed by the sender's\n * participation key, then encrypted to a key only the two of them can derive), put in the sender's\n * own storage (WISP 1000), and named in a *manifest* the storage also holds. A small signed, encrypted\n * *pointer* record on a per-link Pkarr key tells the contact where the manifest is (a URL that expires)\n * and which of the contact's own bundles have been received. Storage and relays see ciphertext, sizes\n * and timing only. Nothing here promises forward secrecy or retention beyond the bounds below.\n */\nexport const HOLD_CAPABILITY = \"hold/1\" as const;\nexport const HOLD_LIMITS = {\n /** One bundle, ciphertext and header included: a picture, not a video. */\n maxBundleBytes: 8 * 1024 * 1024,\n /** All bundles held for one contact at once. */\n maxMailboxBytes: 64 * 1024 * 1024,\n maxMailboxBundles: 64,\n /** A bundle not picked up by then is dropped by its sender. The longest a presigned URL lives, too. */\n ttlMs: 7 * 24 * 60 * 60_000,\n maxTextBytes: 16 * 1024,\n maxPaymentRequestBytes: 64 * 1024,\n maxManifestBytes: 64 * 1024,\n /**\n * How far past one lifetime from now an expiry may reach by the reader's clock: the sender's clock may be ahead, and\n * a day covers any clock that is merely wrong. Nothing else about a pointer or a bundle is held against this clock.\n */\n clockSkewMs: 24 * 60 * 60_000,\n} as const;\n/**\n * How far before its own clock a sender dates its pointer and its manifest, and ends the lifetimes it gives. A reader\n * refuses nothing for those dates: `rev` orders pointers and `seq` orders items, both kept by the reader. Apps up to\n * 1.0.2 refuse a pointer or a manifest dated more than a minute past their clock, and an expiry more than a minute\n * past one lifetime from now, each without a word: the items of a sender whose clock ran two minutes fast were never\n * fetched. Dated back, a sender up to about eleven minutes ahead is read by them.\n */\nexport const HOLD_DATED_BACK_MS = 10 * 60_000;\n\nexport type HoldKind = \"text\" | \"file\" | \"pay-req\" | \"manifest\";\nconst KINDS: readonly string[] = [\"text\", \"file\", \"pay-req\", \"manifest\"];\nconst WIRE_ID = /^[A-Za-z0-9_-]{8,64}$/;\nconst MAILBOX = /^[A-Za-z0-9_-]{22}$/;\nconst SIG = /^[A-Za-z0-9_-]{86}$/;\nconst MAGIC = utf8Encode(\"GHLD\");\nconst VERSION = 1;\nconst NONCE = 24;\n/** A bundle sealed by the chat's ratchet (WISP 4xx § Held items). */\nconst RATCHETED = 2;\ntype HoldItem = { mailbox: string; seq: number; id: string; ts: number; kind: HoldKind; meta?: unknown; expires: number };\n\nexport interface HoldFileMeta { name: string; size: number; mime: string }\n/** One held bundle as the manifest lists it: where to get it, and what to expect. */\nexport type HoldManifestEntry = [seq: number, id: string, kind: Exclude<HoldKind, \"manifest\">, bytes: number, url: string, expires: number];\nexport interface HoldHeader {\n v: 1;\n /** Rendezvous keys, as the sender sees the link. */\n from: string;\n to: string;\n /** Participation keys: who signed, who may open. */\n author: string;\n recipient: string;\n mailbox: string;\n seq: number;\n id: string;\n ts: number;\n kind: HoldKind;\n meta: unknown;\n /** base64url SHA-256 of the body. */\n digest: string;\n expires: number;\n}\nexport interface HoldPointer {\n rev: number;\n issued: number;\n /** When the manifest URL stops working. */\n expires: number;\n manifestUrl: string | null;\n /** Highest sequence the publisher has held for the reader. */\n top: number;\n /** Highest sequence the publisher received from the reader. */\n ack: number;\n count: number;\n bytes: number;\n /** Sequences of the reader's items this publisher refused (changed, oversized, not for it): at most the last 32. */\n refused: number[];\n}\n\n/** Why a bundle, manifest or pointer was refused. Never a reason to trust it a little. */\nexport class HoldRefusedError extends Error {\n /** The bytes the chat's ratchet opened, when it opened them before the item was refused: the caller commits them. */\n ratcheted?: Uint8Array;\n constructor(readonly reason: \"size\" | \"format\" | \"tampered\" | \"not-for-me\" | \"author\" | \"signature\" | \"digest\" | \"limits\" | \"expired\" | \"plain\", message: string) {\n super(message);\n }\n}\n\nconst bodyDigest = (body: Uint8Array) => toBase64Url(sha256(body));\nconst newMailbox = () => toBase64Url(randomBytes(16)).slice(0, 22);\nexport { newMailbox as newHoldMailbox };\n\n/**\n * Everything derived once per link for this feature: my pointer key, the contact's pointer address and\n * the key that seals bundles and pointers between the two participation keys. Needs a pinned contact.\n */\nexport class HoldKeys {\n readonly from: string;\n readonly to: string;\n readonly me: string;\n readonly peer: string;\n /** Publishes my pointer. */\n readonly identity: Identity;\n /** Where the contact publishes its pointer. */\n readonly peerAddress: string;\n private readonly seed: Uint8Array;\n private readonly sealKey: Uint8Array;\n\n constructor(params: LinkParams, participationSeedB64: string, peerKey: string) {\n this.from = identityFromSeedB64(params.seedB64).pubKeyZ32;\n this.to = params.peerPubKeyZ32;\n const mine = identityFromSeedB64(participationSeedB64);\n this.seed = mine.seed;\n this.me = mine.pubKeyZ32;\n this.peer = peerKey;\n const secret = fromBase64Url(params.encKeyB64);\n const context = JSON.stringify([\"ghostly-hold/1\", [this.from, this.to].sort()]);\n const derive = (label: string) => hkdf(sha256, secret, utf8Encode(context), utf8Encode(label), 32);\n this.identity = identityFromSeed(derive(`pointer:${this.from}`));\n this.peerAddress = identityFromSeed(derive(`pointer:${this.to}`)).pubKeyZ32;\n const shared = x25519.getSharedSecret(ed25519.utils.toMontgomerySecret(this.seed), ed25519.utils.toMontgomery(publicKeyFromZ32(peerKey)));\n this.sealKey = hkdf(sha256, shared, derive(\"envelope\"), utf8Encode(\"ghostly-hold-envelope/1\"), 32);\n }\n\n /** Seals one item for the contact: signed with my participation key, encrypted to our shared key. */\n seal(item: HoldItem, body: Uint8Array): Uint8Array {\n const nonce = randomBytes(NONCE);\n const box = xsalsa20poly1305(this.sealKey, nonce).encrypt(this.inner(item, body));\n return concatBytes(MAGIC, new Uint8Array([VERSION]), nonce, box);\n }\n /**\n * The same item as a version-2 bundle (WISP 4xx § Held items): the same plaintext, sealed by the chat's ratchet\n * (`seal`, which saves the ratchet's state before it returns), so the bundle can be uploaded once this returns.\n */\n async sealRatcheted(item: HoldItem, body: Uint8Array, seal: (plaintext: Uint8Array) => Promise<Uint8Array>): Promise<Uint8Array> {\n return concatBytes(MAGIC, new Uint8Array([RATCHETED]), await seal(this.inner(item, body)));\n }\n /** What a bundle seals: the header's length, the signed header, the body. */\n private inner(item: HoldItem, body: Uint8Array): Uint8Array {\n const fields = [VERSION, this.from, this.to, this.me, this.peer, item.mailbox, item.seq, item.id, item.ts, item.kind, item.meta ?? null, bodyDigest(body), item.expires];\n const signature = toBase64Url(sign(utf8Encode(JSON.stringify([\"ghostly-hold-bundle\", fields])), this.seed));\n const header = utf8Encode(JSON.stringify([fields, signature]));\n const length = new Uint8Array(4);\n new DataView(length.buffer).setUint32(0, header.length);\n return concatBytes(length, header, body);\n }\n\n /**\n * Opens a bundle the contact sealed for me. Everything is checked before anything is returned: the\n * authenticated encryption, the header's shape, that it names this link, this contact and me, the\n * signature, the body digest and the limits of its kind. `loopback`: see `isHoldUrl`.\n */\n /**\n * `ratchet`: opens a version-2 bundle's sealed bytes (WISP 4xx), without keeping anything; absent, one is from a newer\n * Ghostly. `refusePlain`: a ratcheted item from this contact opened here, so a version-1 item other than the manifest is\n * refused (WISP 4xx § Downgrade). `ratcheted` in the result: the bytes the ratchet opened, for the caller to commit once\n * the item is stored.\n */\n open(bytes: Uint8Array, expect: { maxBytes?: number; mailbox?: string; now?: number; loopback?: boolean; ratchet?: (sealed: Uint8Array) => Uint8Array | null; refusePlain?: boolean } = {}): { header: HoldHeader; body: Uint8Array; ratcheted?: Uint8Array } {\n const now = expect.now ?? Date.now();\n if (bytes.length > (expect.maxBytes ?? HOLD_LIMITS.maxBundleBytes)) throw new HoldRefusedError(\"size\", \"The held item is larger than allowed\");\n if (bytes.length < MAGIC.length + 1 + 16 + 4 || !MAGIC.every((b, i) => bytes[i] === b)) throw new HoldRefusedError(\"format\", \"Not a held item\");\n const version = bytes[MAGIC.length];\n if (version !== VERSION && (version !== RATCHETED || !expect.ratchet)) throw new HoldRefusedError(\"format\", \"Held item from a newer Ghostly\");\n let plain: Uint8Array | null, ratcheted: Uint8Array | undefined;\n if (version === RATCHETED) {\n ratcheted = bytes.subarray(MAGIC.length + 1);\n try { plain = expect.ratchet!(ratcheted); } catch { plain = null; }\n if (!plain) throw new HoldRefusedError(\"tampered\", \"The held item was changed, is not for this chat, or was opened already\");\n } else {\n if (bytes.length < MAGIC.length + 1 + NONCE + 16 + 4) throw new HoldRefusedError(\"format\", \"Not a held item\");\n try { plain = xsalsa20poly1305(this.sealKey, bytes.subarray(MAGIC.length + 1, MAGIC.length + 1 + NONCE)).decrypt(bytes.subarray(MAGIC.length + 1 + NONCE)); }\n catch { throw new HoldRefusedError(\"tampered\", \"The held item was changed or is not for this chat\"); }\n }\n try { return this.read(plain, ratcheted, expect, now); }\n catch (error) {\n // Opened, then refused: the ratchet's bytes go with the refusal, so the key is used up and the lane heard all the same.\n if (error instanceof HoldRefusedError && ratcheted) error.ratcheted = ratcheted;\n throw error;\n }\n }\n /** The checks of `open` once the bundle is decrypted. */\n private read(plain: Uint8Array, ratcheted: Uint8Array | undefined, expect: { mailbox?: string; loopback?: boolean; refusePlain?: boolean }, now: number): { header: HoldHeader; body: Uint8Array; ratcheted?: Uint8Array } {\n if (plain.length < 4) throw new HoldRefusedError(\"format\", \"Not a held item\");\n const headerLength = new DataView(plain.buffer, plain.byteOffset, 4).getUint32(0);\n if (headerLength > 128 * 1024 || 4 + headerLength > plain.length) throw new HoldRefusedError(\"format\", \"Not a held item\");\n let parsed: unknown;\n try { parsed = JSON.parse(utf8Decode(plain.subarray(4, 4 + headerLength))); } catch { throw new HoldRefusedError(\"format\", \"Not a held item\"); }\n if (!Array.isArray(parsed) || parsed.length !== 2 || !Array.isArray(parsed[0]) || parsed[0].length !== 13 || typeof parsed[1] !== \"string\" || !SIG.test(parsed[1])) throw new HoldRefusedError(\"format\", \"Not a held item\");\n const [fields, signature] = parsed as [unknown[], string];\n const [v, from, to, author, recipient, mailbox, seq, id, ts, kind, meta, digest, expires] = fields;\n if (v !== VERSION || typeof from !== \"string\" || typeof to !== \"string\" || typeof author !== \"string\" || typeof recipient !== \"string\" || typeof mailbox !== \"string\" || !MAILBOX.test(mailbox) ||\n !Number.isSafeInteger(seq) || (seq as number) < 0 || typeof id !== \"string\" || !WIRE_ID.test(id) || !Number.isSafeInteger(ts) || (ts as number) <= 0 ||\n typeof kind !== \"string\" || !KINDS.includes(kind) || typeof digest !== \"string\" || !Number.isSafeInteger(expires)) throw new HoldRefusedError(\"format\", \"Not a held item\");\n // Both directions of this link are sealed with the same key: the header says which one this is.\n if (from !== this.to || to !== this.from || recipient !== this.me) throw new HoldRefusedError(\"not-for-me\", \"The held item is for another chat\");\n if (author !== this.peer) throw new HoldRefusedError(\"author\", \"The held item was not signed by this contact\");\n if (expect.mailbox && mailbox !== expect.mailbox) throw new HoldRefusedError(\"not-for-me\", \"The held item is from another mailbox\");\n let valid: boolean;\n try { valid = verify(fromBase64Url(signature), utf8Encode(JSON.stringify([\"ghostly-hold-bundle\", fields])), publicKeyFromZ32(author)); } catch { valid = false; }\n if (!valid) throw new HoldRefusedError(\"signature\", \"The held item's signature does not check out\");\n const body = plain.subarray(4 + headerLength);\n if (bodyDigest(body) !== digest) throw new HoldRefusedError(\"digest\", \"The held item's content does not match its header\");\n // Its `ts` is its sender's clock, often minutes from this one: nothing is refused for it. It was, past a minute\n // ahead, and for good: the item's sequence was passed, and its sender told \"could not be verified as yours, or was\n // too large\". What stops an item from being taken twice is its sequence (the manifest's, the pointer's `rev`).\n // The item may be older than its upload (a retry, a message written offline); its expiry may not reach past one\n // lifetime from now, give or take what the sender's clock is ahead.\n if ((expires as number) <= (ts as number) || (expires as number) > now + HOLD_LIMITS.ttlMs + HOLD_LIMITS.clockSkewMs) throw new HoldRefusedError(\"limits\", \"The held item's lifetime is out of bounds\");\n const header: HoldHeader = { v: 1, from, to, author, recipient, mailbox, seq: seq as number, id, ts: ts as number, kind: kind as HoldKind, meta, digest, expires: expires as number };\n // The manifest is always sealed as before; anything else from a contact whose items come ratcheted must be ratcheted.\n if (!ratcheted && expect.refusePlain && kind !== \"manifest\") throw new HoldRefusedError(\"plain\", \"The held item was sealed without forward secrecy, which this chat no longer takes\");\n checkKind(header, body, expect.loopback);\n return { header, body, ...(ratcheted && { ratcheted }) };\n }\n\n /** My pointer, as records to publish under `identity`. Throws when it cannot fit a packet. */\n pointerRecords(pointer: HoldPointer, now = Date.now()): GhostRecord[] {\n const body = [VERSION, pointer.rev, pointer.issued, pointer.expires, pointer.manifestUrl, pointer.top, pointer.ack, pointer.count, pointer.bytes, pointer.refused.slice(-32)];\n const signature = toBase64Url(sign(utf8Encode(JSON.stringify([\"ghostly-hold-pointer\", this.from, this.to, body])), this.seed));\n const ttl = Math.min(24 * 3600, Math.max(60, Math.ceil((pointer.expires - now) / 1000)));\n const records = [{ label: \"_hold\", value: encrypt(JSON.stringify([body, signature]), this.sealKey), ttl }];\n if (measureRecords(this.identity.pubKeyZ32, records) > MAX_DNS_PACKET_BYTES) throw new Error(\"The storage address is too long for a DHT packet. Use a shorter endpoint or prefix.\");\n return records;\n }\n\n /**\n * The contact's pointer out of its packet, or null when the packet is not one of its pointers. Its `issued` is the\n * contact's clock and refuses nothing: an older pointer cannot take a newer one's place because of `rev`. The\n * manifest's address is held to what an item's is (`isHoldUrl`): it is fetched as soon as the pointer is read.\n */\n readPointer(packet: SignedPacket, loopback = false): HoldPointer | null {\n if (packet.pubKeyZ32 !== this.peerAddress || measureRecords(packet.pubKeyZ32, packet.records) > MAX_DNS_PACKET_BYTES) return null;\n const records = packet.records.filter(r => r.label === \"_hold\");\n if (records.length !== 1) return null;\n const plain = tryDecrypt(records[0].value, this.sealKey);\n if (!plain) return null;\n let parsed: unknown;\n try { parsed = JSON.parse(plain); } catch { return null; }\n if (!Array.isArray(parsed) || parsed.length !== 2 || !Array.isArray(parsed[0]) || (parsed[0].length !== 9 && parsed[0].length !== 10) || typeof parsed[1] !== \"string\" || !SIG.test(parsed[1])) return null;\n const [body, signature] = parsed as [unknown[], string];\n const [v, rev, issued, expires, manifestUrl, top, ack, count, bytes, refused = []] = body;\n if (v !== VERSION || ![rev, issued, expires, top, ack, count, bytes].every(n => Number.isSafeInteger(n) && (n as number) >= 0) ||\n (manifestUrl !== null && !isHoldUrl(manifestUrl, loopback)) ||\n !Array.isArray(refused) || refused.length > 32 || !refused.every(n => Number.isSafeInteger(n) && (n as number) > 0)) return null;\n try {\n if (!verify(fromBase64Url(signature), utf8Encode(JSON.stringify([\"ghostly-hold-pointer\", this.to, this.from, body])), publicKeyFromZ32(this.peer))) return null;\n } catch { return null; }\n return { rev: rev as number, issued: issued as number, expires: expires as number, manifestUrl: manifestUrl as string | null, top: top as number, ack: ack as number, count: count as number, bytes: bytes as number, refused: refused as number[] };\n }\n}\n\n/**\n * A URL a bundle or manifest may be fetched from. The contact chose it and this device fetches it on its own, so it\n * is HTTPS, without a user or password, at a public name or a public IPv4 address: never this machine or its network.\n * A name with no dot or under a local suffix is a local one. A public name may still resolve to a local address:\n * where the host can resolve, its `fetch` refuses that too (the CLI's, packages/cli/src/runtime/holdFetch.ts, and\n * Desktop's, apps/desktop/src/hold_fetch.rs).\n * `loopback` adds plain HTTP to this machine, for a test against a local server; no shipped app passes it.\n */\nexport function isHoldUrl(value: unknown, loopback = false): value is string {\n if (typeof value !== \"string\" || value.length > 2048) return false;\n let url: URL;\n try { url = new URL(value); } catch { return false; }\n if (url.username || url.password) return false;\n const host = url.hostname.toLowerCase().replace(/\\.+$/, \"\");\n if (loopback && url.protocol === \"http:\" && [\"localhost\", \"127.0.0.1\", \"[::1]\"].includes(host)) return true;\n if (url.protocol !== \"https:\" || !host.includes(\".\") || host.startsWith(\"[\") || underLocalSuffix(host)) return false;\n // A URL's IPv4 host is always written as four decimal numbers, whatever form it was given in.\n return !/^\\d+\\.\\d+\\.\\d+\\.\\d+$/.test(host) || isPublicAddress(Uint8Array.from(host.split(\".\"), Number));\n}\n\n/** The limits of each kind, on the way in. */\nfunction checkKind(header: HoldHeader, body: Uint8Array, loopback = false): void {\n const bad = (message: string) => new HoldRefusedError(\"limits\", message);\n switch (header.kind) {\n case \"text\":\n if (body.length > HOLD_LIMITS.maxTextBytes) throw bad(\"The held text is too long\");\n try { utf8Decode(body); } catch { throw bad(\"The held text is not text\"); }\n return;\n case \"pay-req\":\n if (body.length > HOLD_LIMITS.maxPaymentRequestBytes) throw bad(\"The held payment request is too large\");\n return;\n case \"file\": {\n const meta = header.meta as Partial<HoldFileMeta> | null;\n if (!meta || typeof meta !== \"object\" || typeof meta.name !== \"string\" || meta.name.length > 255 || typeof meta.mime !== \"string\" || meta.mime.length > 255 || meta.size !== body.length) throw bad(\"The held file does not match its description\");\n return;\n }\n case \"manifest\": {\n if (body.length !== 0) throw bad(\"A manifest carries no body\");\n readManifest(header.meta, loopback);\n return;\n }\n }\n}\n\n/** The entries of a manifest, checked: strictly increasing sequences, bounded sizes, fetchable URLs. */\nexport function readManifest(meta: unknown, loopback = false): HoldManifestEntry[] {\n const bad = (message: string) => new HoldRefusedError(\"limits\", message);\n const entries = (meta as { entries?: unknown } | null)?.entries;\n if (!Array.isArray(entries) || entries.length > HOLD_LIMITS.maxMailboxBundles) throw bad(\"The manifest lists too many items\");\n let last = 0, total = 0;\n const out: HoldManifestEntry[] = [];\n for (const entry of entries) {\n if (!Array.isArray(entry) || entry.length !== 6) throw bad(\"The manifest is malformed\");\n const [seq, id, kind, bytes, url, expires] = entry;\n if (!Number.isSafeInteger(seq) || seq <= last || typeof id !== \"string\" || !WIRE_ID.test(id) || typeof kind !== \"string\" || !KINDS.includes(kind) || kind === \"manifest\" ||\n !Number.isSafeInteger(bytes) || bytes < 0 || bytes > HOLD_LIMITS.maxBundleBytes || !isHoldUrl(url, loopback) || !Number.isSafeInteger(expires)) throw bad(\"The manifest is malformed\");\n last = seq; total += bytes;\n if (total > HOLD_LIMITS.maxMailboxBytes) throw bad(\"The manifest lists more than a mailbox may hold\");\n out.push([seq, id, kind as HoldManifestEntry[2], bytes, url, expires]);\n }\n return out;\n}\n","import type { FrameChannel } from \"./frames\";\nimport { isHoldUrl } from \"./storeForward\";\n\nexport const TRANSPORTS = [\"iroh/1\", \"hyperdht/1\", \"webrtc/1\"] as const;\nexport type PairedTransport = typeof TRANSPORTS[number];\nexport type NativeTransport = Exclude<PairedTransport, \"webrtc/1\">;\n\n/** Supplied only by the local adapter after its real cryptographic handshake.\n * Iroh uses a TLS exporter; HyperDHT uses its Noise handshake hash. */\nexport interface NativeBinding {\n transport: NativeTransport;\n context: string;\n identities: [string, string];\n}\nexport interface BoundChannel { channel: FrameChannel; binding: NativeBinding }\nexport interface NativeEndpoint {\n transport: NativeTransport;\n descriptor: unknown;\n connect(descriptor: unknown): Promise<BoundChannel>;\n close(): Promise<void>;\n onConnection: ((connection: BoundChannel) => void) | null;\n onDescriptor: (() => void) | null;\n onUnavailable?: (() => void) | null;\n /** The endpoint is connected to its relay again after it lost it (the native Iroh's home relay; nothing else says it). */\n onRelayBack?: (() => void) | null;\n}\nexport type TransportDescriptors = Partial<Record<NativeTransport, unknown>>;\n\n/**\n * One spelling per Iroh relay. Iroh compares relay URLs as text, and its own relays are named with the trailing dot\n * of a fully qualified name (`https://use1-1.relay.n0.iroh.link./`): the same server written without the dot is\n * another relay to it, and an endpoint dialling a contact there opens a second connection to the server it is already\n * homed on, which the server answers by setting the first one aside.\n *\n * So every relay URL is put in one spelling before it goes into an Iroh endpoint (the relays it homes on, a contact's\n * descriptor before a dial), and which one depends on the endpoint:\n * - `\"dotted\"`, n0's relays with their trailing dot: what native Iroh homes on by default (the Desktop), and the form\n * to compare two relays in. Any other relay keeps its plain name here too: a relay behind a proxy (a Cloudflare\n * tunnel) is found by its Host header, and the proxy answers the dotted name with 404.\n * - `\"plain\"`, the name without it: the only one every browser opens. WebKit (Safari, the iPhone app) refuses a\n * host name that ends in a dot, for `fetch` and for a WebSocket alike, so nothing a browser's Iroh is given has one.\n *\n * An IP address and a single-label name (a search domain may complete it) stay as written; `localhost.` loses its dot\n * in both, the form the relay settings accept. What does not parse comes back untouched, for the caller's own check.\n */\nexport type IrohRelaySpelling = \"dotted\" | \"plain\";\nexport function irohRelayUrl(value: string, spelling: IrohRelaySpelling = \"dotted\"): string {\n let url: URL;\n try { url = new URL(value); } catch { return value; }\n const host = url.hostname, name = host.replace(/\\.$/, \"\");\n if (!name.includes(\".\") && name !== \"localhost\") return value;\n if (name.startsWith(\"[\") || /^\\d+(\\.\\d+){3}$/.test(name)) return value;\n const wanted = spelling === \"dotted\" && /(^|\\.)iroh\\.link$/.test(name) ? `${name}.` : name;\n if (wanted === host) return value;\n url.hostname = wanted;\n return url.href;\n}\n\n/** An Iroh descriptor with its relay in one spelling (`irohRelayUrl`); anything else as it is. */\nexport function irohDescriptor<T>(descriptor: T, spelling: IrohRelaySpelling = \"dotted\"): T {\n const relay = (descriptor as { relay?: unknown } | null | undefined)?.relay;\n if (typeof relay !== \"string\") return descriptor;\n const canonical = irohRelayUrl(relay, spelling);\n return canonical === relay ? descriptor : { ...descriptor, relay: canonical };\n}\n\n/**\n * A relay server's URL, short: https, or wss for a browser's relay; plain http or ws only on this machine's loopback,\n * as a test relay is (the same rule as the relay settings).\n */\nexport const RELAY_URL = /^((https|wss):\\/\\/[^\\s]{1,120}|(http|ws):\\/\\/(127\\.0\\.0\\.1|localhost|\\[::1\\])(:\\d{1,5})?(\\/[^\\s]{0,100})?)$/;\n/**\n * A relay URL with more than its server's address in it: a login, a query or a fragment, which no relay setting takes\n * (irohWeb.ts `irohRelayProblem`, hyperdhtRelay.ts `hyperdhtRelayProblem`). An older app named its HyperDHT relay as\n * set, with them; such a descriptor is not dialed or kept, and the rest of what the contact told still is.\n */\nexport const RELAY_WITH_SECRETS = /^[a-z]+:\\/\\/[^/?#]*@|[?#]/i;\n/** A relay URL a descriptor may name: `RELAY_URL`, with nothing but the server's address in it. */\nexport const relayUrl = (value: unknown): value is string => typeof value === \"string\" && RELAY_URL.test(value) && !RELAY_WITH_SECRETS.test(value);\n/** `RELAY_URL` at any length. */\nconst RELAY_URL_ANY_LENGTH = /^((https|wss):\\/\\/[^\\s]+|(http|ws):\\/\\/(127\\.0\\.0\\.1|localhost|\\[::1\\])(:\\d{1,5})?(\\/[^\\s]*)?)$/;\n/**\n * A relay URL `relayUrl` refuses for its length alone (past 120 characters, a loopback path past 100): a relay setting\n * asks for a shorter one, where \"not a relay address\" sent the person looking for a typo in it.\n */\nexport const relayUrlTooLong = (value: string): boolean => !relayUrl(value) && !RELAY_WITH_SECRETS.test(value) && RELAY_URL_ANY_LENGTH.test(value);\n/**\n * Whether an Iroh endpoint may dial a contact through the relay its descriptor names (none: a direct address alone).\n * The contact chose that relay and this device opens it on its own, again on each redial, so it is held to what a held\n * item's address is (`isHoldUrl`): https at a public name or a public address, never this machine or its network.\n * One of the endpoint's own relays (`own`: the person's settings, a private network's or a test's) is dialled as well,\n * in either spelling: this device opens it anyway.\n */\nexport function dialableIrohRelay(relay: unknown, own: readonly string[]): boolean {\n if (relay === null || relay === undefined) return true;\n if (!relayUrl(relay)) return false;\n const same = (a: string, b: string) => { try { return new URL(irohRelayUrl(a, \"plain\")).href === new URL(irohRelayUrl(b, \"plain\")).href; } catch { return false; } };\n return own.some(mine => same(mine, relay)) || isHoldUrl(relay);\n}\nconst HEX_KEY = /^[0-9a-f]{64}$/;\n/** An Iroh direct address as the adapters parse it: an IPv4 or bracketed IPv6 address and its port. */\nconst SOCKET_ADDRESS = /^(\\d{1,3}(\\.\\d{1,3}){3}|\\[[0-9A-Fa-f:.]{2,45}(%[A-Za-z0-9._-]{1,16})?\\]):\\d{1,5}$/;\nconst MAX_ADDRESSES = 8;\n\n/**\n * A contact's native descriptors as it tells them on a session (`paired-policy`, `paired-adapters`) or as this app\n * kept them: only what the adapters dial, each field in the shape its adapter makes. The keys are 64 hex characters,\n * a relay passes `relayUrl` (the rule its capability record is read by), an Iroh descriptor lists at most eight\n * socket addresses. A descriptor that is anything else is left out, as one the contact never told; a field this app\n * does not know is not kept.\n */\nexport function checkedDescriptors(value: unknown): TransportDescriptors {\n const out: TransportDescriptors = {};\n if (!value || typeof value !== \"object\" || Array.isArray(value)) return out;\n const raw = value as Record<string, unknown>;\n const relayed = (v: unknown) => v === undefined || typeof v === \"boolean\";\n const iroh = raw[\"iroh/1\"] as { id?: unknown; relay?: unknown; addresses?: unknown; relayed?: unknown } | null | undefined;\n if (iroh && typeof iroh === \"object\" && typeof iroh.id === \"string\" && HEX_KEY.test(iroh.id) &&\n (iroh.relay === undefined || iroh.relay === null || relayUrl(iroh.relay)) && relayed(iroh.relayed) &&\n Array.isArray(iroh.addresses) && iroh.addresses.length <= MAX_ADDRESSES &&\n iroh.addresses.every(a => typeof a === \"string\" && SOCKET_ADDRESS.test(a)))\n out[\"iroh/1\"] = { id: iroh.id, relay: (iroh.relay as string | null | undefined) ?? null, addresses: [...iroh.addresses] as string[],\n ...(iroh.relayed !== undefined ? { relayed: iroh.relayed } : {}) };\n const hyper = raw[\"hyperdht/1\"] as { publicKey?: unknown; relay?: unknown; relayed?: unknown } | null | undefined;\n if (hyper && typeof hyper === \"object\" && typeof hyper.publicKey === \"string\" && HEX_KEY.test(hyper.publicKey) &&\n (hyper.relay === undefined || relayUrl(hyper.relay)) && relayed(hyper.relayed))\n out[\"hyperdht/1\"] = { publicKey: hyper.publicKey, ...(hyper.relay !== undefined ? { relay: hyper.relay } : {}),\n ...(hyper.relayed !== undefined ? { relayed: hyper.relayed } : {}) };\n return out;\n}\n\n/**\n * Relay only (WISP 100, \"Relayed\"): the transport reaches this contact only through a relay server, never\n * directly. A descriptor says so with `relayed: true`, and an Iroh descriptor with no direct address is relayed\n * too (a browser's, WISP 102). Either side being relay only makes the whole path relayed. Both sides hold both\n * descriptors after the exchange, so they agree, and the rank stays symmetric.\n */\nexport function relayedTransports(local: TransportDescriptors, remote: TransportDescriptors): NativeTransport[] {\n const relayOnly = (transport: NativeTransport, descriptor: unknown): boolean => {\n if (!descriptor || typeof descriptor !== \"object\") return false;\n const d = descriptor as { relayed?: unknown; addresses?: unknown };\n return d.relayed === true || (transport === \"iroh/1\" && Array.isArray(d.addresses) && d.addresses.length === 0);\n };\n return ([\"iroh/1\", \"hyperdht/1\"] as const).filter(t => relayOnly(t, local[t]) || relayOnly(t, remote[t]));\n}\n\n/** Symmetric rank sum; the fixed order breaks ties deterministically. Neither\n * a remote list nor a preference can add an unavailable local adapter. A\n * relayed transport ranks after every direct one: it is where a failed direct\n * path goes, never ahead of one that works. Iroh through its relay is the\n * exception (WISP 100, revision 2026-11-08): it comes back almost at once after\n * the app was away, and a browser's Iroh is never anything else. */\nexport function rankTransports(local: readonly string[], remote: readonly string[], relayed: readonly string[] = []): PairedTransport[] {\n const penalty = (t: PairedTransport) => t !== \"iroh/1\" && relayed.includes(t) ? 1 : 0;\n return TRANSPORTS.filter(t => local.includes(t) && remote.includes(t))\n .sort((a, b) => penalty(a) - penalty(b)\n || (local.indexOf(a) + remote.indexOf(a)) - (local.indexOf(b) + remote.indexOf(b))\n || TRANSPORTS.indexOf(a) - TRANSPORTS.indexOf(b));\n}\n\n/**\n * What a chat prefers when nobody chose (Automatic): Iroh where the app has it, then WebRTC, then HyperDHT (WISP 100,\n * revision 2026-11-08). Every app puts Iroh first, so the rank sum of two apps that both run it puts it first on both\n * sides. With nothing at all, WebRTC, which the offer then leaves out.\n * With Fallback off the chat may use only that one transport, and nothing moves it off a relayed Iroh then: WebRTC\n * where the app has it, else the first transport it has (a Linux Desktop: WebKitGTK has no WebRTC), as before.\n */\nexport const AUTOMATIC_ORDER: readonly PairedTransport[] = [\"iroh/1\", \"webrtc/1\", \"hyperdht/1\"];\nexport function automaticTransport(available: readonly PairedTransport[], fallback = true): PairedTransport {\n if (!fallback) return available.includes(\"webrtc/1\") ? \"webrtc/1\" : TRANSPORTS.find(t => available.includes(t)) ?? \"webrtc/1\";\n return AUTOMATIC_ORDER.find(t => available.includes(t)) ?? \"webrtc/1\";\n}\n\nexport function transportOrder(available: readonly PairedTransport[], preferred: PairedTransport,\n fallback: boolean): PairedTransport[] {\n const rest = TRANSPORTS.filter(t => available.includes(t) && t !== preferred);\n return [...(available.includes(preferred) ? [preferred] : []), ...(fallback ? rest : [])];\n}\n"],"mappings":"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"}
package/dist/testing.js CHANGED
@@ -1,7 +1,7 @@
1
1
  import { n as decodeBolt11 } from "./bolt11-CRiQrma3.js";
2
- import { A as newIdentityBinding, C as emptyIdentityLedger, D as identityStatement, V as createIdentity, b as IdentityExchange, l as IDENTITY_MAX_EVIDENCE, n as isBitcoinAddress } from "./bitcoinAddress-C2MAmcDT.js";
2
+ import { D as emptyIdentityLedger, P as newIdentityBinding, an as createIdentity, j as identityStatement, l as IDENTITY_MAX_EVIDENCE, n as isBitcoinAddress, w as IdentityExchange } from "./bitcoinAddress-BIW3tpJG.js";
3
3
  import { l as providerDescriptorProblems, o as isNothingSpentError } from "./types-DbgC491n.js";
4
- import { i as verifyIdentity, r as descriptorProblems } from "./verify-CSo7-43-.js";
4
+ import { i as verifyIdentity, r as descriptorProblems } from "./verify-DGJJAFTs.js";
5
5
  import { _ as fakeAddress, a as fakeAccount, b as fakeOnchain, c as fakeKeySign, d as fakeRecord, f as fakeRecordText, g as TEST_PROVIDERS_FLAG, h as FakeOnchainProvider, i as TEST_IDENTITIES_FLAG, l as fakeKeySubject, m as FakeLightningProvider, n as FAKE_ISSUER, o as fakeAccountToken, p as testIdentitiesEnabled, r as FAKE_RECORD_HOST, s as fakeKey, t as FAKE_IDENTITY_PROVIDERS, u as fakeKeyring, v as fakeInvoice, x as testProvidersEnabled, y as fakeLightning } from "./fakes-Cgl1w4Nv.js";
6
6
  import { afterEach, describe, expect, it, vi } from "vitest";
7
7
  // ../browser/src/engine/paymentAdapters/providers/contractSuite.ts
@@ -28,6 +28,11 @@ export interface IdentityFetchOptions {
28
28
  maxBytes?: number;
29
29
  signal?: AbortSignal;
30
30
  redirect?: "follow" | "error";
31
+ /**
32
+ * A read of one of the profile's own Pkarr relays (a did:dht): read as the chats read them, http:// and a private
33
+ * address included, since the person chose them. Ignored for any other URL.
34
+ */
35
+ ownPkarrRelay?: boolean;
31
36
  }
32
37
  export interface IdentityFetchResponse {
33
38
  status: number;
@@ -0,0 +1,4 @@
1
+ export declare function setPkarrRelaySource(read: () => readonly string[] | undefined): void;
2
+ export declare function pkarrRelays(): string[];
3
+ /** Whether `url` is under one of the profile's Pkarr relays (`<relay>/…`). */
4
+ export declare function isOwnPkarrRelayUrl(url: URL): boolean;
@@ -15,9 +15,12 @@ export declare function availableSigners<E>(p: IdentityProofProvider<E>, platfor
15
15
  * The engine's `ctx.fetch`: HTTPS GET only, no credentials or referrer, a time-out, a size cap,
16
16
  * redirects refused unless asked for.
17
17
  * `online` false refuses everything (the person turned the network off).
18
+ * A did:dht read of the profile's own Pkarr relays (`ownPkarrRelay`) may be http://, through `relayFetcher`: those are
19
+ * the relays the person chose, as the chats read them, not an address a contact named.
18
20
  */
19
21
  export declare function boundedIdentityFetch(options?: {
20
22
  online: () => boolean;
21
23
  timeoutMs?: number;
22
24
  fetcher?: typeof fetch;
25
+ relayFetcher?: typeof fetch;
23
26
  }): IdentityFetch;
@@ -16,6 +16,11 @@ export declare const APP_STATEMENT_LIMITS: {
16
16
  readonly reason: 200;
17
17
  /** Revocations in one `ghostly-revoke.json`. */
18
18
  readonly revocations: 4096;
19
+ /**
20
+ * One signed revocation's canonical bytes: twice the largest a valid one can be (64 digests, a 32-character name and
21
+ * a 200-character reason of 4-byte characters: about 4.1 KB), so a reader refuses a larger entry before parsing it.
22
+ */
23
+ readonly revocationBytes: 8192;
19
24
  };
20
25
  /** A z-base32 Ed25519 public key: 52 characters that decode to 32 bytes and encode back to the same text. */
21
26
  export declare function isAppKey(value: unknown): value is string;
@@ -156,4 +161,15 @@ export declare function readAppRevocations(bytes: Uint8Array, checked?: AppRevoc
156
161
  reason: CanonicalJsonRefusal | AppRevocationRefusal;
157
162
  detail?: string;
158
163
  };
164
+ /**
165
+ * The entries of a `ghostly-revoke.json`, each as its own bytes, one at a time and with nothing parsed: a file past
166
+ * 4096 entries, or with one larger than any revocation can be, is refused there, however large it is. It ends with null
167
+ * when the list closed. Each entry read alone (`readCanonicalJson`, then `readAppRevocation`) refuses exactly the files
168
+ * reading the file whole refuses.
169
+ */
170
+ export declare function appRevocationsFileEntries(bytes: Uint8Array): Generator<Uint8Array, {
171
+ ok: false;
172
+ reason: "not-json" | "bad-revocation";
173
+ detail?: string;
174
+ } | null, void>;
159
175
  export {};
@@ -20,3 +20,12 @@ export type CanonicalJsonReading = {
20
20
  * when writing the value again gives other bytes.
21
21
  */
22
22
  export declare function readCanonicalJson(bytes: Uint8Array): CanonicalJsonReading;
23
+ /**
24
+ * The entries of bytes that must be a canonical JSON list, each as its own bytes, one at a time: a scan that builds no
25
+ * value and goes no further than the entry it yields, so a caller reads (and may refuse) each before the next is
26
+ * found. It ends with null at the closing `]`; `not-list` past `maxEntries` entries, at an entry over `maxEntryBytes`,
27
+ * or when the bytes are not within `[` and `]`; `not-json` when brackets or quotes do not close. A canonical list is
28
+ * `[`, its entries' canonical texts joined by `,`, then `]`, so the bytes are canonical exactly when the scan ends with
29
+ * null and each entry read alone with `readCanonicalJson` is.
30
+ */
31
+ export declare function canonicalJsonListEntries(bytes: Uint8Array, maxEntries: number, maxEntryBytes: number): Generator<Uint8Array, "not-json" | "not-list" | null, void>;
@@ -306,6 +306,12 @@ export declare function decodeFileData(message: Uint8Array): {
306
306
  offset: number;
307
307
  data: Uint8Array;
308
308
  } | null;
309
+ /**
310
+ * The room this device tells a contact (`pf-room`, a `no-room` refusal): its free space rounded down to a power of two or
311
+ * one and a half of one. The exact bytes would be the same from every profile on the device, and move with whatever it
312
+ * stores, so a contact could tell one device from another, or watch it, by asking. Never more than the room itself.
313
+ */
314
+ export declare function coarseRoom(room: number): number | null;
309
315
  /** What a refusal means to the sender's person. */
310
316
  export declare function refusalText(why: string, room?: number): {
311
317
  state: TransferState;
@@ -385,6 +391,7 @@ export declare class ChatFiles {
385
391
  */
386
392
  sweep(): void;
387
393
  private sayRoom;
394
+ private refuseOffer;
388
395
  /** A new file to send: offered now if a session is open, or on the next one. */
389
396
  offer(file: FileInfo, digest?: string): FileTransferRecord;
390
397
  private offerFrame;
@@ -5,6 +5,19 @@ export declare const DEVICE_INVITE_BYTES = 133;
5
5
  export declare const DEVICE_INVITE_OWN_DEVICE = 1;
6
6
  /** How long a code is good for (WISP 06: the inviter enforces the 10 minutes). */
7
7
  export declare const DEVICE_INVITE_LIFETIME_S = 600;
8
+ /**
9
+ * How far past its expiry, by the reading device's own clock, a code is still taken: a day. The expiry is in the
10
+ * inviter's clock, and the reader's may run ahead of it by minutes (no time sync), by hours (a wrong time zone set as
11
+ * local time) or more; only the inviter's word counts, and the inviter refuses a code past its ten minutes. A code a
12
+ * day past its expiry here is old by any likely clock.
13
+ */
14
+ export declare const DEVICE_INVITE_READ_SLACK_S: number;
15
+ /**
16
+ * Whether the device reading a code takes it as expired: `expires` is the code's (the inviter's clock), `now` this
17
+ * device's, both UNIX seconds. The one rule for every reader (the enrollment and the join dialogs), so none refuses a
18
+ * fresh code from an inviter whose clock is behind this one.
19
+ */
20
+ export declare const deviceInviteExpired: (expires: number, now: number) => boolean;
8
21
  /** A device invite, as both sides hold it. Keys and seeds are the forms the link parameters use. */
9
22
  export interface DeviceInvite {
10
23
  /** The joiner's one-time rendezvous seed, base64url. */
@@ -19,7 +32,7 @@ export interface DeviceInvite {
19
32
  /** UNIX seconds. */
20
33
  expires: number;
21
34
  }
22
- /** Why a device code was refused. `chat`: it is a chat invite. `expired`: past its time. The others as for a chat invite (WISP 801). */
35
+ /** Why a device code was refused. `chat`: it is a chat invite. `expired`: a day past its time here. The others as for a chat invite (WISP 801). */
23
36
  export type DeviceInviteRefusal = "typo" | "update" | "not-ghostly" | "damaged" | "chat" | "expired";
24
37
  export type DeviceInviteReading = {
25
38
  ok: true;
@@ -33,7 +46,8 @@ export type DeviceInviteReading = {
33
46
  export declare function encodeDeviceInvite(invite: DeviceInvite): string;
34
47
  /**
35
48
  * Reads a device code, pasted or scanned (bare, in capitals from a QR code, or after a `#`). `now` is in UNIX
36
- * seconds: a code past its expiry is refused here already, though only the inviter's word counts.
49
+ * seconds, this device's clock: only a code a day past its expiry by it is refused here (`deviceInviteExpired`), since
50
+ * only the inviter's word counts.
37
51
  */
38
52
  export declare function readDeviceInvite(input: string, now?: number): DeviceInviteReading;
39
53
  /** What the inviter keeps of a code it made: the invite, and its own end of the one-time link. Never written anywhere. */
@@ -7,6 +7,8 @@ import { type DhtFileAnnouncement, type DhtFileElement, type DhtFileOffer } from
7
7
  export type DeliveryMode = "stream" | "dht";
8
8
  export declare const DHT_TEXT_BYTES = 256;
9
9
  export declare const DHT_MESSAGE_TTL: number;
10
+ export declare const DHT_TEXT_TOO_LONG = "DHT text is limited to 256 UTF-8 bytes. Shorten it or choose a live connection.";
11
+ export declare const DHT_PACKET_BUDGET = "Text and authentication exceed the DHT packet budget. Shorten the message.";
10
12
  /**
11
13
  * How far apart two devices' clocks may be for an envelope's expiry: a reader takes one until this long after `expires`
12
14
  * by its own clock. A device's clock a few minutes off is common; an envelope's lifetime is five or ten minutes, so a
@@ -85,5 +85,6 @@ export declare function decodeDnsResponse(data: Uint8Array, name: string, type:
85
85
  /** The TXT character-strings of one record, joined as RFC 7208 §3.3 does. */
86
86
  export declare function txtValue(rdata: Uint8Array): string;
87
87
  /** False for loopback, private, link-local, shared (CGNAT), multicast, reserved
88
- * and unspecified addresses, including IPv4 embedded in IPv6. */
88
+ * and unspecified addresses, including IPv4 embedded in IPv6, and for 6to4, Teredo and documentation IPv6, as
89
+ * Desktop's link_preview::is_public and apps/ui/src/lib/localHost.ts refuse them. */
89
90
  export declare function isPublicAddress(address: Uint8Array): boolean;
@@ -30,6 +30,7 @@ export declare const ENGINE_ERRORS: {
30
30
  readonly ecashBeingReceived: "This ecash is already being received";
31
31
  readonly ecashFeeTakesAll: "The mint keeps all {amount} sats of this ecash as its fee to take it in: nothing was redeemed, and its sender can still take it back";
32
32
  readonly ecashOtherUnit: "This ecash is in {unit}: only sat ecash can be redeemed here";
33
+ readonly ecashUnnamedUnit: "This ecash is in another unit: only sat ecash can be redeemed here";
33
34
  readonly reviewedEcashSpent: "The ecash for this payment was already spent somewhere else. Nothing was sent, and your balance now shows what the mint still holds.";
34
35
  readonly reviewedSatsGone: "The sats this payment was reviewed with went to another payment. Nothing was sent: review it again.";
35
36
  readonly mintFailedQuote: "{host} could not take this payment right now, and no sats left your wallet: try again later. The mint said: {reason}";
@@ -101,6 +102,11 @@ export declare class EngineError extends Error {
101
102
  /** The English text of `code` with its values in it, exactly as the engine writes it. */
102
103
  export declare function engineText(code: EngineErrorCode, values?: EngineErrorValues): string;
103
104
  export declare const engineError: (code: EngineErrorCode, values?: EngineErrorValues) => EngineError;
105
+ /**
106
+ * Why ecash of `unit` is not redeemed here. The unit is named only when it looks like one: a token's unit is whatever
107
+ * its sender wrote, and the line is the app's own (a contact's payment's refusal row, the CLI's answer).
108
+ */
109
+ export declare const ecashUnitError: (unit: string) => EngineError;
104
110
  /** The code and values of a text the engine wrote, or null for any other text (it is then shown as it is). */
105
111
  export declare function parseEngineError(text: string): {
106
112
  code: EngineErrorCode;
@@ -230,6 +230,25 @@ export declare const MESSAGE_RECEIVE_LIMITS: {
230
230
  readonly hourly: 1800;
231
231
  readonly hourWindowMs: 3600000;
232
232
  };
233
+ /** What `sendMessage` says of a text the contact's windows have no room for yet: it did not go (`MessagePace`). */
234
+ export declare const MESSAGE_PACED = "Your contact takes a limited number of texts at a time. It goes by itself once they can take more.";
235
+ /**
236
+ * The texts this side sent on a paired session, counted against the contact's windows (`MESSAGE_RECEIVE_LIMITS`), so
237
+ * none goes that the contact would refuse. A refused text went unconfirmed and came again with the outbox's backoff,
238
+ * after texts written later that found room meanwhile: the contact read them out of order. Past the hour's total it
239
+ * was sent until its attempts ran out, well inside the hour, and ended failed. Each counts from its receipt, the latest
240
+ * the contact can have taken it: counted from its send, a frame that sat in a queue was taken later than counted.
241
+ */
242
+ export declare class MessagePace {
243
+ private readonly now;
244
+ private sent;
245
+ constructor(now?: () => number);
246
+ /** The contact's windows have room for one more text now. */
247
+ room(): boolean;
248
+ took(id: string): void;
249
+ /** Its receipt came: the contact counted it by now. */
250
+ answered(id: string): void;
251
+ }
233
252
  /**
234
253
  * A `paired-message` frame. The preview (`pv`) is left out when the frame would pass `MAX_PAIRED_MESSAGE_FRAME`
235
254
  * with it: the text matters, the card does not. A reply (`r`, WISP 401 § Replies) is a few hundred bytes at most
@@ -818,6 +837,8 @@ export declare class GhostLink {
818
837
  private readonly editsReceived;
819
838
  /** Text frames the contact may send per window (`MESSAGE_RECEIVE_LIMITS`); the rest go unconfirmed and come again. */
820
839
  private readonly messagesReceived;
840
+ /** The texts sent to the contact, against their `messagesReceived` (`MessagePace`). */
841
+ private readonly messagesSent;
821
842
  /** Call signals the contact may send per window; the rest are dropped. */
822
843
  private readonly callsReceived;
823
844
  /** WebRTC signals the contact may send on the session (`paired-rtc`) per window; the rest are dropped. */
@@ -1082,6 +1103,8 @@ export declare class GhostLink {
1082
1103
  private get sessionBlocked();
1083
1104
  validateText(text: string, timestamp: number, id: string, reply?: WireReply): string | null;
1084
1105
  get canSendText(): boolean;
1106
+ /** A text on the live session would find room in the contact's windows now (`MessagePace`); the DHT floor has its own pace. */
1107
+ get textRoom(): boolean;
1085
1108
  get dhtDelivery(): DhtDeliveryView | undefined;
1086
1109
  /** The chat is on screen: on the DHT its mailbox is read at the signaling pace (WISP 403, poll pace). */
1087
1110
  setChatActive(active: boolean): void;
@@ -1684,6 +1707,13 @@ export declare class GhostLink {
1684
1707
  sendEdit(edit: WireEdit, { dht }?: {
1685
1708
  dht?: boolean;
1686
1709
  }): Promise<string | null>;
1710
+ /**
1711
+ * Why the DHT floor can never carry this edit, or null (WISP 403 § Edits): it goes there as a text with the edit's
1712
+ * element, which must fit the packet once sealed, as a text must (`validateText`). One past the 256 bytes never fits
1713
+ * it either, and says so with the same reason. Null off the floor, and for what only makes it wait there (a text
1714
+ * awaiting its receipt): that one goes in its turn.
1715
+ */
1716
+ dhtEditTooBig(edit: WireEdit): string | null;
1687
1717
  /** Confirms an edit of the contact's that waited for its message (`onMessageEdit` returned false). */
1688
1718
  confirmEdit(id: string, e: number): void;
1689
1719
  /**
@@ -594,7 +594,8 @@ export declare class CommunitySession {
594
594
  private adminSeen;
595
595
  /**
596
596
  * After the admin role moved to me (`metaFollowsChain`): whom from, until when I take their statement, and the last
597
- * one of theirs I signed again (what I held then, until one of theirs comes). In memory only.
597
+ * one of theirs I signed again (what I held then, until one of theirs comes). `vouched`: the latest of theirs another
598
+ * member's sync said it holds; `held`: the latest of theirs no other member has shown it holds yet. In memory only.
598
599
  */
599
600
  private takeover;
600
601
  /** The store's frames the app holds with their messages (`storeKey` → message id): in memory here, not in what is saved. */
@@ -1021,6 +1022,16 @@ export declare class CommunitySession {
1021
1022
  * (`reseal`) carries the first one's place inside: its author's are opened to tell.
1022
1023
  */
1023
1024
  forget(id: string): void;
1025
+ /**
1026
+ * The frames whose reply quotes a message deleted for everyone (`gone`): the line of it (`r.s`) is sealed with them,
1027
+ * and opens with the epoch secret this profile keeps. Mine is sealed again with an empty line, in its place, time and
1028
+ * reply, and signed again: a member who holds the first drops it as seen, one who missed it gets the reply without
1029
+ * the line. A member's I cannot sign again: it goes, and its author hands it on. Either way the row that held the
1030
+ * first gives it up; mine is saved with the state from then on.
1031
+ */
1032
+ private unquote;
1033
+ /** The key a stored frame is sealed with, when I hold its epoch's secret. */
1034
+ private messageKey;
1024
1035
  /** The id of the message a stored frame is, by its first place when it was said again (and I can open it). */
1025
1036
  private storedId;
1026
1037
  private keep;
@@ -1158,6 +1169,19 @@ export declare class CommunitySession {
1158
1169
  * be refused for good: a rename of theirs, or a member back from away, would then lose the group's call node.
1159
1170
  */
1160
1171
  private takesOver;
1172
+ /**
1173
+ * Whether a statement I would take (`takesOver`) was on its way when the role moved, as far as I can tell: a member
1174
+ * other than its signer handed it to me (a hub's relay included), or said in a sync it holds that one or a later one
1175
+ * under the same commit. The former admin alone could sign new ones after the hand-over, each taken for the whole group.
1176
+ */
1177
+ private vouches;
1178
+ /** The former admin's statement nobody else has shown it holds: the latest is kept until a sync does (`vouch`). */
1179
+ private holdTaken;
1180
+ /**
1181
+ * A member's sync names the statement it holds: one signed under a commit of the admin before me, by another member
1182
+ * than them, vouches for theirs up to it, and the one held is taken if it now is.
1183
+ */
1184
+ private vouch;
1161
1185
  /**
1162
1186
  * The former admin's statement, taken (`takesOver`): signed again as mine, each field I changed since keeping my
1163
1187
  * value. Dated as theirs, and credited to them, when I changed nothing; what I held was then no change to hand on.
@@ -513,7 +513,8 @@ export declare class GroupSession {
513
513
  private adminSeen;
514
514
  /**
515
515
  * After the admin role moved to me (`metaFollowsChain`): whom from, until when I take their statement, and the last
516
- * one of theirs I signed again (what I held then, until one of theirs comes). In memory only.
516
+ * one of theirs I signed again (what I held then, until one of theirs comes). `vouched`: the latest of theirs another
517
+ * member's sync said it holds; `held`: the latest of theirs no other member has shown it holds yet. In memory only.
517
518
  */
518
519
  private takeover;
519
520
  /** While `handle` runs: the frames it took that a hub passes on (`handle`'s result). */
@@ -785,9 +786,15 @@ export declare class GroupSession {
785
786
  * My message `id` was deleted for everyone: its frame, and each copy said again, keep their place in my log (`nextSeq`,
786
787
  * `couldRead`, the removal's copies) and lose what they said. The log is in the saved state beside the epochs' secrets,
787
788
  * so the text stayed readable from the profile until 32 later sends pushed it out (`message delete --purge` promises
788
- * it leaves the folder). Saved soon, as a community's `forget`; `flush` writes it now.
789
+ * it leaves the folder). A reply of mine that quotes it keeps its place and its reply, its line sealed again empty
790
+ * and signed whole again (`sig` does not cover the box). A member's frame of it, or quoting it, I kept to hand on goes:
791
+ * I cannot sign theirs, and its author hands it on. Saved soon, as a community's `forget`; `flush` writes it now.
789
792
  */
790
793
  forget(id: string): void;
794
+ /** The reply a frame's box holds, when it quotes `id` with a line of it. */
795
+ private quoting;
796
+ /** My frame `f` without the line of `id` it quotes (`forget`); `f` itself when it quotes none. */
797
+ private unquoted;
791
798
  /**
792
799
  * Saves, then sends my frame to every other member of its epoch still in the group (`saved`: the caller saved it). One no edge took (none was up:
793
800
  * my app just opened) is remembered (`alone`): I may be behind on the chain without knowing, and members let in
@@ -1058,6 +1065,19 @@ export declare class GroupSession {
1058
1065
  * be refused for good: their next rename, picture or hubs change would then be built on the older body.
1059
1066
  */
1060
1067
  private takesOver;
1068
+ /**
1069
+ * Whether a statement I would take (`takesOver`) was on its way when the role moved, as far as I can tell: a member
1070
+ * other than its signer handed it to me, or said in a sync it holds that one or a later one under the same commit.
1071
+ * The former admin alone could sign new ones after the hand-over, each taken for the whole group.
1072
+ */
1073
+ private vouches;
1074
+ /** The former admin's statement nobody else has shown it holds: the latest is kept until a sync does (`vouch`). */
1075
+ private holdTaken;
1076
+ /**
1077
+ * A member's sync names the statement it holds: one signed under a commit of the admin before me, by another member
1078
+ * than them, vouches for theirs up to it, and the one held is taken if it now is.
1079
+ */
1080
+ private vouch;
1061
1081
  /**
1062
1082
  * The former admin's statement, taken (`takesOver`): signed again as mine, each field I changed since keeping my
1063
1083
  * value. Dated as theirs, and credited to them, when I changed nothing; what I held was then no change to hand on.
@@ -35,6 +35,19 @@ export declare const IDENTITY_MAX_RECEIVED = 16;
35
35
  /** `idp-*` frames a paired session reads from the contact per `IDENTITY_FRAME_WINDOW_MS`; the rest are dropped unread. */
36
36
  export declare const IDENTITY_FRAME_LIMIT = 40;
37
37
  export declare const IDENTITY_FRAME_WINDOW_MS = 60000;
38
+ /**
39
+ * `idp-*` frames this side sends a contact per `IDENTITY_SEND_WINDOW_MS`, so that the person's own shares and stops fit
40
+ * the contact's per-chat limits above and none is dropped unread there. Lower than the contact's count over a longer
41
+ * window: frames can arrive closer together than they left.
42
+ */
43
+ export declare const IDENTITY_SEND_LIMIT: number;
44
+ export declare const IDENTITY_SEND_WINDOW_MS: number;
45
+ /**
46
+ * A request or withdraw the contact did not answer is sent again after this (ms), twice as long each time, at most
47
+ * `IDENTITY_RESENDS` times a connection; past that it waits for the next one, as before.
48
+ */
49
+ export declare const IDENTITY_RESEND_MS = 60000;
50
+ export declare const IDENTITY_RESENDS = 4;
38
51
  /**
39
52
  * A proof this side holds verified, presented again with the same evidence between the same keys, is answered from that
40
53
  * check while it is younger than this (seconds): the contact chooses how often it presents, and each check costs this
@@ -214,6 +227,11 @@ export interface IdentityExchangeOptions {
214
227
  revoked?(statement: IdentityStatement): Promise<boolean>;
215
228
  now?(): number;
216
229
  onError?(error: string): void;
230
+ /**
231
+ * Off: every frame goes at once and nothing unanswered is sent again in a connection (for tests that play a contact
232
+ * sending past the limits). On by default: `IDENTITY_SEND_LIMIT`, `IDENTITY_RESEND_MS`.
233
+ */
234
+ paced?: boolean;
217
235
  }
218
236
  export type IdentityStatus = "verified" | "expired" | "withdrawn" | "revoked" | "unconfirmed" | "previous-key";
219
237
  /** What the verifier should show for a received proof right now. */
@@ -254,17 +272,37 @@ export declare class IdentityExchange {
254
272
  private checking;
255
273
  /** When the contact's presentations were checked with their provider (seconds), for `IDENTITY_MAX_CHECKS_PER_HOUR`. */
256
274
  private checks;
275
+ /** When this side sent its recent frames (ms), for `IDENTITY_SEND_LIMIT`. Kept across connections, as the contact's count is. */
276
+ private sentAt;
277
+ /** Hello, answers and presentations waiting for room in that window, in order (`proof`: a presentation's). */
278
+ private outbox;
279
+ /**
280
+ * This connection's request or withdraw per proof: when it (or its presentation) last went, how often, and whether its
281
+ * presentation went. Requests and withdraws are built from the ledger when their turn comes, so one stopped or
282
+ * answered meanwhile never goes.
283
+ */
284
+ private attempts;
285
+ private timer;
257
286
  constructor(options: IdentityExchangeOptions);
258
287
  private now;
259
288
  /** The ledger with one more step on the chat's timeline, in milliseconds (a test's clock, in seconds, when given). */
260
289
  private log;
261
290
  private incomingScope;
262
291
  private send;
292
+ /** Sends one frame and counts it; false when the channel is gone (what waits is sent on the next connection). */
293
+ private transmit;
294
+ private static resendAfter;
295
+ /**
296
+ * Sends what fits the contact's limits now and sets a timer for the rest: the waiting answers first, then requests
297
+ * (at most `MAX_CHALLENGES` open, each keeping room in the window for its presentation) and withdraws, then the
298
+ * unanswered ones again once their time is up.
299
+ */
300
+ private pump;
263
301
  private shared;
264
302
  private setShared;
265
303
  /** The providers the contact said it verifies; undefined until its hello. */
266
304
  get contactProviders(): readonly string[] | undefined;
267
- /** The channel is ready: say what we verify, then send what the person queued while offline. */
305
+ /** The channel is ready: say what we verify, then send what the person queued while offline, paced (`pump`). */
268
306
  ready(): void;
269
307
  stop(): void;
270
308
  /**
@@ -276,7 +314,6 @@ export declare class IdentityExchange {
276
314
  private withoutExpired;
277
315
  /** Share a proof of this profile with this contact: now if connected, else when it next is. */
278
316
  share(id: string, connected: boolean): Promise<void>;
279
- private request;
280
317
  /** Stop sharing here. The contact is told (now or on reconnect); a copy it kept cannot be erased. */
281
318
  withdraw(id: string, connected: boolean): Promise<void>;
282
319
  /**
@@ -64,7 +64,7 @@ export * from './pkdns.js';
64
64
  export * from './pubkyProofs.js';
65
65
  export * from './pubkyRing.js';
66
66
  export * from "./capsRecord.js";
67
- export { DhtDelivery, peekDhtMailbox, DHT_TEXT_BYTES, DHT_MESSAGE_TTL, DHT_TEXT_REFUSED, DHT_FILE_REFUSED, DHT_FILE_TOO_LARGE, LIVE_POLL_MS, ACTIVE_DHT_POLL_MS, emptyDhtDeliveryState, type DeliveryMode, type DhtDeliveryState, type DhtDeliveryView, type DhtPacketFacts } from "./dhtDelivery.js";
67
+ export { DhtDelivery, peekDhtMailbox, DHT_TEXT_BYTES, DHT_PACKET_BUDGET, DHT_MESSAGE_TTL, DHT_TEXT_REFUSED, DHT_FILE_REFUSED, DHT_FILE_TOO_LARGE, LIVE_POLL_MS, ACTIVE_DHT_POLL_MS, emptyDhtDeliveryState, type DeliveryMode, type DhtDeliveryState, type DhtDeliveryView, type DhtPacketFacts } from "./dhtDelivery.js";
68
68
  export { DHT_FILE_CAPABILITY, dhtFileId, dhtFileElements, readDhtFile, type DhtFileAnnouncement, type DhtFileElement, type DhtFileMeta, type DhtFileOffer } from "./dhtFiles.js";
69
69
  export * from "./storeForward.js";
70
70
  export * from "./ratchet.js";