zcashname-sdk 0.2.0

package/dist/index.cjs

@@ -0,0 +1,281 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  CLAIM_PRICES: () => CLAIM_PRICES,
+  DEFAULT_CLAIM_PRICE: () => DEFAULT_CLAIM_PRICE,
+  DEFAULT_URL: () => DEFAULT_URL,
+  ErrorType: () => ErrorType,
+  UFVK: () => UFVK,
+  ZNSError: () => ZNSError,
+  buildBuyMemo: () => buildBuyMemo,
+  buildClaimMemo: () => buildClaimMemo,
+  buildDelistMemo: () => buildDelistMemo,
+  buildListMemo: () => buildListMemo,
+  buildUpdateMemo: () => buildUpdateMemo,
+  buildZcashUri: () => buildZcashUri,
+  claimCost: () => claimCost,
+  createClient: () => createClient,
+  decodeBase64Url: () => decodeBase64Url,
+  delistPayload: () => delistPayload,
+  getNonce: () => getNonce,
+  isAvailable: () => isAvailable,
+  isValidName: () => isValidName,
+  listPayload: () => listPayload,
+  listings: () => listings,
+  parseZip321Uri: () => parseZip321Uri,
+  resolve: () => resolve,
+  status: () => status,
+  toBase64Url: () => toBase64Url,
+  updatePayload: () => updatePayload
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/errors.ts
+var ErrorType = /* @__PURE__ */ ((ErrorType2) => {
+  ErrorType2[ErrorType2["ParseError"] = -32700] = "ParseError";
+  ErrorType2[ErrorType2["InvalidRequest"] = -32600] = "InvalidRequest";
+  ErrorType2[ErrorType2["MethodNotFound"] = -32601] = "MethodNotFound";
+  ErrorType2[ErrorType2["InvalidParams"] = -32602] = "InvalidParams";
+  ErrorType2[ErrorType2["InternalError"] = -32603] = "InternalError";
+  ErrorType2[ErrorType2["HttpError"] = -1] = "HttpError";
+  ErrorType2[ErrorType2["UfvkMismatch"] = -2] = "UfvkMismatch";
+  return ErrorType2;
+})(ErrorType || {});
+var ZNSError = class extends Error {
+  constructor(type, message) {
+    super(message ?? ErrorType[type]);
+    this.name = "ZNSError";
+    this.type = type;
+  }
+};
+
+// src/constants.ts
+var DEFAULT_URL = "https://names.zcash.me";
+var UFVK = "uviewtest1h075nwxk0s66hyw0gmy5l2gmr37eahe9ewzgu2lff90rc85mazdhc66udklmd2p7cqm3mg2up8487pusvh78dh89y7mzlfgdl57tncqxrwshhc2kf26js0ymdwd476r0v7qn6es0etgjeg3g0y3pngvvf8zdawg6nlwca7jqy2fv82rc5skauw05ptfuf5twj67u0gzzvhakvkxpvx8rvf2rlh5yh560fdr6p28368kjxez5gu9azam5cm08ygre0uqwhvrkz7sr7ld0nyv05a0xrqeffdvhujafq3ke860skmxzshtjlrlew72vycu54pkgjtyp2phr6fmmkqlxvsan54jh7mc59r7kazgwwrcfnmqjm5pt40kjeafp6lwtx2lp4gm5pzg9c9ugphrsclfnz50spnsrersk34ht5mrevw9yvspkfjg9mjhusc588d855hdch0z82pr5fhkvaz3p4cmjlxujxqw2w20tpgyt3rzkwuuwl4r7";
+var CLAIM_PRICES = {
+  1: 6e8,
+  2: 425e6,
+  3: 3e8,
+  4: 15e7,
+  5: 75e6,
+  6: 5e7
+};
+var DEFAULT_CLAIM_PRICE = 25e6;
+
+// src/validation.ts
+function isValidName(name) {
+  return /^[a-z0-9](?:[a-z0-9-]{0,60}[a-z0-9])?$/.test(name) && !name.includes("--");
+}
+
+// src/pricing.ts
+function claimCost(nameLength) {
+  return CLAIM_PRICES[nameLength] ?? DEFAULT_CLAIM_PRICE;
+}
+
+// src/memo.ts
+function listPayload(name, price, nonce) {
+  return `LIST:${name}:${price}:${nonce}`;
+}
+function delistPayload(name, nonce) {
+  return `DELIST:${name}:${nonce}`;
+}
+function updatePayload(name, newUa, nonce) {
+  return `UPDATE:${name}:${newUa}:${nonce}`;
+}
+function buildClaimMemo(name, ua) {
+  if (!isValidName(name)) throw new Error(`Invalid name: ${name}`);
+  return `ZNS:CLAIM:${name}:${ua}`;
+}
+function buildBuyMemo(name, buyerUa) {
+  if (!isValidName(name)) throw new Error(`Invalid name: ${name}`);
+  return `ZNS:BUY:${name}:${buyerUa}`;
+}
+function buildListMemo(name, price, nonce, signature) {
+  if (!isValidName(name)) throw new Error(`Invalid name: ${name}`);
+  return `ZNS:LIST:${name}:${price}:${nonce}:${signature}`;
+}
+function buildDelistMemo(name, nonce, signature) {
+  if (!isValidName(name)) throw new Error(`Invalid name: ${name}`);
+  return `ZNS:DELIST:${name}:${nonce}:${signature}`;
+}
+function buildUpdateMemo(name, newUa, nonce, signature) {
+  if (!isValidName(name)) throw new Error(`Invalid name: ${name}`);
+  return `ZNS:UPDATE:${name}:${newUa}:${nonce}:${signature}`;
+}
+
+// src/zip321.ts
+function toBase64Url(text) {
+  try {
+    return btoa(unescape(encodeURIComponent(text))).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
+  } catch {
+    return "";
+  }
+}
+function decodeBase64Url(value) {
+  try {
+    const normalized = String(value).replace(/-/g, "+").replace(/_/g, "/");
+    const paddingLength = normalized.length % 4 === 0 ? 0 : 4 - normalized.length % 4;
+    const padded = normalized + "=".repeat(paddingLength);
+    const binary = atob(padded);
+    const bytes = Uint8Array.from(binary, (char) => char.charCodeAt(0));
+    return new TextDecoder().decode(bytes);
+  } catch {
+    return "";
+  }
+}
+function buildZcashUri(address, amount, memo) {
+  if (!address) return "";
+  const base = `zcash:${address}`;
+  const params = [];
+  if (amount !== void 0 && Number(amount) > 0) params.push(`amount=${amount}`);
+  if (memo) params.push(`memo=${toBase64Url(memo)}`);
+  return params.length ? `${base}?${params.join("&")}` : base;
+}
+function parseZip321Uri(uri) {
+  const withoutScheme = String(uri ?? "").replace(/^zcash:/i, "");
+  const [addressPart, queryPart = ""] = withoutScheme.split("?");
+  const address = addressPart.trim();
+  const params = new URLSearchParams(queryPart);
+  const amount = String(params.get("amount") ?? "").trim();
+  const memoRaw = String(params.get("memo") ?? "").trim();
+  const memoDecoded = memoRaw ? decodeBase64Url(memoRaw) : "";
+  return { address, amount, memoRaw, memoDecoded };
+}
+
+// src/rpc.ts
+async function rpc(url, method, params = {}, id = 1) {
+  const body = JSON.stringify({ jsonrpc: "2.0", id, method, params });
+  const res = await fetch(url, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body
+  });
+  if (!res.ok) {
+    throw new ZNSError(-1 /* HttpError */, `HTTP ${res.status}: ${res.statusText}`);
+  }
+  const json = await res.json();
+  if (json.error) {
+    const type = Object.values(ErrorType).includes(json.error.code) ? json.error.code : -32603 /* InternalError */;
+    throw new ZNSError(type, json.error.message);
+  }
+  return json.result;
+}
+
+// src/client.ts
+async function createClient(url = DEFAULT_URL, options = {}) {
+  let nextId = 1;
+  let verified = false;
+  async function call(method, params = {}) {
+    return rpc(url, method, params, nextId++);
+  }
+  if (!options.skipVerify) {
+    const s = await call("status");
+    if (s.ufvk !== UFVK) {
+      throw new ZNSError(
+        -2 /* UfvkMismatch */,
+        `UFVK mismatch: indexer returned "${s.ufvk.slice(0, 20)}..." but expected "${UFVK.slice(0, 20)}..."`
+      );
+    }
+    verified = true;
+  }
+  const client = {
+    url,
+    verified,
+    async resolve(query) {
+      return call("resolve", { query });
+    },
+    async listings() {
+      const result = await call("list_for_sale");
+      return result.listings;
+    },
+    async status() {
+      return call("status");
+    },
+    async isAvailable(name) {
+      const result = await client.resolve(name);
+      return result === null;
+    },
+    async getNonce(name) {
+      const result = await client.resolve(name);
+      return result?.nonce ?? null;
+    }
+  };
+  return client;
+}
+
+// src/index.ts
+var defaultClient = null;
+var defaultClientPromise = null;
+function getDefaultClient() {
+  if (defaultClient) return Promise.resolve(defaultClient);
+  if (!defaultClientPromise) {
+    defaultClientPromise = createClient(DEFAULT_URL).then((c) => {
+      defaultClient = c;
+      return c;
+    });
+  }
+  return defaultClientPromise;
+}
+async function resolve(query) {
+  return (await getDefaultClient()).resolve(query);
+}
+async function listings() {
+  return (await getDefaultClient()).listings();
+}
+async function status() {
+  return (await getDefaultClient()).status();
+}
+async function isAvailable(name) {
+  return (await getDefaultClient()).isAvailable(name);
+}
+async function getNonce(name) {
+  return (await getDefaultClient()).getNonce(name);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CLAIM_PRICES,
+  DEFAULT_CLAIM_PRICE,
+  DEFAULT_URL,
+  ErrorType,
+  UFVK,
+  ZNSError,
+  buildBuyMemo,
+  buildClaimMemo,
+  buildDelistMemo,
+  buildListMemo,
+  buildUpdateMemo,
+  buildZcashUri,
+  claimCost,
+  createClient,
+  decodeBase64Url,
+  delistPayload,
+  getNonce,
+  isAvailable,
+  isValidName,
+  listPayload,
+  listings,
+  parseZip321Uri,
+  resolve,
+  status,
+  toBase64Url,
+  updatePayload
+});

