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

Mailbox credentials

See Addresses for how your wallet address is your mail identity. This page covers the sithbit mailbox credentials command.

sithbit mailbox credentials \
  [-k, --keypair <path>]

credentials prints the username/password pair a stock mail app uses to authenticate to the SithBit SMTP/IMAP/POP servers as your wallet — with no separate stored password. The username is your wallet address (the base58 public key); the password is a base58 wallet signature over a fixed challenge that embeds that same public key, so a captured password cannot be replayed as another wallet. The servers verify the signature against the username, and nothing is stored server-side — the signature is self-proving.

The command is fully offline: it contacts no RPC endpoint, reads nothing on-chain, and writes no files. Both values are derived purely from the local wallet keypair, and because the signature is deterministic, re-running the command for the same keypair prints the identical pair every time — paste it into a mail app once and you are done.

Arguments

  • -k, --keypair <path> (optional) — the wallet keypair file the credentials are derived from. Defaults to the keypair in your Solana CLI config when omitted.

Using the credentials

Enter the printed pair in your mail client as its ordinary username and password — SASL PLAIN over TLS for IMAP/submission, or the plain POP3 PASS login. The password is bearer-equivalent for the connection, so always use TLS. The client walk-throughs show exactly where each value goes, and how the browser/mail-app extensions derive the same pair without the CLI: Thunderbird and Outlook.

Examples

Print the credentials for the Solana CLI config’s default wallet:

sithbit mailbox credentials

Derive them for a specific keypair file:

sithbit mailbox credentials -k ~/.config/solana/id.json
  • Create a client certificate — the password-less alternative: a TLS client certificate that logs the same wallet in over SASL EXTERNAL, for servers with client-certificate auth enabled.
  • Create a mailbox — the credentials log you in to a server account; the mailbox is what receives your on-chain mail.
  • Looking up a mailbox — inspect a mailbox’s settings.