Arweave Name System (ArNS)

When the end user creates a zelfName and purchases a subscription for 1 to N years, we create the record in Arweave because when you don't purchase it we just say the temporal zelfNames in IPFS since it's easier to just remove them after the trial period.

When we store it in Arweave we also bring more benefits besides the permanent storage of the ZelfProof, one of those benefits is that we create a permanent website that we keep updating with the information that we store inside Arweave regarding the ZelfName registration.

Claim your Zelf Name Site

https://api.zelf.world/api/ar-io-arns/:zelfName

Request

Endpoint: /api/ar-io-arns/:zelfName Method: POST

Content-Type: application/json

Node.js

const axios = require('axios');

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: 'https://api.zelf.world/api/ar-io-arns/myzelfname.zelf',
  headers: { }
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

cURL

curl --location --request POST 'https://api.zelf.world/api/ar-io-arns/myzelfname.zelf'

Python

import http.client

conn = http.client.HTTPSConnection("api.zelf.world")
payload = ''
headers = {}
conn.request("POST", "/api/ar-io-arns/myzelfname.zelf", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

Response

200

{
    "id": "Y1ya0fQhyW9TVKMRwO9cDjlJkjRpa-zWEM3R057-82o",
    "result": {
        "transactionId": "oAXUqVVS2-I2OWPKjVOsLGNnwYVFHUTpJepvCxnrEvY",
        "ttlSeconds": 3600
    },
    "primaryUrl": "https://dinero_zelf.arweave.zelf.world",
    "secondaryUrl": "https://dinero_zelf.arweave.net"
}

Already registered

{
    "success": true,
    "exists": true,
    "record": {
        "transactionId": "oAXUqVVS2-I2OWPKjVOsLGNnwYVFHUTpJepvCxnrEvY",
        "ttlSeconds": 80,
        "index": 3
    },
    "upToDate": true,
    "zelfName": "jumitrmo",
    "primaryUrl": "https://myzelfname_zelf.arweave.zelf.world",
    "secondaryUrl": "https://myzelfname_zelf.arweave.net"
}

404

{
    "message": "not_found_in_arweave",
    "code": "NotFound"
}

Query your Zelf Name Site

https://api.zelf.world/api/ar-io-arns/:zelfName

Request

Endpoint: /api/ar-io-arns/:zelfName Method: GET

Content-Type: application/json

Node.js

const axios = require('axios');

let config = {
  method: 'get',
  maxBodyLength: Infinity,
  url: 'https://api.zelf.world/api/ar-io-arns/dinero.zelf',
  headers: { }
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

cURL

curl --location --request GET 'https://api.zelf.world/api/ar-io-arns/dinero.zelf'

Python

import http.client

conn = http.client.HTTPSConnection("api.zelf.world")
payload = ''
headers = {}
conn.request("GET", "/api/ar-io-arns/dinero.zelf", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

Response

200

{
    "success": true,
    "exists": true,
    "record": {
        "transactionId": "oAXUqVVS2-I2OWPKjVOsLGNnwYVFHUTpJepvCxnrEvY",
        "ttlSeconds": 3600,
        "index": 2
    },
    "upToDate": true,
    "zelfName": "dinero",
    "primaryUrl": "https://dinero_zelf.arweave.zelf.world",
    "secondaryUrl": "https://dinero_zelf.arweave.net"
}

404

{
    "message": "not_found_in_arweave",
    "code": "NotFound"
}