@xyo-network/xl1-protocol 5.4.0 → 5.4.1

package/README.md

@@ -76,6 +76,82 @@ Available subpaths:
 - Use `schema` and `validation` at serialization, storage, and chain-validation boundaries.
 - Use `@xyo-network/xl1-sdk` when you need concrete gateway, RPC, or provider implementations.
 
+## Payload schemas, revisions, and identity
+
+XYO schema identifiers use nonempty, dot-separated segments containing only ASCII
+lowercase letters and digits: `^(?:[a-z0-9]+\.)*[a-z0-9]+$`. Hyphens, underscores,
+Unicode, whitespace, empty segments, and URL syntax are not allowed. Namespace
+ownership and publication rules are separate from this lexical validation. Do not
+strip punctuation from an actual domain to invent a namespace you do not own.
+
+Keep schema identifiers stable. Suffixes such as `.v1`, `.v01`, and `.1` are an
+**anti-pattern for payload revisioning**. Do not silently rename an existing
+published identifier. Keep external API/product versions in clearly named data
+fields instead of conflating them with the payload contract revision.
+
+The optional `$version` metadata field identifies the payload contract revision:
+
+```json
+{
+  "schema": "com.example.observation",
+  "$version": 1002003,
+  "temperatureCelsius": 23
+}
+```
+
+The encoding is `major * 1_000_000 + minor * 1_000 + patch`, with each component
+in `0..999`. Thus `1002003` means `1.2.3`. Values must be integers in
+`0..999999999`; strings, null, fractions, and out-of-range numbers are invalid.
+Absence permanently means `1000000` (1.0.0). Readers interpret this default
+without adding it to the original payload. An omitted version and an explicitly
+written 1.0.0 can have different root hashes.
+
+**Use root hashes for almost all application operations.** Use
+`PayloadBuilder.hash(payload)` or a verified `_hash` for identity, references,
+commitments, deduplication, and validation caches. Do not use `dataHash` or
+`_dataHash` for those purposes: data hashes exclude `$version` and all other
+client metadata. Root hashes include client metadata and exclude storage
+metadata (`_` fields). A recomputed hash establishes integrity only when compared
+with an expected hash authenticated by the surrounding protocol.
+
+Bound-witness signing is an intentional exception: signatures continue to cover
+the data hash because signatures are themselves metadata. A bound witness's own
+signature does **not** authenticate its own `$version`. A signed parent reference
+to a child's root hash does bind the child's metadata. Existing protocols that
+explicitly require data-hash references retain that contract until a separately
+reviewed migration; this guidance does not authorize replacing those hashes.
+
+Validation must check the exact schema, version format, a deliberately supported
+revision, the body, and the relevant signature/reference/authorization rules.
+Validate `$version` before any metadata-stripping projection. Do not select
+weaker consensus, authorization, or signature rules using unauthenticated
+metadata, and never try older validators until one accepts the body. A format
+check or a schema-only predicate is not complete contract validation.
+
+This implementation recognizes **XL1 built-in payload revision 1.0.0** at its
+block/transaction contracts, direct Transfer/Claim/Time guards, elevated-payload
+admission gate, and six exported payload/bound-witness JSON schemas. For example,
+`isTransferPayload` checks both the complete Transfer body and supported revision.
+Generic hydrated application payloads retain their independent revisions; an
+application must supply its own supported-revision/body validator. The existing
+signed block `protocol` field is a different version and remains unchanged.
+
+Published `(schema, effective version)` definitions are immutable. That is
+separate from object closure: a closed object rejects unknown fields, while an
+open object explicitly permits them. Set the policy for nested objects and
+metadata too. Evaluate old readers receiving new data and new readers replaying
+old data before calling a change compatible. In particular, widening an existing
+field's type is not automatically safe. See the canonical
+[XYO contract and compatibility rules](https://github.com/XYOracleNetwork/sdk-protocol-js/blob/main/packages/sdk-protocol-core/README.md#payload-schema-contracts).
+
+This checkout adopts published `@xyo-network/sdk` 7.4.0 and
+`@xyo-network/sdk-protocol` 7.4.2. This dependency upgrade does not activate network
+rules. Upgrading validators can reject arbitrary `$version` metadata that older
+software ignored. Audit historical data and plan any admission/replay activation
+before deployment. The repository's
+[implementation and rollout notes](https://github.com/XYOracleNetwork/xl1-protocol/blob/main/PAYLOAD-SCHEMA-VERSIONING.md)
+describe the current coverage and remaining work.
+
 ## AI Agent Skills
 
 Install the recommended XL1/XYO skills with [Skills.sh](https://skills.sh):

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

@@ -1,7 +1,9 @@
 import { z } from 'zod';
 import { type XL1BlockNumber } from '../../../protocol-lib/index.js';
 /** Schema id for the chain-contract manifest document. */
-export declare const ChainContractManifestSchema: "network.xyo.s3.chain.contract";
+export declare const ChainContractManifestSchema: "network.xyo.s3.chain.contract" & {
+    readonly __schema: true;
+};
 /** Type literal for the chain-contract manifest schema. */
 export type ChainContractManifestSchema = typeof ChainContractManifestSchema;
 /** Bumped when the manifest shape changes, so readers can detect a mismatch. */
@@ -18,7 +20,9 @@ export declare const ChainContractManifestZod: z.ZodObject<{
     forkedChainId: z.ZodOptional<z.ZodNullable<import("zod/mini").ZodMiniPipe<import("zod/mini").ZodMiniString<string>, import("zod/mini").ZodMiniTransform<import("@ariestools/sdk").BrandedHex, string>>>>;
     minWithdrawalBlocks: z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBigInt]>, z.ZodTransform<number, string | number | bigint>>, z.ZodNumber>, z.ZodInt>;
     rewardsContract: z.ZodString;
-    schema: z.ZodLiteral<"network.xyo.s3.chain.contract">;
+    schema: z.ZodLiteral<"network.xyo.s3.chain.contract" & {
+        readonly __schema: true;
+    }>;
     stakingTokenAddress: z.ZodString;
     version: z.ZodInt;
 }, z.core.$strip>;
@@ -30,7 +34,9 @@ export type ChainContractManifestInput = z.input<typeof ChainContractManifestZod
 export declare const isChainContractManifest: <T>(value: T) => value is T & {
     minWithdrawalBlocks: number;
     rewardsContract: string;
-    schema: "network.xyo.s3.chain.contract";
+    schema: "network.xyo.s3.chain.contract" & {
+        readonly __schema: true;
+    };
     stakingTokenAddress: string;
     version: number;
     chainId?: import("@ariestools/sdk").BrandedHex | undefined;
@@ -43,7 +49,9 @@ export declare const asChainContractManifest: {
     <T>(value: T): (T & {
         minWithdrawalBlocks: number;
         rewardsContract: string;
-        schema: "network.xyo.s3.chain.contract";
+        schema: "network.xyo.s3.chain.contract" & {
+            readonly __schema: true;
+        };
         stakingTokenAddress: string;
         version: number;
         chainId?: import("@ariestools/sdk").BrandedHex | undefined;
@@ -54,7 +62,9 @@ export declare const asChainContractManifest: {
     <T>(value: T, assert: import("@ariestools/sdk").ZodFactoryConfig): T & {
         minWithdrawalBlocks: number;
         rewardsContract: string;
-        schema: "network.xyo.s3.chain.contract";
+        schema: "network.xyo.s3.chain.contract" & {
+            readonly __schema: true;
+        };
         stakingTokenAddress: string;
         version: number;
         chainId?: import("@ariestools/sdk").BrandedHex | undefined;
@@ -68,7 +78,9 @@ export declare const toChainContractManifest: {
     (value: unknown): {
         minWithdrawalBlocks: number;
         rewardsContract: string;
-        schema: "network.xyo.s3.chain.contract";
+        schema: "network.xyo.s3.chain.contract" & {
+            readonly __schema: true;
+        };
         stakingTokenAddress: string;
         version: number;
         chainId?: import("@ariestools/sdk").BrandedHex | undefined;
@@ -79,7 +91,9 @@ export declare const toChainContractManifest: {
     (value: unknown, assert: import("@ariestools/sdk").ZodFactoryConfig): {
         minWithdrawalBlocks: number;
         rewardsContract: string;
-        schema: "network.xyo.s3.chain.contract";
+        schema: "network.xyo.s3.chain.contract" & {
+            readonly __schema: true;
+        };
         stakingTokenAddress: string;
         version: number;
         chainId?: import("@ariestools/sdk").BrandedHex | undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"chainContractManifest.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/network-model/staticRest/layout/chainContractManifest.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EACqB,KAAK,cAAc,EAC9C,MAAM,eAAe,CAAA;AAMtB,0DAA0D;AAC1D,eAAO,MAAM,2BAA2B,EAAG,+BAAwC,CAAA;AACnF,2DAA2D;AAC3D,MAAM,MAAM,2BAA2B,GAAG,OAAO,2BAA2B,CAAA;AAE5E,gFAAgF;AAChF,eAAO,MAAM,+BAA+B,IAAI,CAAA;AAEhD;;;;GAIG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;iBAWnC,CAAA;AAEF,gFAAgF;AAChF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAE5E,qFAAqF;AACrF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAEjF,0EAA0E;AAC1E,eAAO,MAAM,uBAAuB;;;;;;;;;;CAAyC,CAAA;AAC7E,sEAAsE;AACtE,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;CAAoE,CAAA;AACxG,oDAAoD;AACpD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;CAAoE,CAAA;AAExG,kDAAkD;AAClD,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,IAAI,CAAC,0BAA0B,EAAE,QAAQ,GAAG,SAAS,CAAC,GAC7D,qBAAqB,CAMvB"}
+{"version":3,"file":"chainContractManifest.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/network-model/staticRest/layout/chainContractManifest.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EACqB,KAAK,cAAc,EAC9C,MAAM,eAAe,CAAA;AAMtB,0DAA0D;AAC1D,eAAO,MAAM,2BAA2B;;CAAkD,CAAA;AAC1F,2DAA2D;AAC3D,MAAM,MAAM,2BAA2B,GAAG,OAAO,2BAA2B,CAAA;AAE5E,gFAAgF;AAChF,eAAO,MAAM,+BAA+B,IAAI,CAAA;AAEhD;;;;GAIG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;iBAWnC,CAAA;AAEF,gFAAgF;AAChF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAE5E,qFAAqF;AACrF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAEjF,0EAA0E;AAC1E,eAAO,MAAM,uBAAuB;;;;;;;;;;;;CAAyC,CAAA;AAC7E,sEAAsE;AACtE,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAoE,CAAA;AACxG,oDAAoD;AACpD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAoE,CAAA;AAExG,kDAAkD;AAClD,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,IAAI,CAAC,0BAA0B,EAAE,QAAQ,GAAG,SAAS,CAAC,GAC7D,qBAAqB,CAMvB"}

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

@@ -2,7 +2,9 @@ import { z } from 'zod';
 /** Bumped when the finalized layout changes shape, so readers can detect a mismatch. */
 export declare const CHAIN_LAYOUT_VERSION = 1;
 /** Schema id for the finalized layout manifest document. */
-export declare const ChainManifestSchema: "network.xyo.s3.chain.manifest";
+export declare const ChainManifestSchema: "network.xyo.s3.chain.manifest" & {
+    readonly __schema: true;
+};
 /** Type literal for the chain manifest schema. */
 export type ChainManifestSchema = typeof ChainManifestSchema;
 /** Path templates for the finalized + chain-state files. */
@@ -24,7 +26,9 @@ export declare const ChainManifestZod: z.ZodObject<{
         head: z.ZodString;
         payload: z.ZodString;
     }, z.core.$strip>;
-    schema: z.ZodLiteral<"network.xyo.s3.chain.manifest">;
+    schema: z.ZodLiteral<"network.xyo.s3.chain.manifest" & {
+        readonly __schema: true;
+    }>;
     version: z.ZodInt;
 }, z.core.$strip>;
 /** The finalized layout descriptor at `manifestPath()`. */
@@ -39,7 +43,9 @@ export declare const isChainManifest: <T>(value: T) => value is T & {
         head: string;
         payload: string;
     };
-    schema: "network.xyo.s3.chain.manifest";
+    schema: "network.xyo.s3.chain.manifest" & {
+        readonly __schema: true;
+    };
     version: number;
 };
 /** Converts a value to ChainManifest, throwing if invalid. */
@@ -53,7 +59,9 @@ export declare const asChainManifest: {
             head: string;
             payload: string;
         };
-        schema: "network.xyo.s3.chain.manifest";
+        schema: "network.xyo.s3.chain.manifest" & {
+            readonly __schema: true;
+        };
         version: number;
     }) | undefined;
     <T>(value: T, assert: import("@ariestools/sdk").ZodFactoryConfig): T & {
@@ -65,7 +73,9 @@ export declare const asChainManifest: {
             head: string;
             payload: string;
         };
-        schema: "network.xyo.s3.chain.manifest";
+        schema: "network.xyo.s3.chain.manifest" & {
+            readonly __schema: true;
+        };
         version: number;
     };
 };
@@ -80,7 +90,9 @@ export declare const toChainManifest: {
             head: string;
             payload: string;
         };
-        schema: "network.xyo.s3.chain.manifest";
+        schema: "network.xyo.s3.chain.manifest" & {
+            readonly __schema: true;
+        };
         version: number;
     } | undefined;
     (value: unknown, assert: import("@ariestools/sdk").ZodFactoryConfig): {
@@ -92,7 +104,9 @@ export declare const toChainManifest: {
             head: string;
             payload: string;
         };
-        schema: "network.xyo.s3.chain.manifest";
+        schema: "network.xyo.s3.chain.manifest" & {
+            readonly __schema: true;
+        };
         version: number;
     };
 };

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

@@ -1 +1 @@
-{"version":3,"file":"chainManifest.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/network-model/staticRest/layout/chainManifest.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,wFAAwF;AACxF,eAAO,MAAM,oBAAoB,IAAI,CAAA;AAErC,4DAA4D;AAC5D,eAAO,MAAM,mBAAmB,EAAG,+BAAwC,CAAA;AAC3E,kDAAkD;AAClD,MAAM,MAAM,mBAAmB,GAAG,OAAO,mBAAmB,CAAA;AAE5D,4DAA4D;AAC5D,eAAO,MAAM,qBAAqB;;;;;iBAKhC,CAAA;AAEF,8CAA8C;AAC9C,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEtE,0EAA0E;AAC1E,eAAO,MAAM,gBAAgB;;;;;;;;;;;iBAQ3B,CAAA;AAEF,2DAA2D;AAC3D,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,4FAA4F;AAC5F,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,SAAI,GAAG,aAAa,CAQtF"}
+{"version":3,"file":"chainManifest.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/network-model/staticRest/layout/chainManifest.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,wFAAwF;AACxF,eAAO,MAAM,oBAAoB,IAAI,CAAA;AAErC,4DAA4D;AAC5D,eAAO,MAAM,mBAAmB;;CAAkD,CAAA;AAClF,kDAAkD;AAClD,MAAM,MAAM,mBAAmB,GAAG,OAAO,mBAAmB,CAAA;AAE5D,4DAA4D;AAC5D,eAAO,MAAM,qBAAqB;;;;;iBAKhC,CAAA;AAEF,8CAA8C;AAC9C,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEtE,0EAA0E;AAC1E,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;iBAQ3B,CAAA;AAEF,2DAA2D;AAC3D,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,4FAA4F;AAC5F,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,SAAI,GAAG,aAAa,CAQtF"}

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

@@ -3,11 +3,15 @@ import type { IndexSummaryFamily, IndexWatermark } from '../../../protocol-lib/i
 /** 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";
+export declare const IndexManifestSchema: "network.xyo.s3.index.manifest" & {
+    readonly __schema: true;
+};
 /** 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";
+export declare const IndexHeadSchema: "network.xyo.s3.index.head" & {
+    readonly __schema: true;
+};
 /** Type literal for the index head schema. */
 export type IndexHeadSchema = typeof IndexHeadSchema;
 /** Per-family descriptor carried in the manifest. */
@@ -37,7 +41,9 @@ export declare const IndexManifestZod: z.ZodObject<{
             path: z.ZodString;
         }, z.core.$strip>;
     }, z.core.$strip>;
-    schema: z.ZodLiteral<"network.xyo.s3.index.manifest">;
+    schema: z.ZodLiteral<"network.xyo.s3.index.manifest" & {
+        readonly __schema: true;
+    }>;
     version: z.ZodInt;
 }, z.core.$strip>;
 /** The static index layout descriptor at `indexManifestPath()`. */
@@ -62,7 +68,9 @@ export declare const isIndexManifest: <T>(value: T) => value is T & {
             path: string;
         };
     };
-    schema: "network.xyo.s3.index.manifest";
+    schema: "network.xyo.s3.index.manifest" & {
+        readonly __schema: true;
+    };
     version: number;
 };
 /** Converts a value to IndexManifest, throwing if invalid. */