package/dist/index.d.cts

@@ -0,0 +1,93 @@
+interface Registration {
+    name: string;
+    address: string;
+    txid: string;
+    height: number;
+    nonce: number;
+    signature: string | null;
+}
+interface Listing {
+    name: string;
+    price: number;
+    txid: string;
+    height: number;
+    signature: string;
+}
+interface ResolveResult extends Registration {
+    listing: Listing | null;
+}
+interface ListForSaleResult {
+    listings: Listing[];
+}
+interface StatusResult {
+    synced_height: number;
+    admin_pubkey: string;
+    ufvk: string;
+    registered: number;
+    listed: number;
+}
+
+declare enum ErrorType {
+    ParseError = -32700,
+    InvalidRequest = -32600,
+    MethodNotFound = -32601,
+    InvalidParams = -32602,
+    InternalError = -32603,
+    HttpError = -1,
+    UfvkMismatch = -2
+}
+declare class ZNSError extends Error {
+    type: ErrorType;
+    constructor(type: ErrorType, message?: string);
+}
+
+declare const DEFAULT_URL = "https://names.zcash.me";
+declare const UFVK = "uviewtest1h075nwxk0s66hyw0gmy5l2gmr37eahe9ewzgu2lff90rc85mazdhc66udklmd2p7cqm3mg2up8487pusvh78dh89y7mzlfgdl57tncqxrwshhc2kf26js0ymdwd476r0v7qn6es0etgjeg3g0y3pngvvf8zdawg6nlwca7jqy2fv82rc5skauw05ptfuf5twj67u0gzzvhakvkxpvx8rvf2rlh5yh560fdr6p28368kjxez5gu9azam5cm08ygre0uqwhvrkz7sr7ld0nyv05a0xrqeffdvhujafq3ke860skmxzshtjlrlew72vycu54pkgjtyp2phr6fmmkqlxvsan54jh7mc59r7kazgwwrcfnmqjm5pt40kjeafp6lwtx2lp4gm5pzg9c9ugphrsclfnz50spnsrersk34ht5mrevw9yvspkfjg9mjhusc588d855hdch0z82pr5fhkvaz3p4cmjlxujxqw2w20tpgyt3rzkwuuwl4r7";
+declare const CLAIM_PRICES: Record<number, number>;
+declare const DEFAULT_CLAIM_PRICE = 25000000;
+
+declare function isValidName(name: string): boolean;
+
+declare function claimCost(nameLength: number): number;
+
+declare function listPayload(name: string, price: number, nonce: number): string;
+declare function delistPayload(name: string, nonce: number): string;
+declare function updatePayload(name: string, newUa: string, nonce: number): string;
+declare function buildClaimMemo(name: string, ua: string): string;
+declare function buildBuyMemo(name: string, buyerUa: string): string;
+declare function buildListMemo(name: string, price: number, nonce: number, signature: string): string;
+declare function buildDelistMemo(name: string, nonce: number, signature: string): string;
+declare function buildUpdateMemo(name: string, newUa: string, nonce: number, signature: string): string;
+
+declare function toBase64Url(text: string): string;
+declare function decodeBase64Url(value: string): string;
+interface Zip321Parts {
+    address: string;
+    amount: string;
+    memoRaw: string;
+    memoDecoded: string;
+}
+declare function buildZcashUri(address: string, amount?: string | number, memo?: string): string;
+declare function parseZip321Uri(uri: string): Zip321Parts;
+
+interface ClientOptions {
+    skipVerify?: boolean;
+}
+interface ZNSClient {
+    readonly url: string;
+    readonly verified: boolean;
+    resolve(query: string): Promise<ResolveResult | null>;
+    listings(): Promise<Listing[]>;
+    status(): Promise<StatusResult>;
+    isAvailable(name: string): Promise<boolean>;
+    getNonce(name: string): Promise<number | null>;
+}
+declare function createClient(url?: string, options?: ClientOptions): Promise<ZNSClient>;
+
+declare function resolve(query: string): Promise<ResolveResult | null>;
+declare function listings(): Promise<Listing[]>;
+declare function status(): Promise<StatusResult>;
+declare function isAvailable(name: string): Promise<boolean>;
+declare function getNonce(name: string): Promise<number | null>;
+
+export { CLAIM_PRICES, type ClientOptions, DEFAULT_CLAIM_PRICE, DEFAULT_URL, ErrorType, type ListForSaleResult, type Listing, type Registration, type ResolveResult, type StatusResult, UFVK, type ZNSClient, ZNSError, type Zip321Parts, buildBuyMemo, buildClaimMemo, buildDelistMemo, buildListMemo, buildUpdateMemo, buildZcashUri, claimCost, createClient, decodeBase64Url, delistPayload, getNonce, isAvailable, isValidName, listPayload, listings, parseZip321Uri, resolve, status, toBase64Url, updatePayload };

