@secondlayer/sdk 14.1.0 → 14.3.0

package/dist/subgraphs/index.d.ts

@@ -6,10 +6,13 @@ type FetchLike = (input: string | URL | Request, init?: RequestInit) => Promise<
 interface SecondLayerOptions {
 	/** Base URL of the instance API (trailing slashes are stripped). */
 	baseUrl: string;
-	/** Bearer token for authenticated instance requests (`INSTANCE_TOKEN`). */
+	/** Bearer token for authenticated requests. Defaults to
+	*  `SECONDLAYER_API_KEY` on `api.secondlayer.tools`, `INSTANCE_TOKEN`
+	*  elsewhere. */
 	apiKey?: string;
 	/** Hosted account key (`sk-sl_*`). Env `SECONDLAYER_API_KEY`. Used by
-	*  `sl.archive` quote/fetch/credits, never by instance `/v1` or `/api`. */
+	*  `sl.archive` quote/fetch/credits; reaches `/v1` and `/api` only through
+	*  `apiKey` when the base URL is the hosted API. */
 	accountKey?: string;
 	/** Fetch implementation. Tests and edge runtimes can provide their own. */
 	fetchImpl?: FetchLike;
@@ -1840,6 +1843,37 @@ type CanonicalListParams = {
 	toHeight?: number;
 };
 type CanonicalWalkParams = Omit<CanonicalListParams, "limit"> & WalkOptions;
+/** One MARF write a block committed, in the node's write order. Present only
+*  from the height the instance's node subscribed to `state_writes`. */
+type IndexStateWrite = {
+	/** `<block_height>:<ordinal>`. */
+	cursor: string;
+	block_height: number;
+	/** Position in the block's write order: a separate clock from
+	*  `event_index`. */
+	ordinal: number;
+	/** Null for block-level writes. */
+	tx_index: number | null;
+	/** Full MARF key, e.g. `vm::<contract>::0::map::<hex>`. */
+	key: string;
+	value_hex: string;
+};
+type StateWritesEnvelope = {
+	state_writes: IndexStateWrite[];
+	next_cursor: string | null;
+	tip: IndexTip;
+	reorgs: IndexReorg[];
+};
+type StateWritesListParams = {
+	cursor?: string | null;
+	fromCursor?: string | null;
+	limit?: number;
+	fromHeight?: number;
+	toHeight?: number;
+	/** One block. Excludes `fromHeight`/`toHeight`; a cursor must sit at it. */
+	blockHeight?: number;
+};
+type StateWritesWalkParams = Omit<StateWritesListParams, "limit"> & WalkOptions;
 /** A block resource. Metadata is intentionally thin — only chain-linkage and
 *  burn-anchor fields are persisted (no miner / tx_count / signer). */
 type IndexBlock = {
@@ -2851,6 +2885,11 @@ declare class Index extends BaseClient {
 		list: (params?: CanonicalListParams) => Promise<CanonicalEnvelope>;
 		walk: (params?: CanonicalWalkParams) => AsyncIterable<IndexCanonicalBlock>;
 	};
+	/** Exact MARF writes per canonical block (`/v1/index/state-writes`). */
+	readonly stateWrites: {
+		list: (params?: StateWritesListParams) => Promise<StateWritesEnvelope>;
+		walk: (params?: StateWritesWalkParams) => AsyncIterable<IndexStateWrite>;
+	};
 	/** Canonical blocks: paginated `list`/`walk`, plus `get` by height or hash
 	*  (resolves to null on 404). */
 	readonly blocks: {
@@ -2920,6 +2959,8 @@ declare class Index extends BaseClient {
 	private walkContractCalls;
 	private listCanonical;
 	private walkCanonical;
+	private listStateWrites;
+	private walkStateWrites;
 	private listBlocks;
 	private getBlock;
 	private walkBlocks;

package/dist/subgraphs/index.js

@@ -208,13 +208,20 @@ function resolveBaseUrl(explicit) {
   }
   return LOCAL_API_URL;
 }
-function resolveApiKey(apiKey) {
+function isHostedApiUrl(url) {
+  try {
+    return new URL(url).hostname === "api.secondlayer.tools";
+  } catch {
+    return false;
+  }
+}
+function resolveApiKey(apiKey, baseUrl) {
   if (apiKey !== undefined)
     return apiKey;
   if (typeof process === "undefined")
     return;
-  const token = process.env?.INSTANCE_TOKEN || undefined;
-  return token;
+  const name = baseUrl !== undefined && isHostedApiUrl(baseUrl) ? ACCOUNT_KEY_ENV : INSTANCE_TOKEN_ENV;
+  return process.env?.[name] || undefined;
 }
 function resolveAccountKey(accountKey) {
   if (accountKey !== undefined)
@@ -272,7 +279,7 @@ class BaseClient {
   etagCache;
   constructor(options = {}) {
     this.baseUrl = resolveBaseUrl(options.baseUrl);
-    this.apiKey = resolveApiKey(options.apiKey);
+    this.apiKey = resolveApiKey(options.apiKey, this.baseUrl);
     this.origin = options.origin ?? "cli";
     this.requestTimeoutMs = options.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
     this.fetchImpl = options.fetchImpl ?? ((...args) => fetch(...args));
@@ -1704,6 +1711,10 @@ class Index extends BaseClient {
     list: (params = {}) => this.listCanonical(params),
     walk: (params = {}) => this.walkCanonical(params)
   };
+  stateWrites = {
+    list: (params = {}) => this.listStateWrites(params),
+    walk: (params = {}) => this.walkStateWrites(params)
+  };
   blocks = {
     list: (params = {}) => this.listBlocks(params),
     walk: (params = {}) => this.walkBlocks(params),
@@ -1899,6 +1910,19 @@ class Index extends BaseClient {
   walkCanonical(params = {}) {
     return this.keysetWalk(params, (page) => this.listCanonical({ ...params, ...page }), (e) => e.canonical);
   }
+  async listStateWrites(params = {}) {
+    return this.request("GET", `/v1/index/state-writes${buildQuery({
+      ...indexPageQuery(params),
+      block_height: params.blockHeight
+    })}`, undefined, { signal: params.signal });
+  }
+  walkStateWrites(params = {}) {
+    return this.keysetWalk(params, (page) => this.listStateWrites({
+      ...params,
+      ...page,
+      fromHeight: params.blockHeight === undefined ? page.fromHeight : undefined
+    }), (e) => e.state_writes);
+  }
   async listBlocks(params = {}) {
     return this.request("GET", `/v1/index/blocks${buildQuery(indexPageQuery(params))}`, undefined, { signal: params.signal });
   }
@@ -2303,7 +2327,7 @@ function isLoopbackUrl(baseUrl) {
 }
 function createStreamsClient(options) {
   const baseUrl = normalizeBaseUrl(resolveBaseUrl(options.baseUrl));
-  const apiKey = resolveApiKey(options.apiKey);
+  const apiKey = resolveApiKey(options.apiKey, baseUrl);
   const origin = options.origin ?? "cli";
   const authHeaders = () => ({
     "x-sl-origin": origin,
@@ -2799,5 +2823,5 @@ export {
   getSubgraph
 };
 
-//# debugId=553F4BC532FBAFDA64756E2164756E21
+//# debugId=3252B7843081BB3A64756E2164756E21
 //# sourceMappingURL=index.js.map