@xyo-network/xl1-protocol 4.4.0 → 4.4.2

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

@@ -0,0 +1,115 @@
+import { z } from 'zod/mini';
+/** JSON-safe representation of one raw EVM contract log. */
+export declare const EvmEventIndexLogZod: z.ZodMiniObject<{
+    address: z.ZodMiniString<string>;
+    blockHash: z.ZodMiniString<string>;
+    blockNumber: z.ZodMiniNumber<number>;
+    data: z.ZodMiniString<string>;
+    index: z.ZodMiniNumber<number>;
+    topics: z.ZodMiniArray<z.ZodMiniString<string>>;
+    transactionHash: z.ZodMiniString<string>;
+    transactionIndex: z.ZodMiniNumber<number>;
+}, z.core.$strip>;
+/** Type for one raw EVM contract log in the event index. */
+export type EvmEventIndexLog = z.infer<typeof EvmEventIndexLogZod>;
+/** One immutable, address-scoped range of finalized EVM logs. */
+export declare const EvmEventIndexFrameZod: z.ZodMiniObject<{
+    fromBlock: z.ZodMiniNumber<number>;
+    logs: z.ZodMiniArray<z.ZodMiniObject<{
+        address: z.ZodMiniString<string>;
+        blockHash: z.ZodMiniString<string>;
+        blockNumber: z.ZodMiniNumber<number>;
+        data: z.ZodMiniString<string>;
+        index: z.ZodMiniNumber<number>;
+        topics: z.ZodMiniArray<z.ZodMiniString<string>>;
+        transactionHash: z.ZodMiniString<string>;
+        transactionIndex: z.ZodMiniNumber<number>;
+    }, z.core.$strip>>;
+    toBlock: z.ZodMiniNumber<number>;
+}, z.core.$strip>;
+/** Type for one immutable event-index frame. */
+export type EvmEventIndexFrame = z.infer<typeof EvmEventIndexFrameZod>;
+/** Static description of one contract event index. */
+export declare const EvmEventIndexManifestZod: z.ZodMiniObject<{
+    address: z.ZodMiniString<string>;
+    chainId: z.ZodMiniString<string>;
+    deploymentBlock: z.ZodMiniNumber<number>;
+    frameSize: z.ZodMiniNumber<number>;
+    layout: z.ZodMiniLiteral<"evm-contract-events-v1">;
+}, z.core.$strip>;
+/** Type for the event-index manifest document. */
+export type EvmEventIndexManifest = z.infer<typeof EvmEventIndexManifestZod>;
+/**
+ * Mutable pointer written after all frames through `block` are durable.
+ * Wire schema for the `EvmEventIndexHead` runner contract in `#protocol-lib`.
+ */
+export declare const EvmEventIndexHeadZod: z.ZodMiniObject<{
+    address: z.ZodMiniString<string>;
+    block: z.ZodMiniNumber<number>;
+    chainId: z.ZodMiniString<string>;
+    hash: z.ZodMiniString<string>;
+}, z.core.$strip>;
+/** Converts a value to EvmEventIndexFrame, throwing if invalid. */
+export declare const asEvmEventIndexFrame: {
+    <T>(value: T): (T & {
+        fromBlock: number;
+        logs: {
+            address: string;
+            blockHash: string;
+            blockNumber: number;
+            data: string;
+            index: number;
+            topics: string[];
+            transactionHash: string;
+            transactionIndex: number;
+        }[];
+        toBlock: number;
+    }) | undefined;
+    <T>(value: T, assert: import("@ariestools/sdk").ZodFactoryConfig): T & {
+        fromBlock: number;
+        logs: {
+            address: string;
+            blockHash: string;
+            blockNumber: number;
+            data: string;
+            index: number;
+            topics: string[];
+            transactionHash: string;
+            transactionIndex: number;
+        }[];
+        toBlock: number;
+    };
+};
+/** Converts a value to EvmEventIndexHead, throwing if invalid. */
+export declare const asEvmEventIndexHead: {
+    <T>(value: T): (T & {
+        address: string;
+        block: number;
+        chainId: string;
+        hash: string;
+    }) | undefined;
+    <T>(value: T, assert: import("@ariestools/sdk").ZodFactoryConfig): T & {
+        address: string;
+        block: number;
+        chainId: string;
+        hash: string;
+    };
+};
+/** Converts a value to EvmEventIndexManifest, throwing if invalid. */
+export declare const asEvmEventIndexManifest: {
+    <T>(value: T): (T & {
+        address: string;
+        chainId: string;
+        deploymentBlock: number;
+        frameSize: number;
+        layout: "evm-contract-events-v1";
+    }) | undefined;
+    <T>(value: T, assert: import("@ariestools/sdk").ZodFactoryConfig): T & {
+        address: string;
+        chainId: string;
+        deploymentBlock: number;
+        frameSize: number;
+        layout: "evm-contract-events-v1";
+    };
+};
+//# sourceMappingURL=evmEventIndex.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"evmEventIndex.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/network-model/staticRest/layout/evmEventIndex.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,UAAU,CAAA;AAK5B,4DAA4D;AAC5D,eAAO,MAAM,mBAAmB;;;;;;;;;iBAS9B,CAAA;AAEF,4DAA4D;AAC5D,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAElE,iEAAiE;AACjE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;iBAIhC,CAAA;AAEF,gDAAgD;AAChD,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEtE,sDAAsD;AACtD,eAAO,MAAM,wBAAwB;;;;;;iBAMnC,CAAA;AAEF,kDAAkD;AAClD,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAE5E;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;iBAK/B,CAAA;AAEF,mEAAmE;AACnE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAA8D,CAAA;AAC/F,kEAAkE;AAClE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;CAA4D,CAAA;AAC5F,sEAAsE;AACtE,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;CAAoE,CAAA"}

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

