Inscribing @handles

Inscribe @handle names

@handle names are any child extension of its parent prefix: (@)

The syntax and limitations below apply to the @ prefix. New @handle names can be inscribed as an ordinal artifact by way of a Bitcoin transaction. This process is open to anyone who can inscribe.

Make sure to verify the @handle you want is available before you inscribe it.

Remember first is first. Any duplicate inscriptions will not be indexed.

You can check availability using a tool created by Trac Network, which follows the @handles protocol in its query.

https://trac.network/trac-demos/handles/

---

Simple Registration

To register a @handle name, simply inscribe an ordinal with an @ followed by the desired name. (no spaces). Here are some examples:

• @satoshi

• @bitcoin

• @btc

Protocol Inscription

Protocol Inscriptions allows users to add additional data to a name using JSON5 syntax. The format is optional and used for attaching additional content to your @handles and assist indexers in locating this attached information.

{
    "p": "@handles", 
    "op": "data", 
    "name": "@satoshi", 
    "rev": "bc1psvggtp7mzr3lu8x5vrycqjqqkk5e7urtu2axjvwejea0ctjfdl3qqrctsf" 
}

Key	Required?	Expected	Description
p	Yes	@handles	Helps indexers identify the hns protocol
op	Yes	data	This op allows a handle to have new features
name	Yes	@name	Provide the @handle you want to add features to
rev	No	Bitcoin Wallet Address	Reverse Resolution: Sets the Bitcoin address for this name

The "Protocol Inscription" format is currently in beta and under development. Additional actions and items may be added to or removed from the protocol as it develops. We will maintain these docs to reflect changes, additions, or updates as they occur.

---

Registration Limitations

These rules apply to all @handle names:

• Only the first instance of each @handle name is valid.

• Only one name operation per ordinal inscription.

• The current standard format recognizes the following characters: Letters (English) Numbers underscore (_) and hyphens (-) only

• A limit of 20 characters is allowed (not including the @)

• Capitalization is valid. All @handle names will be indexed as lowercase.

• No spaces are permitted within a name.

Updating "Protocol Inscription" items

We aim to allow for the ability to update the information attached to a @handle in the future. There are some complexities related to making updates safe, and indexed reliably that will require the development of additional tools. Once they are widely available and tested, a syntax will be released.