@secondlayer/sdk 15.4.2 → 15.5.0

package/dist/subgraphs/index.d.ts

@@ -1747,6 +1747,13 @@ type FtTransfersEnvelope<TRow = FtTransfer> = {
 type FtTransferAlwaysFields = "cursor" | "block_height" | "event_type";
 /** An ft-transfer row narrowed to the requested columns plus the always-present ones. */
 type FtTransferFields<F extends keyof FtTransfer & string> = Pick<FtTransfer, (F | FtTransferAlwaysFields) & keyof FtTransfer>;
+/**
+* Read direction for decoded-event lists. `"asc"` (default) reads oldest
+* first. `"desc"` reads newest first: with no height range, page one is the
+* newest rows of the last day, and `next_cursor` pages older. A cursor only
+* resumes under the order that issued it; the API refuses the other order.
+*/
+type IndexOrder = "asc" | "desc";
 /** Column selection, paging, and filters for listing token transfers. */
 type FtTransfersListParams = {
 	/**
@@ -1765,6 +1772,8 @@ type FtTransfersListParams = {
 	recipient?: string;
 	fromHeight?: number;
 	toHeight?: number;
+	/** `"desc"` reads newest first. See {@link IndexOrder}. */
+	order?: IndexOrder;
 };
 /** Options every `walk*` feed shares on top of its list filters. Page fetches
 *  retry with the same `retryCount`/`retryDelay`/`onError` vocabulary as
@@ -1820,6 +1829,8 @@ type NftTransfersListParams = {
 	recipient?: string;
 	fromHeight?: number;
 	toHeight?: number;
+	/** `"desc"` reads newest first. See {@link IndexOrder}. */
+	order?: IndexOrder;
 };
 /** `NftTransfersListParams` without `limit`, plus walk options. */
 type NftTransfersWalkParams = Omit<NftTransfersListParams, "limit"> & WalkOptions;
