@secondlayer/sdk 6.20.0 → 6.21.0

package/dist/subgraphs/index.d.ts

@@ -273,150 +273,6 @@ declare class Contracts extends BaseClient {
 		includeAbi?: boolean
 	}): Promise<ContractSummary | null>;
 }
-/**
-* Typed client for the Foundation Datasets REST API (`/v1/datasets/*`).
-*
-* Most datasets are cursor-paginated event lists with a uniform `list`/`walk`
-* surface; a few (bns names/namespaces/resolve, network-health) are
-* offset/single-object/summary and get bespoke methods. Query params are typed
-* per dataset; rows are `DatasetRow` (JSON) in v1 — per-dataset row interfaces
-* are a fast-follow.
-*/
-/** A dataset row — flat JSON object. Per-dataset interfaces are a follow-up. */
-type DatasetRow = Record<string, unknown>;
-/** Filters shared by every cursor-paginated dataset. */
-interface CursorListParams {
-	cursor?: string;
-	limit?: number;
-	fromBlock?: number;
-	toBlock?: number;
-}
-interface CursorEnvelope {
-	rows: DatasetRow[];
-	next_cursor: string | null;
-	tip?: {
-		block_height: number
-	};
-}
-type RangeFilters = CursorListParams;
-type StxTransfersParams = RangeFilters & {
-	sender?: string
-	recipient?: string
-};
-type SbtcEventsParams = RangeFilters & {
-	topic?: string
-	address?: string
-};
-type SbtcTokenEventsParams = RangeFilters & {
-	eventType?: string
-	sender?: string
-	recipient?: string
-};
-type Pox4CallsParams = RangeFilters & {
-	functionName?: string
-	stacker?: string
-	delegateTo?: string
-	signerKey?: string
-	rewardCycle?: number
-	/** Any-role: matches caller OR stacker OR delegate_to. */
-	address?: string
-};
-type BurnchainRewardsParams = RangeFilters & {
-	/** Filter to one Bitcoin reward address. */
-	recipient?: string
-};
-type BurnchainRewardSlotsParams = RangeFilters & {
-	/** Filter to one reward-set Bitcoin address. */
-	holder?: string
-};
-type BnsEventsParams = RangeFilters & {
-	topic?: string
-	namespace?: string
-	name?: string
-	owner?: string
-};
-type BnsNamespaceEventsParams = RangeFilters & {
-	status?: string
-	namespace?: string
-};
-type BnsMarketplaceEventsParams = RangeFilters & {
-	action?: string
-	bnsId?: string
-};
-type CursorDataset<P> = {
-	list: (params?: P) => Promise<CursorEnvelope>
-	walk: (params?: P & {
-		batchSize?: number
-		signal?: AbortSignal
-	}) => AsyncIterable<DatasetRow>
-};
-declare class Datasets extends BaseClient {
-	private catalogPromise?;
-	constructor(options?: Partial<SecondLayerOptions>);
-	/** Dataset catalog + freshness (the discovery endpoint). */
-	listDatasets(): Promise<unknown>;
-	/**
-	* Generic read by slug for ANY catalog dataset — cursor or bespoke. Resolves
-	* the slug against the live `/v1/datasets` catalog (so datasets added
-	* server-side work with no SDK change), issues the GET, and normalizes the
-	* response into a uniform `{ rows, next_cursor, tip }` envelope. Single-object
-	* datasets (bns/resolve, network-health/summary) come back as 0-or-1 rows.
-	* Accepts both family (`sbtc-events`) and path (`sbtc/events`) slug forms.
-	* Prefer this over {@link query} unless you specifically need cursor-only
-	* semantics.
-	*/
-	get(slug: string, params?: Record<string, unknown>): Promise<CursorEnvelope>;
-	/**
-	* Generic cursor query by slug — used by the CLI. Params are passed through as
-	* REST query keys (snake_case), so callers can use the documented filter names
-	* directly. Throws for non-cursor (bespoke) datasets — use {@link get} for
-	* those (and for slugs added to the catalog after this SDK was built).
-	*/
-	query(slug: string, params?: Record<string, unknown>): Promise<CursorEnvelope>;
-	readonly stxTransfers: CursorDataset<StxTransfersParams>;
-	readonly sbtcEvents: CursorDataset<SbtcEventsParams>;
-	readonly sbtcTokenEvents: CursorDataset<SbtcTokenEventsParams>;
-	readonly pox4Calls: CursorDataset<Pox4CallsParams>;
-	readonly burnchainRewards: CursorDataset<BurnchainRewardsParams>;
-	readonly burnchainRewardSlots: CursorDataset<BurnchainRewardSlotsParams>;
-	readonly bnsEvents: CursorDataset<BnsEventsParams>;
-	readonly bnsNamespaceEvents: CursorDataset<BnsNamespaceEventsParams>;
-	readonly bnsMarketplaceEvents: CursorDataset<BnsMarketplaceEventsParams>;
-	/** BNS names — offset-paginated. */
-	bnsNames(params?: {
-		namespace?: string
-		owner?: string
-		limit?: number
-		offset?: number
-	}): Promise<{
-		names: DatasetRow[]
-	}>;
-	/** All BNS namespaces (no pagination). */
-	bnsNamespaces(): Promise<{
-		namespaces: DatasetRow[]
-	}>;
-	/** Resolve a fully-qualified BNS name → single record. */
-	bnsResolve(fqn: string): Promise<{
-		name: DatasetRow | null
-	}>;
-	/** Network health summary. */
-	networkHealth(): Promise<{
-		summary: DatasetRow
-	}>;
-	private requestPath;
-	/** Resolve a slug → relative path + row key. Known cursor slugs take a
-	*  network-free fast path; anything else is matched against the live catalog
-	*  by family name or path tail. */
-	private resolveDataset;
-	/** Fetch + cache the catalog families. Caches the in-flight promise so
-	*  concurrent first-calls share one request; no TTL — agent sessions are
-	*  short-lived, and a new client picks up newly added datasets. */
-	private loadCatalog;
-	/** Map camelCase filter fields to snake_case query keys (dropping pagination
-	*  controls) and build the canonical query suffix. */
-	private paramsToQuery;
-	private cursorDataset;
-}
 import { RewardSet } from "@secondlayer/shared/node/consensus";
 import { MerkleProofStep } from "@secondlayer/shared/node/nakamoto";
 /**
@@ -1643,7 +1499,6 @@ interface ContextSnapshot {
 declare class SecondLayer extends BaseClient {
 	readonly streams: StreamsClient;
 	readonly index: Index;
-	readonly datasets: Datasets;
 	readonly contracts: Contracts;
 	readonly subgraphs: Subgraphs;
 	readonly subscriptions: Subscriptions;
@@ -1655,6 +1510,21 @@ declare class SecondLayer extends BaseClient {
 	* from `secondlayer://context`, but available to any SDK/CLI consumer. Reads
 	* run concurrently and degrade to `null` per field on failure.
 	*/
