@xyo-network/xl1-protocol-sdk 2.1.8 → 2.2.0

package/dist/neutral/getFileConfig.mjs

@@ -1,7 +1,7 @@
 // src/getFileConfig.ts
 import { isDefined as isDefined3, isNull } from "@xylabs/sdk-js";
 import { cosmiconfig } from "cosmiconfig";
-import { z as z20 } from "zod/mini";
+import { z as z22 } from "zod/mini";
 
 // src/config/Actor.ts
 import {
@@ -9,14 +9,14 @@ import {
   zodIsFactory as zodIsFactory2,
   zodToFactory as zodToFactory2
 } from "@xylabs/sdk-js";
-import { globalRegistry as globalRegistry13, z as z17 } from "zod/mini";
+import { globalRegistry as globalRegistry14, z as z19 } from "zod/mini";
 
 // src/config/Base.ts
-import { z as z16 } from "zod/mini";
+import { z as z18 } from "zod/mini";
 
 // src/config/Chain.ts
 import { HexZod } from "@xylabs/sdk-js";
-import { XyoAddressZod } from "@xyo-network/address";
+import { XyoAddressZod } from "@xyo-network/sdk-js";
 import { globalRegistry, z } from "zod/mini";
 var ChainConfigZod = z.object({
   id: z.optional(HexZod).register(globalRegistry, {
@@ -125,8 +125,24 @@ var LogConfigZod = z7.object({
   })
 });
 
+// src/config/ProviderBinding.ts
+import { globalRegistry as globalRegistry7, z as z8 } from "zod";
+var ProviderBindingConfigZod = z8.object({
+  implementation: z8.string().optional().register(globalRegistry7, {
+    description: "Installed provider implementation id (descriptor id)",
+    title: "providerBindings.implementation",
+    type: "string"
+  }),
+  transport: z8.string().optional().register(globalRegistry7, {
+    description: "Named transport from the top-level transports map",
+    title: "providerBindings.transport",
+    type: "string"
+  })
+}).describe("Provider implementation and transport binding");
+var ProviderBindingsConfigZod = z8.record(z8.string(), ProviderBindingConfigZod).default({});
+
 // src/config/Providers.ts
-import z9 from "zod";
+import z10 from "zod";
 
 // src/config/Provider.ts
 import {
@@ -134,196 +150,227 @@ import {
   zodIsFactory,
   zodToFactory
 } from "@xylabs/sdk-js";
-import { z as z8 } from "zod";
-var ProviderConfigZod = z8.object({
-  moniker: z8.string(),
-  labels: z8.array(z8.string()).optional()
+import { z as z9 } from "zod";
+var ProviderConfigZod = z9.object({
+  moniker: z9.string(),
+  labels: z9.array(z9.string()).optional()
 }).describe("Configuration for a Provider");
 var isProviderConfig = zodIsFactory(ProviderConfigZod);
 var asProviderConfig = zodAsFactory(ProviderConfigZod, "asProviderConfig");
 var toProviderConfig = zodToFactory(ProviderConfigZod, "toProviderConfig");
 
 // src/config/Providers.ts
-var ProvidersConfigZod = z9.array(ProviderConfigZod.loose()).describe("Configuration for providers").default([]);
+var ProvidersConfigZod = z10.array(ProviderConfigZod.loose()).describe("Configuration for providers").default([]);
 
 // src/config/Remote.ts
-import { globalRegistry as globalRegistry7, z as z10 } from "zod";
-var RpcRemoteConfigBaseZod = z10.object({
-  protocol: z10.string("http").register(globalRegistry7, {
+import { globalRegistry as globalRegistry8, z as z11 } from "zod";
+var RpcRemoteConfigBaseZod = z11.object({
+  protocol: z11.string("http").register(globalRegistry8, {
     description: "Protocol for the RPC connection",
     type: "string"
   })
 }).describe("Base configuration for the remote RPC");
 var HttpRpcRemoteConfigZod = RpcRemoteConfigBaseZod.extend({
-  protocol: z10.string("http").register(globalRegistry7, {
+  protocol: z11.string("http").register(globalRegistry8, {
     description: "Protocol for the RPC connection",
     type: "string"
   }).default("http"),
-  url: z10.string().register(globalRegistry7, {
+  url: z11.string().register(globalRegistry8, {
     description: "URL for the Chain RPC API",
     type: "string"
   })
 }).describe("Configuration for the remote RPC using Http");
 var PostMessageRpcRemoteConfigZod = RpcRemoteConfigBaseZod.extend({
-  protocol: z10.string().register(globalRegistry7, {
+  protocol: z11.string().register(globalRegistry8, {
     description: "Protocol for the RPC connection",
     type: "string"
   }).default("postMessage"),
-  networkId: z10.string().register(globalRegistry7, {
+  networkId: z11.string().register(globalRegistry8, {
     description: "Network ID to use for the postMessage RPC connection",
     type: "string"
   }),
-  sessionId: z10.string().register(globalRegistry7, {
+  sessionId: z11.string().register(globalRegistry8, {
     description: "Session ID to use for the postMessage RPC connection",
     type: "string"
   })
 }).describe("Configuration for the remote RPC using postMessage");
-var RpcRemoteConfigZod = z10.union([HttpRpcRemoteConfigZod, PostMessageRpcRemoteConfigZod]).describe("Configuration for a remote RPC connection, either Http or postMessage");
-var RemoteConfigZod = z10.object({ rpc: RpcRemoteConfigZod.optional() }).describe("Configuration for remote connections, including RPC");
+var RpcRemoteConfigZod = z11.union([HttpRpcRemoteConfigZod, PostMessageRpcRemoteConfigZod]).describe("Configuration for a remote RPC connection, either Http or postMessage");
+var RemoteConfigZod = z11.object({ rpc: RpcRemoteConfigZod.optional() }).describe("Configuration for remote connections, including RPC");
 
 // src/config/storage/driver/Mongo.ts
 import { isDefined, isUndefined } from "@xylabs/sdk-js";
-import { globalRegistry as globalRegistry8, z as z11 } from "zod";
-var MongoConfigZod = z11.object({
+import { globalRegistry as globalRegistry9, z as z12 } from "zod";
+var MongoConfigZod = z12.object({
   // TODO: Create from other arguments
-  connectionString: z11.string().nonempty().optional().register(globalRegistry8, {
+  connectionString: z12.string().nonempty().optional().register(globalRegistry9, {
     description: "MongoDB connection string",
     title: "storage.mongo.connectionString",
     type: "string"
   }),
-  database: z11.string().nonempty().optional().register(globalRegistry8, {
+  database: z12.string().nonempty().optional().register(globalRegistry9, {
     description: "MongoDB database name",
     title: "storage.mongo.database",
     type: "string"
   }),
-  domain: z11.string().nonempty().optional().register(globalRegistry8, {
+  domain: z12.string().nonempty().optional().register(globalRegistry9, {
     description: "MongoDB domain",
     title: "storage.mongo.domain",
     type: "string"
   }),
-  password: z11.string().nonempty().optional().register(globalRegistry8, {
+  password: z12.string().nonempty().optional().register(globalRegistry9, {
     description: "MongoDB password",
     title: "storage.mongo.password",
     type: "string"
   }),
-  username: z11.string().nonempty().optional().register(globalRegistry8, {
+  username: z12.string().nonempty().optional().register(globalRegistry9, {
     description: "MongoDB username",
     title: "storage.mongo.username",
     type: "string"
   })
 });
 
-// src/config/storage/driver/R2.ts
-import { isDefined as isDefined2, isUndefined as isUndefined2 } from "@xylabs/sdk-js";
-import { globalRegistry as globalRegistry9, z as z12 } from "zod";
-var R2ConfigZod = z12.object({
-  accessKeyId: z12.string().nonempty().optional().register(globalRegistry9, {
-    description: "Cloudflare R2 access key id (from an R2 API token)",
-    title: "storage.r2.accessKeyId",
-    type: "string"
-  }),
-  accountId: z12.string().nonempty().optional().register(globalRegistry9, {
-    description: "Cloudflare account id; determines the R2 endpoint https://<accountId>.r2.cloudflarestorage.com",
-    title: "storage.r2.accountId",
-    type: "string"
-  }),
-  bucket: z12.string().nonempty().optional().register(globalRegistry9, {
-    description: "Cloudflare R2 bucket name",
-    title: "storage.r2.bucket",
-    type: "string"
-  }),
-  chainStateBucket: z12.string().nonempty().optional().register(globalRegistry9, {
-    description: "Cloudflare R2 bucket for the mutable chain state (the head pointer); defaults to `bucket` when unset",
-    title: "storage.r2.chainStateBucket",
-    type: "string"
-  }),
-  indexBucket: z12.string().nonempty().optional().register(globalRegistry9, {
-    description: "Cloudflare R2 bucket for the chain index (the step-summary families); defaults to `bucket` when unset",
-    title: "storage.r2.indexBucket",
-    type: "string"
-  }),
-  prefix: z12.string().nonempty().optional().register(globalRegistry9, {
-    description: "Optional key prefix namespacing this store within the bucket",
-    title: "storage.r2.prefix",
-    type: "string"
-  }),
-  secretAccessKey: z12.string().nonempty().optional().register(globalRegistry9, {
-    description: "Cloudflare R2 secret access key (from an R2 API token)",
-    title: "storage.r2.secretAccessKey",
-    type: "string"
-  })
+// src/config/storage/driver/S3.ts
+import { isDefined as isDefined2 } from "@xylabs/sdk-js";
+import { z as z13 } from "zod";
+var S3BucketConfigZod = z13.object({
+  accessKeyId: z13.string().nonempty().optional().describe("S3-compatible access key id for this bucket (overrides the shared default)"),
+  accountId: z13.string().nonempty().optional().describe("Account id for this bucket; on Cloudflare R2 it forms the endpoint (overrides the shared default)"),
+  bucket: z13.string().nonempty().optional().describe("S3-compatible bucket name"),
+  prefix: z13.string().nonempty().optional().describe("Optional key prefix within the bucket"),
+  readUrl: z13.string().nonempty().optional().describe("Public HTTP/CDN base URL for anonymous reads of this bucket"),
+  secretAccessKey: z13.string().nonempty().optional().describe("S3-compatible secret access key for this bucket (overrides the shared default)")
+});
+var S3ConfigZod = z13.object({
+  accessKeyId: z13.string().nonempty().optional().describe("Shared S3-compatible access key id (default for all buckets)"),
+  accountId: z13.string().nonempty().optional().describe("Shared account id (default for all buckets; on Cloudflare R2 it forms the endpoint)"),
+  chainState: S3BucketConfigZod.optional().describe("Bucket for the mutable chain state (the head pointer)"),
+  finalized: S3BucketConfigZod.optional().describe("Bucket for the finalized files (blocks, payloads, manifest)"),
+  index: S3BucketConfigZod.optional().describe("Bucket for the chain index (the step-summary families)"),
+  prefix: z13.string().nonempty().optional().describe("Shared key prefix (default for all buckets)"),
+  secretAccessKey: z13.string().nonempty().optional().describe("Shared S3-compatible secret access key (default for all buckets)")
 });
 
 // src/config/storage/Storage.ts
-import { globalRegistry as globalRegistry10, z as z13 } from "zod";
-var StorageConfigZod = z13.object({
+import { globalRegistry as globalRegistry10, z as z14 } from "zod";
+var StorageConfigZod = z14.object({
   mongo: MongoConfigZod.optional().describe("Configuration for the MongoD storage driver"),
-  r2: R2ConfigZod.optional().describe("Configuration for the Cloudflare R2 storage driver"),
-  root: z13.string().optional().register(globalRegistry10, {
+  root: z14.string().optional().register(globalRegistry10, {
     description: "Root directory for local storage",
     title: "storage.root",
     type: "string"
-  })
+  }),
+  s3: S3ConfigZod.optional().describe("Configuration for S3-compatible object storage (e.g. Cloudflare R2)")
 }).describe("Storage configuration options");
 
 // src/config/Telemetry.ts
-import { globalRegistry as globalRegistry11, z as z14 } from "zod";
-var MetricsScrapeConfigZod = z14.object({
-  path: z14.string().default("/metrics").register(globalRegistry11, {
+import { globalRegistry as globalRegistry11, z as z15 } from "zod";
+var MetricsScrapeConfigZod = z15.object({
+  path: z15.string().default("/metrics").register(globalRegistry11, {
     default: "/metrics",
     description: "Path for the metrics scrape endpoint",
     title: "telemetry.metrics.scrape.path",
     type: "string"
   }),
-  port: z14.coerce.number().int().positive().optional().register(globalRegistry11, {
+  port: z15.coerce.number().int().positive().optional().register(globalRegistry11, {
     description: "Port for the metrics scrape endpoint",
     title: "telemetry.metrics.scrape.port",
     type: "number"
   })
 }).describe("Metrics scrape configuration");
-var MetricsConfigZod = z14.object({ scrape: MetricsScrapeConfigZod }).describe("Metrics configuration options");
-var OpenTelemetryConfigZod = z14.object({
+var MetricsConfigZod = z15.object({ scrape: MetricsScrapeConfigZod }).describe("Metrics configuration options");
+var OpenTelemetryConfigZod = z15.object({
   // OpenTelemetry options
-  otlpEndpoint: z14.url().optional().register(globalRegistry11, {
+  otlpEndpoint: z15.url().optional().register(globalRegistry11, {
     description: "OTLP endpoint for exporting telemetry data",
     title: "telemetry.otel.otlpEndpoint",
     type: "string"
   })
 });
-var TelemetryConfigZod = z14.object({
+var TelemetryConfigZod = z15.object({
   // Metrics configuration
   metrics: MetricsConfigZod.optional().describe("Metrics configuration"),
   // OpenTelemetry configuration
   otel: OpenTelemetryConfigZod.optional().describe("OpenTelemetry configuration")
 }).describe("Telemetry configuration options");
 
+// src/config/transports/Transport.ts
+import { globalRegistry as globalRegistry12, z as z16 } from "zod";
+var LmdbTransportConfigZod = z16.object({
+  type: z16.literal("lmdb"),
+  root: z16.string().register(globalRegistry12, {
+    description: "Root directory for local LMDB storage",
+    title: "transports.lmdb.root",
+    type: "string"
+  })
+}).describe("LMDB local storage transport");
+var MongoTransportConfigZod = z16.object({
+  type: z16.literal("mongo"),
+  connectionString: MongoConfigZod.shape.connectionString,
+  database: MongoConfigZod.shape.database,
+  domain: MongoConfigZod.shape.domain,
+  password: MongoConfigZod.shape.password,
+  username: MongoConfigZod.shape.username
+}).describe("MongoDB storage transport");
+var RpcTransportConfigZod = HttpRpcRemoteConfigZod.extend({ type: z16.literal("rpc") }).describe("XL1 JSON-RPC transport");
+var RestTransportConfigZod = z16.object({
+  type: z16.literal("rest"),
+  baseUrl: z16.string().register(globalRegistry12, {
+    description: "HTTP base URL for REST reads",
+    title: "transports.rest.baseUrl",
+    type: "string"
+  })
+}).describe("HTTP REST read transport");
+var S3TransportConfigZod = S3BucketConfigZod.extend({
+  type: z16.literal("s3"),
+  accessKeyId: z16.string().optional(),
+  accountId: z16.string().optional(),
+  secretAccessKey: z16.string().optional()
+}).describe("S3-compatible object storage transport");
+var EvmRpcTransportConfigZod = z16.object({
+  type: z16.literal("evm-rpc"),
+  url: z16.string().register(globalRegistry12, {
+    description: "EVM JSON-RPC URL",
+    title: "transports.evm-rpc.url",
+    type: "string"
+  })
+}).describe("EVM JSON-RPC transport");
+var TransportConfigZod = z16.discriminatedUnion("type", [
+  LmdbTransportConfigZod,
+  MongoTransportConfigZod,
+  RpcTransportConfigZod,
+  RestTransportConfigZod,
+  S3TransportConfigZod,
+  EvmRpcTransportConfigZod
+]);
+var TransportsConfigZod = z16.record(z16.string(), TransportConfigZod).default({});
+
 // src/config/Validation.ts
-import { XyoAddressZod as XyoAddressZod2 } from "@xyo-network/address";
-import { globalRegistry as globalRegistry12, z as z15 } from "zod";
+import { XyoAddressZod as XyoAddressZod2 } from "@xyo-network/sdk-js";
+import { globalRegistry as globalRegistry13, z as z17 } from "zod";
 
 // src/primitives/uncle/findBestUncle.ts
 var DEFAULT_MIN_CANDIDATES = 1;
 var DEFAULT_BACKOFF_MS = 12e4;
 
 // src/config/Validation.ts
-var ValidationConfigZod = z15.object({
-  allowedRewardRedeemers: z15.array(XyoAddressZod2).optional().register(globalRegistry12, {
+var ValidationConfigZod = z17.object({
+  allowedRewardRedeemers: z17.array(XyoAddressZod2).optional().register(globalRegistry13, {
     description: "List of allowed reward redeemer addresses, if undefined anyone can participate",
     title: "allowedRewardRedeemers",
     type: "array"
   }),
-  allowedRewardEscrowAccountSigners: z15.array(XyoAddressZod2).optional().register(globalRegistry12, {
+  allowedRewardEscrowAccountSigners: z17.array(XyoAddressZod2).optional().register(globalRegistry13, {
     description: "List of allowed reward escrow account signer addresses, if undefined anyone can participate",
     title: "allowedRewardEscrowAccountSigners",
     type: "array"
   }),
-  minCandidates: z15.coerce.number().default(DEFAULT_MIN_CANDIDATES).register(globalRegistry12, {
+  minCandidates: z17.coerce.number().default(DEFAULT_MIN_CANDIDATES).register(globalRegistry13, {
     default: DEFAULT_MIN_CANDIDATES,
     description: "Minimum number of uncle candidates before selecting the best uncle",
     title: "validation.minCandidates",
     type: "number"
   }),
-  backoffMs: z15.coerce.number().default(DEFAULT_BACKOFF_MS).register(globalRegistry12, {
+  backoffMs: z17.coerce.number().default(DEFAULT_BACKOFF_MS).register(globalRegistry13, {
     default: DEFAULT_BACKOFF_MS,
     description: "Back-off timeout in ms. If head age exceeds this, minCandidates is ignored",
     title: "validation.backoffMs",
@@ -332,26 +379,28 @@ var ValidationConfigZod = z15.object({
 });
 
 // src/config/Base.ts
-var BaseConfigZod = z16.object({
-  chain: z16._default(ChainConfigZod, ChainConfigZod.parse({})).check(z16.describe("Configuration for the chain")),
-  dataLake: z16.optional(DataLakeConfigZod).check(z16.describe("Configuration for data lakes")),
-  evm: z16._default(EvmConfigZod, EvmConfigZod.parse({})).check(z16.describe("Configuration for EVM-backed services")),
-  log: z16._default(LogConfigZod, LogConfigZod.parse({})).check(z16.describe("Configuration for logging")),
-  providers: z16._default(ProvidersConfigZod, ProvidersConfigZod.parse([])).check(z16.describe("Configuration for providers")),
-  remote: z16._default(RemoteConfigZod, RemoteConfigZod.parse({})).check(z16.describe("Configuration for remote services")),
-  storage: z16._default(StorageConfigZod, StorageConfigZod.parse({})).check(z16.describe("Configuration for the storage")),
-  telemetry: z16._default(TelemetryConfigZod, TelemetryConfigZod.parse({})).check(z16.describe("Configuration for telemetry")),
-  validation: z16._default(ValidationConfigZod, ValidationConfigZod.parse({})).check(z16.describe("Configuration for validation"))
+var BaseConfigZod = z18.object({
+  chain: z18._default(ChainConfigZod, ChainConfigZod.parse({})).check(z18.describe("Configuration for the chain")),
+  dataLake: z18.optional(DataLakeConfigZod).check(z18.describe("Configuration for data lakes")),
+  evm: z18._default(EvmConfigZod, EvmConfigZod.parse({})).check(z18.describe("Configuration for EVM-backed services")),
+  log: z18._default(LogConfigZod, LogConfigZod.parse({})).check(z18.describe("Configuration for logging")),
+  providerBindings: z18._default(ProviderBindingsConfigZod, ProviderBindingsConfigZod.parse({})).check(z18.describe("Per-moniker provider implementation and transport bindings")),
+  providers: z18._default(ProvidersConfigZod, ProvidersConfigZod.parse([])).check(z18.describe("Configuration for providers")),
+  remote: z18._default(RemoteConfigZod, RemoteConfigZod.parse({})).check(z18.describe("Configuration for remote services")),
+  transports: z18._default(TransportsConfigZod, TransportsConfigZod.parse({})).check(z18.describe("Named connection profiles (rpc, rest, s3, lmdb, mongo, evm-rpc)")),
+  storage: z18._default(StorageConfigZod, StorageConfigZod.parse({})).check(z18.describe("Configuration for the storage")),
+  telemetry: z18._default(TelemetryConfigZod, TelemetryConfigZod.parse({})).check(z18.describe("Configuration for telemetry")),
+  validation: z18._default(ValidationConfigZod, ValidationConfigZod.parse({})).check(z18.describe("Configuration for validation"))
 });
 
 // src/config/Actor.ts
-var AccountPathZod = z17.string().check(z17.regex(
+var AccountPathZod = z19.string().check(z19.regex(
   /^(m(\/\d+'?)+|\d+'?(\/\d+'?)*)$/,
   `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".`
 ));
-var ActorConfigZod = z17.extend(BaseConfigZod, {
-  name: z17.string(),
-  accountPath: z17.optional(AccountPathZod).register(globalRegistry13, {
+var ActorConfigZod = z19.extend(BaseConfigZod, {
+  name: z19.string(),
+  accountPath: z19.optional(AccountPathZod).register(globalRegistry14, {
     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.',
     title: "accountPath",
     type: "string"
@@ -362,22 +411,22 @@ var asActorConfig = zodAsFactory2(ActorConfigZod, "asActorConfig");
 var toActorConfig = zodToFactory2(ActorConfigZod, "toActorConfig");
 
 // src/config/Actors.ts
-import { z as z18 } from "zod/mini";
-var ActorsConfigZod = z18._default(
-  z18.array(z18.looseObject(ActorConfigZod.shape)).check(z18.describe("Actor-specific configurations that override the base configuration when the actor is running")),
+import { z as z20 } from "zod/mini";
+var ActorsConfigZod = z20._default(
+  z20.array(z20.looseObject(ActorConfigZod.shape)).check(z20.describe("Actor-specific configurations that override the base configuration when the actor is running")),
   []
 );
 
 // src/config/Config.ts
-import { globalRegistry as globalRegistry14, z as z19 } from "zod/mini";
-var ConfigZod = z19.extend(BaseConfigZod, {
+import { globalRegistry as globalRegistry15, z as z21 } from "zod/mini";
+var ConfigZod = z21.extend(BaseConfigZod, {
   actors: ActorsConfigZod,
-  healthCheckPort: z19.optional(z19.coerce.number()).register(globalRegistry14, {
+  healthCheckPort: z21.optional(z21.coerce.number()).register(globalRegistry15, {
     description: "Port for the system-wide health, readiness, and liveness endpoints (/healthz, /livez, /readyz). Set to 0 to disable.",
     title: "healthCheckPort",
     type: "number"
   })
-}).check(z19.describe("The complete configuration for the protocol, including global settings and actor-specific overrides"));
+}).check(z21.describe("The complete configuration for the protocol, including global settings and actor-specific overrides"));
 
 // src/getFileConfig.ts
 var configName = "xyo";
@@ -394,7 +443,7 @@ async function getFileConfig(searchPlaces) {
   if (!isNull(result)) {
     const section = result[configSection];
     if (isDefined3(section) && typeof section === "object") {
-      return z20.looseObject(ConfigZod.shape).parse(section);
+      return z22.looseObject(ConfigZod.shape).parse(section);
     }
   }
   return ConfigZod.parse({});