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 one 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.

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.