+	/**
+	* Up to 10 public reads in one round trip (`POST /v1/batch`). Each item
+	* keeps its own auth/quota/x402 semantics; forwarded credentials (API key,
+	* PAYMENT-BALANCE/SESSION) apply to every item.
+	*/
+	batch(requests: Array<{
+		path: string
+		params?: Record<string, string | number | boolean>
+	}>): Promise<{
+		results: Array<{
+			path: string | null
+			status: number
+			body: unknown
+		}>
+	}>;
 	context(): Promise<ContextSnapshot>;
 }
 /**

package/dist/subgraphs/index.js

@@ -442,164 +442,6 @@ class Contracts extends BaseClient {
   }
 }
 
-// src/datasets/client.ts
-var PARAM_KEYS = {
-  fromBlock: "from_block",
-  toBlock: "to_block",
-  functionName: "function_name",
-  delegateTo: "delegate_to",
-  signerKey: "signer_key",
-  rewardCycle: "reward_cycle",
-  eventType: "event_type",
-  bnsId: "bns_id"
-};
-var CURSOR_SLUGS = {
-  "stx-transfers": { path: "stx-transfers", rowKey: "events" },
-  "sbtc-events": { path: "sbtc/events", rowKey: "events" },
-  "sbtc-token-events": { path: "sbtc/token-events", rowKey: "events" },
-  "pox-4-calls": { path: "pox-4/calls", rowKey: "calls" },
-  "burnchain-rewards": { path: "burnchain/rewards", rowKey: "rewards" },
-  "burnchain-reward-slots": {
-    path: "burnchain/reward-slots",
-    rowKey: "slots"
-  },
-  "bns-events": { path: "bns/events", rowKey: "events" },
-  "bns-namespace-events": { path: "bns/namespace-events", rowKey: "events" },
-  "bns-marketplace-events": {
-    path: "bns/marketplace-events",
-    rowKey: "events"
-  }
-};
-function catalogPathTail(path) {
-  return path.replace(/^\/?v1\/datasets\//, "").replace(/^\/+/, "");
-}
-
-class Datasets extends BaseClient {
-  catalogPromise;
-  constructor(options = {}) {
-    super(options);
-  }
-  listDatasets() {
-    return this.request("GET", "/v1/datasets");
-  }
-  async get(slug, params = {}) {
-    const { path, rowKey } = await this.resolveDataset(slug);
-    const env = await this.requestPath(path, this.paramsToQuery(params));
-    const value = env[rowKey];
-    const rows = Array.isArray(value) ? value : value == null ? [] : [value];
-    return {
-      rows,
-      next_cursor: env.next_cursor ?? null,
-      tip: env.tip
-    };
-  }
-  async query(slug, params = {}) {
-    const d = CURSOR_SLUGS[slug];
-    if (!d) {
-      throw new Error(`unknown cursor dataset "${slug}" (use one of: ${Object.keys(CURSOR_SLUGS).join(", ")})`);
-    }
-    const env = await this.requestPath(d.path, this.paramsToQuery(params));
-    return {
-      rows: env[d.rowKey] ?? [],
-      next_cursor: env.next_cursor ?? null,
-      tip: env.tip
-    };
-  }
-  stxTransfers = this.cursorDataset("stx-transfers", "events");
-  sbtcEvents = this.cursorDataset("sbtc/events", "events");
-  sbtcTokenEvents = this.cursorDataset("sbtc/token-events", "events");
-  pox4Calls = this.cursorDataset("pox-4/calls", "calls");
-  burnchainRewards = this.cursorDataset("burnchain/rewards", "rewards");
-  burnchainRewardSlots = this.cursorDataset("burnchain/reward-slots", "slots");
-  bnsEvents = this.cursorDataset("bns/events", "events");
-  bnsNamespaceEvents = this.cursorDataset("bns/namespace-events", "events");
-  bnsMarketplaceEvents = this.cursorDataset("bns/marketplace-events", "events");
-  bnsNames(params = {}) {
-    return this.requestPath("bns/names", buildQuery({
-      namespace: params.namespace,
-      owner: params.owner,
-      limit: params.limit,
-      offset: params.offset
-    }));
-  }
-  bnsNamespaces() {
-    return this.requestPath("bns/namespaces", "");
-  }
-  bnsResolve(fqn) {
-    return this.requestPath("bns/resolve", buildQuery({ fqn }));
-  }
-  networkHealth() {
-    return this.requestPath("network-health/summary", "");
-  }
-  requestPath(path, query) {
-    return this.request("GET", `/v1/datasets/${path}${query}`);
-  }
-  async resolveDataset(slug) {
-    const cursor = CURSOR_SLUGS[slug];
-    if (cursor)
-      return { path: cursor.path, rowKey: cursor.rowKey };
-    const families = await this.loadCatalog();
-    const tail = catalogPathTail(slug);
-    const match = families.find((f) => f.family === slug || catalogPathTail(f.path) === tail);
-    if (!match) {
-      throw new Error(`unknown dataset "${slug}" (available: ${families.map((f) => f.family).join(", ")})`);
-    }
-    return { path: catalogPathTail(match.path), rowKey: match.row_key };
-  }
-  loadCatalog() {
-    this.catalogPromise ??= (async () => {
-      const raw = await this.listDatasets();
-      const families = raw.families;
-      if (!Array.isArray(families)) {
-        throw new Error("dataset catalog response missing families[]");
-      }
-      return families;
-    })();
-    return this.catalogPromise;
-  }
-  paramsToQuery(params) {
-    const mapped = {};
-    for (const [k, v] of Object.entries(params)) {
-      if (v === undefined || v === null || k === "batchSize" || k === "signal")
-        continue;
-      mapped[PARAM_KEYS[k] ?? k] = v;
-    }
-    return buildQuery(mapped);
-  }
-  cursorDataset(path, rowKey) {
-    const list = async (params = {}) => {
-      const envelope = await this.requestPath(path, this.paramsToQuery(params));
-      return {
-        rows: envelope[rowKey] ?? [],
-        next_cursor: envelope.next_cursor ?? null,
-        tip: envelope.tip
-      };
-    };
-    const walk = async function* (params = {}) {
-      const batchSize = params.batchSize ?? 200;
-      let cursor = params.cursor ?? null;
-      let first = true;
-      while (!params.signal?.aborted) {
-        const env = await list({
-          ...params,
-          limit: batchSize,
-          cursor: first ? params.cursor : cursor ?? undefined
-        });
-        for (const row of env.rows) {
-          if (params.signal?.aborted)
-            return;
-          yield row;
-        }
-        if (!env.next_cursor || env.next_cursor === cursor || env.rows.length < batchSize)
-          return;
-        cursor = env.next_cursor;
-        first = false;
-      }
-    }.bind(this);
-    return { list, walk };
-  }
-}
-
 // src/index-api/client.ts
 function firstWalkFromHeight(params) {
   if (params.fromHeight !== undefined)
@@ -1771,7 +1613,6 @@ class Subscriptions extends BaseClient {
 class SecondLayer extends BaseClient {
   streams;
   index;
-  datasets;
   contracts;
   subgraphs;
   subscriptions;
@@ -1786,13 +1627,15 @@ class SecondLayer extends BaseClient {
       dumpsBaseUrl: options.dumpsBaseUrl
     });
     this.index = new Index(options);
-    this.datasets = new Datasets(options);
     this.contracts = new Contracts(options);
     this.subgraphs = new Subgraphs(options);
     this.subscriptions = new Subscriptions(options);
     this.apiKeys = new ApiKeys(options);
     this.projects = new Projects(options);
   }
+  async batch(requests) {
+    return this.request("POST", "/v1/batch", { requests });
+  }
   async context() {
     const safe = (p) => p.then((v) => v).catch(() => null);
     const [
@@ -1875,5 +1718,5 @@ export {
   Subgraphs
 };
 
-//# debugId=DD9EE9C3CECE53B564756E2164756E21
+//# debugId=0E36F58DBAA5692064756E2164756E21
 //# sourceMappingURL=index.js.map