@xyo-network/xl1-network-model 2.1.9 → 2.2.0

package/dist/neutral/index.d.ts

@@ -2,5 +2,6 @@ export * from './icons/index.ts';
 export * from './lib/index.ts';
 export * from './models/index.ts';
 export * from './modules/index.ts';
+export * from './staticRest/index.ts';
 export * from './utils/index.ts';
 //# 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,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA;AAClC,cAAc,kBAAkB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/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/index.mjs

@@ -106,6 +106,179 @@ var initNetworkNode = async (activeNetwork, wallet) => {
   return activeNetworkNode;
 };
 
+// src/staticRest/layout/chainManifest.ts
+import {
+  zodAsFactory,
+  zodIsFactory,
+  zodToFactory
+} from "@xylabs/sdk-js";
+import { z } from "zod";
+
+// src/staticRest/paths/chainState.ts
+var headPath = () => "chain/head.json";
+
+// src/staticRest/paths/finalized.ts
+var manifestPath = () => "manifest.json";
+var blockNumberPath = (block) => `block/number/${block}.json`;
+var blockHashPath = (hash) => `block/hash/${hash}.json`;
+var payloadPath = (hash) => `payload/${hash}.json`;
+
+// src/staticRest/paths/indexPaths.ts
+var indexSummaryPath = (family, stepLevel, stepIndex) => `${family}/${stepLevel}/${stepIndex}.json`;
+var indexManifestPath = () => "manifest.json";
+var indexHeadPath = () => "head.json";
+
+// src/staticRest/templates.ts
+var TEMPLATE_SLOTS = {
+  block: 0,
+  hash: "0".repeat(64),
+  index: 99,
+  level: 42
+};
+function toPathTemplate(path, slots) {
+  let result = path;
+  for (const { literal, name } of slots) {
+    if (!result.includes(literal)) {
+      throw new Error(`Template slot "${literal}" not found in path "${path}"`);
+    }
+    result = result.replace(literal, `{${name}}`);
+  }
+  return result;
+}
+function interpolatePathTemplate(template, values) {
+  let result = template;
+  for (const [key, value] of Object.entries(values)) {
+    result = result.replaceAll(`{${key}}`, String(value));
+  }
+  return result;
+}
+var blockNumberPathTemplate = () => toPathTemplate(blockNumberPath(TEMPLATE_SLOTS.block), [{ literal: String(TEMPLATE_SLOTS.block), name: "block" }]);
+var blockHashPathTemplate = () => toPathTemplate(blockHashPath(TEMPLATE_SLOTS.hash), [{ literal: TEMPLATE_SLOTS.hash, name: "hash" }]);
+var payloadPathTemplate = () => toPathTemplate(payloadPath(TEMPLATE_SLOTS.hash), [{ literal: TEMPLATE_SLOTS.hash, name: "hash" }]);
+function chainManifestPathTemplates() {
+  return {
+    blockByHash: blockHashPathTemplate(),
+    blockByNumber: blockNumberPathTemplate(),
+    head: headPath(),
+    payload: payloadPathTemplate()
+  };
+}
+function indexSummaryPathTemplate(family) {
+  const path = indexSummaryPath(family, TEMPLATE_SLOTS.level, TEMPLATE_SLOTS.index);
+  return toPathTemplate(path, [
+    { literal: String(TEMPLATE_SLOTS.level), name: "level" },
+    { literal: String(TEMPLATE_SLOTS.index), name: "index" }
+  ]);
+}
+
+// src/staticRest/layout/chainManifest.ts
+var CHAIN_LAYOUT_VERSION = 1;
+var ChainManifestSchema = "network.xyo.s3.chain.manifest";
+var ChainManifestPathsZod = z.object({
+  blockByHash: z.string(),
+  blockByNumber: z.string(),
+  head: z.string(),
+  payload: z.string()
+});
+var ChainManifestZod = z.object({
+  /** Lowest block number available in the bucket (genesis until pruning exists). */
+  earliestBlock: z.int().nonnegative(),
+  /** Storage/wire encoding of the published files (also on each object's Content-Encoding). */
+  encoding: z.string(),
+  paths: ChainManifestPathsZod,
+  schema: z.literal(ChainManifestSchema),
+  version: z.int().positive()
+});
+var isChainManifest = zodIsFactory(ChainManifestZod);
+var asChainManifest = zodAsFactory(ChainManifestZod, "asChainManifest");
+var toChainManifest = zodToFactory(ChainManifestZod, "toChainManifest");
+function createChainManifest(encoding, earliestBlock = 0) {
+  return asChainManifest({
+    earliestBlock,
+    encoding,
+    paths: chainManifestPathTemplates(),
+    schema: ChainManifestSchema,
+    version: CHAIN_LAYOUT_VERSION
+  }, true);
+}
+
+// src/staticRest/layout/indexManifest.ts
+import {
+  zodAsFactory as zodAsFactory2,
+  zodIsFactory as zodIsFactory2,
+  zodToFactory as zodToFactory2
+} from "@xylabs/sdk-js";
+import { z as z2 } from "zod";
+var INDEX_LAYOUT_VERSION = 1;
+var IndexManifestSchema = "network.xyo.s3.index.manifest";
+var IndexHeadSchema = "network.xyo.s3.index.head";
+var IndexManifestFamilyZod = z2.object({
+  /** Highest step level published for this family. */
+  maxStep: z2.int().nonnegative(),
+  /** Path template for the family's frames, e.g. `blocks/{level}/{index}.json`. */
+  path: z2.string()
+});
+var indexFamiliesZod = z2.object({
+  balances: IndexManifestFamilyZod,
+  blocks: IndexManifestFamilyZod,
+  schemas: IndexManifestFamilyZod,
+  transfers: IndexManifestFamilyZod
+});
+var IndexManifestZod = z2.object({
+  families: indexFamiliesZod,
+  schema: z2.literal(IndexManifestSchema),
+  version: z2.int().positive()
+});
+var isIndexManifest = zodIsFactory2(IndexManifestZod);
+var asIndexManifest = zodAsFactory2(IndexManifestZod, "asIndexManifest");
+var toIndexManifest = zodToFactory2(IndexManifestZod, "toIndexManifest");
+var IndexHeadFamiliesZod = z2.object({
+  balances: z2.int().nonnegative(),
+  blocks: z2.int().nonnegative(),
+  schemas: z2.int().nonnegative(),
+  transfers: z2.int().nonnegative()
+});
+var IndexHeadZod = z2.object({
+  /** Highest block the index is complete through. */
+  block: z2.int().nonnegative(),
+  /** Completed frame counts per family. */
+  families: IndexHeadFamiliesZod,
+  /** Hash of that block. */
+  hash: z2.string(),
+  schema: z2.literal(IndexHeadSchema),
+  /** ISO-8601 timestamp of the last update. */
+  updatedAt: z2.string(),
+  version: z2.int().positive()
+});
+var isIndexHead = zodIsFactory2(IndexHeadZod);
+var asIndexHead = zodAsFactory2(IndexHeadZod, "asIndexHead");
+var toIndexHead = zodToFactory2(IndexHeadZod, "toIndexHead");
+function createIndexManifestFamilies(maxSteps) {
+  return {
+    balances: { maxStep: maxSteps.balances, path: indexSummaryPathTemplate("balances") },
+    blocks: { maxStep: maxSteps.blocks, path: indexSummaryPathTemplate("blocks") },
+    schemas: { maxStep: maxSteps.schemas, path: indexSummaryPathTemplate("schemas") },
+    transfers: { maxStep: maxSteps.transfers, path: indexSummaryPathTemplate("transfers") }
+  };
+}
+function createIndexManifest(maxSteps) {
+  return asIndexManifest({
+    families: createIndexManifestFamilies(maxSteps),
+    schema: IndexManifestSchema,
+    version: INDEX_LAYOUT_VERSION
+  }, true);
+}
+function createIndexHead(watermark, updatedAt = (/* @__PURE__ */ new Date()).toISOString()) {
+  return asIndexHead({
+    block: watermark.block,
+    families: watermark.families,
+    hash: watermark.hash,
+    schema: IndexHeadSchema,
+    updatedAt,
+    version: INDEX_LAYOUT_VERSION
+  }, true);
+}
+
 // src/utils/ExplorerLinks.ts
 var ExplorerLinks = class {
   explorerUrl;
@@ -158,8 +331,19 @@ var ExplorerLinks = class {
   }
 };
 export {
+  CHAIN_LAYOUT_VERSION,
+  ChainManifestPathsZod,
+  ChainManifestSchema,
+  ChainManifestZod,
   DefaultNetworks,
   ExplorerLinks,
+  INDEX_LAYOUT_VERSION,
+  IndexHeadFamiliesZod,
+  IndexHeadSchema,
+  IndexHeadZod,
+  IndexManifestFamilyZod,
+  IndexManifestSchema,
+  IndexManifestZod,
   LocalNetwork,
   local_default as LocalNetworkIconString,
   MainNetwork,
@@ -168,10 +352,38 @@ export {
   NetworkDataLakeUrls,
   SequenceNetwork,
   testnet_default as SequenceNetworkIconString,
+  asChainManifest,
+  asIndexHead,
+  asIndexManifest,
   asOptionalNetwork,
+  blockHashPath,
+  blockHashPathTemplate,
+  blockNumberPath,
+  blockNumberPathTemplate,
+  chainManifestPathTemplates,
+  createChainManifest,
+  createIndexHead,
+  createIndexManifest,
+  createIndexManifestFamilies,
   getNetworkNode,
   getNetworkNodes,
+  headPath,
+  indexHeadPath,
+  indexManifestPath,
+  indexSummaryPath,
+  indexSummaryPathTemplate,
   initNetworkNode,
-  isNetworkBootstrap
+  interpolatePathTemplate,
+  isChainManifest,
+  isIndexHead,
+  isIndexManifest,
+  isNetworkBootstrap,
+  manifestPath,
+  payloadPath,
+  payloadPathTemplate,
+  toChainManifest,
+  toIndexHead,
+  toIndexManifest,
+  toPathTemplate
 };
 //# sourceMappingURL=index.mjs.map

package/dist/neutral/index.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../src/icons/local/local.svg", "../../src/icons/mainnet/mainnet.svg", "../../src/icons/sequence/testnet.svg", "../../src/lib/Networks.ts", "../../src/models/Bootstrap.ts", "../../src/lib/NetworkDataLakeUrls.ts", "../../src/modules/node/getNetworkNode.ts", "../../src/manifest/network.json", "../../src/manifest/networkManifest.ts", "../../src/modules/node/getNetworkNodes.ts", "../../src/modules/node/initNetworkNode.ts", "../../src/utils/ExplorerLinks.ts"],
-  "sourcesContent": ["<svg id=\"Layer_1\" xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 256 256\"><g style=\"opacity:.5;\"><path d=\"M154.71,97c.46,2.59,2.5,4.62,5.1,5.05l14.05,2.34,31.71-46.17c4.57-6.65-3.62-14.62-10.14-9.87l-43.68,31.83,2.97,16.82Z\" style=\"fill:#f47f00;\"/><path d=\"M173.86,151.62l-14.05,2.34c-2.6.43-4.64,2.45-5.1,5.05l-2.97,16.82,43.68,31.83c6.52,4.75,14.71-3.21,10.14-9.87l-31.71-46.17Z\" style=\"fill:#f47f00;\"/><path d=\"M82.14,104.38l14.05-2.34c2.6-.43,4.64-2.45,5.1-5.05l2.97-16.82-43.68-31.83c-6.52-4.75-14.71,3.21-10.14,9.87l31.71,46.17Z\" style=\"fill:#f47f00;\"/><path d=\"M101.29,159c-.46-2.59-2.5-4.62-5.1-5.05l-14.05-2.34-31.71,46.17c-4.57,6.65,3.62,14.62,10.14,9.87l43.68-31.83-2.97-16.82Z\" style=\"fill:#f47f00;\"/></g><path d=\"M107.33,104l15.94-90.32c.93-5.3,8.53-5.3,9.47,0l15.94,90.32c.35,2.01,1.94,3.57,3.95,3.91l92.24,15.35c5.36.89,5.36,8.59,0,9.49l-92.24,15.35c-2.01.33-3.59,1.9-3.95,3.91l-15.94,90.32c-.93,5.3-8.53,5.3-9.47,0l-15.94-90.32c-.35-2.01-1.94-3.57-3.95-3.91l-92.24-15.35c-5.36-.89-5.36-8.59,0-9.49l92.24-15.35c2.01-.33,3.59-1.9,3.95-3.91Z\" style=\"fill:#f47f00;\"/></svg>", "<svg id=\"Layer_1\" xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 256 256\"><path d=\"M154.71,97c.46,2.59,2.5,4.62,5.1,5.05l14.05,2.34,31.71-46.17c4.57-6.65-3.62-14.62-10.14-9.87l-43.68,31.83,2.97,16.82Z\" style=\"fill:#8d8fc6;\"/><path d=\"M173.86,151.62l-14.05,2.34c-2.6.43-4.64,2.45-5.1,5.05l-2.97,16.82,43.68,31.83c6.52,4.75,14.71-3.21,10.14-9.87l-31.71-46.17Z\" style=\"fill:#eb407a;\"/><path d=\"M82.14,104.38l14.05-2.34c2.6-.43,4.64-2.45,5.1-5.05l2.97-16.82-43.68-31.83c-6.52-4.75-14.71,3.21-10.14,9.87l31.71,46.17Z\" style=\"fill:#579fd6;\"/><path d=\"M101.29,159c-.46-2.59-2.5-4.62-5.1-5.05l-14.05-2.34-31.71,46.17c-4.57,6.65,3.62,14.62,10.14,9.87l43.68-31.83-2.97-16.82Z\" style=\"fill:#f27046;\"/><path d=\"M107.33,104l15.94-90.32c.93-5.3,8.53-5.3,9.47,0l15.94,90.32c.35,2.01,1.94,3.57,3.95,3.91l92.24,15.35c5.36.89,5.36,8.59,0,9.49l-92.24,15.35c-2.01.33-3.59,1.9-3.95,3.91l-15.94,90.32c-.93,5.3-8.53,5.3-9.47,0l-15.94-90.32c-.35-2.01-1.94-3.57-3.95-3.91l-92.24-15.35c-5.36-.89-5.36-8.59,0-9.49l92.24-15.35c2.01-.33,3.59-1.9,3.95-3.91Z\" style=\"fill:#572aff;\"/></svg>", "<svg id=\"Layer_1\" xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 256 256\"><g style=\"opacity:.5;\"><path d=\"M154.71,97c.46,2.59,2.5,4.62,5.1,5.05l14.05,2.34,31.71-46.17c4.57-6.65-3.62-14.62-10.14-9.87l-43.68,31.83,2.97,16.82Z\" style=\"fill:#579fd6;\"/><path d=\"M173.86,151.62l-14.05,2.34c-2.6.43-4.64,2.45-5.1,5.05l-2.97,16.82,43.68,31.83c6.52,4.75,14.71-3.21,10.14-9.87l-31.71-46.17Z\" style=\"fill:#579fd6;\"/><path d=\"M82.14,104.38l14.05-2.34c2.6-.43,4.64-2.45,5.1-5.05l2.97-16.82-43.68-31.83c-6.52-4.75-14.71,3.21-10.14,9.87l31.71,46.17Z\" style=\"fill:#579fd6;\"/><path d=\"M101.29,159c-.46-2.59-2.5-4.62-5.1-5.05l-14.05-2.34-31.71,46.17c-4.57,6.65,3.62,14.62,10.14,9.87l43.68-31.83-2.97-16.82Z\" style=\"fill:#579fd6;\"/></g><path d=\"M107.33,104l15.94-90.32c.93-5.3,8.53-5.3,9.47,0l15.94,90.32c.35,2.01,1.94,3.57,3.95,3.91l92.24,15.35c5.36.89,5.36,8.59,0,9.49l-92.24,15.35c-2.01.33-3.59,1.9-3.95,3.91l-15.94,90.32c-.93,5.3-8.53,5.3-9.47,0l-15.94-90.32c-.35-2.01-1.94-3.57-3.95-3.91l-92.24-15.35c-5.36-.89-5.36-8.59,0-9.49l92.24-15.35c2.01-.33,3.59-1.9,3.95-3.91Z\" style=\"fill:#579fd6;\"/></svg>", "import { asHex } from '@xylabs/sdk-js'\n\nimport {\n  LocalNetworkIconString, MainNetworkIconString, SequenceNetworkIconString,\n} from '../icons/index.ts'\nimport type { NetworkBootstrap, NetworkId } from '../models/index.ts'\nimport { NetworkBootstrapSchema } from '../models/index.ts'\n\n/** Bootstrap configuration for the XYO Layer 1 mainnet. */\nexport const MainNetwork: NetworkBootstrap = {\n  chain: asHex('319e667ced10452a117472811130444ded357f26', true),\n  description: 'Main Network for XYO Layer 1',\n  icon: MainNetworkIconString,\n  id: 'mainnet' as NetworkId,\n  name: 'Mainnet',\n  schema: NetworkBootstrapSchema,\n  symbol: 'XL1',\n  url: 'https://api.chain.xyo.network',\n  explorerUrl: 'https://explore.xyo.network',\n}\n\n/** Bootstrap configuration for the XYO Layer 1 sequence (test) network. */\nexport const SequenceNetwork: NetworkBootstrap = {\n  chain: asHex('4b43a753c8024c0e5000e8ac948ac0063ac624bc', true),\n  description: 'Test Network for XYO Layer 1',\n  icon: SequenceNetworkIconString,\n  id: 'sequence' as NetworkId,\n  name: 'Sequence',\n  schema: NetworkBootstrapSchema,\n  symbol: 'XL1',\n  url: 'https://beta.api.chain.xyo.network',\n  explorerUrl: 'https://beta.explore.xyo.network',\n}\n\n/** Bootstrap configuration for a local development network. */\nexport const LocalNetwork: NetworkBootstrap = {\n  description: 'Local Node',\n  icon: LocalNetworkIconString,\n  id: 'local' as NetworkId,\n  name: 'Local',\n  schema: NetworkBootstrapSchema,\n  symbol: 'XL1',\n  url: 'http://localhost:8080',\n  explorerUrl: 'http://localhost:3000',\n}\n\n/** Default set of available XYO Layer 1 networks (mainnet, sequence, local). */\nexport const DefaultNetworks: NetworkBootstrap[] = [MainNetwork, SequenceNetwork, LocalNetwork]\n", "import type { Address } from '@xylabs/sdk-js'\nimport { AsObjectFactory } from '@xylabs/sdk-js'\nimport type { Payload } from '@xyo-network/sdk-js'\nimport { asSchema, isPayloadOfSchemaType } from '@xyo-network/sdk-js'\nimport type { ChainId } from '@xyo-network/xl1-protocol-lib'\n\nimport type { NetworkId } from './NetworkId.ts'\n\n/** Connection details for accessing a chain endpoint. */\nexport interface ChainConnection {\n  /** Chain Identifier - can be a hex (eth contract address) or a string */\n  chain?: ChainId\n  /** Name of the chain */\n  name: string\n  /** Url for accessing the network */\n  url: string\n}\n\n/** Schema identifier for network bootstrap payloads. */\nexport const NetworkBootstrapSchema = asSchema('network.xyo.network.bootstrap', true)\n/** Schema type for network bootstrap payloads. */\nexport type NetworkBootstrapSchema = typeof NetworkBootstrapSchema\n\n/** Fields describing a chain fork origin. */\nexport interface ChainForkFields {\n  /** Block Number at which the chain was forked from */\n  forkedAtLastBlockNumber?: string\n  /** Hash in the last block the chain was forked from */\n  forkedAtLastHash?: string\n  /** Address of the forked chain */\n  forkedChainId?: Address\n}\n\n/** Core fields describing an XYO network. */\nexport interface NetworkFields {\n  /** Description of the network */\n  description: string\n  /** Url for accessing the network explorer */\n  explorerUrl?: string\n  /** string representation of the icon (svg) */\n  icon?: string\n  /** Machine-readable identifier */\n  id: NetworkId\n  schema: NetworkBootstrapSchema\n  /** Symbol of the network */\n  symbol?: string\n}\n\n/** Optional Properties can be found walking the chain to the genesis block */\nexport interface NetworkBootstrapFields extends NetworkFields, ChainForkFields, ChainConnection {}\n\n/** A network bootstrap extended with a flag indicating whether it is a custom network. */\nexport interface Network extends NetworkBootstrap {\n  custom: boolean\n}\n\n/** Payload type containing all network bootstrap configuration fields. */\nexport type NetworkBootstrap = Payload<NetworkBootstrapFields, NetworkBootstrapSchema>\n\n/** Type guard that checks whether a payload is a NetworkBootstrap. */\nexport const isNetworkBootstrap = isPayloadOfSchemaType<NetworkBootstrap>(NetworkBootstrapSchema)\n\n/** Optionally casts a value to a Network if it is a valid NetworkBootstrap. */\nexport const asOptionalNetwork = AsObjectFactory.createOptional(isNetworkBootstrap)\n", "import type { GatewayName } from '@xyo-network/xl1-protocol-lib'\n\nimport {\n  LocalNetwork, MainNetwork, SequenceNetwork,\n} from './Networks.ts'\n\n/** Map of network IDs to their corresponding Data Lake API URLs. */\nexport const NetworkDataLakeUrls = {\n  [MainNetwork.id]: 'https://api.archivist.xyo.network/dataLake',\n  [SequenceNetwork.id]: 'https://beta.api.archivist.xyo.network/dataLake',\n  [LocalNetwork.id]: 'http://localhost:8080/dataLake',\n} as const satisfies Record<GatewayName, string>\n", "import type { AttachableNodeInstance, WalletInstance } from '@xyo-network/sdk-js'\nimport { ManifestWrapper, ModuleFactoryLocator } from '@xyo-network/sdk-js'\n\nimport { NetworkNodeManifest } from '../../manifest/index.ts'\n\n/** Creates a network node from the network manifest using the provided wallet. */\nexport const getNetworkNode = async (wallet: WalletInstance): Promise<AttachableNodeInstance> => {\n  const wrapper = new ManifestWrapper(NetworkNodeManifest, wallet, new ModuleFactoryLocator())\n  const [node] = await wrapper.loadNodes()\n  return node\n}\n", "{\n  \"$schema\": \"https://raw.githubusercontent.com/XYOracleNetwork/sdk-xyo-client-js/main/packages/manifest/src/schema.json\",\n  \"nodes\": [\n    {\n      \"config\": {\n        \"accountPath\": \"44'/60'/1\",\n        \"name\": \"Network\",\n        \"schema\": \"network.xyo.node.config\"\n      },\n      \"modules\": {\n        \"private\": [],\n        \"public\": []\n      }\n    }\n  ],\n  \"schema\": \"network.xyo.manifest\"\n}", "import type { PackageManifestPayload } from '@xyo-network/sdk-js'\n\nimport node from './network.json' with { type: 'json' }\n\n/**\n * Root Node Manifest\n */\nexport const NetworkNodeManifest = node as unknown as PackageManifestPayload\n", "import type { AttachableNodeInstance } from '@xyo-network/sdk-js'\n\nconst networkNodeMap = new Map<string, AttachableNodeInstance>()\n\n/** Returns the global map of network URL to node instance. */\nexport const getNetworkNodes = () => {\n  return networkNodeMap\n}\n", "import type { AttachableNodeInstance, WalletInstance } from '@xyo-network/sdk-js'\n\nimport type { NetworkBootstrap } from '../../models/index.ts'\nimport { getNetworkNode } from './getNetworkNode.ts'\nimport { getNetworkNodes } from './getNetworkNodes.ts'\n\n/** Initializes or retrieves a cached network node for the given network and wallet. */\nexport const initNetworkNode = async (activeNetwork: NetworkBootstrap, wallet: WalletInstance): Promise<AttachableNodeInstance> => {\n  const networkNodeMap = getNetworkNodes()\n  if (networkNodeMap.has(activeNetwork.url)) return networkNodeMap.get(activeNetwork.url)!\n\n  const activeNetworkNode = await getNetworkNode(wallet)\n  networkNodeMap.set(activeNetwork.url, activeNetworkNode)\n\n  return activeNetworkNode\n}\n", "import type { NetworkId } from '../models/index.ts'\n\n/** Builds URLs to pages on an XL1 chain explorer for a specific network. */\nexport class ExplorerLinks {\n  readonly explorerUrl: string\n  readonly networkId: NetworkId\n\n  constructor(explorerUrl: string, networkId: NetworkId) {\n    this.explorerUrl = explorerUrl.replace(/\\/+$/, '')\n    this.networkId = networkId\n  }\n\n  /** `{explorerUrl}/xl1/{networkId}/address/{address}` */\n  address(address: string): string {\n    return `${this.network()}/address/${address}`\n  }\n\n  /** `{explorerUrl}/xl1/{networkId}/addresses` */\n  addresses(): string {\n    return `${this.network()}/addresses`\n  }\n\n  /** `{explorerUrl}/xl1/{networkId}/block/{blockHash}` */\n  block(blockHash: string): string {\n    return `${this.network()}/block/${blockHash}`\n  }\n\n  /** `{explorerUrl}/xl1/{networkId}/block/number/{blockNumber}` */\n  blockByNumber(blockNumber: number | string): string {\n    return `${this.network()}/block/number/${blockNumber}`\n  }\n\n  /** `{explorerUrl}/xl1/{networkId}/block/{blockHash}/payload/{payloadHash}[/{render}]` */\n  blockPayload(blockHash: string, payloadHash: string, render?: string): string {\n    const base = `${this.network()}/block/${blockHash}/payload/${payloadHash}`\n    return render === undefined ? base : `${base}/${render}`\n  }\n\n  /** `{explorerUrl}/xl1/{networkId}/blocks` */\n  blocks(): string {\n    return `${this.network()}/blocks`\n  }\n\n  /** `{explorerUrl}/xl1/{networkId}` */\n  network(): string {\n    return `${this.explorerUrl}/xl1/${this.networkId}`\n  }\n\n  /** `{explorerUrl}/xl1/{networkId}/transaction/{txHash}` */\n  transaction(txHash: string): string {\n    return `${this.network()}/transaction/${txHash}`\n  }\n\n  /** `{explorerUrl}/xl1/{networkId}/transaction/{txHash}/payload/{payloadHash}[/{render}]` */\n  transactionPayload(txHash: string, payloadHash: string, render?: string): string {\n    const base = `${this.network()}/transaction/${txHash}/payload/${payloadHash}`\n    return render === undefined ? base : `${base}/${render}`\n  }\n\n  /** `{explorerUrl}/xl1/{networkId}/transactions` */\n  transactions(): string {\n    return `${this.network()}/transactions`\n  }\n}\n"],
-  "mappings": "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",
-  "names": ["networkNodeMap"]
+  "sources": ["../../src/icons/local/local.svg", "../../src/icons/mainnet/mainnet.svg", "../../src/icons/sequence/testnet.svg", "../../src/lib/Networks.ts", "../../src/models/Bootstrap.ts", "../../src/lib/NetworkDataLakeUrls.ts", "../../src/modules/node/getNetworkNode.ts", "../../src/manifest/network.json", "../../src/manifest/networkManifest.ts", "../../src/modules/node/getNetworkNodes.ts", "../../src/modules/node/initNetworkNode.ts", "../../src/staticRest/layout/chainManifest.ts", "../../src/staticRest/paths/chainState.ts", "../../src/staticRest/paths/finalized.ts", "../../src/staticRest/paths/indexPaths.ts", "../../src/staticRest/templates.ts", "../../src/staticRest/layout/indexManifest.ts", "../../src/utils/ExplorerLinks.ts"],
+  "sourcesContent": ["<svg id=\"Layer_1\" xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 256 256\"><g style=\"opacity:.5;\"><path d=\"M154.71,97c.46,2.59,2.5,4.62,5.1,5.05l14.05,2.34,31.71-46.17c4.57-6.65-3.62-14.62-10.14-9.87l-43.68,31.83,2.97,16.82Z\" style=\"fill:#f47f00;\"/><path d=\"M173.86,151.62l-14.05,2.34c-2.6.43-4.64,2.45-5.1,5.05l-2.97,16.82,43.68,31.83c6.52,4.75,14.71-3.21,10.14-9.87l-31.71-46.17Z\" style=\"fill:#f47f00;\"/><path d=\"M82.14,104.38l14.05-2.34c2.6-.43,4.64-2.45,5.1-5.05l2.97-16.82-43.68-31.83c-6.52-4.75-14.71,3.21-10.14,9.87l31.71,46.17Z\" style=\"fill:#f47f00;\"/><path d=\"M101.29,159c-.46-2.59-2.5-4.62-5.1-5.05l-14.05-2.34-31.71,46.17c-4.57,6.65,3.62,14.62,10.14,9.87l43.68-31.83-2.97-16.82Z\" style=\"fill:#f47f00;\"/></g><path d=\"M107.33,104l15.94-90.32c.93-5.3,8.53-5.3,9.47,0l15.94,90.32c.35,2.01,1.94,3.57,3.95,3.91l92.24,15.35c5.36.89,5.36,8.59,0,9.49l-92.24,15.35c-2.01.33-3.59,1.9-3.95,3.91l-15.94,90.32c-.93,5.3-8.53,5.3-9.47,0l-15.94-90.32c-.35-2.01-1.94-3.57-3.95-3.91l-92.24-15.35c-5.36-.89-5.36-8.59,0-9.49l92.24-15.35c2.01-.33,3.59-1.9,3.95-3.91Z\" style=\"fill:#f47f00;\"/></svg>", "<svg id=\"Layer_1\" xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 256 256\"><path d=\"M154.71,97c.46,2.59,2.5,4.62,5.1,5.05l14.05,2.34,31.71-46.17c4.57-6.65-3.62-14.62-10.14-9.87l-43.68,31.83,2.97,16.82Z\" style=\"fill:#8d8fc6;\"/><path d=\"M173.86,151.62l-14.05,2.34c-2.6.43-4.64,2.45-5.1,5.05l-2.97,16.82,43.68,31.83c6.52,4.75,14.71-3.21,10.14-9.87l-31.71-46.17Z\" style=\"fill:#eb407a;\"/><path d=\"M82.14,104.38l14.05-2.34c2.6-.43,4.64-2.45,5.1-5.05l2.97-16.82-43.68-31.83c-6.52-4.75-14.71,3.21-10.14,9.87l31.71,46.17Z\" style=\"fill:#579fd6;\"/><path d=\"M101.29,159c-.46-2.59-2.5-4.62-5.1-5.05l-14.05-2.34-31.71,46.17c-4.57,6.65,3.62,14.62,10.14,9.87l43.68-31.83-2.97-16.82Z\" style=\"fill:#f27046;\"/><path d=\"M107.33,104l15.94-90.32c.93-5.3,8.53-5.3,9.47,0l15.94,90.32c.35,2.01,1.94,3.57,3.95,3.91l92.24,15.35c5.36.89,5.36,8.59,0,9.49l-92.24,15.35c-2.01.33-3.59,1.9-3.95,3.91l-15.94,90.32c-.93,5.3-8.53,5.3-9.47,0l-15.94-90.32c-.35-2.01-1.94-3.57-3.95-3.91l-92.24-15.35c-5.36-.89-5.36-8.59,0-9.49l92.24-15.35c2.01-.33,3.59-1.9,3.95-3.91Z\" style=\"fill:#572aff;\"/></svg>", "<svg id=\"Layer_1\" xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 256 256\"><g style=\"opacity:.5;\"><path d=\"M154.71,97c.46,2.59,2.5,4.62,5.1,5.05l14.05,2.34,31.71-46.17c4.57-6.65-3.62-14.62-10.14-9.87l-43.68,31.83,2.97,16.82Z\" style=\"fill:#579fd6;\"/><path d=\"M173.86,151.62l-14.05,2.34c-2.6.43-4.64,2.45-5.1,5.05l-2.97,16.82,43.68,31.83c6.52,4.75,14.71-3.21,10.14-9.87l-31.71-46.17Z\" style=\"fill:#579fd6;\"/><path d=\"M82.14,104.38l14.05-2.34c2.6-.43,4.64-2.45,5.1-5.05l2.97-16.82-43.68-31.83c-6.52-4.75-14.71,3.21-10.14,9.87l31.71,46.17Z\" style=\"fill:#579fd6;\"/><path d=\"M101.29,159c-.46-2.59-2.5-4.62-5.1-5.05l-14.05-2.34-31.71,46.17c-4.57,6.65,3.62,14.62,10.14,9.87l43.68-31.83-2.97-16.82Z\" style=\"fill:#579fd6;\"/></g><path d=\"M107.33,104l15.94-90.32c.93-5.3,8.53-5.3,9.47,0l15.94,90.32c.35,2.01,1.94,3.57,3.95,3.91l92.24,15.35c5.36.89,5.36,8.59,0,9.49l-92.24,15.35c-2.01.33-3.59,1.9-3.95,3.91l-15.94,90.32c-.93,5.3-8.53,5.3-9.47,0l-15.94-90.32c-.35-2.01-1.94-3.57-3.95-3.91l-92.24-15.35c-5.36-.89-5.36-8.59,0-9.49l92.24-15.35c2.01-.33,3.59-1.9,3.95-3.91Z\" style=\"fill:#579fd6;\"/></svg>", "import { asHex } from '@xylabs/sdk-js'\n\nimport {\n  LocalNetworkIconString, MainNetworkIconString, SequenceNetworkIconString,\n} from '../icons/index.ts'\nimport type { NetworkBootstrap, NetworkId } from '../models/index.ts'\nimport { NetworkBootstrapSchema } from '../models/index.ts'\n\n/** Bootstrap configuration for the XYO Layer 1 mainnet. */\nexport const MainNetwork: NetworkBootstrap = {\n  chain: asHex('319e667ced10452a117472811130444ded357f26', true),\n  description: 'Main Network for XYO Layer 1',\n  icon: MainNetworkIconString,\n  id: 'mainnet' as NetworkId,\n  name: 'Mainnet',\n  schema: NetworkBootstrapSchema,\n  symbol: 'XL1',\n  url: 'https://api.chain.xyo.network',\n  explorerUrl: 'https://explore.xyo.network',\n}\n\n/** Bootstrap configuration for the XYO Layer 1 sequence (test) network. */\nexport const SequenceNetwork: NetworkBootstrap = {\n  chain: asHex('4b43a753c8024c0e5000e8ac948ac0063ac624bc', true),\n  description: 'Test Network for XYO Layer 1',\n  icon: SequenceNetworkIconString,\n  id: 'sequence' as NetworkId,\n  name: 'Sequence',\n  schema: NetworkBootstrapSchema,\n  symbol: 'XL1',\n  url: 'https://beta.api.chain.xyo.network',\n  explorerUrl: 'https://beta.explore.xyo.network',\n}\n\n/** Bootstrap configuration for a local development network. */\nexport const LocalNetwork: NetworkBootstrap = {\n  description: 'Local Node',\n  icon: LocalNetworkIconString,\n  id: 'local' as NetworkId,\n  name: 'Local',\n  schema: NetworkBootstrapSchema,\n  symbol: 'XL1',\n  url: 'http://localhost:8080',\n  explorerUrl: 'http://localhost:3000',\n}\n\n/** Default set of available XYO Layer 1 networks (mainnet, sequence, local). */\nexport const DefaultNetworks: NetworkBootstrap[] = [MainNetwork, SequenceNetwork, LocalNetwork]\n", "import type { Address } from '@xylabs/sdk-js'\nimport { AsObjectFactory } from '@xylabs/sdk-js'\nimport type { Payload } from '@xyo-network/sdk-js'\nimport { asSchema, isPayloadOfSchemaType } from '@xyo-network/sdk-js'\nimport type { ChainId } from '@xyo-network/xl1-protocol-lib'\n\nimport type { NetworkId } from './NetworkId.ts'\n\n/** Connection details for accessing a chain endpoint. */\nexport interface ChainConnection {\n  /** Chain Identifier - can be a hex (eth contract address) or a string */\n  chain?: ChainId\n  /** Name of the chain */\n  name: string\n  /** Url for accessing the network */\n  url: string\n}\n\n/** Schema identifier for network bootstrap payloads. */\nexport const NetworkBootstrapSchema = asSchema('network.xyo.network.bootstrap', true)\n/** Schema type for network bootstrap payloads. */\nexport type NetworkBootstrapSchema = typeof NetworkBootstrapSchema\n\n/** Fields describing a chain fork origin. */\nexport interface ChainForkFields {\n  /** Block Number at which the chain was forked from */\n  forkedAtLastBlockNumber?: string\n  /** Hash in the last block the chain was forked from */\n  forkedAtLastHash?: string\n  /** Address of the forked chain */\n  forkedChainId?: Address\n}\n\n/** Core fields describing an XYO network. */\nexport interface NetworkFields {\n  /** Description of the network */\n  description: string\n  /** Url for accessing the network explorer */\n  explorerUrl?: string\n  /** string representation of the icon (svg) */\n  icon?: string\n  /** Machine-readable identifier */\n  id: NetworkId\n  schema: NetworkBootstrapSchema\n  /** Symbol of the network */\n  symbol?: string\n}\n\n/** Optional Properties can be found walking the chain to the genesis block */\nexport interface NetworkBootstrapFields extends NetworkFields, ChainForkFields, ChainConnection {}\n\n/** A network bootstrap extended with a flag indicating whether it is a custom network. */\nexport interface Network extends NetworkBootstrap {\n  custom: boolean\n}\n\n/** Payload type containing all network bootstrap configuration fields. */\nexport type NetworkBootstrap = Payload<NetworkBootstrapFields, NetworkBootstrapSchema>\n\n/** Type guard that checks whether a payload is a NetworkBootstrap. */\nexport const isNetworkBootstrap = isPayloadOfSchemaType<NetworkBootstrap>(NetworkBootstrapSchema)\n\n/** Optionally casts a value to a Network if it is a valid NetworkBootstrap. */\nexport const asOptionalNetwork = AsObjectFactory.createOptional(isNetworkBootstrap)\n", "import type { GatewayName } from '@xyo-network/xl1-protocol-lib'\n\nimport {\n  LocalNetwork, MainNetwork, SequenceNetwork,\n} from './Networks.ts'\n\n/** Map of network IDs to their corresponding Data Lake API URLs. */\nexport const NetworkDataLakeUrls = {\n  [MainNetwork.id]: 'https://api.archivist.xyo.network/dataLake',\n  [SequenceNetwork.id]: 'https://beta.api.archivist.xyo.network/dataLake',\n  [LocalNetwork.id]: 'http://localhost:8080/dataLake',\n} as const satisfies Record<GatewayName, string>\n", "import type { AttachableNodeInstance, WalletInstance } from '@xyo-network/sdk-js'\nimport { ManifestWrapper, ModuleFactoryLocator } from '@xyo-network/sdk-js'\n\nimport { NetworkNodeManifest } from '../../manifest/index.ts'\n\n/** Creates a network node from the network manifest using the provided wallet. */\nexport const getNetworkNode = async (wallet: WalletInstance): Promise<AttachableNodeInstance> => {\n  const wrapper = new ManifestWrapper(NetworkNodeManifest, wallet, new ModuleFactoryLocator())\n  const [node] = await wrapper.loadNodes()\n  return node\n}\n", "{\n  \"$schema\": \"https://raw.githubusercontent.com/XYOracleNetwork/sdk-xyo-client-js/main/packages/manifest/src/schema.json\",\n  \"nodes\": [\n    {\n      \"config\": {\n        \"accountPath\": \"44'/60'/1\",\n        \"name\": \"Network\",\n        \"schema\": \"network.xyo.node.config\"\n      },\n      \"modules\": {\n        \"private\": [],\n        \"public\": []\n      }\n    }\n  ],\n  \"schema\": \"network.xyo.manifest\"\n}", "import type { PackageManifestPayload } from '@xyo-network/sdk-js'\n\nimport node from './network.json' with { type: 'json' }\n\n/**\n * Root Node Manifest\n */\nexport const NetworkNodeManifest = node as unknown as PackageManifestPayload\n", "import type { AttachableNodeInstance } from '@xyo-network/sdk-js'\n\nconst networkNodeMap = new Map<string, AttachableNodeInstance>()\n\n/** Returns the global map of network URL to node instance. */\nexport const getNetworkNodes = () => {\n  return networkNodeMap\n}\n", "import type { AttachableNodeInstance, WalletInstance } from '@xyo-network/sdk-js'\n\nimport type { NetworkBootstrap } from '../../models/index.ts'\nimport { getNetworkNode } from './getNetworkNode.ts'\nimport { getNetworkNodes } from './getNetworkNodes.ts'\n\n/** Initializes or retrieves a cached network node for the given network and wallet. */\nexport const initNetworkNode = async (activeNetwork: NetworkBootstrap, wallet: WalletInstance): Promise<AttachableNodeInstance> => {\n  const networkNodeMap = getNetworkNodes()\n  if (networkNodeMap.has(activeNetwork.url)) return networkNodeMap.get(activeNetwork.url)!\n\n  const activeNetworkNode = await getNetworkNode(wallet)\n  networkNodeMap.set(activeNetwork.url, activeNetworkNode)\n\n  return activeNetworkNode\n}\n", "import {\n  zodAsFactory, zodIsFactory, zodToFactory,\n} from '@xylabs/sdk-js'\nimport { z } from 'zod'\n\nimport { chainManifestPathTemplates } from '../templates.ts'\n\n/** Bumped when the finalized layout changes shape, so readers can detect a mismatch. */\nexport const CHAIN_LAYOUT_VERSION = 1\n\n/** Schema id for the finalized layout manifest document. */\nexport const ChainManifestSchema = 'network.xyo.s3.chain.manifest' as const\n/** Type literal for the chain manifest schema. */\nexport type ChainManifestSchema = typeof ChainManifestSchema\n\n/** Path templates for the finalized + chain-state files. */\nexport const ChainManifestPathsZod = z.object({\n  blockByHash: z.string(),\n  blockByNumber: z.string(),\n  head: z.string(),\n  payload: z.string(),\n})\n\n/** Type for chain manifest path templates. */\nexport type ChainManifestPaths = z.infer<typeof ChainManifestPathsZod>\n\n/** Zod schema for the finalized layout descriptor at `manifestPath()`. */\nexport const ChainManifestZod = z.object({\n  /** Lowest block number available in the bucket (genesis until pruning exists). */\n  earliestBlock: z.int().nonnegative(),\n  /** Storage/wire encoding of the published files (also on each object's Content-Encoding). */\n  encoding: z.string(),\n  paths: ChainManifestPathsZod,\n  schema: z.literal(ChainManifestSchema),\n  version: z.int().positive(),\n})\n\n/** The finalized layout descriptor at `manifestPath()`. */\nexport type ChainManifest = z.infer<typeof ChainManifestZod>\n\n/** Type guard that checks if a value is a valid ChainManifest. */\nexport const isChainManifest = zodIsFactory(ChainManifestZod)\n/** Converts a value to ChainManifest, throwing if invalid. */\nexport const asChainManifest = zodAsFactory(ChainManifestZod, 'asChainManifest')\n/** Non-validating cast to ChainManifest. */\nexport const toChainManifest = zodToFactory(ChainManifestZod, 'toChainManifest')\n\n/** Builds a validated chain manifest with path templates derived from the path builders. */\nexport function createChainManifest(encoding: string, earliestBlock = 0): ChainManifest {\n  return asChainManifest({\n    earliestBlock,\n    encoding,\n    paths: chainManifestPathTemplates(),\n    schema: ChainManifestSchema,\n    version: CHAIN_LAYOUT_VERSION,\n  }, true)\n}\n", "/**\n * Path builders for the chain-state (mutable) bucket.\n *\n * Paths are relative \u2014 no leading slash \u2014 and joined to a base URL by the consumer.\n */\n\n/** The mutable head pointer: the current head SignedHydratedBlockWithHashMeta. */\nexport const headPath = (): string => 'chain/head.json'\n", "/**\n * Path builders for the finalized (immutable) bucket.\n *\n * Paths are relative \u2014 no leading slash \u2014 and joined to a base URL by the consumer.\n */\n\n/** The finalized layout descriptor (path templates, encoding, version, earliest block). */\nexport const manifestPath = (): string => 'manifest.json'\n\n/** A block by number: SignedHydratedBlockWithHashMeta. */\nexport const blockNumberPath = (block: number): string => `block/number/${block}.json`\n\n/** A block by hash: the same content as its by-number twin. */\nexport const blockHashPath = (hash: string): string => `block/hash/${hash}.json`\n\n/** A payload by hash: WithHashMeta<Payload>. */\nexport const payloadPath = (hash: string): string => `payload/${hash}.json`\n", "import type { IndexSummaryFamily } from '@xyo-network/xl1-protocol-lib'\n\n/**\n * Path builders for the index bucket.\n *\n * The index is a separate, single-writer bucket holding completed step summaries for several\n * families. Paths are relative \u2014 no leading slash \u2014 and joined to a base URL by the consumer.\n */\n\n/** A completed frame's summary for a family, e.g. `blocks/2/5.json`. Immutable once written. */\nexport const indexSummaryPath = (family: IndexSummaryFamily, stepLevel: number, stepIndex: number): string =>\n  `${family}/${stepLevel}/${stepIndex}.json`\n\n/** The index layout descriptor (families, max step, encoding, version). */\nexport const indexManifestPath = (): string => 'manifest.json'\n\n/** The indexer's progress watermark (highest block the index is complete through). */\nexport const indexHeadPath = (): string => 'head.json'\n", "import type { IndexSummaryFamily } from '@xyo-network/xl1-protocol-lib'\n\nimport { headPath } from './paths/chainState.ts'\nimport {\n  blockHashPath, blockNumberPath, payloadPath,\n} from './paths/finalized.ts'\nimport { indexSummaryPath } from './paths/indexPaths.ts'\n\n/** Sentinel values used when deriving self-describing path templates from concrete builders. */\nconst TEMPLATE_SLOTS = {\n  block: 0,\n  hash: '0'.repeat(64),\n  index: 99,\n  level: 42,\n} as const\n\n/**\n * Replaces concrete slot literals in a path with named `{placeholder}` segments.\n * Used to derive manifest path templates from the path builders so the two cannot drift.\n */\nexport function toPathTemplate(path: string, slots: { literal: string; name: string }[]): string {\n  let result = path\n  for (const { literal, name } of slots) {\n    if (!result.includes(literal)) {\n      throw new Error(`Template slot \"${literal}\" not found in path \"${path}\"`)\n    }\n    result = result.replace(literal, `{${name}}`)\n  }\n  return result\n}\n\n/** Fills `{placeholder}` segments in a manifest path template. Used in conformance tests. */\nexport function interpolatePathTemplate(template: string, values: Record<string, string | number>): string {\n  let result = template\n  for (const [key, value] of Object.entries(values)) {\n    result = result.replaceAll(`{${key}}`, String(value))\n  }\n  return result\n}\n\n/** Self-describing template for `blockNumberPath`. */\nexport const blockNumberPathTemplate = (): string =>\n  toPathTemplate(blockNumberPath(TEMPLATE_SLOTS.block), [{ literal: String(TEMPLATE_SLOTS.block), name: 'block' }])\n\n/** Self-describing template for `blockHashPath`. */\nexport const blockHashPathTemplate = (): string =>\n  toPathTemplate(blockHashPath(TEMPLATE_SLOTS.hash), [{ literal: TEMPLATE_SLOTS.hash, name: 'hash' }])\n\n/** Self-describing template for `payloadPath`. */\nexport const payloadPathTemplate = (): string =>\n  toPathTemplate(payloadPath(TEMPLATE_SLOTS.hash), [{ literal: TEMPLATE_SLOTS.hash, name: 'hash' }])\n\n/** Self-describing templates for finalized + chain-state files carried in the chain manifest. */\nexport function chainManifestPathTemplates(): {\n  blockByHash: string\n  blockByNumber: string\n  head: string\n  payload: string\n} {\n  return {\n    blockByHash: blockHashPathTemplate(),\n    blockByNumber: blockNumberPathTemplate(),\n    head: headPath(),\n    payload: payloadPathTemplate(),\n  }\n}\n\n/** Self-describing template for one index summary family, e.g. `blocks/{level}/{index}.json`. */\nexport function indexSummaryPathTemplate(family: IndexSummaryFamily): string {\n  const path = indexSummaryPath(family, TEMPLATE_SLOTS.level, TEMPLATE_SLOTS.index)\n  return toPathTemplate(path, [\n    { literal: String(TEMPLATE_SLOTS.level), name: 'level' },\n    { literal: String(TEMPLATE_SLOTS.index), name: 'index' },\n  ])\n}\n", "import {\n  zodAsFactory, zodIsFactory, zodToFactory,\n} from '@xylabs/sdk-js'\nimport type { IndexSummaryFamily, IndexWatermark } from '@xyo-network/xl1-protocol-lib'\nimport { z } from 'zod'\n\nimport { indexSummaryPathTemplate } from '../templates.ts'\n\n/** Bumped when the on-disk index layout changes shape, so readers can detect a mismatch. */\nexport const INDEX_LAYOUT_VERSION = 1\n\n/** Schema id for the index manifest document (the static layout descriptor). */\nexport const IndexManifestSchema = 'network.xyo.s3.index.manifest' as const\n/** Type literal for the index manifest schema. */\nexport type IndexManifestSchema = typeof IndexManifestSchema\n\n/** Schema id for the index head document (the progress watermark). */\nexport const IndexHeadSchema = 'network.xyo.s3.index.head' as const\n/** Type literal for the index head schema. */\nexport type IndexHeadSchema = typeof IndexHeadSchema\n\n/** Per-family descriptor carried in the manifest. */\nexport const IndexManifestFamilyZod = z.object({\n  /** Highest step level published for this family. */\n  maxStep: z.int().nonnegative(),\n  /** Path template for the family's frames, e.g. `blocks/{level}/{index}.json`. */\n  path: z.string(),\n})\n\n/** Type for one index manifest family descriptor. */\nexport type IndexManifestFamily = z.infer<typeof IndexManifestFamilyZod>\n\nconst indexFamiliesZod = z.object({\n  balances: IndexManifestFamilyZod,\n  blocks: IndexManifestFamilyZod,\n  schemas: IndexManifestFamilyZod,\n  transfers: IndexManifestFamilyZod,\n})\n\n/** Zod schema for the static index layout descriptor at `indexManifestPath()`. */\nexport const IndexManifestZod = z.object({\n  families: indexFamiliesZod,\n  schema: z.literal(IndexManifestSchema),\n  version: z.int().positive(),\n})\n\n/** The static index layout descriptor at `indexManifestPath()`. */\nexport type IndexManifest = z.infer<typeof IndexManifestZod>\n\n/** Type guard that checks if a value is a valid IndexManifest. */\nexport const isIndexManifest = zodIsFactory(IndexManifestZod)\n/** Converts a value to IndexManifest, throwing if invalid. */\nexport const asIndexManifest = zodAsFactory(IndexManifestZod, 'asIndexManifest')\n/** Non-validating cast to IndexManifest. */\nexport const toIndexManifest = zodToFactory(IndexManifestZod, 'toIndexManifest')\n\n/** Completed frame counts per family in the index head watermark. */\nexport const IndexHeadFamiliesZod = z.object({\n  balances: z.int().nonnegative(),\n  blocks: z.int().nonnegative(),\n  schemas: z.int().nonnegative(),\n  transfers: z.int().nonnegative(),\n})\n\n/** Zod schema for the index progress watermark at `indexHeadPath()`. */\nexport const IndexHeadZod = z.object({\n  /** Highest block the index is complete through. */\n  block: z.int().nonnegative(),\n  /** Completed frame counts per family. */\n  families: IndexHeadFamiliesZod,\n  /** Hash of that block. */\n  hash: z.string(),\n  schema: z.literal(IndexHeadSchema),\n  /** ISO-8601 timestamp of the last update. */\n  updatedAt: z.string(),\n  version: z.int().positive(),\n})\n\n/** The index progress watermark at `indexHeadPath()`. */\nexport type IndexHead = z.infer<typeof IndexHeadZod>\n\n/** Type guard that checks if a value is a valid IndexHead. */\nexport const isIndexHead = zodIsFactory(IndexHeadZod)\n/** Converts a value to IndexHead, throwing if invalid. */\nexport const asIndexHead = zodAsFactory(IndexHeadZod, 'asIndexHead')\n/** Non-validating cast to IndexHead. */\nexport const toIndexHead = zodToFactory(IndexHeadZod, 'toIndexHead')\n\n/** Builds per-family manifest descriptors with path templates derived from the path builders. */\nexport function createIndexManifestFamilies(\n  maxSteps: Record<IndexSummaryFamily, number>,\n): Record<IndexSummaryFamily, IndexManifestFamily> {\n  return {\n    balances: { maxStep: maxSteps.balances, path: indexSummaryPathTemplate('balances') },\n    blocks: { maxStep: maxSteps.blocks, path: indexSummaryPathTemplate('blocks') },\n    schemas: { maxStep: maxSteps.schemas, path: indexSummaryPathTemplate('schemas') },\n    transfers: { maxStep: maxSteps.transfers, path: indexSummaryPathTemplate('transfers') },\n  }\n}\n\n/** Builds a validated index manifest with path templates derived from the path builders. */\nexport function createIndexManifest(maxSteps: Record<IndexSummaryFamily, number>): IndexManifest {\n  return asIndexManifest({\n    families: createIndexManifestFamilies(maxSteps),\n    schema: IndexManifestSchema,\n    version: INDEX_LAYOUT_VERSION,\n  }, true)\n}\n\n/** Builds a validated index head watermark from an indexer progress snapshot. */\nexport function createIndexHead(watermark: IndexWatermark, updatedAt = new Date().toISOString()): IndexHead {\n  return asIndexHead({\n    block: watermark.block,\n    families: watermark.families,\n    hash: watermark.hash,\n    schema: IndexHeadSchema,\n    updatedAt,\n    version: INDEX_LAYOUT_VERSION,\n  }, true)\n}\n", "import type { NetworkId } from '../models/index.ts'\n\n/** Builds URLs to pages on an XL1 chain explorer for a specific network. */\nexport class ExplorerLinks {\n  readonly explorerUrl: string\n  readonly networkId: NetworkId\n\n  constructor(explorerUrl: string, networkId: NetworkId) {\n    this.explorerUrl = explorerUrl.replace(/\\/+$/, '')\n    this.networkId = networkId\n  }\n\n  /** `{explorerUrl}/xl1/{networkId}/address/{address}` */\n  address(address: string): string {\n    return `${this.network()}/address/${address}`\n  }\n\n  /** `{explorerUrl}/xl1/{networkId}/addresses` */\n  addresses(): string {\n    return `${this.network()}/addresses`\n  }\n\n  /** `{explorerUrl}/xl1/{networkId}/block/{blockHash}` */\n  block(blockHash: string): string {\n    return `${this.network()}/block/${blockHash}`\n  }\n\n  /** `{explorerUrl}/xl1/{networkId}/block/number/{blockNumber}` */\n  blockByNumber(blockNumber: number | string): string {\n    return `${this.network()}/block/number/${blockNumber}`\n  }\n\n  /** `{explorerUrl}/xl1/{networkId}/block/{blockHash}/payload/{payloadHash}[/{render}]` */\n  blockPayload(blockHash: string, payloadHash: string, render?: string): string {\n    const base = `${this.network()}/block/${blockHash}/payload/${payloadHash}`\n    return render === undefined ? base : `${base}/${render}`\n  }\n\n  /** `{explorerUrl}/xl1/{networkId}/blocks` */\n  blocks(): string {\n    return `${this.network()}/blocks`\n  }\n\n  /** `{explorerUrl}/xl1/{networkId}` */\n  network(): string {\n    return `${this.explorerUrl}/xl1/${this.networkId}`\n  }\n\n  /** `{explorerUrl}/xl1/{networkId}/transaction/{txHash}` */\n  transaction(txHash: string): string {\n    return `${this.network()}/transaction/${txHash}`\n  }\n\n  /** `{explorerUrl}/xl1/{networkId}/transaction/{txHash}/payload/{payloadHash}[/{render}]` */\n  transactionPayload(txHash: string, payloadHash: string, render?: string): string {\n    const base = `${this.network()}/transaction/${txHash}/payload/${payloadHash}`\n    return render === undefined ? base : `${base}/${render}`\n  }\n\n  /** `{explorerUrl}/xl1/{networkId}/transactions` */\n  transactions(): string {\n    return `${this.network()}/transactions`\n  }\n}\n"],
+  "mappings": "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",
+  "names": ["networkNodeMap", "zodAsFactory", "zodIsFactory", "zodToFactory", "z", "z", "zodIsFactory", "zodAsFactory", "zodToFactory"]
 }

