@xyo-network/xl1-protocol-sdk 3.1.3 → 4.0.0

package/dist/neutral/getFileConfig.d.ts

@@ -4,12 +4,12 @@
  */
 export declare function getFileConfig(searchPlaces?: string[]): Promise<{
     chain: {
-        id?: import("@xylabs/sdk-js").BrandedHex | undefined;
+        id?: import("@xylabs/sdk").BrandedHex | undefined;
         genesisRewardAddress?: (Lowercase<string> & {
             readonly __hex: true;
         } & {
             readonly __address: true;
-        }) | import("@xyo-network/sdk-protocol-js").XyoQuantAddress | undefined;
+        }) | import("@xyo-network/sdk-protocol").XyoQuantAddress | undefined;
     };
     log: {
         logLevel: "error" | "warn" | "info" | "log" | "debug" | "trace";
@@ -74,7 +74,7 @@ export declare function getFileConfig(searchPlaces?: string[]): Promise<{
     validation: {
         signerAuthorizations: ({
             type: "completedStepReward";
-            signers: (import("@xyo-network/sdk-protocol-js").XyoQuantAddress | (Lowercase<string> & {
+            signers: (import("@xyo-network/sdk-protocol").XyoQuantAddress | (Lowercase<string> & {
                 readonly __hex: true;
             } & {
                 readonly __address: true;
@@ -82,7 +82,7 @@ export declare function getFileConfig(searchPlaces?: string[]): Promise<{
         } | {
             type: "derivedReceive";
             scope: string;
-            signers: (import("@xyo-network/sdk-protocol-js").XyoQuantAddress | (Lowercase<string> & {
+            signers: (import("@xyo-network/sdk-protocol").XyoQuantAddress | (Lowercase<string> & {
                 readonly __hex: true;
             } & {
                 readonly __address: true;
@@ -94,12 +94,12 @@ export declare function getFileConfig(searchPlaces?: string[]): Promise<{
     actors: {
         [x: string]: unknown;
         chain: {
-            id?: import("@xylabs/sdk-js").BrandedHex | undefined;
+            id?: import("@xylabs/sdk").BrandedHex | undefined;
             genesisRewardAddress?: (Lowercase<string> & {
                 readonly __hex: true;
             } & {
                 readonly __address: true;
-            }) | import("@xyo-network/sdk-protocol-js").XyoQuantAddress | undefined;
+            }) | import("@xyo-network/sdk-protocol").XyoQuantAddress | undefined;
         };
         log: {
             logLevel: "error" | "warn" | "info" | "log" | "debug" | "trace";
@@ -164,7 +164,7 @@ export declare function getFileConfig(searchPlaces?: string[]): Promise<{
         validation: {
             signerAuthorizations: ({
                 type: "completedStepReward";
-                signers: (import("@xyo-network/sdk-protocol-js").XyoQuantAddress | (Lowercase<string> & {
+                signers: (import("@xyo-network/sdk-protocol").XyoQuantAddress | (Lowercase<string> & {
                     readonly __hex: true;
                 } & {
                     readonly __address: true;
@@ -172,7 +172,7 @@ export declare function getFileConfig(searchPlaces?: string[]): Promise<{
             } | {
                 type: "derivedReceive";
                 scope: string;
-                signers: (import("@xyo-network/sdk-protocol-js").XyoQuantAddress | (Lowercase<string> & {
+                signers: (import("@xyo-network/sdk-protocol").XyoQuantAddress | (Lowercase<string> & {
                     readonly __hex: true;
                 } & {
                     readonly __address: true;

package/dist/neutral/getFileConfig.mjs

@@ -1,5 +1,5 @@
 // src/getFileConfig.ts
-import { isDefined, isNull } from "@xylabs/sdk-js";
+import { isDefined, isNull } from "@xylabs/sdk";
 import { cosmiconfig } from "cosmiconfig";
 import { z as z15 } from "zod/mini";
 
@@ -8,14 +8,14 @@ import {
   zodAsFactory as zodAsFactory2,
   zodIsFactory as zodIsFactory2,
   zodToFactory as zodToFactory2
-} from "@xylabs/sdk-js";
+} from "@xylabs/sdk";
 import { globalRegistry as globalRegistry8, z as z12 } from "zod/mini";
 
 // src/config/Base.ts
 import { z as z11 } from "zod/mini";
 
 // src/config/Chain.ts
-import { HexZod } from "@xylabs/sdk-js";
+import { HexZod } from "@xylabs/sdk";
 import { XyoAddressZod } from "@xyo-network/sdk-js";
 import { globalRegistry, z } from "zod/mini";
 var ChainConfigZod = z.object({
@@ -167,7 +167,7 @@ var ConnectionConfigZod = z4.discriminatedUnion("type", [
 var ConnectionsConfigZod = z4.record(z4.string(), ConnectionConfigZod).default({});
 
 // src/config/Log.ts
-import { LogLevel } from "@xylabs/sdk-js";
+import { LogLevel } from "@xylabs/sdk";
 import { globalRegistry as globalRegistry4, z as z5 } from "zod";
 var LogLevelNames = Object.keys(LogLevel);
 var LogConfigZod = z5.object({
@@ -205,7 +205,7 @@ import {
   zodAsFactory,
   zodIsFactory,
   zodToFactory
-} from "@xylabs/sdk-js";
+} from "@xylabs/sdk";
 import { z as z7 } from "zod";
 var ProviderConfigZod = z7.object({
   moniker: z7.string(),

package/dist/neutral/getFileConfig.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/getFileConfig.ts", "../../src/config/Actor.ts", "../../src/config/Base.ts", "../../src/config/Chain.ts", "../../src/config/connections/Connection.ts", "../../src/config/connections/Mongo.ts", "../../src/config/connections/S3.ts", "../../src/config/Log.ts", "../../src/config/ProviderBinding.ts", "../../src/config/Providers.ts", "../../src/config/Provider.ts", "../../src/config/Telemetry.ts", "../../src/config/Validation.ts", "../../src/primitives/uncle/findBestUncle.ts", "../../src/config/Actors.ts", "../../src/config/Config.ts"],
-  "sourcesContent": ["import { isDefined, isNull } from '@xylabs/sdk-js'\nimport { cosmiconfig } from 'cosmiconfig'\nimport { z } from 'zod/mini'\n\nimport { ConfigZod } from './config/index.ts'\n\n/**\n * The name of the configuration file to search for.\n */\nconst configName = 'xyo'\n\n/**\n * The name of the section within the configuration file to parse.\n */\nconst configSection = 'xl1' // Default section in the config file\n\n/**\n * Attempts to parse the configuration from a file using cosmiconfig.\n * @returns The parsed configuration object if found and valid, otherwise undefined.\n */\nexport async function getFileConfig(searchPlaces?: string[]) {\n  const explorer = cosmiconfig(\n    configName,\n    {\n      cache: true,\n      searchPlaces,\n    },\n  )\n  const searchResult = await explorer.search()\n  const result: unknown = searchResult?.config\n  if (!isNull(result)) {\n    const section = (result as Record<string, unknown>)[configSection]\n    if (isDefined(section) && typeof section === 'object') {\n      return z.looseObject(ConfigZod.shape).parse(section)\n    }\n  }\n  return ConfigZod.parse({})\n}\n", "import {\n  zodAsFactory, zodIsFactory, zodToFactory,\n} from '@xylabs/sdk-js'\nimport { globalRegistry, z } from 'zod/mini'\n\nimport { BaseConfigZod } from './Base.ts'\n\n/**\n * BIP-32 derivation path for an actor wallet.\n *\n * - Absolute form: starts with `m/` (e.g. `m/44'/60'/0'/0/0`). The full path is used as-is,\n *   giving the caller complete control over coin type, account, and hardening.\n * - Relative form: a segment list without the `m/` prefix (e.g. `0`, `0/1`, `44'/60'/0'/0/0`).\n *   The consumer appends this to its configured root base path.\n *\n * Each segment is a non-negative integer, optionally suffixed with `'` to mark it as hardened.\n */\nexport const AccountPathZod = z.string().check(z.regex(\n  /^(m(\\/\\d+'?)+|\\d+'?(\\/\\d+'?)*)$/,\n  'Invalid BIP-32 derivation path. Use either an absolute path like \"m/44\\'/60\\'/0\\'/0/0\" or a relative path like \"0\", \"0/1\", or \"44\\'/60\\'/0\\'/0/0\".',\n))\n\n/** ActorConfigZod constant. */\nexport const ActorConfigZod = z.extend(BaseConfigZod, {\n  name: z.string(),\n  accountPath: z.optional(AccountPathZod).register(globalRegistry, {\n    description: 'BIP-32 derivation path for the actor wallet. Absolute when it starts with \"m/\"; otherwise relative to the root wallet base path. Each actor must derive to a distinct path.',\n    title: 'accountPath',\n    type: 'string',\n  }),\n})\n\n/** ActorConfig type. */\nexport type ActorConfig = z.infer<typeof ActorConfigZod>\n\n/** Type guard that checks if a value is a valid ActorConfig. */\nexport const isActorConfig = zodIsFactory(ActorConfigZod)\n/** Converts a value to ActorConfig, throwing if invalid. */\nexport const asActorConfig = zodAsFactory(ActorConfigZod, 'asActorConfig')\n/** toActorConfig constant. */\nexport const toActorConfig = zodToFactory(ActorConfigZod, 'toActorConfig')\n", "import { z } from 'zod/mini'\n\nimport { ChainConfigZod } from './Chain.ts'\nimport { ConnectionsConfigZod } from './connections/index.ts'\nimport { LogConfigZod } from './Log.ts'\nimport { ProviderBindingsConfigZod } from './ProviderBinding.ts'\nimport { ProvidersConfigZod } from './Providers.ts'\nimport { TelemetryConfigZod } from './Telemetry.ts'\nimport { ValidationConfigZod } from './Validation.ts'\n\n/** BaseConfigZod constant. */\nexport const BaseConfigZod = z.object({\n  chain: z._default(ChainConfigZod, ChainConfigZod.parse({})).check(z.describe('Configuration for the chain')),\n  log: z._default(LogConfigZod, LogConfigZod.parse({})).check(z.describe('Configuration for logging')),\n  connections: z._default(ConnectionsConfigZod, ConnectionsConfigZod.parse({})).check(z.describe('Named connection profiles (rpc, rest, s3, lmdb, mongo, evm-rpc)')),\n  providerBindings: z._default(ProviderBindingsConfigZod, ProviderBindingsConfigZod.parse({})).check(z.describe('Per-moniker provider connection bindings')),\n  providers: z._default(ProvidersConfigZod, ProvidersConfigZod.parse([])).check(z.describe('Configuration for providers')),\n  telemetry: z._default(TelemetryConfigZod, TelemetryConfigZod.parse({})).check(z.describe('Configuration for telemetry')),\n  validation: z._default(ValidationConfigZod, ValidationConfigZod.parse({})).check(z.describe('Configuration for validation')),\n})\n\n/** BaseConfig type. */\nexport type BaseConfig = z.infer<typeof BaseConfigZod>\n", "import { HexZod } from '@xylabs/sdk-js'\nimport { XyoAddressZod } from '@xyo-network/sdk-js'\nimport { globalRegistry, z } from 'zod/mini'\n\n/** ChainConfigZod constant. */\nexport const ChainConfigZod = z.object({\n  id: z.optional(HexZod)\n    .register(globalRegistry, {\n      description:\n      'The unique identifier for the chain. Should be the staking contract address for contract-backed chains.',\n      title: 'chain.id',\n      type: 'string',\n    }),\n  genesisRewardAddress: z.optional(XyoAddressZod)\n    .register(globalRegistry, {\n      description:\n      'Address to send the initial genesis rewards to, if a new chain is being created.',\n      title: 'chain.genesisRewardAddress',\n      type: 'Address',\n    }),\n})\n\n/** ChainConfig type. */\nexport type ChainConfig = z.infer<typeof ChainConfigZod>\n", "import { globalRegistry, z } from 'zod'\n\nimport { MongoConfigZod } from './Mongo.ts'\nimport { S3BucketConfigZod } from './S3.ts'\n\n/** Named LMDB backing-store connection. */\nexport const LmdbConnectionConfigZod = z.object({\n  access: z.enum(['read', 'write']).optional().register(globalRegistry, {\n    description: 'Access mode for this LMDB connection (read or write)',\n    title: 'connections.lmdb.access',\n    type: 'string',\n  }),\n  root: z.string().register(globalRegistry, {\n    description: 'Root directory for local LMDB storage',\n    title: 'connections.lmdb.root',\n    type: 'string',\n  }),\n  store: z.string().optional().register(globalRegistry, {\n    description: 'Logical store name within the LMDB root (e.g. finalized-chain, mempool)',\n    title: 'connections.lmdb.store',\n    type: 'string',\n  }),\n  type: z.literal('lmdb'),\n}).describe('LMDB local storage connection')\n\n/** MongoDB backing-store connection. */\nexport const MongoConnectionConfigZod = z.object({\n  type: z.literal('mongo'),\n  connectionString: MongoConfigZod.shape.connectionString,\n  database: MongoConfigZod.shape.database,\n  domain: MongoConfigZod.shape.domain,\n  password: MongoConfigZod.shape.password,\n  username: MongoConfigZod.shape.username,\n}).describe('MongoDB storage connection')\n\n/** JSON-RPC wire connection (HTTP or postMessage). */\nexport const RpcConnectionConfigZod = z.object({\n  type: z.literal('rpc'),\n  protocol: z.string().default('http').register(globalRegistry, {\n    description: 'Protocol for the RPC connection (http or postMessage)',\n    title: 'connections.rpc.protocol',\n    type: 'string',\n  }),\n  url: z.string().optional().register(globalRegistry, {\n    description: 'URL for the Chain RPC API (http protocol)',\n    title: 'connections.rpc.url',\n    type: 'string',\n  }),\n  networkId: z.string().optional().register(globalRegistry, {\n    description: 'Network ID for the postMessage RPC connection',\n    title: 'connections.rpc.networkId',\n    type: 'string',\n  }),\n  sessionId: z.string().optional().register(globalRegistry, {\n    description: 'Session ID for the postMessage RPC connection',\n    title: 'connections.rpc.sessionId',\n    type: 'string',\n  }),\n}).describe('XL1 JSON-RPC connection')\n\n/** HTTP REST read connection (CDN / public read base URL). */\nexport const RestConnectionConfigZod = z.object({\n  type: z.literal('rest'),\n  baseUrl: z.string().register(globalRegistry, {\n    description: 'HTTP base URL for REST reads',\n    title: 'connections.rest.baseUrl',\n    type: 'string',\n  }),\n}).describe('HTTP REST read connection')\n\n/** S3-compatible object storage connection (API + optional public read URL). */\nexport const S3ConnectionConfigZod = S3BucketConfigZod.extend({\n  type: z.literal('s3'),\n  accessKeyId: z.string().optional(),\n  accountId: z.string().optional(),\n  secretAccessKey: z.string().optional(),\n}).describe('S3-compatible object storage connection')\n\n/** EVM JSON-RPC connection. */\nexport const EvmRpcConnectionConfigZod = z.object({\n  type: z.literal('evm-rpc'),\n  url: z.string().register(globalRegistry, {\n    description: 'EVM JSON-RPC URL',\n    title: 'connections.evm-rpc.url',\n    type: 'string',\n  }),\n  chainId: z.string().optional().register(globalRegistry, {\n    description: 'EVM chain ID for this RPC endpoint; auto-detected from the endpoint when omitted',\n    title: 'connections.evm-rpc.chainId',\n    type: 'string',\n  }),\n}).describe('EVM JSON-RPC connection')\n\n/** In-process shared-memory connection (ephemeral; backed by a MemoryArchivist). */\nexport const MemoryConnectionConfigZod = z.object({ type: z.literal('memory') }).describe('In-process memory connection')\n\n/** Discriminated union of all supported connection kinds. */\nexport const ConnectionConfigZod = z.discriminatedUnion('type', [\n  LmdbConnectionConfigZod,\n  MongoConnectionConfigZod,\n  RpcConnectionConfigZod,\n  RestConnectionConfigZod,\n  S3ConnectionConfigZod,\n  EvmRpcConnectionConfigZod,\n  MemoryConnectionConfigZod,\n])\n\nexport type LmdbConnectionConfig = z.infer<typeof LmdbConnectionConfigZod>\nexport type MongoConnectionConfig = z.infer<typeof MongoConnectionConfigZod>\nexport type RpcConnectionConfig = z.infer<typeof RpcConnectionConfigZod>\nexport type RestConnectionConfig = z.infer<typeof RestConnectionConfigZod>\nexport type S3ConnectionConfig = z.infer<typeof S3ConnectionConfigZod>\nexport type EvmRpcConnectionConfig = z.infer<typeof EvmRpcConnectionConfigZod>\nexport type MemoryConnectionConfig = z.infer<typeof MemoryConnectionConfigZod>\nexport type ConnectionConfig = z.infer<typeof ConnectionConfigZod>\n\n/** Map of connection name \u2192 connection configuration. */\nexport const ConnectionsConfigZod = z.record(z.string(), ConnectionConfigZod).default({})\n\nexport type ConnectionsConfig = z.infer<typeof ConnectionsConfigZod>\n\nexport type ConnectionKind = ConnectionConfig['type']\n", "import { globalRegistry, z } from 'zod'\n\n/** MongoConfigZod constant. */\nexport const MongoConfigZod = z.object({\n  // TODO: Create from other arguments\n  connectionString: z.string().nonempty().optional().register(globalRegistry, {\n    description: 'MongoDB connection string',\n    title: 'storage.mongo.connectionString',\n    type: 'string',\n  }),\n  database: z.string().nonempty().optional().register(globalRegistry, {\n    description: 'MongoDB database name',\n    title: 'storage.mongo.database',\n    type: 'string',\n  }),\n  domain: z.string().nonempty().optional().register(globalRegistry, {\n    description: 'MongoDB domain',\n    title: 'storage.mongo.domain',\n    type: 'string',\n  }),\n  password: z.string().nonempty().optional().register(globalRegistry, {\n    description: 'MongoDB password',\n    title: 'storage.mongo.password',\n    type: 'string',\n  }),\n  username: z.string().nonempty().optional().register(globalRegistry, {\n    description: 'MongoDB username',\n    title: 'storage.mongo.username',\n    type: 'string',\n  }),\n})\n\n/** MongoConfig type. */\nexport type MongoConfig = z.infer<typeof MongoConfigZod>\n", "import { z } from 'zod'\n\n/**\n * Per-bucket S3 configuration: the bucket name, an optional public read URL (CDN), and optional\n * credential/prefix overrides. Any omitted credential or prefix falls back to the shared top-level\n * S3 config; an omitted bucket name falls back to the finalized bucket.\n *\n * \"S3\" is the S3-compatible object-storage protocol; Cloudflare R2 is one such implementation.\n */\nexport const S3BucketConfigZod = z.object({\n  accessKeyId: z.string().nonempty().optional().describe('S3-compatible access key id for this bucket (overrides the shared default)'),\n  accountId: z.string().nonempty().optional().describe('Account id for this bucket; on Cloudflare R2 it forms the endpoint (overrides the shared default)'),\n  bucket: z.string().nonempty().optional().describe('S3-compatible bucket name'),\n  endpoint: z.string().nonempty().optional().describe('S3-compatible API endpoint for reads and writes; when omitted, derived from accountId as a Cloudflare R2 endpoint'),\n  prefix: z.string().nonempty().optional().describe('Optional key prefix within the bucket'),\n  readUrl: z.string().nonempty().optional().describe('Public HTTP/CDN base URL for anonymous reads of this bucket'),\n  secretAccessKey: z.string().nonempty().optional().describe('S3-compatible secret access key for this bucket (overrides the shared default)'),\n})\n\n/** S3BucketConfig type. */\nexport type S3BucketConfig = z.infer<typeof S3BucketConfigZod>\n", "import type { LogLevelKey } from '@xylabs/sdk-js'\nimport { LogLevel } from '@xylabs/sdk-js'\nimport { globalRegistry, z } from 'zod'\n\nconst LogLevelNames = Object.keys(LogLevel) as [LogLevelKey]\n\n/** LogConfigZod constant. */\nexport const LogConfigZod = z.object({\n  logLevel: z.enum(LogLevelNames).default('info').register(globalRegistry, {\n    choices: LogLevelNames,\n    default: 'info',\n    description: 'Desired process verbosity',\n    title: 'logLevel',\n    type: 'string',\n  }),\n  silent: z.boolean().default(false).register(globalRegistry, {\n    default: false,\n    description: 'Whether to run in silent mode',\n    title: 'silent',\n    type: 'boolean',\n  }),\n})\n\n/** LogConfig type. */\nexport type LogConfig = z.infer<typeof LogConfigZod>\n", "import { globalRegistry, z } from 'zod'\n\n/**\n * Binds a capability moniker to a named connection profile.\n * Keys in `providerBindings` use the provider moniker (e.g. `BlockViewer`).\n */\nexport const ProviderBindingConfigZod = z.object({\n  connection: z.string().optional().register(globalRegistry, {\n    description: 'Named connection from the top-level connections map',\n    title: 'providerBindings.connection',\n    type: 'string',\n  }),\n}).describe('Provider connection binding')\n\nexport type ProviderBindingConfig = z.infer<typeof ProviderBindingConfigZod>\n\n/** Map of provider moniker \u2192 binding. */\nexport const ProviderBindingsConfigZod = z.record(z.string(), ProviderBindingConfigZod).default({})\n\nexport type ProviderBindingsConfig = z.infer<typeof ProviderBindingsConfigZod>\n", "import z from 'zod'\n\nimport { ProviderConfigZod } from './Provider.ts'\n\n/** ProvidersConfigZod constant. */\nexport const ProvidersConfigZod = z.array(ProviderConfigZod.loose()).describe('Configuration for providers').default([])\n\n/** ProvidersConfig type. */\nexport type ProvidersConfig = z.infer<typeof ProvidersConfigZod>\n", "import {\n  zodAsFactory, zodIsFactory, zodToFactory,\n} from '@xylabs/sdk-js'\nimport { z } from 'zod'\n\n/** ProviderConfigZod constant. */\nexport const ProviderConfigZod = z.object({\n  moniker: z.string(),\n  labels: z.array(z.string()).optional(),\n}).describe('Configuration for a Provider')\n\n/** ProviderConfig type. */\nexport type ProviderConfig = z.infer<typeof ProviderConfigZod>\n\n/** Type guard that checks if a value is a valid ProviderConfig. */\nexport const isProviderConfig = zodIsFactory(ProviderConfigZod)\n/** Converts a value to ProviderConfig, throwing if invalid. */\nexport const asProviderConfig = zodAsFactory(ProviderConfigZod, 'asProviderConfig')\n/** toProviderConfig constant. */\nexport const toProviderConfig = zodToFactory(ProviderConfigZod, 'toProviderConfig')\n", "import { globalRegistry, z } from 'zod'\n\n/** DefaultMetricsScrapePorts constant. */\nexport const DefaultMetricsScrapePorts = {\n  api: 9465,\n  bridge: 9468,\n  mempool: 9466,\n  producer: 9464,\n  rewardRedemptionApi: 9467,\n}\n\n/** MetricsScrapeConfigZod constant. */\nexport const MetricsScrapeConfigZod = z.object({\n  path: z.string().default('/metrics').register(globalRegistry, {\n    default: '/metrics',\n    description: 'Path for the metrics scrape endpoint',\n    title: 'telemetry.metrics.scrape.path',\n    type: 'string',\n  }),\n  port: z.coerce.number().int().nonnegative().optional().register(globalRegistry, {\n    description: 'Port for the metrics scrape endpoint (0 disables the scrape endpoint)',\n    title: 'telemetry.metrics.scrape.port',\n    type: 'number',\n  }),\n}).describe('Metrics scrape configuration')\n\n/** MetricsConfigZod constant. */\nexport const MetricsConfigZod = z.object({ scrape: MetricsScrapeConfigZod }).describe('Metrics configuration options')\n\n/** OpenTelemetryConfigZod constant. */\nexport const OpenTelemetryConfigZod = z.object({\n  // OpenTelemetry options\n  otlpEndpoint: z.url().optional().register(globalRegistry, {\n    description: 'OTLP endpoint for exporting telemetry data',\n    title: 'telemetry.otel.otlpEndpoint',\n    type: 'string',\n  }),\n})\n\n/** TelemetryConfigZod constant. */\nexport const TelemetryConfigZod = z.object({\n  // Metrics configuration\n  metrics: MetricsConfigZod.optional().describe('Metrics configuration'),\n  // OpenTelemetry configuration\n  otel: OpenTelemetryConfigZod.optional().describe('OpenTelemetry configuration'),\n}).describe('Telemetry configuration options')\n\n/** TelemetryConfig type. */\nexport type TelemetryConfig = z.infer<typeof TelemetryConfigZod>\n", "import { SignerAuthorizationZod } from '@xyo-network/xl1-validation'\nimport { globalRegistry, z } from 'zod'\n\nimport { DEFAULT_BACKOFF_MS, DEFAULT_MIN_CANDIDATES } from '../primitives/index.ts'\n\n/** ValidationConfigZod constant. */\nexport const ValidationConfigZod = z.object({\n  signerAuthorizations: z.array(SignerAuthorizationZod).default([]).register(globalRegistry, {\n    description: 'Authorizations granting signers the right to sign for addresses derived by a given function (e.g. completed-step-reward, derived-receive). Empty = self-transfers only.',\n    title: 'validation.signerAuthorizations',\n    type: 'array',\n  }),\n  minCandidates: z.coerce.number().default(DEFAULT_MIN_CANDIDATES).register(globalRegistry, {\n    default: DEFAULT_MIN_CANDIDATES,\n    description: 'Minimum number of uncle candidates before selecting the best uncle',\n    title: 'validation.minCandidates',\n    type: 'number',\n  }),\n  backoffMs: z.coerce.number().default(DEFAULT_BACKOFF_MS).register(globalRegistry, {\n    default: DEFAULT_BACKOFF_MS,\n    description: 'Back-off timeout in ms. If head age exceeds this, minCandidates is ignored',\n    title: 'validation.backoffMs',\n    type: 'number',\n  }),\n})\n\n/** ValidationConfig type. */\nexport type ValidationConfig = z.infer<typeof ValidationConfigZod>\n", "import type { SignedHydratedBlockWithHashMeta } from '@xyo-network/xl1-protocol-lib'\n\nimport { scoreUncle } from './scoreUncle.ts'\n\n/** Default minimum number of uncle candidates before selecting. */\nexport const DEFAULT_MIN_CANDIDATES = 1\n\n/** Default back-off timeout in milliseconds. If the head has not changed for this long, minCandidates is ignored. */\nexport const DEFAULT_BACKOFF_MS = 120_000\n\n/** Options for findBestUncle block selection. */\nexport interface FindBestUncleOptions {\n  /** Back-off timeout in ms. If head age exceeds this, minCandidates is ignored. Default: 120_000. */\n  backoffMs?: number\n  /** Minimum number of uncle candidates before selecting. Default: 1. */\n  minCandidates?: number\n  /** Current timestamp in ms. Injectable for testing. Default: Date.now(). */\n  now?: number\n}\n\n/** Selects the best uncle chain from candidates using Proof of Perfect scoring. */\nexport function findBestUncle(\n  finalizedWindowedChain: SignedHydratedBlockWithHashMeta[],\n  uncles: SignedHydratedBlockWithHashMeta[][],\n  options?: FindBestUncleOptions,\n): SignedHydratedBlockWithHashMeta[] | undefined {\n  if (uncles.length === 0) return undefined\n\n  const minCandidates = options?.minCandidates ?? DEFAULT_MIN_CANDIDATES\n  const backoffMs = options?.backoffMs ?? DEFAULT_BACKOFF_MS\n  const now = options?.now ?? Date.now()\n\n  if (uncles.length < minCandidates) {\n    const headEpoch = finalizedWindowedChain.at(-1)?.[0].$epoch ?? 0\n    const headAge = now - headEpoch\n    if (headAge < backoffMs) {\n      return undefined\n    }\n  }\n\n  const scores = uncles.map(uncle => ([scoreUncle(finalizedWindowedChain, uncle), uncle] as const)).toSorted((a, b) => b[0] - a[0])\n  return scores[0]?.[1]\n}\n", "import { z } from 'zod/mini'\n\nimport { ActorConfigZod } from './Actor.ts'\n\n/** ActorsConfigZod constant. */\nexport const ActorsConfigZod = z._default(\n  z.array(z.looseObject(ActorConfigZod.shape)).check(z.describe('Actor-specific configurations that override the base configuration when the actor is running')),\n  [],\n)\n\n/** ActorsConfig type. */\nexport type ActorsConfig = z.infer<typeof ActorsConfigZod>\n", "import { globalRegistry, z } from 'zod/mini'\n\nimport { ActorConfigZod } from './Actor.ts'\nimport { ActorsConfigZod } from './Actors.ts'\nimport { BaseConfigZod } from './Base.ts'\nimport type { DeepPartial } from './DeepPartial.ts'\n\n/** ConfigZod constant. */\nexport const ConfigZod = z.extend(BaseConfigZod, {\n  actors: ActorsConfigZod,\n  healthCheckPort: z.optional(z.coerce.number()).register(globalRegistry, {\n    description: 'Port for the system-wide health, readiness, and liveness endpoints (/healthz, /livez, /readyz). Set to 0 to disable.',\n    title: 'healthCheckPort',\n    type: 'number',\n  }),\n}).check(z.describe('The complete configuration for the protocol, including global settings and actor-specific overrides'))\n\n/** Config type. */\nexport type Config = z.infer<typeof ConfigZod>\n\n/** ResolveConfig helper function. */\nexport function resolveConfig(\n  config: DeepPartial<Config>,\n) {\n  const parsedConfig = ConfigZod.parse(config)\n  const {\n    actors, healthCheckPort: _healthCheckPort, ...rootConfig\n  } = parsedConfig\n  parsedConfig.actors = actors.map((actorConfig: z.infer<typeof ActorConfigZod>) => {\n    return z.looseObject(ActorConfigZod.shape).parse({ ...rootConfig, ...actorConfig })\n  })\n  return parsedConfig\n}\n"],
+  "sourcesContent": ["import { isDefined, isNull } from '@xylabs/sdk'\nimport { cosmiconfig } from 'cosmiconfig'\nimport { z } from 'zod/mini'\n\nimport { ConfigZod } from './config/index.ts'\n\n/**\n * The name of the configuration file to search for.\n */\nconst configName = 'xyo'\n\n/**\n * The name of the section within the configuration file to parse.\n */\nconst configSection = 'xl1' // Default section in the config file\n\n/**\n * Attempts to parse the configuration from a file using cosmiconfig.\n * @returns The parsed configuration object if found and valid, otherwise undefined.\n */\nexport async function getFileConfig(searchPlaces?: string[]) {\n  const explorer = cosmiconfig(\n    configName,\n    {\n      cache: true,\n      searchPlaces,\n    },\n  )\n  const searchResult = await explorer.search()\n  const result: unknown = searchResult?.config\n  if (!isNull(result)) {\n    const section = (result as Record<string, unknown>)[configSection]\n    if (isDefined(section) && typeof section === 'object') {\n      return z.looseObject(ConfigZod.shape).parse(section)\n    }\n  }\n  return ConfigZod.parse({})\n}\n", "import {\n  zodAsFactory, zodIsFactory, zodToFactory,\n} from '@xylabs/sdk'\nimport { globalRegistry, z } from 'zod/mini'\n\nimport { BaseConfigZod } from './Base.ts'\n\n/**\n * BIP-32 derivation path for an actor wallet.\n *\n * - Absolute form: starts with `m/` (e.g. `m/44'/60'/0'/0/0`). The full path is used as-is,\n *   giving the caller complete control over coin type, account, and hardening.\n * - Relative form: a segment list without the `m/` prefix (e.g. `0`, `0/1`, `44'/60'/0'/0/0`).\n *   The consumer appends this to its configured root base path.\n *\n * Each segment is a non-negative integer, optionally suffixed with `'` to mark it as hardened.\n */\nexport const AccountPathZod = z.string().check(z.regex(\n  /^(m(\\/\\d+'?)+|\\d+'?(\\/\\d+'?)*)$/,\n  'Invalid BIP-32 derivation path. Use either an absolute path like \"m/44\\'/60\\'/0\\'/0/0\" or a relative path like \"0\", \"0/1\", or \"44\\'/60\\'/0\\'/0/0\".',\n))\n\n/** ActorConfigZod constant. */\nexport const ActorConfigZod = z.extend(BaseConfigZod, {\n  name: z.string(),\n  accountPath: z.optional(AccountPathZod).register(globalRegistry, {\n    description: 'BIP-32 derivation path for the actor wallet. Absolute when it starts with \"m/\"; otherwise relative to the root wallet base path. Each actor must derive to a distinct path.',\n    title: 'accountPath',\n    type: 'string',\n  }),\n})\n\n/** ActorConfig type. */\nexport type ActorConfig = z.infer<typeof ActorConfigZod>\n\n/** Type guard that checks if a value is a valid ActorConfig. */\nexport const isActorConfig = zodIsFactory(ActorConfigZod)\n/** Converts a value to ActorConfig, throwing if invalid. */\nexport const asActorConfig = zodAsFactory(ActorConfigZod, 'asActorConfig')\n/** toActorConfig constant. */\nexport const toActorConfig = zodToFactory(ActorConfigZod, 'toActorConfig')\n", "import { z } from 'zod/mini'\n\nimport { ChainConfigZod } from './Chain.ts'\nimport { ConnectionsConfigZod } from './connections/index.ts'\nimport { LogConfigZod } from './Log.ts'\nimport { ProviderBindingsConfigZod } from './ProviderBinding.ts'\nimport { ProvidersConfigZod } from './Providers.ts'\nimport { TelemetryConfigZod } from './Telemetry.ts'\nimport { ValidationConfigZod } from './Validation.ts'\n\n/** BaseConfigZod constant. */\nexport const BaseConfigZod = z.object({\n  chain: z._default(ChainConfigZod, ChainConfigZod.parse({})).check(z.describe('Configuration for the chain')),\n  log: z._default(LogConfigZod, LogConfigZod.parse({})).check(z.describe('Configuration for logging')),\n  connections: z._default(ConnectionsConfigZod, ConnectionsConfigZod.parse({})).check(z.describe('Named connection profiles (rpc, rest, s3, lmdb, mongo, evm-rpc)')),\n  providerBindings: z._default(ProviderBindingsConfigZod, ProviderBindingsConfigZod.parse({})).check(z.describe('Per-moniker provider connection bindings')),\n  providers: z._default(ProvidersConfigZod, ProvidersConfigZod.parse([])).check(z.describe('Configuration for providers')),\n  telemetry: z._default(TelemetryConfigZod, TelemetryConfigZod.parse({})).check(z.describe('Configuration for telemetry')),\n  validation: z._default(ValidationConfigZod, ValidationConfigZod.parse({})).check(z.describe('Configuration for validation')),\n})\n\n/** BaseConfig type. */\nexport type BaseConfig = z.infer<typeof BaseConfigZod>\n", "import { HexZod } from '@xylabs/sdk'\nimport { XyoAddressZod } from '@xyo-network/sdk-js'\nimport { globalRegistry, z } from 'zod/mini'\n\n/** ChainConfigZod constant. */\nexport const ChainConfigZod = z.object({\n  id: z.optional(HexZod)\n    .register(globalRegistry, {\n      description:\n      'The unique identifier for the chain. Should be the staking contract address for contract-backed chains.',\n      title: 'chain.id',\n      type: 'string',\n    }),\n  genesisRewardAddress: z.optional(XyoAddressZod)\n    .register(globalRegistry, {\n      description:\n      'Address to send the initial genesis rewards to, if a new chain is being created.',\n      title: 'chain.genesisRewardAddress',\n      type: 'Address',\n    }),\n})\n\n/** ChainConfig type. */\nexport type ChainConfig = z.infer<typeof ChainConfigZod>\n", "import { globalRegistry, z } from 'zod'\n\nimport { MongoConfigZod } from './Mongo.ts'\nimport { S3BucketConfigZod } from './S3.ts'\n\n/** Named LMDB backing-store connection. */\nexport const LmdbConnectionConfigZod = z.object({\n  access: z.enum(['read', 'write']).optional().register(globalRegistry, {\n    description: 'Access mode for this LMDB connection (read or write)',\n    title: 'connections.lmdb.access',\n    type: 'string',\n  }),\n  root: z.string().register(globalRegistry, {\n    description: 'Root directory for local LMDB storage',\n    title: 'connections.lmdb.root',\n    type: 'string',\n  }),\n  store: z.string().optional().register(globalRegistry, {\n    description: 'Logical store name within the LMDB root (e.g. finalized-chain, mempool)',\n    title: 'connections.lmdb.store',\n    type: 'string',\n  }),\n  type: z.literal('lmdb'),\n}).describe('LMDB local storage connection')\n\n/** MongoDB backing-store connection. */\nexport const MongoConnectionConfigZod = z.object({\n  type: z.literal('mongo'),\n  connectionString: MongoConfigZod.shape.connectionString,\n  database: MongoConfigZod.shape.database,\n  domain: MongoConfigZod.shape.domain,\n  password: MongoConfigZod.shape.password,\n  username: MongoConfigZod.shape.username,\n}).describe('MongoDB storage connection')\n\n/** JSON-RPC wire connection (HTTP or postMessage). */\nexport const RpcConnectionConfigZod = z.object({\n  type: z.literal('rpc'),\n  protocol: z.string().default('http').register(globalRegistry, {\n    description: 'Protocol for the RPC connection (http or postMessage)',\n    title: 'connections.rpc.protocol',\n    type: 'string',\n  }),\n  url: z.string().optional().register(globalRegistry, {\n    description: 'URL for the Chain RPC API (http protocol)',\n    title: 'connections.rpc.url',\n    type: 'string',\n  }),\n  networkId: z.string().optional().register(globalRegistry, {\n    description: 'Network ID for the postMessage RPC connection',\n    title: 'connections.rpc.networkId',\n    type: 'string',\n  }),\n  sessionId: z.string().optional().register(globalRegistry, {\n    description: 'Session ID for the postMessage RPC connection',\n    title: 'connections.rpc.sessionId',\n    type: 'string',\n  }),\n}).describe('XL1 JSON-RPC connection')\n\n/** HTTP REST read connection (CDN / public read base URL). */\nexport const RestConnectionConfigZod = z.object({\n  type: z.literal('rest'),\n  baseUrl: z.string().register(globalRegistry, {\n    description: 'HTTP base URL for REST reads',\n    title: 'connections.rest.baseUrl',\n    type: 'string',\n  }),\n}).describe('HTTP REST read connection')\n\n/** S3-compatible object storage connection (API + optional public read URL). */\nexport const S3ConnectionConfigZod = S3BucketConfigZod.extend({\n  type: z.literal('s3'),\n  accessKeyId: z.string().optional(),\n  accountId: z.string().optional(),\n  secretAccessKey: z.string().optional(),\n}).describe('S3-compatible object storage connection')\n\n/** EVM JSON-RPC connection. */\nexport const EvmRpcConnectionConfigZod = z.object({\n  type: z.literal('evm-rpc'),\n  url: z.string().register(globalRegistry, {\n    description: 'EVM JSON-RPC URL',\n    title: 'connections.evm-rpc.url',\n    type: 'string',\n  }),\n  chainId: z.string().optional().register(globalRegistry, {\n    description: 'EVM chain ID for this RPC endpoint; auto-detected from the endpoint when omitted',\n    title: 'connections.evm-rpc.chainId',\n    type: 'string',\n  }),\n}).describe('EVM JSON-RPC connection')\n\n/** In-process shared-memory connection (ephemeral; backed by a MemoryArchivist). */\nexport const MemoryConnectionConfigZod = z.object({ type: z.literal('memory') }).describe('In-process memory connection')\n\n/** Discriminated union of all supported connection kinds. */\nexport const ConnectionConfigZod = z.discriminatedUnion('type', [\n  LmdbConnectionConfigZod,\n  MongoConnectionConfigZod,\n  RpcConnectionConfigZod,\n  RestConnectionConfigZod,\n  S3ConnectionConfigZod,\n  EvmRpcConnectionConfigZod,\n  MemoryConnectionConfigZod,\n])\n\nexport type LmdbConnectionConfig = z.infer<typeof LmdbConnectionConfigZod>\nexport type MongoConnectionConfig = z.infer<typeof MongoConnectionConfigZod>\nexport type RpcConnectionConfig = z.infer<typeof RpcConnectionConfigZod>\nexport type RestConnectionConfig = z.infer<typeof RestConnectionConfigZod>\nexport type S3ConnectionConfig = z.infer<typeof S3ConnectionConfigZod>\nexport type EvmRpcConnectionConfig = z.infer<typeof EvmRpcConnectionConfigZod>\nexport type MemoryConnectionConfig = z.infer<typeof MemoryConnectionConfigZod>\nexport type ConnectionConfig = z.infer<typeof ConnectionConfigZod>\n\n/** Map of connection name \u2192 connection configuration. */\nexport const ConnectionsConfigZod = z.record(z.string(), ConnectionConfigZod).default({})\n\nexport type ConnectionsConfig = z.infer<typeof ConnectionsConfigZod>\n\nexport type ConnectionKind = ConnectionConfig['type']\n", "import { globalRegistry, z } from 'zod'\n\n/** MongoConfigZod constant. */\nexport const MongoConfigZod = z.object({\n  // TODO: Create from other arguments\n  connectionString: z.string().nonempty().optional().register(globalRegistry, {\n    description: 'MongoDB connection string',\n    title: 'storage.mongo.connectionString',\n    type: 'string',\n  }),\n  database: z.string().nonempty().optional().register(globalRegistry, {\n    description: 'MongoDB database name',\n    title: 'storage.mongo.database',\n    type: 'string',\n  }),\n  domain: z.string().nonempty().optional().register(globalRegistry, {\n    description: 'MongoDB domain',\n    title: 'storage.mongo.domain',\n    type: 'string',\n  }),\n  password: z.string().nonempty().optional().register(globalRegistry, {\n    description: 'MongoDB password',\n    title: 'storage.mongo.password',\n    type: 'string',\n  }),\n  username: z.string().nonempty().optional().register(globalRegistry, {\n    description: 'MongoDB username',\n    title: 'storage.mongo.username',\n    type: 'string',\n  }),\n})\n\n/** MongoConfig type. */\nexport type MongoConfig = z.infer<typeof MongoConfigZod>\n", "import { z } from 'zod'\n\n/**\n * Per-bucket S3 configuration: the bucket name, an optional public read URL (CDN), and optional\n * credential/prefix overrides. Any omitted credential or prefix falls back to the shared top-level\n * S3 config; an omitted bucket name falls back to the finalized bucket.\n *\n * \"S3\" is the S3-compatible object-storage protocol; Cloudflare R2 is one such implementation.\n */\nexport const S3BucketConfigZod = z.object({\n  accessKeyId: z.string().nonempty().optional().describe('S3-compatible access key id for this bucket (overrides the shared default)'),\n  accountId: z.string().nonempty().optional().describe('Account id for this bucket; on Cloudflare R2 it forms the endpoint (overrides the shared default)'),\n  bucket: z.string().nonempty().optional().describe('S3-compatible bucket name'),\n  endpoint: z.string().nonempty().optional().describe('S3-compatible API endpoint for reads and writes; when omitted, derived from accountId as a Cloudflare R2 endpoint'),\n  prefix: z.string().nonempty().optional().describe('Optional key prefix within the bucket'),\n  readUrl: z.string().nonempty().optional().describe('Public HTTP/CDN base URL for anonymous reads of this bucket'),\n  secretAccessKey: z.string().nonempty().optional().describe('S3-compatible secret access key for this bucket (overrides the shared default)'),\n})\n\n/** S3BucketConfig type. */\nexport type S3BucketConfig = z.infer<typeof S3BucketConfigZod>\n", "import type { LogLevelKey } from '@xylabs/sdk'\nimport { LogLevel } from '@xylabs/sdk'\nimport { globalRegistry, z } from 'zod'\n\nconst LogLevelNames = Object.keys(LogLevel) as [LogLevelKey]\n\n/** LogConfigZod constant. */\nexport const LogConfigZod = z.object({\n  logLevel: z.enum(LogLevelNames).default('info').register(globalRegistry, {\n    choices: LogLevelNames,\n    default: 'info',\n    description: 'Desired process verbosity',\n    title: 'logLevel',\n    type: 'string',\n  }),\n  silent: z.boolean().default(false).register(globalRegistry, {\n    default: false,\n    description: 'Whether to run in silent mode',\n    title: 'silent',\n    type: 'boolean',\n  }),\n})\n\n/** LogConfig type. */\nexport type LogConfig = z.infer<typeof LogConfigZod>\n", "import { globalRegistry, z } from 'zod'\n\n/**\n * Binds a capability moniker to a named connection profile.\n * Keys in `providerBindings` use the provider moniker (e.g. `BlockViewer`).\n */\nexport const ProviderBindingConfigZod = z.object({\n  connection: z.string().optional().register(globalRegistry, {\n    description: 'Named connection from the top-level connections map',\n    title: 'providerBindings.connection',\n    type: 'string',\n  }),\n}).describe('Provider connection binding')\n\nexport type ProviderBindingConfig = z.infer<typeof ProviderBindingConfigZod>\n\n/** Map of provider moniker \u2192 binding. */\nexport const ProviderBindingsConfigZod = z.record(z.string(), ProviderBindingConfigZod).default({})\n\nexport type ProviderBindingsConfig = z.infer<typeof ProviderBindingsConfigZod>\n", "import z from 'zod'\n\nimport { ProviderConfigZod } from './Provider.ts'\n\n/** ProvidersConfigZod constant. */\nexport const ProvidersConfigZod = z.array(ProviderConfigZod.loose()).describe('Configuration for providers').default([])\n\n/** ProvidersConfig type. */\nexport type ProvidersConfig = z.infer<typeof ProvidersConfigZod>\n", "import {\n  zodAsFactory, zodIsFactory, zodToFactory,\n} from '@xylabs/sdk'\nimport { z } from 'zod'\n\n/** ProviderConfigZod constant. */\nexport const ProviderConfigZod = z.object({\n  moniker: z.string(),\n  labels: z.array(z.string()).optional(),\n}).describe('Configuration for a Provider')\n\n/** ProviderConfig type. */\nexport type ProviderConfig = z.infer<typeof ProviderConfigZod>\n\n/** Type guard that checks if a value is a valid ProviderConfig. */\nexport const isProviderConfig = zodIsFactory(ProviderConfigZod)\n/** Converts a value to ProviderConfig, throwing if invalid. */\nexport const asProviderConfig = zodAsFactory(ProviderConfigZod, 'asProviderConfig')\n/** toProviderConfig constant. */\nexport const toProviderConfig = zodToFactory(ProviderConfigZod, 'toProviderConfig')\n", "import { globalRegistry, z } from 'zod'\n\n/** DefaultMetricsScrapePorts constant. */\nexport const DefaultMetricsScrapePorts = {\n  api: 9465,\n  bridge: 9468,\n  mempool: 9466,\n  producer: 9464,\n  rewardRedemptionApi: 9467,\n}\n\n/** MetricsScrapeConfigZod constant. */\nexport const MetricsScrapeConfigZod = z.object({\n  path: z.string().default('/metrics').register(globalRegistry, {\n    default: '/metrics',\n    description: 'Path for the metrics scrape endpoint',\n    title: 'telemetry.metrics.scrape.path',\n    type: 'string',\n  }),\n  port: z.coerce.number().int().nonnegative().optional().register(globalRegistry, {\n    description: 'Port for the metrics scrape endpoint (0 disables the scrape endpoint)',\n    title: 'telemetry.metrics.scrape.port',\n    type: 'number',\n  }),\n}).describe('Metrics scrape configuration')\n\n/** MetricsConfigZod constant. */\nexport const MetricsConfigZod = z.object({ scrape: MetricsScrapeConfigZod }).describe('Metrics configuration options')\n\n/** OpenTelemetryConfigZod constant. */\nexport const OpenTelemetryConfigZod = z.object({\n  // OpenTelemetry options\n  otlpEndpoint: z.url().optional().register(globalRegistry, {\n    description: 'OTLP endpoint for exporting telemetry data',\n    title: 'telemetry.otel.otlpEndpoint',\n    type: 'string',\n  }),\n})\n\n/** TelemetryConfigZod constant. */\nexport const TelemetryConfigZod = z.object({\n  // Metrics configuration\n  metrics: MetricsConfigZod.optional().describe('Metrics configuration'),\n  // OpenTelemetry configuration\n  otel: OpenTelemetryConfigZod.optional().describe('OpenTelemetry configuration'),\n}).describe('Telemetry configuration options')\n\n/** TelemetryConfig type. */\nexport type TelemetryConfig = z.infer<typeof TelemetryConfigZod>\n", "import { SignerAuthorizationZod } from '@xyo-network/xl1-validation'\nimport { globalRegistry, z } from 'zod'\n\nimport { DEFAULT_BACKOFF_MS, DEFAULT_MIN_CANDIDATES } from '../primitives/index.ts'\n\n/** ValidationConfigZod constant. */\nexport const ValidationConfigZod = z.object({\n  signerAuthorizations: z.array(SignerAuthorizationZod).default([]).register(globalRegistry, {\n    description: 'Authorizations granting signers the right to sign for addresses derived by a given function (e.g. completed-step-reward, derived-receive). Empty = self-transfers only.',\n    title: 'validation.signerAuthorizations',\n    type: 'array',\n  }),\n  minCandidates: z.coerce.number().default(DEFAULT_MIN_CANDIDATES).register(globalRegistry, {\n    default: DEFAULT_MIN_CANDIDATES,\n    description: 'Minimum number of uncle candidates before selecting the best uncle',\n    title: 'validation.minCandidates',\n    type: 'number',\n  }),\n  backoffMs: z.coerce.number().default(DEFAULT_BACKOFF_MS).register(globalRegistry, {\n    default: DEFAULT_BACKOFF_MS,\n    description: 'Back-off timeout in ms. If head age exceeds this, minCandidates is ignored',\n    title: 'validation.backoffMs',\n    type: 'number',\n  }),\n})\n\n/** ValidationConfig type. */\nexport type ValidationConfig = z.infer<typeof ValidationConfigZod>\n", "import type { SignedHydratedBlockWithHashMeta } from '@xyo-network/xl1-protocol-lib'\n\nimport { scoreUncle } from './scoreUncle.ts'\n\n/** Default minimum number of uncle candidates before selecting. */\nexport const DEFAULT_MIN_CANDIDATES = 1\n\n/** Default back-off timeout in milliseconds. If the head has not changed for this long, minCandidates is ignored. */\nexport const DEFAULT_BACKOFF_MS = 120_000\n\n/** Options for findBestUncle block selection. */\nexport interface FindBestUncleOptions {\n  /** Back-off timeout in ms. If head age exceeds this, minCandidates is ignored. Default: 120_000. */\n  backoffMs?: number\n  /** Minimum number of uncle candidates before selecting. Default: 1. */\n  minCandidates?: number\n  /** Current timestamp in ms. Injectable for testing. Default: Date.now(). */\n  now?: number\n}\n\n/** Selects the best uncle chain from candidates using Proof of Perfect scoring. */\nexport function findBestUncle(\n  finalizedWindowedChain: SignedHydratedBlockWithHashMeta[],\n  uncles: SignedHydratedBlockWithHashMeta[][],\n  options?: FindBestUncleOptions,\n): SignedHydratedBlockWithHashMeta[] | undefined {\n  if (uncles.length === 0) return undefined\n\n  const minCandidates = options?.minCandidates ?? DEFAULT_MIN_CANDIDATES\n  const backoffMs = options?.backoffMs ?? DEFAULT_BACKOFF_MS\n  const now = options?.now ?? Date.now()\n\n  if (uncles.length < minCandidates) {\n    const headEpoch = finalizedWindowedChain.at(-1)?.[0].$epoch ?? 0\n    const headAge = now - headEpoch\n    if (headAge < backoffMs) {\n      return undefined\n    }\n  }\n\n  const scores = uncles.map(uncle => ([scoreUncle(finalizedWindowedChain, uncle), uncle] as const)).toSorted((a, b) => b[0] - a[0])\n  return scores[0]?.[1]\n}\n", "import { z } from 'zod/mini'\n\nimport { ActorConfigZod } from './Actor.ts'\n\n/** ActorsConfigZod constant. */\nexport const ActorsConfigZod = z._default(\n  z.array(z.looseObject(ActorConfigZod.shape)).check(z.describe('Actor-specific configurations that override the base configuration when the actor is running')),\n  [],\n)\n\n/** ActorsConfig type. */\nexport type ActorsConfig = z.infer<typeof ActorsConfigZod>\n", "import { globalRegistry, z } from 'zod/mini'\n\nimport { ActorConfigZod } from './Actor.ts'\nimport { ActorsConfigZod } from './Actors.ts'\nimport { BaseConfigZod } from './Base.ts'\nimport type { DeepPartial } from './DeepPartial.ts'\n\n/** ConfigZod constant. */\nexport const ConfigZod = z.extend(BaseConfigZod, {\n  actors: ActorsConfigZod,\n  healthCheckPort: z.optional(z.coerce.number()).register(globalRegistry, {\n    description: 'Port for the system-wide health, readiness, and liveness endpoints (/healthz, /livez, /readyz). Set to 0 to disable.',\n    title: 'healthCheckPort',\n    type: 'number',\n  }),\n}).check(z.describe('The complete configuration for the protocol, including global settings and actor-specific overrides'))\n\n/** Config type. */\nexport type Config = z.infer<typeof ConfigZod>\n\n/** ResolveConfig helper function. */\nexport function resolveConfig(\n  config: DeepPartial<Config>,\n) {\n  const parsedConfig = ConfigZod.parse(config)\n  const {\n    actors, healthCheckPort: _healthCheckPort, ...rootConfig\n  } = parsedConfig\n  parsedConfig.actors = actors.map((actorConfig: z.infer<typeof ActorConfigZod>) => {\n    return z.looseObject(ActorConfigZod.shape).parse({ ...rootConfig, ...actorConfig })\n  })\n  return parsedConfig\n}\n"],
   "mappings": "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",
   "names": ["z", "zodAsFactory", "zodIsFactory", "zodToFactory", "globalRegistry", "z", "z", "globalRegistry", "z", "globalRegistry", "z", "z", "z", "globalRegistry", "globalRegistry", "z", "globalRegistry", "z", "z", "z", "z", "globalRegistry", "z", "z", "globalRegistry", "globalRegistry", "z", "z", "globalRegistry", "z", "z", "globalRegistry", "zodIsFactory", "zodAsFactory", "zodToFactory", "z", "z", "globalRegistry", "z", "z", "globalRegistry", "z"]
 }