zcashname-sdk 0.2.3 → 0.3.0

package/dist/chunk-4UY7KDYN.js

@@ -0,0 +1,61 @@
+import {
+  isValidName
+} from "./chunk-TNP4GYNO.js";
+
+// src/memo.ts
+function claimPayload(name, ua) {
+  return `CLAIM:${name}:${ua}`;
+}
+function buyPayload(name, buyerUa) {
+  return `BUY:${name}:${buyerUa}`;
+}
+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 setPricePayload(prices, nonce) {
+  return `SETPRICE:${prices.length}:${prices.join(":")}:${nonce}`;
+}
+function buildClaimMemo(name, ua, signature) {
+  if (!isValidName(name)) throw new Error(`Invalid name: ${name}`);
+  return `ZNS:CLAIM:${name}:${ua}:${signature}`;
+}
+function buildBuyMemo(name, buyerUa, signature) {
+  if (!isValidName(name)) throw new Error(`Invalid name: ${name}`);
+  return `ZNS:BUY:${name}:${buyerUa}:${signature}`;
+}
+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}`;
+}
+function buildSetPriceMemo(prices, nonce, signature) {
+  return `ZNS:SETPRICE:${prices.length}:${prices.join(":")}:${nonce}:${signature}`;
+}
+
+export {
+  claimPayload,
+  buyPayload,
+  listPayload,
+  delistPayload,
+  updatePayload,
+  setPricePayload,
+  buildClaimMemo,
+  buildBuyMemo,
+  buildListMemo,
+  buildDelistMemo,
+  buildUpdateMemo,
+  buildSetPriceMemo
+};

package/dist/chunk-E3JAIK65.js

@@ -0,0 +1,98 @@
+// 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["UivkMismatch"] = -2] = "UivkMismatch";
+  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://light.zcash.me/zns-testnet";
+var TESTNET_UIVK = "uivktest1hzw7wyadutvzfgpna80yftsk5l7jeyu2p5me5quvp28tytxueta00cx4068wnlzcv7tx9n3t3gfhsy83pe4y6jrhxtzaq0hj6xtg5zrk2dn7zen3vns2a5pgs4fxdjlletmqrhfa42";
+var MAINNET_UIVK = "uivk1gl26qy0xjja7lqhyg3pf0x4j4j66kqwewrjkdcg28eqq4wgtzjmujpee7x9cs2ec9xhnlgrm8ptlw8z80j2aryw8nqtssser2ys778a0s00uvgkdjnfr58sndhfvc3f4zqjs6ywva6";
+var KNOWN_UIVKS = [TESTNET_UIVK, MAINNET_UIVK];
+
+// 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 (!KNOWN_UIVKS.includes(s.uivk)) {
+      throw new ZNSError(
+        -2 /* UivkMismatch */,
+        `UIVK mismatch: indexer returned "${s.uivk.slice(0, 20)}..." which is not a known ZNS instance`
+      );
+    }
+    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 events(filter = {}) {
+      return call("events", filter);
+    },
+    async getNonce(name) {
+      const result = await client.resolve(name);
+      return result?.nonce ?? null;
+    }
+  };
+  return client;
+}
+
+export {
+  ErrorType,
+  ZNSError,
+  DEFAULT_URL,
+  TESTNET_UIVK,
+  MAINNET_UIVK,
+  KNOWN_UIVKS,
+  createClient
+};

package/dist/chunk-QBUZYA7S.js

@@ -0,0 +1,45 @@
+// 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 };
+}
+
+export {
+  toBase64Url,
+  decodeBase64Url,
+  buildZcashUri,
+  parseZip321Uri
+};

package/dist/chunk-QQCGKLYR.js

@@ -0,0 +1,10 @@
+// src/pricing.ts
+function claimCost(tiers, nameLength) {
+  if (tiers.length === 0) return null;
+  const idx = Math.min(Math.max(nameLength - 1, 0), tiers.length - 1);
+  return tiers[idx];
+}
+
+export {
+  claimCost
+};

package/dist/chunk-TNP4GYNO.js

@@ -0,0 +1,8 @@
+// src/validation.ts
+function isValidName(name) {
+  return /^[a-z0-9](?:[a-z0-9-]{0,60}[a-z0-9])?$/.test(name) && !name.includes("--");
+}
+
+export {
+  isValidName
+};

package/dist/client-N6gdk287.d.cts

@@ -0,0 +1,76 @@
+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 Pricing {
+    nonce: number;
+    height: number;
+    /** Per-character claim prices in zats.
+     *  Index 0 = 1-char names, index 1 = 2-char, etc.
+     *  Names longer than the array clamp to the last entry. */
+    tiers: number[];
+}
+interface StatusResult {
+    synced_height: number;
+    admin_pubkey: string;
+    uivk: string;
+    registered: number;
+    listed: number;
+    pricing: Pricing | null;
+}
+interface Event {
+    id: number;
+    name: string;
+    action: "CLAIM" | "LIST" | "DELIST" | "UPDATE" | "BUY";
+    txid: string;
+    height: number;
+    ua: string | null;
+    price: number | null;
+    nonce: number | null;
+    signature: string | null;
+}
+interface EventsFilter {
+    name?: string;
+    action?: string | string[];
+    since_height?: number;
+    limit?: number;
+    offset?: number;
+}
+interface EventsResult {
+    events: Event[];
+    total: number;
+}
+
+interface ClientOptions {
+    skipVerify?: boolean;
+}
+interface ZNSClient {
+    readonly url: string;
+    readonly verified: boolean;
+    resolve(query: string): Promise<ResolveResult | null>;
+    listings(): Promise<Listing[]>;
+    status(): Promise<StatusResult>;
+    events(filter?: EventsFilter): Promise<EventsResult>;
+    isAvailable(name: string): Promise<boolean>;
+    getNonce(name: string): Promise<number | null>;
+}
+declare function createClient(url?: string, options?: ClientOptions): Promise<ZNSClient>;
+
+export { type ClientOptions as C, type Event as E, type ListForSaleResult as L, type Pricing as P, type Registration as R, type StatusResult as S, type ZNSClient as Z, type EventsFilter as a, type EventsResult as b, type Listing as c, type ResolveResult as d, createClient as e };

package/dist/client-N6gdk287.d.ts

@@ -0,0 +1,76 @@
+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 Pricing {
+    nonce: number;
+    height: number;
+    /** Per-character claim prices in zats.
+     *  Index 0 = 1-char names, index 1 = 2-char, etc.
+     *  Names longer than the array clamp to the last entry. */
+    tiers: number[];
+}
+interface StatusResult {
+    synced_height: number;
+    admin_pubkey: string;
+    uivk: string;
+    registered: number;
+    listed: number;
+    pricing: Pricing | null;
+}
+interface Event {
+    id: number;
+    name: string;
+    action: "CLAIM" | "LIST" | "DELIST" | "UPDATE" | "BUY";
+    txid: string;
+    height: number;
+    ua: string | null;
+    price: number | null;
+    nonce: number | null;
+    signature: string | null;
+}
+interface EventsFilter {
+    name?: string;
+    action?: string | string[];
+    since_height?: number;
+    limit?: number;
+    offset?: number;
+}
+interface EventsResult {
+    events: Event[];
+    total: number;
+}
+
+interface ClientOptions {
+    skipVerify?: boolean;
+}
+interface ZNSClient {
+    readonly url: string;
+    readonly verified: boolean;
+    resolve(query: string): Promise<ResolveResult | null>;
+    listings(): Promise<Listing[]>;
+    status(): Promise<StatusResult>;
+    events(filter?: EventsFilter): Promise<EventsResult>;
+    isAvailable(name: string): Promise<boolean>;
+    getNonce(name: string): Promise<number | null>;
+}
+declare function createClient(url?: string, options?: ClientOptions): Promise<ZNSClient>;
+
+export { type ClientOptions as C, type Event as E, type ListForSaleResult as L, type Pricing as P, type Registration as R, type StatusResult as S, type ZNSClient as Z, type EventsFilter as a, type EventsResult as b, type Listing as c, type ResolveResult as d, createClient as e };

package/dist/client.cjs

@@ -0,0 +1,118 @@
+"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/client.ts
+var client_exports = {};
+__export(client_exports, {
+  createClient: () => createClient
+});
+module.exports = __toCommonJS(client_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["UivkMismatch"] = -2] = "UivkMismatch";
+  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://light.zcash.me/zns-testnet";
+var TESTNET_UIVK = "uivktest1hzw7wyadutvzfgpna80yftsk5l7jeyu2p5me5quvp28tytxueta00cx4068wnlzcv7tx9n3t3gfhsy83pe4y6jrhxtzaq0hj6xtg5zrk2dn7zen3vns2a5pgs4fxdjlletmqrhfa42";
+var MAINNET_UIVK = "uivk1gl26qy0xjja7lqhyg3pf0x4j4j66kqwewrjkdcg28eqq4wgtzjmujpee7x9cs2ec9xhnlgrm8ptlw8z80j2aryw8nqtssser2ys778a0s00uvgkdjnfr58sndhfvc3f4zqjs6ywva6";
+var KNOWN_UIVKS = [TESTNET_UIVK, MAINNET_UIVK];
+
+// 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 (!KNOWN_UIVKS.includes(s.uivk)) {
+      throw new ZNSError(
+        -2 /* UivkMismatch */,
+        `UIVK mismatch: indexer returned "${s.uivk.slice(0, 20)}..." which is not a known ZNS instance`
+      );
+    }
+    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 events(filter = {}) {
+      return call("events", filter);
+    },
+    async getNonce(name) {
+      const result = await client.resolve(name);
+      return result?.nonce ?? null;
+    }
+  };
+  return client;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createClient
+});

package/dist/client.d.cts

@@ -0,0 +1 @@
+export { C as ClientOptions, Z as ZNSClient, e as createClient } from './client-N6gdk287.cjs';

package/dist/client.d.ts

@@ -0,0 +1 @@
+export { C as ClientOptions, Z as ZNSClient, e as createClient } from './client-N6gdk287.js';

package/dist/client.js

@@ -0,0 +1,6 @@
+import {
+  createClient
+} from "./chunk-E3JAIK65.js";
+export {
+  createClient
+};