zcashname-sdk 0.8.2 → 0.8.4

package/dist/zns.cjs

@@ -35,7 +35,8 @@ __export(zns_exports, {
   LIST_COMMISSION: () => LIST_COMMISSION,
   MAINNET_UIVK: () => MAINNET_UIVK,
   TESTNET_UIVK: () => TESTNET_UIVK,
-  ZNS: () => ZNS
+  ZNS: () => ZNS,
+  ZNS_ACTIONS: () => ZNS_ACTIONS
 });
 module.exports = __toCommonJS(zns_exports);
 var ed25519 = __toESM(require("@noble/ed25519"), 1);
@@ -44,16 +45,99 @@ var import_bech32 = require("bech32");
 // src/types.ts
 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
+  };
+}
+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 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 toEventsFilter(raw) {
+  return {
+    name: raw.name,
+    action: raw.action,
+    since_height: raw.sinceHeight,
+    limit: raw.limit,
+    offset: raw.offset
+  };
+}
+function toEventsResult(raw) {
+  return {
+    events: raw.events.map(toEvent),
+    total: raw.total
+  };
+}
 
 // src/zns.ts
 var DEFAULT_URL = "https://light.zcash.me/zns-testnet";
-var TESTNET_UIVK = "uivktest1hzw7wyadutvzfgpna80yftsk5l7jeyu2p5me5quvp28tytxueta00cx4068wnlzcv7tx9n3t3gfhsy83pe4y6jrhxtzaq0hj6xtg5zrk2dn7zen3vns2a5pgs4fxdjlletmqrhfa42";
-var MAINNET_UIVK = "uivk1gl26qy0xjja7lqhyg3pf0x4j4j66kqwewrjkdcg28eqq4wgtzjmujpee7x9cs2ec9xhnlgrm8ptlw8z80j2aryw8nqtssser2ys778a0s00uvgkdjnfr58sndhfvc3f4zqjs6ywva6";
+var TESTNET_UIVK = "utest1hzw7wyadutvzfgpna80yftsk5l7jeyu2p5me5quvp28tytxueta00cx4068wnlzcv7tx9n3t3gfhsy83pe4y6jrhxtzaq0hj6xtg5zrk2dn7zen3vns2a5pgs4fxdjlletmqrhfa42";
+var MAINNET_UIVK = "u1k0evt0ahj5qdt6y9ftsxndl8lrkm4ff6rp00u04cjpmqj6hxl9t8hfsxftmn3ht34e03lljh89czn2h8qn67rwrs8x0hm3lsxsucp9q9";
 var KNOWN_UIVKS = [TESTNET_UIVK, MAINNET_UIVK];
 var REGISTRY_ADDRESSES = {
   testnet: "utest1f32kn6c4zvn54xr8wfsnxmj9hzpu2mwgtxzpzwcw34906tdccdvzs0z2dx38lly7tpan77x6udt8pjczqm22ymsdhlz9j0tk5yq664nl",
   mainnet: "u1k0evt0ahj5qdt6y9ftsxndl8lrkm4ff6rp00u04cjpmqj6hxl9t8hfsxftmn3ht34e03lljh89czn2h8qn67rwrs8x0hm3lsxsucp9q9"
 };
