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

Mailboxes

A mailbox is an account on Solana that stores email settings for an address. An address must have an associated mailbox created before participating in the email system, and an address can only have one mailbox.

Looking up a mailbox

sithbit mailbox get [owner_address]

owner_address is optional and defaults to the address of your own configured keypair, so sithbit mailbox get with no arguments looks up your own mailbox.

A mailbox has the following settings:

  • Mail count. The total number of emails sent to the mailbox since it was created.
  • Default Postage. The default price of a stamp in lamports to send an email to the mailbox. When you create a new frombox, this value is used initially for the stamp price for the frombox unless otherwise specified. The default price should be set very high to prevent SPAM from being sent to the mailbox.
  • Domain. The program address that represents the internet domain associated with the mailbox. You can change the domain for your account at any time, but in order for email to be properly routed to your mailbox, the owner of the domain must have registered the domain with the email program. In addition, the domain must host MX servers that support the email program protocol.

See Appendix: Closing accounts for how to close a mailbox you no longer need.