Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Create a mailbox

To create a mailbox, you must first create a Solana wallet — run sithbit wallet create (see Getting Started).1

You should also have identified a mail / mx domain (e.g., “sithbit.com”) with which you want to associate you wallet address, but this can be done later. Note that the mail domain you choose might require additional configuration before the mail servers will relay mail for you. For example, the domain might require you to sign up first before it offers POP or IMAP services for your email.

The domain must already be registered and active on-chain — creating or updating a mailbox verifies the domain account and refuses unregistered or deactivated names. A wallet has exactly one mailbox, and a mailbox names exactly one domain (switch it later with sithbit mailbox update --domain); receiving under two domains at once means using two wallets.

No encryption setup is required: mail servers seal mail straight to your wallet address, and your wallet keypair file decrypts it. Only wallets that cannot expose a decryption key (hardware and browser wallets, which can only sign) need to publish a delegated encryption key.

sithbit mailbox create \
  --default-postage 100000 \
  --domain sithbit.com \
  --keypair <path to wallet keypair>

  1. If you already have the Solana CLI/SDK installed, its own wallet setup works just as well. ↩