@@ -86,7 +94,9 @@ export declare const asIndexManifest: {
                 path: string;
             };
         };
-        schema: "network.xyo.s3.index.manifest";
+        schema: "network.xyo.s3.index.manifest" & {
+            readonly __schema: true;
+        };
         version: number;
     }) | undefined;
     <T>(value: T, assert: import("@ariestools/sdk").ZodFactoryConfig): T & {
@@ -108,7 +118,9 @@ export declare const asIndexManifest: {
                 path: string;
             };
         };
-        schema: "network.xyo.s3.index.manifest";
+        schema: "network.xyo.s3.index.manifest" & {
+            readonly __schema: true;
+        };
         version: number;
     };
 };
@@ -133,7 +145,9 @@ export declare const toIndexManifest: {
                 path: string;
             };
         };
-        schema: "network.xyo.s3.index.manifest";
+        schema: "network.xyo.s3.index.manifest" & {
+            readonly __schema: true;
+        };
         version: number;
     } | undefined;
     (value: unknown, assert: import("@ariestools/sdk").ZodFactoryConfig): {
@@ -155,7 +169,9 @@ export declare const toIndexManifest: {
                 path: string;
             };
         };
-        schema: "network.xyo.s3.index.manifest";
+        schema: "network.xyo.s3.index.manifest" & {
+            readonly __schema: true;
+        };
         version: number;
     };
 };