package/dist/neutral/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.ts';
+export * from './paths/index.ts';
+export * from './templates.ts';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/neutral/staticRest/layout/chainManifest.d.ts

@@ -0,0 +1,101 @@
+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";
+/** Type literal for the chain manifest schema. */
+export type ChainManifestSchema = typeof ChainManifestSchema;
+/** Path templates for the finalized + chain-state files. */
+export declare const ChainManifestPathsZod: z.ZodObject<{
+    blockByHash: z.ZodString;
+    blockByNumber: z.ZodString;
+    head: z.ZodString;
+    payload: z.ZodString;
+}, z.core.$strip>;
+/** Type for chain manifest path templates. */
+export type ChainManifestPaths = z.infer<typeof ChainManifestPathsZod>;
+/** Zod schema for the finalized layout descriptor at `manifestPath()`. */
+export declare const ChainManifestZod: z.ZodObject<{
+    earliestBlock: z.ZodInt;
+    encoding: z.ZodString;
+    paths: z.ZodObject<{
+        blockByHash: z.ZodString;
+        blockByNumber: z.ZodString;
+        head: z.ZodString;
+        payload: z.ZodString;
+    }, z.core.$strip>;
+    schema: z.ZodLiteral<"network.xyo.s3.chain.manifest">;
+    version: z.ZodInt;
+}, z.core.$strip>;
+/** The finalized layout descriptor at `manifestPath()`. */
+export type ChainManifest = z.infer<typeof ChainManifestZod>;
+/** Type guard that checks if a value is a valid ChainManifest. */
+export declare const isChainManifest: <T>(value: T) => value is T & {
+    earliestBlock: number;
+    encoding: string;
+    paths: {
+        blockByHash: string;
+        blockByNumber: string;
+        head: string;
+        payload: string;
+    };
+    schema: "network.xyo.s3.chain.manifest";
+    version: number;
+};
+/** Converts a value to ChainManifest, throwing if invalid. */
+export declare const asChainManifest: {
+    <T>(value: T): (T & {
+        earliestBlock: number;
+        encoding: string;
+        paths: {
+            blockByHash: string;
+            blockByNumber: string;
+            head: string;
+            payload: string;
+        };
+        schema: "network.xyo.s3.chain.manifest";
+        version: number;
+    }) | undefined;
+    <T>(value: T, assert: import("@xylabs/sdk-js").ZodFactoryConfig): T & {
+        earliestBlock: number;
+        encoding: string;
+        paths: {
+            blockByHash: string;
+            blockByNumber: string;
+            head: string;
+            payload: string;
+        };
+        schema: "network.xyo.s3.chain.manifest";
+        version: number;
+    };
+};
+/** Non-validating cast to ChainManifest. */
+export declare const toChainManifest: {
+    <T>(value: T): (T & {
+        earliestBlock: number;
+        encoding: string;
+        paths: {
+            blockByHash: string;
+            blockByNumber: string;
+            head: string;
+            payload: string;
+        };
+        schema: "network.xyo.s3.chain.manifest";
+        version: number;
+    }) | undefined;
+    <T>(value: T, assert: import("@xylabs/sdk-js").ZodFactoryConfig): T & {
+        earliestBlock: number;
+        encoding: string;
+        paths: {
+            blockByHash: string;
+            blockByNumber: string;
+            head: string;
+            payload: string;
+        };
+        schema: "network.xyo.s3.chain.manifest";
+        version: number;
+    };
+};
+/** Builds a validated chain manifest with path templates derived from the path builders. */
+export declare function createChainManifest(encoding: string, earliestBlock?: number): ChainManifest;
+//# sourceMappingURL=chainManifest.d.ts.map

