πŸ› οΈNamespaces

Namespaces

Namespace operations define a namespace, for example, .oifi is a namespace.

The DNS (Doge Name Services) Namespace is derived from the SNS (Satoshi Name Services) Namespace found in Bitcoin. Namespace operations serve as a valuable tool for builders, marketplaces, and indexers, enabling them to monitor and manage names across various namespaces using a consistent syntax. Similar to the syntax used for retrieving all tokens in the #DRC20 standard, DNS establishes a standardized approach for retrieving all names.

Here are few noteworthy examples and their namespace inscription:

NamespaceAboutNamespace operation

.doge

name on Dogecoin

***

.oifi

name on OrdiFind.Com

***

.dogim

name on Dogim inscription

***

There are many more. You can find them all by searching for the dns operation.

Create a namespace

Here are few reasons to inscribe a namespace operation for your community:

  • Help indexers and marketplaces "find" your namespace.

  • Include a description so inscribers know the purpose of the namespace.

  • Include a nice avatar or logo for marketplaces.

A few other important details about namespaces:

  • Like names, namespaces (specifically the dns value) are globally unique, and the first inscription of any namespace is the only valid instance. First is first.

  • The namespace inscription does not add, or remove, or limit anything related to how others inscribe names.

  • You can inscribe any DNS name, on any namespace, before the namespace inscription has been created.

  • No special permissions are given to the namespace inscription holder.

  • Namespace inscriptions have no speculative or secondary market value.

Namespace operation

{
    "p": "dns",
    "op": "dns",
    "ns": "doge",
    "about": "Names on Dogecoin.",
    "avatar": "********",
}
KeyRequired?Description

p

Yes

Helps indexers identify the DNS protocol

op

Yes

New namespace operation

dns

Yes

Defines the namespace, for example dogedefines the .doge namespace. Do not include the period .

about

No

A short description. Aim for under 50 characters.

avatar

No

A logo or image symbolizing the namespace. Use Inscription ID.

Do not include the period, or dot, in the operation.

You're welcome to put any UTF-8 character in your namespace but we recommend keeping things simple. Emoji, rare unicode characters, etc. are probably a bad idea and may have poor support by indexers or marketplaces.

⚠️ 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.

Last updated