@@ -176,7 +192,9 @@ export declare const IndexHeadZod: z.ZodObject<{
         transfers: z.ZodInt;
     }, z.core.$strip>;
     hash: z.ZodString;
-    schema: z.ZodLiteral<"network.xyo.s3.index.head">;
+    schema: z.ZodLiteral<"network.xyo.s3.index.head" & {
+        readonly __schema: true;
+    }>;
     updatedAt: z.ZodString;
     version: z.ZodInt;
 }, z.core.$strip>;
@@ -192,7 +210,9 @@ export declare const isIndexHead: <T>(value: T) => value is T & {
         transfers: number;
     };
     hash: string;
-    schema: "network.xyo.s3.index.head";
+    schema: "network.xyo.s3.index.head" & {
+        readonly __schema: true;
+    };
     updatedAt: string;
     version: number;
 };
@@ -207,7 +227,9 @@ export declare const asIndexHead: {
             transfers: number;
         };
         hash: string;
-        schema: "network.xyo.s3.index.head";
+        schema: "network.xyo.s3.index.head" & {
+            readonly __schema: true;
+        };
         updatedAt: string;
         version: number;
     }) | undefined;
@@ -220,7 +242,9 @@ export declare const asIndexHead: {
             transfers: number;
         };
         hash: string;
