@xyo-network/xl1-protocol-sdk 1.30.0 → 1.30.2

package/dist/neutral/getFileConfig.mjs

@@ -365,4 +365,4 @@ async function getFileConfig(searchPlaces) {
 export {
   getFileConfig
 };
-//# sourceMappingURL=getFileConfig.mjs.map
+//# sourceMappingURL=getFileConfig.mjs.map

package/dist/neutral/getFileConfig.mjs.map

@@ -1 +1,7 @@
-{"version":3,"sources":["../../src/getFileConfig.ts","../../src/config/Actor.ts","../../src/config/Base.ts","../../src/config/Chain.ts","../../src/config/DataLake/DataLake.ts","../../src/config/DataLake/RestDataLakeConfig.ts","../../src/config/DataLake/DataLakeRemoteConfig.ts","../../src/config/DataLake/RouterDataLakeConfig.ts","../../src/config/Evm.ts","../../src/config/Log.ts","../../src/config/Providers.ts","../../src/config/Provider.ts","../../src/config/Remote.ts","../../src/config/storage/driver/Mongo.ts","../../src/config/storage/Storage.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'\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 result: unknown = (await explorer.search())?.config\n  if (!isNull(result)) {\n    const section = (result as Record<string, unknown>)[configSection]\n    if (isDefined(section) && typeof section === 'object') {\n      return ConfigZod.loose().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'\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().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 = BaseConfigZod.extend({\n  name: z.string(),\n  accountPath: AccountPathZod.optional().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   * @deprecated Use the top-level `healthCheckPort` on `ConfigZod` instead.\n   * The system-wide health server covers all actors in a single process; per-actor\n   * health ports will be removed in a future major release.\n   */\n  healthCheckPort: z.coerce.number().optional().register(globalRegistry, {\n    description: '[DEPRECATED — use top-level healthCheckPort] Per-actor health server port.',\n    title: 'actor.healthCheckPort',\n    type: 'number',\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'\n\nimport { ChainConfigZod } from './Chain.ts'\nimport { DataLakeConfigZod } from './DataLake/index.ts'\nimport { EvmConfigZod } from './Evm.ts'\nimport { LogConfigZod } from './Log.ts'\nimport { ProvidersConfigZod } from './Providers.ts'\nimport { RemoteConfigZod } from './Remote.ts'\nimport { StorageConfigZod } from './storage/index.ts'\nimport { TelemetryConfigZod } from './Telemetry.ts'\nimport { ValidationConfigZod } from './Validation.ts'\n\n/** BaseConfigZod constant. */\nexport const BaseConfigZod = z.object({\n  chain: ChainConfigZod.default(ChainConfigZod.parse({})).describe('Configuration for the chain'),\n  dataLake: DataLakeConfigZod.optional().describe('Configuration for data lakes'),\n  evm: EvmConfigZod.default(EvmConfigZod.parse({})).describe('Configuration for EVM-backed services'),\n  log: LogConfigZod.default(LogConfigZod.parse({})).describe('Configuration for logging'),\n  providers: ProvidersConfigZod.default(ProvidersConfigZod.parse([])).describe('Configuration for providers'),\n  remote: RemoteConfigZod.default(RemoteConfigZod.parse({})).describe('Configuration for remote services'),\n  storage: StorageConfigZod.default(StorageConfigZod.parse({})).describe('Configuration for the storage'),\n  telemetry: TelemetryConfigZod.default(TelemetryConfigZod.parse({})).describe('Configuration for telemetry'),\n  validation: ValidationConfigZod.default(ValidationConfigZod.parse({})).describe('Configuration for validation'),\n})\n\n/** BaseConfig type. */\nexport type BaseConfig = z.infer<typeof BaseConfigZod>\n","import { AddressZod, HexZod } from '@xylabs/sdk-js'\nimport { globalRegistry, z } from 'zod'\n\n/** ChainConfigZod constant. */\nexport const ChainConfigZod = z.object({\n  id: HexZod.optional()\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: AddressZod.optional()\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 { z } from 'zod'\n\nimport { type RestDataLakeConfig, RestDataLakeConfigZod } from './RestDataLakeConfig.ts'\n// eslint-disable-next-line import-x/no-cycle -- intentional cycle for z.lazy recursive type\nimport { type RouterDataLakeConfig, RouterDataLakeConfigZod } from './RouterDataLakeConfig.ts'\n\n/** DataLakeConfig type. */\nexport type DataLakeConfig = RestDataLakeConfig | RouterDataLakeConfig\n\n// z.lazy handles the circular reference between DataLakeConfigZod and RouterDataLakeZod\n/** DataLakeConfigZod constant. */\nexport const DataLakeConfigZod: z.ZodType<DataLakeConfig> = z.lazy(() =>\n  z.union([RestDataLakeConfigZod, RouterDataLakeConfigZod])).describe('Configuration for a data lake')\n","import { globalRegistry, z } from 'zod'\n\nimport { DataLakeDriverConfigBaseZod } from './DataLakeRemoteConfig.ts'\n\n/** RestDataLakeConfigZod constant. */\nexport const RestDataLakeConfigZod = DataLakeDriverConfigBaseZod.extend({\n  driver: z.literal('rest').register(globalRegistry, {\n    description: 'Driver for the REST data lake',\n    type: 'string',\n  }),\n  url: z.string().register(globalRegistry, {\n    description: 'URL for the REST data lake',\n    type: 'string',\n  }),\n}).describe('Configuration for the REST data lake driver')\n\n/** RestDataLakeConfig type. */\nexport type RestDataLakeConfig = z.infer<typeof RestDataLakeConfigZod>\n","import { globalRegistry, z } from 'zod'\n\n/** DataLakeDriverConfigBaseZod constant. */\nexport const DataLakeDriverConfigBaseZod = z.object({\n  driver: z.string().register(globalRegistry, {\n    description: 'Driver for the data lake',\n    type: 'string',\n  }),\n}).describe('Base configuration for a data lake driver')\n/** DataLakeDriverConfigBase type. */\nexport type DataLakeDriverConfigBase = z.infer<typeof DataLakeDriverConfigBaseZod>\n","import { globalRegistry, z } from 'zod'\n\nimport type { DataLakeConfig } from './DataLake.ts'\n// eslint-disable-next-line import-x/no-cycle -- intentional cycle for z.lazy recursive type\nimport { DataLakeConfigZod } from './DataLake.ts'\n\n/** Configuration for RouterDataLake. */\nexport interface RouterDataLakeConfig {\n  children: DataLakeConfig[]\n  driver: 'router'\n}\n\n/** RouterDataLakeConfigZod constant. */\nexport const RouterDataLakeConfigZod: z.ZodType<RouterDataLakeConfig> = z.object({\n  driver: z.literal('router').register(globalRegistry, {\n    description: 'Driver for the router data lake',\n    type: 'string',\n  }),\n  children: z.array(z.lazy(() => DataLakeConfigZod)).register(globalRegistry, {\n    description: 'Child data lake drivers',\n    type: 'array',\n  }),\n}).describe('Configuration for the router data lake driver')\n","import { globalRegistry, z } from 'zod'\n\n/** EvmInfuraConfigZod constant. */\nexport const EvmInfuraConfigZod = z.object({\n  projectId: z.string().optional().register(globalRegistry, {\n    description: 'Infura project ID',\n    title: 'evm.infura.projectId',\n    type: 'string',\n  }),\n  projectSecret: z.string().optional().register(globalRegistry, {\n    description: 'Infura project secret',\n    title: 'evm.infura.projectSecret',\n    type: 'string',\n  }),\n})\n\n/** EvmJsonRpcConfigZod constant. */\nexport const EvmJsonRpcConfigZod = z.object({\n  url: z.url().optional().register(globalRegistry, {\n    description: 'JSON-RPC URL',\n    title: 'evm.jsonRpc.url',\n    type: 'string',\n  }),\n})\n\n/** EvmConfigZod constant. */\nexport const EvmConfigZod = z.object({\n  chainId: z.string().optional().register(globalRegistry, {\n    description: 'EVM chain ID',\n    title: 'evm.chainId',\n    type: 'string',\n  }),\n  infura: EvmInfuraConfigZod.optional().describe('Infura Provider configuration'),\n  jsonRpc: EvmJsonRpcConfigZod.optional().describe('JSON-RPC Provider configuration'),\n})\n\n/** EvmConfig type. */\nexport type EvmConfig = z.infer<typeof EvmConfigZod>\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 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/** RpcRemoteConfigBaseZod constant. */\nexport const RpcRemoteConfigBaseZod = z.object({\n  protocol: z.string('http').register(globalRegistry, {\n    description: 'Protocol for the RPC connection',\n    type: 'string',\n  }),\n}).describe('Base configuration for the remote RPC')\n\n/** RpcRemoteConfigBase type. */\nexport type RpcRemoteConfigBase = z.infer<typeof RpcRemoteConfigBaseZod>\n\n/** HttpRpcRemoteConfigZod constant. */\nexport const HttpRpcRemoteConfigZod = RpcRemoteConfigBaseZod.extend({\n  protocol: z.string('http').register(globalRegistry, {\n    description: 'Protocol for the RPC connection',\n    type: 'string',\n  }).default('http'),\n  url: z.string().register(globalRegistry, {\n    description: 'URL for the Chain RPC API',\n    type: 'string',\n  }),\n}).describe('Configuration for the remote RPC using Http')\n\n/** HttpRpcRemoteConfig type. */\nexport type HttpRpcRemoteConfig = z.infer<typeof HttpRpcRemoteConfigZod>\n\n/** PostMessageRpcRemoteConfigZod constant. */\nexport const PostMessageRpcRemoteConfigZod = RpcRemoteConfigBaseZod.extend({\n  protocol: z.string().register(globalRegistry, {\n    description: 'Protocol for the RPC connection',\n    type: 'string',\n  }).default('postMessage'),\n  networkId: z.string().register(globalRegistry, {\n    description: 'Network ID to use for the postMessage RPC connection',\n    type: 'string',\n  }),\n  sessionId: z.string().register(globalRegistry, {\n    description: 'Session ID to use for the postMessage RPC connection',\n    type: 'string',\n  }),\n}).describe('Configuration for the remote RPC using postMessage')\n\n/** PostMessageRpcRemoteConfig type. */\nexport type PostMessageRpcRemoteConfig = z.infer<typeof PostMessageRpcRemoteConfigZod>\n\n/** RpcRemoteConfigZod constant. */\nexport const RpcRemoteConfigZod = z.union([HttpRpcRemoteConfigZod, PostMessageRpcRemoteConfigZod])\n  .describe('Configuration for a remote RPC connection, either Http or postMessage')\n\n/** RpcRemoteConfig type. */\nexport type RpcRemoteConfig = z.infer<typeof RpcRemoteConfigZod>\n\n/** RemoteConfigZod constant. */\nexport const RemoteConfigZod = z.object({ rpc: RpcRemoteConfigZod.optional() }).describe('Configuration for remote connections, including RPC')\n\n/** RemoteConfig type. */\nexport type RemoteConfig = z.infer<typeof RemoteConfigZod>\n","import { isDefined, isUndefined } from '@xylabs/sdk-js'\nimport { globalRegistry, z } from 'zod'\n\n/**\n * Checks if the provided MongoDB configuration contains the fields needed to\n * identify a Mongo target. `username` / `password` are intentionally not\n * required: `mongodb-memory-server` and many production deployments run\n * without auth (or carry credentials inline in the `connectionString` URI).\n * @param config MongoDB configuration object\n * @returns True iff `connectionString`, `database`, and `domain` are all set\n */\nexport const hasMongoConfig = (\n  config?: MongoConfig,\n): config is MongoConfig & { connectionString: string; database: string; domain: string } => {\n  if (isUndefined(config)) return false\n  return (\n    isDefined(config.connectionString)\n    && isDefined(config.database)\n    && isDefined(config.domain)\n  )\n}\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 { globalRegistry, z } from 'zod'\n\nimport { MongoConfigZod } from './driver/index.ts'\n\n/** StorageConfigZod constant. */\nexport const StorageConfigZod = z.object({\n  mongo: MongoConfigZod.optional().describe('Configuration for the MongoD storage driver'),\n  root: z.string().optional().register(globalRegistry, {\n    description: 'Root directory for local storage',\n    title: 'storage.root',\n    type: 'string',\n  }),\n}).describe('Storage configuration options')\n\n/** StorageConfig type. */\nexport type StorageConfig = z.infer<typeof StorageConfigZod>\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().positive().optional().register(globalRegistry, {\n    description: 'Port for the metrics 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 { AddressZod } from '@xylabs/sdk-js'\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  allowedRewardRedeemers: z.array(AddressZod).optional().register(globalRegistry, {\n    description: 'List of allowed reward redeemer addresses, if undefined anyone can participate',\n    title: 'allowedRewardRedeemers',\n    type: 'array',\n  }),\n  allowedRewardEscrowAccountSigners: z.array(AddressZod).optional().register(globalRegistry, {\n    description: 'List of allowed reward escrow account signer addresses, if undefined anyone can participate',\n    title: 'allowedRewardEscrowAccountSigners',\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'\n\nimport { ActorConfigZod } from './Actor.ts'\n\n/** ActorsConfigZod constant. */\nexport const ActorsConfigZod = z.array(ActorConfigZod.loose()).describe('Actor-specific configurations that override the base configuration when the actor is running').default([])\n\n/** ActorsConfig type. */\nexport type ActorsConfig = z.infer<typeof ActorsConfigZod>\n","import { globalRegistry, z } from 'zod'\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 = BaseConfigZod.extend({\n  actors: ActorsConfigZod,\n  healthCheckPort: z.coerce.number().optional().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}).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 { actors, ...rootConfig } = parsedConfig\n  parsedConfig.actors = actors.map((actorConfig) => {\n    return ActorConfigZod.loose().parse({ ...rootConfig, ...actorConfig })\n  })\n  return parsedConfig\n}\n"],"mappings":";AAAA,SAAS,aAAAA,YAAW,cAAc;AAClC,SAAS,mBAAmB;;;ACD5B;AAAA,EACE,gBAAAC;AAAA,EAAc,gBAAAC;AAAA,EAAc,gBAAAC;AAAA,OACvB;AACP,SAAS,kBAAAC,kBAAgB,KAAAC,WAAS;;;ACHlC,SAAS,KAAAC,WAAS;;;ACAlB,SAAS,YAAY,cAAc;AACnC,SAAS,gBAAgB,SAAS;AAG3B,IAAM,iBAAiB,EAAE,OAAO;AAAA,EACrC,IAAI,OAAO,SAAS,EACjB,SAAS,gBAAgB;AAAA,IACxB,aACA;AAAA,IACA,OAAO;AAAA,IACP,MAAM;AAAA,EACR,CAAC;AAAA,EACH,sBAAsB,WAAW,SAAS,EACvC,SAAS,gBAAgB;AAAA,IACxB,aACA;AAAA,IACA,OAAO;AAAA,IACP,MAAM;AAAA,EACR,CAAC;AACL,CAAC;;;ACnBD,SAAS,KAAAC,UAAS;;;ACAlB,SAAS,kBAAAC,iBAAgB,KAAAC,UAAS;;;ACAlC,SAAS,kBAAAC,iBAAgB,KAAAC,UAAS;AAG3B,IAAM,8BAA8BA,GAAE,OAAO;AAAA,EAClD,QAAQA,GAAE,OAAO,EAAE,SAASD,iBAAgB;AAAA,IAC1C,aAAa;AAAA,IACb,MAAM;AAAA,EACR,CAAC;AACH,CAAC,EAAE,SAAS,2CAA2C;;;ADHhD,IAAM,wBAAwB,4BAA4B,OAAO;AAAA,EACtE,QAAQE,GAAE,QAAQ,MAAM,EAAE,SAASC,iBAAgB;AAAA,IACjD,aAAa;AAAA,IACb,MAAM;AAAA,EACR,CAAC;AAAA,EACD,KAAKD,GAAE,OAAO,EAAE,SAASC,iBAAgB;AAAA,IACvC,aAAa;AAAA,IACb,MAAM;AAAA,EACR,CAAC;AACH,CAAC,EAAE,SAAS,6CAA6C;;;AEdzD,SAAS,kBAAAC,iBAAgB,KAAAC,UAAS;AAa3B,IAAM,0BAA2DC,GAAE,OAAO;AAAA,EAC/E,QAAQA,GAAE,QAAQ,QAAQ,EAAE,SAASC,iBAAgB;AAAA,IACnD,aAAa;AAAA,IACb,MAAM;AAAA,EACR,CAAC;AAAA,EACD,UAAUD,GAAE,MAAMA,GAAE,KAAK,MAAM,iBAAiB,CAAC,EAAE,SAASC,iBAAgB;AAAA,IAC1E,aAAa;AAAA,IACb,MAAM;AAAA,EACR,CAAC;AACH,CAAC,EAAE,SAAS,+CAA+C;;;AHXpD,IAAM,oBAA+CC,GAAE,KAAK,MACjEA,GAAE,MAAM,CAAC,uBAAuB,uBAAuB,CAAC,CAAC,EAAE,SAAS,+BAA+B;;;AIZrG,SAAS,kBAAAC,iBAAgB,KAAAC,UAAS;AAG3B,IAAM,qBAAqBA,GAAE,OAAO;AAAA,EACzC,WAAWA,GAAE,OAAO,EAAE,SAAS,EAAE,SAASD,iBAAgB;AAAA,IACxD,aAAa;AAAA,IACb,OAAO;AAAA,IACP,MAAM;AAAA,EACR,CAAC;AAAA,EACD,eAAeC,GAAE,OAAO,EAAE,SAAS,EAAE,SAASD,iBAAgB;AAAA,IAC5D,aAAa;AAAA,IACb,OAAO;AAAA,IACP,MAAM;AAAA,EACR,CAAC;AACH,CAAC;AAGM,IAAM,sBAAsBC,GAAE,OAAO;AAAA,EAC1C,KAAKA,GAAE,IAAI,EAAE,SAAS,EAAE,SAASD,iBAAgB;AAAA,IAC/C,aAAa;AAAA,IACb,OAAO;AAAA,IACP,MAAM;AAAA,EACR,CAAC;AACH,CAAC;AAGM,IAAM,eAAeC,GAAE,OAAO;AAAA,EACnC,SAASA,GAAE,OAAO,EAAE,SAAS,EAAE,SAASD,iBAAgB;AAAA,IACtD,aAAa;AAAA,IACb,OAAO;AAAA,IACP,MAAM;AAAA,EACR,CAAC;AAAA,EACD,QAAQ,mBAAmB,SAAS,EAAE,SAAS,+BAA+B;AAAA,EAC9E,SAAS,oBAAoB,SAAS,EAAE,SAAS,iCAAiC;AACpF,CAAC;;;ACjCD,SAAS,gBAAgB;AACzB,SAAS,kBAAAE,iBAAgB,KAAAC,UAAS;AAElC,IAAM,gBAAgB,OAAO,KAAK,QAAQ;AAGnC,IAAM,eAAeA,GAAE,OAAO;AAAA,EACnC,UAAUA,GAAE,KAAK,aAAa,EAAE,QAAQ,MAAM,EAAE,SAASD,iBAAgB;AAAA,IACvE,SAAS;AAAA,IACT,SAAS;AAAA,IACT,aAAa;AAAA,IACb,OAAO;AAAA,IACP,MAAM;AAAA,EACR,CAAC;AAAA,EACD,QAAQC,GAAE,QAAQ,EAAE,QAAQ,KAAK,EAAE,SAASD,iBAAgB;AAAA,IAC1D,SAAS;AAAA,IACT,aAAa;AAAA,IACb,OAAO;AAAA,IACP,MAAM;AAAA,EACR,CAAC;AACH,CAAC;;;ACrBD,OAAOE,QAAO;;;ACAd;AAAA,EACE;AAAA,EAAc;AAAA,EAAc;AAAA,OACvB;AACP,SAAS,KAAAC,UAAS;AAGX,IAAM,oBAAoBA,GAAE,OAAO;AAAA,EACxC,SAASA,GAAE,OAAO;AAAA,EAClB,QAAQA,GAAE,MAAMA,GAAE,OAAO,CAAC,EAAE,SAAS;AACvC,CAAC,EAAE,SAAS,8BAA8B;AAMnC,IAAM,mBAAmB,aAAa,iBAAiB;AAEvD,IAAM,mBAAmB,aAAa,mBAAmB,kBAAkB;AAE3E,IAAM,mBAAmB,aAAa,mBAAmB,kBAAkB;;;ADd3E,IAAM,qBAAqBC,GAAE,MAAM,kBAAkB,MAAM,CAAC,EAAE,SAAS,6BAA6B,EAAE,QAAQ,CAAC,CAAC;;;AELvH,SAAS,kBAAAC,iBAAgB,KAAAC,WAAS;AAG3B,IAAM,yBAAyBA,IAAE,OAAO;AAAA,EAC7C,UAAUA,IAAE,OAAO,MAAM,EAAE,SAASD,iBAAgB;AAAA,IAClD,aAAa;AAAA,IACb,MAAM;AAAA,EACR,CAAC;AACH,CAAC,EAAE,SAAS,uCAAuC;AAM5C,IAAM,yBAAyB,uBAAuB,OAAO;AAAA,EAClE,UAAUC,IAAE,OAAO,MAAM,EAAE,SAASD,iBAAgB;AAAA,IAClD,aAAa;AAAA,IACb,MAAM;AAAA,EACR,CAAC,EAAE,QAAQ,MAAM;AAAA,EACjB,KAAKC,IAAE,OAAO,EAAE,SAASD,iBAAgB;AAAA,IACvC,aAAa;AAAA,IACb,MAAM;AAAA,EACR,CAAC;AACH,CAAC,EAAE,SAAS,6CAA6C;AAMlD,IAAM,gCAAgC,uBAAuB,OAAO;AAAA,EACzE,UAAUC,IAAE,OAAO,EAAE,SAASD,iBAAgB;AAAA,IAC5C,aAAa;AAAA,IACb,MAAM;AAAA,EACR,CAAC,EAAE,QAAQ,aAAa;AAAA,EACxB,WAAWC,IAAE,OAAO,EAAE,SAASD,iBAAgB;AAAA,IAC7C,aAAa;AAAA,IACb,MAAM;AAAA,EACR,CAAC;AAAA,EACD,WAAWC,IAAE,OAAO,EAAE,SAASD,iBAAgB;AAAA,IAC7C,aAAa;AAAA,IACb,MAAM;AAAA,EACR,CAAC;AACH,CAAC,EAAE,SAAS,oDAAoD;AAMzD,IAAM,qBAAqBC,IAAE,MAAM,CAAC,wBAAwB,6BAA6B,CAAC,EAC9F,SAAS,uEAAuE;AAM5E,IAAM,kBAAkBA,IAAE,OAAO,EAAE,KAAK,mBAAmB,SAAS,EAAE,CAAC,EAAE,SAAS,qDAAqD;;;ACvD9I,SAAS,WAAW,mBAAmB;AACvC,SAAS,kBAAAC,iBAAgB,KAAAC,WAAS;AAsB3B,IAAM,iBAAiBC,IAAE,OAAO;AAAA;AAAA,EAErC,kBAAkBA,IAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAASC,iBAAgB;AAAA,IAC1E,aAAa;AAAA,IACb,OAAO;AAAA,IACP,MAAM;AAAA,EACR,CAAC;AAAA,EACD,UAAUD,IAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAASC,iBAAgB;AAAA,IAClE,aAAa;AAAA,IACb,OAAO;AAAA,IACP,MAAM;AAAA,EACR,CAAC;AAAA,EACD,QAAQD,IAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAASC,iBAAgB;AAAA,IAChE,aAAa;AAAA,IACb,OAAO;AAAA,IACP,MAAM;AAAA,EACR,CAAC;AAAA,EACD,UAAUD,IAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAASC,iBAAgB;AAAA,IAClE,aAAa;AAAA,IACb,OAAO;AAAA,IACP,MAAM;AAAA,EACR,CAAC;AAAA,EACD,UAAUD,IAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAASC,iBAAgB;AAAA,IAClE,aAAa;AAAA,IACb,OAAO;AAAA,IACP,MAAM;AAAA,EACR,CAAC;AACH,CAAC;;;AClDD,SAAS,kBAAAC,iBAAgB,KAAAC,WAAS;AAK3B,IAAM,mBAAmBC,IAAE,OAAO;AAAA,EACvC,OAAO,eAAe,SAAS,EAAE,SAAS,6CAA6C;AAAA,EACvF,MAAMA,IAAE,OAAO,EAAE,SAAS,EAAE,SAASC,iBAAgB;AAAA,IACnD,aAAa;AAAA,IACb,OAAO;AAAA,IACP,MAAM;AAAA,EACR,CAAC;AACH,CAAC,EAAE,SAAS,+BAA+B;;;ACZ3C,SAAS,kBAAAC,kBAAgB,KAAAC,WAAS;AAY3B,IAAM,yBAAyBC,IAAE,OAAO;AAAA,EAC7C,MAAMA,IAAE,OAAO,EAAE,QAAQ,UAAU,EAAE,SAASC,kBAAgB;AAAA,IAC5D,SAAS;AAAA,IACT,aAAa;AAAA,IACb,OAAO;AAAA,IACP,MAAM;AAAA,EACR,CAAC;AAAA,EACD,MAAMD,IAAE,OAAO,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,SAASC,kBAAgB;AAAA,IAC3E,aAAa;AAAA,IACb,OAAO;AAAA,IACP,MAAM;AAAA,EACR,CAAC;AACH,CAAC,EAAE,SAAS,8BAA8B;AAGnC,IAAM,mBAAmBD,IAAE,OAAO,EAAE,QAAQ,uBAAuB,CAAC,EAAE,SAAS,+BAA+B;AAG9G,IAAM,yBAAyBA,IAAE,OAAO;AAAA;AAAA,EAE7C,cAAcA,IAAE,IAAI,EAAE,SAAS,EAAE,SAASC,kBAAgB;AAAA,IACxD,aAAa;AAAA,IACb,OAAO;AAAA,IACP,MAAM;AAAA,EACR,CAAC;AACH,CAAC;AAGM,IAAM,qBAAqBD,IAAE,OAAO;AAAA;AAAA,EAEzC,SAAS,iBAAiB,SAAS,EAAE,SAAS,uBAAuB;AAAA;AAAA,EAErE,MAAM,uBAAuB,SAAS,EAAE,SAAS,6BAA6B;AAChF,CAAC,EAAE,SAAS,iCAAiC;;;AC7C7C,SAAS,cAAAE,mBAAkB;AAC3B,SAAS,kBAAAC,kBAAgB,KAAAC,WAAS;;;ACI3B,IAAM,yBAAyB;AAG/B,IAAM,qBAAqB;;;ADF3B,IAAM,sBAAsBC,IAAE,OAAO;AAAA,EAC1C,wBAAwBA,IAAE,MAAMC,WAAU,EAAE,SAAS,EAAE,SAASC,kBAAgB;AAAA,IAC9E,aAAa;AAAA,IACb,OAAO;AAAA,IACP,MAAM;AAAA,EACR,CAAC;AAAA,EACD,mCAAmCF,IAAE,MAAMC,WAAU,EAAE,SAAS,EAAE,SAASC,kBAAgB;AAAA,IACzF,aAAa;AAAA,IACb,OAAO;AAAA,IACP,MAAM;AAAA,EACR,CAAC;AAAA,EACD,eAAeF,IAAE,OAAO,OAAO,EAAE,QAAQ,sBAAsB,EAAE,SAASE,kBAAgB;AAAA,IACxF,SAAS;AAAA,IACT,aAAa;AAAA,IACb,OAAO;AAAA,IACP,MAAM;AAAA,EACR,CAAC;AAAA,EACD,WAAWF,IAAE,OAAO,OAAO,EAAE,QAAQ,kBAAkB,EAAE,SAASE,kBAAgB;AAAA,IAChF,SAAS;AAAA,IACT,aAAa;AAAA,IACb,OAAO;AAAA,IACP,MAAM;AAAA,EACR,CAAC;AACH,CAAC;;;AdhBM,IAAM,gBAAgBC,IAAE,OAAO;AAAA,EACpC,OAAO,eAAe,QAAQ,eAAe,MAAM,CAAC,CAAC,CAAC,EAAE,SAAS,6BAA6B;AAAA,EAC9F,UAAU,kBAAkB,SAAS,EAAE,SAAS,8BAA8B;AAAA,EAC9E,KAAK,aAAa,QAAQ,aAAa,MAAM,CAAC,CAAC,CAAC,EAAE,SAAS,uCAAuC;AAAA,EAClG,KAAK,aAAa,QAAQ,aAAa,MAAM,CAAC,CAAC,CAAC,EAAE,SAAS,2BAA2B;AAAA,EACtF,WAAW,mBAAmB,QAAQ,mBAAmB,MAAM,CAAC,CAAC,CAAC,EAAE,SAAS,6BAA6B;AAAA,EAC1G,QAAQ,gBAAgB,QAAQ,gBAAgB,MAAM,CAAC,CAAC,CAAC,EAAE,SAAS,mCAAmC;AAAA,EACvG,SAAS,iBAAiB,QAAQ,iBAAiB,MAAM,CAAC,CAAC,CAAC,EAAE,SAAS,+BAA+B;AAAA,EACtG,WAAW,mBAAmB,QAAQ,mBAAmB,MAAM,CAAC,CAAC,CAAC,EAAE,SAAS,6BAA6B;AAAA,EAC1G,YAAY,oBAAoB,QAAQ,oBAAoB,MAAM,CAAC,CAAC,CAAC,EAAE,SAAS,8BAA8B;AAChH,CAAC;;;ADNM,IAAM,iBAAiBC,IAAE,OAAO,EAAE;AAAA,EACvC;AAAA,EACA;AACF;AAGO,IAAM,iBAAiB,cAAc,OAAO;AAAA,EACjD,MAAMA,IAAE,OAAO;AAAA,EACf,aAAa,eAAe,SAAS,EAAE,SAASC,kBAAgB;AAAA,IAC9D,aAAa;AAAA,IACb,OAAO;AAAA,IACP,MAAM;AAAA,EACR,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMD,iBAAiBD,IAAE,OAAO,OAAO,EAAE,SAAS,EAAE,SAASC,kBAAgB;AAAA,IACrE,aAAa;AAAA,IACb,OAAO;AAAA,IACP,MAAM;AAAA,EACR,CAAC;AACH,CAAC;AAMM,IAAM,gBAAgBC,cAAa,cAAc;AAEjD,IAAM,gBAAgBC,cAAa,gBAAgB,eAAe;AAElE,IAAM,gBAAgBC,cAAa,gBAAgB,eAAe;;;AiBlDzE,OAAOC,SAAO;AAKP,IAAM,kBAAkBC,IAAE,MAAM,eAAe,MAAM,CAAC,EAAE,SAAS,8FAA8F,EAAE,QAAQ,CAAC,CAAC;;;ACLlL,SAAS,kBAAAC,kBAAgB,KAAAC,WAAS;AAQ3B,IAAM,YAAY,cAAc,OAAO;AAAA,EAC5C,QAAQ;AAAA,EACR,iBAAiBC,IAAE,OAAO,OAAO,EAAE,SAAS,EAAE,SAASC,kBAAgB;AAAA,IACrE,aAAa;AAAA,IACb,OAAO;AAAA,IACP,MAAM;AAAA,EACR,CAAC;AACH,CAAC,EAAE,SAAS,qGAAqG;;;AnBPjH,IAAM,aAAa;AAKnB,IAAM,gBAAgB;AAMtB,eAAsB,cAAc,cAAyB;AAC3D,QAAM,WAAW;AAAA,IACf;AAAA,IACA;AAAA,MACE,OAAO;AAAA,MACP;AAAA,IACF;AAAA,EACF;AACA,QAAM,UAAmB,MAAM,SAAS,OAAO,IAAI;AACnD,MAAI,CAAC,OAAO,MAAM,GAAG;AACnB,UAAM,UAAW,OAAmC,aAAa;AACjE,QAAIC,WAAU,OAAO,KAAK,OAAO,YAAY,UAAU;AACrD,aAAO,UAAU,MAAM,EAAE,MAAM,OAAO;AAAA,IACxC;AAAA,EACF;AACA,SAAO,UAAU,MAAM,CAAC,CAAC;AAC3B;","names":["isDefined","zodAsFactory","zodIsFactory","zodToFactory","globalRegistry","z","z","z","globalRegistry","z","globalRegistry","z","z","globalRegistry","globalRegistry","z","z","globalRegistry","z","globalRegistry","z","globalRegistry","z","z","z","z","globalRegistry","z","globalRegistry","z","z","globalRegistry","globalRegistry","z","z","globalRegistry","globalRegistry","z","z","globalRegistry","AddressZod","globalRegistry","z","z","AddressZod","globalRegistry","z","z","globalRegistry","zodIsFactory","zodAsFactory","zodToFactory","z","z","globalRegistry","z","z","globalRegistry","isDefined"]}
+{
+  "version": 3,
+  "sources": ["../../src/getFileConfig.ts", "../../src/config/Actor.ts", "../../src/config/Base.ts", "../../src/config/Chain.ts", "../../src/config/DataLake/DataLake.ts", "../../src/config/DataLake/RestDataLakeConfig.ts", "../../src/config/DataLake/DataLakeRemoteConfig.ts", "../../src/config/DataLake/RouterDataLakeConfig.ts", "../../src/config/Evm.ts", "../../src/config/Log.ts", "../../src/config/Providers.ts", "../../src/config/Provider.ts", "../../src/config/Remote.ts", "../../src/config/storage/driver/Mongo.ts", "../../src/config/storage/Storage.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'\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 result: unknown = (await explorer.search())?.config\n  if (!isNull(result)) {\n    const section = (result as Record<string, unknown>)[configSection]\n    if (isDefined(section) && typeof section === 'object') {\n      return ConfigZod.loose().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'\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().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 = BaseConfigZod.extend({\n  name: z.string(),\n  accountPath: AccountPathZod.optional().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   * @deprecated Use the top-level `healthCheckPort` on `ConfigZod` instead.\n   * The system-wide health server covers all actors in a single process; per-actor\n   * health ports will be removed in a future major release.\n   */\n  healthCheckPort: z.coerce.number().optional().register(globalRegistry, {\n    description: '[DEPRECATED \u2014 use top-level healthCheckPort] Per-actor health server port.',\n    title: 'actor.healthCheckPort',\n    type: 'number',\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'\n\nimport { ChainConfigZod } from './Chain.ts'\nimport { DataLakeConfigZod } from './DataLake/index.ts'\nimport { EvmConfigZod } from './Evm.ts'\nimport { LogConfigZod } from './Log.ts'\nimport { ProvidersConfigZod } from './Providers.ts'\nimport { RemoteConfigZod } from './Remote.ts'\nimport { StorageConfigZod } from './storage/index.ts'\nimport { TelemetryConfigZod } from './Telemetry.ts'\nimport { ValidationConfigZod } from './Validation.ts'\n\n/** BaseConfigZod constant. */\nexport const BaseConfigZod = z.object({\n  chain: ChainConfigZod.default(ChainConfigZod.parse({})).describe('Configuration for the chain'),\n  dataLake: DataLakeConfigZod.optional().describe('Configuration for data lakes'),\n  evm: EvmConfigZod.default(EvmConfigZod.parse({})).describe('Configuration for EVM-backed services'),\n  log: LogConfigZod.default(LogConfigZod.parse({})).describe('Configuration for logging'),\n  providers: ProvidersConfigZod.default(ProvidersConfigZod.parse([])).describe('Configuration for providers'),\n  remote: RemoteConfigZod.default(RemoteConfigZod.parse({})).describe('Configuration for remote services'),\n  storage: StorageConfigZod.default(StorageConfigZod.parse({})).describe('Configuration for the storage'),\n  telemetry: TelemetryConfigZod.default(TelemetryConfigZod.parse({})).describe('Configuration for telemetry'),\n  validation: ValidationConfigZod.default(ValidationConfigZod.parse({})).describe('Configuration for validation'),\n})\n\n/** BaseConfig type. */\nexport type BaseConfig = z.infer<typeof BaseConfigZod>\n", "import { AddressZod, HexZod } from '@xylabs/sdk-js'\nimport { globalRegistry, z } from 'zod'\n\n/** ChainConfigZod constant. */\nexport const ChainConfigZod = z.object({\n  id: HexZod.optional()\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: AddressZod.optional()\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 { z } from 'zod'\n\nimport { type RestDataLakeConfig, RestDataLakeConfigZod } from './RestDataLakeConfig.ts'\n// eslint-disable-next-line import-x/no-cycle -- intentional cycle for z.lazy recursive type\nimport { type RouterDataLakeConfig, RouterDataLakeConfigZod } from './RouterDataLakeConfig.ts'\n\n/** DataLakeConfig type. */\nexport type DataLakeConfig = RestDataLakeConfig | RouterDataLakeConfig\n\n// z.lazy handles the circular reference between DataLakeConfigZod and RouterDataLakeZod\n/** DataLakeConfigZod constant. */\nexport const DataLakeConfigZod: z.ZodType<DataLakeConfig> = z.lazy(() =>\n  z.union([RestDataLakeConfigZod, RouterDataLakeConfigZod])).describe('Configuration for a data lake')\n", "import { globalRegistry, z } from 'zod'\n\nimport { DataLakeDriverConfigBaseZod } from './DataLakeRemoteConfig.ts'\n\n/** RestDataLakeConfigZod constant. */\nexport const RestDataLakeConfigZod = DataLakeDriverConfigBaseZod.extend({\n  driver: z.literal('rest').register(globalRegistry, {\n    description: 'Driver for the REST data lake',\n    type: 'string',\n  }),\n  url: z.string().register(globalRegistry, {\n    description: 'URL for the REST data lake',\n    type: 'string',\n  }),\n}).describe('Configuration for the REST data lake driver')\n\n/** RestDataLakeConfig type. */\nexport type RestDataLakeConfig = z.infer<typeof RestDataLakeConfigZod>\n", "import { globalRegistry, z } from 'zod'\n\n/** DataLakeDriverConfigBaseZod constant. */\nexport const DataLakeDriverConfigBaseZod = z.object({\n  driver: z.string().register(globalRegistry, {\n    description: 'Driver for the data lake',\n    type: 'string',\n  }),\n}).describe('Base configuration for a data lake driver')\n/** DataLakeDriverConfigBase type. */\nexport type DataLakeDriverConfigBase = z.infer<typeof DataLakeDriverConfigBaseZod>\n", "import { globalRegistry, z } from 'zod'\n\nimport type { DataLakeConfig } from './DataLake.ts'\n// eslint-disable-next-line import-x/no-cycle -- intentional cycle for z.lazy recursive type\nimport { DataLakeConfigZod } from './DataLake.ts'\n\n/** Configuration for RouterDataLake. */\nexport interface RouterDataLakeConfig {\n  children: DataLakeConfig[]\n  driver: 'router'\n}\n\n/** RouterDataLakeConfigZod constant. */\nexport const RouterDataLakeConfigZod: z.ZodType<RouterDataLakeConfig> = z.object({\n  driver: z.literal('router').register(globalRegistry, {\n    description: 'Driver for the router data lake',\n    type: 'string',\n  }),\n  children: z.array(z.lazy(() => DataLakeConfigZod)).register(globalRegistry, {\n    description: 'Child data lake drivers',\n    type: 'array',\n  }),\n}).describe('Configuration for the router data lake driver')\n", "import { globalRegistry, z } from 'zod'\n\n/** EvmInfuraConfigZod constant. */\nexport const EvmInfuraConfigZod = z.object({\n  projectId: z.string().optional().register(globalRegistry, {\n    description: 'Infura project ID',\n    title: 'evm.infura.projectId',\n    type: 'string',\n  }),\n  projectSecret: z.string().optional().register(globalRegistry, {\n    description: 'Infura project secret',\n    title: 'evm.infura.projectSecret',\n    type: 'string',\n  }),\n})\n\n/** EvmJsonRpcConfigZod constant. */\nexport const EvmJsonRpcConfigZod = z.object({\n  url: z.url().optional().register(globalRegistry, {\n    description: 'JSON-RPC URL',\n    title: 'evm.jsonRpc.url',\n    type: 'string',\n  }),\n})\n\n/** EvmConfigZod constant. */\nexport const EvmConfigZod = z.object({\n  chainId: z.string().optional().register(globalRegistry, {\n    description: 'EVM chain ID',\n    title: 'evm.chainId',\n    type: 'string',\n  }),\n  infura: EvmInfuraConfigZod.optional().describe('Infura Provider configuration'),\n  jsonRpc: EvmJsonRpcConfigZod.optional().describe('JSON-RPC Provider configuration'),\n})\n\n/** EvmConfig type. */\nexport type EvmConfig = z.infer<typeof EvmConfigZod>\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 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/** RpcRemoteConfigBaseZod constant. */\nexport const RpcRemoteConfigBaseZod = z.object({\n  protocol: z.string('http').register(globalRegistry, {\n    description: 'Protocol for the RPC connection',\n    type: 'string',\n  }),\n}).describe('Base configuration for the remote RPC')\n\n/** RpcRemoteConfigBase type. */\nexport type RpcRemoteConfigBase = z.infer<typeof RpcRemoteConfigBaseZod>\n\n/** HttpRpcRemoteConfigZod constant. */\nexport const HttpRpcRemoteConfigZod = RpcRemoteConfigBaseZod.extend({\n  protocol: z.string('http').register(globalRegistry, {\n    description: 'Protocol for the RPC connection',\n    type: 'string',\n  }).default('http'),\n  url: z.string().register(globalRegistry, {\n    description: 'URL for the Chain RPC API',\n    type: 'string',\n  }),\n}).describe('Configuration for the remote RPC using Http')\n\n/** HttpRpcRemoteConfig type. */\nexport type HttpRpcRemoteConfig = z.infer<typeof HttpRpcRemoteConfigZod>\n\n/** PostMessageRpcRemoteConfigZod constant. */\nexport const PostMessageRpcRemoteConfigZod = RpcRemoteConfigBaseZod.extend({\n  protocol: z.string().register(globalRegistry, {\n    description: 'Protocol for the RPC connection',\n    type: 'string',\n  }).default('postMessage'),\n  networkId: z.string().register(globalRegistry, {\n    description: 'Network ID to use for the postMessage RPC connection',\n    type: 'string',\n  }),\n  sessionId: z.string().register(globalRegistry, {\n    description: 'Session ID to use for the postMessage RPC connection',\n    type: 'string',\n  }),\n}).describe('Configuration for the remote RPC using postMessage')\n\n/** PostMessageRpcRemoteConfig type. */\nexport type PostMessageRpcRemoteConfig = z.infer<typeof PostMessageRpcRemoteConfigZod>\n\n/** RpcRemoteConfigZod constant. */\nexport const RpcRemoteConfigZod = z.union([HttpRpcRemoteConfigZod, PostMessageRpcRemoteConfigZod])\n  .describe('Configuration for a remote RPC connection, either Http or postMessage')\n\n/** RpcRemoteConfig type. */\nexport type RpcRemoteConfig = z.infer<typeof RpcRemoteConfigZod>\n\n/** RemoteConfigZod constant. */\nexport const RemoteConfigZod = z.object({ rpc: RpcRemoteConfigZod.optional() }).describe('Configuration for remote connections, including RPC')\n\n/** RemoteConfig type. */\nexport type RemoteConfig = z.infer<typeof RemoteConfigZod>\n", "import { isDefined, isUndefined } from '@xylabs/sdk-js'\nimport { globalRegistry, z } from 'zod'\n\n/**\n * Checks if the provided MongoDB configuration contains the fields needed to\n * identify a Mongo target. `username` / `password` are intentionally not\n * required: `mongodb-memory-server` and many production deployments run\n * without auth (or carry credentials inline in the `connectionString` URI).\n * @param config MongoDB configuration object\n * @returns True iff `connectionString`, `database`, and `domain` are all set\n */\nexport const hasMongoConfig = (\n  config?: MongoConfig,\n): config is MongoConfig & { connectionString: string; database: string; domain: string } => {\n  if (isUndefined(config)) return false\n  return (\n    isDefined(config.connectionString)\n    && isDefined(config.database)\n    && isDefined(config.domain)\n  )\n}\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 { globalRegistry, z } from 'zod'\n\nimport { MongoConfigZod } from './driver/index.ts'\n\n/** StorageConfigZod constant. */\nexport const StorageConfigZod = z.object({\n  mongo: MongoConfigZod.optional().describe('Configuration for the MongoD storage driver'),\n  root: z.string().optional().register(globalRegistry, {\n    description: 'Root directory for local storage',\n    title: 'storage.root',\n    type: 'string',\n  }),\n}).describe('Storage configuration options')\n\n/** StorageConfig type. */\nexport type StorageConfig = z.infer<typeof StorageConfigZod>\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().positive().optional().register(globalRegistry, {\n    description: 'Port for the metrics 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 { AddressZod } from '@xylabs/sdk-js'\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  allowedRewardRedeemers: z.array(AddressZod).optional().register(globalRegistry, {\n    description: 'List of allowed reward redeemer addresses, if undefined anyone can participate',\n    title: 'allowedRewardRedeemers',\n    type: 'array',\n  }),\n  allowedRewardEscrowAccountSigners: z.array(AddressZod).optional().register(globalRegistry, {\n    description: 'List of allowed reward escrow account signer addresses, if undefined anyone can participate',\n    title: 'allowedRewardEscrowAccountSigners',\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'\n\nimport { ActorConfigZod } from './Actor.ts'\n\n/** ActorsConfigZod constant. */\nexport const ActorsConfigZod = z.array(ActorConfigZod.loose()).describe('Actor-specific configurations that override the base configuration when the actor is running').default([])\n\n/** ActorsConfig type. */\nexport type ActorsConfig = z.infer<typeof ActorsConfigZod>\n", "import { globalRegistry, z } from 'zod'\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 = BaseConfigZod.extend({\n  actors: ActorsConfigZod,\n  healthCheckPort: z.coerce.number().optional().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}).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 { actors, ...rootConfig } = parsedConfig\n  parsedConfig.actors = actors.map((actorConfig) => {\n    return ActorConfigZod.loose().parse({ ...rootConfig, ...actorConfig })\n  })\n  return parsedConfig\n}\n"],
+  "mappings": "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",
+  "names": ["isDefined", "zodAsFactory", "zodIsFactory", "zodToFactory", "globalRegistry", "z", "z", "z", "globalRegistry", "z", "globalRegistry", "z", "z", "globalRegistry", "globalRegistry", "z", "z", "globalRegistry", "z", "globalRegistry", "z", "globalRegistry", "z", "z", "z", "z", "globalRegistry", "z", "globalRegistry", "z", "z", "globalRegistry", "globalRegistry", "z", "z", "globalRegistry", "globalRegistry", "z", "z", "globalRegistry", "AddressZod", "globalRegistry", "z", "z", "AddressZod", "globalRegistry", "z", "z", "globalRegistry", "zodIsFactory", "zodAsFactory", "zodToFactory", "z", "z", "globalRegistry", "z", "z", "globalRegistry", "isDefined"]
+}

package/dist/neutral/index.mjs

@@ -4973,18 +4973,26 @@ import {
   isSignedHydratedBlockWithHashMeta,
   isSignedHydratedTransactionWithHashMeta,
   MempoolRunnerMoniker,
+  MempoolViewerMoniker,
   TransactionRejectionSchema,
   TransactionValidationViewerMoniker
 } from "@xyo-network/xl1-protocol-lib";
 import { Mutex } from "async-mutex";
 var DEFAULT_SYNC_INTERVAL = 3e4;
 var DEFAULT_SYNC_LIMIT = 100;
+var ENFORCE_CAP_BATCH_SIZE = 1e3;
+function isDemotionAware(viewer) {
+  if (!viewer) return false;
+  const candidate = viewer;
+  return typeof candidate.forget === "function" && typeof candidate.getEvictionPriorityOrder === "function";
+}
 var SimpleMempoolRunner = class extends AbstractCreatableProvider {
   moniker = SimpleMempoolRunner.defaultMoniker;
   _blockValidationViewer;
   _chainContractViewer;
   _deadLetterQueueRunner;
   _finalizationViewer;
+  _mempoolViewer;
   _transactionValidationViewer;
   _syncMutex = new Mutex();
   _syncTimerId = null;
@@ -5003,6 +5011,9 @@ var SimpleMempoolRunner = class extends AbstractCreatableProvider {
   get maxExpAhead() {
     return this.params.maxExpAhead ?? DEFAULT_MAX_EXP_AHEAD;
   }
+  get maxPendingTransactions() {
+    return this.params.maxPendingTransactions ?? 0;
+  }
   get pendingBlocksArchivist() {
     return this.params.pendingBlocksArchivist;
   }
@@ -5035,6 +5046,7 @@ var SimpleMempoolRunner = class extends AbstractCreatableProvider {
     this._finalizationViewer = await this.locator.getInstance(FinalizationViewerMoniker4);
     this._transactionValidationViewer = await this.locator.getInstance(TransactionValidationViewerMoniker);
     this._deadLetterQueueRunner = await this.locator.tryGetInstance(DeadLetterQueueRunnerMoniker);
+    this._mempoolViewer = await this.locator.tryGetInstance(MempoolViewerMoniker);
   }
   async prunePendingBlocks({
     batchSize = 10,
@@ -5149,6 +5161,7 @@ var SimpleMempoolRunner = class extends AbstractCreatableProvider {
       pruned += pruneHashes.length;
       total += batch.length;
       await this.pendingTransactionsArchivist.delete(pruneHashes);
+      this.forgetBundleHashes(pruneHashes);
       const pruneSet = new Set(pruneHashes);
       const lastSurvivor = batch.findLast((p) => !pruneSet.has(p._hash));
       cursor = lastSurvivor?._sequence ?? cursor;
@@ -5158,8 +5171,7 @@ var SimpleMempoolRunner = class extends AbstractCreatableProvider {
         order: "desc"
       });
     }
-    this.logger?.debug(`prunePendingTransactions completed: pruned=${pruned}, totalChecked=${total}`);
-    return [pruned, total];
+    return this.finalizePruneTransactionsResult(pruned, total);
   }
   async submitBlocks(blocks) {
     const bundles = await Promise.all(blocks.map(async ([bw, payloads]) => {
@@ -5205,6 +5217,7 @@ var SimpleMempoolRunner = class extends AbstractCreatableProvider {
     }
     const bundles = hashedTransactions.map((tx) => hydratedTransactionToPayloadBundle(tx));
     const inserted = await this.pendingTransactionsArchivist.insert(bundles);
+    await this.enforceCap();
     return inserted.map((p) => p._hash);
   }
   async startHandler() {
@@ -5223,6 +5236,50 @@ var SimpleMempoolRunner = class extends AbstractCreatableProvider {
       this._syncTimerId = null;
     }
   }
+  async collectAllPendingTransactionBundles() {
+    const all = [];
+    let cursor;
+    while (true) {
+      const batch = await this.pendingTransactionsArchivist.next({
+        limit: ENFORCE_CAP_BATCH_SIZE,
+        cursor,
+        order: "asc"
+      });
+      if (batch.length === 0) break;
+      all.push(...batch);
+      cursor = batch.at(-1)?._sequence;
+      if (batch.length < ENFORCE_CAP_BATCH_SIZE) break;
+    }
+    return all;
+  }
+  async enforceCap() {
+    const cap = this.maxPendingTransactions;
+    if (cap <= 0) return;
+    const all = await this.collectAllPendingTransactionBundles();
+    if (all.length <= cap) return;
+    const excess = all.length - cap;
+    const bundleHashesOldestFirst = all.map((p) => p._hash);
+    const orderedForEviction = this.orderForEviction(bundleHashesOldestFirst);
+    const toEvict = orderedForEviction.slice(0, excess);
+    await this.pendingTransactionsArchivist.delete(toEvict);
+    this.forgetBundleHashes(toEvict);
+    this.logger?.debug(`enforceCap evicted ${toEvict.length} bundles (pool=${all.length}, cap=${cap})`);
+  }
+  async finalizePruneTransactionsResult(pruned, total) {
+    this.logger?.debug(`prunePendingTransactions completed: pruned=${pruned}, totalChecked=${total}`);
+    await this.enforceCap();
+    return [pruned, total];
+  }
+  forgetBundleHashes(bundleHashes) {
+    if (bundleHashes.length === 0) return;
+    if (isDemotionAware(this._mempoolViewer)) this._mempoolViewer.forget(bundleHashes);
+  }
+  orderForEviction(bundleHashesOldestFirst) {
+    if (isDemotionAware(this._mempoolViewer)) {
+      return this._mempoolViewer.getEvictionPriorityOrder(bundleHashesOldestFirst);
+    }
+    return bundleHashesOldestFirst;
+  }
   async routeRejectedTransaction(transaction, errors) {
     if (!this._deadLetterQueueRunner) return;
     const rejectionErrors = errors.map((e) => ({
@@ -5335,13 +5392,22 @@ import {
 } from "@xylabs/sdk-js";
 import { isHashMeta as isHashMeta2, isPayloadBundle as isPayloadBundle2 } from "@xyo-network/sdk-js";
 import {
-  MempoolViewerMoniker,
+  MempoolViewerMoniker as MempoolViewerMoniker2,
   WindowedBlockViewerMoniker
 } from "@xyo-network/xl1-protocol-lib";
 var DEFAULT_MEMPOOL_SELECTION_RATIO = 0.66;
+var DEFAULT_DEMOTION_THRESHOLD = 3;
+var DEFAULT_HANDOUT_STATS_TTL_BLOCKS = 1e3;
 var SimpleMempoolViewer = class extends AbstractCreatableProvider {
   moniker = SimpleMempoolViewer.defaultMoniker;
+  _handoutStats = /* @__PURE__ */ new Map();
   _windowedBlockViewer;
+  get demotionThreshold() {
+    return this.params.demotionThreshold ?? DEFAULT_DEMOTION_THRESHOLD;
+  }
+  get handoutStatsTtlBlocks() {
+    return this.params.handoutStatsTtlBlocks ?? DEFAULT_HANDOUT_STATS_TTL_BLOCKS;
+  }
   get pendingBlocksArchivist() {
     return this.params.pendingBlocksArchivist;
   }
@@ -5355,6 +5421,32 @@ var SimpleMempoolViewer = class extends AbstractCreatableProvider {
     await super.createHandler();
     this._windowedBlockViewer = await this.locator.getInstance(WindowedBlockViewerMoniker);
   }
+  /** Drop handout stats for the given bundle hashes. Called when a bundle has been evicted or otherwise removed from the pool. */
+  forget(bundleHashes) {
+    for (const hash of bundleHashes) this._handoutStats.delete(hash);
+  }
+  /** Return the subset of the given bundle hashes that are currently considered demoted. */
+  getDemotedBundleHashes(bundleHashes) {
+    return bundleHashes.filter((hash) => this.isDemoted(hash));
+  }
+  /**
+   * Return the bundle hashes in the order they should be evicted under size pressure.
+   * Demoted entries come first, sorted by handouts descending; the remainder is left as-is
+   * so the caller can append by FIFO sequence order.
+   */
+  getEvictionPriorityOrder(bundleHashes) {
+    const demoted = [];
+    const nonDemoted = [];
+    for (const hash of bundleHashes) {
+      if (this.isDemoted(hash)) demoted.push(hash);
+      else nonDemoted.push(hash);
+    }
+    demoted.sort((a, b) => (this._handoutStats.get(b)?.handouts ?? 0) - (this._handoutStats.get(a)?.handouts ?? 0));
+    return [...demoted, ...nonDemoted];
+  }
+  getHandoutStats(bundleHash) {
+    return this._handoutStats.get(bundleHash);
+  }
   async pendingBlocks({ cursor: providedCursor } = {}) {
     let cursor = void 0;
     if (isHash2(providedCursor)) {
@@ -5397,6 +5489,7 @@ var SimpleMempoolViewer = class extends AbstractCreatableProvider {
       })
     )).filter(exists9);
     const currentBlock = await this.windowedBlockViewer.currentBlock();
+    const currentBlockNumber = currentBlock[0].block;
     const evaluated = await Promise.all(
       hydratedWithBundle.map(async ({ bundle: bundle3, tx }) => ({
         bundle: bundle3,
@@ -5410,25 +5503,43 @@ var SimpleMempoolViewer = class extends AbstractCreatableProvider {
     await Promise.all(
       deletionCandidates.map(async ({ bundle: bundle3, tx }) => {
         await this.deleteBundledTransaction(bundle3);
+        this._handoutStats.delete(bundle3._hash);
         this.logger?.debug(`Purged completed/expired bundled transaction: ${bundle3._hash}/${tx[0]._hash}`);
       })
     );
-    const inclusionCandidates = (await Promise.all(validTransactions.map((x) => x.tx).map(async (tx) => {
-      if (await this.isInclusionCandidate(tx, currentBlock, false)) return tx;
+    this.gcHandoutStats(currentBlockNumber);
+    const inclusionCandidates = (await Promise.all(validTransactions.map(async ({ bundle: bundle3, tx }) => {
+      if (await this.isInclusionCandidate(tx, currentBlock, false)) return { bundle: bundle3, tx };
     }))).filter(exists9);
     const selectionRatio = this.params.mempoolSelectionRatio ?? DEFAULT_MEMPOOL_SELECTION_RATIO;
-    const maxByRatio = Math.ceil(inclusionCandidates.length * selectionRatio);
-    const effectiveLimit = Math.min(limit, maxByRatio);
-    const randomInclusionCandidates = deduplicateBySigner(
-      inclusionCandidates.filter(() => Math.random() < selectionRatio)
-    ).slice(0, effectiveLimit);
-    const result = randomInclusionCandidates.length > 0 ? randomInclusionCandidates : deduplicateBySigner(inclusionCandidates).slice(0, 1);
-    this.logger?.debug(`Inclusion candidates: ${inclusionCandidates.length}`);
-    return result;
+    const nonDemoted = inclusionCandidates.filter(({ bundle: bundle3 }) => !this.isDemoted(bundle3._hash));
+    const demoted = inclusionCandidates.filter(({ bundle: bundle3 }) => this.isDemoted(bundle3._hash));
+    const primary = this.selectWithRatio(nonDemoted, limit, selectionRatio);
+    const topupNeeded = limit - primary.length;
+    const topup = topupNeeded > 0 ? this.selectWithRatio(demoted, topupNeeded, selectionRatio) : [];
+    let combined = [...primary, ...topup];
+    if (combined.length === 0 && inclusionCandidates.length > 0) {
+      combined = deduplicateWithBundleBySigner(inclusionCandidates).slice(0, 1);
+    }
+    for (const { bundle: bundle3 } of combined) {
+      this.recordHandout(bundle3._hash, currentBlockNumber);
+    }
+    this.logger?.debug(`Inclusion candidates: ${inclusionCandidates.length} (nonDemoted=${nonDemoted.length}, demoted=${demoted.length}); returning ${combined.length}`);
+    return combined.map(({ tx }) => tx);
+  }
+  isDemoted(bundleHash) {
+    const stats = this._handoutStats.get(bundleHash);
+    return stats !== void 0 && stats.handouts >= this.demotionThreshold;
   }
   async deleteBundledTransaction(bundle3) {
     await this.pendingTransactionsArchivist.delete([bundle3._hash]);
   }
+  gcHandoutStats(currentBlockNumber) {
+    const ttl = this.handoutStatsTtlBlocks;
+    for (const [hash, stats] of this._handoutStats) {
+      if (currentBlockNumber - stats.firstHandoutAt > ttl) this._handoutStats.delete(hash);
+    }
+  }
   /**
    * Evaluates a transaction to determine if it should be purged from the mempool.
    * @param tx The transaction to evaluate
@@ -5461,16 +5572,31 @@ var SimpleMempoolViewer = class extends AbstractCreatableProvider {
     if (checkForDeletable && await this.isDeletable(tx, currentBlock)) return false;
     return true;
   }
+  recordHandout(bundleHash, currentBlockNumber) {
+    const existing = this._handoutStats.get(bundleHash);
+    if (existing) {
+      existing.handouts += 1;
+    } else {
+      this._handoutStats.set(bundleHash, { handouts: 1, firstHandoutAt: currentBlockNumber });
+    }
+  }
+  selectWithRatio(group, take, selectionRatio) {
+    if (take <= 0 || group.length === 0) return [];
+    const maxByRatio = Math.ceil(group.length * selectionRatio);
+    const effectiveLimit = Math.min(take, maxByRatio);
+    const randomSelected = group.filter(() => Math.random() < selectionRatio);
+    return deduplicateWithBundleBySigner(randomSelected).slice(0, effectiveLimit);
+  }
 };
-__publicField(SimpleMempoolViewer, "defaultMoniker", MempoolViewerMoniker);
+__publicField(SimpleMempoolViewer, "defaultMoniker", MempoolViewerMoniker2);
 __publicField(SimpleMempoolViewer, "dependencies", [WindowedBlockViewerMoniker]);
-__publicField(SimpleMempoolViewer, "monikers", [MempoolViewerMoniker]);
+__publicField(SimpleMempoolViewer, "monikers", [MempoolViewerMoniker2]);
 SimpleMempoolViewer = __decorateClass([
   creatableProvider()
 ], SimpleMempoolViewer);
-function deduplicateBySigner(txs) {
+function deduplicateWithBundleBySigner(items) {
   const seen = /* @__PURE__ */ new Set();
-  return txs.filter((tx) => {
+  return items.filter(({ tx }) => {
     const key = tx[0].addresses.toSorted().join(",");
     if (seen.has(key)) return false;
     seen.add(key);
@@ -6925,4 +7051,4 @@ export {
   withContextCacheResponse,
   xl1BlockNumberToEthBlockNumber
 };
-//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map