+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";
@@ -79,7 +163,7 @@ var ZNS = class {
    * @throws Error if the server's UIVK is not recognized
    */
   async verify() {
-    const status = await this.rpc("status");
+    const status = await this.status();
     if (!KNOWN_UIVKS.includes(status.uivk)) {
       throw new Error(
         `UIVK mismatch: indexer returned "${status.uivk.slice(0, 20)}..." which is not a known ZNS instance`
@@ -101,29 +185,33 @@ var ZNS = class {
   }
   /** Fetch current server status including pricing and configuration. */
   async status() {
-    return this.rpc("status");
+    const raw = await this.rpc("status");
+    return toStatus(raw);
   }
   /** Resolve a ZNS name to its registration. Returns null if not registered. */
   async resolveName(name) {
-    return this.rpc("resolve", { query: name });
+    const raw = await this.rpc("resolve", { query: name });
+    return raw ? toRegistration(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). */
   async resolveAddress(address, limit, offset) {
-    return this.rpc("resolve", {
+    const raw = await this.rpc("resolve", {
       query: address,
       limit,
       offset
     });
+    return raw.map(toRegistration);
   }
   /** List all registered names. Useful for explorers or browsers.
    *  Supports pagination with limit (default 50, max 500) and offset (default 0). */
   async listAllRegistrations(limit, offset) {
-    return this.rpc("resolve", {
+    const raw = await this.rpc("resolve", {
       query: "",
       limit,
       offset
     });
+    return raw.map(toRegistration);
   }
   /** Check if a name is available for registration.
    *  Returns false immediately for invalid names without hitting the server. */
@@ -152,13 +240,33 @@ var ZNS = class {
       limit,
       offset
     });
-    return result;
+    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
+    };
   }
   async events(filter) {
-    return this.rpc(
+    const raw = await this.rpc(
       "events",
-      filter ?? {}
+      toEventsFilter(filter ?? {})
     );
+    return toEventsResult(raw);
   }
   /**
    * Verify a listing's signature.
@@ -168,7 +276,7 @@ var ZNS = class {
    */
   async verifyListing(listing, adminPubkey) {
     const pubkey = listing.pubkey ?? adminPubkey;
-    const payload = `LIST:${listing.name}:${listing.price}:${listing.pay_taddr}:${listing.nonce}`;
+    const payload = `LIST:${listing.name}:${listing.price}:${listing.payTaddr}:${listing.nonce}`;
     return this.verifyEd25519(payload, listing.signature, pubkey);
   }
   /**
@@ -292,29 +400,12 @@ var ZNS = class {
           return mk("invalid", actionUpper, "release", `Nonce must be a whole number.`);
         return mk("valid", actionUpper, "release", "Valid RELEASE payload.");
       }
-      case "setprice": {
-        if (parts.length < 3)
-          return mk("invalid", actionUpper, "setprice", `Expected SETPRICE:<count>:<tier1>:...:<nonce>.`);
-        const count = Number(parts[0]);
-        if (!isWholeNumber(parts[0]) || isNaN(count) || count <= 0)
-          return mk("invalid", actionUpper, "setprice", `Count must be a positive whole number.`);
-        const priceCount = parts.length - 2;
-        if (priceCount !== count)
-          return mk("invalid", actionUpper, "setprice", `SETPRICE count mismatch: header is ${count} but found ${priceCount} price tiers.`);
-        if (!isWholeNumber(parts[parts.length - 1]))
-          return mk("invalid", actionUpper, "setprice", `Nonce must be a whole number.`);
-        for (let i = 1; i < parts.length - 1; i++) {
-          if (!isWholeNumber(parts[i]) || Number(parts[i]) <= 0)
-            return mk("invalid", actionUpper, "setprice", `Tier ${i} must be a positive whole number in zats.`);
-        }
-        return mk("valid", actionUpper, "setprice", "Valid SETPRICE payload.");
-      }
       default:
         return {
           valid: false,
           action: actionUpper,
           canonicalAction: null,
-          message: `Unrecognized action "${actionUpper}". Valid actions: CLAIM, BUY, UPDATE, LIST, DELIST, RELEASE, SETPRICE.`,
+          message: `Unrecognized action "${actionUpper}". Valid actions: ${ZNS_ACTIONS.join(", ")}.`,
           level: "unrecognized"
         };
     }
@@ -375,16 +466,16 @@ var ZNS = class {
       }
     };
   }
-  prepareList(name, price, pay_taddr, nonce) {
+  prepareList(name, price, payTaddr, nonce) {
     this.requireValidName(name);
     return {
       name,
       price,
-      pay_taddr,
+      payTaddr,
       nonce,
-      payload: `LIST:${name}:${price}:${pay_taddr}:${nonce}`,
+      payload: `LIST:${name}:${price}:${payTaddr}:${nonce}`,
       complete: (signature, userPubkey) => {
-        const memo = userPubkey ? `ZNS:LIST:${name}:${price}:${pay_taddr}:${nonce}:${signature}:${userPubkey}` : `ZNS:LIST:${name}:${price}:${pay_taddr}:${nonce}:${signature}`;
+        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) };
       }
     };
@@ -458,7 +549,7 @@ var ZNS = class {
   }
   // ── Private helpers ────────────────────────────────────────────────────────
   registrationPayload(reg) {
-    switch (reg.last_action) {
+    switch (reg.lastAction) {
       case "CLAIM":
         return `CLAIM:${reg.name}:${reg.address}`;
       case "BUY":
@@ -553,5 +644,6 @@ var ZNS = class {
   LIST_COMMISSION,
   MAINNET_UIVK,
   TESTNET_UIVK,
-  ZNS
+  ZNS,
+  ZNS_ACTIONS
 });

package/dist/zns.d.cts

@@ -1,59 +1,67 @@
-/** Amount in zatoshis (1 ZEC = 100,000,000 zats).
- *  All monetary values in ZNS are denominated in zats.
- *  Note: JavaScript number precision degrades above 2^53 (~9e15 zats, or ~90M ZEC) */
+/**
+ * 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.
+ */
 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;
-interface Registration {
-    name: string;
-    address: string;
-    txid: string;
-    height: number;
-    nonce: number;
-    signature: string | null;
-    last_action: LastAction;
-    pubkey: string | null;
-    listing: Listing | null;
-}
 /** 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";
+/** Pending purchase for a listed name. */
+interface PendingBuy {
+    buyer: string;
+    price: Zats;
+    claimHeight: number;
+    expiresAt: number;
+    txid: string;
+}
+/** A name listing in the marketplace. */
 interface Listing {
     name: string;
     price: Zats;
-    pay_taddr: string;
+    payTaddr: string;
     nonce: number;
     txid: string;
     height: number;
     signature: string;
     pubkey: string | null;
-    pending_buy: PendingBuy | null;
+    pendingBuy: PendingBuy | undefined;
 }
-interface PendingBuy {
-    buyer_ua: string;
-    price: Zats;
-    claim_height: number;
-    expires_at: number;
+/** A registered ZNS name. */
+interface Registration {
+    name: string;
+    address: string;
     txid: string;
+    height: number;
+    nonce: number;
+    signature: string | null;
+    lastAction: LastAction;
+    pubkey: string | null;
+    listing: Listing | null;
 }
+/** Pricing tiers for name registration. */
 interface Pricing {
     nonce: number;
     height: number;
     tiers: Zats[];
 }
+/** Current indexer status including pricing configuration. */
 interface Status {
-    synced_height: number;
-    admin_pubkey: string;
+    syncedHeight: number;
+    adminPubkey: string;
     uivk: string;
     address: string;
     registered: number;
     listed: number;
     pricing: Pricing | null;
 }
+/** An event in the ZNS event log. */
 interface Event {
     id: number;
     name: string;
@@ -66,13 +74,15 @@ interface Event {
     signature: string | null;
     pubkey: string | null;
 }
+/** Filter options for querying events. */
 interface EventsFilter {
     name?: string;
     action?: EventAction;
-    since_height?: number;
+    sinceHeight?: number;
     limit?: number;
     offset?: number;
 }
+/** Paginated events result. */
 interface EventsResult {
     events: Event[];
     total: number;
@@ -103,7 +113,7 @@ interface PreparedClaim extends PreparedAction {
 interface PreparedList extends PreparedAction {
     readonly name: string;
     readonly price: Zats;
-    readonly pay_taddr: string;
+    readonly payTaddr: string;
     readonly nonce: number;
 }
 /** Prepared DELIST action */
@@ -151,8 +161,11 @@ interface PayloadValidationResult {
 }
 
 declare const DEFAULT_URL = "https://light.zcash.me/zns-testnet";
-declare const TESTNET_UIVK = "uivktest1hzw7wyadutvzfgpna80yftsk5l7jeyu2p5me5quvp28tytxueta00cx4068wnlzcv7tx9n3t3gfhsy83pe4y6jrhxtzaq0hj6xtg5zrk2dn7zen3vns2a5pgs4fxdjlletmqrhfa42";
-declare const MAINNET_UIVK = "uivk1gl26qy0xjja7lqhyg3pf0x4j4j66kqwewrjkdcg28eqq4wgtzjmujpee7x9cs2ec9xhnlgrm8ptlw8z80j2aryw8nqtssser2ys778a0s00uvgkdjnfr58sndhfvc3f4zqjs6ywva6";
+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";
 declare class ZNS {
     private url;
@@ -266,7 +279,7 @@ declare class ZNS {
      * @returns Prepared claim ready for signature completion
      */
     prepareClaim(name: string, address: string, cost: Zats): PreparedClaim;
-    prepareList(name: string, price: Zats, pay_taddr: string, nonce: number): PreparedList;
+    prepareList(name: string, price: Zats, payTaddr: string, nonce: number): PreparedList;
     prepareDelist(name: string, nonce: number): PreparedDelist;
     prepareUpdate(name: string, newAddress: string, nonce: number): PreparedUpdate;
     prepareBuy(name: string, buyerAddress: string, price: Zats): PreparedBuy;
@@ -283,4 +296,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, type Zats };
+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 };

package/dist/zns.d.ts

@@ -1,59 +1,67 @@
-/** Amount in zatoshis (1 ZEC = 100,000,000 zats).
- *  All monetary values in ZNS are denominated in zats.
- *  Note: JavaScript number precision degrades above 2^53 (~9e15 zats, or ~90M ZEC) */
+/**
+ * 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.
+ */
 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;
-interface Registration {
-    name: string;
-    address: string;
-    txid: string;
-    height: number;
-    nonce: number;
-    signature: string | null;
-    last_action: LastAction;
-    pubkey: string | null;
-    listing: Listing | null;
-}
 /** 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";
+/** Pending purchase for a listed name. */
+interface PendingBuy {
+    buyer: string;
+    price: Zats;
+    claimHeight: number;
+    expiresAt: number;
+    txid: string;
+}
+/** A name listing in the marketplace. */
 interface Listing {
     name: string;
     price: Zats;
-    pay_taddr: string;
+    payTaddr: string;
     nonce: number;
     txid: string;
     height: number;
     signature: string;
     pubkey: string | null;
-    pending_buy: PendingBuy | null;
+    pendingBuy: PendingBuy | undefined;
 }
-interface PendingBuy {
-    buyer_ua: string;
-    price: Zats;
-    claim_height: number;
-    expires_at: number;
+/** A registered ZNS name. */
+interface Registration {
+    name: string;
+    address: string;
     txid: string;
+    height: number;
+    nonce: number;
+    signature: string | null;
+    lastAction: LastAction;
+    pubkey: string | null;
+    listing: Listing | null;
 }
+/** Pricing tiers for name registration. */
 interface Pricing {
     nonce: number;
     height: number;
     tiers: Zats[];
 }
+/** Current indexer status including pricing configuration. */
 interface Status {
-    synced_height: number;
-    admin_pubkey: string;
+    syncedHeight: number;
+    adminPubkey: string;
     uivk: string;
     address: string;
     registered: number;
     listed: number;
     pricing: Pricing | null;
 }
+/** An event in the ZNS event log. */
 interface Event {
     id: number;
     name: string;
@@ -66,13 +74,15 @@ interface Event {
     signature: string | null;
     pubkey: string | null;
 }
+/** Filter options for querying events. */
 interface EventsFilter {
     name?: string;
     action?: EventAction;
-    since_height?: number;
+    sinceHeight?: number;
     limit?: number;
     offset?: number;
 }
+/** Paginated events result. */
 interface EventsResult {
     events: Event[];
     total: number;
@@ -103,7 +113,7 @@ interface PreparedClaim extends PreparedAction {
 interface PreparedList extends PreparedAction {
     readonly name: string;
     readonly price: Zats;
-    readonly pay_taddr: string;
+    readonly payTaddr: string;
     readonly nonce: number;
 }
 /** Prepared DELIST action */
@@ -151,8 +161,11 @@ interface PayloadValidationResult {
 }
 
 declare const DEFAULT_URL = "https://light.zcash.me/zns-testnet";
-declare const TESTNET_UIVK = "uivktest1hzw7wyadutvzfgpna80yftsk5l7jeyu2p5me5quvp28tytxueta00cx4068wnlzcv7tx9n3t3gfhsy83pe4y6jrhxtzaq0hj6xtg5zrk2dn7zen3vns2a5pgs4fxdjlletmqrhfa42";
-declare const MAINNET_UIVK = "uivk1gl26qy0xjja7lqhyg3pf0x4j4j66kqwewrjkdcg28eqq4wgtzjmujpee7x9cs2ec9xhnlgrm8ptlw8z80j2aryw8nqtssser2ys778a0s00uvgkdjnfr58sndhfvc3f4zqjs6ywva6";
+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";
 declare class ZNS {
     private url;
@@ -266,7 +279,7 @@ declare class ZNS {
      * @returns Prepared claim ready for signature completion
      */
     prepareClaim(name: string, address: string, cost: Zats): PreparedClaim;
-    prepareList(name: string, price: Zats, pay_taddr: string, nonce: number): PreparedList;
+    prepareList(name: string, price: Zats, payTaddr: string, nonce: number): PreparedList;
     prepareDelist(name: string, nonce: number): PreparedDelist;
     prepareUpdate(name: string, newAddress: string, nonce: number): PreparedUpdate;
     prepareBuy(name: string, buyerAddress: string, price: Zats): PreparedBuy;
@@ -283,4 +296,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, type Zats };
+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 };

package/dist/zns.js

@@ -5,16 +5,99 @@ import { bech32m } from "bech32";
 // src/types.ts
 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
+  };
+}
+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 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 toEventsFilter(raw) {
+  return {
+    name: raw.name,
+    action: raw.action,
+    since_height: raw.sinceHeight,
+    limit: raw.limit,
+    offset: raw.offset
+  };
+}
+function toEventsResult(raw) {
+  return {
+    events: raw.events.map(toEvent),
+    total: raw.total
+  };
+}
 
 // src/zns.ts
 var DEFAULT_URL = "https://light.zcash.me/zns-testnet";
-var TESTNET_UIVK = "uivktest1hzw7wyadutvzfgpna80yftsk5l7jeyu2p5me5quvp28tytxueta00cx4068wnlzcv7tx9n3t3gfhsy83pe4y6jrhxtzaq0hj6xtg5zrk2dn7zen3vns2a5pgs4fxdjlletmqrhfa42";
-var MAINNET_UIVK = "uivk1gl26qy0xjja7lqhyg3pf0x4j4j66kqwewrjkdcg28eqq4wgtzjmujpee7x9cs2ec9xhnlgrm8ptlw8z80j2aryw8nqtssser2ys778a0s00uvgkdjnfr58sndhfvc3f4zqjs6ywva6";
+var TESTNET_UIVK = "utest1hzw7wyadutvzfgpna80yftsk5l7jeyu2p5me5quvp28tytxueta00cx4068wnlzcv7tx9n3t3gfhsy83pe4y6jrhxtzaq0hj6xtg5zrk2dn7zen3vns2a5pgs4fxdjlletmqrhfa42";
+var MAINNET_UIVK = "u1k0evt0ahj5qdt6y9ftsxndl8lrkm4ff6rp00u04cjpmqj6hxl9t8hfsxftmn3ht34e03lljh89czn2h8qn67rwrs8x0hm3lsxsucp9q9";
 var KNOWN_UIVKS = [TESTNET_UIVK, MAINNET_UIVK];
 var REGISTRY_ADDRESSES = {
   testnet: "utest1f32kn6c4zvn54xr8wfsnxmj9hzpu2mwgtxzpzwcw34906tdccdvzs0z2dx38lly7tpan77x6udt8pjczqm22ymsdhlz9j0tk5yq664nl",
   mainnet: "u1k0evt0ahj5qdt6y9ftsxndl8lrkm4ff6rp00u04cjpmqj6hxl9t8hfsxftmn3ht34e03lljh89czn2h8qn67rwrs8x0hm3lsxsucp9q9"
 };
+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";
@@ -40,7 +123,7 @@ var ZNS = class {
    * @throws Error if the server's UIVK is not recognized
    */
   async verify() {
-    const status = await this.rpc("status");
+    const status = await this.status();
     if (!KNOWN_UIVKS.includes(status.uivk)) {
       throw new Error(
         `UIVK mismatch: indexer returned "${status.uivk.slice(0, 20)}..." which is not a known ZNS instance`
@@ -62,29 +145,33 @@ var ZNS = class {
   }
   /** Fetch current server status including pricing and configuration. */
   async status() {
-    return this.rpc("status");
+    const raw = await this.rpc("status");
+    return toStatus(raw);
   }
   /** Resolve a ZNS name to its registration. Returns null if not registered. */
   async resolveName(name) {
-    return this.rpc("resolve", { query: name });
+    const raw = await this.rpc("resolve", { query: name });
+    return raw ? toRegistration(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). */
   async resolveAddress(address, limit, offset) {
-    return this.rpc("resolve", {
+    const raw = await this.rpc("resolve", {
       query: address,
       limit,
       offset
     });
+    return raw.map(toRegistration);
   }
   /** List all registered names. Useful for explorers or browsers.
    *  Supports pagination with limit (default 50, max 500) and offset (default 0). */
   async listAllRegistrations(limit, offset) {
-    return this.rpc("resolve", {
+    const raw = await this.rpc("resolve", {
       query: "",
       limit,
       offset
     });
+    return raw.map(toRegistration);
   }
   /** Check if a name is available for registration.
    *  Returns false immediately for invalid names without hitting the server. */
@@ -113,13 +200,33 @@ var ZNS = class {
       limit,
       offset
     });
-    return result;
+    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
+    };
   }
   async events(filter) {
-    return this.rpc(
+    const raw = await this.rpc(
       "events",
-      filter ?? {}
+      toEventsFilter(filter ?? {})
     );
+    return toEventsResult(raw);
   }
   /**
    * Verify a listing's signature.
@@ -129,7 +236,7 @@ var ZNS = class {
    */
   async verifyListing(listing, adminPubkey) {
     const pubkey = listing.pubkey ?? adminPubkey;
-    const payload = `LIST:${listing.name}:${listing.price}:${listing.pay_taddr}:${listing.nonce}`;
+    const payload = `LIST:${listing.name}:${listing.price}:${listing.payTaddr}:${listing.nonce}`;
     return this.verifyEd25519(payload, listing.signature, pubkey);
   }
   /**
@@ -253,29 +360,12 @@ var ZNS = class {
           return mk("invalid", actionUpper, "release", `Nonce must be a whole number.`);
         return mk("valid", actionUpper, "release", "Valid RELEASE payload.");
       }
-      case "setprice": {
-        if (parts.length < 3)
-          return mk("invalid", actionUpper, "setprice", `Expected SETPRICE:<count>:<tier1>:...:<nonce>.`);
-        const count = Number(parts[0]);
-        if (!isWholeNumber(parts[0]) || isNaN(count) || count <= 0)
-          return mk("invalid", actionUpper, "setprice", `Count must be a positive whole number.`);
-        const priceCount = parts.length - 2;
-        if (priceCount !== count)
-          return mk("invalid", actionUpper, "setprice", `SETPRICE count mismatch: header is ${count} but found ${priceCount} price tiers.`);
-        if (!isWholeNumber(parts[parts.length - 1]))
-          return mk("invalid", actionUpper, "setprice", `Nonce must be a whole number.`);
-        for (let i = 1; i < parts.length - 1; i++) {
-          if (!isWholeNumber(parts[i]) || Number(parts[i]) <= 0)
-            return mk("invalid", actionUpper, "setprice", `Tier ${i} must be a positive whole number in zats.`);
-        }
-        return mk("valid", actionUpper, "setprice", "Valid SETPRICE payload.");
-      }
       default:
         return {
           valid: false,
           action: actionUpper,
           canonicalAction: null,
-          message: `Unrecognized action "${actionUpper}". Valid actions: CLAIM, BUY, UPDATE, LIST, DELIST, RELEASE, SETPRICE.`,
+          message: `Unrecognized action "${actionUpper}". Valid actions: ${ZNS_ACTIONS.join(", ")}.`,
           level: "unrecognized"
         };
     }
@@ -336,16 +426,16 @@ var ZNS = class {
       }
     };
   }
-  prepareList(name, price, pay_taddr, nonce) {
+  prepareList(name, price, payTaddr, nonce) {
     this.requireValidName(name);
     return {
       name,
       price,
-      pay_taddr,
+      payTaddr,
       nonce,
-      payload: `LIST:${name}:${price}:${pay_taddr}:${nonce}`,
+      payload: `LIST:${name}:${price}:${payTaddr}:${nonce}`,
       complete: (signature, userPubkey) => {
-        const memo = userPubkey ? `ZNS:LIST:${name}:${price}:${pay_taddr}:${nonce}:${signature}:${userPubkey}` : `ZNS:LIST:${name}:${price}:${pay_taddr}:${nonce}:${signature}`;
+        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) };
       }
     };
@@ -419,7 +509,7 @@ var ZNS = class {
   }
   // ── Private helpers ────────────────────────────────────────────────────────
   registrationPayload(reg) {
-    switch (reg.last_action) {
+    switch (reg.lastAction) {
       case "CLAIM":
         return `CLAIM:${reg.name}:${reg.address}`;
       case "BUY":
@@ -513,5 +603,6 @@ export {
   LIST_COMMISSION,
   MAINNET_UIVK,
   TESTNET_UIVK,
-  ZNS
+  ZNS,
+  ZNS_ACTIONS
 };

package/package.json

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