@@ -2006,6 +2017,8 @@ type EventsListParams<T extends IndexEventType = IndexEventType> = {
 	txId?: string;
 	fromHeight?: number;
 	toHeight?: number;
+	/** `"desc"` reads newest first. See {@link IndexOrder}. */
+	order?: IndexOrder;
 	/** Restrict to contracts conforming to a trait/standard (e.g. "sip-010").
 	*  Mutually exclusive with contractId; contract-keyed event types only. */
 	trait?: string;
@@ -2035,7 +2048,7 @@ type EventsWalkParams<T extends IndexEventType = IndexEventType> = Omit<EventsLi
 type EventsConsumeParams<
 	T extends IndexEventType = IndexEventType,
 	TTx = never
-> = Omit<EventsListParams<T>, "cursor" | "fromCursor" | "limit" | "fields"> & IndexConsumeOptions<IndexEventOf<T>, EventsEnvelope<T>, TTx>;
+> = Omit<EventsListParams<T>, "cursor" | "fromCursor" | "limit" | "fields" | "order"> & IndexConsumeOptions<IndexEventOf<T>, EventsEnvelope<T>, TTx>;
 /** A decoded contract call: contract, function, sender, arguments, result. */
 type IndexContractCall = {
 	cursor: string;
@@ -3215,7 +3228,7 @@ interface FtTransfersResource {
 	/**
 	* Read one page of fungible-token transfers, plus the cursor for the next.
 	*
-	* Filter by `contractId`, `assetIdentifier`, `sender`, `recipient`, and a height range. Filters are equality only: there is no amount filter. Pass `next_cursor` back as `cursor` to continue. `fields` returns only those columns and narrows the row type; `cursor`, `block_height`, and `event_type` always come back. `reorgs` on the envelope lists forks that overlap the page.
+	* Filter by `contractId`, `assetIdentifier`, `sender`, `recipient`, and a height range. Filters are equality only: there is no amount filter. `order: "desc"` reads newest first. Pass `next_cursor` back as `cursor` to continue. `fields` returns only those columns and narrows the row type; `cursor`, `block_height`, and `event_type` always come back. `reorgs` on the envelope lists forks that overlap the page.
 	*/
 	list<const F extends keyof FtTransfer & string>(params: FtTransfersListParams & {
 		fields: readonly F[];
@@ -3224,7 +3237,7 @@ interface FtTransfersResource {
 	/**
 	* Iterate every fungible-token transfer, paging for you.
 	*
-	* Takes the same filters as `list`. Not a live index: it does not checkpoint, ignores reorgs, and ends when it catches the tip. `batchSize` defaults to 200 (max 1000); page fetches retry on 429 and 5xx; aborting `signal` rejects the iterator.
+	* Takes the same filters as `list`. Not a live index: it does not checkpoint, ignores reorgs, and ends when it catches the tip, or with `order: "desc"` when it reaches `fromHeight` (genesis by default). `batchSize` defaults to 200 (max 1000); page fetches retry on 429 and 5xx; aborting `signal` rejects the iterator.
 	*/
 	walk<const F extends keyof FtTransfer & string>(params: FtTransfersWalkParams & {
 		fields: readonly F[];
@@ -3242,7 +3255,7 @@ interface NftTransfersResource {
 	/**
 	* Read one page of NFT transfers, plus the cursor for the next.
 	*
-	* Filter by `contractId`, `assetIdentifier`, `sender`, `recipient`, and a height range. Pass `next_cursor` back as `cursor` to continue. `fields` returns only those columns and narrows the row type; `cursor`, `block_height`, and `event_type` always come back.
+	* Filter by `contractId`, `assetIdentifier`, `sender`, `recipient`, and a height range. `order: "desc"` reads newest first. Pass `next_cursor` back as `cursor` to continue. `fields` returns only those columns and narrows the row type; `cursor`, `block_height`, and `event_type` always come back.
 	*/
 	list<const F extends keyof NftTransfer & string>(params: NftTransfersListParams & {
 		fields: readonly F[];
@@ -3251,7 +3264,7 @@ interface NftTransfersResource {
 	/**
 	* Iterate every NFT transfer, paging for you.
 	*
-	* Takes the same filters as `list`. Not a live index: it does not checkpoint, ignores reorgs, and ends when it catches the tip. `batchSize` defaults to 200 (max 1000); page fetches retry on 429 and 5xx; aborting `signal` rejects the iterator.
+	* Takes the same filters as `list`. Not a live index: it does not checkpoint, ignores reorgs, and ends when it catches the tip, or with `order: "desc"` when it reaches `fromHeight` (genesis by default). `batchSize` defaults to 200 (max 1000); page fetches retry on 429 and 5xx; aborting `signal` rejects the iterator.
 	*/
 	walk<const F extends keyof NftTransfer & string>(params: NftTransfersWalkParams & {
 		fields: readonly F[];
@@ -3272,7 +3285,7 @@ interface IndexEventsResource {
 	/**
 	* Read one page of decoded events of one type.
 	*
-	* `eventType` is required: a decoded type (`ft_transfer`, `print`, ...) or a VM type (`nested_contract_call`, `map_set`, ...), and a literal narrows the row type. Scope with `contractId` (one id or up to 20) or `trait`, never both, plus `assetIdentifier`, `sender`, `recipient`, `functionName`, `caller`, `map`, `varName`, `txId`, and a height range. `txContext: true` joins the submitting transaction onto each event. `fields` returns only those columns and narrows the row type; it saves wire bytes but does not change what you are billed, since rows are metered, not columns.
+	* `eventType` is required: a decoded type (`ft_transfer`, `print`, ...) or a VM type (`nested_contract_call`, `map_set`, ...), and a literal narrows the row type. Scope with `contractId` (one id or up to 20) or `trait`, never both, plus `assetIdentifier`, `sender`, `recipient`, `functionName`, `caller`, `map`, `varName`, `txId`, and a height range. `order: "desc"` reads newest first. `txContext: true` joins the submitting transaction onto each event. `fields` returns only those columns and narrows the row type; it saves wire bytes but does not change what you are billed, since rows are metered, not columns.
 	*/
 	list<
 		T extends IndexEventType,
@@ -3284,7 +3297,7 @@ interface IndexEventsResource {
 	/**
 	* Iterate every decoded event of one type, paging for you.
 	*
-	* Takes the same filters as `list`, including `eventType`. Not a live index: it does not checkpoint, ignores reorgs, and ends when it catches the tip. `batchSize` defaults to 200 (max 1000); page fetches retry on 429 and 5xx; aborting `signal` rejects the iterator.
+	* Takes the same filters as `list`, including `eventType`. Not a live index: it does not checkpoint, ignores reorgs, and ends when it catches the tip, or with `order: "desc"` when it reaches `fromHeight` (genesis by default). `batchSize` defaults to 200 (max 1000); page fetches retry on 429 and 5xx; aborting `signal` rejects the iterator.
 	*/
 	walk<
 		T extends IndexEventType,

package/dist/subgraphs/index.js

@@ -1666,7 +1666,8 @@ function indexPageQuery(params) {
     limit: params.limit,
     from_height: params.fromHeight,
     to_height: params.toHeight,
-    fields: params.fields
+    fields: params.fields,
+    order: params.order
   };
 }
 
@@ -2842,5 +2843,5 @@ export {
   getSubgraph
 };
 
-//# debugId=B52CC2088456848264756E2164756E21
+//# debugId=9138C23A8DEF74B764756E2164756E21
 //# sourceMappingURL=index.js.map