@xyo-network/xl1-protocol 4.5.1 → 4.5.3

package/dist/neutral/modules/protocol-model/xl1/milliXl1.d.ts

@@ -1,15 +1,24 @@
-/** Maximum value for the MilliXL1 branded type. */
+/** Largest milliXL1 amount whose attoXL1 representation fits the 32-digit amount range. */
 export declare const MilliXL1MaxValue: bigint;
-/** MilliXL1 type. */
+/** Non-negative XL1 amount expressed in milliXL1, where one milliXL1 equals `10^15` attoXL1. */
 export type MilliXL1 = bigint & {
     readonly _tag: 'MilliXL1';
 };
-/** Type guard that checks if a value is a valid MilliXL1. */
+/** Returns whether a value is a bigint in the inclusive range `0` through {@link MilliXL1MaxValue}. */
 export declare const isMilliXL1: (val: unknown) => val is MilliXL1;
-/** Converts a value to MilliXL1, throwing if invalid. */
+/**
+ * Validates and brands an existing bigint as a {@link MilliXL1} amount.
+ *
+ * @throws A Zod validation error when the value is not a bigint or is outside the supported range.
+ */
 export declare const asMilliXL1: (val: unknown) => MilliXL1;
-/** Converts a bigint value to MilliXL1 without validation. */
+/**
+ * Coerces a bigint, integer number, numeric string, or boolean to {@link MilliXL1}, then validates its range.
+ *
+ * @returns The branded amount, or `undefined` when input type or range validation fails.
+ * @throws A JavaScript bigint-conversion error when a number is fractional or a string is not an integer.
+ */
 export declare const toMilliXL1: (val: unknown) => MilliXL1 | undefined;
-/** Shorthand alias for asMilliXL1. */
+/** Strict constructor alias for {@link asMilliXL1}. */
 export declare const MilliXL1: (val: unknown) => MilliXL1;
 //# sourceMappingURL=milliXl1.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"milliXl1.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-model/xl1/milliXl1.ts"],"names":[],"mappings":"AAMA,mDAAmD;AACnD,eAAO,MAAM,gBAAgB,QAA+B,CAAA;AAC5D,qBAAqB;AACrB,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAAE,CAAA;AAC7D,6DAA6D;AAC7D,eAAO,MAAM,UAAU,mCAA0C,CAAA;AACjE,yDAAyD;AACzD,eAAO,MAAM,UAAU,4BAA0C,CAAA;AAEjE,8DAA8D;AAC9D,eAAO,MAAM,UAAU,wCAA0C,CAAA;AAEjE,sCAAsC;AACtC,eAAO,MAAM,QAAQ,4BAAa,CAAA"}
+{"version":3,"file":"milliXl1.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-model/xl1/milliXl1.ts"],"names":[],"mappings":"AAMA,2FAA2F;AAC3F,eAAO,MAAM,gBAAgB,QAA+B,CAAA;AAC5D,gGAAgG;AAChG,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAAE,CAAA;AAC7D,uGAAuG;AACvG,eAAO,MAAM,UAAU,mCAA0C,CAAA;AACjE;;;;GAIG;AACH,eAAO,MAAM,UAAU,4BAA0C,CAAA;AAEjE;;;;;GAKG;AACH,eAAO,MAAM,UAAU,wCAA0C,CAAA;AAEjE,uDAAuD;AACvD,eAAO,MAAM,QAAQ,4BAAa,CAAA"}

package/dist/neutral/modules/protocol-model/xl1/nanoXl1.d.ts

@@ -1,15 +1,24 @@
-/** Maximum value for the NanoXL1 branded type. */
+/** Largest nanoXL1 amount whose attoXL1 representation fits the 32-digit amount range. */
 export declare const NanoXL1MaxValue: bigint;
-/** NanoXL1 type. */
+/** Non-negative XL1 amount expressed in nanoXL1, where one nanoXL1 equals `10^9` attoXL1. */
 export type NanoXL1 = bigint & {
     readonly _tag: 'NanoXL1';
 };
-/** Type guard that checks if a value is a valid NanoXL1. */
+/** Returns whether a value is a bigint in the inclusive range `0` through {@link NanoXL1MaxValue}. */
 export declare const isNanoXL1: (val: unknown) => val is NanoXL1;
-/** Converts a value to NanoXL1, throwing if invalid. */
+/**
+ * Validates and brands an existing bigint as a {@link NanoXL1} amount.
+ *
+ * @throws A Zod validation error when the value is not a bigint or is outside the supported range.
+ */
 export declare const asNanoXL1: (val: unknown) => NanoXL1;
-/** Converts a bigint value to NanoXL1 without validation. */
+/**
+ * Coerces a bigint, integer number, numeric string, or boolean to {@link NanoXL1}, then validates its range.
+ *
+ * @returns The branded amount, or `undefined` when input type or range validation fails.
+ * @throws A JavaScript bigint-conversion error when a number is fractional or a string is not an integer.
+ */
 export declare const toNanoXL1: (val: unknown) => NanoXL1 | undefined;