-        schema: "network.xyo.s3.index.head";
+        schema: "network.xyo.s3.index.head" & {
+            readonly __schema: true;
+        };
         updatedAt: string;
         version: number;
     };
@@ -236,7 +260,9 @@ export declare const toIndexHead: {
             transfers: number;
         };
         hash: string;
-        schema: "network.xyo.s3.index.head";
+        schema: "network.xyo.s3.index.head" & {
+            readonly __schema: true;
+        };
         updatedAt: string;
         version: number;
     } | undefined;
@@ -249,7 +275,9 @@ export declare const toIndexHead: {
             transfers: number;
         };
         hash: string;
-        schema: "network.xyo.s3.index.head";
+        schema: "network.xyo.s3.index.head" & {
+            readonly __schema: true;
+        };
         updatedAt: string;
         version: number;
     };

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

@@ -1 +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"}
+{"version":3,"file":"indexManifest.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/network-model/staticRest/layout/indexManifest.ts"],"names":[],"mappings":"AAIA,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;;CAAkD,CAAA;AAClF,kDAAkD;AAClD,MAAM,MAAM,mBAAmB,GAAG,OAAO,mBAAmB,CAAA;AAE5D,sEAAsE;AACtE,eAAO,MAAM,eAAe;;CAA8C,CAAA;AAC1E,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/protocol-model/RecordKeyType.d.ts

