Looking up a frombox

See Fromboxes for what a frombox is and how pricing works. This page covers the sithbit frombox get command.

sithbit frombox get <from> [to_address]

frombox get is a read-only query: it derives the frombox PDA for the (from, to) pair, reads the account, and prints its stamp price and balance. It signs nothing, spends nothing, and needs no CLI feature flag — anyone can inspect any frombox.

Arguments

• <from> (required) — the sender’s “from” address, exactly as it keys the frombox: a wallet address, an alias@domain / wallet@domain email address, or a path to a .json keypair file (its public key is used). The value is taken literally as the frombox’s from-key, so a bare local part and its fully-qualified email address are different fromboxes — match whatever was used at create time.
• [to_address] (optional) — the recipient whose mailbox charges the postage. Accepts a wallet address, an alias/email address, or a .json keypair path, and (unlike <from>) is resolved to a wallet pubkey, so an alias is looked up on-chain. Defaults to your own configured wallet — the recipient’s own point of view.

What it prints

For an existing frombox the report is two lines: the derived frombox account address, its per-stamp postage price in lamports, the number of stamps currently available, and the account’s total lamport balance (rent plus the residual prepaid stamp value — what closing the frombox would refund to the recipient, or what frombox reclaim would return to a wallet-address sender, less the rent).

If no frombox exists for the pair, the command reports that the account does not exist and exits successfully — that is the normal state for an unknown sender, who simply pays the recipient’s mailbox default postage instead.

Examples

Check the frombox a recipient (you) has set up for [email protected]:

sithbit frombox get [email protected]

Inspect the frombox from [email protected] to a specific recipient alias, rather than your own wallet:

sithbit frombox get [email protected] [email protected]

Related commands

• Create a frombox — created on the sender’s first stamp purchase.
• Add stamps — top up the prepaid balance.
• Update postage — set the per-stamp price (owner only).
• Reclaim unspent stamps — the sender takes back postage it prepaid and never spent.

See Closing accounts for how to close a frombox and reclaim its rent and remaining stamp value.