-/** Shorthand alias for asNanoXL1. */
+/** Strict constructor alias for {@link asNanoXL1}. */
 export declare const NanoXL1: (val: unknown) => NanoXL1;
 //# sourceMappingURL=nanoXl1.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"nanoXl1.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-model/xl1/nanoXl1.ts"],"names":[],"mappings":"AAMA,kDAAkD;AAClD,eAAO,MAAM,eAAe,QAA8B,CAAA;AAC1D,oBAAoB;AACpB,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,CAAA;AAC3D,4DAA4D;AAC5D,eAAO,MAAM,SAAS,kCAAwC,CAAA;AAC9D,wDAAwD;AACxD,eAAO,MAAM,SAAS,2BAAwC,CAAA;AAE9D,6DAA6D;AAC7D,eAAO,MAAM,SAAS,uCAAwC,CAAA;AAE9D,qCAAqC;AACrC,eAAO,MAAM,OAAO,2BAAY,CAAA"}
+{"version":3,"file":"nanoXl1.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-model/xl1/nanoXl1.ts"],"names":[],"mappings":"AAMA,0FAA0F;AAC1F,eAAO,MAAM,eAAe,QAA8B,CAAA;AAC1D,6FAA6F;AAC7F,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,CAAA;AAC3D,sGAAsG;AACtG,eAAO,MAAM,SAAS,kCAAwC,CAAA;AAC9D;;;;GAIG;AACH,eAAO,MAAM,SAAS,2BAAwC,CAAA;AAE9D;;;;;GAKG;AACH,eAAO,MAAM,SAAS,uCAAwC,CAAA;AAE9D,sDAAsD;AACtD,eAAO,MAAM,OAAO,2BAAY,CAAA"}

package/dist/neutral/modules/protocol-model/xl1/picoXl1.d.ts

@@ -1,15 +1,24 @@
-/** PicoXL1MaxValue constant. */
+/** Largest picoXL1 amount whose attoXL1 representation fits the 32-digit amount range. */
 export declare const PicoXL1MaxValue: bigint;
-/** PicoXL1 type. */
+/** Non-negative XL1 amount expressed in picoXL1, where one picoXL1 equals `10^6` attoXL1. */
 export type PicoXL1 = bigint & {
     readonly _tag: 'PicoXL1';
 };
-/** Type guard that checks if a value is a valid PicoXL1. */
+/** Returns whether a value is a bigint in the inclusive range `0` through {@link PicoXL1MaxValue}. */
 export declare const isPicoXL1: (val: unknown) => val is PicoXL1;
-/** Converts a value to PicoXL1, throwing if invalid. */
+/**
+ * Validates and brands an existing bigint as a {@link PicoXL1} amount.
+ *
+ * @throws A Zod validation error when the value is not a bigint or is outside the supported range.
+ */
 export declare const asPicoXL1: (val: unknown) => PicoXL1;
-/** toPicoXL1 constant. */
+/**
+ * Coerces a bigint, integer number, numeric string, or boolean to {@link PicoXL1}, then validates its range.
+ *
+ * @returns The branded amount, or `undefined` when input type or range validation fails.
+ * @throws A JavaScript bigint-conversion error when a number is fractional or a string is not an integer.
+ */
 export declare const toPicoXL1: (val: unknown) => PicoXL1 | undefined;
-/** PicoXL1 constant. */
+/** Strict constructor alias for {@link asPicoXL1}. */
 export declare const PicoXL1: (val: unknown) => PicoXL1;
 //# sourceMappingURL=picoXl1.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"picoXl1.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-model/xl1/picoXl1.ts"],"names":[],"mappings":"AAMA,gCAAgC;AAChC,eAAO,MAAM,eAAe,QAA8B,CAAA;AAC1D,oBAAoB;AACpB,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,CAAA;AAC3D,4DAA4D;AAC5D,eAAO,MAAM,SAAS,kCAAwC,CAAA;AAC9D,wDAAwD;AACxD,eAAO,MAAM,SAAS,2BAAwC,CAAA;AAE9D,0BAA0B;AAC1B,eAAO,MAAM,SAAS,uCAAwC,CAAA;AAE9D,wBAAwB;AACxB,eAAO,MAAM,OAAO,2BAAY,CAAA"}
+{"version":3,"file":"picoXl1.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-model/xl1/picoXl1.ts"],"names":[],"mappings":"AAMA,0FAA0F;AAC1F,eAAO,MAAM,eAAe,QAA8B,CAAA;AAC1D,6FAA6F;AAC7F,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,CAAA;AAC3D,sGAAsG;AACtG,eAAO,MAAM,SAAS,kCAAwC,CAAA;AAC9D;;;;GAIG;AACH,eAAO,MAAM,SAAS,2BAAwC,CAAA;AAE9D;;;;;GAKG;AACH,eAAO,MAAM,SAAS,uCAAwC,CAAA;AAE9D,sDAAsD;AACtD,eAAO,MAAM,OAAO,2BAAY,CAAA"}

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

@@ -1,15 +1,24 @@
-/** XL1MaxValue constant. */
+/** Largest whole-XL1 amount whose attoXL1 representation fits the 32-digit amount range. */
 export declare const XL1MaxValue: bigint;
-/** XL1 type. */
+/** Non-negative amount expressed in whole XL1, where one XL1 equals `10^18` attoXL1. */
 export type XL1 = bigint & {
     readonly _tag: 'XL1';
 };
