Skip to content
Open app

Using TalariaYour keys and devices

Your keys and devices

The one message your wallet signs, what each device keeps, using a second device, rotating your inbox key, blocked wallets and sound.

Every key Talaria uses for you comes from one message your wallet signs. Nothing secret leaves your device, and nothing is kept anywhere that your wallet can't make again. Keys at /app/keys holds your inbox, your private links, your history on this device, sound and the wallets you have blocked.

The key message#

When the app opens, it asks your wallet to sign one fixed message, under Make your keys with Sign the message. Your wallet shows it as:

Text
Talaria private inbox
Version: 1
Wallet: <your address>
Sign to derive your inbox and local history keys. This does not send a transaction.

It is not a transaction: it costs nothing and moves nothing. From that one signature your device makes every key: your inbox key, the secret behind each pass you buy, the key of each private link, and the key that locks your history on this device.

Your wallet gives the same signature for the same message every time, so the same keys come out on every device you use. That is why nothing else needs to be stored or backed up: your wallet is the backup. The keys stay in the app's memory while it is open, so each time you open the app it asks for the signature again.

If you decline in your wallet, the app reads "The wallet didn't sign the key message. Nothing was sent." Press Sign the message to try again, or Use another wallet to switch.

What each device keeps#

Each device keeps its own copy of your history in this browser, locked with the key from your signature: your messages, threads, rooms, private links and how far it has read the Log. No server holds a copy, and the copy can't be read without your wallet's signature. Each wallet you connect has its own.

Your messages themselves live in the Log. Every message you send carries a second key slot that only your own inbox key opens, so your sent messages come back on any device, along with everything written to you.

Some choices are kept only on the device where you make them:

ChoiceOn your other devices
Accepting a requestthe thread waits as a request again, until you write in it
Blocking a walletnot blocked
Accepting a room invitationwaits as an invitation, until you write in the room
Declining a room invitationwaits as an invitation
Unread countscounted on each device
Sound on or offset on each device

Writing in a thread or a room carries it to every device, because your own message comes back to each of them.

A second device#

  1. Connect the same wallet

    Open /app on the other device and press Connect wallet.

  2. Sign the key message

    The same signature gives the same keys: every version of your inbox key, every pass and every private link.

  3. Read the Log

    A device with no history of yours reads the Log from its first entry, showing the entry it has reached out of the Log's length. Then the app opens with your threads, your rooms, your sent messages, your private links and your pass.

If the app shows "The indexer can't be reached right now.", the device couldn't download the Log. Your messages are still on chain; press Read again.

Restore history on this device#

Restore in Keys reads the whole Log again from its first entry, on the device you are using, and rebuilds every thread and room, the messages you sent included. It shows the entry it has reached, the Log's length and how many messages it has found, then "Done." with the count, and the button becomes Restore again. Restore signs nothing and sends nothing.

Use it when this device is missing something it should hold, such as the messages a wallet sent while you had it blocked. Restore needs an open inbox. If a restore fails, the reason shows under the section with Nothing on this device was changed., and you can press Restore again.

Your inbox#

The Inbox section shows your Inbox key, the key anyone writes to; Opened, the date your inbox opened and the slot it opened in; and Key version, which starts at 1. A wallet without one reads "This wallet has no inbox."; Send your first message opens one.

Opening an inbox is a public transaction from your wallet: anyone can see that the wallet has an inbox and its key, and nothing about what is written to it.

Rotate your inbox key#

Rotate inbox key replaces the key anyone writes to with the next version, made from the same signature.

  1. Sign in your wallet

    Press Rotate inbox key. It reads Rotating…, and your wallet asks you to sign one transaction.

  2. Confirming

    The transaction lands on chain.

  3. New key in use

    Key version goes up by one. Messages written to you from now on use the new key.

Messages written to an earlier key still open on every device of yours, because every version comes from the same signature and your devices try each of them. Your passes, rooms and private links carry on unchanged.

Rotation changes an account you already have, so it costs only the network fee, paid in SOL by your wallet. Like opening the inbox, it is public: anyone can see that your inbox key changed. If it fails, the reason shows with "The key was not changed."

Blocked wallets#

Blocked wallets lists every wallet you have blocked on this device, each with Unblock. With none, it reads "None. A blocked wallet's messages are dropped on this device." Threads and requests covers blocking.

Sound#

The app plays a sound when a message is sent, when its proof is done, when it lands, when one is received, and when something fails. The switch under Sound reads "On" with those moments, or Off. Sound starts on, and the switch is kept in this browser.

Your wallet#

The wallet mark in the app's rail opens Connected wallet, with Copy address and Disconnect. Disconnecting closes your history on this device until the same wallet connects and signs again; nothing is deleted.

Where every key is derived from, for developers: Inboxes and keys and Cryptography.