zcashname-sdk 0.8.4 → 0.8.5

package/dist/zns.cjs

@@ -33,117 +33,94 @@ __export(zns_exports, {
   BUY_COMMISSION: () => BUY_COMMISSION,
   DEFAULT_URL: () => DEFAULT_URL,
   LIST_COMMISSION: () => LIST_COMMISSION,
-  MAINNET_UIVK: () => MAINNET_UIVK,
-  TESTNET_UIVK: () => TESTNET_UIVK,
-  ZNS: () => ZNS,
-  ZNS_ACTIONS: () => ZNS_ACTIONS
+  NETWORKS: () => NETWORKS,
+  ZNS: () => ZNS
 });
 module.exports = __toCommonJS(zns_exports);
 var ed25519 = __toESM(require("@noble/ed25519"), 1);
 var import_bech32 = require("bech32");
 
 // src/types.ts
+var ZNS_ACTIONS = ["CLAIM", "BUY", "UPDATE", "LIST", "DELIST", "RELEASE"];
+
+// src/zns.ts
+var DEFAULT_URL = "https://light.zcash.me/zns-testnet";
 var BUY_COMMISSION = 1e4;
 var LIST_COMMISSION = 1e6;
-function toPendingBuy(raw) {
-  return {
-    buyer: raw.buyer_ua,
-    price: raw.price,
-    claimHeight: raw.claim_height,
-    expiresAt: raw.expires_at,
-    txid: raw.txid
-  };
-}
-function toListing(raw) {
-  return {
-    name: raw.name,
-    price: raw.price,
-    payTaddr: raw.pay_taddr,
-    nonce: raw.nonce,
-    txid: raw.txid,
-    height: raw.height,
-    signature: raw.signature,
-    pubkey: raw.pubkey,
-    pendingBuy: raw.pending_buy ? toPendingBuy(raw.pending_buy) : void 0
-  };
-}
-function toRegistration(raw) {
-  return {
-    name: raw.name,
-    address: raw.address,
-    txid: raw.txid,
-    height: raw.height,
-    nonce: raw.nonce,
-    signature: raw.signature,
-    lastAction: raw.last_action,
-    pubkey: raw.pubkey,
-    listing: raw.listing ? toListing(raw.listing) : null
-  };
-}
-function toPricing(raw) {
-  return {
-    nonce: raw.nonce,
-    height: raw.height,
-    tiers: raw.tiers
-  };
+var NETWORKS = {
+  testnet: {
+    url: "https://light.zcash.me/zns-testnet",
+    registryAddress: "utest1f32kn6c4zvn54xr8wfsnxmj9hzpu2mwgtxzpzwcw34906tdccdvzs0z2dx38lly7tpan77x6udt8pjczqm22ymsdhlz9j0tk5yq664nl",
+    uivk: "utest1hzw7wyadutvzfgpna80yftsk5l7jeyu2p5me5quvp28tytxueta00cx4068wnlzcv7tx9n3t3gfhsy83pe4y6jrhxtzaq0hj6xtg5zrk2dn7zen3vns2a5pgs4fxdjlletmqrhfa42"
+  },
+  mainnet: {
+    url: "https://light.zcash.me/zns",
+    registryAddress: "u1k0evt0ahj5qdt6y9ftsxndl8lrkm4ff6rp00u04cjpmqj6hxl9t8hfsxftmn3ht34e03lljh89czn2h8qn67rwrs8x0hm3lsxsucp9q9",
+    uivk: "u1k0evt0ahj5qdt6y9ftsxndl8lrkm4ff6rp00u04cjpmqj6hxl9t8hfsxftmn3ht34e03lljh89czn2h8qn67rwrs8x0hm3lsxsucp9q9"
+  }
+};
+var NAME_RE = /^[a-z0-9]{1,62}$/;
+function isValidName(name) {
+  return NAME_RE.test(name);
 }
-function toStatus(raw) {
-  return {
-    syncedHeight: raw.synced_height,
-    adminPubkey: raw.admin_pubkey,
-    uivk: raw.uivk,
-    address: raw.address,
-    registered: raw.registered,
-    listed: raw.listed,
-    pricing: raw.pricing ? toPricing(raw.pricing) : null
-  };
+function normalizeApiResponse(obj) {
+  if (Array.isArray(obj)) return obj.map((item) => normalizeApiResponse(item));
+  if (obj && typeof obj === "object") {
+    return Object.fromEntries(
+      Object.entries(obj).map(([k, v]) => [
+        k.replace(/_([a-z])/g, (_, c) => c.toUpperCase()),
+        normalizeApiResponse(v)
+      ])
+    );
+  }
+  return obj;
 }
-function toEvent(raw) {
-  return {
-    id: raw.id,
-    name: raw.name,
-    action: raw.action,
-    txid: raw.txid,
-    height: raw.height,
-    ua: raw.ua,
-    price: raw.price,
-    nonce: raw.nonce,
-    signature: raw.signature,
-    pubkey: raw.pubkey
-  };
+function isWholeNumber(value) {
+  return /^\d+$/.test(value) && !value.startsWith("0") || value === "0";
 }
-function toEventsFilter(raw) {
-  return {
-    name: raw.name,
-    action: raw.action,
-    since_height: raw.sinceHeight,
-    limit: raw.limit,
-    offset: raw.offset
-  };
+function isValidUnifiedAddress(address) {
+  if (!address) return false;
+  if (address.startsWith("utest1")) return true;
+  if (address.startsWith("u1")) return true;
+  try {
+    const decoded = import_bech32.bech32m.decode(address);
+    return decoded.prefix === "u" || decoded.prefix === "utest";
+  } catch {
+    return false;
+  }
 }
-function toEventsResult(raw) {
-  return {
-    events: raw.events.map(toEvent),
-    total: raw.total
-  };
+function isValidTransparentAddress(address) {
+  if (!address) return false;
+  const validPrefixes = ["t1", "t3", "tm", "tn"];
+  if (!validPrefixes.some((p) => address.startsWith(p))) return false;
+  if (address.length < 26 || address.length > 35) return false;
+  const base58Regex = /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]+$/;
+  return base58Regex.test(address);
 }
-
-// src/zns.ts
-var DEFAULT_URL = "https://light.zcash.me/zns-testnet";
-var TESTNET_UIVK = "utest1hzw7wyadutvzfgpna80yftsk5l7jeyu2p5me5quvp28tytxueta00cx4068wnlzcv7tx9n3t3gfhsy83pe4y6jrhxtzaq0hj6xtg5zrk2dn7zen3vns2a5pgs4fxdjlletmqrhfa42";
-var MAINNET_UIVK = "u1k0evt0ahj5qdt6y9ftsxndl8lrkm4ff6rp00u04cjpmqj6hxl9t8hfsxftmn3ht34e03lljh89czn2h8qn67rwrs8x0hm3lsxsucp9q9";
-var KNOWN_UIVKS = [TESTNET_UIVK, MAINNET_UIVK];
-var REGISTRY_ADDRESSES = {
-  testnet: "utest1f32kn6c4zvn54xr8wfsnxmj9hzpu2mwgtxzpzwcw34906tdccdvzs0z2dx38lly7tpan77x6udt8pjczqm22ymsdhlz9j0tk5yq664nl",
-  mainnet: "u1k0evt0ahj5qdt6y9ftsxndl8lrkm4ff6rp00u04cjpmqj6hxl9t8hfsxftmn3ht34e03lljh89czn2h8qn67rwrs8x0hm3lsxsucp9q9"
+var PAYLOAD_RULES = {
+  CLAIM: { format: "CLAIM:<name>:<ua>", checks: ["name", "ua"] },
+  BUY: { format: "BUY:<name>:<ua>", checks: ["name", "ua"] },
+  UPDATE: { format: "UPDATE:<name>:<ua>:<nonce>", checks: ["name", "ua", "nonce"] },
+  LIST: { format: "LIST:<name>:<price>:<pay_taddr>:<nonce>", checks: ["name", "price", "pay_taddr", "nonce"] },
+  DELIST: { format: "DELIST:<name>:<nonce>", checks: ["name", "nonce"] },
+  RELEASE: { format: "RELEASE:<name>:<nonce>", checks: ["name", "nonce"] }
 };
-var ZNS_ACTIONS = ["CLAIM", "BUY", "UPDATE", "LIST", "DELIST", "RELEASE"];
-var NAME_RE = /^[a-z0-9]{1,62}$/;
-function isWholeNumber(value) {
-  return /^\d+$/.test(value) && !value.startsWith("0") || value === "0";
+function validateField(value, type) {
+  switch (type) {
+    case "name":
+      return NAME_RE.test(value) ? null : "Invalid name. Use lowercase a-z and 0-9, 1 to 62 chars.";
+    case "ua":
+      return isValidUnifiedAddress(value) ? null : `Invalid unified address: "${value}".`;
+    case "price":
+      return isWholeNumber(value) && Number(value) > 0 ? null : "Price must be a positive whole number in zats.";
+    case "nonce":
+      return isWholeNumber(value) ? null : "Nonce must be a whole number.";
+    case "pay_taddr":
+      return isValidTransparentAddress(value) ? null : `Invalid transparent address: "${value}".`;
+  }
 }
-function mk(level, action, canonical, message) {
-  return { valid: level === "valid", action, canonicalAction: canonical, message, level };
+function buildValidationResult(level, action, message) {
+  return { valid: level === "valid", action, message, level };
 }
 var ZNS = class {
   /**
@@ -155,8 +132,20 @@ var ZNS = class {
   constructor(options) {
     this.rpcId = 0;
     this._verified = false;
+    /** Validate a Zcash Unified Address format.
+     *  Accepts both mainnet ('u') and testnet ('utest') prefixes.
+     *  Performs basic format validation but NOT full bech32m checksum verification.
+     *  Returns true if the address looks like a unified address, false otherwise.
+     * 
+     *  @todo(F4Jumble) Upgrade to full ZIP-316 decoding with F4Jumble to:
+     *    - Parse actual typecodes from address items
+     *    - Validate F4Jumble checksum (not just bech32m)
+     *    - Optionally enforce: address must contain at least one Orchard receiver (typecode 0x03)
+     *    Requires @noble/hashes (blake2b) implementation of F4Jumble inverse. */
+    this.isValidUnifiedAddress = isValidUnifiedAddress;
+    this.isValidTransparentAddress = isValidTransparentAddress;
     this.network = options?.network ?? "testnet";
-    this.url = options?.url ?? DEFAULT_URL;
+    this.url = options?.url ?? NETWORKS[this.network].url;
   }
   /**
    * Verifies that the connected server is a known ZNS instance.
@@ -164,7 +153,7 @@ var ZNS = class {
    */
   async verify() {
     const status = await this.status();
-    if (!KNOWN_UIVKS.includes(status.uivk)) {
+    if (status.uivk !== NETWORKS[this.network].uivk) {
       throw new Error(
         `UIVK mismatch: indexer returned "${status.uivk.slice(0, 20)}..." which is not a known ZNS instance`
       );
@@ -177,21 +166,17 @@ var ZNS = class {
   }
   /** Get the registry address for the current network. */
   get registryAddress() {
-    const addr = REGISTRY_ADDRESSES[this.network];
-    if (!addr) {
-      throw new Error(`Unknown network: ${this.network}`);
-    }
-    return addr;
+    return NETWORKS[this.network].registryAddress;
   }
   /** Fetch current server status including pricing and configuration. */
   async status() {
     const raw = await this.rpc("status");
-    return toStatus(raw);
+    return normalizeApiResponse(raw);
   }
   /** Resolve a ZNS name to its registration. Returns null if not registered. */
   async resolveName(name) {
     const raw = await this.rpc("resolve", { query: name });
-    return raw ? toRegistration(raw) : null;
+    return raw ? normalizeApiResponse(raw) : null;
   }
   /** Resolve a Zcash Unified Address to all names pointing to it. Returns empty array if none.
    *  Supports pagination with limit (default 50, max 500) and offset (default 0). */
@@ -201,7 +186,7 @@ var ZNS = class {
       limit,
       offset
     });
-    return raw.map(toRegistration);
+    return raw.map((r) => normalizeApiResponse(r));
   }
   /** List all registered names. Useful for explorers or browsers.
    *  Supports pagination with limit (default 50, max 500) and offset (default 0). */
@@ -211,62 +196,31 @@ var ZNS = class {
       limit,
       offset
     });
-    return raw.map(toRegistration);
+    return raw.map((r) => normalizeApiResponse(r));
   }
   /** Check if a name is available for registration.
    *  Returns false immediately for invalid names without hitting the server. */
   async isAvailable(name) {
-    if (!this.isValidName(name)) return false;
+    if (!isValidName(name)) return false;
     const result = await this.resolveName(name);
     return result === null;
   }
-  /** Validate a Zcash Unified Address format.
-   *  Accepts both mainnet ('u') and testnet ('utest') prefixes.
-   *  Performs basic format validation but NOT full bech32m checksum verification.
-   *  Returns true if the address looks like a unified address, false otherwise. */
-  isValidUnifiedAddress(address) {
-    if (!address) return false;
-    if (address.startsWith("utest1")) return true;
-    if (address.startsWith("u1")) return true;
-    try {
-      const decoded = import_bech32.bech32m.decode(address);
-      return decoded.prefix === "u" || decoded.prefix === "utest";
-    } catch {
-      return false;
-    }
-  }
   async listings(limit, offset) {
-    const result = await this.rpc("listings", {
+    const raw = await this.rpc("listings", {
       limit,
       offset
     });
     return {
-      listings: result.listings.map((l) => ({
-        name: l.name,
-        price: l.price,
-        payTaddr: l.pay_taddr,
-        nonce: l.nonce,
-        txid: l.txid,
-        height: l.height,
-        signature: l.signature,
-        pubkey: l.pubkey,
-        pendingBuy: l.pending_buy ? {
-          buyer: l.pending_buy.buyer_ua,
-          price: l.pending_buy.price,
-          claimHeight: l.pending_buy.claim_height,
-          expiresAt: l.pending_buy.expires_at,
-          txid: l.pending_buy.txid
-        } : void 0
-      })),
-      total: result.total
+      listings: raw.listings.map((l) => normalizeApiResponse(l)),
+      total: raw.total
     };
   }
   async events(filter) {
     const raw = await this.rpc(
       "events",
-      toEventsFilter(filter ?? {})
+      normalizeApiResponse(filter ?? {})
     );
-    return toEventsResult(raw);
+    return normalizeApiResponse(raw);
   }
   /**
    * Verify a listing's signature.
@@ -292,10 +246,6 @@ var ZNS = class {
     if (!payload) return false;
     return this.verifyEd25519(payload, reg.signature, pubkey);
   }
-  /** Check if a name is valid format (lowercase alphanumeric, 1-62 chars). */
-  isValidName(name) {
-    return NAME_RE.test(name);
-  }
   /**
    * Validate a signing payload string against the ZNS memo format spec.
    *
@@ -322,7 +272,6 @@ var ZNS = class {
       return {
         valid: false,
         action: "",
-        canonicalAction: null,
         message: "Empty payload.",
         level: "invalid"
       };
@@ -332,83 +281,29 @@ var ZNS = class {
       return {
         valid: false,
         action: raw.toUpperCase(),
-        canonicalAction: null,
         message: "Missing colon separator. Expected format: ACTION:field1:field2:...",
         level: "invalid"
       };
     }
-    const actionUpper = raw.slice(0, colonIdx).toUpperCase();
-    const actionLower = raw.slice(0, colonIdx).toLowerCase();
+    const action = raw.slice(0, colonIdx).toUpperCase();
     const rest = raw.slice(colonIdx + 1);
     const parts = rest.split(":");
-    switch (actionLower) {
-      case "claim": {
-        if (parts.length !== 2)
-          return mk("invalid", actionUpper, "claim", `Expected CLAIM:<name>:<ua>.`);
-        if (!NAME_RE.test(parts[0]))
-          return mk("invalid", actionUpper, "claim", `Invalid name. Use lowercase a-z and 0-9, 1 to 62 chars.`);
-        if (!this.isValidUnifiedAddress(parts[1]))
-          return mk("invalid", actionUpper, "claim", `Invalid unified address: "${parts[1]}".`);
-        return mk("valid", actionUpper, "claim", "Valid CLAIM payload.");
-      }
-      case "buy": {
-        if (parts.length !== 2)
-          return mk("invalid", actionUpper, "buy", `Expected BUY:<name>:<buyer_ua>.`);
-        if (!NAME_RE.test(parts[0]))
-          return mk("invalid", actionUpper, "buy", `Invalid name. Use lowercase a-z and 0-9, 1 to 62 chars.`);
-        if (!this.isValidUnifiedAddress(parts[1]))
-          return mk("invalid", actionUpper, "buy", `Invalid unified address: "${parts[1]}".`);
-        return mk("valid", actionUpper, "buy", "Valid BUY payload.");
-      }
-      case "update": {
-        if (parts.length !== 3)
-          return mk("invalid", actionUpper, "update", `Expected UPDATE:<name>:<ua>:<nonce>.`);
-        if (!NAME_RE.test(parts[0]))
-          return mk("invalid", actionUpper, "update", `Invalid name. Use lowercase a-z and 0-9, 1 to 62 chars.`);
-        if (!this.isValidUnifiedAddress(parts[1]))
-          return mk("invalid", actionUpper, "update", `Invalid unified address: "${parts[1]}".`);
-        if (!isWholeNumber(parts[2]))
-          return mk("invalid", actionUpper, "update", `Nonce must be a whole number.`);
-        return mk("valid", actionUpper, "update", "Valid UPDATE payload.");
-      }
-      case "list": {
-        if (parts.length !== 4)
-          return mk("invalid", actionUpper, "list", `Expected LIST:<name>:<price_zats>:<pay_taddr>:<nonce>.`);
-        if (!NAME_RE.test(parts[0]))
-          return mk("invalid", actionUpper, "list", `Invalid name. Use lowercase a-z and 0-9, 1 to 62 chars.`);
-        if (!isWholeNumber(parts[1]) || Number(parts[1]) <= 0)
-          return mk("invalid", actionUpper, "list", `Price must be a positive whole number in zats.`);
-        if (!isWholeNumber(parts[3]))
-          return mk("invalid", actionUpper, "list", `Nonce must be a whole number.`);
-        return mk("valid", actionUpper, "list", "Valid LIST payload.");
-      }
-      case "delist": {
-        if (parts.length !== 2)
-          return mk("invalid", actionUpper, "delist", `Expected DELIST:<name>:<nonce>.`);
-        if (!NAME_RE.test(parts[0]))
-          return mk("invalid", actionUpper, "delist", `Invalid name. Use lowercase a-z and 0-9, 1 to 62 chars.`);
-        if (!isWholeNumber(parts[1]))
-          return mk("invalid", actionUpper, "delist", `Nonce must be a whole number.`);
-        return mk("valid", actionUpper, "delist", "Valid DELIST payload.");
-      }
-      case "release": {
-        if (parts.length !== 2)
-          return mk("invalid", actionUpper, "release", `Expected RELEASE:<name>:<nonce>.`);
-        if (!NAME_RE.test(parts[0]))
-          return mk("invalid", actionUpper, "release", `Invalid name. Use lowercase a-z and 0-9, 1 to 62 chars.`);
-        if (!isWholeNumber(parts[1]))
-          return mk("invalid", actionUpper, "release", `Nonce must be a whole number.`);
-        return mk("valid", actionUpper, "release", "Valid RELEASE payload.");
-      }
-      default:
-        return {
-          valid: false,
-          action: actionUpper,
-          canonicalAction: null,
-          message: `Unrecognized action "${actionUpper}". Valid actions: ${ZNS_ACTIONS.join(", ")}.`,
-          level: "unrecognized"
-        };
+    if (!ZNS_ACTIONS.includes(action)) {
+      return {
+        valid: false,
+        action,
+        message: `Unrecognized action "${action}". Valid actions: ${ZNS_ACTIONS.join(", ")}.`,
+        level: "unrecognized"
+      };
+    }
+    const rule = PAYLOAD_RULES[action];
+    if (parts.length !== rule.checks.length)
+      return buildValidationResult("invalid", action, `Expected ${rule.format}.`);
+    for (let i = 0; i < rule.checks.length; i++) {
+      const err = validateField(parts[i], rule.checks[i]);
+      if (err) return buildValidationResult("invalid", action, err);
     }
+    return buildValidationResult("valid", action, `Valid ${action} payload.`);
   }
   /**
    * Get the claim cost in zatoshis for a name of given length.
@@ -451,7 +346,7 @@ var ZNS = class {
    */
   prepareClaim(name, address, cost) {
     this.requireValidName(name);
-    if (!this.isValidUnifiedAddress(address)) {
+    if (!isValidUnifiedAddress(address)) {
       throw new Error(`Invalid Zcash Unified Address: ${address}`);
     }
     return {
@@ -494,7 +389,7 @@ var ZNS = class {
   }
   prepareUpdate(name, newAddress, nonce) {
     this.requireValidName(name);
-    if (!this.isValidUnifiedAddress(newAddress)) {
+    if (!isValidUnifiedAddress(newAddress)) {
       throw new Error(`Invalid Zcash Unified Address: ${newAddress}`);
     }
     return {
@@ -576,7 +471,7 @@ var ZNS = class {
     }
   }
   requireValidName(name) {
-    if (!NAME_RE.test(name)) throw new Error(`Invalid ZNS name: ${name}`);
+    if (!isValidName(name)) throw new Error(`Invalid ZNS name: ${name}`);
   }
   /** Build a ZIP-321 URI. Amount is in zatoshis and will be converted to ZEC for the URI. */
   buildZcashUri(address, amountZats, memo) {
@@ -642,8 +537,6 @@ var ZNS = class {
   BUY_COMMISSION,
   DEFAULT_URL,
   LIST_COMMISSION,
-  MAINNET_UIVK,
-  TESTNET_UIVK,
-  ZNS,
-  ZNS_ACTIONS
+  NETWORKS,
+  ZNS
 });

package/dist/zns.d.cts

@@ -1,18 +1,21 @@
 /**
- * Internal types that mirror the Rust indexer API exactly (snake_case).
- * These are used for raw data passthrough and debugging.
- * Public SDK consumers should use the camelCase types exported below.
+ * ZNS TypeScript SDK types.
+ *
+ * API responses are converted from snake_case (Rust convention) to camelCase
+ * (TypeScript convention) using the snakeToCamel utility. Types below are the
+ * user-facing shape — Raw* types and manual converters have been removed.
  */
 type Zats = number;
-/** Commission sent with a BUY claim memo (0.0001 ZEC = 10,000 zats). */
-declare const BUY_COMMISSION: Zats;
-/** Listing commission sent with a LIST memo (0.01 ZEC = 1,000,000 zats).
- *  Mirrors the indexer's formula: min_tier × 1000. */
-declare const LIST_COMMISSION: Zats;
-/** Actions that can be the 'last action' on a Registration (ownership-changing actions) */
-type LastAction = "CLAIM" | "BUY" | "UPDATE" | "DELIST" | "RELEASE";
-/** All actions that can appear in the Event log (includes non-ownership actions like LIST) */
-type EventAction = "CLAIM" | "LIST" | "DELIST" | "RELEASE" | "UPDATE" | "BUY" | "SETPRICE";
+/** Target network for ZNS operations. */
+type Network = "testnet" | "mainnet";
+/** All user-signable ZNS actions. Single source of truth — ZnsAction is derived from this. */
+declare const ZNS_ACTIONS: readonly ["CLAIM", "BUY", "UPDATE", "LIST", "DELIST", "RELEASE"];
+/** Union of all user-signable action names. Derived from ZNS_ACTIONS. */
+type ZnsAction = (typeof ZNS_ACTIONS)[number];
+/** Ownership-changing actions — can appear as Registration.lastAction. */
+type LastAction = Exclude<ZnsAction, "LIST">;
+/** All actions that appear in the event log — user actions plus admin SETPRICE. */
+type EventAction = ZnsAction | "SETPRICE";
 /** Pending purchase for a listed name. */
 interface PendingBuy {
     buyer: string;
@@ -152,8 +155,6 @@ interface PayloadValidationResult {
     readonly valid: boolean;
     /** Parsed action name (uppercase), e.g. "CLAIM", "LIST" */
     readonly action: string;
-    /** Canonical action used internally (lowercase), e.g. "claim", "list" */
-    readonly canonicalAction: string | null;
     /** Human-readable validation message */
     readonly message: string;
     /** Validation level: valid | invalid | unrecognized */
@@ -161,12 +162,28 @@ interface PayloadValidationResult {
 }
 
 declare const DEFAULT_URL = "https://light.zcash.me/zns-testnet";
-declare const TESTNET_UIVK = "utest1hzw7wyadutvzfgpna80yftsk5l7jeyu2p5me5quvp28tytxueta00cx4068wnlzcv7tx9n3t3gfhsy83pe4y6jrhxtzaq0hj6xtg5zrk2dn7zen3vns2a5pgs4fxdjlletmqrhfa42";
-declare const MAINNET_UIVK = "u1k0evt0ahj5qdt6y9ftsxndl8lrkm4ff6rp00u04cjpmqj6hxl9t8hfsxftmn3ht34e03lljh89czn2h8qn67rwrs8x0hm3lsxsucp9q9";
-/** Actions accepted by {@link validatePayload}. Exposed for consumers who need
- *  to build action selectors or dynamic validation. */
-declare const ZNS_ACTIONS: readonly ["CLAIM", "BUY", "UPDATE", "LIST", "DELIST", "RELEASE"];
-type Network = "testnet" | "mainnet";
+/** Commission sent with a BUY claim memo (0.0001 ZEC = 10,000 zats). */
+declare const BUY_COMMISSION: Zats;
+/** Listing commission sent with a LIST memo (0.01 ZEC = 1,000,000 zats).
+ *  Mirrors the indexer's formula: min_tier × 1000. */
+declare const LIST_COMMISSION: Zats;
+/** Network-specific configuration for ZNS. */
+declare const NETWORKS: {
+    readonly testnet: {
+        readonly url: "https://light.zcash.me/zns-testnet";
+        readonly registryAddress: "utest1f32kn6c4zvn54xr8wfsnxmj9hzpu2mwgtxzpzwcw34906tdccdvzs0z2dx38lly7tpan77x6udt8pjczqm22ymsdhlz9j0tk5yq664nl";
+        readonly uivk: "utest1hzw7wyadutvzfgpna80yftsk5l7jeyu2p5me5quvp28tytxueta00cx4068wnlzcv7tx9n3t3gfhsy83pe4y6jrhxtzaq0hj6xtg5zrk2dn7zen3vns2a5pgs4fxdjlletmqrhfa42";
+    };
+    readonly mainnet: {
+        readonly url: "https://light.zcash.me/zns";
+        readonly registryAddress: "u1k0evt0ahj5qdt6y9ftsxndl8lrkm4ff6rp00u04cjpmqj6hxl9t8hfsxftmn3ht34e03lljh89czn2h8qn67rwrs8x0hm3lsxsucp9q9";
+        readonly uivk: "u1k0evt0ahj5qdt6y9ftsxndl8lrkm4ff6rp00u04cjpmqj6hxl9t8hfsxftmn3ht34e03lljh89czn2h8qn67rwrs8x0hm3lsxsucp9q9";
+    };
+};
+/** Validates a Zcash unified (u-) address. */
+declare function isValidUnifiedAddress(address: string): boolean;
+/** Validates a Zcash transparent (t-) address. */
+declare function isValidTransparentAddress(address: string): boolean;
 declare class ZNS {
     private url;
     private network;
@@ -207,8 +224,15 @@ declare class ZNS {
     /** Validate a Zcash Unified Address format.
      *  Accepts both mainnet ('u') and testnet ('utest') prefixes.
      *  Performs basic format validation but NOT full bech32m checksum verification.
-     *  Returns true if the address looks like a unified address, false otherwise. */
-    isValidUnifiedAddress(address: string): boolean;
+     *  Returns true if the address looks like a unified address, false otherwise.
+     *
+     *  @todo(F4Jumble) Upgrade to full ZIP-316 decoding with F4Jumble to:
+     *    - Parse actual typecodes from address items
+     *    - Validate F4Jumble checksum (not just bech32m)
+     *    - Optionally enforce: address must contain at least one Orchard receiver (typecode 0x03)
+     *    Requires @noble/hashes (blake2b) implementation of F4Jumble inverse. */
+    isValidUnifiedAddress: typeof isValidUnifiedAddress;
+    isValidTransparentAddress: typeof isValidTransparentAddress;
     listings(limit?: number, offset?: number): Promise<{
         listings: Listing[];
         total: number;
@@ -228,8 +252,6 @@ declare class ZNS {
      * @returns true if the signature is valid
      */
     verifyRegistration(reg: Registration, adminPubkey: string): Promise<boolean>;
-    /** Check if a name is valid format (lowercase alphanumeric, 1-62 chars). */
-    isValidName(name: string): boolean;
     /**
      * Validate a signing payload string against the ZNS memo format spec.
      *
@@ -296,4 +318,4 @@ declare class ZNS {
     private rpc;
 }
 
-export { BUY_COMMISSION, type CompletedAction, DEFAULT_URL, type Event, type EventAction, type EventsFilter, type EventsResult, LIST_COMMISSION, type LastAction, type Listing, MAINNET_UIVK, type Network, type PayloadValidationLevel, type PayloadValidationResult, type PendingBuy, type PreparedBuy, type PreparedClaim, type PreparedDelist, type PreparedList, type PreparedRelease, type PreparedSetPrice, type PreparedUpdate, type Pricing, type Registration, type Status, TESTNET_UIVK, ZNS, ZNS_ACTIONS, type Zats };
+export { BUY_COMMISSION, DEFAULT_URL, LIST_COMMISSION, NETWORKS, ZNS };

package/dist/zns.d.ts

@@ -1,18 +1,21 @@
 /**
- * Internal types that mirror the Rust indexer API exactly (snake_case).
- * These are used for raw data passthrough and debugging.
- * Public SDK consumers should use the camelCase types exported below.
+ * ZNS TypeScript SDK types.
+ *
+ * API responses are converted from snake_case (Rust convention) to camelCase
+ * (TypeScript convention) using the snakeToCamel utility. Types below are the
+ * user-facing shape — Raw* types and manual converters have been removed.
  */
 type Zats = number;
-/** Commission sent with a BUY claim memo (0.0001 ZEC = 10,000 zats). */
-declare const BUY_COMMISSION: Zats;
-/** Listing commission sent with a LIST memo (0.01 ZEC = 1,000,000 zats).
- *  Mirrors the indexer's formula: min_tier × 1000. */
-declare const LIST_COMMISSION: Zats;
-/** Actions that can be the 'last action' on a Registration (ownership-changing actions) */
-type LastAction = "CLAIM" | "BUY" | "UPDATE" | "DELIST" | "RELEASE";
-/** All actions that can appear in the Event log (includes non-ownership actions like LIST) */
-type EventAction = "CLAIM" | "LIST" | "DELIST" | "RELEASE" | "UPDATE" | "BUY" | "SETPRICE";
+/** Target network for ZNS operations. */
+type Network = "testnet" | "mainnet";
+/** All user-signable ZNS actions. Single source of truth — ZnsAction is derived from this. */
+declare const ZNS_ACTIONS: readonly ["CLAIM", "BUY", "UPDATE", "LIST", "DELIST", "RELEASE"];
+/** Union of all user-signable action names. Derived from ZNS_ACTIONS. */
+type ZnsAction = (typeof ZNS_ACTIONS)[number];
+/** Ownership-changing actions — can appear as Registration.lastAction. */
+type LastAction = Exclude<ZnsAction, "LIST">;
+/** All actions that appear in the event log — user actions plus admin SETPRICE. */
+type EventAction = ZnsAction | "SETPRICE";
 /** Pending purchase for a listed name. */
 interface PendingBuy {
     buyer: string;
@@ -152,8 +155,6 @@ interface PayloadValidationResult {
     readonly valid: boolean;
     /** Parsed action name (uppercase), e.g. "CLAIM", "LIST" */
     readonly action: string;
-    /** Canonical action used internally (lowercase), e.g. "claim", "list" */
-    readonly canonicalAction: string | null;
     /** Human-readable validation message */
     readonly message: string;
     /** Validation level: valid | invalid | unrecognized */
@@ -161,12 +162,28 @@ interface PayloadValidationResult {
 }
 
 declare const DEFAULT_URL = "https://light.zcash.me/zns-testnet";
-declare const TESTNET_UIVK = "utest1hzw7wyadutvzfgpna80yftsk5l7jeyu2p5me5quvp28tytxueta00cx4068wnlzcv7tx9n3t3gfhsy83pe4y6jrhxtzaq0hj6xtg5zrk2dn7zen3vns2a5pgs4fxdjlletmqrhfa42";
-declare const MAINNET_UIVK = "u1k0evt0ahj5qdt6y9ftsxndl8lrkm4ff6rp00u04cjpmqj6hxl9t8hfsxftmn3ht34e03lljh89czn2h8qn67rwrs8x0hm3lsxsucp9q9";
-/** Actions accepted by {@link validatePayload}. Exposed for consumers who need
- *  to build action selectors or dynamic validation. */
-declare const ZNS_ACTIONS: readonly ["CLAIM", "BUY", "UPDATE", "LIST", "DELIST", "RELEASE"];
-type Network = "testnet" | "mainnet";
+/** Commission sent with a BUY claim memo (0.0001 ZEC = 10,000 zats). */
+declare const BUY_COMMISSION: Zats;
+/** Listing commission sent with a LIST memo (0.01 ZEC = 1,000,000 zats).
+ *  Mirrors the indexer's formula: min_tier × 1000. */
+declare const LIST_COMMISSION: Zats;
+/** Network-specific configuration for ZNS. */
+declare const NETWORKS: {
+    readonly testnet: {
+        readonly url: "https://light.zcash.me/zns-testnet";
+        readonly registryAddress: "utest1f32kn6c4zvn54xr8wfsnxmj9hzpu2mwgtxzpzwcw34906tdccdvzs0z2dx38lly7tpan77x6udt8pjczqm22ymsdhlz9j0tk5yq664nl";
+        readonly uivk: "utest1hzw7wyadutvzfgpna80yftsk5l7jeyu2p5me5quvp28tytxueta00cx4068wnlzcv7tx9n3t3gfhsy83pe4y6jrhxtzaq0hj6xtg5zrk2dn7zen3vns2a5pgs4fxdjlletmqrhfa42";
+    };
+    readonly mainnet: {
+        readonly url: "https://light.zcash.me/zns";
+        readonly registryAddress: "u1k0evt0ahj5qdt6y9ftsxndl8lrkm4ff6rp00u04cjpmqj6hxl9t8hfsxftmn3ht34e03lljh89czn2h8qn67rwrs8x0hm3lsxsucp9q9";
+        readonly uivk: "u1k0evt0ahj5qdt6y9ftsxndl8lrkm4ff6rp00u04cjpmqj6hxl9t8hfsxftmn3ht34e03lljh89czn2h8qn67rwrs8x0hm3lsxsucp9q9";
+    };
+};
+/** Validates a Zcash unified (u-) address. */
+declare function isValidUnifiedAddress(address: string): boolean;
+/** Validates a Zcash transparent (t-) address. */
+declare function isValidTransparentAddress(address: string): boolean;
 declare class ZNS {
     private url;
     private network;
@@ -207,8 +224,15 @@ declare class ZNS {
     /** Validate a Zcash Unified Address format.
      *  Accepts both mainnet ('u') and testnet ('utest') prefixes.
      *  Performs basic format validation but NOT full bech32m checksum verification.
-     *  Returns true if the address looks like a unified address, false otherwise. */
-    isValidUnifiedAddress(address: string): boolean;
+     *  Returns true if the address looks like a unified address, false otherwise.
+     *
+     *  @todo(F4Jumble) Upgrade to full ZIP-316 decoding with F4Jumble to:
+     *    - Parse actual typecodes from address items
+     *    - Validate F4Jumble checksum (not just bech32m)
+     *    - Optionally enforce: address must contain at least one Orchard receiver (typecode 0x03)
+     *    Requires @noble/hashes (blake2b) implementation of F4Jumble inverse. */
+    isValidUnifiedAddress: typeof isValidUnifiedAddress;
+    isValidTransparentAddress: typeof isValidTransparentAddress;
     listings(limit?: number, offset?: number): Promise<{
         listings: Listing[];
         total: number;
@@ -228,8 +252,6 @@ declare class ZNS {
      * @returns true if the signature is valid
      */
     verifyRegistration(reg: Registration, adminPubkey: string): Promise<boolean>;
-    /** Check if a name is valid format (lowercase alphanumeric, 1-62 chars). */
-    isValidName(name: string): boolean;
     /**
      * Validate a signing payload string against the ZNS memo format spec.
      *
@@ -296,4 +318,4 @@ declare class ZNS {
     private rpc;
 }
 
-export { BUY_COMMISSION, type CompletedAction, DEFAULT_URL, type Event, type EventAction, type EventsFilter, type EventsResult, LIST_COMMISSION, type LastAction, type Listing, MAINNET_UIVK, type Network, type PayloadValidationLevel, type PayloadValidationResult, type PendingBuy, type PreparedBuy, type PreparedClaim, type PreparedDelist, type PreparedList, type PreparedRelease, type PreparedSetPrice, type PreparedUpdate, type Pricing, type Registration, type Status, TESTNET_UIVK, ZNS, ZNS_ACTIONS, type Zats };
+export { BUY_COMMISSION, DEFAULT_URL, LIST_COMMISSION, NETWORKS, ZNS };

package/dist/zns.js

@@ -3,107 +3,86 @@ import * as ed25519 from "@noble/ed25519";
 import { bech32m } from "bech32";
 
 // src/types.ts
+var ZNS_ACTIONS = ["CLAIM", "BUY", "UPDATE", "LIST", "DELIST", "RELEASE"];
+
+// src/zns.ts
+var DEFAULT_URL = "https://light.zcash.me/zns-testnet";
 var BUY_COMMISSION = 1e4;
 var LIST_COMMISSION = 1e6;
-function toPendingBuy(raw) {
-  return {
-    buyer: raw.buyer_ua,
-    price: raw.price,
-    claimHeight: raw.claim_height,
-    expiresAt: raw.expires_at,
-    txid: raw.txid
-  };
-}
-function toListing(raw) {
-  return {
-    name: raw.name,
-    price: raw.price,
-    payTaddr: raw.pay_taddr,
-    nonce: raw.nonce,
-    txid: raw.txid,
-    height: raw.height,
-    signature: raw.signature,
-    pubkey: raw.pubkey,
-    pendingBuy: raw.pending_buy ? toPendingBuy(raw.pending_buy) : void 0
-  };
-}
-function toRegistration(raw) {
-  return {
-    name: raw.name,
-    address: raw.address,
-    txid: raw.txid,
-    height: raw.height,
-    nonce: raw.nonce,
-    signature: raw.signature,
-    lastAction: raw.last_action,
-    pubkey: raw.pubkey,
-    listing: raw.listing ? toListing(raw.listing) : null
-  };
-}
-function toPricing(raw) {
-  return {
-    nonce: raw.nonce,
-    height: raw.height,
-    tiers: raw.tiers
-  };
+var NETWORKS = {
+  testnet: {
+    url: "https://light.zcash.me/zns-testnet",
+    registryAddress: "utest1f32kn6c4zvn54xr8wfsnxmj9hzpu2mwgtxzpzwcw34906tdccdvzs0z2dx38lly7tpan77x6udt8pjczqm22ymsdhlz9j0tk5yq664nl",
+    uivk: "utest1hzw7wyadutvzfgpna80yftsk5l7jeyu2p5me5quvp28tytxueta00cx4068wnlzcv7tx9n3t3gfhsy83pe4y6jrhxtzaq0hj6xtg5zrk2dn7zen3vns2a5pgs4fxdjlletmqrhfa42"
+  },
+  mainnet: {
+    url: "https://light.zcash.me/zns",
+    registryAddress: "u1k0evt0ahj5qdt6y9ftsxndl8lrkm4ff6rp00u04cjpmqj6hxl9t8hfsxftmn3ht34e03lljh89czn2h8qn67rwrs8x0hm3lsxsucp9q9",
+    uivk: "u1k0evt0ahj5qdt6y9ftsxndl8lrkm4ff6rp00u04cjpmqj6hxl9t8hfsxftmn3ht34e03lljh89czn2h8qn67rwrs8x0hm3lsxsucp9q9"
+  }
+};
+var NAME_RE = /^[a-z0-9]{1,62}$/;
+function isValidName(name) {
+  return NAME_RE.test(name);
 }
-function toStatus(raw) {
-  return {
-    syncedHeight: raw.synced_height,
-    adminPubkey: raw.admin_pubkey,
-    uivk: raw.uivk,
-    address: raw.address,
-    registered: raw.registered,
-    listed: raw.listed,
-    pricing: raw.pricing ? toPricing(raw.pricing) : null
-  };
+function normalizeApiResponse(obj) {
+  if (Array.isArray(obj)) return obj.map((item) => normalizeApiResponse(item));
+  if (obj && typeof obj === "object") {
+    return Object.fromEntries(
+      Object.entries(obj).map(([k, v]) => [
+        k.replace(/_([a-z])/g, (_, c) => c.toUpperCase()),
+        normalizeApiResponse(v)
+      ])
+    );
+  }
+  return obj;
 }
-function toEvent(raw) {
-  return {
-    id: raw.id,
-    name: raw.name,
-    action: raw.action,
-    txid: raw.txid,
-    height: raw.height,
-    ua: raw.ua,
-    price: raw.price,
-    nonce: raw.nonce,
-    signature: raw.signature,
-    pubkey: raw.pubkey
-  };
+function isWholeNumber(value) {
+  return /^\d+$/.test(value) && !value.startsWith("0") || value === "0";
 }
-function toEventsFilter(raw) {
-  return {
-    name: raw.name,
-    action: raw.action,
-    since_height: raw.sinceHeight,
-    limit: raw.limit,
-    offset: raw.offset
-  };
+function isValidUnifiedAddress(address) {
+  if (!address) return false;
+  if (address.startsWith("utest1")) return true;
+  if (address.startsWith("u1")) return true;
+  try {
+    const decoded = bech32m.decode(address);
+    return decoded.prefix === "u" || decoded.prefix === "utest";
+  } catch {
+    return false;
+  }
 }
-function toEventsResult(raw) {
-  return {
-    events: raw.events.map(toEvent),
-    total: raw.total
-  };
+function isValidTransparentAddress(address) {
+  if (!address) return false;
+  const validPrefixes = ["t1", "t3", "tm", "tn"];
+  if (!validPrefixes.some((p) => address.startsWith(p))) return false;
+  if (address.length < 26 || address.length > 35) return false;
+  const base58Regex = /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]+$/;
+  return base58Regex.test(address);
 }
-
-// src/zns.ts
-var DEFAULT_URL = "https://light.zcash.me/zns-testnet";
-var TESTNET_UIVK = "utest1hzw7wyadutvzfgpna80yftsk5l7jeyu2p5me5quvp28tytxueta00cx4068wnlzcv7tx9n3t3gfhsy83pe4y6jrhxtzaq0hj6xtg5zrk2dn7zen3vns2a5pgs4fxdjlletmqrhfa42";
-var MAINNET_UIVK = "u1k0evt0ahj5qdt6y9ftsxndl8lrkm4ff6rp00u04cjpmqj6hxl9t8hfsxftmn3ht34e03lljh89czn2h8qn67rwrs8x0hm3lsxsucp9q9";
-var KNOWN_UIVKS = [TESTNET_UIVK, MAINNET_UIVK];
-var REGISTRY_ADDRESSES = {
-  testnet: "utest1f32kn6c4zvn54xr8wfsnxmj9hzpu2mwgtxzpzwcw34906tdccdvzs0z2dx38lly7tpan77x6udt8pjczqm22ymsdhlz9j0tk5yq664nl",
-  mainnet: "u1k0evt0ahj5qdt6y9ftsxndl8lrkm4ff6rp00u04cjpmqj6hxl9t8hfsxftmn3ht34e03lljh89czn2h8qn67rwrs8x0hm3lsxsucp9q9"
+var PAYLOAD_RULES = {
+  CLAIM: { format: "CLAIM:<name>:<ua>", checks: ["name", "ua"] },
+  BUY: { format: "BUY:<name>:<ua>", checks: ["name", "ua"] },
+  UPDATE: { format: "UPDATE:<name>:<ua>:<nonce>", checks: ["name", "ua", "nonce"] },
+  LIST: { format: "LIST:<name>:<price>:<pay_taddr>:<nonce>", checks: ["name", "price", "pay_taddr", "nonce"] },
+  DELIST: { format: "DELIST:<name>:<nonce>", checks: ["name", "nonce"] },
+  RELEASE: { format: "RELEASE:<name>:<nonce>", checks: ["name", "nonce"] }
 };
-var ZNS_ACTIONS = ["CLAIM", "BUY", "UPDATE", "LIST", "DELIST", "RELEASE"];
-var NAME_RE = /^[a-z0-9]{1,62}$/;
-function isWholeNumber(value) {
-  return /^\d+$/.test(value) && !value.startsWith("0") || value === "0";
+function validateField(value, type) {
+  switch (type) {
+    case "name":
+      return NAME_RE.test(value) ? null : "Invalid name. Use lowercase a-z and 0-9, 1 to 62 chars.";
+    case "ua":
+      return isValidUnifiedAddress(value) ? null : `Invalid unified address: "${value}".`;
+    case "price":
+      return isWholeNumber(value) && Number(value) > 0 ? null : "Price must be a positive whole number in zats.";
+    case "nonce":
+      return isWholeNumber(value) ? null : "Nonce must be a whole number.";
+    case "pay_taddr":
+      return isValidTransparentAddress(value) ? null : `Invalid transparent address: "${value}".`;
+  }
 }
-function mk(level, action, canonical, message) {
-  return { valid: level === "valid", action, canonicalAction: canonical, message, level };
+function buildValidationResult(level, action, message) {
+  return { valid: level === "valid", action, message, level };
 }
 var ZNS = class {
   /**
@@ -115,8 +94,20 @@ var ZNS = class {
   constructor(options) {
     this.rpcId = 0;
     this._verified = false;
+    /** Validate a Zcash Unified Address format.
+     *  Accepts both mainnet ('u') and testnet ('utest') prefixes.
+     *  Performs basic format validation but NOT full bech32m checksum verification.
+     *  Returns true if the address looks like a unified address, false otherwise.
+     * 
+     *  @todo(F4Jumble) Upgrade to full ZIP-316 decoding with F4Jumble to:
+     *    - Parse actual typecodes from address items
+     *    - Validate F4Jumble checksum (not just bech32m)
+     *    - Optionally enforce: address must contain at least one Orchard receiver (typecode 0x03)
+     *    Requires @noble/hashes (blake2b) implementation of F4Jumble inverse. */
+    this.isValidUnifiedAddress = isValidUnifiedAddress;
+    this.isValidTransparentAddress = isValidTransparentAddress;
     this.network = options?.network ?? "testnet";
-    this.url = options?.url ?? DEFAULT_URL;
+    this.url = options?.url ?? NETWORKS[this.network].url;
   }
   /**
    * Verifies that the connected server is a known ZNS instance.
@@ -124,7 +115,7 @@ var ZNS = class {
    */
   async verify() {
     const status = await this.status();
-    if (!KNOWN_UIVKS.includes(status.uivk)) {
+    if (status.uivk !== NETWORKS[this.network].uivk) {
       throw new Error(
         `UIVK mismatch: indexer returned "${status.uivk.slice(0, 20)}..." which is not a known ZNS instance`
       );
@@ -137,21 +128,17 @@ var ZNS = class {
   }
   /** Get the registry address for the current network. */
   get registryAddress() {
-    const addr = REGISTRY_ADDRESSES[this.network];
-    if (!addr) {
-      throw new Error(`Unknown network: ${this.network}`);
-    }
-    return addr;
+    return NETWORKS[this.network].registryAddress;
   }
   /** Fetch current server status including pricing and configuration. */
   async status() {
     const raw = await this.rpc("status");
-    return toStatus(raw);
+    return normalizeApiResponse(raw);
   }
   /** Resolve a ZNS name to its registration. Returns null if not registered. */
   async resolveName(name) {
     const raw = await this.rpc("resolve", { query: name });
-    return raw ? toRegistration(raw) : null;
+    return raw ? normalizeApiResponse(raw) : null;
   }
   /** Resolve a Zcash Unified Address to all names pointing to it. Returns empty array if none.
    *  Supports pagination with limit (default 50, max 500) and offset (default 0). */
@@ -161,7 +148,7 @@ var ZNS = class {
       limit,
       offset
     });
-    return raw.map(toRegistration);
+    return raw.map((r) => normalizeApiResponse(r));
   }
   /** List all registered names. Useful for explorers or browsers.
    *  Supports pagination with limit (default 50, max 500) and offset (default 0). */
@@ -171,62 +158,31 @@ var ZNS = class {
       limit,
       offset
     });
-    return raw.map(toRegistration);
+    return raw.map((r) => normalizeApiResponse(r));
   }
   /** Check if a name is available for registration.
    *  Returns false immediately for invalid names without hitting the server. */
   async isAvailable(name) {
-    if (!this.isValidName(name)) return false;
+    if (!isValidName(name)) return false;
     const result = await this.resolveName(name);
     return result === null;
   }
-  /** Validate a Zcash Unified Address format.
-   *  Accepts both mainnet ('u') and testnet ('utest') prefixes.
-   *  Performs basic format validation but NOT full bech32m checksum verification.
-   *  Returns true if the address looks like a unified address, false otherwise. */
-  isValidUnifiedAddress(address) {
-    if (!address) return false;
-    if (address.startsWith("utest1")) return true;
-    if (address.startsWith("u1")) return true;
-    try {
-      const decoded = bech32m.decode(address);
-      return decoded.prefix === "u" || decoded.prefix === "utest";
-    } catch {
-      return false;
-    }
-  }
   async listings(limit, offset) {
-    const result = await this.rpc("listings", {
+    const raw = await this.rpc("listings", {
       limit,
       offset
     });
     return {
-      listings: result.listings.map((l) => ({
-        name: l.name,
-        price: l.price,
-        payTaddr: l.pay_taddr,
-        nonce: l.nonce,
-        txid: l.txid,
-        height: l.height,
-        signature: l.signature,
-        pubkey: l.pubkey,
-        pendingBuy: l.pending_buy ? {
-          buyer: l.pending_buy.buyer_ua,
-          price: l.pending_buy.price,
-          claimHeight: l.pending_buy.claim_height,
-          expiresAt: l.pending_buy.expires_at,
-          txid: l.pending_buy.txid
-        } : void 0
-      })),
-      total: result.total
+      listings: raw.listings.map((l) => normalizeApiResponse(l)),
+      total: raw.total
     };
   }
   async events(filter) {
     const raw = await this.rpc(
       "events",
-      toEventsFilter(filter ?? {})
+      normalizeApiResponse(filter ?? {})
     );
-    return toEventsResult(raw);
+    return normalizeApiResponse(raw);
   }
   /**
    * Verify a listing's signature.
@@ -252,10 +208,6 @@ var ZNS = class {
     if (!payload) return false;
     return this.verifyEd25519(payload, reg.signature, pubkey);
   }
-  /** Check if a name is valid format (lowercase alphanumeric, 1-62 chars). */
-  isValidName(name) {
-    return NAME_RE.test(name);
-  }
   /**
    * Validate a signing payload string against the ZNS memo format spec.
    *
@@ -282,7 +234,6 @@ var ZNS = class {
       return {
         valid: false,
         action: "",
-        canonicalAction: null,
         message: "Empty payload.",
         level: "invalid"
       };
@@ -292,83 +243,29 @@ var ZNS = class {
       return {
         valid: false,
         action: raw.toUpperCase(),
-        canonicalAction: null,
         message: "Missing colon separator. Expected format: ACTION:field1:field2:...",
         level: "invalid"
       };
     }
-    const actionUpper = raw.slice(0, colonIdx).toUpperCase();
-    const actionLower = raw.slice(0, colonIdx).toLowerCase();
+    const action = raw.slice(0, colonIdx).toUpperCase();
     const rest = raw.slice(colonIdx + 1);
     const parts = rest.split(":");
-    switch (actionLower) {
-      case "claim": {
-        if (parts.length !== 2)
-          return mk("invalid", actionUpper, "claim", `Expected CLAIM:<name>:<ua>.`);
-        if (!NAME_RE.test(parts[0]))
-          return mk("invalid", actionUpper, "claim", `Invalid name. Use lowercase a-z and 0-9, 1 to 62 chars.`);
-        if (!this.isValidUnifiedAddress(parts[1]))
-          return mk("invalid", actionUpper, "claim", `Invalid unified address: "${parts[1]}".`);
-        return mk("valid", actionUpper, "claim", "Valid CLAIM payload.");
-      }
-      case "buy": {
-        if (parts.length !== 2)
-          return mk("invalid", actionUpper, "buy", `Expected BUY:<name>:<buyer_ua>.`);
-        if (!NAME_RE.test(parts[0]))
-          return mk("invalid", actionUpper, "buy", `Invalid name. Use lowercase a-z and 0-9, 1 to 62 chars.`);
-        if (!this.isValidUnifiedAddress(parts[1]))
-          return mk("invalid", actionUpper, "buy", `Invalid unified address: "${parts[1]}".`);
-        return mk("valid", actionUpper, "buy", "Valid BUY payload.");
-      }
-      case "update": {
-        if (parts.length !== 3)
-          return mk("invalid", actionUpper, "update", `Expected UPDATE:<name>:<ua>:<nonce>.`);
-        if (!NAME_RE.test(parts[0]))
-          return mk("invalid", actionUpper, "update", `Invalid name. Use lowercase a-z and 0-9, 1 to 62 chars.`);
-        if (!this.isValidUnifiedAddress(parts[1]))
-          return mk("invalid", actionUpper, "update", `Invalid unified address: "${parts[1]}".`);
-        if (!isWholeNumber(parts[2]))
-          return mk("invalid", actionUpper, "update", `Nonce must be a whole number.`);
-        return mk("valid", actionUpper, "update", "Valid UPDATE payload.");
-      }
-      case "list": {
-        if (parts.length !== 4)
-          return mk("invalid", actionUpper, "list", `Expected LIST:<name>:<price_zats>:<pay_taddr>:<nonce>.`);
-        if (!NAME_RE.test(parts[0]))
-          return mk("invalid", actionUpper, "list", `Invalid name. Use lowercase a-z and 0-9, 1 to 62 chars.`);
-        if (!isWholeNumber(parts[1]) || Number(parts[1]) <= 0)
-          return mk("invalid", actionUpper, "list", `Price must be a positive whole number in zats.`);
-        if (!isWholeNumber(parts[3]))
-          return mk("invalid", actionUpper, "list", `Nonce must be a whole number.`);
-        return mk("valid", actionUpper, "list", "Valid LIST payload.");
-      }
-      case "delist": {
-        if (parts.length !== 2)
-          return mk("invalid", actionUpper, "delist", `Expected DELIST:<name>:<nonce>.`);
-        if (!NAME_RE.test(parts[0]))
-          return mk("invalid", actionUpper, "delist", `Invalid name. Use lowercase a-z and 0-9, 1 to 62 chars.`);
-        if (!isWholeNumber(parts[1]))
-          return mk("invalid", actionUpper, "delist", `Nonce must be a whole number.`);
-        return mk("valid", actionUpper, "delist", "Valid DELIST payload.");
-      }
-      case "release": {
-        if (parts.length !== 2)
-          return mk("invalid", actionUpper, "release", `Expected RELEASE:<name>:<nonce>.`);
-        if (!NAME_RE.test(parts[0]))
-          return mk("invalid", actionUpper, "release", `Invalid name. Use lowercase a-z and 0-9, 1 to 62 chars.`);
-        if (!isWholeNumber(parts[1]))
-          return mk("invalid", actionUpper, "release", `Nonce must be a whole number.`);
-        return mk("valid", actionUpper, "release", "Valid RELEASE payload.");
-      }
-      default:
-        return {
-          valid: false,
-          action: actionUpper,
-          canonicalAction: null,
-          message: `Unrecognized action "${actionUpper}". Valid actions: ${ZNS_ACTIONS.join(", ")}.`,
-          level: "unrecognized"
-        };
+    if (!ZNS_ACTIONS.includes(action)) {
+      return {
+        valid: false,
+        action,
+        message: `Unrecognized action "${action}". Valid actions: ${ZNS_ACTIONS.join(", ")}.`,
+        level: "unrecognized"
+      };
+    }
+    const rule = PAYLOAD_RULES[action];
+    if (parts.length !== rule.checks.length)
+      return buildValidationResult("invalid", action, `Expected ${rule.format}.`);
+    for (let i = 0; i < rule.checks.length; i++) {
+      const err = validateField(parts[i], rule.checks[i]);
+      if (err) return buildValidationResult("invalid", action, err);
     }
+    return buildValidationResult("valid", action, `Valid ${action} payload.`);
   }
   /**
    * Get the claim cost in zatoshis for a name of given length.
@@ -411,7 +308,7 @@ var ZNS = class {
    */
   prepareClaim(name, address, cost) {
     this.requireValidName(name);
-    if (!this.isValidUnifiedAddress(address)) {
+    if (!isValidUnifiedAddress(address)) {
       throw new Error(`Invalid Zcash Unified Address: ${address}`);
     }
     return {
@@ -454,7 +351,7 @@ var ZNS = class {
   }
   prepareUpdate(name, newAddress, nonce) {
     this.requireValidName(name);
-    if (!this.isValidUnifiedAddress(newAddress)) {
+    if (!isValidUnifiedAddress(newAddress)) {
       throw new Error(`Invalid Zcash Unified Address: ${newAddress}`);
     }
     return {
@@ -536,7 +433,7 @@ var ZNS = class {
     }
   }
   requireValidName(name) {
-    if (!NAME_RE.test(name)) throw new Error(`Invalid ZNS name: ${name}`);
+    if (!isValidName(name)) throw new Error(`Invalid ZNS name: ${name}`);
   }
   /** Build a ZIP-321 URI. Amount is in zatoshis and will be converted to ZEC for the URI. */
   buildZcashUri(address, amountZats, memo) {
@@ -601,8 +498,6 @@ export {
   BUY_COMMISSION,
   DEFAULT_URL,
   LIST_COMMISSION,
-  MAINNET_UIVK,
-  TESTNET_UIVK,
-  ZNS,
-  ZNS_ACTIONS
+  NETWORKS,
+  ZNS
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zcashname-sdk",
-  "version": "0.8.4",
+  "version": "0.8.5",
   "type": "module",
   "description": "TypeScript SDK for the Zcash Name System (ZNS).",
   "main": "dist/zns.cjs",