package/dist/neutral/staticRest/layout/chainManifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chainManifest.d.ts","sourceRoot":"","sources":["../../../../src/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"}

package/dist/neutral/staticRest/layout/index.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/staticRest/layout/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA"}

package/dist/neutral/staticRest/layout/indexManifest.d.ts

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

package/dist/neutral/staticRest/layout/indexManifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexManifest.d.ts","sourceRoot":"","sources":["../../../../src/staticRest/layout/indexManifest.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AACvF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,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,SAA2B,GAAG,SAAS,CAS1G"}

package/dist/neutral/staticRest/paths/chainState.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Path builders for the chain-state (mutable) bucket.
+ *
+ * Paths are relative — no leading slash — and joined to a base URL by the consumer.
+ */
+/** The mutable head pointer: the current head SignedHydratedBlockWithHashMeta. */
+export declare const headPath: () => string;
+//# sourceMappingURL=chainState.d.ts.map

package/dist/neutral/staticRest/paths/chainState.d.ts.map

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

package/dist/neutral/staticRest/paths/finalized.d.ts

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

package/dist/neutral/staticRest/paths/finalized.d.ts.map

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

package/dist/neutral/staticRest/paths/index.d.ts

@@ -0,0 +1,4 @@
+export * from './chainState.ts';
+export * from './finalized.ts';
+export * from './indexPaths.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/staticRest/paths/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA"}