@@ -1,4 +1,5 @@
 export * from './chainContractManifest.js';
 export * from './chainManifest.js';
+export * from './evmEventIndex.js';
 export * from './indexManifest.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"}
+{"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"}

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

@@ -0,0 +1,10 @@
+import type { EthAddress } from '@ariestools/sdk';
+/** Path of one immutable event-index frame within the index bucket. */
+export declare function evmEventIndexFramePath(address: EthAddress, frameIndex: number): string;
+/** Path of the mutable event-index head pointer within the index bucket. */
+export declare function evmEventIndexHeadPath(address: EthAddress): string;
+/** Path of the event-index manifest within the index bucket. */
+export declare function evmEventIndexManifestPath(address: EthAddress): string;
+/** Path of the mutable partial-frame tail within the index bucket. */
+export declare function evmEventIndexTailPath(address: EthAddress): string;
+//# sourceMappingURL=evmEventIndex.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"evmEventIndex.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/network-model/staticRest/paths/evmEventIndex.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAMjD,uEAAuE;AACvE,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAEtF;AAED,4EAA4E;AAC5E,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAEjE;AAED,gEAAgE;AAChE,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAErE;AAED,sEAAsE;AACtE,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAEjE"}

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

@@ -1,4 +1,5 @@
 export * from './chainState.js';
+export * from './evmEventIndex.js';
 export * from './finalized.js';
 export * from './indexPaths.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,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,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"}

package/dist/neutral/modules/protocol-lib/runners/EvmEventIndexPublish.d.ts

@@ -0,0 +1,25 @@
+import type { Provider } from '../../protocol-model/index.js';
+/** Mutable pointer written after all event-index frames through `block` are durable. */
+export interface EvmEventIndexHead {
+    /** EVM address of the contract whose raw logs are indexed. */
+    address: string;
+    /** Highest finalized EVM block the index is complete through. */
+    block: number;
+    /** EVM chain id the index was built against. */
+    chainId: string;
+    /** Hash of that block, for reorg detection on resume. */
+    hash: string;
+}
+/** EvmEventIndexPublishRunnerMethods interface. */
+export interface EvmEventIndexPublishRunnerMethods {
+    /** Publishes finalized raw logs for a configured EVM contract; null when nothing is publishable yet. */
+    publishFinalizedEvents(): Promise<EvmEventIndexHead | null>;
+}
+/** Moniker identifier for the EvmEventIndexPublishRunner provider. */
+export declare const EvmEventIndexPublishRunnerMoniker: "EvmEventIndexPublishRunner";
+/** Type literal for the EvmEventIndexPublishRunner provider moniker. */
+export type EvmEventIndexPublishRunnerMoniker = typeof EvmEventIndexPublishRunnerMoniker;
+/** Runner interface for publishing a finalized EVM contract event index. */
+export interface EvmEventIndexPublishRunner extends EvmEventIndexPublishRunnerMethods, Provider<EvmEventIndexPublishRunnerMoniker> {
+}
+//# sourceMappingURL=EvmEventIndexPublish.d.ts.map