package/dist/index.d.mts

@@ -0,0 +1,46 @@
+interface Registration {
+    name: string;
+    address: string;
+    txid: string;
+    height: number;
+    nonce: number;
+    signature: string | null;
+}
+interface Listing {
+    name: string;
+    price: number;
+    txid: string;
+    height: number;
+    signature: string;
+}
+interface ResolveResult extends Registration {
+    listing: Listing | null;
+}
+interface ListForSaleResult {
+    listings: Listing[];
+}
+interface StatusResult {
+    synced_height: number;
+    admin_pubkey: string;
+    ufvk: string;
+    registered: number;
+    listed: number;
+}
+declare class ZNSError extends Error {
+    code: number;
+    constructor(code: number, message: string);
+}
+declare class ZNSClient {
+    private url;
+    private nextId;
+    constructor(url?: string);
+    /** Look up a ZNS name or Zcash address. Returns null if not found. */
+    resolve(query: string): Promise<ResolveResult | null>;
+    /** Get all names currently listed for sale. */
+    listForSale(): Promise<Listing[]>;
+    /** Get indexer status. */
+    status(): Promise<StatusResult>;
+    private call;
+}
+
+export { type ListForSaleResult, type Listing, type Registration, type ResolveResult, type StatusResult, ZNSClient, ZNSError, ZNSClient as default };

