@xyo-network/xl1-protocol 5.0.3 → 5.0.6

package/dist/neutral/modules/network-model/staticRest/layout/index.d.ts

@@ -3,4 +3,5 @@ export * from './chainManifest.js';
 export * from './evmEventIndex.js';
 export * from './indexManifest.js';
 export * from './networkStakeRewardsIndex.js';
+export * from './transactionInclusionIndex.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/neutral/modules/network-model/staticRest/layout/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/network-model/staticRest/layout/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAA;AAC1C,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,+BAA+B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/network-model/staticRest/layout/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAA;AAC1C,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,gCAAgC,CAAA"}

package/dist/neutral/modules/network-model/staticRest/layout/transactionInclusionIndex.d.ts

@@ -0,0 +1,100 @@
+import { z } from 'zod';
+/** Versioned identifier for the finalized transaction-inclusion index layout. */
+export declare const TRANSACTION_INCLUSION_INDEX_LAYOUT: "transaction-inclusions-v1";
+/** Static descriptor for the transaction-inclusion index. */
+export declare const TransactionInclusionManifestZod: z.ZodObject<{
+    chain: import("zod/mini").ZodMiniPipe<import("zod/mini").ZodMiniString<string>, import("zod/mini").ZodMiniTransform<import("@ariestools/sdk").BrandedHex, string>>;
+    layout: z.ZodLiteral<"transaction-inclusions-v1">;
+    path: z.ZodString;
+}, z.core.$strip>;
+/** Static descriptor for the transaction-inclusion index. */
+export type TransactionInclusionManifest = z.infer<typeof TransactionInclusionManifestZod>;
+/** Mutable pointer written after every transaction inclusion through `block` is durable. */
+export declare const TransactionInclusionHeadZod: z.ZodObject<{
+    block: z.ZodPipe<z.ZodInt, z.ZodTransform<import('../../../protocol-model/index.js').XL1BlockNumber, number>>;
+    blockHash: import("zod/mini").ZodMiniPipe<import("zod/mini").ZodMiniString<string>, import("zod/mini").ZodMiniTransform<import("@ariestools/sdk").BrandedHash, string>>;
+    chain: import("zod/mini").ZodMiniPipe<import("zod/mini").ZodMiniString<string>, import("zod/mini").ZodMiniTransform<import("@ariestools/sdk").BrandedHex, string>>;
+    entries: z.ZodInt;
+    layout: z.ZodLiteral<"transaction-inclusions-v1">;
+}, z.core.$strip>;
+/** Mutable transaction-inclusion progress pointer. */
+export type TransactionInclusionHead = z.infer<typeof TransactionInclusionHeadZod>;
+/** Type guard that checks whether a value is a valid transaction-inclusion manifest. */
+export declare const isTransactionInclusionManifest: <T>(value: T) => value is T & {
+    chain: import("@ariestools/sdk").BrandedHex;
+    layout: "transaction-inclusions-v1";
+    path: string;
+};
+/** Converts a value to a transaction-inclusion manifest, throwing when invalid. */
+export declare const asTransactionInclusionManifest: {
+    <T>(value: T): (T & {
+        chain: import("@ariestools/sdk").BrandedHex;
+        layout: "transaction-inclusions-v1";
+        path: string;
+    }) | undefined;
+    <T>(value: T, assert: import("@ariestools/sdk").ZodFactoryConfig): T & {
+        chain: import("@ariestools/sdk").BrandedHex;
+        layout: "transaction-inclusions-v1";
+        path: string;
+    };
+};
+/** Converts a value to a transaction-inclusion manifest, returning undefined when invalid. */
+export declare const toTransactionInclusionManifest: {
+    (value: unknown): {
+        chain: import("@ariestools/sdk").BrandedHex;
+        layout: "transaction-inclusions-v1";
+        path: string;
+    } | undefined;
+    (value: unknown, assert: import("@ariestools/sdk").ZodFactoryConfig): {
+        chain: import("@ariestools/sdk").BrandedHex;
+        layout: "transaction-inclusions-v1";
+        path: string;
+    };
+};
+/** Type guard that checks whether a value is a valid transaction-inclusion head. */
+export declare const isTransactionInclusionHead: <T>(value: T) => value is T & {
+    block: import('../../../protocol-model/index.js').XL1BlockNumber;
+    blockHash: import("@ariestools/sdk").BrandedHash;
+    chain: import("@ariestools/sdk").BrandedHex;
+    entries: number;
+    layout: "transaction-inclusions-v1";
+};
+/** Converts a value to a transaction-inclusion head, throwing when invalid. */
+export declare const asTransactionInclusionHead: {
+    <T>(value: T): (T & {
+        block: import('../../../protocol-model/index.js').XL1BlockNumber;
+        blockHash: import("@ariestools/sdk").BrandedHash;
+        chain: import("@ariestools/sdk").BrandedHex;
+        entries: number;
+        layout: "transaction-inclusions-v1";
+    }) | undefined;
+    <T>(value: T, assert: import("@ariestools/sdk").ZodFactoryConfig): T & {
+        block: import('../../../protocol-model/index.js').XL1BlockNumber;
+        blockHash: import("@ariestools/sdk").BrandedHash;
+        chain: import("@ariestools/sdk").BrandedHex;
+        entries: number;
+        layout: "transaction-inclusions-v1";
+    };
+};
+/** Converts a value to a transaction-inclusion head, returning undefined when invalid. */
+export declare const toTransactionInclusionHead: {
+    (value: unknown): {
+        block: import('../../../protocol-model/index.js').XL1BlockNumber;
+        blockHash: import("@ariestools/sdk").BrandedHash;
+        chain: import("@ariestools/sdk").BrandedHex;
+        entries: number;
+        layout: "transaction-inclusions-v1";
+    } | undefined;
+    (value: unknown, assert: import("@ariestools/sdk").ZodFactoryConfig): {
+        block: import('../../../protocol-model/index.js').XL1BlockNumber;
+        blockHash: import("@ariestools/sdk").BrandedHash;
+        chain: import("@ariestools/sdk").BrandedHex;
+        entries: number;
+        layout: "transaction-inclusions-v1";
+    };
+};
+/** Builds the static descriptor for a chain's transaction-inclusion index. */
+export declare function createTransactionInclusionManifest(chain: TransactionInclusionManifest['chain']): TransactionInclusionManifest;
+/** Builds the mutable progress pointer for a transaction-inclusion index. */
+export declare function createTransactionInclusionHead(head: Omit<TransactionInclusionHead, 'layout'>): TransactionInclusionHead;
+//# sourceMappingURL=transactionInclusionIndex.d.ts.map

