Rooms
Start a room, invite wallets, write to everyone at once, and change who is in it.
A room is a conversation between several wallets that share one key. A message to the room is one transaction, however many members it has, and every member's device finds it with the room's key. The chain holds nothing that says a room exists: its messages are Log entries like any other.
Start a room#
Press Room at the top of the list, or open New room at /app/rooms/new.
Name it
Type a Name. Only members see it: it travels inside the invitations, never in the open.
Add members
Type each wallet into Add by wallet address or .sol name and press Add. Each member shows Inbox open or No inbox. Every member needs an inbox to receive the room's key, so a member without one holds the room back: press Remove beside them, or wait until they open one. Above the list, the count of members includes you.
Create the room
The figure beside Create room is the number of invitations, one message from your pass for each member besides you, and the line under it says how many of today's messages they use. Press Create room. It reads "Sending invitations" with the count, each member shows Sending… and then Invited, and the room opens.
Create room waits until the room has a name, every member has an inbox, and your pass has a message left today for every invitation. The line under the count says which of these is missing.
Invitations#
Each invitation is a message from you to one member. It carries the room's name, its members and its key, and its text reads "Invitation to" and the room's name. It also appears in your thread with that member, and on their side it arrives like any first message from you.
On a member's device, the room appears under Requests as "Invitation" with its number of members. Opening it shows "You are invited to this room. Accepting adds its key to this device."
- Accept joins the room. From then on the member reads its messages and can write to it.
- Decline takes the room off their list on this device.
Neither signs anything or sends anything, and neither tells the other members. Members at the top of the room shows who is in it before you choose.
Write in a room#
A joined room reads and writes like a thread. Each message from another member shows who wrote it above the text, and yours show as your own. A message to the room uses one message from your pass for each part, the same as a message to one wallet, whatever the number of members.
Every member's device checks which member wrote each message: holding the room's key is enough to read, never to write as someone else.
Change who is in a room#
Press Members in a room you have joined. Every joined member can add and remove, and the panel shows the room's key version, which goes up by one with every change.
| Action | What you press | What is sent |
|---|---|---|
| Add a member | type into Add a member and press Add; it reads Sending key… | the room's key, to every member besides you, the new one included |
| Remove a member | Remove beside them; it reads Sending new key… | a notice to the removed member, then a new key to everyone who remains |
| Leave | Leave room; it reads Leaving… | a new key to everyone who remains |
A new member needs an inbox, the same as at the start. If a change doesn't go through, the reason shows at the foot of the panel.
Removed and left#
A room you left reads "You left this room. What you already received stays here." on every device of your wallet, and a room you declined reads "You declined this room."; neither has a composer. A removed member's room stays in their list as "You were removed from this room". Inside it reads: "You were removed from this room. Its key was changed; what you already received stays here." Messages written after the change are under the new key, which they don't hold.
When you leave, the room goes from your list on every device of your wallet. What you received before leaving stays where it was, and messages written after are under a key you don't hold.
What each action uses#
Rooms cost no SOL. Each action uses messages from the sender's pass, one each. With n members besides you, after the change:
| Action | Messages from your pass |
|---|---|
| Create a room | n |
| Send a message | 1 per part |
| Add a member | n, the new member counted |
| Remove a member | n + 1: the members who remain, and the notice to the removed member |
| Leave | n, the members who remain |
| Accept or decline | none |
A room on another device#
A room you created or have written in is joined on every device of your wallet. A room you accepted but never wrote in waits as an invitation on your other devices, to accept there too. A room you were removed from comes back as removed, and a room you left stays gone. If you open a room your device doesn't hold, it reads "This room is not on this device." Your keys and devices gives what a new device reads.
How the room key and the writer checks work, for developers: Cryptography and Scanning.