@secondlayer/sdk 14.2.0 → 14.3.0

package/dist/subgraphs/index.d.ts

@@ -1843,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 = {
@@ -2854,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: {
@@ -2923,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

@@ -1711,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),
@@ -1906,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 });
   }
@@ -2806,5 +2823,5 @@ export {
   getSubgraph
 };
 
-//# debugId=DD76B5EA212EEC4D64756E2164756E21
+//# debugId=3252B7843081BB3A64756E2164756E21
 //# sourceMappingURL=index.js.map