@@ -1,4 +1,4 @@
 /** Utility type that constrains T to valid record key types (string, number, or symbol) */
 /** Validated data representation for Record Key Type. */
-export type RecordKeyType<T = keyof any> = T extends keyof any ? T : never;
+export type RecordKeyType<T = PropertyKey> = T extends PropertyKey ? T : never;
 //# sourceMappingURL=RecordKeyType.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"RecordKeyType.d.ts","sourceRoot":"","sources":["../../../../src/modules/protocol-model/RecordKeyType.ts"],"names":[],"mappings":"AACA,2FAA2F;AAE3F,yDAAyD;AACzD,MAAM,MAAM,aAAa,CAAC,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC,SAAS,MAAM,GAAG,GAAG,CAAC,GAAG,KAAK,CAAA"}
+{"version":3,"file":"RecordKeyType.d.ts","sourceRoot":"","sources":["../../../../src/modules/protocol-model/RecordKeyType.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAE3F,yDAAyD;AACzD,MAAM,MAAM,aAAa,CAAC,CAAC,GAAG,WAAW,IAAI,CAAC,SAAS,WAAW,GAAG,CAAC,GAAG,KAAK,CAAA"}

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

@@ -25,6 +25,7 @@ export declare const TransferZod: z.ZodMiniObject<{
     schema: z.ZodMiniLiteral<"network.xyo.transfer" & {
         readonly __schema: true;
     }>;
+    $version: z.ZodMiniOptional<z.ZodMiniLiteral<1000000>>;
     context: z.ZodMiniOptional<z.ZodMiniType<import("@ariestools/sdk").JsonObject, unknown, z.core.$ZodTypeInternals<import("@ariestools/sdk").JsonObject, unknown>>>;
     epoch: z.ZodMiniNumber<number>;
     from: z.ZodMiniUnion<readonly [z.ZodMiniPipe<z.ZodMiniString<string>, z.ZodMiniTransform<Lowercase<string> & {
@@ -43,27 +44,11 @@ export type Transfer = z.infer<typeof TransferZod>;
 /**
  * Type guard that checks if a value is a Transfer payload.
  *
- * @deprecated Checks only the schema string — a matching payload may still be missing `from`,
+ * @deprecated Checks only the schema string and supported revision — a matching payload may still be missing `from`,
  * `epoch`, or `transfers`. Use `isTransferPayload` to validate the full shape before
  * dereferencing Transfer fields.
  */
-export declare const isTransfer: (x?: unknown) => x is {
-    schema: "network.xyo.transfer" & {
-        readonly __schema: true;
-    };
-    epoch: number;
-    from: (Lowercase<string> & {
-        readonly __hex: true;
-    } & {
-        readonly __address: true;
-    }) | import("@xyo-network/sdk").XyoQuantAddress;
-    transfers: Record<(Lowercase<string> & {
-        readonly __hex: true;
-    } & {
-        readonly __address: true;
-    }) | import("@xyo-network/sdk").XyoQuantAddress, import("@ariestools/sdk").BrandedHex>;
-    context?: import("@ariestools/sdk").JsonObject | undefined;
-};
+export declare const isTransfer: (value: unknown) => value is Transfer;
 /** Type guard that validates the full Transfer payload shape (schema and all fields). */
 export declare const isTransferPayload: <T>(value: T) => value is T & {
     schema: "network.xyo.transfer" & {
@@ -80,6 +65,7 @@ export declare const isTransferPayload: <T>(value: T) => value is T & {
     } & {
         readonly __address: true;
     }) | import("@xyo-network/sdk").XyoQuantAddress, import("@ariestools/sdk").BrandedHex>;
+    $version?: 1000000 | undefined;
     context?: import("@ariestools/sdk").JsonObject | undefined;
 };
 /** Casts a value to Transfer or returns undefined if invalid */
@@ -98,6 +84,7 @@ export declare const asTransfer: import("@ariestools/sdk").AsTypeFunction<{
     } & {
         readonly __address: true;
     }) | import("@xyo-network/sdk").XyoQuantAddress, import("@ariestools/sdk").BrandedHex>;
+    $version?: 1000000 | undefined;
     context?: import("@ariestools/sdk").JsonObject | undefined;
 }>;
 /** Casts a value to a fully-validated Transfer or returns undefined if invalid */
@@ -116,6 +103,7 @@ export declare const asTransferPayload: import("@ariestools/sdk").AsTypeFunction
     } & {
         readonly __address: true;
     }) | import("@xyo-network/sdk").XyoQuantAddress, import("@ariestools/sdk").BrandedHex>;
