Revenue snapshot: sithbit earnings

sithbit earnings \
  [--owner <PUBKEY>] \
  [--from <ADDRESS>]...

A read-only holdings and revenue snapshot for one wallet — the bookend to sithbit setup: setup gets a brand-new user configured, earnings shows an existing recipient what their wallet holds and has taken in, and it only ever reads. It prints, in order:

• Wallet balance — the wallet’s native SOL balance.
• Mailbox asking price — this wallet’s default postage (the price a new sender pays), or a note that the wallet has no mailbox yet.
• Postoffice balance (delegate) — the singleton postoffice balance. This line appears only when the queried wallet is the postoffice’s standing delegate, and is omitted entirely for everyone else.
• Prepaid stamps — for each sender named with --from, the prepaid stamps that sender holds against this wallet plus the lamports held in that frombox, or none prepaid when no frombox exists for that pair.

Arguments

• --owner <PUBKEY> — the wallet to report on. Accepts a base58 pubkey or a keypair-file path; defaults to your configured signing keypair.
• --from <ADDRESS> — a sender address to report prepaid stamps for. Repeatable; each occurrence adds one Prepaid from … line.

--from is the only per-sender lookup — by design

earnings reads only the handful of accounts your wallet’s PDAs point at directly: its balance, its mailbox, the singleton postoffice, and the specific fromboxes you name. It deliberately does no chain-wide scan, so there is no wallet-wide enumeration of the senders who have prepaid you. To see a sender’s prepaid balance you must name that sender explicitly with --from — one flag per sender. Passing no --from prints a one-line hint instead of a per-sender list.

USD figures are best-effort

Every SOL figure is annotated with an approximate USD value (e.g. 1.5 SOL (~$210.00)) when a live SOL→USD rate is available. The rate fetch is fail-soft: any hiccup — no network, a slow or erroring price API — simply drops the dollar annotations and prints the bare SOL amounts. A pricing outage never blocks or fails the report.

The same best-effort SOL→USD annotation rides sithbit frombox get automatically — the asking price and held balance gain dollar tails whenever a rate is available. On sithbit mailbox get it is opt-in: pass --usd to annotate the asking price; without the flag it prints bare lamports exactly as before. The fetch is fail-soft the same way — a pricing outage just drops the dollar tails.

Example

A recipient checking their own snapshot and one known sender’s prepaid stamps, with a live rate available:

$ sithbit earnings --from [email protected]
Earnings summary for 85FZrun1Eb5bdkbFCDjaFSTLnBfnx6sUFHa5BiYH2Q0
  Wallet balance: 1.5 SOL (~$210.00)
  Mailbox asking price: 0.5 SOL (~$70.00) per email
  Prepaid from [email protected]: 7 stamps (1 SOL (~$140.00) held)

The same wallet queried without --from, and with no rate available (note the missing dollar tails and the per-sender hint):

$ sithbit earnings
Earnings summary for 85FZrun1Eb5bdkbFCDjaFSTLnBfnx6sUFHa5BiYH2Q0
  Wallet balance: 1.5 SOL
  Mailbox asking price: 0.5 SOL per email
  Prepaid stamps: pass --from <address> to show a named sender's balance

A sender you name who has never prepaid you reports none prepaid rather than erroring — asking about an unknown sender is expected:

$ sithbit earnings --from [email protected]
...
  Prepaid from [email protected]: none prepaid

For the wider picture of how postage and prepaid stamps price out spam, see Economics.