ar.ioar.io Documentation

Ar.io Name System (ArNS)

What ArNS does

An Arweave transaction ID is a 43-character string that is hard to remember and share. The Ar.io Name System (ArNS) gives your data a friendly name, such as ardrive, that works as a subdomain on any ar.io gateway that supports ArNS, for example https://ardrive.ar.io.

ArNS works like DNS, with three differences:

  • No single company runs the registry. It lives on Solana, so anyone can check who owns a name.
  • You pay for names in ARIO. You can lease a name for 1 to 5 years or buy it permanently.
  • A name points to data stored on Arweave, not to a server.

How names resolve

When you register a name, you receive an Ar.io Name Token (ANT), an NFT on Solana that controls the name. Whoever holds the ANT sets its records. Each record points an undername to an Arweave transaction ID, so you can move the name to a new version of your app at any time.

Undernames use an underscore: docs_ardrive.ar.io asks for the docs record on the ANT behind ardrive, and ardrive.ar.io asks for its @ record.

Every gateway resolves names on its own, by reading the name registry and the ANT's records from Solana:

A gateway reads the name and its ANT records from Solana, then serves the data

If a gateway cannot read a name from Solana, it can ask a trusted gateway for the answer instead.

Explore ArNS

How is this guide?