@secondlayer/sdk 6.20.0 → 6.21.0

package/dist/index.d.ts

@@ -273,155 +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>
-};
-/** Cursor-paginated dataset slugs → REST path + envelope row key. */
-declare const CURSOR_SLUGS: Record<string, {
-	path: string
-	rowKey: string
-}>;
-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";
 /**
@@ -1697,7 +1548,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;
@@ -1709,6 +1559,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>;
 }
 /**
@@ -2129,6 +1994,16 @@ declare function buildSignedX402Payment(opts: BuildSignedX402PaymentOptions): Pr
 }>;
 type WithX402Options = SelectOfferOptions & {
 	account: LocalAccount
+	/** Prepaid-credit token (PAYMENT-BALANCE) from a prior deposit — calls
+	*  debit the tab server-side instead of settling on-chain per call. */
+	balanceToken?: string
+	/** Autonomous treasury policy: when the tab's remaining balance (read from
+	*  X-BALANCE-REMAINING-USD) drops below `whenBelow`, deposit `usd` more in
+	*  the background (one on-chain payment) and adopt the fresh token. */
+	topUp?: {
+		usd: number
+		whenBelow: number
+	}
 	/** Override the payer nonce; auto-resolved from `nodeUrl` when omitted. */
 	accountNonce?: bigint | number | string
 	/** Node for auto-nonce lookup. Defaults to {@link DEFAULT_NONCE_NODE_URL}. */
@@ -2367,4 +2242,4 @@ declare function toJsonSafe(value: unknown): unknown;
 /** Decode a hex-encoded Clarity value to JSON-safe JS (uints as strings,
 *  buffers as `0x…` hex, tuples as objects). Returns the input hex on failure. */
 declare function decodeClarityValue(hex: string): unknown;
