@orbinum/sdk 0.12.0 → 0.13.0

package/dist/index.mjs

@@ -1019,397 +1019,6 @@ var EvmExplorer = class _EvmExplorer {
   }
 };
 
-// src/indexer/IndexerClient.ts
-var LOCAL_HOSTS = /* @__PURE__ */ new Set(["localhost", "127.0.0.1", "[::1]", "::1"]);
-function normalizeBaseUrl(baseUrl) {
-  let url;
-  try {
-    url = new URL(baseUrl);
-  } catch {
-    throw new Error(`IndexerClient: invalid baseUrl ${JSON.stringify(baseUrl)}`);
-  }
-  const isLocal = LOCAL_HOSTS.has(url.hostname);
-  if (url.protocol !== "https:" && !(url.protocol === "http:" && isLocal)) {
-    throw new Error(
-      `IndexerClient: baseUrl must use https:// (got ${url.protocol}//${url.hostname}). Plain http is only allowed for localhost.`
-    );
-  }
-  return baseUrl.replace(/\/$/, "");
-}
-var IndexerClient = class _IndexerClient {
-  baseUrl;
-  timeoutMs;
-  constructor(config) {
-    this.baseUrl = normalizeBaseUrl(config.baseUrl);
-    this.timeoutMs = config.timeoutMs ?? 1e4;
-  }
-  // ─── Internal helpers ──────────────────────────────────────────────────────
-  async _fetchResponse(path) {
-    const controller = new AbortController();
-    const timer = setTimeout(() => controller.abort(), this.timeoutMs);
-    try {
-      return await fetch(`${this.baseUrl}${path}`, { signal: controller.signal });
-    } finally {
-      clearTimeout(timer);
-    }
-  }
-  async get(path) {
-    const res = await this._fetchResponse(path);
-    if (!res.ok) {
-      throw new Error(`IndexerClient: HTTP ${res.status} for ${path}`);
-    }
-    return res.json();
-  }
-  async getOrNull(path) {
-    const res = await this._fetchResponse(path);
-    if (res.status === 404) return null;
-    if (!res.ok) {
-      throw new Error(`IndexerClient: HTTP ${res.status} for ${path}`);
-    }
-    return res.json();
-  }
-  buildQuery(params) {
-    const entries = Object.entries(params).filter(([, v]) => v !== void 0);
-    if (entries.length === 0) return "";
-    const qs = entries.map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(String(v))}`).join("&");
-    return `?${qs}`;
-  }
-  // ─── Commitments ───────────────────────────────────────────────────────────
-  /** Returns the total count of shielded commitments. */
-  async getCommitmentsCount() {
-    const res = await this.get("/shielded/commitments/count");
-    return res.total;
-  }
-  /** Returns a paginated list of shielded commitments. */
-  async getCommitments(params) {
-    const qs = this.buildQuery({
-      page: params?.page,
-      limit: params?.limit,
-      since_leaf_index: params?.sinceLeafIndex
-    });
-    return this.get(`/shielded/commitments${qs}`);
-  }
-  /** Returns a single commitment by its hex string, or null if not found. */
-  async getCommitmentByHex(hex) {
-    return this.getOrNull(
-      `/shielded/commitments/${encodeURIComponent(hex)}`
-    );
-  }
-  /**
-   * Returns a paginated list of stealth scan hints ordered ascending by leafIndex.
-   * Each hint contains only the fields required for ECDH triage and decryption:
-   * leafIndex, commitmentHex, assetId, ephPkHex, encryptedMemo, circuitVersion.
-   *
-   * Use `sinceLeafIndex` for incremental scans (cursor = last seen leafIndex + 1).
-   */
-  async getScanHints(params) {
-    const qs = this.buildQuery({
-      page: params?.page,
-      limit: params?.limit,
-      since_leaf_index: params?.sinceLeafIndex
-    });
-    return this.get(`/shielded/scan-hints${qs}`);
-  }
-  // ─── Nullifiers ────────────────────────────────────────────────────────────
-  /** Returns a paginated list of spent nullifiers. */
-  async getNullifiers(params) {
-    const qs = this.buildQuery({ page: params?.page, limit: params?.limit });
-    return this.get(`/shielded/nullifiers${qs}`);
-  }
-  /** Returns the spent/unspent status of a nullifier. */
-  async getNullifierStatus(hex) {
-    return this.get(
-      `/shielded/nullifier/${encodeURIComponent(hex)}/status`
-    );
-  }
-  /**
-   * 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).
-   *
-   * Kept as the FALLBACK for readers that don't serve sealed chunks yet (and for
-   * small sets). New integrations should prefer the incremental chunk flow:
-   * `getNullifierManifest` → `getNullifierChunk` for missing chunks →
-   * `getNullifierTail`, persisting the set locally between rescans.
-   */
-  async getAllSpentNullifiers() {
-    const res = await this.get("/shielded/nullifiers/all");
-    return new Set(res.data.map((h) => h.toLowerCase()));
-  }
-  /**
-   * Universal index of the sealed nullifier chunks — identical request and
-   * response for every caller (no client-supplied position: PIR-A preserved).
-   *
-   * Returns `null` when the reader does not serve chunks yet (404) — the
-   * caller should fall back to `getAllSpentNullifiers`.
-   */
-  async getNullifierManifest() {
-    return this.getOrNull("/shielded/nullifiers/manifest");
-  }
-  /**
-   * One sealed, immutable chunk of the spent-nullifier set (ascending hex,
-   * lowercased). The digest comes from the manifest and lives in the URL, so
-   * a corrected chunk is a different URL — safe to cache forever client-side.
-   */
-  async getNullifierChunk(idx, digest) {
-    const res = await this.get(
-      `/shielded/nullifiers/chunks/${idx}/${encodeURIComponent(digest)}`
-    );
-    return res.data.map((h) => h.toLowerCase());
-  }
-  /**
-   * The mutable remainder of the nullifier set after the last sealed chunk.
-   * Identical request for every caller (no input). `afterChunks` lets the
-   * client detect a chunk sealed between its manifest fetch and this one.
-   */
-  async getNullifierTail() {
-    const res = await this.get("/shielded/nullifiers/tail");
-    return { afterChunks: res.afterChunks, data: res.data.map((h) => h.toLowerCase()) };
-  }
-  // ─── Private transfers ─────────────────────────────────────────────────────
-  /** Server-enforced max items per by-nullifiers / by-commitments request. */
-  static TRANSFER_LOOKUP_CHUNK = 50;
-  /**
-   * Chunked fetch for the transfer timestamp lookups. The reader silently
-   * truncates each request to 50 items, so larger inputs MUST be split or
-   * results are silently lost. Responses are merged per extrinsic
-   * (`blockNumber:extrinsicIndex`), concatenating the matched arrays, and
-   * sorted by block descending.
-   *
-   * Privacy note: these lookups send the wallet's own note identifiers to
-   * the indexer — a bounded, documented linkage tradeoff for timestamp
-   * recovery. They are NEVER used for spent-STATUS checks (PIR-A: status
-   * comes from the anonymous full-set `/shielded/nullifiers/all` download).
-   */
-  async fetchTransfersChunked(path, param, items, matchedField) {
-    if (items.length === 0) return [];
-    const normalized = items.map((i) => i.toLowerCase());
-    const chunks = [];
-    for (let i = 0; i < normalized.length; i += _IndexerClient.TRANSFER_LOOKUP_CHUNK) {
-      chunks.push(normalized.slice(i, i + _IndexerClient.TRANSFER_LOOKUP_CHUNK));
-    }
-    const responses = await Promise.all(
-      chunks.map((chunk) => {
-        const qs = this.buildQuery({ [param]: chunk.join(",") });
-        return this.get(
-          `${path}${qs}`
-        );
-      })
-    );
-    const byExtrinsic = /* @__PURE__ */ new Map();
-    for (const res of responses) {
-      for (const transfer of res.data) {
-        const key = `${transfer.blockNumber}:${transfer.extrinsicIndex ?? "null"}`;
-        const existing = byExtrinsic.get(key);
-        if (!existing) {
-          byExtrinsic.set(key, transfer);
-          continue;
-        }
-        const merged = /* @__PURE__ */ new Set([
-          ...existing[matchedField] ?? [],
-          ...transfer[matchedField] ?? []
-        ]);
-        existing[matchedField] = [...merged];
-      }
-    }
-    return [...byExtrinsic.values()].sort((a, b) => b.blockNumber - a.blockNumber);
-  }
-  /**
-   * Returns temporal metadata for private transfers that spent any of the given nullifiers.
-   * Only blockNumber, extrinsicIndex, timestampMs, and hash are returned — no cross-link
-   * between inputs and outputs to prevent graph reconstruction.
-   * Inputs of any size are transparently chunked into requests of 50 (the server cap)
-   * and merged per extrinsic.
-   */
-  async getTransfersByNullifiers(nullifiers) {
-    return this.fetchTransfersChunked(
-      "/shielded/transfers/by-nullifiers",
-      "nullifiers",
-      nullifiers,
-      "matchedNullifiers"
-    );
-  }
-  /**
-   * Returns temporal metadata for private transfers that produced any of the given commitments.
-   * Only blockNumber, extrinsicIndex, timestampMs, and hash are returned — no cross-link
-   * between outputs and inputs to prevent graph reconstruction.
-   * Inputs of any size are transparently chunked into requests of 50 (the server cap)
-   * and merged per extrinsic.
-   */
-  async getTransfersByCommitments(commitments) {
-    return this.fetchTransfersChunked(
-      "/shielded/transfers/by-commitments",
-      "commitments",
-      commitments,
-      "matchedCommitments"
-    );
-  }
-  // ─── Unshields ─────────────────────────────────────────────────────────────
-  /** Returns a paginated list of unshield events. */
-  async getUnshields(params) {
-    const qs = this.buildQuery({ page: params?.page, limit: params?.limit });
-    return this.get(`/shielded/unshields${qs}`);
-  }
-  // ─── Merkle roots ──────────────────────────────────────────────────────────
-  /** Returns a paginated list of Merkle root checkpoints. */
-  async getMerkleRoots(params) {
-    const qs = this.buildQuery({ page: params?.page, limit: params?.limit });
-    return this.get(`/shielded/merkle-roots${qs}`);
-  }
-  /** Returns the latest Merkle root, or null if none exists. */
-  async getLatestMerkleRoot() {
-    return this.getOrNull("/shielded/merkle-roots/latest");
-  }
-  // ─── Address activity ──────────────────────────────────────────────────────
-  /** Returns a paginated list of extrinsics signed by the given address. */
-  async getAddressExtrinsics(address, params) {
-    const qs = this.buildQuery({ page: params?.page, limit: params?.limit });
-    return this.get(
-      `/address/${encodeURIComponent(address.toLowerCase())}/extrinsics${qs}`
-    );
-  }
-  /** Returns a paginated list of EVM transactions filtered by address and/or block number. */
-  async getEvmTransactions(params) {
-    const qs = this.buildQuery({
-      page: params?.page,
-      limit: params?.limit,
-      address: params?.address?.toLowerCase(),
-      blockNumber: params?.blockNumber
-    });
-    return this.get(`/evm/transactions${qs}`);
-  }
-  /** Returns a single EVM transaction by hash, or null if not found. */
-  async getEvmTransactionByHash(hash) {
-    return this.getOrNull(
-      `/evm/transactions/${encodeURIComponent(hash.toLowerCase())}`
-    );
-  }
-  // ─── Blocks ────────────────────────────────────────────────────────────────
-  /** Returns a paginated list of indexed blocks. */
-  async getBlocks(params) {
-    const qs = this.buildQuery({ page: params?.page, limit: params?.limit });
-    return this.get(`/blocks${qs}`);
-  }
-  /** Returns a single block by number or hash, or null if not found. */
-  async getBlock(numberOrHash) {
-    return this.getOrNull(`/blocks/${encodeURIComponent(String(numberOrHash))}`);
-  }
-  // ─── Address-scoped shielded activity ─────────────────────────────────────
-  /**
-   * Returns a paginated list of unshield events where the given address is the recipient.
-   * Accepts a 0x-prefixed EVM address or an SS58 Substrate address.
-   */
-  async getAddressUnshields(address, params) {
-    const qs = this.buildQuery({ page: params?.page, limit: params?.limit });
-    return this.get(
-      `/address/${encodeURIComponent(address)}/unshields${qs}`
-    );
-  }
-  /**
-   * Returns the shielded-pool BOUNDARY activity for an address: shields it
-   * deposited and unshields it received, tagged `kind: 'shield' | 'unshield'`.
-   * Only boundary fields are returned (block, asset, amount for unshields,
-   * timestamp, tx hash) — note internals are never served per-address, and
-   * private transfers carry no address at all (PIR-A).
-   */
-  async getAddressShieldedActivity(address, params) {
-    const qs = this.buildQuery({ page: params?.page, limit: params?.limit });
-    return this.get(
-      `/shielded/address/${encodeURIComponent(address)}${qs}`
-    );
-  }
-  // ─── Relayers ──────────────────────────────────────────────────────────────
-  /** Returns a paginated list of relayers. Filter by active status with `active`. */
-  async getRelayers(params) {
-    const qs = this.buildQuery({
-      page: params?.page,
-      limit: params?.limit,
-      active: params?.active === void 0 ? void 0 : params.active ? "true" : "false"
-    });
-    return this.get(`/relayers${qs}`);
-  }
-  /** Returns a single relayer by EVM address, or null if not found. */
-  async getRelayer(evmAddress) {
-    return this.getOrNull(`/relayers/${encodeURIComponent(evmAddress.toLowerCase())}`);
-  }
-  /** Returns a paginated list of relay fee events. */
-  async getRelayFees(params) {
-    const qs = this.buildQuery({
-      page: params?.page,
-      limit: params?.limit,
-      relayer: params?.relayer,
-      type: params?.type
-    });
-    return this.get(`/relayers/fees${qs}`);
-  }
-  /** Returns aggregated relay fee balances per asset for a given relayer account. */
-  async getRelayFeesSummary(relayer) {
-    return this.get(
-      `/relayers/fees/summary/${encodeURIComponent(relayer)}`
-    );
-  }
-  // ─── Registered assets ─────────────────────────────────────────────────────
-  /** Returns a paginated list of assets registered via register_asset. */
-  async getRegisteredAssets(params) {
-    const qs = this.buildQuery({ page: params?.page, limit: params?.limit });
-    return this.get(`/shielded/assets${qs}`);
-  }
-  /** Returns a single registered asset by its ID, or null if not found. */
-  async getRegisteredAsset(assetId) {
-    return this.getOrNull(`/shielded/assets/${encodeURIComponent(assetId)}`);
-  }
-  // ─── Validators ────────────────────────────────────────────────────────────
-  /** Returns a paginated list of validators. Filter by lifecycle status with `status`. */
-  async getValidators(params) {
-    const qs = this.buildQuery({
-      page: params?.page,
-      limit: params?.limit,
-      status: params?.status
-    });
-    return this.get(`/validators${qs}`);
-  }
-  /** Returns a single validator by account address, or null if not found. */
-  async getValidator(account) {
-    return this.getOrNull(`/validators/${encodeURIComponent(account)}`);
-  }
-  // ─── Sessions ──────────────────────────────────────────────────────────────
-  /** Returns a paginated list of session rotations, ordered by most recent first. */
-  async getSessions(params) {
-    const qs = this.buildQuery({ page: params?.page, limit: params?.limit });
-    return this.get(`/sessions${qs}`);
-  }
-  // ─── Stats & Health ────────────────────────────────────────────────────────
-  /** Returns aggregated indexer statistics. */
-  async getStats() {
-    return this.get("/stats");
-  }
-  /**
-   * Returns transaction activity bucketed per hour over the last `hours` hours
-   * of chain time (default 24, max 168). For sparklines / activity charts.
-   */
-  async getActivity(hours = 24) {
-    return this.get(`/stats/activity?hours=${hours}`);
-  }
-  /** Returns true if the indexer health endpoint responds OK. */
-  async isHealthy() {
-    try {
-      const controller = new AbortController();
-      const timer = setTimeout(() => controller.abort(), this.timeoutMs);
-      try {
-        const res = await fetch(`${this.baseUrl}/health`, {
-          signal: controller.signal
-        });
-        return res.ok;
-      } finally {
-        clearTimeout(timer);
-      }
-    } catch {
-      return false;
-    }
-  }
-};
-
 // src/shielded-pool/pallet/ShieldedPoolModule.ts
 import "polkadot-api";
 
@@ -3511,12 +3120,6 @@ var OrbinumClient = class _OrbinumClient {
    * `null` when `evmRpc` is not configured.
    */
   evmExplorer;
-  /**
-   * HTTP client for the Orbinum indexer REST API.
-   * Provides paginated access to indexed blocks, extrinsics, shielded events, and nullifiers.
-   * `null` when `indexerUrl` is not configured.
-   */
-  indexer;
   /** Shielded-pool extrinsics and Merkle tree queries (`shield`, `unshield`, `privateTransfer`, …). */
   shieldedPool;
   /** Account-mapping extrinsics: aliases, chain links, metadata, marketplace, and identity. */
@@ -3540,11 +3143,10 @@ var OrbinumClient = class _OrbinumClient {
    */
   precompiles;
   /** @internal Use `OrbinumClient.connect()` to obtain an instance. */
-  constructor(substrate, evm, indexer, circuitsBaseUrl) {
+  constructor(substrate, evm, circuitsBaseUrl) {
     this.substrate = substrate;
     this.evm = evm;
     this.evmExplorer = evm ? new EvmExplorer(evm) : null;
-    this.indexer = indexer;
     this.shieldedPool = new ShieldedPoolModule(substrate);
     this.accountMapping = new AccountMappingModule(substrate);
     this.privacy = new PrivacyModule(substrate);
@@ -3570,8 +3172,7 @@ var OrbinumClient = class _OrbinumClient {
       config.connectTimeoutMs ?? 15e3
     );
     const evm = config.evmRpc ? new EvmClient(config.evmRpc) : null;
-    const indexer = config.indexerUrl ? new IndexerClient({ baseUrl: config.indexerUrl }) : null;
-    return new _OrbinumClient(substrate, evm, indexer, config.circuitsBaseUrl);
+    return new _OrbinumClient(substrate, evm, config.circuitsBaseUrl);
   }
   /** Closes the underlying Substrate WebSocket connection and releases all resources. */
   destroy() {
@@ -3692,7 +3293,6 @@ var OrbinumClientProvider = class {
         substrateWs: this.config.substrateWs
       };
       if (this.config.evmRpc) connectConfig.evmRpc = this.config.evmRpc;
-      if (this.config.indexerUrl) connectConfig.indexerUrl = this.config.indexerUrl;
       if (this.config.circuitsBaseUrl)
         connectConfig.circuitsBaseUrl = this.config.circuitsBaseUrl;
       const clientPromise = OrbinumClient.connect(connectConfig);
@@ -5536,7 +5136,6 @@ export {
   EncryptedMemo,
   EvmClient,
   EvmExplorer,
-  IndexerClient,
   KNOWN_PRECOMPILES,
   Keccak256,
   NoteBuilder,

package/package.json

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