+    $version?: 1000000 | undefined;
     context?: import("@ariestools/sdk").JsonObject | undefined;
 }>;
 //# sourceMappingURL=TransferPayload.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"TransferPayload.d.ts","sourceRoot":"","sources":["../../../../src/modules/protocol-model/TransferPayload.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,CAAC,EAAE,MAAM,UAAU,CAAA;AAE5B,kDAAkD;AAClD,eAAO,MAAM,cAAc;;CAAyC,CAAA;AACpE,qDAAqD;AACrD,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAA;AAElD,+DAA+D;AAC/D,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;iBAO5B,CAAA;AAEF,6EAA6E;AAC7E,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;iBAAwE,CAAA;AAEhG,mFAAmF;AACnF,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAA;AAElD;;;;;;GAMG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;CAAkD,CAAA;AAEzE,yFAAyF;AACzF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;CAA4B,CAAA;AAE1D,gEAAgE;AAEhE,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;EAAqC,CAAA;AAE5D,kFAAkF;AAClF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;EAA4C,CAAA"}
+{"version":3,"file":"TransferPayload.d.ts","sourceRoot":"","sources":["../../../../src/modules/protocol-model/TransferPayload.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,CAAC,EAAE,MAAM,UAAU,CAAA;AAI5B,kDAAkD;AAClD,eAAO,MAAM,cAAc;;CAAyC,CAAA;AACpE,qDAAqD;AACrD,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAA;AAElD,+DAA+D;AAC/D,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;iBAO5B,CAAA;AAEF,6EAA6E;AAC7E,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;iBAGtB,CAAA;AAEF,mFAAmF;AACnF,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAA;AAIlD;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,QAEpD,CAAA;AAED,yFAAyF;AACzF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;CAA4B,CAAA;AAE1D,gEAAgE;AAEhE,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;EAAqC,CAAA;AAE5D,kFAAkF;AAClF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;EAA4C,CAAA"}

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

@@ -1 +1 @@
-{"version":3,"file":"AllowedBlockPayload.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-model/block/AllowedBlockPayload.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACF,aAAa,EAAE,eAAe,EACvC,MAAM,kBAAkB,CAAA;AAIzB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,KAAK,EACV,4BAA4B,EAAE,YAAY,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,KAAK,EAAE,WAAW,EACzG,iBAAiB,EAAE,cAAc,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EACpH,MAAM,qBAAqB,CAAA;AAQ5B,OAAO,EAA6B,KAAK,uBAAuB,EAAE,MAAM,yBAAyB,CAAA;AACjG,OAAO,EACO,KAAK,QAAQ,EAC1B,MAAM,uBAAuB,CAAA;AAE9B,+DAA+D;AAC/D,MAAM,MAAM,mBAAmB,GACzB,4BAA4B,GAC5B,YAAY,GACZ,uBAAuB,GACvB,gBAAgB,GAChB,KAAK,GACL,WAAW,GACX,aAAa,GACb,iBAAiB,GACjB,cAAc,GACd,WAAW,GACX,aAAa,GACb,YAAY,GACZ,WAAW,GACX,YAAY,GACZ,WAAW,GACX,uBAAuB,GACvB,QAAQ,CAAA;AAEd,yEAAyE;AACzE,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAkBnB,CAAA;AAEpB,qEAAqE;AACrE,eAAO,MAAM,4BAA4B,eAAqC,CAAA;AAC9E,oDAAoD;AACpD,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAA;AACpF,4DAA4D;AAC5D,eAAO,MAAM,2BAA2B,6BAA6C,CAAA;AAErF,wEAAwE;AACxE,eAAO,MAAM,qBAAqB,GAAI,CAAC,EAAE,OAAO,CAAC,KAAG,KAAK,IAAI,mBAAmB,GAAG,CAsBlF,CAAA;AAED,oFAAoF;AACpF,eAAO,MAAM,iCAAiC,GAAI,CAAC,EAAE,OAAO,CAAC,KAAG,KAAK,IAAI,eAAe,CAAC,mBAAmB,GAAG,CAAC,CAE/G,CAAA"}
+{"version":3,"file":"AllowedBlockPayload.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-model/block/AllowedBlockPayload.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACF,aAAa,EAAE,eAAe,EACvC,MAAM,kBAAkB,CAAA;AAIzB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,OAAO,KAAK,EACV,4BAA4B,EAAE,YAAY,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,KAAK,EAAE,WAAW,EACzG,iBAAiB,EAAE,cAAc,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EACpH,MAAM,qBAAqB,CAAA;AAQ5B,OAAO,EAA6B,KAAK,uBAAuB,EAAE,MAAM,yBAAyB,CAAA;AACjG,OAAO,EACO,KAAK,QAAQ,EAC1B,MAAM,uBAAuB,CAAA;AAE9B,+DAA+D;AAC/D,MAAM,MAAM,mBAAmB,GACzB,4BAA4B,GAC5B,YAAY,GACZ,uBAAuB,GACvB,gBAAgB,GAChB,KAAK,GACL,WAAW,GACX,aAAa,GACb,iBAAiB,GACjB,cAAc,GACd,WAAW,GACX,aAAa,GACb,YAAY,GACZ,WAAW,GACX,YAAY,GACZ,WAAW,GACX,uBAAuB,GACvB,QAAQ,CAAA;AAEd,yEAAyE;AACzE,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAkBnB,CAAA;AAEpB,qEAAqE;AACrE,eAAO,MAAM,4BAA4B,eAAqC,CAAA;AAC9E,oDAAoD;AACpD,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAA;AACpF,4DAA4D;AAC5D,eAAO,MAAM,2BAA2B,6BAA6C,CAAA;AAErF,wEAAwE;AACxE,eAAO,MAAM,qBAAqB,GAAI,CAAC,EAAE,OAAO,CAAC,KAAG,KAAK,IAAI,mBAAmB,GAAG,CAwBlF,CAAA;AAED,oFAAoF;AACpF,eAAO,MAAM,iCAAiC,GAAI,CAAC,EAAE,OAAO,CAAC,KAAG,KAAK,IAAI,eAAe,CAAC,mBAAmB,GAAG,CAAC,CAE/G,CAAA"}