package/dist/neutral/modules/network-model/staticRest/layout/transactionInclusionIndex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactionInclusionIndex.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/network-model/staticRest/layout/transactionInclusionIndex.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAMvB,iFAAiF;AACjF,eAAO,MAAM,kCAAkC,EAAG,2BAAoC,CAAA;AAEtF,6DAA6D;AAC7D,eAAO,MAAM,+BAA+B;;;;iBAO1C,CAAA;AAEF,6DAA6D;AAC7D,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAA;AAE1F,4FAA4F;AAC5F,eAAO,MAAM,2BAA2B;;;;;;iBAWtC,CAAA;AAEF,sDAAsD;AACtD,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAA;AAElF,wFAAwF;AACxF,eAAO,MAAM,8BAA8B;;;;CAAgD,CAAA;AAC3F,mFAAmF;AACnF,eAAO,MAAM,8BAA8B;;;;;;;;;;;CAG1C,CAAA;AACD,8FAA8F;AAC9F,eAAO,MAAM,8BAA8B;;;;;;;;;;;CAG1C,CAAA;AAED,oFAAoF;AACpF,eAAO,MAAM,0BAA0B;;;;;;CAA4C,CAAA;AACnF,+EAA+E;AAC/E,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;CAGtC,CAAA;AACD,0FAA0F;AAC1F,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;CAGtC,CAAA;AAED,8EAA8E;AAC9E,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,4BAA4B,CAAC,OAAO,CAAC,GAC3C,4BAA4B,CAM9B;AAED,6EAA6E;AAC7E,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,IAAI,CAAC,wBAAwB,EAAE,QAAQ,CAAC,GAC7C,wBAAwB,CAK1B"}

package/dist/neutral/modules/network-model/staticRest/paths/index.d.ts

@@ -3,4 +3,5 @@ export * from './evmEventIndex.js';
 export * from './finalized.js';
 export * from './indexPaths.js';
 export * from './networkStakeRewardsIndex.js';
+export * from './transactionInclusionIndex.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/neutral/modules/network-model/staticRest/paths/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/network-model/staticRest/paths/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,+BAA+B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/network-model/staticRest/paths/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,+BAA+B,CAAA;AAC7C,cAAc,gCAAgC,CAAA"}

package/dist/neutral/modules/network-model/staticRest/paths/transactionInclusionIndex.d.ts

@@ -0,0 +1,8 @@
+import type { Hash } from '@ariestools/sdk';
+/** Path of one immutable transaction-hash to finalized-block inclusion record. */
+export declare function transactionInclusionPath(transactionHash: Hash): string;
+/** Path of the mutable transaction-inclusion progress pointer. */
+export declare function transactionInclusionHeadPath(): string;
+/** Path of the transaction-inclusion layout descriptor. */
+export declare function transactionInclusionManifestPath(): string;
+//# sourceMappingURL=transactionInclusionIndex.d.ts.map

