@xyo-network/xl1-protocol 4.0.11 → 4.0.14

package/README.md

@@ -5,29 +5,17 @@
 [![npm-badge][]][npm-link]
 [![license-badge][]][license-link]
 
-> The full XL1 protocol surface — types, schemas, runtime contracts, and validation in one package.
-
-## Table of Contents
-
-- [Description](#description)
-- [Install](#install)
-- [Subpath Exports](#subpath-exports)
-- [What's Inside](#whats-inside)
-- [Building Locally](#building-locally)
-- [Maintainers](#maintainers)
-- [License](#license)
-- [Credits](#credits)
+> XL1 protocol models, interfaces, schemas, and validation in one package.
 
 ## Description
 
-This package is the protocol-tier aggregate for XL1 (XYO Layer One). It bundles every package that defines *what XL1 data looks like* and *how it's validated* — the contracts that every node, indexer, and client agrees on:
+XL1 is the XYO Layer One blockchain protocol. This package is the protocol
+surface for XL1: data models, provider and viewer contracts, network metadata,
+JSON schema exports, and validation utilities.
 
-- `@xyo-network/xl1-network-model` — network metadata, default networks, datalake URLs
-- `@xyo-network/xl1-protocol-lib` — viewer/runner/repository/provider interfaces (the runtime contract layer)
-- `@xyo-network/xl1-schema` — JSON Schema (AJV) definitions for protocol payloads
-- `@xyo-network/xl1-validation` — block/bound-witness/transaction validators
-
-If you're building a node, indexer, or any tool that needs the raw protocol primitives without RPC plumbing, this is your entry point. If you also want gateways, providers, RPC, and wrappers, use [`@xyo-network/xl1-sdk`](https://www.npmjs.com/package/@xyo-network/xl1-sdk) — it re-exports this package alongside two more SDK-tier packages.
+Use it when you need protocol-level types or runtime validation without pulling
+in gateway construction, JSON-RPC transports, storage drivers, or React bindings.
+For application and service development, start with `@xyo-network/xl1-sdk`.
 
 ## Install
 
@@ -55,63 +43,70 @@ Using bun:
 bun add @xyo-network/xl1-protocol
 ```
 
-## Subpath Exports
+## Usage
+
+Import the protocol layer from its explicit subpaths:
 
-- `@xyo-network/xl1-protocol` — flat barrel of all four sub-packages
-- `@xyo-network/xl1-protocol/test` — shared test utilities and fixtures
+```ts
+import { DefaultNetworks } from '@xyo-network/xl1-protocol/network-model'
+import { BlockViewerMoniker } from '@xyo-network/xl1-protocol/protocol-lib'
+import { asXL1BlockNumber } from '@xyo-network/xl1-protocol/protocol-model'
 
-## What's Inside
+const sequence = DefaultNetworks.find(network => network.id === 'sequence')
+const genesis = asXL1BlockNumber(0, true)
 
-**Type system** — A Zod-first model: every protocol type starts as a Zod schema, with derived TypeScript types and `is*` / `as*` / `to*` factory guards. Includes the full Signed/Unsigned × plain/WithHashMeta/WithStorageMeta variant matrix for transactions, blocks, and bound witnesses.
+console.log(sequence?.name, BlockViewerMoniker, genesis)
+```
 
-**Runtime contracts** — Viewer interfaces (read), Runner interfaces (write), Repository interfaces (storage), and Provider interfaces (connection). 25+ viewers covering blocks, accounts, stake, finalization, mempool, network, time, and transactions.
+Available subpaths:
 
-**Schemas** — AJV-compatible JSON Schemas for payloads, transactions, and bound witnesses, used at network and storage boundaries.
+- `@xyo-network/xl1-protocol`
+- `@xyo-network/xl1-protocol/network-model`
+- `@xyo-network/xl1-protocol/protocol-lib`
+- `@xyo-network/xl1-protocol/protocol-model`
+- `@xyo-network/xl1-protocol/schema`
+- `@xyo-network/xl1-protocol/validation`
+- `@xyo-network/xl1-protocol/test`
 
-**Validators** — Composable validator functions for block cumulative balances, bound-witness signatures and references, and transactions (protocol, duration, from-address, gas, elevation, JSON-schema, transfers).
+## Documentation
 
-## Building Locally
+- Use `protocol-model` for Zod-first XL1 data structures and value guards.
+- Use `protocol-lib` for provider, viewer, runner, gateway, and status contracts.
+- Use `network-model` for network metadata and static REST path helpers.
+- 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.
+
+## AI Agent Skills
+
+Install the recommended XL1/XYO skills with [Skills.sh](https://skills.sh):
 
-From the repo root:
+```sh
+npx skills add XYOracleNetwork/xyo-skills --all
+```
+
+In XY toolchain repos, the equivalent convenience command is:
 
 ```sh
-xy build      # tsup + tsc + publint
-xy test       # vitest
-xy lint       # eslint
+pnpm xy skills defaults
+pnpm xy skills lint --fix
 ```
 
-Scope to this package: `xy build @xyo-network/xl1-protocol`.
-
-## Maintainers
-
-<table>
-  <tr>
-    <td align="center" valign="top" width="120">
-      <a href="https://github.com/arietrouw">
-        <img src="https://github.com/arietrouw.png" width="80" height="80" alt="Arie Trouw" /><br />
-        <sub><b>Arie Trouw</b></sub>
-      </a>
-      <br />
-      <a href="https://arietrouw.com">arietrouw.com</a>
-    </td>
-    <td align="center" valign="top" width="120">
-      <a href="https://github.com/jonesmac">
-        <img src="https://github.com/jonesmac.png" width="80" height="80" alt="Matt Jones" /><br />
-        <sub><b>Matt Jones</b></sub>
-      </a>
-    </td>
-    <td align="center" valign="top" width="120">
-      <a href="https://github.com/JoelBCarter">
-        <img src="https://github.com/JoelBCarter.png" width="80" height="80" alt="Joel Carter" /><br />
-        <sub><b>Joel Carter</b></sub>
-      </a>
-    </td>
-  </tr>
-</table>
+For XL1 work, ask your agent to use `xyo-knowledge`, `xl1-knowledge`, and
+`xl1-patterns`. These skills cover XYO primitives, XL1 chain and gateway APIs,
+and application patterns for XL1 dApps.
+
+## Building Locally
+
+```sh
+pnpm xy build @xyo-network/xl1-protocol
+pnpm xy test @xyo-network/xl1-protocol
+pnpm xy lint @xyo-network/xl1-protocol
+```
 
 ## License
 
-See the [LICENSE](./LICENSE) file for license rights and limitations (LGPL-3.0-only).
+See the repository [LICENSE](../../LICENSE) file for license rights and
+limitations (LGPL-3.0-only).
 
 ## Credits
 
@@ -120,5 +115,5 @@ See the [LICENSE](./LICENSE) file for license rights and limitations (LGPL-3.0-o
 [npm-badge]: https://img.shields.io/npm/v/@xyo-network/xl1-protocol.svg
 [npm-link]: https://www.npmjs.com/package/@xyo-network/xl1-protocol
 [license-badge]: https://img.shields.io/npm/l/@xyo-network/xl1-protocol.svg
-[license-link]: ./LICENSE
+[license-link]: ../../LICENSE
 [logo]: https://cdn.xy.company/img/brand/XYO_full_colored.png

package/dist/neutral/index.d.ts

@@ -1,5 +1,5 @@
-export * from '@xyo-network/xl1-network-model';
-export * from '@xyo-network/xl1-protocol-lib';
-export * from '@xyo-network/xl1-schema';
-export * from '@xyo-network/xl1-validation';
+export * from './modules/network-model/index.js';
+export * from './modules/protocol-lib/index.js';
+export * from './modules/schema/index.js';
+export * from './modules/validation/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/neutral/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAA;AAC9C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,yBAAyB,CAAA;AACvC,cAAc,6BAA6B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA"}

package/dist/neutral/index.mjs

@@ -1,6 +1,6 @@
 // src/index.ts
-export * from "@xyo-network/xl1-network-model";
-export * from "@xyo-network/xl1-protocol-lib";
-export * from "@xyo-network/xl1-schema";
-export * from "@xyo-network/xl1-validation";
+export * from "#network-model";
+export * from "#protocol-lib";
+export * from "#schema";
+export * from "#validation";
 //# sourceMappingURL=index.mjs.map

package/dist/neutral/index.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/index.ts"],
-  "sourcesContent": ["export * from '@xyo-network/xl1-network-model'\nexport * from '@xyo-network/xl1-protocol-lib'\nexport * from '@xyo-network/xl1-schema'\nexport * from '@xyo-network/xl1-validation'\n"],
-  "mappings": ";AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
+  "sourcesContent": ["// Generated by xy monolith layout sync (package-sync-layout) \u2014 do not edit by hand.\nexport * from '#network-model'\nexport * from '#protocol-lib'\nexport * from '#schema'\nexport * from '#validation'\n"],
+  "mappings": ";AACA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
   "names": []
 }

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

@@ -0,0 +1,4 @@
+export * from './local/index.js';
+export * from './mainnet/index.js';
+export * from './sequence/index.js';
+//# sourceMappingURL=index.d.ts.map

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

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

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

@@ -0,0 +1,2 @@
+export { default as LocalNetworkIconString } from './local.svg.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/network-model/icons/local/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,sBAAsB,EAAE,MAAM,aAAa,CAAA"}

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

@@ -0,0 +1,2 @@
+export { default as MainNetworkIconString } from './mainnet.svg.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/network-model/icons/mainnet/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,eAAe,CAAA"}

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

@@ -0,0 +1,2 @@
+export { default as SequenceNetworkIconString } from './testnet.svg.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/network-model/icons/sequence/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,yBAAyB,EAAE,MAAM,eAAe,CAAA"}

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

@@ -0,0 +1,7 @@
+export * from './icons/index.js';
+export * from './lib/index.js';
+export * from './models/index.js';
+export * from './modules/index.js';
+export * from './staticRest/index.js';
+export * from './utils/index.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/network-model/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA;AAClC,cAAc,uBAAuB,CAAA;AACrC,cAAc,kBAAkB,CAAA"}

package/dist/neutral/modules/network-model/lib/NetworkDataLakeUrls.d.ts

@@ -0,0 +1,8 @@
+import { LocalNetwork, MainNetwork, SequenceNetwork } from './Networks.js';
+/** Map of network IDs to their corresponding Data Lake API URLs. */
+export declare const NetworkDataLakeUrls: {
+    readonly [MainNetwork.id]: "https://api.archivist.xyo.network/dataLake";
+    readonly [SequenceNetwork.id]: "https://beta.api.archivist.xyo.network/dataLake";
+    readonly [LocalNetwork.id]: "http://localhost:8080/dataLake";
+};
+//# sourceMappingURL=NetworkDataLakeUrls.d.ts.map

package/dist/neutral/modules/network-model/lib/NetworkDataLakeUrls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NetworkDataLakeUrls.d.ts","sourceRoot":"","sources":["../../../../../src/modules/network-model/lib/NetworkDataLakeUrls.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,YAAY,EAAE,WAAW,EAAE,eAAe,EAC3C,MAAM,eAAe,CAAA;AAEtB,oEAAoE;AACpE,eAAO,MAAM,mBAAmB;IAC9B,SAAA,CAAC,WAAW,CAAC,EAAE,CAAC,+CAA8C;IAC9D,SAAA,CAAC,eAAe,CAAC,EAAE,CAAC,oDAAmD;IACvE,SAAA,CAAC,YAAY,CAAC,EAAE,CAAC,mCAAkC;CACL,CAAA"}

package/dist/neutral/modules/network-model/lib/Networks.d.ts

@@ -0,0 +1,10 @@
+import type { NetworkBootstrap } from '../models/index.js';
+/** Bootstrap configuration for the XYO Layer 1 mainnet. */
+export declare const MainNetwork: NetworkBootstrap;
+/** Bootstrap configuration for the XYO Layer 1 sequence (test) network. */
+export declare const SequenceNetwork: NetworkBootstrap;
+/** Bootstrap configuration for a local development network. */
+export declare const LocalNetwork: NetworkBootstrap;
+/** Default set of available XYO Layer 1 networks (mainnet, sequence, local). */
+export declare const DefaultNetworks: NetworkBootstrap[];
+//# sourceMappingURL=Networks.d.ts.map

package/dist/neutral/modules/network-model/lib/Networks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Networks.d.ts","sourceRoot":"","sources":["../../../../../src/modules/network-model/lib/Networks.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAa,MAAM,oBAAoB,CAAA;AAGrE,2DAA2D;AAC3D,eAAO,MAAM,WAAW,EAAE,gBAUzB,CAAA;AAED,2EAA2E;AAC3E,eAAO,MAAM,eAAe,EAAE,gBAU7B,CAAA;AAED,+DAA+D;AAC/D,eAAO,MAAM,YAAY,EAAE,gBAS1B,CAAA;AAED,gFAAgF;AAChF,eAAO,MAAM,eAAe,EAAE,gBAAgB,EAAiD,CAAA"}

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

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

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

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

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

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

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

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

package/dist/neutral/modules/network-model/manifest/networkManifest.d.ts

@@ -0,0 +1,4 @@
+import type { PackageManifestPayload } from '@xyo-network/sdk';
+/** @deprecated XYO Node manifest bootstrap is no longer used; wire providers via archivist bindings or JsonRpc instead. */
+export declare const NetworkNodeManifest: PackageManifestPayload;
+//# sourceMappingURL=networkManifest.d.ts.map

package/dist/neutral/modules/network-model/manifest/networkManifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"networkManifest.d.ts","sourceRoot":"","sources":["../../../../../src/modules/network-model/manifest/networkManifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAI9D,2HAA2H;AAC3H,eAAO,MAAM,mBAAmB,EAAsB,sBAAsB,CAAA"}

package/dist/neutral/modules/network-model/models/Bootstrap.d.ts

@@ -0,0 +1,56 @@
+import type { Address } from '@ariestools/sdk';
+import type { Payload } from '@xyo-network/sdk';
+import type { ChainId } from '../../protocol-lib/index.js';
+import type { NetworkId } from './NetworkId.js';
+/** Connection details for accessing a chain endpoint. */
+export interface ChainConnection {
+    /** Chain Identifier - can be a hex (eth contract address) or a string */
+    chain?: ChainId;
+    /** Name of the chain */
+    name: string;
+    /** URL for accessing the network */
+    url: string;
+}
+/** Schema identifier for network bootstrap payloads. */
+export declare const NetworkBootstrapSchema: "network.xyo.network.bootstrap" & {
+    readonly __schema: true;
+};
+/** Schema type for network bootstrap payloads. */
+export type NetworkBootstrapSchema = typeof NetworkBootstrapSchema;
+/** Fields describing a chain fork origin. */
+export interface ChainForkFields {
+    /** Block Number at which the chain was forked from */
+    forkedAtLastBlockNumber?: string;
+    /** Hash in the last block the chain was forked from */
+    forkedAtLastHash?: string;
+    /** Address of the forked chain */
+    forkedChainId?: Address;
+}
+/** Core fields describing an XYO network. */
+export interface NetworkFields {
+    /** Description of the network */
+    description: string;
+    /** URL for accessing the network explorer */
+    explorerUrl?: string;
+    /** string representation of the icon (SVG) */
+    icon?: string;
+    /** Machine-readable identifier */
+    id: NetworkId;
+    schema: NetworkBootstrapSchema;
+    /** Symbol of the network */
+    symbol?: string;
+}
+/** Optional Properties can be found walking the chain to the genesis block */
+export interface NetworkBootstrapFields extends NetworkFields, ChainForkFields, ChainConnection {
+}
+/** A network bootstrap extended with a flag indicating whether it is a custom network. */
+export interface Network extends NetworkBootstrap {
+    custom: boolean;
+}
+/** Payload type containing all network bootstrap configuration fields. */
+export type NetworkBootstrap = Payload<NetworkBootstrapFields, NetworkBootstrapSchema>;
+/** Type guard that checks whether a payload is a NetworkBootstrap. */
+export declare const isNetworkBootstrap: (x?: unknown) => x is NetworkBootstrap;
+/** Optionally casts a value to a Network if it is a valid NetworkBootstrap. */
+export declare const asOptionalNetwork: (value: import("@ariestools/sdk").AnyNonPromise) => NetworkBootstrap | undefined;
+//# sourceMappingURL=Bootstrap.d.ts.map

package/dist/neutral/modules/network-model/models/Bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Bootstrap.d.ts","sourceRoot":"","sources":["../../../../../src/modules/network-model/models/Bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAE9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAG/C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAE5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE/C,yDAAyD;AACzD,MAAM,WAAW,eAAe;IAC9B,yEAAyE;IACzE,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,oCAAoC;IACpC,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,wDAAwD;AACxD,eAAO,MAAM,sBAAsB;;CAAkD,CAAA;AACrF,kDAAkD;AAClD,MAAM,MAAM,sBAAsB,GAAG,OAAO,sBAAsB,CAAA;AAElE,6CAA6C;AAC7C,MAAM,WAAW,eAAe;IAC9B,sDAAsD;IACtD,uBAAuB,CAAC,EAAE,MAAM,CAAA;IAChC,uDAAuD;IACvD,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,kCAAkC;IAClC,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAED,6CAA6C;AAC7C,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAA;IACnB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,kCAAkC;IAClC,EAAE,EAAE,SAAS,CAAA;IACb,MAAM,EAAE,sBAAsB,CAAA;IAC9B,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,8EAA8E;AAC9E,MAAM,WAAW,sBAAuB,SAAQ,aAAa,EAAE,eAAe,EAAE,eAAe;CAAG;AAElG,0FAA0F;AAC1F,MAAM,WAAW,OAAQ,SAAQ,gBAAgB;IAC/C,MAAM,EAAE,OAAO,CAAA;CAChB;AAED,0EAA0E;AAC1E,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,sBAAsB,EAAE,sBAAsB,CAAC,CAAA;AAEtF,sEAAsE;AACtE,eAAO,MAAM,kBAAkB,wCAAkE,CAAA;AAEjG,+EAA+E;AAC/E,eAAO,MAAM,iBAAiB,kFAAqD,CAAA"}

package/dist/neutral/modules/network-model/models/NetworkId.d.ts

@@ -0,0 +1,12 @@
+import type { GatewayName } from '../../protocol-lib/index.js';
+/** Default network identifiers for mainnet, sequence, and local environments. */
+export type DefaultNetworkIds = ('mainnet' & {
+    __gatewayName: true;
+}) | ('sequence' & {
+    __gatewayName: true;
+}) | ('local' & {
+    __gatewayName: true;
+});
+/** A network identifier, either a custom gateway name or one of the default network IDs. */
+export type NetworkId<T extends GatewayName | void = void> = T extends void ? DefaultNetworkIds : T | DefaultNetworkIds;
+//# sourceMappingURL=NetworkId.d.ts.map

package/dist/neutral/modules/network-model/models/NetworkId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NetworkId.d.ts","sourceRoot":"","sources":["../../../../../src/modules/network-model/models/NetworkId.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAEhD,iFAAiF;AACjF,MAAM,MAAM,iBAAiB,GAAG,CAAC,SAAS,GAAG;IAAE,aAAa,EAAE,IAAI,CAAA;CAAE,CAAC,GAAG,CAAC,UAAU,GAAG;IAAE,aAAa,EAAE,IAAI,CAAA;CAAE,CAAC,GAAG,CAAC,OAAO,GAAG;IAAE,aAAa,EAAE,IAAI,CAAA;CAAE,CAAC,CAAA;AACpJ,4FAA4F;AAC5F,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,WAAW,GAAG,IAAI,GAAG,IAAI,IAAM,CAAC,SAAS,IAAI,GAAG,iBAAiB,GAAG,CAAC,GAAG,iBAAiB,CAAA"}

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

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

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

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

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

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

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

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

package/dist/neutral/modules/network-model/modules/node/getNetworkNode.d.ts

@@ -0,0 +1,10 @@
+import type { AttachableNodeInstance, WalletInstance } from '@xyo-network/sdk';
+/**
+ * Creates a network node from the network manifest using the provided wallet.
+ *
+ * @deprecated Bootstrapping an XYO `NodeInstance` via manifest is no longer supported.
+ * Use `connectArchivist` from `@xyo-network/xl1-protocol-sdk` for co-located archivist
+ * access, or `GatewayBuilder` from `@xyo-network/xl1-gateway` for remote RPC access.
+ */
+export declare function getNetworkNode(wallet: WalletInstance): Promise<AttachableNodeInstance>;
+//# sourceMappingURL=getNetworkNode.d.ts.map

package/dist/neutral/modules/network-model/modules/node/getNetworkNode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getNetworkNode.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/network-model/modules/node/getNetworkNode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAK9E;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAI5F"}

package/dist/neutral/modules/network-model/modules/node/getNetworkNodes.d.ts

@@ -0,0 +1,4 @@
+import type { AttachableNodeInstance } from '@xyo-network/sdk';
+/** @deprecated Internal cache for deprecated `initNetworkNode`; do not use. */
+export declare const getNetworkNodes: () => Map<string, AttachableNodeInstance<import("@xyo-network/sdk").NodeParams<import("@xyo-network/sdk").AnyConfigSchema<import("@xyo-network/sdk").NodeConfig>>, import("@xyo-network/sdk").NodeModuleEventData>>;
+//# sourceMappingURL=getNetworkNodes.d.ts.map

package/dist/neutral/modules/network-model/modules/node/getNetworkNodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getNetworkNodes.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/network-model/modules/node/getNetworkNodes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAI9D,+EAA+E;AAC/E,eAAO,MAAM,eAAe,qNAE3B,CAAA"}

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

@@ -0,0 +1,4 @@
+export * from './getNetworkNode.js';
+export * from './getNetworkNodes.js';
+export * from './initNetworkNode.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/network-model/modules/node/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AACnC,cAAc,sBAAsB,CAAA;AACpC,cAAc,sBAAsB,CAAA"}

package/dist/neutral/modules/network-model/modules/node/initNetworkNode.d.ts

@@ -0,0 +1,5 @@
+import type { AttachableNodeInstance, WalletInstance } from '@xyo-network/sdk';
+import type { NetworkBootstrap } from '../../models/index.js';
+/** @deprecated Use `connectArchivist` archivist bindings (`@xyo-network/xl1-protocol-sdk`) or `GatewayBuilder` (`@xyo-network/xl1-gateway`) instead of bootstrapping an XYO NodeInstance. */
+export declare const initNetworkNode: (activeNetwork: NetworkBootstrap, wallet: WalletInstance) => Promise<AttachableNodeInstance>;
+//# sourceMappingURL=initNetworkNode.d.ts.map

package/dist/neutral/modules/network-model/modules/node/initNetworkNode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initNetworkNode.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/network-model/modules/node/initNetworkNode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAE9E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAI7D,6LAA6L;AAC7L,eAAO,MAAM,eAAe,GAAU,eAAe,gBAAgB,EAAE,QAAQ,cAAc,KAAG,OAAO,CAAC,sBAAsB,CAQ7H,CAAA"}

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

@@ -0,0 +1,10 @@
+/**
+ * Static REST layout protocol for XL1 chain data.
+ *
+ * Path builders, manifest schemas, and derived path templates shared by static file publishers
+ * (S3 runners) and HTTP readers (Rest viewers). See `packages/protocol/STATIC_REST_LAYOUT.md`.
+ */
+export * from './layout/index.js';
+export * from './paths/index.js';
+export * from './templates.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/modules/network-model/staticRest/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,mBAAmB,CAAA;AACjC,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA"}

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

@@ -0,0 +1,84 @@
+import { z } from 'zod';
+/** Schema id for the chain-contract manifest document. */
+export declare const ChainContractManifestSchema: "network.xyo.s3.chain.contract";
+/** 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. */
+export declare const CHAIN_CONTRACT_MANIFEST_VERSION = 1;
+/**
+ * Zod schema for the static per-chain config at `chainContractPath()`: the reward contract,
+ * staking token, minimum withdrawal window, and (optional) fork lineage. Published once —
+ * this data doesn't change per block, unlike `chain/head.json`.
+ */
+export declare const ChainContractManifestZod: z.ZodObject<{
+    forkedAtBlockNumber: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodInt, z.ZodTransform<import('../../../protocol-lib/index.js').XL1BlockNumber, number>>>>;
+    forkedAtHash: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    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.ZodInt;
+    rewardsContract: z.ZodString;
+    schema: z.ZodLiteral<"network.xyo.s3.chain.contract">;
+    stakingTokenAddress: z.ZodString;
+    version: z.ZodInt;
+}, z.core.$strip>;
+/** The static per-chain contract config at `chainContractPath()`. */
+export type ChainContractManifest = z.infer<typeof ChainContractManifestZod>;
+/** Type guard that checks if a value is a valid ChainContractManifest. */
+export declare const isChainContractManifest: <T>(value: T) => value is T & {
+    minWithdrawalBlocks: number;
+    rewardsContract: string;
+    schema: "network.xyo.s3.chain.contract";
+    stakingTokenAddress: string;
+    version: number;
+    forkedAtBlockNumber?: import('../../../protocol-lib/index.js').XL1BlockNumber | null | undefined;
+    forkedAtHash?: string | null | undefined;
+    forkedChainId?: import("@ariestools/sdk").BrandedHex | null | undefined;
+};
+/** Converts a value to ChainContractManifest, throwing if invalid. */
+export declare const asChainContractManifest: {
+    <T>(value: T): (T & {
+        minWithdrawalBlocks: number;
+        rewardsContract: string;
+        schema: "network.xyo.s3.chain.contract";
+        stakingTokenAddress: string;
+        version: number;
+        forkedAtBlockNumber?: import('../../../protocol-lib/index.js').XL1BlockNumber | null | undefined;
+        forkedAtHash?: string | null | undefined;
+        forkedChainId?: import("@ariestools/sdk").BrandedHex | null | undefined;
+    }) | undefined;
+    <T>(value: T, assert: import("@ariestools/sdk").ZodFactoryConfig): T & {
+        minWithdrawalBlocks: number;
+        rewardsContract: string;
+        schema: "network.xyo.s3.chain.contract";
+        stakingTokenAddress: string;
+        version: number;
+        forkedAtBlockNumber?: import('../../../protocol-lib/index.js').XL1BlockNumber | null | undefined;
+        forkedAtHash?: string | null | undefined;
+        forkedChainId?: import("@ariestools/sdk").BrandedHex | null | undefined;
+    };
+};
+/** Non-validating cast to ChainContractManifest. */
+export declare const toChainContractManifest: {
+    <T>(value: T): (T & {
+        minWithdrawalBlocks: number;
+        rewardsContract: string;
+        schema: "network.xyo.s3.chain.contract";
+        stakingTokenAddress: string;
+        version: number;
+        forkedAtBlockNumber?: import('../../../protocol-lib/index.js').XL1BlockNumber | null | undefined;
+        forkedAtHash?: string | null | undefined;
+        forkedChainId?: import("@ariestools/sdk").BrandedHex | null | undefined;
+    }) | undefined;
+    <T>(value: T, assert: import("@ariestools/sdk").ZodFactoryConfig): T & {
+        minWithdrawalBlocks: number;
+        rewardsContract: string;
+        schema: "network.xyo.s3.chain.contract";
+        stakingTokenAddress: string;
+        version: number;
+        forkedAtBlockNumber?: import('../../../protocol-lib/index.js').XL1BlockNumber | null | undefined;
+        forkedAtHash?: string | null | undefined;
+        forkedChainId?: import("@ariestools/sdk").BrandedHex | null | undefined;
+    };
+};
+/** Builds a validated chain-contract manifest. */
+export declare function createChainContractManifest(config: Omit<ChainContractManifest, 'schema' | 'version'>): ChainContractManifest;
+//# sourceMappingURL=chainContractManifest.d.ts.map

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

@@ -0,0 +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;AAIvB,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;;;;;;;;;iBASnC,CAAA;AAEF,qEAAqE;AACrE,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAE5E,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,qBAAqB,EAAE,QAAQ,GAAG,SAAS,CAAC,GACxD,qBAAqB,CAMvB"}