-export { withX402, verifyWebhookSignature, verifyTransactionProof, verifySecondlayerSignature, trigger, toJsonSafe, selectOffer, resolveAccountNonce, readX402Receipt, readX402Challenge, payAndRetry, isStxTransfer, isStxMint, isStxLock, isStxBurn, isPrint, isNftTransfer, isNftMint, isNftBurn, isFtTransfer, isFtMint, isFtBurn, getSubgraph, fetchRewardSet, decodeStxTransfer, decodeStxMint, decodeStxLock, decodeStxBurn, decodePrint, decodeNftTransfer, decodeNftMint, decodeNftBurn, decodeFtTransfer, decodeFtMint, decodeFtBurn, decodeClarityValue, createX402Client, createStreamsClient, buildSignedX402Payment, X402SpendGuardError, X402Result, X402Receipt, X402Fetch, X402ClientOptions, X402Client, X402Challenge, X402Accept, WithX402Options, VersionConflictError, ValidationError, UpdateSubscriptionRequest2 as UpdateSubscriptionRequest, UpdateProjectParams, TransactionsWalkParams, TransactionsListParams, TransactionsEnvelope, TransactionProofVerifyResult, TransactionProof, TransactionEnvelope, Subscriptions, SubscriptionSummary2 as SubscriptionSummary, SubscriptionStatus, SubscriptionRuntime, SubscriptionKind, SubscriptionFormat, SubscriptionDetail2 as SubscriptionDetail, Subgraphs, SubgraphSpecOptions3 as SubgraphSpecOptions, SubgraphSpecFormat2 as SubgraphSpecFormat, SubgraphOperationStatus, SubgraphAgentSchema3 as SubgraphAgentSchema, StreamsUsage, StreamsTip, StreamsSignatureError, StreamsServerError, StreamsReorgsListParams, StreamsReorgsListEnvelope, StreamsReorgContext, StreamsReorg, StreamsEventsSubscribeParams, StreamsEventsStreamParams, StreamsEventsListParams, StreamsEventsListEnvelope, StreamsEventsEnvelope, StreamsEventsConsumeResult, StreamsEventsConsumeParams, StreamsEventType, StreamsEventPayload, StreamsEvent, StreamsDumpsManifest, StreamsDumps, StreamsDumpFile, StreamsConsumeParams, StreamsClient, StreamsCanonicalBlock, StreamsBatchContext, StreamsBatch, StackingWalkParams, StackingListParams, StackingEnvelope, SelectOfferOptions, SecondLayerOptions, SecondLayer, ScopedKeyProduct, RotateSecretResponse2 as RotateSecretResponse, RewardSet2 as RewardSet, ReplayResult2 as ReplayResult, RateLimitError, Projects, ProjectTeamMember, ProjectTeam, ProjectInvitation, Project, Pox4CallsParams, PayAndRetryOptions, NftTransfersWalkParams, NftTransfersResource, NftTransfersListParams, NftTransfersEnvelope, NftTransferPayload, NftTransferEvent, NftTransfer, MempoolWalkParams, MempoolTransactionEnvelope, MempoolListParams, MempoolEnvelope, IndexUsage, IndexTransaction, IndexTip, IndexStackingAction, IndexReorg, IndexPostCondition, IndexMempoolTransaction, IndexEventsResource, IndexEventTypeFilters, IndexEventType, IndexEvent, IndexDiscovery, IndexContractCall, IndexCanonicalBlock, IndexBlock, Index, FtTransfersWalkParams, FtTransfersResource, FtTransfersListParams, FtTransfersEnvelope, FtTransferPayload, FtTransferEvent, FtTransfer, FetchLike2 as FetchLike, EventsWalkParams, EventsListParams, EventsEnvelope, DeliveryRow2 as DeliveryRow, DecodedStxTransferPayload, DecodedStxTransfer, DecodedStxMintPayload, DecodedStxMint, DecodedStxLockPayload, DecodedStxLock, DecodedStxBurnPayload, DecodedStxBurn, DecodedPrintValue, DecodedPrintPayload, DecodedPrint, DecodedNftTransferPayload, DecodedNftTransfer, DecodedNftMintPayload, DecodedNftMint, DecodedNftBurnPayload, DecodedNftBurn, DecodedFtTransferPayload, DecodedFtTransfer, DecodedFtMintPayload, DecodedFtMint, DecodedFtBurnPayload, DecodedFtBurn, DecodedEventRow, DecodedEventColumns, DeadRow2 as DeadRow, Datasets, DatasetRow, DEFAULT_PREFER_ASSETS, CursorListParams, CursorEnvelope, Cursor, CreateSubscriptionResponse2 as CreateSubscriptionResponse, CreateSubscriptionRequest2 as CreateSubscriptionRequest, CreateProjectParams, CreateApiKeyResponse, CreateApiKeyParams, ContractsListParams, ContractsEnvelope, Contracts, ContractSummary, ContractConformance, ContractCallsWalkParams, ContractCallsListParams, ContractCallsEnvelope, ContextSnapshot, ContextProject, ContextApiKey, ContextAccount, ChainTriggerType, ChainTrigger, CanonicalWalkParams, CanonicalListParams, CanonicalEnvelope, CURSOR_SLUGS, ByoBreakingChangeError, ByoBreakingChangeDetails, BuildSignedX402PaymentOptions, BlocksWalkParams, BlocksListParams, BlocksEnvelope, BlockEnvelope, AuthError, ApiKeys, ApiKeySummary, ApiError, ActiveSubgraphOperation };
+export { withX402, verifyWebhookSignature, verifyTransactionProof, verifySecondlayerSignature, trigger, toJsonSafe, selectOffer, resolveAccountNonce, readX402Receipt, readX402Challenge, payAndRetry, isStxTransfer, isStxMint, isStxLock, isStxBurn, isPrint, isNftTransfer, isNftMint, isNftBurn, isFtTransfer, isFtMint, isFtBurn, getSubgraph, fetchRewardSet, decodeStxTransfer, decodeStxMint, decodeStxLock, decodeStxBurn, decodePrint, decodeNftTransfer, decodeNftMint, decodeNftBurn, decodeFtTransfer, decodeFtMint, decodeFtBurn, decodeClarityValue, createX402Client, createStreamsClient, buildSignedX402Payment, X402SpendGuardError, X402Result, X402Receipt, X402Fetch, X402ClientOptions, X402Client, X402Challenge, X402Accept, WithX402Options, VersionConflictError, ValidationError, UpdateSubscriptionRequest2 as UpdateSubscriptionRequest, UpdateProjectParams, TransactionsWalkParams, TransactionsListParams, TransactionsEnvelope, TransactionProofVerifyResult, TransactionProof, TransactionEnvelope, Subscriptions, SubscriptionSummary2 as SubscriptionSummary, SubscriptionStatus, SubscriptionRuntime, SubscriptionKind, SubscriptionFormat, SubscriptionDetail2 as SubscriptionDetail, Subgraphs, SubgraphSpecOptions3 as SubgraphSpecOptions, SubgraphSpecFormat2 as SubgraphSpecFormat, SubgraphOperationStatus, SubgraphAgentSchema3 as SubgraphAgentSchema, StreamsUsage, StreamsTip, StreamsSignatureError, StreamsServerError, StreamsReorgsListParams, StreamsReorgsListEnvelope, StreamsReorgContext, StreamsReorg, StreamsEventsSubscribeParams, StreamsEventsStreamParams, StreamsEventsListParams, StreamsEventsListEnvelope, StreamsEventsEnvelope, StreamsEventsConsumeResult, StreamsEventsConsumeParams, StreamsEventType, StreamsEventPayload, StreamsEvent, StreamsDumpsManifest, StreamsDumps, StreamsDumpFile, StreamsConsumeParams, StreamsClient, StreamsCanonicalBlock, StreamsBatchContext, StreamsBatch, StackingWalkParams, StackingListParams, StackingEnvelope, SelectOfferOptions, SecondLayerOptions, SecondLayer, ScopedKeyProduct, RotateSecretResponse2 as RotateSecretResponse, RewardSet2 as RewardSet, ReplayResult2 as ReplayResult, RateLimitError, Projects, ProjectTeamMember, ProjectTeam, ProjectInvitation, Project, PayAndRetryOptions, NftTransfersWalkParams, NftTransfersResource, NftTransfersListParams, NftTransfersEnvelope, NftTransferPayload, NftTransferEvent, NftTransfer, MempoolWalkParams, MempoolTransactionEnvelope, MempoolListParams, MempoolEnvelope, IndexUsage, IndexTransaction, IndexTip, IndexStackingAction, IndexReorg, IndexPostCondition, IndexMempoolTransaction, IndexEventsResource, IndexEventTypeFilters, IndexEventType, IndexEvent, IndexDiscovery, IndexContractCall, IndexCanonicalBlock, IndexBlock, Index, FtTransfersWalkParams, FtTransfersResource, FtTransfersListParams, FtTransfersEnvelope, FtTransferPayload, FtTransferEvent, FtTransfer, FetchLike2 as FetchLike, EventsWalkParams, EventsListParams, EventsEnvelope, DeliveryRow2 as DeliveryRow, DecodedStxTransferPayload, DecodedStxTransfer, DecodedStxMintPayload, DecodedStxMint, DecodedStxLockPayload, DecodedStxLock, DecodedStxBurnPayload, DecodedStxBurn, DecodedPrintValue, DecodedPrintPayload, DecodedPrint, DecodedNftTransferPayload, DecodedNftTransfer, DecodedNftMintPayload, DecodedNftMint, DecodedNftBurnPayload, DecodedNftBurn, DecodedFtTransferPayload, DecodedFtTransfer, DecodedFtMintPayload, DecodedFtMint, DecodedFtBurnPayload, DecodedFtBurn, DecodedEventRow, DecodedEventColumns, DeadRow2 as DeadRow, DEFAULT_PREFER_ASSETS, Cursor, CreateSubscriptionResponse2 as CreateSubscriptionResponse, CreateSubscriptionRequest2 as CreateSubscriptionRequest, CreateProjectParams, CreateApiKeyResponse, CreateApiKeyParams, ContractsListParams, ContractsEnvelope, Contracts, ContractSummary, ContractConformance, ContractCallsWalkParams, ContractCallsListParams, ContractCallsEnvelope, ContextSnapshot, ContextProject, ContextApiKey, ContextAccount, ChainTriggerType, ChainTrigger, CanonicalWalkParams, CanonicalListParams, CanonicalEnvelope, ByoBreakingChangeError, ByoBreakingChangeDetails, BuildSignedX402PaymentOptions, BlocksWalkParams, BlocksListParams, BlocksEnvelope, BlockEnvelope, AuthError, ApiKeys, ApiKeySummary, ApiError, ActiveSubgraphOperation };