package/dist/neutral/modules/protocol-lib/runners/EvmEventIndexPublish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EvmEventIndexPublish.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-lib/runners/EvmEventIndexPublish.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAE/C,wFAAwF;AACxF,MAAM,WAAW,iBAAiB;IAChC,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAA;IACf,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAA;IACb,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAA;IACf,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAA;CACb;AAED,mDAAmD;AACnD,MAAM,WAAW,iCAAiC;IAChD,wGAAwG;IACxG,sBAAsB,IAAI,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAA;CAC5D;AAED,sEAAsE;AACtE,eAAO,MAAM,iCAAiC,EAAG,4BAAqC,CAAA;AACtF,wEAAwE;AACxE,MAAM,MAAM,iCAAiC,GAAG,OAAO,iCAAiC,CAAA;AAExF,4EAA4E;AAC5E,MAAM,WAAW,0BAA2B,SAAQ,iCAAiC,EAAE,QAAQ,CAAC,iCAAiC,CAAC;CAAG"}

package/dist/neutral/modules/protocol-lib/runners/index.d.ts

@@ -3,6 +3,7 @@ export * from './BlockPublish.js';
 export * from './ChainStatePublish.js';
 export * from './DataLakePublish.js';
 export * from './DeadLetterQueue.js';
+export * from './EvmEventIndexPublish.js';
 export * from './Finalization.js';
 export * from './IndexPublish.js';
 export * from './Mempool.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-lib/runners/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,mBAAmB,CAAA;AACjC,cAAc,wBAAwB,CAAA;AACtC,cAAc,sBAAsB,CAAA;AACpC,cAAc,sBAAsB,CAAA;AACpC,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-lib/runners/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,mBAAmB,CAAA;AACjC,cAAc,wBAAwB,CAAA;AACtC,cAAc,sBAAsB,CAAA;AACpC,cAAc,sBAAsB,CAAA;AACpC,cAAc,2BAA2B,CAAA;AACzC,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,cAAc,CAAA"}

package/dist/neutral/modules/protocol-model/Step/StepSizes.d.ts

@@ -6,7 +6,7 @@ export declare function isValidStep(step: unknown): step is number;
 /** Casts a value to a valid step index, returning undefined if invalid */
 export declare const asValidStep: import("@ariestools/sdk").AsTypeFunction<number>;
 /** Returns the block interval size for a given step index */
-export declare function stepSize(step: number): number;
+export declare function stepSize(step: number): XL1BlockNumber;
 /** Fraction of block rewards allocated at each step level, expressed as [numerator, denominator] pairs */
 export declare const StepRewardFractions: readonly [readonly [0n, 1n], readonly [0n, 1n], readonly [0n, 1n], readonly [1n, 10000n], readonly [2n, 1000n], readonly [3n, 100n], readonly [45n, 100n]];
 //# sourceMappingURL=StepSizes.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"StepSizes.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-model/Step/StepSizes.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAK/E,wGAAwG;AACxG,eAAO,MAAM,SAAS,EAAE,cAAc,EAUrC,CAAA;AAED,yFAAyF;AACzF,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,MAAM,CAKzD;AAED,0EAA0E;AAC1E,eAAO,MAAM,WAAW,kDAA4C,CAAA;AAEpE,6DAA6D;AAC7D,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG7C;AAED,0GAA0G;AAC1G,eAAO,MAAM,mBAAmB,4JAQtB,CAAA"}
+{"version":3,"file":"StepSizes.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-model/Step/StepSizes.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAK/E,wGAAwG;AACxG,eAAO,MAAM,SAAS,EAAE,cAAc,EAUrC,CAAA;AAED,yFAAyF;AACzF,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,MAAM,CAKzD;AAED,0EAA0E;AAC1E,eAAO,MAAM,WAAW,kDAA4C,CAAA;AAEpE,6DAA6D;AAC7D,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAGrD;AAED,0GAA0G;AAC1G,eAAO,MAAM,mBAAmB,4JAQtB,CAAA"}

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

