@xyo-network/xl1-protocol 4.0.11 → 4.0.12

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

@@ -0,0 +1,263 @@
+import { z } from 'zod';
+import type { IndexSummaryFamily, IndexWatermark } from '../../../protocol-lib/index.js';
+/** Bumped when the on-disk index layout changes shape, so readers can detect a mismatch. */
+export declare const INDEX_LAYOUT_VERSION = 1;
+/** Schema id for the index manifest document (the static layout descriptor). */
+export declare const IndexManifestSchema: "network.xyo.s3.index.manifest";
+/** Type literal for the index manifest schema. */
+export type IndexManifestSchema = typeof IndexManifestSchema;
+/** Schema id for the index head document (the progress watermark). */
+export declare const IndexHeadSchema: "network.xyo.s3.index.head";
+/** Type literal for the index head schema. */
+export type IndexHeadSchema = typeof IndexHeadSchema;
+/** Per-family descriptor carried in the manifest. */
+export declare const IndexManifestFamilyZod: z.ZodObject<{
+    maxStep: z.ZodInt;
+    path: z.ZodString;
+}, z.core.$strip>;
+/** Type for one index manifest family descriptor. */
+export type IndexManifestFamily = z.infer<typeof IndexManifestFamilyZod>;
+/** Zod schema for the static index layout descriptor at `indexManifestPath()`. */
+export declare const IndexManifestZod: z.ZodObject<{
+    families: z.ZodObject<{
+        balances: z.ZodObject<{
+            maxStep: z.ZodInt;
+            path: z.ZodString;
+        }, z.core.$strip>;
+        blocks: z.ZodObject<{
+            maxStep: z.ZodInt;
+            path: z.ZodString;
+        }, z.core.$strip>;
+        schemas: z.ZodObject<{
+            maxStep: z.ZodInt;
+            path: z.ZodString;
+        }, z.core.$strip>;
+        transfers: z.ZodObject<{
+            maxStep: z.ZodInt;
+            path: z.ZodString;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+    schema: z.ZodLiteral<"network.xyo.s3.index.manifest">;
+    version: z.ZodInt;
+}, z.core.$strip>;
+/** The static index layout descriptor at `indexManifestPath()`. */
+export type IndexManifest = z.infer<typeof IndexManifestZod>;
+/** Type guard that checks if a value is a valid IndexManifest. */
+export declare const isIndexManifest: <T>(value: T) => value is T & {
+    families: {
+        balances: {
+            maxStep: number;
+            path: string;
+        };
+        blocks: {
+            maxStep: number;
+            path: string;
+        };
+        schemas: {
+            maxStep: number;
+            path: string;
+        };
+        transfers: {
+            maxStep: number;
+            path: string;
+        };
+    };
+    schema: "network.xyo.s3.index.manifest";
+    version: number;
+};
+/** Converts a value to IndexManifest, throwing if invalid. */
+export declare const asIndexManifest: {
+    <T>(value: T): (T & {
+        families: {
+            balances: {
+                maxStep: number;
+                path: string;
+            };
+            blocks: {
+                maxStep: number;
+                path: string;
+            };
+            schemas: {
+                maxStep: number;
+                path: string;
+            };
+            transfers: {
+                maxStep: number;
+                path: string;
+            };
+        };
+        schema: "network.xyo.s3.index.manifest";
+        version: number;
+    }) | undefined;
+    <T>(value: T, assert: import("@ariestools/sdk").ZodFactoryConfig): T & {
+        families: {
+            balances: {
+                maxStep: number;
+                path: string;
+            };
+            blocks: {
+                maxStep: number;
+                path: string;
+            };
+            schemas: {
+                maxStep: number;
+                path: string;
+            };
+            transfers: {
+                maxStep: number;
+                path: string;
+            };
+        };
+        schema: "network.xyo.s3.index.manifest";
+        version: number;
+    };
+};
+/** Non-validating cast to IndexManifest. */
+export declare const toIndexManifest: {
+    <T>(value: T): (T & {
+        families: {
+            balances: {
+                maxStep: number;
+                path: string;
+            };
+            blocks: {
+                maxStep: number;
+                path: string;
+            };
+            schemas: {
+                maxStep: number;
+                path: string;
+            };
+            transfers: {
+                maxStep: number;
+                path: string;
+            };
+        };
+        schema: "network.xyo.s3.index.manifest";
+        version: number;
+    }) | undefined;
+    <T>(value: T, assert: import("@ariestools/sdk").ZodFactoryConfig): T & {
+        families: {
+            balances: {
+                maxStep: number;
+                path: string;
+            };
+            blocks: {
+                maxStep: number;
+                path: string;
+            };
+            schemas: {
+                maxStep: number;
+                path: string;
+            };
+            transfers: {
+                maxStep: number;
+                path: string;
+            };
+        };
+        schema: "network.xyo.s3.index.manifest";
+        version: number;
+    };
+};
+/** Completed frame counts per family in the index head watermark. */
+export declare const IndexHeadFamiliesZod: z.ZodObject<{
+    balances: z.ZodInt;
+    blocks: z.ZodInt;
+    schemas: z.ZodInt;
+    transfers: z.ZodInt;
+}, z.core.$strip>;
+/** Zod schema for the index progress watermark at `indexHeadPath()`. */
+export declare const IndexHeadZod: z.ZodObject<{
+    block: z.ZodInt;
+    families: z.ZodObject<{
+        balances: z.ZodInt;
+        blocks: z.ZodInt;
+        schemas: z.ZodInt;
+        transfers: z.ZodInt;
+    }, z.core.$strip>;
+    hash: z.ZodString;
+    schema: z.ZodLiteral<"network.xyo.s3.index.head">;
+    updatedAt: z.ZodString;
+    version: z.ZodInt;
+}, z.core.$strip>;
+/** The index progress watermark at `indexHeadPath()`. */
+export type IndexHead = z.infer<typeof IndexHeadZod>;
+/** Type guard that checks if a value is a valid IndexHead. */
+export declare const isIndexHead: <T>(value: T) => value is T & {
+    block: number;
+    families: {
+        balances: number;
+        blocks: number;
+        schemas: number;
+        transfers: number;
+    };
+    hash: string;
+    schema: "network.xyo.s3.index.head";
+    updatedAt: string;
+    version: number;
+};
+/** Converts a value to IndexHead, throwing if invalid. */
+export declare const asIndexHead: {
+    <T>(value: T): (T & {
+        block: number;
+        families: {
+            balances: number;
+            blocks: number;
+            schemas: number;
+            transfers: number;
+        };
+        hash: string;
+        schema: "network.xyo.s3.index.head";
+        updatedAt: string;
+        version: number;
+    }) | undefined;
+    <T>(value: T, assert: import("@ariestools/sdk").ZodFactoryConfig): T & {
+        block: number;
+        families: {
+            balances: number;
+            blocks: number;
+            schemas: number;
+            transfers: number;
+        };
+        hash: string;
+        schema: "network.xyo.s3.index.head";
+        updatedAt: string;
+        version: number;
+    };
+};
+/** Non-validating cast to IndexHead. */
+export declare const toIndexHead: {
+    <T>(value: T): (T & {
+        block: number;
+        families: {
+            balances: number;
+            blocks: number;
+            schemas: number;
+            transfers: number;
+        };
+        hash: string;
+        schema: "network.xyo.s3.index.head";
+        updatedAt: string;
+        version: number;
+    }) | undefined;
+    <T>(value: T, assert: import("@ariestools/sdk").ZodFactoryConfig): T & {
+        block: number;
+        families: {
+            balances: number;
+            blocks: number;
+            schemas: number;
+            transfers: number;
+        };
+        hash: string;
+        schema: "network.xyo.s3.index.head";
+        updatedAt: string;
+        version: number;
+    };
+};
+/** Builds per-family manifest descriptors with path templates derived from the path builders. */
+export declare function createIndexManifestFamilies(maxSteps: Record<IndexSummaryFamily, number>): Record<IndexSummaryFamily, IndexManifestFamily>;
+/** Builds a validated index manifest with path templates derived from the path builders. */
+export declare function createIndexManifest(maxSteps: Record<IndexSummaryFamily, number>): IndexManifest;
+/** Builds a validated index head watermark from an indexer progress snapshot. */
+export declare function createIndexHead(watermark: IndexWatermark, updatedAt?: string): IndexHead;
+//# sourceMappingURL=indexManifest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"indexManifest.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/network-model/staticRest/layout/indexManifest.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAIvE,4FAA4F;AAC5F,eAAO,MAAM,oBAAoB,IAAI,CAAA;AAErC,gFAAgF;AAChF,eAAO,MAAM,mBAAmB,EAAG,+BAAwC,CAAA;AAC3E,kDAAkD;AAClD,MAAM,MAAM,mBAAmB,GAAG,OAAO,mBAAmB,CAAA;AAE5D,sEAAsE;AACtE,eAAO,MAAM,eAAe,EAAG,2BAAoC,CAAA;AACnE,8CAA8C;AAC9C,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAA;AAEpD,qDAAqD;AACrD,eAAO,MAAM,sBAAsB;;;iBAKjC,CAAA;AAEF,qDAAqD;AACrD,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AASxE,kFAAkF;AAClF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;iBAI3B,CAAA;AAEF,mEAAmE;AACnE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAE5D,kEAAkE;AAClE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;CAAiC,CAAA;AAC7D,8DAA8D;AAC9D,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAoD,CAAA;AAChF,4CAA4C;AAC5C,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAoD,CAAA;AAEhF,qEAAqE;AACrE,eAAO,MAAM,oBAAoB;;;;;iBAK/B,CAAA;AAEF,wEAAwE;AACxE,eAAO,MAAM,YAAY;;;;;;;;;;;;iBAWvB,CAAA;AAEF,yDAAyD;AACzD,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAA;AAEpD,8DAA8D;AAC9D,eAAO,MAAM,WAAW;;;;;;;;;;;;CAA6B,CAAA;AACrD,0DAA0D;AAC1D,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;CAA4C,CAAA;AACpE,wCAAwC;AACxC,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;CAA4C,CAAA;AAEpE,iGAAiG;AACjG,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC,GAC3C,MAAM,CAAC,kBAAkB,EAAE,mBAAmB,CAAC,CAOjD;AAED,4FAA4F;AAC5F,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC,GAAG,aAAa,CAM/F;AAED,iFAAiF;AACjF,wBAAgB,eAAe,CAAC,SAAS,EAAE,cAAc,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAWxF"}

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

@@ -0,0 +1,10 @@
+/**
+ * Path builders for the chain-state (mutable) bucket.
+ *
+ * Paths are relative — no leading slash — and joined to a base URL by the consumer.
+ */
+/** The mutable head pointer: the current head SignedHydratedBlockWithHashMeta. */
+export declare const headPath: () => string;
+/** The chain-contract manifest: static per-chain config (rewards contract, staking token, fork info). Published once. */
+export declare const chainContractPath: () => string;
+//# sourceMappingURL=chainState.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chainState.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/network-model/staticRest/paths/chainState.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,kFAAkF;AAClF,eAAO,MAAM,QAAQ,QAAO,MAA2B,CAAA;AAEvD,yHAAyH;AACzH,eAAO,MAAM,iBAAiB,QAAO,MAA+B,CAAA"}

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

@@ -0,0 +1,14 @@
+/**
+ * Path builders for the finalized (immutable) bucket.
+ *
+ * Paths are relative — no leading slash — and joined to a base URL by the consumer.
+ */
+/** The finalized layout descriptor (path templates, encoding, version, earliest block). */
+export declare const manifestPath: () => string;
+/** A block by number: SignedHydratedBlockWithHashMeta. */
+export declare const blockNumberPath: (block: number) => string;
+/** A block by hash: the same content as its by-number twin. */
+export declare const blockHashPath: (hash: string) => string;
+/** A payload by hash: WithHashMeta<Payload>. */
+export declare const payloadPath: (hash: string) => string;
+//# sourceMappingURL=finalized.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"finalized.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/network-model/staticRest/paths/finalized.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,2FAA2F;AAC3F,eAAO,MAAM,YAAY,QAAO,MAAyB,CAAA;AAEzD,0DAA0D;AAC1D,eAAO,MAAM,eAAe,GAAI,OAAO,MAAM,KAAG,MAAsC,CAAA;AAEtF,+DAA+D;AAC/D,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,KAAG,MAAmC,CAAA;AAEhF,gDAAgD;AAChD,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,KAAG,MAAgC,CAAA"}

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

@@ -0,0 +1,4 @@
+export * from './chainState.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

@@ -0,0 +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"}

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

@@ -0,0 +1,14 @@
+import type { IndexSummaryFamily } from '../../../protocol-lib/index.js';
+/**
+ * Path builders for the index bucket.
+ *
+ * The index is a separate, single-writer bucket holding completed step summaries for several
+ * families. Paths are relative — no leading slash — and joined to a base URL by the consumer.
+ */
+/** A completed frame's summary for a family, e.g. `blocks/2/5.json`. Immutable once written. */
+export declare const indexSummaryPath: (family: IndexSummaryFamily, stepLevel: number, stepIndex: number) => string;
+/** The index layout descriptor (families, max step, encoding, version). */
+export declare const indexManifestPath: () => string;
+/** The indexer's progress watermark (highest block the index is complete through). */
+export declare const indexHeadPath: () => string;
+//# sourceMappingURL=indexPaths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"indexPaths.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/network-model/staticRest/paths/indexPaths.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAEvD;;;;;GAKG;AAEH,gGAAgG;AAChG,eAAO,MAAM,gBAAgB,GAAI,QAAQ,kBAAkB,EAAE,WAAW,MAAM,EAAE,WAAW,MAAM,KAAG,MACxD,CAAA;AAE5C,2EAA2E;AAC3E,eAAO,MAAM,iBAAiB,QAAO,MAAyB,CAAA;AAE9D,sFAAsF;AACtF,eAAO,MAAM,aAAa,QAAO,MAAqB,CAAA"}

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

@@ -0,0 +1,27 @@
+import type { IndexSummaryFamily } from '../../protocol-lib/index.js';
+/**
+ * Replaces concrete slot literals in a path with named `{placeholder}` segments.
+ * Used to derive manifest path templates from the path builders so the two cannot drift.
+ */
+export declare function toPathTemplate(path: string, slots: {
+    literal: string;
+    name: string;
+}[]): string;
+/** Fills `{placeholder}` segments in a manifest path template. Used in conformance tests. */
+export declare function interpolatePathTemplate(template: string, values: Record<string, string | number>): string;
+/** Self-describing template for `blockNumberPath`. */
+export declare const blockNumberPathTemplate: () => string;
+/** Self-describing template for `blockHashPath`. */
+export declare const blockHashPathTemplate: () => string;
+/** Self-describing template for `payloadPath`. */
+export declare const payloadPathTemplate: () => string;
+/** Self-describing templates for finalized + chain-state files carried in the chain manifest. */
+export declare function chainManifestPathTemplates(): {
+    blockByHash: string;
+    blockByNumber: string;
+    head: string;
+    payload: string;
+};
+/** Self-describing template for one index summary family, e.g. `blocks/{level}/{index}.json`. */
+export declare function indexSummaryPathTemplate(family: IndexSummaryFamily): string;
+//# sourceMappingURL=templates.d.ts.map

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

@@ -0,0 +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"}

package/dist/neutral/modules/network-model/utils/ExplorerLinks.d.ts

@@ -0,0 +1,28 @@
+import type { NetworkId } from '../models/index.js';
+/** Builds URLs to pages on an XL1 chain explorer for a specific network. */
+export declare class ExplorerLinks {
+    readonly explorerUrl: string;
+    readonly networkId: NetworkId;
+    constructor(explorerUrl: string, networkId: NetworkId);
+    /** `{explorerUrl}/xl1/{networkId}/address/{address}` */
+    address(address: string): string;
+    /** `{explorerUrl}/xl1/{networkId}/addresses` */
+    addresses(): string;
+    /** `{explorerUrl}/xl1/{networkId}/block/{blockHash}` */
+    block(blockHash: string): string;
+    /** `{explorerUrl}/xl1/{networkId}/block/number/{blockNumber}` */
+    blockByNumber(blockNumber: number | string): string;
+    /** `{explorerUrl}/xl1/{networkId}/block/{blockHash}/payload/{payloadHash}[/{render}]` */
+    blockPayload(blockHash: string, payloadHash: string, render?: string): string;
+    /** `{explorerUrl}/xl1/{networkId}/blocks` */
+    blocks(): string;
+    /** `{explorerUrl}/xl1/{networkId}` */
+    network(): string;
+    /** `{explorerUrl}/xl1/{networkId}/transaction/{txHash}` */
+    transaction(txHash: string): string;
+    /** `{explorerUrl}/xl1/{networkId}/transaction/{txHash}/payload/{payloadHash}[/{render}]` */
+    transactionPayload(txHash: string, payloadHash: string, render?: string): string;
+    /** `{explorerUrl}/xl1/{networkId}/transactions` */
+    transactions(): string;
+}
+//# sourceMappingURL=ExplorerLinks.d.ts.map

package/dist/neutral/modules/network-model/utils/ExplorerLinks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExplorerLinks.d.ts","sourceRoot":"","sources":["../../../../../src/modules/network-model/utils/ExplorerLinks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAEnD,4EAA4E;AAC5E,qBAAa,aAAa;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;gBAEjB,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS;IAKrD,wDAAwD;IACxD,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAIhC,gDAAgD;IAChD,SAAS,IAAI,MAAM;IAInB,wDAAwD;IACxD,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAIhC,iEAAiE;IACjE,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM;IAInD,yFAAyF;IACzF,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM;IAK7E,6CAA6C;IAC7C,MAAM,IAAI,MAAM;IAIhB,sCAAsC;IACtC,OAAO,IAAI,MAAM;IAIjB,2DAA2D;IAC3D,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAInC,4FAA4F;IAC5F,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM;IAKhF,mDAAmD;IACnD,YAAY,IAAI,MAAM;CAGvB"}

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

@@ -0,0 +1,2 @@
+export * from './ExplorerLinks.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/modules/network-model/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA"}

package/dist/neutral/modules/protocol-lib/OpenTelemetryProviders.d.ts

@@ -0,0 +1,7 @@
+import type { MeterProvider, TracerProvider } from '@opentelemetry/api';
+/** Configuration for OpenTelemetry metric and trace providers */
+export interface OpenTelemetryProviders {
+    meterProvider?: MeterProvider;
+    traceProvider?: TracerProvider;
+}
+//# sourceMappingURL=OpenTelemetryProviders.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OpenTelemetryProviders.d.ts","sourceRoot":"","sources":["../../../../src/modules/protocol-lib/OpenTelemetryProviders.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAEvE,iEAAiE;AACjE,MAAM,WAAW,sBAAsB;IACrC,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,aAAa,CAAC,EAAE,cAAc,CAAA;CAC/B"}

package/dist/neutral/modules/protocol-lib/address/derivedReceiveAddress.d.ts

@@ -0,0 +1,4 @@
+import type { XyoAddress } from '@xyo-network/sdk';
+/** Returns the deterministic derived receive address for an address and optional scope. */
+export declare function derivedReceiveAddress(address: XyoAddress, scope?: string): XyoAddress;
+//# sourceMappingURL=derivedReceiveAddress.d.ts.map

package/dist/neutral/modules/protocol-lib/address/derivedReceiveAddress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derivedReceiveAddress.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-lib/address/derivedReceiveAddress.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAGlD,2FAA2F;AAC3F,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU,CAKrF"}

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

@@ -0,0 +1,4 @@
+export * from './derivedReceiveAddress.js';
+export * from './rewardAddressFromStepIdentity.js';
+export * from './sentinelAddressFromSchema.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-lib/address/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAA;AAC1C,cAAc,oCAAoC,CAAA;AAClD,cAAc,gCAAgC,CAAA"}

package/dist/neutral/modules/protocol-lib/address/rewardAddressFromStepIdentity.d.ts

@@ -0,0 +1,7 @@
+import type { XyoAddress } from '@xyo-network/sdk';
+import { type StepIdentity } from '../../protocol-model/index.js';
+/** Returns the deterministic reward-holder address for a completed step. */
+export declare function rewardAddressFromStepIdentity({ block, step }: StepIdentity): XyoAddress;
+/** @deprecated use rewardAddressFromStepIdentity instead */
+export declare const completedStepRewardAddress: typeof rewardAddressFromStepIdentity;
+//# sourceMappingURL=rewardAddressFromStepIdentity.d.ts.map

package/dist/neutral/modules/protocol-lib/address/rewardAddressFromStepIdentity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rewardAddressFromStepIdentity.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-lib/address/rewardAddressFromStepIdentity.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAGlD,OAAO,EAAE,KAAK,YAAY,EAAa,MAAM,iBAAiB,CAAA;AAE9D,4EAA4E;AAC5E,wBAAgB,6BAA6B,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,YAAY,GAAG,UAAU,CAMvF;AAED,4DAA4D;AAC5D,eAAO,MAAM,0BAA0B,sCAAgC,CAAA"}

package/dist/neutral/modules/protocol-lib/address/sentinelAddressFromSchema.d.ts

@@ -0,0 +1,21 @@
+import type { XyoAddress } from '@xyo-network/sdk';
+/**
+ * Returns a deterministic no-private-key sentinel address derived from a schema,
+ * optionally bound to a specific payload hash for per-payload burn semantics.
+ *
+ * Without `payloadHash`: produces the static protocol sentinel for the schema.
+ * Used as the destination for `Transfer` payloads accompanying app
+ * data so that `accountBalanceHistory(sentinel)` surfaces every transaction
+ * in the protocol with no global indexer required.
+ *   construction: keccak256(utf8(schema)).slice(-40)
+ *
+ * With `payloadHash`: produces a per-payload derived burn address scoped to
+ * the schema. Each app payload binds dust to a unique no-key
+ * destination — verifiable real cost per operation.
+ *   construction: keccak256(utf8(`${schema}|${payloadHash}`)).slice(-40)
+ *
+ * Mirrors the construction used by `rewardAddressFromStepIdentity` and
+ * `derivedReceiveAddress` for the chain's own no-key escrow accounts.
+ */
+export declare function sentinelAddressFromSchema(schema: string, payloadHash?: string): XyoAddress;
+//# sourceMappingURL=sentinelAddressFromSchema.d.ts.map

package/dist/neutral/modules/protocol-lib/address/sentinelAddressFromSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sentinelAddressFromSchema.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-lib/address/sentinelAddressFromSchema.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAGlD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,UAAU,CAM1F"}

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

@@ -0,0 +1,14 @@
+export * from './address/index.js';
+export * from './network/index.js';
+export * from './OpenTelemetryProviders.js';
+export * from './permissions/index.js';
+export * from './providers/index.js';
+export * from './repository/index.js';
+export * from './runners/index.js';
+export * from './status/index.js';
+export * from './summary/index.js';
+export * from './transaction/index.js';
+export * from './validation/index.js';
+export * from './viewers/index.js';
+export * from '../protocol-model/index.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/protocol-lib/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,wBAAwB,CAAA;AACtC,cAAc,sBAAsB,CAAA;AACpC,cAAc,uBAAuB,CAAA;AACrC,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA;AAClC,cAAc,wBAAwB,CAAA;AACtC,cAAc,uBAAuB,CAAA;AACrC,cAAc,oBAAoB,CAAA;AAClC,cAAc,iBAAiB,CAAA"}

package/dist/neutral/modules/protocol-lib/network/Status.d.ts

@@ -0,0 +1,26 @@
+import type { Payload } from '@xyo-network/sdk';
+/** Schema identifier for network status payloads. */
+export declare const NetworkStatusSchema: "network.xyo.chain.status" & {
+    readonly __schema: true;
+};
+/** Schema type for NetworkStatus payloads. */
+export type NetworkStatusSchema = typeof NetworkStatusSchema;
+/** Possible states of the network: online, offline, degraded, or unknown. */
+export type NetworkStatusState = 'online' | 'offline' | 'degraded' | 'unknown';
+/** Represents a single network status update with a time range and description. */
+export interface NetworkStatusUpdate {
+    end: number;
+    start: number;
+    update: string;
+}
+/** Fields describing the current network status, including state and optional updates. */
+export interface NetworkStatusFields {
+    description: string;
+    state: NetworkStatusState;
+    updates?: NetworkStatusUpdate[];
+}
+/** A payload representing the current network status. */
+export type NetworkStatus = Payload<NetworkStatusFields, NetworkStatusSchema>;
+/** Type guard that checks whether a value is a NetworkStatus payload. */
+export declare const isNetworkStatus: (x?: unknown) => x is NetworkStatus;
+//# sourceMappingURL=Status.d.ts.map

package/dist/neutral/modules/protocol-lib/network/Status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Status.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-lib/network/Status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAG/C,qDAAqD;AACrD,eAAO,MAAM,mBAAmB;;CAA6C,CAAA;AAC7E,8CAA8C;AAC9C,MAAM,MAAM,mBAAmB,GAAG,OAAO,mBAAmB,CAAA;AAE5D,6EAA6E;AAC7E,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAA;AAE9E,mFAAmF;AACnF,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAED,0FAA0F;AAC1F,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,kBAAkB,CAAA;IACzB,OAAO,CAAC,EAAE,mBAAmB,EAAE,CAAA;CAChC;AAED,yDAAyD;AACzD,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,mBAAmB,EAAE,mBAAmB,CAAC,CAAA;AAE7E,yEAAyE;AACzE,eAAO,MAAM,eAAe,qCAA4D,CAAA"}

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

@@ -0,0 +1,2 @@
+export * from './Status.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-lib/network/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA"}

package/dist/neutral/modules/protocol-lib/permissions/InvokerPermission.d.ts

@@ -0,0 +1,48 @@
+import type { JsonValue } from '@ariestools/sdk';
+import type { CaveatTypes } from '../../protocol-model/index.js';
+/**
+ * Modeled after EIP-2255
+ * See - https://eips.ethereum.org/EIPS/eip-2255#specification
+ *
+ * In order to send multiple permission requests at once, do not send multiple parentCapability keys.
+ * Instead, send multiple PermissionRequest objects in the params array of the rpc call.
+ */
+export type PermissionRequest = Record<string, Record<string, JsonValue>>;
+/**
+ * Modeled after EIP-2255
+ * See - https://eips.ethereum.org/EIPS/eip-2255#specification
+ */
+export interface RequestedPermission {
+    /** Optional timestamp for when the permission was granted */
+    date?: number;
+    /** Permission identifier (i.e. RPC method, action, etc.) */
+    parentCapability: string;
+}
+/**
+ * Modeled after EIP-2255
+ * See - https://eips.ethereum.org/EIPS/eip-2255#specification
+ */
+export interface Caveats {
+    /** Type of caveat */
+    type: CaveatTypes;
+    /** Value for the caveat (i.e. chain id, subset of accounts, expiration, max request per minute, etc.) */
+    value: JsonValue;
+}
+/**
+ * Modeled after EIP-2255
+ * See - https://eips.ethereum.org/EIPS/eip-2255#specification
+ */
+export interface Permission {
+    /** Caveats for the permission, if applicable (i.e. allowed accounts, signing, etc.) */
+    caveats?: Caveats[];
+    /** Invoker for the given permission (URI, domain, webpage, address, etc.) */
+    invoker: string;
+    /** Permission identifier (i.e. RPC method, action, etc.) */
+    parentCapability: string;
+}
+/** InvokerPermission interface. */
+export interface InvokerPermission extends Permission {
+    /** Time at which the permission was granted */
+    date?: number;
+}
+//# sourceMappingURL=InvokerPermission.d.ts.map

package/dist/neutral/modules/protocol-lib/permissions/InvokerPermission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InvokerPermission.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-lib/permissions/InvokerPermission.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAEhD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAElD;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAA;AAEzE;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,4DAA4D;IAC5D,gBAAgB,EAAE,MAAM,CAAA;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB,qBAAqB;IACrB,IAAI,EAAE,WAAW,CAAA;IACjB,yGAAyG;IACzG,KAAK,EAAE,SAAS,CAAA;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,uFAAuF;IACvF,OAAO,CAAC,EAAE,OAAO,EAAE,CAAA;IACnB,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAA;IACf,4DAA4D;IAC5D,gBAAgB,EAAE,MAAM,CAAA;CACzB;AAED,mCAAmC;AACnC,MAAM,WAAW,iBAAkB,SAAQ,UAAU;IACnD,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAA;CACd"}

package/dist/neutral/modules/protocol-lib/permissions/XyoPermissions.d.ts

@@ -0,0 +1,33 @@
+import type { InvokerPermission, PermissionRequest, RequestedPermission } from './InvokerPermission.js';
+/**
+ * Handles Getting Permissions
+ */
+export interface PermissionsGetHandler {
+    /**
+     * Returns the permissions that are currently granted
+     *
+     * Per the spec - "The wallet_getPermissions method is used for getting an array of current permissions
+     * (empty by default). It takes no parameters and returns an array of Permission objects."
+     *
+     * See - https://eips.ethereum.org/EIPS/eip-2255#specification
+     */
+    getPermissions(): Promise<InvokerPermission[]>;
+}
+/**
+ * Handles Permission Requests
+ */
+export interface PermissionRequestsHandler {
+    requestPermissions(permissions: PermissionRequest[]): Promise<RequestedPermission[]>;
+    revokePermissions(permissions: PermissionRequest): Promise<RequestedPermission[]>;
+}
+/**
+ * Interface for getting, requesting and revoking permissions
+ *
+ * See - https://eips.ethereum.org/EIPS/eip-2255
+ */
+export interface XyoPermissions extends PermissionsGetHandler, PermissionRequestsHandler {
+}
+/** PermissionsProvider interface. */
+export interface PermissionsProvider extends XyoPermissions {
+}
+//# sourceMappingURL=XyoPermissions.d.ts.map

package/dist/neutral/modules/protocol-lib/permissions/XyoPermissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"XyoPermissions.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-lib/permissions/XyoPermissions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EAAE,iBAAiB,EAAE,mBAAmB,EAC1D,MAAM,wBAAwB,CAAA;AAE/B;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;;;OAOG;IACH,cAAc,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAA;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IAExC,kBAAkB,CAAC,WAAW,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAAA;IAEpF,iBAAiB,CAAC,WAAW,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAAA;CAClF;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAe,SAAQ,qBAAqB,EAAE,yBAAyB;CAEvF;AAGD,qCAAqC;AACrC,MAAM,WAAW,mBAAoB,SAAQ,cAAc;CAAG"}

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

@@ -0,0 +1,3 @@
+export * from './InvokerPermission.js';
+export * from './XyoPermissions.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-lib/permissions/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAA;AACtC,cAAc,qBAAqB,CAAA"}