zcashname-sdk 0.6.1 → 0.7.1

package/README.md

@@ -67,26 +67,40 @@ console.log("Memo:", memo);
 | `prepareUpdate(name, newAddress, nonce, registryAddress)` | Change address |
 | `prepareBuy(name, buyerAddress, registryAddress)` | Buy a listed name |
 | `prepareRelease(name, nonce, registryAddress)` | Release name (burn) |
-| `prepareSetPrice(prices, nonce, registryAddress)` | Admin: set pricing tiers |
 
 ## Reading Data
 
 ```ts
-// Resolve name → address
+// Resolve name → address (single lookup)
 const reg = await zns.resolveName("alice");
 
-// Resolve address → names (reverse lookup)
+// Resolve address → names (reverse lookup) - supports pagination
 const names = await zns.resolveAddress("u1qqlzrf9...");
 
+// Paginated address lookup (get next 50 names starting from position 50)
+const namesPage2 = await zns.resolveAddress("u1qqlzrf9...", 50, 50);
+
+// List all registered names (paginated) - useful for explorers
+const allNames = await zns.listAllRegistrations();
+
+// Paginated list (first 100 registrations)
+const first100 = await zns.listAllRegistrations(100, 0);
+
 // Check availability
 const available = await zns.isAvailable("bob");
 
-// Get all listings
+// Get marketplace listings - supports pagination
 const listings = await zns.listings();
 
-// Query events
+// Paginated listings (get 50 listings starting from position 100)
+const listingsPage3 = await zns.listings(50, 100);
+
+// Query events with pagination
 const { events, total } = await zns.events({ action: "CLAIM", limit: 10 });
 
+// Next page of events
+const nextPage = await zns.events({ action: "CLAIM", limit: 10, offset: 10 });
+
 // Get current pricing from status
 const status = await zns.status();
 const cost = zns.claimCost(5, status.pricing); // cost for 5-char name

package/dist/zns.cjs

@@ -93,9 +93,23 @@ var ZNS = class {
   async resolveName(name) {
     return this.rpc("resolve", { query: name });
   }
-  /** Resolve a Zcash Unified Address to all names pointing to it. Returns empty array if none. */
-  async resolveAddress(address) {
-    return this.rpc("resolve", { query: address });
+  /** 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", {
+      query: address,
+      limit,
+      offset
+    });
+  }
+  /** 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", {
+      query: "",
+      limit,
+      offset
+    });
   }
   /** Check if a name is available for registration.
    *  Returns false immediately for invalid names without hitting the server. */
@@ -119,9 +133,12 @@ var ZNS = class {
       return false;
     }
   }
-  async listings() {
-    const result = await this.rpc("list_for_sale");
-    return result.listings;
+  async listings(limit, offset) {
+    const result = await this.rpc("listings", {
+      limit,
+      offset
+    });
+    return result;
   }
   async events(filter) {
     return this.rpc(
@@ -272,17 +289,6 @@ var ZNS = class {
       }
     };
   }
-  prepareSetPrice(prices, nonce) {
-    return {
-      prices,
-      nonce,
-      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) };
-      }
-    };
-  }
   // ── Private helpers ────────────────────────────────────────────────────────
   registrationPayload(reg) {
     switch (reg.last_action) {

package/dist/zns.d.cts

@@ -112,11 +112,6 @@ interface PreparedRelease extends PreparedAction {
     readonly name: string;
     readonly nonce: number;
 }
-/** Prepared SETPRICE action (admin only) */
-interface PreparedSetPrice extends PreparedAction {
-    readonly prices: readonly Zats[];
-    readonly nonce: number;
-}
 
 declare const DEFAULT_URL = "https://light.zcash.me/zns-testnet";
 declare const TESTNET_UIVK = "uivktest1hzw7wyadutvzfgpna80yftsk5l7jeyu2p5me5quvp28tytxueta00cx4068wnlzcv7tx9n3t3gfhsy83pe4y6jrhxtzaq0hj6xtg5zrk2dn7zen3vns2a5pgs4fxdjlletmqrhfa42";
@@ -150,8 +145,12 @@ declare class ZNS {
     status(): Promise<Status>;
     /** Resolve a ZNS name to its registration. Returns null if not registered. */
     resolveName(name: string): Promise<Registration | null>;
-    /** Resolve a Zcash Unified Address to all names pointing to it. Returns empty array if none. */
-    resolveAddress(address: string): Promise<Registration[]>;
+    /** 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). */
+    resolveAddress(address: string, limit?: number, offset?: number): Promise<Registration[]>;
+    /** List all registered names. Useful for explorers or browsers.
+     *  Supports pagination with limit (default 50, max 500) and offset (default 0). */
+    listAllRegistrations(limit?: number, offset?: number): Promise<Registration[]>;
     /** Check if a name is available for registration.
      *  Returns false immediately for invalid names without hitting the server. */
     isAvailable(name: string): Promise<boolean>;
@@ -160,7 +159,10 @@ declare class ZNS {
      *  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;
-    listings(): Promise<Listing[]>;
+    listings(limit?: number, offset?: number): Promise<{
+        listings: Listing[];
+        total: number;
+    }>;
     events(filter?: EventsFilter): Promise<EventsResult>;
     /**
      * Verify a listing's signature.
@@ -205,7 +207,6 @@ declare class ZNS {
     prepareUpdate(name: string, newAddress: string, nonce: number): PreparedUpdate;
     prepareBuy(name: string, buyerAddress: string): PreparedBuy;
     prepareRelease(name: string, nonce: number): PreparedRelease;
-    prepareSetPrice(prices: Zats[], nonce: number): PreparedSetPrice;
     private registrationPayload;
     private verifyEd25519;
     private requireValidName;
@@ -217,4 +218,4 @@ declare class ZNS {
     private rpc;
 }
 
-export { type CompletedAction, DEFAULT_URL, type Event, type EventAction, type EventsFilter, type EventsResult, type LastAction, type Listing, MAINNET_UIVK, type Network, 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 { type CompletedAction, DEFAULT_URL, type Event, type EventAction, type EventsFilter, type EventsResult, type LastAction, type Listing, MAINNET_UIVK, type Network, type PreparedBuy, type PreparedClaim, type PreparedDelist, type PreparedList, type PreparedRelease, type PreparedUpdate, type Pricing, type Registration, type Status, TESTNET_UIVK, ZNS, type Zats };

package/dist/zns.d.ts

@@ -112,11 +112,6 @@ interface PreparedRelease extends PreparedAction {
     readonly name: string;
     readonly nonce: number;
 }
-/** Prepared SETPRICE action (admin only) */
-interface PreparedSetPrice extends PreparedAction {
-    readonly prices: readonly Zats[];
-    readonly nonce: number;
-}
 
 declare const DEFAULT_URL = "https://light.zcash.me/zns-testnet";
 declare const TESTNET_UIVK = "uivktest1hzw7wyadutvzfgpna80yftsk5l7jeyu2p5me5quvp28tytxueta00cx4068wnlzcv7tx9n3t3gfhsy83pe4y6jrhxtzaq0hj6xtg5zrk2dn7zen3vns2a5pgs4fxdjlletmqrhfa42";
@@ -150,8 +145,12 @@ declare class ZNS {
     status(): Promise<Status>;
     /** Resolve a ZNS name to its registration. Returns null if not registered. */
     resolveName(name: string): Promise<Registration | null>;
-    /** Resolve a Zcash Unified Address to all names pointing to it. Returns empty array if none. */
-    resolveAddress(address: string): Promise<Registration[]>;
+    /** 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). */
+    resolveAddress(address: string, limit?: number, offset?: number): Promise<Registration[]>;
+    /** List all registered names. Useful for explorers or browsers.
+     *  Supports pagination with limit (default 50, max 500) and offset (default 0). */
+    listAllRegistrations(limit?: number, offset?: number): Promise<Registration[]>;
     /** Check if a name is available for registration.
      *  Returns false immediately for invalid names without hitting the server. */
     isAvailable(name: string): Promise<boolean>;
@@ -160,7 +159,10 @@ declare class ZNS {
      *  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;
-    listings(): Promise<Listing[]>;
+    listings(limit?: number, offset?: number): Promise<{
+        listings: Listing[];
+        total: number;
+    }>;
     events(filter?: EventsFilter): Promise<EventsResult>;
     /**
      * Verify a listing's signature.
@@ -205,7 +207,6 @@ declare class ZNS {
     prepareUpdate(name: string, newAddress: string, nonce: number): PreparedUpdate;
     prepareBuy(name: string, buyerAddress: string): PreparedBuy;
     prepareRelease(name: string, nonce: number): PreparedRelease;
-    prepareSetPrice(prices: Zats[], nonce: number): PreparedSetPrice;
     private registrationPayload;
     private verifyEd25519;
     private requireValidName;
@@ -217,4 +218,4 @@ declare class ZNS {
     private rpc;
 }
 
-export { type CompletedAction, DEFAULT_URL, type Event, type EventAction, type EventsFilter, type EventsResult, type LastAction, type Listing, MAINNET_UIVK, type Network, 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 { type CompletedAction, DEFAULT_URL, type Event, type EventAction, type EventsFilter, type EventsResult, type LastAction, type Listing, MAINNET_UIVK, type Network, type PreparedBuy, type PreparedClaim, type PreparedDelist, type PreparedList, type PreparedRelease, type PreparedUpdate, type Pricing, type Registration, type Status, TESTNET_UIVK, ZNS, type Zats };

package/dist/zns.js

@@ -56,9 +56,23 @@ var ZNS = class {
   async resolveName(name) {
     return this.rpc("resolve", { query: name });
   }
-  /** Resolve a Zcash Unified Address to all names pointing to it. Returns empty array if none. */
-  async resolveAddress(address) {
-    return this.rpc("resolve", { query: address });
+  /** 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", {
+      query: address,
+      limit,
+      offset
+    });
+  }
+  /** 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", {
+      query: "",
+      limit,
+      offset
+    });
   }
   /** Check if a name is available for registration.
    *  Returns false immediately for invalid names without hitting the server. */
@@ -82,9 +96,12 @@ var ZNS = class {
       return false;
     }
   }
-  async listings() {
-    const result = await this.rpc("list_for_sale");
-    return result.listings;
+  async listings(limit, offset) {
+    const result = await this.rpc("listings", {
+      limit,
+      offset
+    });
+    return result;
   }
   async events(filter) {
     return this.rpc(
@@ -235,17 +252,6 @@ var ZNS = class {
       }
     };
   }
-  prepareSetPrice(prices, nonce) {
-    return {
-      prices,
-      nonce,
-      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) };
-      }
-    };
-  }
   // ── Private helpers ────────────────────────────────────────────────────────
   registrationPayload(reg) {
     switch (reg.last_action) {

package/package.json

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