package/dist/neutral/modules/network-model/staticRest/paths/transactionInclusionIndex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactionInclusionIndex.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/network-model/staticRest/paths/transactionInclusionIndex.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAI3C,kFAAkF;AAClF,wBAAgB,wBAAwB,CAAC,eAAe,EAAE,IAAI,GAAG,MAAM,CAEtE;AAED,kEAAkE;AAClE,wBAAgB,4BAA4B,IAAI,MAAM,CAErD;AAED,2DAA2D;AAC3D,wBAAgB,gCAAgC,IAAI,MAAM,CAEzD"}

package/dist/neutral/modules/network-model/staticRest/templates.d.ts

@@ -24,4 +24,6 @@ export declare function chainManifestPathTemplates(): {
 };
 /** Self-describing template for one index summary family, e.g. `blocks/{level}/{index}.json`. */
 export declare function indexSummaryPathTemplate(family: IndexSummaryFamily): string;
+/** Self-describing template for the hash-addressed transaction-inclusion lookup. */
+export declare function transactionInclusionPathTemplate(): string;
 //# sourceMappingURL=templates.d.ts.map

package/dist/neutral/modules/network-model/staticRest/templates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../../../../src/modules/network-model/staticRest/templates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAgBvD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,MAAM,CAS/F;AAED,6FAA6F;AAC7F,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,MAAM,CAMzG;AAED,sDAAsD;AACtD,eAAO,MAAM,uBAAuB,QAAO,MACwE,CAAA;AAEnH,oDAAoD;AACpD,eAAO,MAAM,qBAAqB,QAAO,MAC6D,CAAA;AAEtG,kDAAkD;AAClD,eAAO,MAAM,mBAAmB,QAAO,MAC6D,CAAA;AAEpG,iGAAiG;AACjG,wBAAgB,0BAA0B,IAAI;IAC5C,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,MAAM,CAAA;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB,CAOA;AAED,iGAAiG;AACjG,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAM3E"}
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../../../../src/modules/network-model/staticRest/templates.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAiBvD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,MAAM,CAS/F;AAED,6FAA6F;AAC7F,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,MAAM,CAMzG;AAED,sDAAsD;AACtD,eAAO,MAAM,uBAAuB,QAAO,MACwE,CAAA;AAEnH,oDAAoD;AACpD,eAAO,MAAM,qBAAqB,QAAO,MAC6D,CAAA;AAEtG,kDAAkD;AAClD,eAAO,MAAM,mBAAmB,QAAO,MAC6D,CAAA;AAEpG,iGAAiG;AACjG,wBAAgB,0BAA0B,IAAI;IAC5C,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,MAAM,CAAA;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB,CAOA;AAED,iGAAiG;AACjG,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAM3E;AAED,oFAAoF;AACpF,wBAAgB,gCAAgC,IAAI,MAAM,CAIzD"}

package/dist/neutral/modules/protocol-lib/viewers/Block.d.ts

