Send your first message
Connect a wallet, open an inbox, buy a pass, write to someone, and turn the message over to see what the chain holds.
This page goes through the app once: from a wallet with some SOL in it to a message that has landed, a reply, and the Log entry that holds your message. Each step says what your wallet signs and what it pays.
What each step costs#
| Step | Your wallet signs | Your wallet pays |
|---|---|---|
| Connect | nothing | nothing |
| Make your keys | one fixed message, not a transaction | nothing |
| Open your inbox | one transaction | the inbox's rent, once, and the network fee |
| Buy a pass | one transaction | the pass price and the network fee |
| Send | nothing | nothing: the message uses one of your pass's messages for the day |
The inbox's rent is 0.00116332 SOL at the mainnet rate (0.00159384 SOL on the local validator). The network fee is the base fee of 0.000005 SOL plus the priority fee your wallet shows before you sign. The smallest pass costs 0.0075 SOL (development default); Passes gives all nine prices.
Before you start#
- A Solana wallet in your browser, such as Phantom, Solflare or Backpack, holding enough SOL for the rent, a pass and two network fees.
- The address or
.solname of someone who has opened an inbox. To try both sides yourself, use a second wallet in another browser profile.
Get in#
Connect wallet
Open /app and press Connect wallet. With one wallet installed it connects straight away; with several, choose one. Connecting moves nothing. If the app finds no wallet, it says so: install one and reload the page.
Once a wallet is in, the screen shows its address and three steps. Use another wallet at the top disconnects it.
Make your keys
Press Sign the message. Your wallet shows a fixed text that names Talaria and your wallet's address, and says it does not send a transaction. Sign it, and confirm in your wallet.
From that one signature your device makes every key Talaria uses: your inbox key, the keys to your passes, and the key that locks your history on this device. Nothing else is stored anywhere, and the same signature makes the same keys on any device. Your keys and devices covers what each one is for.
Open your inbox
Press Open my inbox and sign the transaction. The button reads Confirm in your wallet, then Landing on chain. This registers the key anyone writes to you with, and your wallet pays its rent and the fee.
Then your device reads the Log for anything addressed to you, showing the entry it has reached out of the Log's length.
Receive your first message
A few seconds after your inbox opens, Talaria's own wallet, talaria.sol, writes you one message. It is sent through the pool and a relay like any other, and the screen says Waiting for it to land until it does. Then the screen shows it twice: as you read it, and as the chain holds it, with sender none · recipient none. It reads:
Welcome to Talaria. This message reached you as one transaction, carried by a relay. Turn it over with On chain and look for your address, or mine: neither is there.
Press Start writing to open the app, or Open it in the Log to see its entry. In the app it waits under Requests, the first thread in your list. Turn it over with On chain, as Turn a message over shows, and look for your address or talaria.sol's: neither is there.
If it takes more than a minute, Start now, it will be in your threads opens the app anyway, and the welcome arrives under Requests when it lands.
A wallet that already has an inbox signs the key message, reads the Log and opens the app. There is no welcome the second time.
Buy a pass#
Open Pass in the rail, or press Get a pass to write at the top of your threads. Choose Messages a day and a Length, check the price and the line under it (the daily limit × the days × the price of one message), and press Buy a pass. Sign the transaction.
The stages read Sign in your wallet, Confirming, In the pool. Then the page says Your pass is in the pool. with a link to the transaction, and shows your meter. The top of your threads now reads how many messages you have left today.
Passes gives the tiers, the prices, how the day is counted and what the meter shows.
Start a thread#
Press Write above your threads to open New thread, and type an address or a .sol name in Wallet address, .sol name, or a private link. The app looks it up on your device as you type:
| It shows | What it means | What to do |
|---|---|---|
| Looking it up… | the name or address is being found | wait a moment |
| Inbox open with Start thread | the wallet has an inbox | press Start thread |
| No inbox | the wallet has never opened one, so there is no key to lock a message to | write once it opens one |
The field under Write to an address or a name. on Threads does the same in one line: it shows the name with inbox open or no inbox yet, and its arrow opens the thread. A name or address the app can't find says why; When something fails lists each line. Pasting a private link into either opens the link instead; see Private links. Threads and requests covers the thread list.
Send#
Write in the field and press Enter or the send button. Shift and Enter start a new line. Before you send, the line under the field says how many messages the text takes and how many you will have left today. A long text goes as several parts, one transaction each, and each part uses one of the day's messages.
Your message appears in the thread at once and moves through four stages:
Encrypting
Your device locks the message to the reader's inbox key, and a second copy to your own, so your other devices can read what you sent. Your address travels inside, where only the reader sees it.
Proving
Your device proves that you hold a pass with a message left today, without saying which pass. One proof took 1,400 ms in a browser when it was measured.
Relaying
A relay puts the message on chain and signs the transaction. Your wallet signs nothing. If a relay doesn't answer, the message says trying another relay and goes on with the next one.
Landed
The message is in the Log. It shows Landed under its time, and the count at the top of your threads goes down by one for each part.
If a message can't be sent, it shows the reason in place of its stages, with Send through another relay and Discard. When something fails goes through every reason.
The reply#
The app keeps reading the Log while it is open. When a reply arrives, it lands in your thread and the app plays a sound. If you are elsewhere in the app, a notice shows who wrote and the first line; press it to open the thread. The thread moves to the top of your list with its unread count.
Your first message reaches the other person the same way, as a request, since your wallet is new to them. They see Accept and Block until they accept; then they can write back. Threads and requests covers requests.
Turn a message over#
Beside every message is its signature, cut short. That is its On chain control: press it and a panel opens with everything the chain holds for that message. It lists Signature, Slot, Time, Relay, Day, Nullifier, Proof, Key slot 1, Key slot 2 and Ciphertext, and ends on Of this, what identifies the writer or the reader: Nothing. A message sent in parts has a tab for each part. Close, or Escape, puts it away.
Open this entry in the Log opens the same entry on /log, where anyone can read it, with the result of checking its proof. What the chain sees explains each part.
If the panel says Not yet indexed., the message has landed and the Log hasn't caught up yet. Press Read again after a moment.