@orbinum/sdk 0.7.0 → 0.7.1

package/README.md

@@ -28,6 +28,7 @@ const client = await OrbinumClient.connect({
 const info  = await client.substrate.getChainInfo();
 const root  = await client.rpcV2.privacy.getMerkleRoot();
 const block = await client.substrate.getBlock('best');
+const isValidator = await client.rpcV2.chain.isValidator('5GrwvaEF...');
 ```
 
 `OrbinumClient` exposes the following modules:
@@ -36,7 +37,8 @@ const block = await client.substrate.getBlock('best');
 |---|---|
 | `client.substrate` | Substrate RPC — blocks, events, transactions |
 | `client.evm` | EVM JSON-RPC client (`null` if `evmRpc` not set) |
-| `client.rpcV2` | Orbinum `rpc-v2` namespaces (`privacy_*`, etc.) |
+| `client.rpcV2` | Orbinum `rpc-v2` namespaces (`chain_*`, `privacy_*`) |
+| `client.rpcV2.chain` | Chain-level queries (`chain_isValidator`, etc.) |
 | `client.shieldedPool` | Shielded pool extrinsics |
 | `client.accountMapping` | Alias, chain-link, and identity operations |
 | `client.precompiles` | EVM precompile wrappers (`null` if `evmRpc` not set) |

package/dist/index.d.mts

@@ -711,7 +711,6 @@ declare class IndexerClient {
     constructor(config: IndexerClientConfig);
     private _fetchResponse;
     private get;
-    private post;
     private getOrNull;
     private buildQuery;
     /** Returns the total count of shielded commitments. */
@@ -744,11 +743,15 @@ declare class IndexerClient {
     /** Returns the spent/unspent status of a nullifier. */
     getNullifierStatus(hex: string): Promise<NullifierStatusResult>;
     /**
-     * Batch-checks which of the given nullifiers are spent.
-     * Returns only the nullifiers that exist in the spent set.
-     * Accepts up to 100 nullifiers (0x-prefixed hex).
+     * Downloads the full spent nullifier set and returns it as a Set of lowercase hex strings.
+     *
+     * The server sees an identical GET request regardless of which notes the wallet holds —
+     * the intersection is computed locally (PIR-A privacy model).
+     *
+     * Suitable for wallets with up to ~1M spent nullifiers (~70 MB raw, <20 MB gzip).
+     * For the current Orbinum testnet/mainnet scale this is the recommended approach.
      */
-    getNullifiersBatch(nullifiers: string[]): Promise<SpentNullifier[]>;
+    getAllSpentNullifiers(): Promise<Set<string>>;
     /**
      * Returns temporal metadata for private transfers that spent any of the given nullifiers.
      * Only blockNumber, extrinsicIndex, timestampMs, and hash are returned — no cross-link

package/dist/index.d.ts

@@ -711,7 +711,6 @@ declare class IndexerClient {
     constructor(config: IndexerClientConfig);
     private _fetchResponse;
     private get;
-    private post;
     private getOrNull;
     private buildQuery;
     /** Returns the total count of shielded commitments. */
@@ -744,11 +743,15 @@ declare class IndexerClient {
     /** Returns the spent/unspent status of a nullifier. */
     getNullifierStatus(hex: string): Promise<NullifierStatusResult>;
     /**
-     * Batch-checks which of the given nullifiers are spent.
-     * Returns only the nullifiers that exist in the spent set.
-     * Accepts up to 100 nullifiers (0x-prefixed hex).
+     * Downloads the full spent nullifier set and returns it as a Set of lowercase hex strings.
+     *
+     * The server sees an identical GET request regardless of which notes the wallet holds —
+     * the intersection is computed locally (PIR-A privacy model).
+     *
+     * Suitable for wallets with up to ~1M spent nullifiers (~70 MB raw, <20 MB gzip).
+     * For the current Orbinum testnet/mainnet scale this is the recommended approach.
      */
-    getNullifiersBatch(nullifiers: string[]): Promise<SpentNullifier[]>;
+    getAllSpentNullifiers(): Promise<Set<string>>;
     /**
      * Returns temporal metadata for private transfers that spent any of the given nullifiers.
      * Only blockNumber, extrinsicIndex, timestampMs, and hash are returned — no cross-link

package/dist/index.js

@@ -1113,24 +1113,6 @@ var IndexerClient = class {
     }
     return res.json();
   }
-  async post(path, body) {
-    const controller = new AbortController();
-    const timer = setTimeout(() => controller.abort(), this.timeoutMs);
-    try {
-      const res = await fetch(`${this.baseUrl}${path}`, {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify(body),
-        signal: controller.signal
-      });
-      if (!res.ok) {
-        throw new Error(`IndexerClient: HTTP ${res.status} for POST ${path}`);
-      }
-      return res.json();
-    } finally {
-      clearTimeout(timer);
-    }
-  }
   async getOrNull(path) {
     const res = await this._fetchResponse(path);
     if (res.status === 404) return null;
@@ -1194,16 +1176,17 @@ var IndexerClient = class {
     );
   }
   /**
-   * Batch-checks which of the given nullifiers are spent.
-   * Returns only the nullifiers that exist in the spent set.
-   * Accepts up to 100 nullifiers (0x-prefixed hex).
+   * Downloads the full spent nullifier set and returns it as a Set of lowercase hex strings.
+   *
+   * The server sees an identical GET request regardless of which notes the wallet holds —
+   * the intersection is computed locally (PIR-A privacy model).
+   *
+   * Suitable for wallets with up to ~1M spent nullifiers (~70 MB raw, <20 MB gzip).
+   * For the current Orbinum testnet/mainnet scale this is the recommended approach.
    */
-  async getNullifiersBatch(nullifiers) {
-    if (nullifiers.length === 0) return [];
-    const res = await this.post("/shielded/nullifiers/batch", {
-      nullifiers: nullifiers.map((n) => n.toLowerCase())
-    });
-    return res.data;
+  async getAllSpentNullifiers() {
+    const res = await this.get("/shielded/nullifiers/all");
+    return new Set(res.data.map((h) => h.toLowerCase()));
   }
   // ─── Private transfers ─────────────────────────────────────────────────────
   /**

package/dist/index.mjs

@@ -986,24 +986,6 @@ var IndexerClient = class {
     }
     return res.json();
   }
-  async post(path, body) {
-    const controller = new AbortController();
-    const timer = setTimeout(() => controller.abort(), this.timeoutMs);
-    try {
-      const res = await fetch(`${this.baseUrl}${path}`, {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify(body),
-        signal: controller.signal
-      });
-      if (!res.ok) {
-        throw new Error(`IndexerClient: HTTP ${res.status} for POST ${path}`);
-      }
-      return res.json();
-    } finally {
-      clearTimeout(timer);
-    }
-  }
   async getOrNull(path) {
     const res = await this._fetchResponse(path);
     if (res.status === 404) return null;
@@ -1067,16 +1049,17 @@ var IndexerClient = class {
     );
   }
   /**
-   * Batch-checks which of the given nullifiers are spent.
-   * Returns only the nullifiers that exist in the spent set.
-   * Accepts up to 100 nullifiers (0x-prefixed hex).
+   * Downloads the full spent nullifier set and returns it as a Set of lowercase hex strings.
+   *
+   * The server sees an identical GET request regardless of which notes the wallet holds —
+   * the intersection is computed locally (PIR-A privacy model).
+   *
+   * Suitable for wallets with up to ~1M spent nullifiers (~70 MB raw, <20 MB gzip).
+   * For the current Orbinum testnet/mainnet scale this is the recommended approach.
    */
-  async getNullifiersBatch(nullifiers) {
-    if (nullifiers.length === 0) return [];
-    const res = await this.post("/shielded/nullifiers/batch", {
-      nullifiers: nullifiers.map((n) => n.toLowerCase())
-    });
-    return res.data;
+  async getAllSpentNullifiers() {
+    const res = await this.get("/shielded/nullifiers/all");
+    return new Set(res.data.map((h) => h.toLowerCase()));
   }
   // ─── Private transfers ─────────────────────────────────────────────────────
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orbinum/sdk",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "Official TypeScript SDK for Orbinum.",
   "author": "Orbinum",
   "license": "MIT",