Sats Names
Search
K
Comment on page

Mint names

The syntax below applies to all SNS namespaces, for example .sats .ord .gm and so on, plus all future namespaces.
New names can be minted (inscribed for the first time) as ordinals with only a Bitcoin transaction. This process is open to anyone that can inscribe.

Registering names

Simple registration

To register a new name within the Sats Name System simply inscribe an ordinal containing your desired name. Here is an example.
satoshi.sats

Advanced registration

Advanced registration allows users to add additional data to a name using JSON5 syntax. The format is optional for registration.
{
"p": "sns",
"op": "reg",
"name": "satoshi.sats",
"avatar": "7f9c06b712c5b60c0b66868c69568b2d198533553c347cd732fc3c87e62efe86i0",
"rev": "bc1psvggtp7mzr3lu8x5vrycqjqqkk5e7urtu2axjvwejea0ctjfdl3qqrctsf",
"relay": "85b10531435304cbe47d268106b58b57a4416c76573d4b50fa544432597ad670i0"
}
Key
Required?
Expected
Description
p
Yes
sns
Helps indexers identify the SNS protocol
op
Yes
reg
Tells indexers this is a new name
name
Yes
SNS name
Name: Your desired name. Including .sats, or another namespace, is required.
avatar
No
Inscription ID
Avatar or profile pic. Specify with inscription ID.
rev
No
Bitcoin address
Reverse resolution: Sets the Bitcoin address for this name.
relay
No
Inscription ID
Tells indexers this SNS name is a pointer, or relay, to another inscription. Specify with inscription ID.
Updating names: Avatar, Relay, and Reverse Resolution (rev) will have update operations in the future. There are some complexities related to making updates safe and reliable that will require new inscription tools. Once those are widely available and tested, we will release the syntax!

⚠️ Registration limitations

These rules apply to all namespaces and names:
  • Only the first instance of each name/namespace is valid.
  • Only one name operation per ordinal inscription.
  • Any UTF-8 character is valid.
  • Capitalization does not matter. All names/namespaces will be indexed as lowercase.
  • No spaces are permitted within a name.
  • Only one period permitted within a name.