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.


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


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

Last updated