package/dist/index.d.ts

@@ -0,0 +1,93 @@
+interface Registration {
+    name: string;
+    address: string;
+    txid: string;
+    height: number;
+    nonce: number;
+    signature: string | null;
+}
+interface Listing {
+    name: string;
+    price: number;
+    txid: string;
+    height: number;
+    signature: string;
+}
+interface ResolveResult extends Registration {
+    listing: Listing | null;
+}
+interface ListForSaleResult {
+    listings: Listing[];
+}
+interface StatusResult {
+    synced_height: number;
+    admin_pubkey: string;
+    ufvk: string;
+    registered: number;
+    listed: number;
+}
+
+declare enum ErrorType {
+    ParseError = -32700,
+    InvalidRequest = -32600,
+    MethodNotFound = -32601,
+    InvalidParams = -32602,
+    InternalError = -32603,
+    HttpError = -1,
+    UfvkMismatch = -2
+}
+declare class ZNSError extends Error {
+    type: ErrorType;
+    constructor(type: ErrorType, message?: string);
+}
+
+declare const DEFAULT_URL = "https://names.zcash.me";
+declare const UFVK = "uviewtest1h075nwxk0s66hyw0gmy5l2gmr37eahe9ewzgu2lff90rc85mazdhc66udklmd2p7cqm3mg2up8487pusvh78dh89y7mzlfgdl57tncqxrwshhc2kf26js0ymdwd476r0v7qn6es0etgjeg3g0y3pngvvf8zdawg6nlwca7jqy2fv82rc5skauw05ptfuf5twj67u0gzzvhakvkxpvx8rvf2rlh5yh560fdr6p28368kjxez5gu9azam5cm08ygre0uqwhvrkz7sr7ld0nyv05a0xrqeffdvhujafq3ke860skmxzshtjlrlew72vycu54pkgjtyp2phr6fmmkqlxvsan54jh7mc59r7kazgwwrcfnmqjm5pt40kjeafp6lwtx2lp4gm5pzg9c9ugphrsclfnz50spnsrersk34ht5mrevw9yvspkfjg9mjhusc588d855hdch0z82pr5fhkvaz3p4cmjlxujxqw2w20tpgyt3rzkwuuwl4r7";
+declare const CLAIM_PRICES: Record<number, number>;
+declare const DEFAULT_CLAIM_PRICE = 25000000;
+
+declare function isValidName(name: string): boolean;
+
+declare function claimCost(nameLength: number): number;
+
+declare function listPayload(name: string, price: number, nonce: number): string;
+declare function delistPayload(name: string, nonce: number): string;
+declare function updatePayload(name: string, newUa: string, nonce: number): string;
+declare function buildClaimMemo(name: string, ua: string): string;
+declare function buildBuyMemo(name: string, buyerUa: string): string;
+declare function buildListMemo(name: string, price: number, nonce: number, signature: string): string;
+declare function buildDelistMemo(name: string, nonce: number, signature: string): string;
+declare function buildUpdateMemo(name: string, newUa: string, nonce: number, signature: string): string;
+
+declare function toBase64Url(text: string): string;
+declare function decodeBase64Url(value: string): string;
+interface Zip321Parts {
+    address: string;
+    amount: string;
+    memoRaw: string;
+    memoDecoded: string;
+}
+declare function buildZcashUri(address: string, amount?: string | number, memo?: string): string;
+declare function parseZip321Uri(uri: string): Zip321Parts;
+
+interface ClientOptions {
+    skipVerify?: boolean;
+}
+interface ZNSClient {
+    readonly url: string;
+    readonly verified: boolean;
+    resolve(query: string): Promise<ResolveResult | null>;
+    listings(): Promise<Listing[]>;
+    status(): Promise<StatusResult>;
+    isAvailable(name: string): Promise<boolean>;
+    getNonce(name: string): Promise<number | null>;
+}
+declare function createClient(url?: string, options?: ClientOptions): Promise<ZNSClient>;
+
+declare function resolve(query: string): Promise<ResolveResult | null>;
+declare function listings(): Promise<Listing[]>;
+declare function status(): Promise<StatusResult>;
+declare function isAvailable(name: string): Promise<boolean>;
+declare function getNonce(name: string): Promise<number | null>;
+
+export { CLAIM_PRICES, type ClientOptions, DEFAULT_CLAIM_PRICE, DEFAULT_URL, ErrorType, type ListForSaleResult, type Listing, type Registration, type ResolveResult, type StatusResult, UFVK, type ZNSClient, ZNSError, type Zip321Parts, buildBuyMemo, buildClaimMemo, buildDelistMemo, buildListMemo, buildUpdateMemo, buildZcashUri, claimCost, createClient, decodeBase64Url, delistPayload, getNonce, isAvailable, isValidName, listPayload, listings, parseZip321Uri, resolve, status, toBase64Url, updatePayload };