@@ -1 +1 @@
-{"version":3,"file":"BlockRate.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-model/model/BlockRate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAI7E,iCAAiC;AACjC,eAAO,MAAM,gBAAgB;;;;;;;iBAO3B,CAAA;AAEF,kEAAkE;AAClE,eAAO,MAAM,eAAe;;;;;;;CAAiC,CAAA;AAC7D,8DAA8D;AAC9D,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;CAAoD,CAAA;AAChF,gCAAgC;AAChC,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;CAAoD,CAAA;AAEhF,0BAA0B;AAC1B,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAE5D,6BAA6B;AAC7B,eAAO,MAAM,YAAY;;;;;;;;;;;;;;iBAOvB,CAAA;AAEF,sBAAsB;AACtB,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAA;AAEpD,6BAA6B;AAC7B,MAAM,MAAM,gBAAgB,CAAC,YAAY,SAAS,MAAM,IAAI,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG;IACrF,KAAK,EAAE,CAAC,YAAY,EAAE,YAAY,CAAC,CAAA;CACpC,CAAA;AAED,8BAA8B;AAC9B,MAAM,WAAW,YAAa,SAAQ,gBAAgB,CAAC,cAAc,CAAC;CAAG;AACzE,8BAA8B;AAC9B,MAAM,WAAW,YAAa,SAAQ,gBAAgB,CAAC,cAAc,CAAC;CAAG;AAEzE,8DAA8D;AAC9D,eAAO,MAAM,WAAW;;;;;;;CAA6B,CAAA;AACrD,0DAA0D;AAC1D,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;CAA4C,CAAA;AACpE,4BAA4B;AAC5B,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;CAA4C,CAAA;AAEpE,yBAAyB;AACzB,eAAO,MAAM,QAAQ,UAAiE,CAAA;AACtF,kBAAkB;AAClB,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAA;AAE5C,6BAA6B;AAC7B,eAAO,MAAM,YAAY,UAAqF,CAAA;AAC9G,sBAAsB;AACtB,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAA;AAIpD,8BAA8B;AAC9B,eAAO,MAAM,aAAa;;;;;;;iBAOgC,CAAA;AAE1D,uBAAuB;AACvB,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAA;AAEtD,+DAA+D;AAC/D,eAAO,MAAM,YAAY;;;;;;;CAA8B,CAAA;AACvD,2DAA2D;AAC3D,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;CAA8C,CAAA;AACvE,6BAA6B;AAC7B,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;CAA8C,CAAA;AAEvE,oCAAoC;AACpC,eAAO,MAAM,mBAAmB;;;;;;;;;;;;mBAO4B,CAAA;AAE5D,6BAA6B;AAC7B,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAElE,qEAAqE;AACrE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;EAAoC,CAAA;AACnE,iEAAiE;AACjE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;CAA0D,CAAA;AACzF,mCAAmC;AACnC,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;CAA0D,CAAA"}
+{"version":3,"file":"BlockRate.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-model/model/BlockRate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAI7E,iCAAiC;AACjC,eAAO,MAAM,gBAAgB;;;;;;;iBAO3B,CAAA;AAEF,kEAAkE;AAClE,eAAO,MAAM,eAAe;;;;;;;CAAiC,CAAA;AAC7D,8DAA8D;AAC9D,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;CAAoD,CAAA;AAChF,gCAAgC;AAChC,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;CAAoD,CAAA;AAEhF,0BAA0B;AAC1B,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAE5D,6BAA6B;AAC7B,eAAO,MAAM,YAAY;;;;;;;;;;;;;;iBAOvB,CAAA;AAEF,sBAAsB;AACtB,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAA;AAEpD,6BAA6B;AAC7B,MAAM,MAAM,gBAAgB,CAAC,YAAY,SAAS,MAAM,IAAI,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG;IACrF,KAAK,EAAE,CAAC,YAAY,EAAE,YAAY,CAAC,CAAA;CACpC,CAAA;AAED,8BAA8B;AAC9B,MAAM,WAAW,YAAa,SAAQ,gBAAgB,CAAC,cAAc,CAAC;CAAG;AACzE,8BAA8B;AAC9B,MAAM,WAAW,YAAa,SAAQ,gBAAgB,CAAC,cAAc,CAAC;CAAG;AAEzE,8DAA8D;AAC9D,eAAO,MAAM,WAAW;;;;;;;CAA6B,CAAA;AACrD,0DAA0D;AAC1D,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;CAA4C,CAAA;AACpE,4BAA4B;AAC5B,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;CAA4C,CAAA;AAEpE,yBAAyB;AACzB,eAAO,MAAM,QAAQ,UAAiE,CAAA;AACtF,kBAAkB;AAClB,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAA;AAE5C,6BAA6B;AAC7B,eAAO,MAAM,YAAY,UAAyF,CAAA;AAClH,sBAAsB;AACtB,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAA;AAIpD,8BAA8B;AAC9B,eAAO,MAAM,aAAa;;;;;;;iBAOgC,CAAA;AAE1D,uBAAuB;AACvB,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAA;AAEtD,+DAA+D;AAC/D,eAAO,MAAM,YAAY;;;;;;;CAA8B,CAAA;AACvD,2DAA2D;AAC3D,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;CAA8C,CAAA;AACvE,6BAA6B;AAC7B,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;CAA8C,CAAA;AAEvE,oCAAoC;AACpC,eAAO,MAAM,mBAAmB;;;;;;;;;;;;mBAO4B,CAAA;AAE5D,6BAA6B;AAC7B,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAElE,qEAAqE;AACrE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;EAAoC,CAAA;AACnE,iEAAiE;AACjE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;CAA0D,CAAA;AACzF,mCAAmC;AACnC,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;CAA0D,CAAA"}