@@ -13,6 +13,8 @@ export interface BlockViewerEventData extends EventData {
 }
 /** Batch block and payload queries shared by block-viewer implementations. */
 export interface BlockViewerMethods {
+    /** Returns the finalized block containing a transaction hash, or null when it is not indexed. */
+    blockByTransactionHash(transactionHash: Hash): Promisable<SignedHydratedBlockWithHashMeta | null>;
     /**
      * Up to `limit` blocks ending at the block with `hash`, walking **descending**
      * via each block's `previous` link (newest first) — `hash` is the window's

package/dist/neutral/modules/protocol-lib/viewers/Block.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Block.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-lib/viewers/Block.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Block.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-lib/viewers/Block.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,EAC1C,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAE7D,OAAO,KAAK,EACV,SAAS,EAAE,OAAO,EAClB,QAAQ,EAAE,eAAe,EAAE,+BAA+B,EAAE,gBAAgB,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAC3H,MAAM,iBAAiB,CAAA;AAExB,uDAAuD;AACvD,MAAM,WAAW,2BAA2B;IAC1C,0CAA0C;IAC1C,KAAK,EAAE,+BAA+B,CAAA;CACvC;AAED,2CAA2C;AAC3C,MAAM,WAAW,oBAAqB,SAAQ,SAAS;IACrD,0DAA0D;IAC1D,WAAW,EAAE,2BAA2B,CAAA;CACzC;AAED,8EAA8E;AAC9E,MAAM,WAAW,kBAAkB;IACjC,iGAAiG;IACjG,sBAAsB,CAAC,eAAe,EAAE,IAAI,GAAG,UAAU,CAAC,+BAA+B,GAAG,IAAI,CAAC,CAAA;IACjG;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC,+BAA+B,EAAE,CAAC,CAAA;IACvF;;;;;;;;;;OAUG;IACH,cAAc,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC,+BAA+B,EAAE,CAAC,CAAA;IACpG,0EAA0E;IAC1E,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU,CAAC,+BAA+B,EAAE,CAAC,CAAA;IACjG,0DAA0D;IAC1D,YAAY,IAAI,UAAU,CAAC,+BAA+B,CAAC,CAAA;IAC3D,kGAAkG;IAClG,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,UAAU,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;CACpE;AAED,uDAAuD;AACvD,eAAO,MAAM,kBAAkB,EAAG,aAAsB,CAAA;AACxD,yDAAyD;AACzD,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAA;AAE1D,+CAA+C;AAC/C,MAAM,WAAW,WAAW,CAAC,QAAQ,SAAS,eAAe,GAAG,kBAAkB,CAChF,SAAQ,kBAAkB,EAAE,YAAY,CAAC,oBAAoB,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC;IAClF,8EAA8E;IAC9E,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,UAAU,CAAC,+BAA+B,GAAG,IAAI,CAAC,CAAA;IAC3E,uEAAuE;IACvE,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,UAAU,CAAC,+BAA+B,GAAG,IAAI,CAAC,CAAA;IACxF,4CAA4C;IAC5C,OAAO,IAAI,UAAU,CAAC,OAAO,CAAC,CAAA;IAC9B,6DAA6D;IAC7D,OAAO,CAAC,WAAW,EAAE,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC,CAAA;IACzD,wDAAwD;IACxD,OAAO,CAAC,WAAW,EAAE,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,CAAA;IACnD,kDAAkD;IAClD,gBAAgB,IAAI,UAAU,CAAC,IAAI,CAAC,CAAA;IACpC,oDAAoD;IACpD,kBAAkB,IAAI,UAAU,CAAC,cAAc,CAAC,CAAA;IAChD,8EAA8E;IAC9E,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,UAAU,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAA;IACnE,2DAA2D;IAC3D,IAAI,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,MAAM,aAAa,GAAG,UAAU,CAAC,SAAS,CAAC,CAAA;IACjF,8EAA8E;IAC9E,YAAY,CAAC,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,aAAa,GAAG,UAAU,CAAC,SAAS,CAAC,CAAA;IAC7H,sEAAsE;IACtE,gBAAgB,CACd,UAAU,EAAE,gBAAgB,EAC5B,gBAAgB,CAAC,EAAE,cAAc,EACjC,QAAQ,CAAC,EAAE,MAAM,aAAa,EAC9B,WAAW,CAAC,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,MAAM,GACnB,UAAU,CAAC,SAAS,CAAC,CAAA;CACzB"}

package/dist/neutral/modules/protocol-lib/viewers/IndexViewer.d.ts

@@ -1,16 +1,18 @@
-import type { Promisable } from '@ariestools/sdk';
-import type { Provider, ProviderMoniker } from '../../protocol-model/index.js';
+import type { Hash, Promisable } from '@ariestools/sdk';
+import type { Provider, ProviderMoniker, TransactionInclusion } from '../../protocol-model/index.js';
 import type { IndexSummaryFamily } from '../runners/IndexPublish.js';
 /** Operations exposed by the Index Viewer contract. */
 export interface IndexViewerMethods {
     /** The published summary for a completed step in the given family, or null when not (yet) published. */
     stepSummary<T = unknown>(family: IndexSummaryFamily, stepLevel: number, stepIndex: number): Promisable<T | null>;
+    /** The finalized block position of a transaction, or null when it is not indexed. */
+    transactionInclusionByHash(transactionHash: Hash): Promisable<TransactionInclusion | null>;
 }
 /** Moniker identifier for the IndexViewer provider. */
 export declare const IndexViewerMoniker: "IndexViewer";
 /** Type literal for the IndexViewer provider moniker. */
 export type IndexViewerMoniker = typeof IndexViewerMoniker;
-/** Viewer interface for reading published step summaries (the chain index). */
+/** Viewer interface for reading derived chain indexes. */
 export interface IndexViewer<TMoniker extends ProviderMoniker = IndexViewerMoniker> extends IndexViewerMethods, Provider<TMoniker> {
 }
 //# sourceMappingURL=IndexViewer.d.ts.map

package/dist/neutral/modules/protocol-lib/viewers/IndexViewer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IndexViewer.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-lib/viewers/IndexViewer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAEhE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AAEpE,uDAAuD;AACvD,MAAM,WAAW,kBAAkB;IACjC,wGAAwG;IACxG,WAAW,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;CACjH;AAED,uDAAuD;AACvD,eAAO,MAAM,kBAAkB,EAAG,aAAsB,CAAA;AACxD,yDAAyD;AACzD,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAA;AAE1D,+EAA+E;AAC/E,MAAM,WAAW,WAAW,CAAC,QAAQ,SAAS,eAAe,GAAG,kBAAkB,CAChF,SAAQ,kBAAkB,EAAE,QAAQ,CAAC,QAAQ,CAAC;CAAG"}
+{"version":3,"file":"IndexViewer.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-lib/viewers/IndexViewer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEvD,OAAO,KAAK,EACV,QAAQ,EAAE,eAAe,EAAE,oBAAoB,EAChD,MAAM,iBAAiB,CAAA;AAExB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AAEpE,uDAAuD;AACvD,MAAM,WAAW,kBAAkB;IACjC,wGAAwG;IACxG,WAAW,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;IAChH,qFAAqF;IACrF,0BAA0B,CAAC,eAAe,EAAE,IAAI,GAAG,UAAU,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAA;CAC3F;AAED,uDAAuD;AACvD,eAAO,MAAM,kBAAkB,EAAG,aAAsB,CAAA;AACxD,yDAAyD;AACzD,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAA;AAE1D,0DAA0D;AAC1D,MAAM,WAAW,WAAW,CAAC,QAAQ,SAAS,eAAe,GAAG,kBAAkB,CAChF,SAAQ,kBAAkB,EAAE,QAAQ,CAAC,QAAQ,CAAC;CAAG"}

package/dist/neutral/modules/protocol-lib/viewers/WindowedBlock.d.ts

@@ -1,7 +1,7 @@
 import type { Hash, Promisable } from '@ariestools/sdk';
 import type { HydratedBlockWithHashMeta, Provider, ProviderMoniker } from '../../protocol-model/index.js';
 import type { BlockViewerMethods } from './Block.js';
-type ExtendableBlockViewerMethods = Omit<BlockViewerMethods, 'rate' | 'stepSizeRate' | 'timeDurationRate'>;
+type ExtendableBlockViewerMethods = Omit<BlockViewerMethods, 'blockByTransactionHash' | 'rate' | 'stepSizeRate' | 'timeDurationRate'>;
 /** Operations exposed by the Windowed Block Viewer contract. */
 export interface WindowedBlockViewerMethods extends ExtendableBlockViewerMethods {
     /** Returns the result of the blocks by transaction hashes query. */

package/dist/neutral/modules/protocol-lib/viewers/WindowedBlock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WindowedBlock.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-lib/viewers/WindowedBlock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEvD,OAAO,KAAK,EACV,yBAAyB,EAAE,QAAQ,EAAE,eAAe,EACrD,MAAM,iBAAiB,CAAA;AAExB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAEpD,KAAK,4BAA4B,GAAG,IAAI,CAAC,kBAAkB,EAAE,MAAM,GAAG,cAAc,GAAG,kBAAkB,CAAC,CAAA;AAE1G,gEAAgE;AAChE,MAAM,WAAW,0BAA2B,SAAQ,4BAA4B;IAC9E,oEAAoE;IACpE,yBAAyB,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,UAAU,CAAC,yBAAyB,EAAE,CAAC,CAAA;CACnF;AAED,+DAA+D;AAC/D,eAAO,MAAM,0BAA0B,EAAG,qBAA8B,CAAA;AACxE,iEAAiE;AACjE,MAAM,MAAM,0BAA0B,GAAG,OAAO,0BAA0B,CAAA;AAE1E,uDAAuD;AACvD,MAAM,WAAW,mBAAmB,CAAC,QAAQ,SAAS,eAAe,GAAG,0BAA0B,CAAE,SAAQ,0BAA0B,EAAE,QAAQ,CAAC,QAAQ,CAAC;IACxJ,iEAAiE;IACjE,sBAAsB,CAAC,IAAI,EAAE,IAAI,GAAG,UAAU,CAAC,yBAAyB,GAAG,IAAI,CAAC,CAAA;CACjF"}
+{"version":3,"file":"WindowedBlock.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-lib/viewers/WindowedBlock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEvD,OAAO,KAAK,EACV,yBAAyB,EAAE,QAAQ,EAAE,eAAe,EACrD,MAAM,iBAAiB,CAAA;AAExB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAEpD,KAAK,4BAA4B,GAAG,IAAI,CAAC,kBAAkB,EAAE,wBAAwB,GAAG,MAAM,GAAG,cAAc,GAAG,kBAAkB,CAAC,CAAA;AAErI,gEAAgE;AAChE,MAAM,WAAW,0BAA2B,SAAQ,4BAA4B;IAC9E,oEAAoE;IACpE,yBAAyB,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,UAAU,CAAC,yBAAyB,EAAE,CAAC,CAAA;CACnF;AAED,+DAA+D;AAC/D,eAAO,MAAM,0BAA0B,EAAG,qBAA8B,CAAA;AACxE,iEAAiE;AACjE,MAAM,MAAM,0BAA0B,GAAG,OAAO,0BAA0B,CAAA;AAE1E,uDAAuD;AACvD,MAAM,WAAW,mBAAmB,CAAC,QAAQ,SAAS,eAAe,GAAG,0BAA0B,CAAE,SAAQ,0BAA0B,EAAE,QAAQ,CAAC,QAAQ,CAAC;IACxJ,iEAAiE;IACjE,sBAAsB,CAAC,IAAI,EAAE,IAAI,GAAG,UAAU,CAAC,yBAAyB,GAAG,IAAI,CAAC,CAAA;CACjF"}

package/dist/neutral/modules/protocol-model/model/TransactionInclusion.d.ts

@@ -0,0 +1,48 @@
+import { z } from 'zod';
+/** Zod schema for the canonical position of a transaction in the finalized XL1 chain. */
+export declare const TransactionInclusionZod: z.ZodObject<{
+    blockHash: import("zod/mini").ZodMiniPipe<import("zod/mini").ZodMiniString<string>, import("zod/mini").ZodMiniTransform<import("@ariestools/sdk").BrandedHash, string>>;
+    blockNumber: z.ZodPipe<z.ZodInt, z.ZodTransform<import('../BlockNumber/xl1BlockNumber.js').XL1BlockNumber, number>>;
+    transactionHash: import("zod/mini").ZodMiniPipe<import("zod/mini").ZodMiniString<string>, import("zod/mini").ZodMiniTransform<import("@ariestools/sdk").BrandedHash, string>>;
+    transactionIndex: z.ZodInt;
+}, z.core.$strip>;
+/** Canonical position of a transaction in the finalized XL1 chain. */
+export type TransactionInclusion = z.infer<typeof TransactionInclusionZod>;
+/** Type guard that checks whether a value is a valid transaction inclusion. */
+export declare const isTransactionInclusion: <T>(value: T) => value is T & {
+    blockHash: import("@ariestools/sdk").BrandedHash;
+    blockNumber: import('../BlockNumber/xl1BlockNumber.js').XL1BlockNumber;
+    transactionHash: import("@ariestools/sdk").BrandedHash;
+    transactionIndex: number;
+};
+/** Converts a value to a transaction inclusion, throwing when invalid. */
+export declare const asTransactionInclusion: {
+    <T>(value: T): (T & {
+        blockHash: import("@ariestools/sdk").BrandedHash;
+        blockNumber: import('../BlockNumber/xl1BlockNumber.js').XL1BlockNumber;
+        transactionHash: import("@ariestools/sdk").BrandedHash;
+        transactionIndex: number;
+    }) | undefined;
+    <T>(value: T, assert: import("@ariestools/sdk").ZodFactoryConfig): T & {
+        blockHash: import("@ariestools/sdk").BrandedHash;
+        blockNumber: import('../BlockNumber/xl1BlockNumber.js').XL1BlockNumber;
+        transactionHash: import("@ariestools/sdk").BrandedHash;
+        transactionIndex: number;
+    };
+};
+/** Converts a value to a transaction inclusion, returning undefined when invalid. */
+export declare const toTransactionInclusion: {
+    (value: unknown): {
+        blockHash: import("@ariestools/sdk").BrandedHash;
+        blockNumber: import('../BlockNumber/xl1BlockNumber.js').XL1BlockNumber;
+        transactionHash: import("@ariestools/sdk").BrandedHash;
+        transactionIndex: number;
+    } | undefined;
+    (value: unknown, assert: import("@ariestools/sdk").ZodFactoryConfig): {
+        blockHash: import("@ariestools/sdk").BrandedHash;
+        blockNumber: import('../BlockNumber/xl1BlockNumber.js').XL1BlockNumber;
+        transactionHash: import("@ariestools/sdk").BrandedHash;
+        transactionIndex: number;
+    };
+};
+//# sourceMappingURL=TransactionInclusion.d.ts.map

package/dist/neutral/modules/protocol-model/model/TransactionInclusion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransactionInclusion.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-model/model/TransactionInclusion.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,yFAAyF;AACzF,eAAO,MAAM,uBAAuB;;;;;iBASlC,CAAA;AAEF,sEAAsE;AACtE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAE1E,+EAA+E;AAC/E,eAAO,MAAM,sBAAsB;;;;;CAAwC,CAAA;AAC3E,0EAA0E;AAC1E,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;CAAkE,CAAA;AACrG,qFAAqF;AACrF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;CAAkE,CAAA"}

package/dist/neutral/modules/protocol-model/model/index.d.ts

@@ -23,6 +23,7 @@ export * from './Sequence.js';
 export * from './Stake.js';
 export * from './SyncStepSummary.js';
 export * from './TimeDomain.js';
+export * from './TransactionInclusion.js';
 export * from './TransferPair.js';
 export * from './version.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/neutral/modules/protocol-model/model/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-model/model/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AACnC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,uBAAuB,CAAA;AACrC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,yBAAyB,CAAA;AACvC,cAAc,oBAAoB,CAAA;AAClC,cAAc,yBAAyB,CAAA;AACvC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,kBAAkB,CAAA;AAChC,cAAc,0BAA0B,CAAA;AACxC,cAAc,yBAAyB,CAAA;AACvC,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,uBAAuB,CAAA;AACrC,cAAc,cAAc,CAAA;AAC5B,cAAc,kBAAkB,CAAA;AAChC,cAAc,0BAA0B,CAAA;AACxC,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,sBAAsB,CAAA;AACpC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,mBAAmB,CAAA;AACjC,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-model/model/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AACnC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,uBAAuB,CAAA;AACrC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,yBAAyB,CAAA;AACvC,cAAc,oBAAoB,CAAA;AAClC,cAAc,yBAAyB,CAAA;AACvC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,kBAAkB,CAAA;AAChC,cAAc,0BAA0B,CAAA;AACxC,cAAc,yBAAyB,CAAA;AACvC,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,uBAAuB,CAAA;AACrC,cAAc,cAAc,CAAA;AAC5B,cAAc,kBAAkB,CAAA;AAChC,cAAc,0BAA0B,CAAA;AACxC,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,sBAAsB,CAAA;AACpC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,2BAA2B,CAAA;AACzC,cAAc,mBAAmB,CAAA;AACjC,cAAc,cAAc,CAAA"}

package/dist/neutral/network-model.mjs

@@ -151,6 +151,9 @@ import {
 } from "@ariestools/sdk";
 import { z as z2 } from "zod";
 
+// src/modules/network-model/staticRest/templates.ts
+import { asHash } from "@ariestools/sdk";
+
 // src/modules/network-model/staticRest/paths/chainState.ts
 var headPath = () => "chain/head.json";
 var chainContractByIdPath = (chainId) => `chain/contracts/${chainId.toLowerCase()}.json`;
@@ -166,10 +169,22 @@ var indexSummaryPath = (family, stepLevel, stepIndex) => `${family}/${stepLevel}
 var indexManifestPath = () => "manifest.json";
 var indexHeadPath = () => "head.json";
 
+// src/modules/network-model/staticRest/paths/transactionInclusionIndex.ts
+var TRANSACTION_INCLUSION_ROOT = "transactions";
+function transactionInclusionPath(transactionHash) {
+  return `${TRANSACTION_INCLUSION_ROOT}/by-hash/${transactionHash}.json`;
+}
+function transactionInclusionHeadPath() {
+  return `${TRANSACTION_INCLUSION_ROOT}/head.json`;
+}
+function transactionInclusionManifestPath() {
+  return `${TRANSACTION_INCLUSION_ROOT}/manifest.json`;
+}
+
 // src/modules/network-model/staticRest/templates.ts
 var TEMPLATE_SLOTS = {
   block: 0,
-  hash: "0".repeat(64),
+  hash: asHash("0".repeat(64), true),
   index: 99,
   level: 42
 };
@@ -208,6 +223,11 @@ function indexSummaryPathTemplate(family) {
     { literal: String(TEMPLATE_SLOTS.index), name: "index" }
   ]);
 }
+function transactionInclusionPathTemplate() {
+  return toPathTemplate(transactionInclusionPath(TEMPLATE_SLOTS.hash), [
+    { literal: TEMPLATE_SLOTS.hash, name: "hash" }
+  ]);
+}
 
 // src/modules/network-model/staticRest/layout/chainManifest.ts
 var CHAIN_LAYOUT_VERSION = 1;
@@ -437,6 +457,68 @@ var asNetworkStakeRewardsIndexHead = zodAsFactory5(
   "asNetworkStakeRewardsIndexHead"
 );
 
+// src/modules/network-model/staticRest/layout/transactionInclusionIndex.ts
+import {
+  HashZod,
+  zodAsFactory as zodAsFactory6,
+  zodIsFactory as zodIsFactory5,
+  zodToFactory as zodToFactory4
+} from "@ariestools/sdk";
+import { z as z6 } from "zod";
+import { ChainIdZod as ChainIdZod2, XL1BlockNumberZod } from "#protocol-model";
+var TRANSACTION_INCLUSION_INDEX_LAYOUT = "transaction-inclusions-v1";
+var TransactionInclusionManifestZod = z6.object({
+  /** XL1 chain whose finalized transactions are indexed. */
+  chain: ChainIdZod2,
+  /** Versioned layout identifier. */
+  layout: z6.literal(TRANSACTION_INCLUSION_INDEX_LAYOUT),
+  /** Hash-addressed path template, for example `transactions/by-hash/{hash}.json`. */
+  path: z6.string()
+});
+var TransactionInclusionHeadZod = z6.object({
+  /** Highest finalized block fully represented by the lookup. */
+  block: XL1BlockNumberZod,
+  /** Hash of the highest finalized block fully represented by the lookup. */
+  blockHash: HashZod,
+  /** XL1 chain whose finalized transactions are indexed. */
+  chain: ChainIdZod2,
+  /** Number of transaction-inclusion records represented through `block`. */
+  entries: z6.int().nonnegative(),
+  /** Versioned layout identifier. */
+  layout: z6.literal(TRANSACTION_INCLUSION_INDEX_LAYOUT)
+});
+var isTransactionInclusionManifest = zodIsFactory5(TransactionInclusionManifestZod);
+var asTransactionInclusionManifest = zodAsFactory6(
+  TransactionInclusionManifestZod,
+  "asTransactionInclusionManifest"
+);
+var toTransactionInclusionManifest = zodToFactory4(
+  TransactionInclusionManifestZod,
+  "toTransactionInclusionManifest"
+);
+var isTransactionInclusionHead = zodIsFactory5(TransactionInclusionHeadZod);
+var asTransactionInclusionHead = zodAsFactory6(
+  TransactionInclusionHeadZod,
+  "asTransactionInclusionHead"
+);
+var toTransactionInclusionHead = zodToFactory4(
+  TransactionInclusionHeadZod,
+  "toTransactionInclusionHead"
+);
+function createTransactionInclusionManifest(chain) {
+  return asTransactionInclusionManifest({
+    chain,
+    layout: TRANSACTION_INCLUSION_INDEX_LAYOUT,
+    path: transactionInclusionPathTemplate()
+  }, true);
+}
+function createTransactionInclusionHead(head) {
+  return asTransactionInclusionHead({
+    ...head,
+    layout: TRANSACTION_INCLUSION_INDEX_LAYOUT
+  }, true);
+}
+
 // src/modules/network-model/staticRest/paths/evmEventIndex.ts
 function root(address) {
   return `evm/events/${address.toLowerCase()}`;
@@ -566,6 +648,9 @@ export {
   NetworkStakeRewardsPolicyIdZod,
   SequenceNetwork,
   testnet_default as SequenceNetworkIconString,
+  TRANSACTION_INCLUSION_INDEX_LAYOUT,
+  TransactionInclusionHeadZod,
+  TransactionInclusionManifestZod,
   asChainContractManifest,
   asChainManifest,
   asEvmEventIndexFrame,
@@ -578,6 +663,8 @@ export {
   asNetworkStakeRewardsIndexSnapshot,
   asNetworkStakeRewardsIndexStep,
   asOptionalNetwork,
+  asTransactionInclusionHead,
+  asTransactionInclusionManifest,
   blockHashPath,
   blockHashPathTemplate,
   blockNumberPath,
@@ -589,6 +676,8 @@ export {
   createIndexHead,
   createIndexManifest,
   createIndexManifestFamilies,
+  createTransactionInclusionHead,
+  createTransactionInclusionManifest,
   evmEventIndexFramePath,
   evmEventIndexHeadPath,
   evmEventIndexManifestPath,
@@ -608,6 +697,8 @@ export {
   isIndexManifest,
   isNetworkBootstrap,
   isNetworkStakeRewardsIndexManifest,
+  isTransactionInclusionHead,
+  isTransactionInclusionManifest,
   manifestPath,
   networkStakeRewardsIndexHeadPath,
   networkStakeRewardsIndexManifestPath,
@@ -619,6 +710,12 @@ export {
   toChainManifest,
   toIndexHead,
   toIndexManifest,
-  toPathTemplate
+  toPathTemplate,
+  toTransactionInclusionHead,
+  toTransactionInclusionManifest,
+  transactionInclusionHeadPath,
+  transactionInclusionManifestPath,
+  transactionInclusionPath,
+  transactionInclusionPathTemplate
 };
 //# sourceMappingURL=network-model.mjs.map