Skip to content

Commit f29ca9e

Browse files
authored
Merge pull request #391 from longviewoor/update-arns-section
Update ArNS section
2 parents ad7449a + 10c55e8 commit f29ca9e

File tree

1 file changed

+9
-7
lines changed

1 file changed

+9
-7
lines changed

docs/src/concepts/arns.md

Lines changed: 9 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,25 +1,27 @@
11
# ArNS - Arweave Name System
22

33
## Overview
4-
The Arweave Name System (ArNS) is the phonebook of the PermaWeb.
4+
The Arweave Name System (ArNS) is the phonebook of the Permaweb.
55

6-
It is a decentralized and censorship-resistant naming system that is enabled by AR.IO Gateways and used to connect friendly names to PermaWeb apps, pages and data.
6+
It is a decentralized and censorship-resistant naming system that is enabled by AR.IO Gateways and used to connect friendly names to Permaweb apps, pages and data.
77

88
This system works similarly to traditional DNS, where a user can purchase a name in a registry and DNS Name servers resolve these names to IP addresses.
99

10-
With ArNS, the registry is decentralized, permanent and stored on Arweave and each AR.IO gateway acts as both cache and name resolver. Users can register a name within the ArNS Registry, like "my-name" and set a pointer to any Arweave Transaction ID. AR.IO Gateways will resolve that name as one of their own subdomains, eg. https://laserilla.arweave.net and proxy all requests to the associated Arweave Transaction ID. Each registered name can also have under names associated with it that each point to an Arweave Transaction ID, like https://v1_laserilla.arweave.net, giving even more flexibility and control to its owner.
10+
With ArNS, the registry is decentralized, permanent and stored on Arweave (via AO), and each AR.IO gateway acts as both cache and name resolver. Users can register a name within the ArNS Registry, like "my-name" and set a pointer to any Arweave Transaction ID.
11+
12+
AR.IO Gateways will resolve that name as one of their own subdomains, eg. https://laserilla.arweave.net and proxy all requests to the associated Arweave Transaction ID. Each registered name can also have under names associated with it that each point to an Arweave Transaction ID, like https://v1_laserilla.arweave.net, giving even more flexibility and control to its owner.
1113

1214
## The ArNS Registry
1315

14-
ArNS uses the Smartweave protocol manage its name records. Each record, or name, is leased by a user and tied to an ANT token. You can register multiple ArNS names to a single ANT, but you cannot register multiple ANTs to a single ArNS name - the gateways wouldn't know where to point the routing ID.
16+
ArNS uses AO to manage its name records. Each record, or name, is leased by a user or bought permanently and tied to an ANT token. You can register multiple ArNS names to a single ANT, but you cannot register multiple ANTs to a single ArNS name - the gateways wouldn't know where to point the routing ID.
1517

1618
ArNS names can be up to 32 characters, including numbers [0-9], letters [a-z], and dashes [-]. The dashes cannot be trailing dashes, e.g. -myname.
1719

1820
## ANTs (Arweave Name Tokens)
1921

2022
ANTs are a crucial part of the ArNS ecosystem - they are the actual key to owning an ArNS name. When you register an ArNS name to an ANT, the ANT then becomes the transfer method for that name. The ArNS registry does not care who owns the ANT, it simply knows what name ANT it belongs to.
2123

22-
Within ANTs you can build out whatever functionality you wish, within the scope ArNS registry approved source code transaction list. Up to and including NFT's, PST's, DAO's, or full on applications.
24+
Within ANTs you can build out whatever functionality you wish, within the scope ArNS registry approved source code transaction list.
2325

2426
## Under_Names
2527

@@ -56,5 +58,5 @@ if you tried to access undername1_my-name.arweave.net, you would get 'undername1
5658
ANT's, in theory, have an UNLIMITED number of undernames. However, how many will be served depends on which tier is used with your ArNS name.
5759

5860
## Resources
59-
# [ArNS App](https://arns.app/)
60-
# [ArNS Docs](https://docs.ar.io/arns/)
61+
- [ArNS App](https://arns.app/)
62+
- [ArNS Docs](https://docs.ar.io/arns/)

0 commit comments

Comments
 (0)