Sending mail

sithbit mail send <to> \
  [--from <address>] \
  (--cid <cid> | --path <file>) \
  [--keypair <keypair>] \
  [--skip-preflight]

--from defaults to the sending keypair’s own address. Exactly one of --cid or --path is required:

sithbit mail send jane_doe@sithbit.com \
  --from john_doe@sithbit.com \
  --path ./message.eml

Important: --path only computes the local file’s IPFS content identifier (CID) from its bytes — it does not upload or pin the content anywhere. Before the recipient can actually fetch and decrypt the message, the file must be separately pinned to IPFS (for example, through the embedded node in your own sithbitd, or a shared sithbit-ipfsd). --cid is for content that’s already pinned somewhere — you supply its known CID directly instead of a local file.

The --from address determines which frombox is charged: sending burns exactly one stamp from that frombox (see Add stamps for what a stamp is worth), so the frombox for <from> → <to> must exist and have at least one stamp before the send will succeed.

Neither address string reaches the chain: the instruction carries only the blake3 hash of the normalized --from address (the frombox seed), and the recipient is identified by the wallet the message account’s PDA seeds on. The readable From:/To: headers travel solely inside the sealed body — see the threat model for exactly what an observer can and cannot learn.