package/dist/index.js

@@ -0,0 +1,229 @@
+// src/errors.ts
+var ErrorType = /* @__PURE__ */ ((ErrorType2) => {
+  ErrorType2[ErrorType2["ParseError"] = -32700] = "ParseError";
+  ErrorType2[ErrorType2["InvalidRequest"] = -32600] = "InvalidRequest";
+  ErrorType2[ErrorType2["MethodNotFound"] = -32601] = "MethodNotFound";
+  ErrorType2[ErrorType2["InvalidParams"] = -32602] = "InvalidParams";
+  ErrorType2[ErrorType2["InternalError"] = -32603] = "InternalError";
+  ErrorType2[ErrorType2["HttpError"] = -1] = "HttpError";
+  ErrorType2[ErrorType2["UfvkMismatch"] = -2] = "UfvkMismatch";
+  return ErrorType2;
+})(ErrorType || {});
+var ZNSError = class extends Error {
+  constructor(type, message) {
+    super(message ?? ErrorType[type]);
+    this.name = "ZNSError";
+    this.type = type;
+  }
+};
+
+// src/constants.ts
+var DEFAULT_URL = "https://names.zcash.me";
+var UFVK = "uviewtest1h075nwxk0s66hyw0gmy5l2gmr37eahe9ewzgu2lff90rc85mazdhc66udklmd2p7cqm3mg2up8487pusvh78dh89y7mzlfgdl57tncqxrwshhc2kf26js0ymdwd476r0v7qn6es0etgjeg3g0y3pngvvf8zdawg6nlwca7jqy2fv82rc5skauw05ptfuf5twj67u0gzzvhakvkxpvx8rvf2rlh5yh560fdr6p28368kjxez5gu9azam5cm08ygre0uqwhvrkz7sr7ld0nyv05a0xrqeffdvhujafq3ke860skmxzshtjlrlew72vycu54pkgjtyp2phr6fmmkqlxvsan54jh7mc59r7kazgwwrcfnmqjm5pt40kjeafp6lwtx2lp4gm5pzg9c9ugphrsclfnz50spnsrersk34ht5mrevw9yvspkfjg9mjhusc588d855hdch0z82pr5fhkvaz3p4cmjlxujxqw2w20tpgyt3rzkwuuwl4r7";
+var CLAIM_PRICES = {
+  1: 6e8,
+  2: 425e6,
+  3: 3e8,
+  4: 15e7,
+  5: 75e6,
+  6: 5e7
+};
+var DEFAULT_CLAIM_PRICE = 25e6;
+
+// src/validation.ts
+function isValidName(name) {
+  return /^[a-z0-9](?:[a-z0-9-]{0,60}[a-z0-9])?$/.test(name) && !name.includes("--");
+}
+
+// src/pricing.ts
+function claimCost(nameLength) {
+  return CLAIM_PRICES[nameLength] ?? DEFAULT_CLAIM_PRICE;
+}
+
+// src/memo.ts
+function listPayload(name, price, nonce) {
+  return `LIST:${name}:${price}:${nonce}`;
+}
+function delistPayload(name, nonce) {
+  return `DELIST:${name}:${nonce}`;
+}
+function updatePayload(name, newUa, nonce) {
+  return `UPDATE:${name}:${newUa}:${nonce}`;
+}
+function buildClaimMemo(name, ua) {
+  if (!isValidName(name)) throw new Error(`Invalid name: ${name}`);
+  return `ZNS:CLAIM:${name}:${ua}`;
+}
+function buildBuyMemo(name, buyerUa) {
+  if (!isValidName(name)) throw new Error(`Invalid name: ${name}`);
+  return `ZNS:BUY:${name}:${buyerUa}`;
+}
+function buildListMemo(name, price, nonce, signature) {
+  if (!isValidName(name)) throw new Error(`Invalid name: ${name}`);
+  return `ZNS:LIST:${name}:${price}:${nonce}:${signature}`;
+}
+function buildDelistMemo(name, nonce, signature) {
+  if (!isValidName(name)) throw new Error(`Invalid name: ${name}`);
+  return `ZNS:DELIST:${name}:${nonce}:${signature}`;
+}
+function buildUpdateMemo(name, newUa, nonce, signature) {
+  if (!isValidName(name)) throw new Error(`Invalid name: ${name}`);
+  return `ZNS:UPDATE:${name}:${newUa}:${nonce}:${signature}`;
+}
+
+// src/zip321.ts
+function toBase64Url(text) {
+  try {
+    return btoa(unescape(encodeURIComponent(text))).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
+  } catch {
+    return "";
+  }
+}
+function decodeBase64Url(value) {
+  try {
+    const normalized = String(value).replace(/-/g, "+").replace(/_/g, "/");
+    const paddingLength = normalized.length % 4 === 0 ? 0 : 4 - normalized.length % 4;
+    const padded = normalized + "=".repeat(paddingLength);
+    const binary = atob(padded);
+    const bytes = Uint8Array.from(binary, (char) => char.charCodeAt(0));
+    return new TextDecoder().decode(bytes);
+  } catch {
+    return "";
+  }
+}
+function buildZcashUri(address, amount, memo) {
+  if (!address) return "";
+  const base = `zcash:${address}`;
+  const params = [];
+  if (amount !== void 0 && Number(amount) > 0) params.push(`amount=${amount}`);
+  if (memo) params.push(`memo=${toBase64Url(memo)}`);
+  return params.length ? `${base}?${params.join("&")}` : base;
+}
+function parseZip321Uri(uri) {
+  const withoutScheme = String(uri ?? "").replace(/^zcash:/i, "");
+  const [addressPart, queryPart = ""] = withoutScheme.split("?");
+  const address = addressPart.trim();
+  const params = new URLSearchParams(queryPart);
+  const amount = String(params.get("amount") ?? "").trim();
+  const memoRaw = String(params.get("memo") ?? "").trim();
+  const memoDecoded = memoRaw ? decodeBase64Url(memoRaw) : "";
+  return { address, amount, memoRaw, memoDecoded };
+}
+
+// src/rpc.ts
+async function rpc(url, method, params = {}, id = 1) {
+  const body = JSON.stringify({ jsonrpc: "2.0", id, method, params });
+  const res = await fetch(url, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body
+  });
+  if (!res.ok) {
+    throw new ZNSError(-1 /* HttpError */, `HTTP ${res.status}: ${res.statusText}`);
+  }
+  const json = await res.json();
+  if (json.error) {
+    const type = Object.values(ErrorType).includes(json.error.code) ? json.error.code : -32603 /* InternalError */;
+    throw new ZNSError(type, json.error.message);
+  }
+  return json.result;
+}
+
+// src/client.ts
+async function createClient(url = DEFAULT_URL, options = {}) {
+  let nextId = 1;
+  let verified = false;
+  async function call(method, params = {}) {
+    return rpc(url, method, params, nextId++);
+  }
+  if (!options.skipVerify) {
+    const s = await call("status");
+    if (s.ufvk !== UFVK) {
+      throw new ZNSError(
+        -2 /* UfvkMismatch */,
+        `UFVK mismatch: indexer returned "${s.ufvk.slice(0, 20)}..." but expected "${UFVK.slice(0, 20)}..."`
+      );
+    }
+    verified = true;
+  }
+  const client = {
+    url,
+    verified,
+    async resolve(query) {
+      return call("resolve", { query });
+    },
+    async listings() {
+      const result = await call("list_for_sale");
+      return result.listings;
+    },
+    async status() {
+      return call("status");
+    },
+    async isAvailable(name) {
+      const result = await client.resolve(name);
+      return result === null;
+    },
+    async getNonce(name) {
+      const result = await client.resolve(name);
+      return result?.nonce ?? null;
+    }
+  };
+  return client;
+}
+
+// src/index.ts
+var defaultClient = null;
+var defaultClientPromise = null;
+function getDefaultClient() {
+  if (defaultClient) return Promise.resolve(defaultClient);
+  if (!defaultClientPromise) {
+    defaultClientPromise = createClient(DEFAULT_URL).then((c) => {
+      defaultClient = c;
+      return c;
+    });
+  }
+  return defaultClientPromise;
+}
+async function resolve(query) {
+  return (await getDefaultClient()).resolve(query);
+}
+async function listings() {
+  return (await getDefaultClient()).listings();
+}
+async function status() {
+  return (await getDefaultClient()).status();
+}
+async function isAvailable(name) {
+  return (await getDefaultClient()).isAvailable(name);
+}
+async function getNonce(name) {
+  return (await getDefaultClient()).getNonce(name);
+}
+export {
+  CLAIM_PRICES,
+  DEFAULT_CLAIM_PRICE,
+  DEFAULT_URL,
+  ErrorType,
+  UFVK,
+  ZNSError,
+  buildBuyMemo,
+  buildClaimMemo,
+  buildDelistMemo,
+  buildListMemo,
+  buildUpdateMemo,
+  buildZcashUri,
+  claimCost,
+  createClient,
+  decodeBase64Url,
+  delistPayload,
+  getNonce,
+  isAvailable,
+  isValidName,
+  listPayload,
+  listings,
+  parseZip321Uri,
+  resolve,
+  status,
+  toBase64Url,
+  updatePayload
+};

