Unseenet Working Group A. Lorensen
UN-RFC: 0009 October 2026
Category: Standards Track
Status: Draft
Updates: 0002, 0004, 0005
Unseenet: Inbox Groups and Local Groups
Abstract¶
This document adds a fifth group type, inbox: anyone may post, only the owner can read. Posts are sealed to the owner's key, and the outer article is signed by a one-time key, so nodes learn neither the content nor the sender. Inboxes provide private messages between people, a way to contact node operators, and a submission queue for moderated groups. The document also defines local groups, which are never replicated between nodes.
1. Motivation¶
UN-RFC 0004 offers no way to write privately to a person who has not first invited you into a closed group. That leaves three gaps:
- two people cannot exchange private messages;
- nobody can privately contact a node's operator (e.g. about abuse);
- a post awaiting approval in a moderated group has no private path to the moderators (the problem reserved for this number in UN-RFC 0000).
An inbox closes all three with one mechanism.
2. Inbox Groups¶
2.1 Manifest¶
An inbox is a group (UN-RFC 0004) whose manifest has "type": "inbox".
All other manifest rules apply. Owners SHOULD set a short
retention_days (RECOMMENDED: 30); the owner keeps what they want to
keep in their own client.
2.2 Well-known Inbox of an Identity¶
The group named inbox owned by an identity is that identity's
personal inbox:
inbox@<fingerprint of the identity's key>
Because the Group ID is derived from the key, anyone who knows a person's key knows where to write to them. A client MAY create a personal inbox automatically when an identity is created.
2.3 Inbox Articles¶
An ordinary article in an inbox group MUST:
- have
Encrypted: sealedbox; - NOT have
FromorSubjectin the outer header block; - be signed (
Author-Key,Signature) by a fresh one-time key that is used for no other article; - have as body the b64 encoding (lines of at most 76 characters) of a sealed box (UN-RFC 0003 section 4.1) to the owner's key, containing the inner article.
The inner article is in article syntax and carries:
| Header | Required | Value |
|---|---|---|
From |
yes | Sender's display name |
Subject |
yes | Subject |
Sender-Key |
no | Sender's real identity key |
Sender-Signature |
with Sender-Key |
See below |
Reply-Inbox |
no | A Group ID where the sender wants replies |
Content-Type |
no | Default text/plain; charset=utf-8 |
Sender-Signature is a signature by Sender-Key (UN-RFC 0003 section
3), purpose UNSEENET-INBOX-SENDER-1, over
group-id || 0x00 || outer-author-key-text || 0x00 || C_inner
where C_inner is the canonical form (UN-RFC 0002 section 3) of the
inner article without Sender-Signature. Binding the outer one-time key
and the group prevents the inner article from being lifted into another
message or another inbox.
An inner article without Sender-Key is anonymous. Clients MUST show
such messages as anonymous and MUST NOT display a From name as if it
were verified.
2.4 Node Rules¶
Nodes cannot check who may write to an inbox, because everybody may. A
node MUST reject an ordinary article in an inbox group unless it meets
section 2.3 as far as a node can see: Encrypted: sealedbox, no outer
From/Subject, and a valid outer signature and postage.
Owners of inboxes that receive spam SHOULD raise min_pow in the
manifest. Nodes MAY apply a higher minimum postage to inbox groups than
to other groups.
2.5 Replies¶
A reply is a new inbox article to the sender's Reply-Inbox (or to
inbox@<fp of Sender-Key> if that is absent), with References set to
the Message-ID of the article replied to.
3. Submissions to Moderated Groups¶
A moderated group's manifest MAY name an inbox in a new field:
| Field | Type | Meaning |
|---|---|---|
submissions |
Group ID | Inbox owned by the group owner or a moderator |
To submit, a client builds the article for the moderated group exactly
as it would post it (signed, with postage and Message-ID), and sends it
as the body of an inbox article to submissions, with
Content-Type: message/unseenet in the inner headers.
The moderator approves by adding Approved-By and Approval (UN-RFC
0004 section 5) and posting the original article to the group. Its
Message-ID is unchanged, so replies and references made before approval
remain valid. Rejection needs no message, but a moderator MAY reply.
This replaces the reservation of UN-RFC 0009 for a moderation queue.
4. Local Groups¶
A manifest MAY contain:
| Field | Type | Default | Meaning |
|---|---|---|---|
local |
boolean | false |
The group exists on one node only |
For a local group a node:
- MUST NOT offer its manifest or articles to peers;
- MUST reject its manifest and articles when they arrive from a peer (as opposed to from a client);
- otherwise treats it like any group of its type.
Local groups are for things that belong to one node, such as its
operator's inbox (UN-RFC 0011), a node's own announcements, or a group
for the people using one node. They correspond to the local hierarchies
and Distribution: local of Usenet.
local cannot be changed by a later manifest (UN-RFC 0004 section 4,
step 4, is extended accordingly).
5. Changes to Other Documents¶
- UN-RFC 0002 section 2.3:
Sender-Key,Sender-SignatureandReply-Inboxappear only in inner articles and are listed there. - UN-RFC 0003 section 3: purpose
UNSEENET-INBOX-SENDER-1is added. - UN-RFC 0004 section 2: type
inboxis added; section 3.1: fieldssubmissionsandlocalare added. - UN-RFC 0005 section 5.2: local groups are never queued for peers.
6. Security and Privacy Considerations¶
- What a node sees: that an inbox received a message of a certain size at a certain time. It does not see the content, the sender (the outer key is used once), or whether a sender identified themselves.
- Timing: a reply sent soon after a message arrives may let an observer of several nodes link the two. Clients MAY delay replies.
- Deniability: a message with
Sender-Keyis provably from that sender to anyone the owner shows it to. Senders who need deniability should omitSender-Key. - No forward secrecy: if an owner's key is compromised, all stored messages to it can be decrypted. Owners SHOULD keep inbox retention short.
- Spam: an inbox is open by design. Postage is the defense; clients
SHOULD also let owners ignore messages without
Sender-Keyor from unknown keys.
Copyright Notice¶
Copyright (c) 2026 the persons identified as the document authors.
This document is licensed under CC BY 4.0, see rfc/LICENSE.md.