package/dist/neutral/modules/protocol-model/payload/StepWitness.d.ts

@@ -0,0 +1,33 @@
+import type { Payload } from '@xyo-network/sdk';
+import { z } from 'zod/mini';
+/** Schema identifier for step witness payloads. */
+export declare const StepWitnessSchema: "network.xyo.chain.validation.step.witness" & {
+    readonly __schema: true;
+};
+/** Schema type for step witness payloads. */
+export type StepWitnessSchema = typeof StepWitnessSchema;
+/**
+ * Fields for a step witness — an observer's attestation of the step hash it observed in a
+ * specific block's `step_hashes` array. The witness is anchored to the observation block via
+ * `blockHash`/`blockNumber`, so anyone can later verify the claim against that block.
+ */
+export declare const StepWitnessFieldsZod: z.ZodMiniObject<{
+    blockHash: z.ZodMiniPipe<z.ZodMiniString<string>, z.ZodMiniTransform<import("@ariestools/sdk").BrandedHash, string>>;
+    blockNumber: import("zod").ZodPipe<import("zod").ZodInt, import("zod").ZodTransform<import('../BlockNumber/xl1BlockNumber.js').XL1BlockNumber, number>>;
+    stepHash: z.ZodMiniPipe<z.ZodMiniString<string>, z.ZodMiniTransform<import("@ariestools/sdk").BrandedHash, string>>;
+    stepSize: z.ZodMiniLiteral<import('../BlockNumber/xl1BlockNumber.js').XL1BlockNumber>;
+    witness: z.ZodMiniUnion<readonly [z.ZodMiniPipe<z.ZodMiniString<string>, z.ZodMiniTransform<Lowercase<string> & {
+        readonly __hex: true;
+    } & {
+        readonly __address: true;
+    }, string>>, z.ZodMiniPipe<z.ZodMiniString<string>, z.ZodMiniTransform<import("@xyo-network/sdk").XyoQuantAddress, string>>]>;
+}, z.core.$strip>;
+/** StepWitnessFields type. */
+export type StepWitnessFields = z.infer<typeof StepWitnessFieldsZod>;
+/** A step witness payload — records an observer's attestation of a completed step's hash as seen in a specific block. */
+export type StepWitness = Payload<StepWitnessFields, StepWitnessSchema>;
+/** Type guard that checks if a value is a valid StepWitness. */
+export declare const isStepWitness: (x?: unknown) => x is StepWitness;
+/** Casts a value to StepWitness or returns undefined if invalid. */
+export declare const asStepWitness: import("@ariestools/sdk").AsTypeFunction<StepWitness>;
+//# sourceMappingURL=StepWitness.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"StepWitness.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-model/payload/StepWitness.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAI/C,OAAO,EAAE,CAAC,EAAE,MAAM,UAAU,CAAA;AAK5B,mDAAmD;AACnD,eAAO,MAAM,iBAAiB;;CAA8D,CAAA;AAC5F,6CAA6C;AAC7C,MAAM,MAAM,iBAAiB,GAAG,OAAO,iBAAiB,CAAA;AAExD;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;iBAW/B,CAAA;AAEF,8BAA8B;AAC9B,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEpE,yHAAyH;AACzH,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,iBAAiB,EAAE,iBAAiB,CAAC,CAAA;AAEvE,gEAAgE;AAChE,eAAO,MAAM,aAAa,mCAA2E,CAAA;AAErG,oEAAoE;AACpE,eAAO,MAAM,aAAa,uDAAwC,CAAA"}

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