package/dist/index.mjs

@@ -0,0 +1,51 @@
+// src/index.ts
+var ZNSError = class extends Error {
+  constructor(code, message) {
+    super(message);
+    this.code = code;
+    this.name = "ZNSError";
+  }
+};
+var ZNSClient = class {
+  constructor(url = "http://127.0.0.1:3000") {
+    this.nextId = 1;
+    this.url = url;
+  }
+  /** Look up a ZNS name or Zcash address. Returns null if not found. */
+  async resolve(query) {
+    return this.call("resolve", { query });
+  }
+  /** Get all names currently listed for sale. */
+  async listForSale() {
+    const result = await this.call("list_for_sale", {});
+    return result.listings;
+  }
+  /** Get indexer status. */
+  async status() {
+    return this.call("status", {});
+  }
+  // ── JSON-RPC transport ──────────────────────────────────────────────────
+  async call(method, params) {
+    const id = this.nextId++;
+    const body = JSON.stringify({ jsonrpc: "2.0", id, method, params });
+    const res = await fetch(this.url, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body
+    });
+    if (!res.ok) {
+      throw new ZNSError(-1, `HTTP ${res.status}: ${res.statusText}`);
+    }
+    const json = await res.json();
+    if (json.error) {
+      throw new ZNSError(json.error.code, json.error.message);
+    }
+    return json.result;
+  }
+};
+var index_default = ZNSClient;
+export {
+  ZNSClient,
+  ZNSError,
+  index_default as default
+};

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "zcashname-sdk",
+  "version": "0.2.0",
+  "type": "module",
+  "description": "TypeScript SDK for the Zcash Name System (ZNS) JSON-RPC API",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/zcashme/ZNS.git",
+    "directory": "sdk/typescript"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^2.0.0"
+  }
+}