-/** Type guard that checks if a value is a valid XL1. */
+/** Returns whether a value is a bigint in the inclusive range `0` through {@link XL1MaxValue}. */
 export declare const isXL1: (val: unknown) => val is XL1;
-/** Converts a value to XL1, throwing if invalid. */
+/**
+ * Validates and brands an existing bigint as a whole-{@link XL1} amount.
+ *
+ * @throws A Zod validation error when the value is not a bigint or is outside the supported range.
+ */
 export declare const asXL1: (val: unknown) => XL1;
-/** toXL1 constant. */
+/**
+ * Coerces a bigint, integer number, numeric string, or boolean to whole {@link XL1}, then validates its range.
+ *
+ * @returns The branded amount, or `undefined` when input type or range validation fails.
+ * @throws A JavaScript bigint-conversion error when a number is fractional or a string is not an integer.
+ */
 export declare const toXL1: (val: unknown) => XL1 | undefined;
-/** XL1 constant. */
+/** Strict constructor alias for {@link asXL1}. */
 export declare const XL1: (val: unknown) => XL1;
 //# sourceMappingURL=xl1.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"xl1.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-model/xl1/xl1.ts"],"names":[],"mappings":"AAMA,4BAA4B;AAC5B,eAAO,MAAM,WAAW,QAA6B,CAAA;AACrD,gBAAgB;AAChB,MAAM,MAAM,GAAG,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAA;CAAE,CAAA;AACnD,wDAAwD;AACxD,eAAO,MAAM,KAAK,8BAAmC,CAAA;AACrD,oDAAoD;AACpD,eAAO,MAAM,KAAK,uBAAmC,CAAA;AAErD,sBAAsB;AACtB,eAAO,MAAM,KAAK,mCAAmC,CAAA;AAErD,oBAAoB;AACpB,eAAO,MAAM,GAAG,uBAAQ,CAAA"}
+{"version":3,"file":"xl1.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-model/xl1/xl1.ts"],"names":[],"mappings":"AAMA,4FAA4F;AAC5F,eAAO,MAAM,WAAW,QAA6B,CAAA;AACrD,wFAAwF;AACxF,MAAM,MAAM,GAAG,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAA;CAAE,CAAA;AACnD,kGAAkG;AAClG,eAAO,MAAM,KAAK,8BAAmC,CAAA;AACrD;;;;GAIG;AACH,eAAO,MAAM,KAAK,uBAAmC,CAAA;AAErD;;;;;GAKG;AACH,eAAO,MAAM,KAAK,mCAAmC,CAAA;AAErD,kDAAkD;AAClD,eAAO,MAAM,GAAG,uBAAQ,CAAA"}

package/dist/neutral/modules/protocol-model/xl1/xl1MaxValue.d.ts

@@ -1,3 +1,8 @@
-/** Computes the maximum value for an XL1 unit given its decimal places. */
+/**
+ * Computes the largest count of a denomination that fits the 32-decimal-digit XL1 amount range.
+ *
+ * @param places The denomination's decimal places relative to attoXL1.
+ * @returns `10 ** (32 - places) - 1`.
+ */
 export declare const xl1MaxValue: (places: bigint) => bigint;
 //# sourceMappingURL=xl1MaxValue.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"xl1MaxValue.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-model/xl1/xl1MaxValue.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,eAAO,MAAM,WAAW,GAAI,QAAQ,MAAM,WAA+B,CAAA"}
+{"version":3,"file":"xl1MaxValue.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-model/xl1/xl1MaxValue.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,QAAQ,MAAM,WAA+B,CAAA"}

package/dist/neutral/modules/protocol-model/xl1/xl1Units.d.ts

@@ -1,9 +1,12 @@
 type XL1Units = 'xl1' | 'milli' | 'micro' | 'nano' | 'pico' | 'femto' | 'atto';
-/** Decimal place definitions for each XL1 currency unit (atto=18, femto=15, etc.). */
+/** Decimal exponent used to convert each XL1 denomination to atomic attoXL1 units. */
 export declare const XL1Places: Record<XL1Units, bigint>;
 /**
- * Convert factor by which a respective unit is multiplied to convert it to AttoXL1 or
- * by which AttoXL1 is divided to convert it to respective unit is multiplied.
+ * Number of attoXL1 in one unit of each denomination.
+ *
+ * Multiply a denomination value by its factor to obtain attoXL1; divide an
+ * attoXL1 value by the factor to obtain that denomination, subject to integer
+ * truncation by the caller's arithmetic.
  */
 export declare const AttoXL1ConvertFactor: Record<XL1Units, bigint>;
 export {};

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

@@ -1 +1 @@
-{"version":3,"file":"xl1Units.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-model/xl1/xl1Units.ts"],"names":[],"mappings":"AAAA,KAAK,QAAQ,GAAG,KAAK,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAA;AAE9E,sFAAsF;AACtF,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAQrC,CAAA;AAEV;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAQhD,CAAA"}
+{"version":3,"file":"xl1Units.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-model/xl1/xl1Units.ts"],"names":[],"mappings":"AAAA,KAAK,QAAQ,GAAG,KAAK,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAA;AAE9E,sFAAsF;AACtF,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAQrC,CAAA;AAEV;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAQhD,CAAA"}

package/dist/neutral/modules/schema/boundwitness/BlockBoundWitness.d.ts

