Looking up a domain

See Domains for what a domain is and what the active/inactive status means. This page covers the sithbit domain get command.

sithbit domain get <domain>

domain get is a read-only query — it derives the domain’s on-chain account, reads it, and prints its status. It signs nothing, spends nothing, and, unlike the admin subcommands below, needs no special CLI feature: any mailbox owner can check whether a domain exists and is active before pointing their mailbox at it.

Arguments

• <domain> (required) — either the domain name itself (e.g. sithbit.com, case-insensitive; domain names are stored lowercased) or the domain account’s on-chain address. A value that parses as a base58 pubkey is read as an account address directly; anything else is treated as a domain name and hashed into its PDA.

What it prints

For a registered domain the command prints a summary line: the domain name, its derived account address, the domain authority that controls it (the address that can transfer it), and whether it is currently active or inactive — see Active and inactive domains for what that status means.

A second line gives the domain’s sponsor policy:

Sponsor policy: cap 500, rate 25 per epoch, delegate maiLtdkxym8CCmo9TwDuXywqd9DXaK3tB6toKFVeBFR

The cap and the rate print unlimited when they are zero, and the delegate prints none when no sponsor delegate is set. If a reclaim by proof is pending, its details follow.

If the domain has never been registered — or its account address does not exist — the command reports that the domain does not exist on Solana and exits successfully.

Examples

Look up a domain by name:

sithbit domain get sithbit.com

Look up the same domain by its on-chain account address instead:

sithbit domain get 7Np41oeYqPefeNQEHSv1UDhYrehxin3NStELsSKCT4K2

Note: domain create, domain transfer, and domain deactivate require the CLI’s domain feature (enabled by default) and always require the delegate’s signature — domain administration is not something an ordinary mailbox owner can do unilaterally. domain get, by contrast, is unauthenticated and always available.