package/dist/neutral/staticRest/paths/indexPaths.d.ts

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

package/dist/neutral/staticRest/paths/indexPaths.d.ts.map

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

package/dist/neutral/staticRest/templates.d.ts

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

package/dist/neutral/staticRest/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../../src/staticRest/templates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAA;AAgBvE;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,MAAM,CAS/F;AAED,6FAA6F;AAC7F,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,MAAM,CAMzG;AAED,sDAAsD;AACtD,eAAO,MAAM,uBAAuB,QAAO,MACwE,CAAA;AAEnH,oDAAoD;AACpD,eAAO,MAAM,qBAAqB,QAAO,MAC6D,CAAA;AAEtG,kDAAkD;AAClD,eAAO,MAAM,mBAAmB,QAAO,MAC6D,CAAA;AAEpG,iGAAiG;AACjG,wBAAgB,0BAA0B,IAAI;IAC5C,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,MAAM,CAAA;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB,CAOA;AAED,iGAAiG;AACjG,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAM3E"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xyo-network/xl1-network-model",
-  "version": "2.1.9",
+  "version": "2.2.0",
   "description": "XYO Layer One API",
   "homepage": "https://xylabs.com",
   "bugs": {
@@ -43,7 +43,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@xyo-network/xl1-protocol-lib": "~2.1.9"
+    "@xyo-network/xl1-protocol-lib": "~2.2.0"
   },
   "devDependencies": {
     "@bitauth/libauth": "~3.0.0",
@@ -58,7 +58,6 @@
     "@xylabs/threads": "^6.1.3",
     "@xylabs/toolchain": "~8.1.21",
     "@xylabs/tsconfig": "~8.1.21",
-    "@xyo-network/address": "^6.1.1",
     "@xyo-network/sdk-js": "^6.1.0",
     "@xyo-network/sdk-protocol-js": "~6.1.1",
     "ajv": "^8.20.0",
@@ -88,7 +87,6 @@
     "@xylabs/geo": "^6.0",
     "@xylabs/sdk-js": "^6.0",
     "@xylabs/threads": "^6.1",
-    "@xyo-network/address": "^6.0",
     "@xyo-network/sdk-js": "^6.0",
     "@xyo-network/sdk-protocol-js": "~6.1",
     "ajv": "^8.20",