@@ -2,6 +2,7 @@ import type { JSONSchemaType } from 'ajv';
 import type { BlockBoundWitness } from '../../protocol-lib/index.js';
 /** JSON schema for validating BlockBoundWitness payloads. */
 export declare const BlockBoundWitnessJsonSchema: JSONSchemaType<BlockBoundWitness>;
+/** Schema payload that publishes {@link BlockBoundWitnessJsonSchema} for registry-based validation. */
 export declare const BlockBoundWitnessSchemaPayload: {
     schema: "network.xyo.schema" & {
         readonly __schema: true;

package/dist/neutral/modules/schema/boundwitness/BlockBoundWitness.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BlockBoundWitness.d.ts","sourceRoot":"","sources":["../../../../../src/modules/schema/boundwitness/BlockBoundWitness.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,KAAK,CAAA;AAEzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAItD,6DAA6D;AAC7D,eAAO,MAAM,2BAA2B,EAAE,cAAc,CAAC,iBAAiB,CAoBhE,CAAA;AAIV,eAAO,MAAM,8BAA8B;;;;;;;;;;;CACmB,CAAA"}
+{"version":3,"file":"BlockBoundWitness.d.ts","sourceRoot":"","sources":["../../../../../src/modules/schema/boundwitness/BlockBoundWitness.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,KAAK,CAAA;AAEzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAItD,6DAA6D;AAC7D,eAAO,MAAM,2BAA2B,EAAE,cAAc,CAAC,iBAAiB,CAoBhE,CAAA;AAIV,uGAAuG;AACvG,eAAO,MAAM,8BAA8B;;;;;;;;;;;CACmB,CAAA"}

package/dist/neutral/modules/schema/boundwitness/BlockBoundWitnessWithStorageMeta.d.ts

@@ -3,6 +3,7 @@ import type { JSONSchemaType } from 'ajv';
 import type { BlockBoundWitness } from '../../protocol-lib/index.js';
 /** JSON schema for validating BlockBoundWitness payloads including storage metadata. */
 export declare const BlockBoundWitnessWithStorageMetaJsonSchema: JSONSchemaType<WithStorageMeta<BlockBoundWitness>>;
+/** Schema payload that publishes the storage-meta block definition for registry-based validation. */
 export declare const BlockBoundWitnessWithStorageMetaSchemaPayload: {
     schema: "network.xyo.schema" & {
         readonly __schema: true;

package/dist/neutral/modules/schema/boundwitness/BlockBoundWitnessWithStorageMeta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BlockBoundWitnessWithStorageMeta.d.ts","sourceRoot":"","sources":["../../../../../src/modules/schema/boundwitness/BlockBoundWitnessWithStorageMeta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAKtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,KAAK,CAAA;AAEzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAMtD,wFAAwF;AACxF,eAAO,MAAM,0CAA0C,EAAE,cAAc,CAAC,eAAe,CAAC,iBAAiB,CAAC,CAehG,CAAA;AAIV,eAAO,MAAM,6CAA6C;;;;;;;;;;;CACmB,CAAA"}
+{"version":3,"file":"BlockBoundWitnessWithStorageMeta.d.ts","sourceRoot":"","sources":["../../../../../src/modules/schema/boundwitness/BlockBoundWitnessWithStorageMeta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAKtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,KAAK,CAAA;AAEzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAMtD,wFAAwF;AACxF,eAAO,MAAM,0CAA0C,EAAE,cAAc,CAAC,eAAe,CAAC,iBAAiB,CAAC,CAehG,CAAA;AAIV,qGAAqG;AACrG,eAAO,MAAM,6CAA6C;;;;;;;;;;;CACmB,CAAA"}

package/dist/neutral/modules/schema/boundwitness/TransactionBoundWitness.d.ts

@@ -2,6 +2,7 @@ import type { JSONSchemaType } from 'ajv';
 import type { TransactionBoundWitness } from '../../protocol-lib/index.js';
 /** JSON schema for validating TransactionBoundWitness payloads. */
 export declare const TransactionBoundWitnessJsonSchema: JSONSchemaType<TransactionBoundWitness>;
+/** Schema payload that publishes {@link TransactionBoundWitnessJsonSchema} for registry-based validation. */
 export declare const TransactionBoundWitnessSchemaPayload: {
     schema: "network.xyo.schema" & {
         readonly __schema: true;

package/dist/neutral/modules/schema/boundwitness/TransactionBoundWitness.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TransactionBoundWitness.d.ts","sourceRoot":"","sources":["../../../../../src/modules/schema/boundwitness/TransactionBoundWitness.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,KAAK,CAAA;AAEzC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAA;AAK5D,mEAAmE;AACnE,eAAO,MAAM,iCAAiC,EAAE,cAAc,CAAC,uBAAuB,CA2B5E,CAAA;AAIV,eAAO,MAAM,oCAAoC;;;;;;;;;;;CACmB,CAAA"}
+{"version":3,"file":"TransactionBoundWitness.d.ts","sourceRoot":"","sources":["../../../../../src/modules/schema/boundwitness/TransactionBoundWitness.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,KAAK,CAAA;AAEzC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAA;AAK5D,mEAAmE;AACnE,eAAO,MAAM,iCAAiC,EAAE,cAAc,CAAC,uBAAuB,CA2B5E,CAAA;AAIV,6GAA6G;AAC7G,eAAO,MAAM,oCAAoC;;;;;;;;;;;CACmB,CAAA"}

package/dist/neutral/modules/schema/boundwitness/TransactionBoundWitnessWithStorageMeta.d.ts

@@ -2,6 +2,7 @@ import type { JSONSchemaType } from 'ajv';
 import type { TransactionBoundWitness } from '../../protocol-lib/index.js';
 /** JSON schema for validating TransactionBoundWitness payloads including storage metadata. */
 export declare const TransactionBoundWitnessWithStorageMetaJsonSchema: JSONSchemaType<TransactionBoundWitness>;
+/** Schema payload that publishes the storage-meta transaction definition for registry-based validation. */
 export declare const TransactionBoundWitnessWithStorageMetaSchemaPayload: {
     schema: "network.xyo.schema" & {
         readonly __schema: true;

package/dist/neutral/modules/schema/boundwitness/TransactionBoundWitnessWithStorageMeta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TransactionBoundWitnessWithStorageMeta.d.ts","sourceRoot":"","sources":["../../../../../src/modules/schema/boundwitness/TransactionBoundWitnessWithStorageMeta.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,KAAK,CAAA;AAEzC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAA;AAK5D,8FAA8F;AAC9F,eAAO,MAAM,gDAAgD,EAAE,cAAc,CAAC,uBAAuB,CAgB3F,CAAA;AAIV,eAAO,MAAM,mDAAmD;;;;;;;;;;;CACmB,CAAA"}
+{"version":3,"file":"TransactionBoundWitnessWithStorageMeta.d.ts","sourceRoot":"","sources":["../../../../../src/modules/schema/boundwitness/TransactionBoundWitnessWithStorageMeta.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,KAAK,CAAA;AAEzC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAA;AAK5D,8FAA8F;AAC9F,eAAO,MAAM,gDAAgD,EAAE,cAAc,CAAC,uBAAuB,CAgB3F,CAAA;AAIV,2GAA2G;AAC3G,eAAO,MAAM,mDAAmD;;;;;;;;;;;CACmB,CAAA"}

package/dist/neutral/modules/schema/mergeJsonSchemaRequired.d.ts

@@ -1,4 +1,10 @@
 import type { JSONSchemaType } from 'ajv';
+/**
+ * Normalizes an AJV `required` value to a readonly string array.
+ *
+ * @param required Candidate value from a JSON-schema definition.
+ * @returns The string itself as one item, its string array items, or an empty array.
+ */
 export declare const asRequiredStrings: (required: unknown) => readonly string[];
 /** Merge JSON schema `required` arrays without spreading untyped sdk-js values. */
 export declare const mergeJsonSchemaRequired: <T>(...groups: readonly unknown[]) => JSONSchemaType<T> extends {

package/dist/neutral/modules/schema/mergeJsonSchemaRequired.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mergeJsonSchemaRequired.d.ts","sourceRoot":"","sources":["../../../../src/modules/schema/mergeJsonSchemaRequired.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,KAAK,CAAA;AAEzC,eAAO,MAAM,iBAAiB,GAAI,UAAU,OAAO,KAAG,SAAS,MAAM,EAIpE,CAAA;AAED,mFAAmF;AACnF,eAAO,MAAM,uBAAuB,GAAI,CAAC,EACvC,GAAG,QAAQ,SAAS,OAAO,EAAE,KAC5B,cAAc,CAAC,CAAC,CAAC,SAAS;IAAE,QAAQ,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,GAAG,KAExD,CAAA"}
+{"version":3,"file":"mergeJsonSchemaRequired.d.ts","sourceRoot":"","sources":["../../../../src/modules/schema/mergeJsonSchemaRequired.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,KAAK,CAAA;AAEzC;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,UAAU,OAAO,KAAG,SAAS,MAAM,EAIpE,CAAA;AAED,mFAAmF;AACnF,eAAO,MAAM,uBAAuB,GAAI,CAAC,EACvC,GAAG,QAAQ,SAAS,OAAO,EAAE,KAC5B,cAAc,CAAC,CAAC,CAAC,SAAS;IAAE,QAAQ,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,GAAG,KAExD,CAAA"}

package/dist/neutral/modules/schema/payload/ChainStakeIntent.d.ts

@@ -2,6 +2,7 @@ import type { JSONSchemaType } from 'ajv';
 import type { ChainStakeIntent } from '../../protocol-lib/index.js';
 /** JSON schema for validating ChainStakeIntent payloads. */
 export declare const ChainStakeIntentPayloadJsonSchema: JSONSchemaType<ChainStakeIntent>;
+/** Schema payload that publishes {@link ChainStakeIntentPayloadJsonSchema} for registry-based validation. */
 export declare const ChainStakeIntentPayloadJsonSchemaPayload: {
     schema: "network.xyo.schema" & {
         readonly __schema: true;

package/dist/neutral/modules/schema/payload/ChainStakeIntent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChainStakeIntent.d.ts","sourceRoot":"","sources":["../../../../../src/modules/schema/payload/ChainStakeIntent.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,KAAK,CAAA;AAEzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAKrD,4DAA4D;AAC5D,eAAO,MAAM,iCAAiC,EAAE,cAAc,CAAC,gBAAgB,CAa9E,CAAA;AAID,eAAO,MAAM,wCAAwC;;;;;;;;;;;CACe,CAAA"}
+{"version":3,"file":"ChainStakeIntent.d.ts","sourceRoot":"","sources":["../../../../../src/modules/schema/payload/ChainStakeIntent.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,KAAK,CAAA;AAEzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAKrD,4DAA4D;AAC5D,eAAO,MAAM,iCAAiC,EAAE,cAAc,CAAC,gBAAgB,CAa9E,CAAA;AAID,6GAA6G;AAC7G,eAAO,MAAM,wCAAwC;;;;;;;;;;;CACe,CAAA"}

package/dist/neutral/modules/schema/payload/HashPayload.d.ts

@@ -2,6 +2,7 @@ import type { JSONSchemaType } from 'ajv';
 import type { HashPayload } from '../../protocol-lib/index.js';
 /** JSON schema for validating Hash payloads. */
 export declare const HashPayloadJsonSchema: JSONSchemaType<HashPayload>;
+/** Schema payload that publishes {@link HashPayloadJsonSchema} for registry-based validation. */
 export declare const HashPayloadJsonSchemaPayload: {
     schema: "network.xyo.schema" & {
         readonly __schema: true;

package/dist/neutral/modules/schema/payload/HashPayload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HashPayload.d.ts","sourceRoot":"","sources":["../../../../../src/modules/schema/payload/HashPayload.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,KAAK,CAAA;AAEzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAKhD,gDAAgD;AAChD,eAAO,MAAM,qBAAqB,EAAE,cAAc,CAAC,WAAW,CAY7D,CAAA;AAID,eAAO,MAAM,4BAA4B;;;;;;;;;;;CACe,CAAA"}
+{"version":3,"file":"HashPayload.d.ts","sourceRoot":"","sources":["../../../../../src/modules/schema/payload/HashPayload.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,KAAK,CAAA;AAEzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAKhD,gDAAgD;AAChD,eAAO,MAAM,qBAAqB,EAAE,cAAc,CAAC,WAAW,CAY7D,CAAA;AAID,iGAAiG;AACjG,eAAO,MAAM,4BAA4B;;;;;;;;;;;CACe,CAAA"}

package/dist/neutral/modules/schema/payload/TransferPayload.d.ts

@@ -2,6 +2,7 @@ import type { JSONSchemaType } from 'ajv';
 import type { Transfer } from '../../protocol-lib/index.js';
 /** JSON schema for validating Transfer payloads. */
 export declare const TransferPayloadJsonSchema: JSONSchemaType<Transfer>;
+/** Schema payload that publishes {@link TransferPayloadJsonSchema} for registry-based validation. */
 export declare const TransferPayloadJsonSchemaPayload: {
     schema: "network.xyo.schema" & {
         readonly __schema: true;

package/dist/neutral/modules/schema/payload/TransferPayload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TransferPayload.d.ts","sourceRoot":"","sources":["../../../../../src/modules/schema/payload/TransferPayload.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,KAAK,CAAA;AAEzC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAK7C,oDAAoD;AACpD,eAAO,MAAM,yBAAyB,EAAE,cAAc,CAAC,QAAQ,CAkB9D,CAAA;AAID,eAAO,MAAM,gCAAgC;;;;;;;;;;;CACe,CAAA"}
+{"version":3,"file":"TransferPayload.d.ts","sourceRoot":"","sources":["../../../../../src/modules/schema/payload/TransferPayload.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,KAAK,CAAA;AAEzC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAK7C,oDAAoD;AACpD,eAAO,MAAM,yBAAyB,EAAE,cAAc,CAAC,QAAQ,CAkB9D,CAAA;AAID,qGAAqG;AACrG,eAAO,MAAM,gCAAgC;;;;;;;;;;;CACe,CAAA"}

package/dist/neutral/modules/test/buildRandomTransaction.d.ts

@@ -1,4 +1,11 @@
 import type { AccountInstance, Payload, Schema, XyoAddress } from '@xyo-network/sdk';
 import type { ChainId, SignedHydratedTransactionWithHashMeta, XL1BlockNumber } from '../protocol-lib/index.js';
+/**
+ * Builds a signed test transaction, creating a random sender and minimal
+ * transfer payload when the caller does not supply them.
+ *
+ * Payloads with schemas listed in `privatePayloadSchemas` are omitted from the
+ * returned hydrated payload array after signing.
+ */
 export declare const buildRandomTransaction: (chain: ChainId, payloads?: Payload[], account?: AccountInstance, nbf?: XL1BlockNumber, exp?: XL1BlockNumber, privatePayloadSchemas?: Schema[], receiverAddress?: XyoAddress) => Promise<SignedHydratedTransactionWithHashMeta>;
 //# sourceMappingURL=buildRandomTransaction.d.ts.map

package/dist/neutral/modules/test/buildRandomTransaction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buildRandomTransaction.d.ts","sourceRoot":"","sources":["../../../../src/modules/test/buildRandomTransaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAC7C,MAAM,kBAAkB,CAAA;AAGzB,OAAO,KAAK,EAEV,OAAO,EACP,qCAAqC,EACrC,cAAc,EACf,MAAM,eAAe,CAAA;AAMtB,eAAO,MAAM,sBAAsB,GACjC,OAAO,OAAO,EACd,WAAW,OAAO,EAAE,EACpB,UAAU,eAAe,EACzB,MAAK,cAA0C,EAC/C,MAAK,cAAmD,EACxD,wBAAuB,MAAM,EAAO,EACpC,kBAAkB,UAAU,KAC3B,OAAO,CAAC,qCAAqC,CAgB/C,CAAA"}
+{"version":3,"file":"buildRandomTransaction.d.ts","sourceRoot":"","sources":["../../../../src/modules/test/buildRandomTransaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAC7C,MAAM,kBAAkB,CAAA;AAGzB,OAAO,KAAK,EAEV,OAAO,EACP,qCAAqC,EACrC,cAAc,EACf,MAAM,eAAe,CAAA;AAMtB;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GACjC,OAAO,OAAO,EACd,WAAW,OAAO,EAAE,EACpB,UAAU,eAAe,EACzB,MAAK,cAA0C,EAC/C,MAAK,cAAmD,EACxD,wBAAuB,MAAM,EAAO,EACpC,kBAAkB,UAAU,KAC3B,OAAO,CAAC,qCAAqC,CAgB/C,CAAA"}

package/dist/neutral/modules/test/buildTransaction.d.ts

@@ -1,4 +1,12 @@
 import type { AccountInstance, Payload, XyoAddress } from '@xyo-network/sdk';
 import type { AllowedBlockPayload, ChainId, SignedHydratedTransactionWithHashMeta, TransactionFeesBigInt, XL1BlockNumber } from '../protocol-lib/index.js';
+/**
+ * Builds and signs a hydrated XL1 transaction for protocol tests.
+ *
+ * On-chain payload hashes are added to the elevation script; off-chain payloads
+ * remain referenced by the bound witness without elevation.
+ *
+ * @throws When multiple signers are supplied without an explicit source address.
+ */
 export declare function buildTransaction(chain: ChainId, onChainPayloads: AllowedBlockPayload[], offChainPayloads: Payload[], signer: AccountInstance | AccountInstance[], nbf: XL1BlockNumber, exp: XL1BlockNumber, from?: XyoAddress, fees?: TransactionFeesBigInt): Promise<SignedHydratedTransactionWithHashMeta>;
 //# sourceMappingURL=buildTransaction.d.ts.map

package/dist/neutral/modules/test/buildTransaction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buildTransaction.d.ts","sourceRoot":"","sources":["../../../../src/modules/test/buildTransaction.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,eAAe,EAAE,OAAO,EAAE,UAAU,EACrC,MAAM,kBAAkB,CAAA;AAKzB,OAAO,KAAK,EACV,mBAAmB,EACnB,OAAO,EAGP,qCAAqC,EAGrC,qBAAqB,EACrB,cAAc,EACf,MAAM,eAAe,CAAA;AAGtB,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,OAAO,EACd,eAAe,EAAE,mBAAmB,EAAE,EACtC,gBAAgB,EAAE,OAAO,EAAE,EAC3B,MAAM,EAAE,eAAe,GAAG,eAAe,EAAE,EAC3C,GAAG,EAAE,cAAc,EACnB,GAAG,EAAE,cAAc,EACnB,IAAI,CAAC,EAAE,UAAU,EACjB,IAAI,GAAE,qBAA8C,GACnD,OAAO,CAAC,qCAAqC,CAAC,CAsChD"}
+{"version":3,"file":"buildTransaction.d.ts","sourceRoot":"","sources":["../../../../src/modules/test/buildTransaction.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,eAAe,EAAE,OAAO,EAAE,UAAU,EACrC,MAAM,kBAAkB,CAAA;AAKzB,OAAO,KAAK,EACV,mBAAmB,EACnB,OAAO,EAGP,qCAAqC,EAGrC,qBAAqB,EACrB,cAAc,EACf,MAAM,eAAe,CAAA;AAGtB;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,OAAO,EACd,eAAe,EAAE,mBAAmB,EAAE,EACtC,gBAAgB,EAAE,OAAO,EAAE,EAC3B,MAAM,EAAE,eAAe,GAAG,eAAe,EAAE,EAC3C,GAAG,EAAE,cAAc,EACnB,GAAG,EAAE,cAAc,EACnB,IAAI,CAAC,EAAE,UAAU,EACjB,IAAI,GAAE,qBAA8C,GACnD,OAAO,CAAC,qCAAqC,CAAC,CAsChD"}

package/dist/neutral/modules/test/createTransferPayload.d.ts

@@ -1,5 +1,6 @@
 import type { JsonObject } from '@ariestools/sdk';
 import type { XyoAddress } from '@xyo-network/sdk';
 import type { Transfer } from '../protocol-lib/index.js';
+/** Creates an XL1 transfer payload with hex-encoded attoXL1 amounts and the current epoch timestamp. */
 export declare function createTransferPayload(from: XyoAddress, transfers: Record<XyoAddress, bigint>, context?: JsonObject): Transfer;
 //# sourceMappingURL=createTransferPayload.d.ts.map

package/dist/neutral/modules/test/createTransferPayload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createTransferPayload.d.ts","sourceRoot":"","sources":["../../../../src/modules/test/createTransferPayload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAGlD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAG7C,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,QAAQ,CAQ7H"}
+{"version":3,"file":"createTransferPayload.d.ts","sourceRoot":"","sources":["../../../../src/modules/test/createTransferPayload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAGlD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAG7C,wGAAwG;AACxG,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,QAAQ,CAQ7H"}

package/dist/neutral/modules/validation/transaction/validators/SignerAuthorization.d.ts

@@ -36,8 +36,11 @@ export declare const SignerAuthorizationZod: z.ZodDiscriminatedUnion<[z.ZodObjec
         readonly __address: true;
     }, string>>, import("zod/mini").ZodMiniPipe<import("zod/mini").ZodMiniString<string>, import("zod/mini").ZodMiniTransform<import("@xyo-network/sdk").XyoQuantAddress, string>>]>>;
 }, z.core.$strip>], "type">;
+/** Type-level representation of Completed Step Reward Authorization. */
 export type CompletedStepRewardAuthorization = z.infer<typeof CompletedStepRewardAuthorizationZod>;
+/** Type-level representation of Derived Receive Authorization. */
 export type DerivedReceiveAuthorization = z.infer<typeof DerivedReceiveAuthorizationZod>;
+/** Type-level representation of Signer Authorization. */
 export type SignerAuthorization = z.infer<typeof SignerAuthorizationZod>;
 /**
  * Builds the `SignerValidator[]` consumed by `TransactionTransfersValidatorFactory` from a list

package/dist/neutral/modules/validation/transaction/validators/SignerAuthorization.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SignerAuthorization.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/validation/transaction/validators/SignerAuthorization.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAA;AAKzE,iFAAiF;AACjF,eAAO,MAAM,mCAAmC;;;;;;;iBAGqB,CAAA;AAErE,0FAA0F;AAC1F,eAAO,MAAM,8BAA8B;;;;;;;;iBAImC,CAAA;AAE9E,+FAA+F;AAC/F,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;2BAGjC,CAAA;AAEF,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAA;AAClG,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAA;AACxF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAkBxE;;;;GAIG;AACH,wBAAgB,kCAAkC,CAAC,cAAc,GAAE,mBAAmB,EAAO,GAAG,eAAe,EAAE,CAEhH"}
+{"version":3,"file":"SignerAuthorization.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/validation/transaction/validators/SignerAuthorization.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAA;AAKzE,iFAAiF;AACjF,eAAO,MAAM,mCAAmC;;;;;;;iBAGqB,CAAA;AAErE,0FAA0F;AAC1F,eAAO,MAAM,8BAA8B;;;;;;;;iBAImC,CAAA;AAE9E,+FAA+F;AAC/F,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;2BAGjC,CAAA;AAEF,wEAAwE;AACxE,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAA;AAClG,kEAAkE;AAClE,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAA;AACxF,yDAAyD;AACzD,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAkBxE;;;;GAIG;AACH,wBAAgB,kCAAkC,CAAC,cAAc,GAAE,mBAAmB,EAAO,GAAG,eAAe,EAAE,CAEhH"}

package/dist/neutral/network-model.mjs

@@ -121,6 +121,8 @@ var ChainContractBlockNumberZod = NumberishZod.pipe(z.int().nonnegative()).trans
 var ChainContractManifestSchema = "network.xyo.s3.chain.contract";
 var CHAIN_CONTRACT_MANIFEST_VERSION = 1;
 var ChainContractManifestZod = z.object({
+  /** Self-identifying chain id (matches the path key). Optional for older fixtures. */
+  chainId: z.optional(ChainIdZod),
   forkedAtBlockNumber: ChainContractBlockNumberZod.nullable().optional(),
   forkedAtHash: z.string().nullable().optional(),
   forkedChainId: z.nullable(ChainIdZod).optional(),
@@ -151,7 +153,7 @@ import { z as z2 } from "zod";
 
 // src/modules/network-model/staticRest/paths/chainState.ts
 var headPath = () => "chain/head.json";
-var chainContractPath = () => "chain/contract.json";
+var chainContractByIdPath = (chainId) => `chain/contracts/${chainId.toLowerCase()}.json`;
 
 // src/modules/network-model/staticRest/paths/finalized.ts
 var manifestPath = () => "manifest.json";
@@ -377,8 +379,16 @@ function evmEventIndexTailPath(address) {
 
 // src/modules/network-model/utils/ExplorerLinks.ts
 var ExplorerLinks = class {
+  /** Explorer origin with trailing slashes removed. */
   explorerUrl;
+  /** Network identifier included in generated links. */
   networkId;
+  /**
+   * Creates a link builder for one explorer deployment and network.
+   *
+   * @param explorerUrl Base explorer URL, with or without trailing slashes.
+   * @param networkId Network segment included in every generated URL.
+   */
   constructor(explorerUrl, networkId) {
     this.explorerUrl = explorerUrl.replace(/\/+$/, "");
     this.networkId = networkId;
@@ -467,7 +477,7 @@ export {
   blockHashPathTemplate,
   blockNumberPath,
   blockNumberPathTemplate,
-  chainContractPath,
+  chainContractByIdPath,
   chainManifestPathTemplates,
   createChainContractManifest,
   createChainManifest,