zcashname-sdk 0.8.5 → 0.8.7

package/dist/zns.cjs

@@ -31,7 +31,6 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var zns_exports = {};
 __export(zns_exports, {
   BUY_COMMISSION: () => BUY_COMMISSION,
-  DEFAULT_URL: () => DEFAULT_URL,
   LIST_COMMISSION: () => LIST_COMMISSION,
   NETWORKS: () => NETWORKS,
   ZNS: () => ZNS
@@ -44,19 +43,18 @@ var import_bech32 = require("bech32");
 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;
 var NETWORKS = {
   testnet: {
     url: "https://light.zcash.me/zns-testnet",
     registryAddress: "utest1f32kn6c4zvn54xr8wfsnxmj9hzpu2mwgtxzpzwcw34906tdccdvzs0z2dx38lly7tpan77x6udt8pjczqm22ymsdhlz9j0tk5yq664nl",
-    uivk: "utest1hzw7wyadutvzfgpna80yftsk5l7jeyu2p5me5quvp28tytxueta00cx4068wnlzcv7tx9n3t3gfhsy83pe4y6jrhxtzaq0hj6xtg5zrk2dn7zen3vns2a5pgs4fxdjlletmqrhfa42"
+    uivk: "uivktest1hzw7wyadutvzfgpna80yftsk5l7jeyu2p5me5quvp28tytxueta00cx4068wnlzcv7tx9n3t3gfhsy83pe4y6jrhxtzaq0hj6xtg5zrk2dn7zen3vns2a5pgs4fxdjlletmqrhfa42"
   },
   mainnet: {
-    url: "https://light.zcash.me/zns",
+    url: "https://light.zcash.me/zns-mainnet",
     registryAddress: "u1k0evt0ahj5qdt6y9ftsxndl8lrkm4ff6rp00u04cjpmqj6hxl9t8hfsxftmn3ht34e03lljh89czn2h8qn67rwrs8x0hm3lsxsucp9q9",
-    uivk: "u1k0evt0ahj5qdt6y9ftsxndl8lrkm4ff6rp00u04cjpmqj6hxl9t8hfsxftmn3ht34e03lljh89czn2h8qn67rwrs8x0hm3lsxsucp9q9"
+    uivk: "uivk1gl26qy0xjja7lqhyg3pf0x4j4j66kqwewrjkdcg28eqq4wgtzjmujpee7x9cs2ec9xhnlgrm8ptlw8z80j2aryw8nqtssser2ys778a0s00uvgkdjnfr58sndhfvc3f4zqjs6ywva6"
   }
 };
 var NAME_RE = /^[a-z0-9]{1,62}$/;
@@ -64,7 +62,8 @@ function isValidName(name) {
   return NAME_RE.test(name);
 }
 function normalizeApiResponse(obj) {
-  if (Array.isArray(obj)) return obj.map((item) => normalizeApiResponse(item));
+  if (Array.isArray(obj))
+    return obj.map((item) => normalizeApiResponse(item));
   if (obj && typeof obj === "object") {
     return Object.fromEntries(
       Object.entries(obj).map(([k, v]) => [
@@ -93,15 +92,21 @@ 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;
+  if (address.length < 26 || address.length > 36) return false;
   const base58Regex = /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]+$/;
   return base58Regex.test(address);
 }
 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"] },
+  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"] }
 };
@@ -136,12 +141,13 @@ var ZNS = class {
      *  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.isValidName = isValidName;
     this.isValidUnifiedAddress = isValidUnifiedAddress;
     this.isValidTransparentAddress = isValidTransparentAddress;
     this.network = options?.network ?? "testnet";
@@ -175,7 +181,9 @@ var ZNS = class {
   }
   /** Resolve a ZNS name to its registration. Returns null if not registered. */
   async resolveName(name) {
-    const raw = await this.rpc("resolve", { query: name });
+    const raw = await this.rpc("resolve", {
+      query: name
+    });
     return raw ? normalizeApiResponse(raw) : null;
   }
   /** Resolve a Zcash Unified Address to all names pointing to it. Returns empty array if none.
@@ -246,6 +254,26 @@ var ZNS = class {
     if (!payload) return false;
     return this.verifyEd25519(payload, reg.signature, pubkey);
   }
+  /**
+   * Verify a sovereign Ed25519 signature before sending a transaction.
+   * Call this after signing but before calling `complete()` to catch invalid signatures early.
+   *
+   * @param payload The signing payload string (e.g. `CLAIM:foo:u1abc`)
+   * @param signature The Ed25519 signature (base64)
+   * @param pubkey The Ed25519 public key (base64)
+   * @returns true if the signature is valid for the given payload and pubkey
+   *
+   * @example
+   * ```ts
+   * const claim = zns.prepareClaim(name, address, cost);
+   * const isValid = await zns.verifySoverignSignature(claim.payload, signature, userPubkey);
+   * if (!isValid) throw new Error("Invalid signature");
+   * const { memo, uri } = claim.complete(signature, userPubkey);
+   * ```
+   */
+  async verifySoverignSignature(payload, signature, pubkey) {
+    return this.verifyEd25519(payload, signature, pubkey);
+  }
   /**
    * Validate a signing payload string against the ZNS memo format spec.
    *
@@ -298,7 +326,11 @@ var ZNS = class {
     }
     const rule = PAYLOAD_RULES[action];
     if (parts.length !== rule.checks.length)
-      return buildValidationResult("invalid", action, `Expected ${rule.format}.`);
+      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);
@@ -371,7 +403,10 @@ var ZNS = class {
       payload: `LIST:${name}:${price}:${payTaddr}:${nonce}`,
       complete: (signature, userPubkey) => {
         const memo = userPubkey ? `ZNS:LIST:${name}:${price}:${payTaddr}:${nonce}:${signature}:${userPubkey}` : `ZNS:LIST:${name}:${price}:${payTaddr}:${nonce}:${signature}`;
-        return { memo, uri: this.buildZcashUri(this.registryAddress, LIST_COMMISSION, memo) };
+        return {
+          memo,
+          uri: this.buildZcashUri(this.registryAddress, LIST_COMMISSION, memo)
+        };
       }
     };
   }
@@ -383,7 +418,10 @@ var ZNS = class {
       payload: `DELIST:${name}:${nonce}`,
       complete: (signature, userPubkey) => {
         const memo = userPubkey ? `ZNS:DELIST:${name}:${nonce}:${signature}:${userPubkey}` : `ZNS:DELIST:${name}:${nonce}:${signature}`;
-        return { memo, uri: this.buildZcashUri(this.registryAddress, void 0, memo) };
+        return {
+          memo,
+          uri: this.buildZcashUri(this.registryAddress, void 0, memo)
+        };
       }
     };
   }
@@ -399,7 +437,10 @@ var ZNS = class {
       payload: `UPDATE:${name}:${newAddress}:${nonce}`,
       complete: (signature, userPubkey) => {
         const memo = userPubkey ? `ZNS:UPDATE:${name}:${newAddress}:${nonce}:${signature}:${userPubkey}` : `ZNS:UPDATE:${name}:${newAddress}:${nonce}:${signature}`;
-        return { memo, uri: this.buildZcashUri(this.registryAddress, void 0, memo) };
+        return {
+          memo,
+          uri: this.buildZcashUri(this.registryAddress, void 0, memo)
+        };
       }
     };
   }
@@ -415,7 +456,10 @@ var ZNS = class {
       payload: `BUY:${name}:${buyerAddress}`,
       complete: (signature, userPubkey) => {
         const memo = userPubkey ? `ZNS:BUY:${name}:${buyerAddress}:${price}:${signature}:${userPubkey}` : `ZNS:BUY:${name}:${buyerAddress}:${price}:${signature}`;
-        return { memo, uri: this.buildZcashUri(this.registryAddress, BUY_COMMISSION, memo) };
+        return {
+          memo,
+          uri: this.buildZcashUri(this.registryAddress, BUY_COMMISSION, memo)
+        };
       }
     };
   }
@@ -427,7 +471,10 @@ var ZNS = class {
       payload: `RELEASE:${name}:${nonce}`,
       complete: (signature, userPubkey) => {
         const memo = userPubkey ? `ZNS:RELEASE:${name}:${nonce}:${signature}:${userPubkey}` : `ZNS:RELEASE:${name}:${nonce}:${signature}`;
-        return { memo, uri: this.buildZcashUri(this.registryAddress, void 0, memo) };
+        return {
+          memo,
+          uri: this.buildZcashUri(this.registryAddress, void 0, memo)
+        };
       }
     };
   }
@@ -438,7 +485,10 @@ var ZNS = class {
       payload: `SETPRICE:${prices.length}:${prices.join(":")}:${nonce}`,
       complete: (signature) => {
         const memo = `ZNS:SETPRICE:${prices.length}:${prices.join(":")}:${nonce}:${signature}`;
-        return { memo, uri: this.buildZcashUri(this.registryAddress, void 0, memo) };
+        return {
+          memo,
+          uri: this.buildZcashUri(this.registryAddress, void 0, memo)
+        };
       }
     };
   }
@@ -535,7 +585,6 @@ var ZNS = class {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   BUY_COMMISSION,
-  DEFAULT_URL,
   LIST_COMMISSION,
   NETWORKS,
   ZNS

package/dist/zns.d.cts

@@ -161,7 +161,6 @@ interface PayloadValidationResult {
     readonly level: PayloadValidationLevel;
 }
 
-declare const DEFAULT_URL = "https://light.zcash.me/zns-testnet";
 /** 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).
@@ -172,14 +171,16 @@ declare const NETWORKS: {
     readonly testnet: {
         readonly url: "https://light.zcash.me/zns-testnet";
         readonly registryAddress: "utest1f32kn6c4zvn54xr8wfsnxmj9hzpu2mwgtxzpzwcw34906tdccdvzs0z2dx38lly7tpan77x6udt8pjczqm22ymsdhlz9j0tk5yq664nl";
-        readonly uivk: "utest1hzw7wyadutvzfgpna80yftsk5l7jeyu2p5me5quvp28tytxueta00cx4068wnlzcv7tx9n3t3gfhsy83pe4y6jrhxtzaq0hj6xtg5zrk2dn7zen3vns2a5pgs4fxdjlletmqrhfa42";
+        readonly uivk: "uivktest1hzw7wyadutvzfgpna80yftsk5l7jeyu2p5me5quvp28tytxueta00cx4068wnlzcv7tx9n3t3gfhsy83pe4y6jrhxtzaq0hj6xtg5zrk2dn7zen3vns2a5pgs4fxdjlletmqrhfa42";
     };
     readonly mainnet: {
-        readonly url: "https://light.zcash.me/zns";
+        readonly url: "https://light.zcash.me/zns-mainnet";
         readonly registryAddress: "u1k0evt0ahj5qdt6y9ftsxndl8lrkm4ff6rp00u04cjpmqj6hxl9t8hfsxftmn3ht34e03lljh89czn2h8qn67rwrs8x0hm3lsxsucp9q9";
-        readonly uivk: "u1k0evt0ahj5qdt6y9ftsxndl8lrkm4ff6rp00u04cjpmqj6hxl9t8hfsxftmn3ht34e03lljh89czn2h8qn67rwrs8x0hm3lsxsucp9q9";
+        readonly uivk: "uivk1gl26qy0xjja7lqhyg3pf0x4j4j66kqwewrjkdcg28eqq4wgtzjmujpee7x9cs2ec9xhnlgrm8ptlw8z80j2aryw8nqtssser2ys778a0s00uvgkdjnfr58sndhfvc3f4zqjs6ywva6";
     };
 };
+/** Validates a ZNS name format (lowercase alphanumeric, 1-62 chars). */
+declare function isValidName(name: string): boolean;
 /** Validates a Zcash unified (u-) address. */
 declare function isValidUnifiedAddress(address: string): boolean;
 /** Validates a Zcash transparent (t-) address. */
@@ -231,6 +232,7 @@ declare class ZNS {
      *    - 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. */
+    isValidName: typeof isValidName;
     isValidUnifiedAddress: typeof isValidUnifiedAddress;
     isValidTransparentAddress: typeof isValidTransparentAddress;
     listings(limit?: number, offset?: number): Promise<{
@@ -252,6 +254,24 @@ declare class ZNS {
      * @returns true if the signature is valid
      */
     verifyRegistration(reg: Registration, adminPubkey: string): Promise<boolean>;
+    /**
+     * Verify a sovereign Ed25519 signature before sending a transaction.
+     * Call this after signing but before calling `complete()` to catch invalid signatures early.
+     *
+     * @param payload The signing payload string (e.g. `CLAIM:foo:u1abc`)
+     * @param signature The Ed25519 signature (base64)
+     * @param pubkey The Ed25519 public key (base64)
+     * @returns true if the signature is valid for the given payload and pubkey
+     *
+     * @example
+     * ```ts
+     * const claim = zns.prepareClaim(name, address, cost);
+     * const isValid = await zns.verifySoverignSignature(claim.payload, signature, userPubkey);
+     * if (!isValid) throw new Error("Invalid signature");
+     * const { memo, uri } = claim.complete(signature, userPubkey);
+     * ```
+     */
+    verifySoverignSignature(payload: string, signature: string, pubkey: string): Promise<boolean>;
     /**
      * Validate a signing payload string against the ZNS memo format spec.
      *
@@ -318,4 +338,4 @@ declare class ZNS {
     private rpc;
 }
 
-export { BUY_COMMISSION, DEFAULT_URL, LIST_COMMISSION, NETWORKS, ZNS };
+export { BUY_COMMISSION, LIST_COMMISSION, NETWORKS, ZNS };

package/dist/zns.d.ts

@@ -161,7 +161,6 @@ interface PayloadValidationResult {
     readonly level: PayloadValidationLevel;
 }
 
-declare const DEFAULT_URL = "https://light.zcash.me/zns-testnet";
 /** 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).
@@ -172,14 +171,16 @@ declare const NETWORKS: {
     readonly testnet: {
         readonly url: "https://light.zcash.me/zns-testnet";
         readonly registryAddress: "utest1f32kn6c4zvn54xr8wfsnxmj9hzpu2mwgtxzpzwcw34906tdccdvzs0z2dx38lly7tpan77x6udt8pjczqm22ymsdhlz9j0tk5yq664nl";
-        readonly uivk: "utest1hzw7wyadutvzfgpna80yftsk5l7jeyu2p5me5quvp28tytxueta00cx4068wnlzcv7tx9n3t3gfhsy83pe4y6jrhxtzaq0hj6xtg5zrk2dn7zen3vns2a5pgs4fxdjlletmqrhfa42";
+        readonly uivk: "uivktest1hzw7wyadutvzfgpna80yftsk5l7jeyu2p5me5quvp28tytxueta00cx4068wnlzcv7tx9n3t3gfhsy83pe4y6jrhxtzaq0hj6xtg5zrk2dn7zen3vns2a5pgs4fxdjlletmqrhfa42";
     };
     readonly mainnet: {
-        readonly url: "https://light.zcash.me/zns";
+        readonly url: "https://light.zcash.me/zns-mainnet";
         readonly registryAddress: "u1k0evt0ahj5qdt6y9ftsxndl8lrkm4ff6rp00u04cjpmqj6hxl9t8hfsxftmn3ht34e03lljh89czn2h8qn67rwrs8x0hm3lsxsucp9q9";
-        readonly uivk: "u1k0evt0ahj5qdt6y9ftsxndl8lrkm4ff6rp00u04cjpmqj6hxl9t8hfsxftmn3ht34e03lljh89czn2h8qn67rwrs8x0hm3lsxsucp9q9";
+        readonly uivk: "uivk1gl26qy0xjja7lqhyg3pf0x4j4j66kqwewrjkdcg28eqq4wgtzjmujpee7x9cs2ec9xhnlgrm8ptlw8z80j2aryw8nqtssser2ys778a0s00uvgkdjnfr58sndhfvc3f4zqjs6ywva6";
     };
 };
+/** Validates a ZNS name format (lowercase alphanumeric, 1-62 chars). */
+declare function isValidName(name: string): boolean;
 /** Validates a Zcash unified (u-) address. */
 declare function isValidUnifiedAddress(address: string): boolean;
 /** Validates a Zcash transparent (t-) address. */
@@ -231,6 +232,7 @@ declare class ZNS {
      *    - 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. */
+    isValidName: typeof isValidName;
     isValidUnifiedAddress: typeof isValidUnifiedAddress;
     isValidTransparentAddress: typeof isValidTransparentAddress;
     listings(limit?: number, offset?: number): Promise<{
@@ -252,6 +254,24 @@ declare class ZNS {
      * @returns true if the signature is valid
      */
     verifyRegistration(reg: Registration, adminPubkey: string): Promise<boolean>;
+    /**
+     * Verify a sovereign Ed25519 signature before sending a transaction.
+     * Call this after signing but before calling `complete()` to catch invalid signatures early.
+     *
+     * @param payload The signing payload string (e.g. `CLAIM:foo:u1abc`)
+     * @param signature The Ed25519 signature (base64)
+     * @param pubkey The Ed25519 public key (base64)
+     * @returns true if the signature is valid for the given payload and pubkey
+     *
+     * @example
+     * ```ts
+     * const claim = zns.prepareClaim(name, address, cost);
+     * const isValid = await zns.verifySoverignSignature(claim.payload, signature, userPubkey);
+     * if (!isValid) throw new Error("Invalid signature");
+     * const { memo, uri } = claim.complete(signature, userPubkey);
+     * ```
+     */
+    verifySoverignSignature(payload: string, signature: string, pubkey: string): Promise<boolean>;
     /**
      * Validate a signing payload string against the ZNS memo format spec.
      *
@@ -318,4 +338,4 @@ declare class ZNS {
     private rpc;
 }
 
-export { BUY_COMMISSION, DEFAULT_URL, LIST_COMMISSION, NETWORKS, ZNS };
+export { BUY_COMMISSION, LIST_COMMISSION, NETWORKS, ZNS };

package/dist/zns.js

@@ -6,19 +6,18 @@ import { bech32m } from "bech32";
 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;
 var NETWORKS = {
   testnet: {
     url: "https://light.zcash.me/zns-testnet",
     registryAddress: "utest1f32kn6c4zvn54xr8wfsnxmj9hzpu2mwgtxzpzwcw34906tdccdvzs0z2dx38lly7tpan77x6udt8pjczqm22ymsdhlz9j0tk5yq664nl",
-    uivk: "utest1hzw7wyadutvzfgpna80yftsk5l7jeyu2p5me5quvp28tytxueta00cx4068wnlzcv7tx9n3t3gfhsy83pe4y6jrhxtzaq0hj6xtg5zrk2dn7zen3vns2a5pgs4fxdjlletmqrhfa42"
+    uivk: "uivktest1hzw7wyadutvzfgpna80yftsk5l7jeyu2p5me5quvp28tytxueta00cx4068wnlzcv7tx9n3t3gfhsy83pe4y6jrhxtzaq0hj6xtg5zrk2dn7zen3vns2a5pgs4fxdjlletmqrhfa42"
   },
   mainnet: {
-    url: "https://light.zcash.me/zns",
+    url: "https://light.zcash.me/zns-mainnet",
     registryAddress: "u1k0evt0ahj5qdt6y9ftsxndl8lrkm4ff6rp00u04cjpmqj6hxl9t8hfsxftmn3ht34e03lljh89czn2h8qn67rwrs8x0hm3lsxsucp9q9",
-    uivk: "u1k0evt0ahj5qdt6y9ftsxndl8lrkm4ff6rp00u04cjpmqj6hxl9t8hfsxftmn3ht34e03lljh89czn2h8qn67rwrs8x0hm3lsxsucp9q9"
+    uivk: "uivk1gl26qy0xjja7lqhyg3pf0x4j4j66kqwewrjkdcg28eqq4wgtzjmujpee7x9cs2ec9xhnlgrm8ptlw8z80j2aryw8nqtssser2ys778a0s00uvgkdjnfr58sndhfvc3f4zqjs6ywva6"
   }
 };
 var NAME_RE = /^[a-z0-9]{1,62}$/;
@@ -26,7 +25,8 @@ function isValidName(name) {
   return NAME_RE.test(name);
 }
 function normalizeApiResponse(obj) {
-  if (Array.isArray(obj)) return obj.map((item) => normalizeApiResponse(item));
+  if (Array.isArray(obj))
+    return obj.map((item) => normalizeApiResponse(item));
   if (obj && typeof obj === "object") {
     return Object.fromEntries(
       Object.entries(obj).map(([k, v]) => [
@@ -55,15 +55,21 @@ 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;
+  if (address.length < 26 || address.length > 36) return false;
   const base58Regex = /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]+$/;
   return base58Regex.test(address);
 }
 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"] },
+  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"] }
 };
@@ -98,12 +104,13 @@ var ZNS = class {
      *  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.isValidName = isValidName;
     this.isValidUnifiedAddress = isValidUnifiedAddress;
     this.isValidTransparentAddress = isValidTransparentAddress;
     this.network = options?.network ?? "testnet";
@@ -137,7 +144,9 @@ var ZNS = class {
   }
   /** Resolve a ZNS name to its registration. Returns null if not registered. */
   async resolveName(name) {
-    const raw = await this.rpc("resolve", { query: name });
+    const raw = await this.rpc("resolve", {
+      query: name
+    });
     return raw ? normalizeApiResponse(raw) : null;
   }
   /** Resolve a Zcash Unified Address to all names pointing to it. Returns empty array if none.
@@ -208,6 +217,26 @@ var ZNS = class {
     if (!payload) return false;
     return this.verifyEd25519(payload, reg.signature, pubkey);
   }
+  /**
+   * Verify a sovereign Ed25519 signature before sending a transaction.
+   * Call this after signing but before calling `complete()` to catch invalid signatures early.
+   *
+   * @param payload The signing payload string (e.g. `CLAIM:foo:u1abc`)
+   * @param signature The Ed25519 signature (base64)
+   * @param pubkey The Ed25519 public key (base64)
+   * @returns true if the signature is valid for the given payload and pubkey
+   *
+   * @example
+   * ```ts
+   * const claim = zns.prepareClaim(name, address, cost);
+   * const isValid = await zns.verifySoverignSignature(claim.payload, signature, userPubkey);
+   * if (!isValid) throw new Error("Invalid signature");
+   * const { memo, uri } = claim.complete(signature, userPubkey);
+   * ```
+   */
+  async verifySoverignSignature(payload, signature, pubkey) {
+    return this.verifyEd25519(payload, signature, pubkey);
+  }
   /**
    * Validate a signing payload string against the ZNS memo format spec.
    *
@@ -260,7 +289,11 @@ var ZNS = class {
     }
     const rule = PAYLOAD_RULES[action];
     if (parts.length !== rule.checks.length)
-      return buildValidationResult("invalid", action, `Expected ${rule.format}.`);
+      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);
@@ -333,7 +366,10 @@ var ZNS = class {
       payload: `LIST:${name}:${price}:${payTaddr}:${nonce}`,
       complete: (signature, userPubkey) => {
         const memo = userPubkey ? `ZNS:LIST:${name}:${price}:${payTaddr}:${nonce}:${signature}:${userPubkey}` : `ZNS:LIST:${name}:${price}:${payTaddr}:${nonce}:${signature}`;
-        return { memo, uri: this.buildZcashUri(this.registryAddress, LIST_COMMISSION, memo) };
+        return {
+          memo,
+          uri: this.buildZcashUri(this.registryAddress, LIST_COMMISSION, memo)
+        };
       }
     };
   }
@@ -345,7 +381,10 @@ var ZNS = class {
       payload: `DELIST:${name}:${nonce}`,
       complete: (signature, userPubkey) => {
         const memo = userPubkey ? `ZNS:DELIST:${name}:${nonce}:${signature}:${userPubkey}` : `ZNS:DELIST:${name}:${nonce}:${signature}`;
-        return { memo, uri: this.buildZcashUri(this.registryAddress, void 0, memo) };
+        return {
+          memo,
+          uri: this.buildZcashUri(this.registryAddress, void 0, memo)
+        };
       }
     };
   }
@@ -361,7 +400,10 @@ var ZNS = class {
       payload: `UPDATE:${name}:${newAddress}:${nonce}`,
       complete: (signature, userPubkey) => {
         const memo = userPubkey ? `ZNS:UPDATE:${name}:${newAddress}:${nonce}:${signature}:${userPubkey}` : `ZNS:UPDATE:${name}:${newAddress}:${nonce}:${signature}`;
-        return { memo, uri: this.buildZcashUri(this.registryAddress, void 0, memo) };
+        return {
+          memo,
+          uri: this.buildZcashUri(this.registryAddress, void 0, memo)
+        };
       }
     };
   }
@@ -377,7 +419,10 @@ var ZNS = class {
       payload: `BUY:${name}:${buyerAddress}`,
       complete: (signature, userPubkey) => {
         const memo = userPubkey ? `ZNS:BUY:${name}:${buyerAddress}:${price}:${signature}:${userPubkey}` : `ZNS:BUY:${name}:${buyerAddress}:${price}:${signature}`;
-        return { memo, uri: this.buildZcashUri(this.registryAddress, BUY_COMMISSION, memo) };
+        return {
+          memo,
+          uri: this.buildZcashUri(this.registryAddress, BUY_COMMISSION, memo)
+        };
       }
     };
   }
@@ -389,7 +434,10 @@ var ZNS = class {
       payload: `RELEASE:${name}:${nonce}`,
       complete: (signature, userPubkey) => {
         const memo = userPubkey ? `ZNS:RELEASE:${name}:${nonce}:${signature}:${userPubkey}` : `ZNS:RELEASE:${name}:${nonce}:${signature}`;
-        return { memo, uri: this.buildZcashUri(this.registryAddress, void 0, memo) };
+        return {
+          memo,
+          uri: this.buildZcashUri(this.registryAddress, void 0, memo)
+        };
       }
     };
   }
@@ -400,7 +448,10 @@ var ZNS = class {
       payload: `SETPRICE:${prices.length}:${prices.join(":")}:${nonce}`,
       complete: (signature) => {
         const memo = `ZNS:SETPRICE:${prices.length}:${prices.join(":")}:${nonce}:${signature}`;
-        return { memo, uri: this.buildZcashUri(this.registryAddress, void 0, memo) };
+        return {
+          memo,
+          uri: this.buildZcashUri(this.registryAddress, void 0, memo)
+        };
       }
     };
   }
@@ -496,7 +547,6 @@ var ZNS = class {
 };
 export {
   BUY_COMMISSION,
-  DEFAULT_URL,
   LIST_COMMISSION,
   NETWORKS,
   ZNS

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zcashname-sdk",
-  "version": "0.8.5",
+  "version": "0.8.7",
   "type": "module",
   "description": "TypeScript SDK for the Zcash Name System (ZNS).",
   "main": "dist/zns.cjs",
@@ -33,6 +33,7 @@
     "bech32": "^2.0.0"
   },
   "devDependencies": {
+    "@noble/hashes": "^2.2.0",
     "tsup": "^8.0.0",
     "typescript": "^5.4.0",
     "vitest": "^2.0.0"