zcashname-sdk 0.6.0 → 0.7.0

package/README.md

@@ -72,21 +72,36 @@ console.log("Memo:", memo);
 ## 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

@@ -43,8 +43,8 @@ var TESTNET_UIVK = "uivktest1hzw7wyadutvzfgpna80yftsk5l7jeyu2p5me5quvp28tytxueta
 var MAINNET_UIVK = "uivk1gl26qy0xjja7lqhyg3pf0x4j4j66kqwewrjkdcg28eqq4wgtzjmujpee7x9cs2ec9xhnlgrm8ptlw8z80j2aryw8nqtssser2ys778a0s00uvgkdjnfr58sndhfvc3f4zqjs6ywva6";
 var KNOWN_UIVKS = [TESTNET_UIVK, MAINNET_UIVK];
 var REGISTRY_ADDRESSES = {
-  testnet: "utest1qqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqq",
-  mainnet: "u1qqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqq"
+  testnet: "utest1f32kn6c4zvn54xr8wfsnxmj9hzpu2mwgtxzpzwcw34906tdccdvzs0z2dx38lly7tpan77x6udt8pjczqm22ymsdhlz9j0tk5yq664nl",
+  mainnet: "u1k0evt0ahj5qdt6y9ftsxndl8lrkm4ff6rp00u04cjpmqj6hxl9t8hfsxftmn3ht34e03lljh89czn2h8qn67rwrs8x0hm3lsxsucp9q9"
 };
 var NAME_RE = /^[a-z0-9]{1,62}$/;
 var ZNS = class {
@@ -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(

package/dist/zns.d.cts

@@ -150,8 +150,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 +164,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.

package/dist/zns.d.ts

@@ -150,8 +150,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 +164,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.

package/dist/zns.js

@@ -6,8 +6,8 @@ var TESTNET_UIVK = "uivktest1hzw7wyadutvzfgpna80yftsk5l7jeyu2p5me5quvp28tytxueta
 var MAINNET_UIVK = "uivk1gl26qy0xjja7lqhyg3pf0x4j4j66kqwewrjkdcg28eqq4wgtzjmujpee7x9cs2ec9xhnlgrm8ptlw8z80j2aryw8nqtssser2ys778a0s00uvgkdjnfr58sndhfvc3f4zqjs6ywva6";
 var KNOWN_UIVKS = [TESTNET_UIVK, MAINNET_UIVK];
 var REGISTRY_ADDRESSES = {
-  testnet: "utest1qqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqq",
-  mainnet: "u1qqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqq"
+  testnet: "utest1f32kn6c4zvn54xr8wfsnxmj9hzpu2mwgtxzpzwcw34906tdccdvzs0z2dx38lly7tpan77x6udt8pjczqm22ymsdhlz9j0tk5yq664nl",
+  mainnet: "u1k0evt0ahj5qdt6y9ftsxndl8lrkm4ff6rp00u04cjpmqj6hxl9t8hfsxftmn3ht34e03lljh89czn2h8qn67rwrs8x0hm3lsxsucp9q9"
 };
 var NAME_RE = /^[a-z0-9]{1,62}$/;
 var ZNS = class {
@@ -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(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zcashname-sdk",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "type": "module",
   "description": "TypeScript SDK for the Zcash Name System (ZNS)",
   "main": "dist/zns.cjs",
@@ -37,4 +37,4 @@
     "typescript": "^5.4.0",
     "vitest": "^2.0.0"
   }
-}
+}