package/dist/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 [
@@ -2259,15 +2102,60 @@ async function buildSignedX402Payment(opts) {
   return { header, accept };
 }
 function withX402(baseFetch, opts) {
-  return async (input, init) => {
+  const sessions = new Map;
+  let balanceToken = opts.balanceToken ?? null;
+  let toppingUp = false;
+  const originOf = (input) => {
+    try {
+      return new URL(String(input)).origin;
+    } catch {
+      return "";
+    }
+  };
+  const wrapped = async (input, init) => {
+    const origin = originOf(input);
     const run = (extra, signal2) => baseFetch(input, {
       ...init,
       headers: { ...init?.headers, ...extra },
       ...signal2 ? { signal: signal2 } : {}
     });
-    const first = await run({});
+    const maybeTopUp = (res) => {
+      const policy = opts.topUp;
+      if (!policy || toppingUp || !origin)
+        return;
+      const remaining = res.headers.get("X-BALANCE-REMAINING-USD");
+      if (remaining === null || Number(remaining) >= policy.whenBelow)
+        return;
+      toppingUp = true;
+      (async () => {
+        try {
+          const dep = await wrapped(`${origin}/v1/x402/deposit?usd=${policy.usd}`, { method: "POST" });
+          if (dep.ok) {
+            const body = await dep.json();
+            if (body.balance_token)
+              balanceToken = body.balance_token;
+          }
+        } catch {} finally {
+          toppingUp = false;
+        }
+      })();
+    };
+    const remember = (res) => {
+      const voucher = res.headers.get("PAYMENT-SESSION");
+      if (voucher && origin)
+        sessions.set(origin, voucher);
+      maybeTopUp(res);
+      return res;
+    };
+    const cached = origin ? sessions.get(origin) : undefined;
+    const first = await run({
+      ...cached ? { "PAYMENT-SESSION": cached } : {},
+      ...balanceToken ? { "PAYMENT-BALANCE": balanceToken } : {}
+    });
     if (first.status !== 402)
-      return first;
+      return remember(first);
+    if (cached && origin)
+      sessions.delete(origin);
     const challenge = await readX402Challenge(first);
     if (!challenge)
       return first;
@@ -2282,8 +2170,9 @@ function withX402(baseFetch, opts) {
     });
     opts.onSettling?.({ asset: accept.asset, amount: accept.amount });
     const signal = opts.timeoutMs ? AbortSignal.timeout(opts.timeoutMs) : undefined;
-    return run({ "PAYMENT-SIGNATURE": header }, signal);
+    return remember(await run({ "PAYMENT-SIGNATURE": header }, signal));
   };
+  return wrapped;
 }
 function createX402Client(opts) {
   const f = withX402(opts.fetch ?? fetch, opts);
@@ -2496,16 +2385,14 @@ export {
   RateLimitError,
   Projects,
   Index,
-  Datasets,
   DEFAULT_PREFER_ASSETS,
   Cursor,
   Contracts,
-  CURSOR_SLUGS,
   ByoBreakingChangeError,
   AuthError,
   ApiKeys,
   ApiError
 };
 
-//# debugId=EFE64A13154F57C864756E2164756E21
+//# debugId=EAC231197163FBBB64756E2164756E21
 //# sourceMappingURL=index.js.map