@@ -1,4 +1,5 @@
 export * from './application/index.js';
 export * from './elevatable/index.js';
 export * from './StepIdentityPayload.js';
+export * from './StepWitness.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-model/payload/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAA;AACtC,cAAc,uBAAuB,CAAA;AACrC,cAAc,0BAA0B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-model/payload/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAA;AACtC,cAAc,uBAAuB,CAAA;AACrC,cAAc,0BAA0B,CAAA;AACxC,cAAc,kBAAkB,CAAA"}

package/dist/neutral/network-model.mjs

@@ -238,56 +238,97 @@ function createChainManifest(encoding, earliestBlock = 0) {
   }, true);
 }
 
+// src/modules/network-model/staticRest/layout/evmEventIndex.ts
+import {
+  EthAddressZod,
+  HexRegExMinMaxMixedCaseWithPrefix,
+  zodAsFactory as zodAsFactory3
+} from "@ariestools/sdk";
+import { z as z3 } from "zod/mini";
+var EvmHashZod = z3.string().check(z3.regex(HexRegExMinMaxMixedCaseWithPrefix(32, 32)));
+var EvmDataZod = z3.string().check(z3.regex(/^0x[\dA-Fa-f]*$/));
+var EvmEventIndexLogZod = z3.object({
+  address: EthAddressZod,
+  blockHash: EvmHashZod,
+  blockNumber: z3.number(),
+  data: EvmDataZod,
+  index: z3.number(),
+  topics: z3.array(EvmHashZod),
+  transactionHash: EvmHashZod,
+  transactionIndex: z3.number()
+});
+var EvmEventIndexFrameZod = z3.object({
+  fromBlock: z3.number(),
+  logs: z3.array(EvmEventIndexLogZod),
+  toBlock: z3.number()
+});
+var EvmEventIndexManifestZod = z3.object({
+  address: EthAddressZod,
+  chainId: z3.string(),
+  deploymentBlock: z3.number(),
+  frameSize: z3.number(),
+  layout: z3.literal("evm-contract-events-v1")
+});
+var EvmEventIndexHeadZod = z3.object({
+  address: EthAddressZod,
+  block: z3.number(),
+  chainId: z3.string(),
+  hash: EvmHashZod
+});
+var asEvmEventIndexFrame = zodAsFactory3(EvmEventIndexFrameZod, "asEvmEventIndexFrame");
+var asEvmEventIndexHead = zodAsFactory3(EvmEventIndexHeadZod, "asEvmEventIndexHead");
+var asEvmEventIndexManifest = zodAsFactory3(EvmEventIndexManifestZod, "asEvmEventIndexManifest");
+
 // src/modules/network-model/staticRest/layout/indexManifest.ts
 import {
-  zodAsFactory as zodAsFactory3,
+  zodAsFactory as zodAsFactory4,
   zodIsFactory as zodIsFactory3,
   zodToFactory as zodToFactory3
 } from "@ariestools/sdk";
-import { z as z3 } from "zod";
+import { z as z4 } from "zod";
 var INDEX_LAYOUT_VERSION = 1;
 var IndexManifestSchema = "network.xyo.s3.index.manifest";
 var IndexHeadSchema = "network.xyo.s3.index.head";
