Resolve & Names

Base URL: https://zns-server-production.up.railway.app

tip

All names are lowercase, without the .zec suffix (use alice, not alice.zec or Alice).

---

Resolve a Name

The primary endpoint. Look up the Zcash address for a .zec name.

GET /v1/resolve/{name}

curl

curl https://zns-server-production.up.railway.app/v1/resolve/alice

JavaScript

const res = await fetch('https://zns-server-production.up.railway.app/v1/resolve/alice');
const { address, merkle_proof, smt_root } = await res.json();

Python

import requests

r = requests.get('https://zns-server-production.up.railway.app/v1/resolve/alice')
data = r.json()
print(data['address'])

Response 200 OK

{
  "name": "alice",
  "address": "u1qr5e...7xk4",
  "smt_root": "a3b2c1d4e5f6...",
  "merkle_proof": ["0000000000000000...", "a1b2c3d4e5f6..."]
}

Field	Type	Description
name	string	The registered name
address	string	Zcash unified address
smt_root	string	Current Merkle tree root (hex)
merkle_proof	string[]	128 sibling hashes for verification (hex)

Errors: 400 Invalid name | 404 Not registered

---

Name Details

Full registration details including ownership, listing status, and metadata.

GET /v1/names/{name}

curl https://zns-server-production.up.railway.app/v1/names/alice

Response 200 OK

{
  "name": "alice",
  "unified_address": "u1qr5e...7xk4",
  "owner_address": "u1qr5e...7xk4",
  "txid": "a1b2c3d4...",
  "registered_at_height": 2920000,
  "updated_at_height": null,
  "listing": null,
  "owner_pubkey": "3b6a27bceeb6a090...",
  "nonce": 0
}

Field	Type	Description
name	string	The registered name
unified_address	string	Current resolved address
txid	string	Registration transaction ID
registered_at_height	number	Block height of registration
listing	object | null	Active marketplace listing
owner_pubkey	string	Ed25519 owner public key (hex)
nonce	number	Current nonce for signed operations

---

Names by Owner

All names owned by a given Ed25519 public key.

GET /v1/owner/pubkey/{pubkey}

curl https://zns-server-production.up.railway.app/v1/owner/pubkey/3b6a27bceeb6a090...

Response 200 OK

{
  "owner_pubkey": "3b6a27bceeb6a090...",
  "names": [
    {
      "name": "alice",
      "unified_address": "u1qr5e...7xk4",
      "registered_at_height": 2920000
    }
  ]
}