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.