-var IndexManifestFamilyZod = z3.object({
+var IndexManifestFamilyZod = z4.object({
   /** Highest step level published for this family. */
-  maxStep: z3.int().nonnegative(),
+  maxStep: z4.int().nonnegative(),
   /** Path template for the family's frames, e.g. `blocks/{level}/{index}.json`. */
-  path: z3.string()
+  path: z4.string()
 });
-var indexFamiliesZod = z3.object({
+var indexFamiliesZod = z4.object({
   balances: IndexManifestFamilyZod,
   blocks: IndexManifestFamilyZod,
   schemas: IndexManifestFamilyZod,
   transfers: IndexManifestFamilyZod
 });
-var IndexManifestZod = z3.object({
+var IndexManifestZod = z4.object({
   families: indexFamiliesZod,
-  schema: z3.literal(IndexManifestSchema),
-  version: z3.int().positive()
+  schema: z4.literal(IndexManifestSchema),
+  version: z4.int().positive()
 });
 var isIndexManifest = zodIsFactory3(IndexManifestZod);
-var asIndexManifest = zodAsFactory3(IndexManifestZod, "asIndexManifest");
+var asIndexManifest = zodAsFactory4(IndexManifestZod, "asIndexManifest");
 var toIndexManifest = zodToFactory3(IndexManifestZod, "toIndexManifest");
-var IndexHeadFamiliesZod = z3.object({
-  balances: z3.int().nonnegative(),
-  blocks: z3.int().nonnegative(),
-  schemas: z3.int().nonnegative(),
-  transfers: z3.int().nonnegative()
+var IndexHeadFamiliesZod = z4.object({
+  balances: z4.int().nonnegative(),
+  blocks: z4.int().nonnegative(),
+  schemas: z4.int().nonnegative(),
+  transfers: z4.int().nonnegative()
 });
-var IndexHeadZod = z3.object({
+var IndexHeadZod = z4.object({
   /** Highest block the index is complete through. */
-  block: z3.int().nonnegative(),
+  block: z4.int().nonnegative(),
   /** Completed frame counts per family. */
   families: IndexHeadFamiliesZod,
   /** Hash of that block. */
-  hash: z3.string(),
-  schema: z3.literal(IndexHeadSchema),
+  hash: z4.string(),
+  schema: z4.literal(IndexHeadSchema),
   /** ISO-8601 timestamp of the last update. */
-  updatedAt: z3.string(),
-  version: z3.int().positive()
+  updatedAt: z4.string(),
+  version: z4.int().positive()
 });
 var isIndexHead = zodIsFactory3(IndexHeadZod);
-var asIndexHead = zodAsFactory3(IndexHeadZod, "asIndexHead");
+var asIndexHead = zodAsFactory4(IndexHeadZod, "asIndexHead");
 var toIndexHead = zodToFactory3(IndexHeadZod, "toIndexHead");
 function createIndexManifestFamilies(maxSteps) {
   return {
@@ -317,6 +358,23 @@ function createIndexHead(watermark, updatedAt) {
   }, true);
 }
 
+// src/modules/network-model/staticRest/paths/evmEventIndex.ts
+function root(address) {
+  return `evm/events/${address.toLowerCase()}`;
+}
+function evmEventIndexFramePath(address, frameIndex) {
+  return `${root(address)}/frames/${frameIndex}.json`;
+}
+function evmEventIndexHeadPath(address) {
+  return `${root(address)}/head.json`;
+}
+function evmEventIndexManifestPath(address) {
+  return `${root(address)}/manifest.json`;
+}
+function evmEventIndexTailPath(address) {
+  return `${root(address)}/tail.json`;
+}
+
 // src/modules/network-model/utils/ExplorerLinks.ts
 var ExplorerLinks = class {
   explorerUrl;
@@ -377,6 +435,10 @@ export {
   ChainManifestSchema,
   ChainManifestZod,
   DefaultNetworks,
+  EvmEventIndexFrameZod,
+  EvmEventIndexHeadZod,
+  EvmEventIndexLogZod,
+  EvmEventIndexManifestZod,
   ExplorerLinks,
   INDEX_LAYOUT_VERSION,
   IndexHeadFamiliesZod,
@@ -395,6 +457,9 @@ export {
   testnet_default as SequenceNetworkIconString,
   asChainContractManifest,
   asChainManifest,
+  asEvmEventIndexFrame,
+  asEvmEventIndexHead,
+  asEvmEventIndexManifest,
   asIndexHead,
   asIndexManifest,
   asOptionalNetwork,
@@ -409,6 +474,10 @@ export {
   createIndexHead,
   createIndexManifest,
   createIndexManifestFamilies,
+  evmEventIndexFramePath,
+  evmEventIndexHeadPath,
+  evmEventIndexManifestPath,
+  evmEventIndexTailPath,
   getNetworkNode,
   getNetworkNodes,
   headPath,