@usherlabs/cex-broker 0.2.48 → 0.2.50

package/dist/commands/market-data-vendor-backfill.js

@@ -8257,241 +8257,6 @@ var require_src = __commonJS((exports) => {
   };
 });
 
-// node_modules/@loglayer/transport-opentelemetry/node_modules/@opentelemetry/api-logs/build/src/types/LogRecord.js
-var require_LogRecord = __commonJS((exports) => {
-  Object.defineProperty(exports, "__esModule", { value: true });
-  exports.SeverityNumber = undefined;
-  var SeverityNumber;
-  (function(SeverityNumber2) {
-    SeverityNumber2[SeverityNumber2["UNSPECIFIED"] = 0] = "UNSPECIFIED";
-    SeverityNumber2[SeverityNumber2["TRACE"] = 1] = "TRACE";
-    SeverityNumber2[SeverityNumber2["TRACE2"] = 2] = "TRACE2";
-    SeverityNumber2[SeverityNumber2["TRACE3"] = 3] = "TRACE3";
-    SeverityNumber2[SeverityNumber2["TRACE4"] = 4] = "TRACE4";
-    SeverityNumber2[SeverityNumber2["DEBUG"] = 5] = "DEBUG";
-    SeverityNumber2[SeverityNumber2["DEBUG2"] = 6] = "DEBUG2";
-    SeverityNumber2[SeverityNumber2["DEBUG3"] = 7] = "DEBUG3";
-    SeverityNumber2[SeverityNumber2["DEBUG4"] = 8] = "DEBUG4";
-    SeverityNumber2[SeverityNumber2["INFO"] = 9] = "INFO";
-    SeverityNumber2[SeverityNumber2["INFO2"] = 10] = "INFO2";
-    SeverityNumber2[SeverityNumber2["INFO3"] = 11] = "INFO3";
-    SeverityNumber2[SeverityNumber2["INFO4"] = 12] = "INFO4";
-    SeverityNumber2[SeverityNumber2["WARN"] = 13] = "WARN";
-    SeverityNumber2[SeverityNumber2["WARN2"] = 14] = "WARN2";
-    SeverityNumber2[SeverityNumber2["WARN3"] = 15] = "WARN3";
-    SeverityNumber2[SeverityNumber2["WARN4"] = 16] = "WARN4";
-    SeverityNumber2[SeverityNumber2["ERROR"] = 17] = "ERROR";
-    SeverityNumber2[SeverityNumber2["ERROR2"] = 18] = "ERROR2";
-    SeverityNumber2[SeverityNumber2["ERROR3"] = 19] = "ERROR3";
-    SeverityNumber2[SeverityNumber2["ERROR4"] = 20] = "ERROR4";
-    SeverityNumber2[SeverityNumber2["FATAL"] = 21] = "FATAL";
-    SeverityNumber2[SeverityNumber2["FATAL2"] = 22] = "FATAL2";
-    SeverityNumber2[SeverityNumber2["FATAL3"] = 23] = "FATAL3";
-    SeverityNumber2[SeverityNumber2["FATAL4"] = 24] = "FATAL4";
-  })(SeverityNumber = exports.SeverityNumber || (exports.SeverityNumber = {}));
-});
-
-// node_modules/@loglayer/transport-opentelemetry/node_modules/@opentelemetry/api-logs/build/src/NoopLogger.js
-var require_NoopLogger = __commonJS((exports) => {
-  Object.defineProperty(exports, "__esModule", { value: true });
-  exports.NOOP_LOGGER = exports.NoopLogger = undefined;
-
-  class NoopLogger {
-    emit(_logRecord) {}
-  }
-  exports.NoopLogger = NoopLogger;
-  exports.NOOP_LOGGER = new NoopLogger;
-});
-
-// node_modules/@loglayer/transport-opentelemetry/node_modules/@opentelemetry/api-logs/build/src/NoopLoggerProvider.js
-var require_NoopLoggerProvider = __commonJS((exports) => {
-  Object.defineProperty(exports, "__esModule", { value: true });
-  exports.NOOP_LOGGER_PROVIDER = exports.NoopLoggerProvider = undefined;
-  var NoopLogger_1 = require_NoopLogger();
-
-  class NoopLoggerProvider {
-    getLogger(_name, _version, _options) {
-      return new NoopLogger_1.NoopLogger;
-    }
-  }
-  exports.NoopLoggerProvider = NoopLoggerProvider;
-  exports.NOOP_LOGGER_PROVIDER = new NoopLoggerProvider;
-});
-
-// node_modules/@loglayer/transport-opentelemetry/node_modules/@opentelemetry/api-logs/build/src/ProxyLogger.js
-var require_ProxyLogger = __commonJS((exports) => {
-  Object.defineProperty(exports, "__esModule", { value: true });
-  exports.ProxyLogger = undefined;
-  var NoopLogger_1 = require_NoopLogger();
-
-  class ProxyLogger {
-    constructor(_provider, name, version2, options) {
-      this._provider = _provider;
-      this.name = name;
-      this.version = version2;
-      this.options = options;
-    }
-    emit(logRecord) {
-      this._getLogger().emit(logRecord);
-    }
-    _getLogger() {
-      if (this._delegate) {
-        return this._delegate;
-      }
-      const logger = this._provider._getDelegateLogger(this.name, this.version, this.options);
-      if (!logger) {
-        return NoopLogger_1.NOOP_LOGGER;
-      }
-      this._delegate = logger;
-      return this._delegate;
-    }
-  }
-  exports.ProxyLogger = ProxyLogger;
-});
-
-// node_modules/@loglayer/transport-opentelemetry/node_modules/@opentelemetry/api-logs/build/src/ProxyLoggerProvider.js
-var require_ProxyLoggerProvider = __commonJS((exports) => {
-  Object.defineProperty(exports, "__esModule", { value: true });
-  exports.ProxyLoggerProvider = undefined;
-  var NoopLoggerProvider_1 = require_NoopLoggerProvider();
-  var ProxyLogger_1 = require_ProxyLogger();
-
-  class ProxyLoggerProvider {
-    getLogger(name, version2, options) {
-      var _a2;
-      return (_a2 = this._getDelegateLogger(name, version2, options)) !== null && _a2 !== undefined ? _a2 : new ProxyLogger_1.ProxyLogger(this, name, version2, options);
-    }
-    _getDelegate() {
-      var _a2;
-      return (_a2 = this._delegate) !== null && _a2 !== undefined ? _a2 : NoopLoggerProvider_1.NOOP_LOGGER_PROVIDER;
-    }
-    _setDelegate(delegate) {
-      this._delegate = delegate;
-    }
-    _getDelegateLogger(name, version2, options) {
-      var _a2;
-      return (_a2 = this._delegate) === null || _a2 === undefined ? undefined : _a2.getLogger(name, version2, options);
-    }
-  }
-  exports.ProxyLoggerProvider = ProxyLoggerProvider;
-});
-
-// node_modules/@loglayer/transport-opentelemetry/node_modules/@opentelemetry/api-logs/build/src/platform/node/globalThis.js
-var require_globalThis2 = __commonJS((exports) => {
-  Object.defineProperty(exports, "__esModule", { value: true });
-  exports._globalThis = undefined;
-  exports._globalThis = typeof globalThis === "object" ? globalThis : global;
-});
-
-// node_modules/@loglayer/transport-opentelemetry/node_modules/@opentelemetry/api-logs/build/src/platform/node/index.js
-var require_node2 = __commonJS((exports) => {
-  Object.defineProperty(exports, "__esModule", { value: true });
-  exports._globalThis = undefined;
-  var globalThis_1 = require_globalThis2();
-  Object.defineProperty(exports, "_globalThis", { enumerable: true, get: function() {
-    return globalThis_1._globalThis;
-  } });
-});
-
-// node_modules/@loglayer/transport-opentelemetry/node_modules/@opentelemetry/api-logs/build/src/platform/index.js
-var require_platform2 = __commonJS((exports) => {
-  Object.defineProperty(exports, "__esModule", { value: true });
-  exports._globalThis = undefined;
-  var node_1 = require_node2();
-  Object.defineProperty(exports, "_globalThis", { enumerable: true, get: function() {
-    return node_1._globalThis;
-  } });
-});
-
-// node_modules/@loglayer/transport-opentelemetry/node_modules/@opentelemetry/api-logs/build/src/internal/global-utils.js
-var require_global_utils2 = __commonJS((exports) => {
-  Object.defineProperty(exports, "__esModule", { value: true });
-  exports.API_BACKWARDS_COMPATIBILITY_VERSION = exports.makeGetter = exports._global = exports.GLOBAL_LOGS_API_KEY = undefined;
-  var platform_1 = require_platform2();
-  exports.GLOBAL_LOGS_API_KEY = Symbol.for("io.opentelemetry.js.api.logs");
-  exports._global = platform_1._globalThis;
-  function makeGetter(requiredVersion, instance, fallback) {
-    return (version2) => version2 === requiredVersion ? instance : fallback;
-  }
-  exports.makeGetter = makeGetter;
-  exports.API_BACKWARDS_COMPATIBILITY_VERSION = 1;
-});
-
-// node_modules/@loglayer/transport-opentelemetry/node_modules/@opentelemetry/api-logs/build/src/api/logs.js
-var require_logs = __commonJS((exports) => {
-  Object.defineProperty(exports, "__esModule", { value: true });
-  exports.LogsAPI = undefined;
-  var global_utils_1 = require_global_utils2();
-  var NoopLoggerProvider_1 = require_NoopLoggerProvider();
-  var ProxyLoggerProvider_1 = require_ProxyLoggerProvider();
-
-  class LogsAPI {
-    constructor() {
-      this._proxyLoggerProvider = new ProxyLoggerProvider_1.ProxyLoggerProvider;
-    }
-    static getInstance() {
-      if (!this._instance) {
-        this._instance = new LogsAPI;
-      }
-      return this._instance;
-    }
-    setGlobalLoggerProvider(provider) {
-      if (global_utils_1._global[global_utils_1.GLOBAL_LOGS_API_KEY]) {
-        return this.getLoggerProvider();
-      }
-      global_utils_1._global[global_utils_1.GLOBAL_LOGS_API_KEY] = (0, global_utils_1.makeGetter)(global_utils_1.API_BACKWARDS_COMPATIBILITY_VERSION, provider, NoopLoggerProvider_1.NOOP_LOGGER_PROVIDER);
-      this._proxyLoggerProvider._setDelegate(provider);
-      return provider;
-    }
-    getLoggerProvider() {
-      var _a2, _b;
-      return (_b = (_a2 = global_utils_1._global[global_utils_1.GLOBAL_LOGS_API_KEY]) === null || _a2 === undefined ? undefined : _a2.call(global_utils_1._global, global_utils_1.API_BACKWARDS_COMPATIBILITY_VERSION)) !== null && _b !== undefined ? _b : this._proxyLoggerProvider;
-    }
-    getLogger(name, version2, options) {
-      return this.getLoggerProvider().getLogger(name, version2, options);
-    }
-    disable() {
-      delete global_utils_1._global[global_utils_1.GLOBAL_LOGS_API_KEY];
-      this._proxyLoggerProvider = new ProxyLoggerProvider_1.ProxyLoggerProvider;
-    }
-  }
-  exports.LogsAPI = LogsAPI;
-});
-
-// node_modules/@loglayer/transport-opentelemetry/node_modules/@opentelemetry/api-logs/build/src/index.js
-var require_src2 = __commonJS((exports) => {
-  Object.defineProperty(exports, "__esModule", { value: true });
-  exports.logs = exports.ProxyLoggerProvider = exports.ProxyLogger = exports.NoopLoggerProvider = exports.NOOP_LOGGER_PROVIDER = exports.NoopLogger = exports.NOOP_LOGGER = exports.SeverityNumber = undefined;
-  var LogRecord_1 = require_LogRecord();
-  Object.defineProperty(exports, "SeverityNumber", { enumerable: true, get: function() {
-    return LogRecord_1.SeverityNumber;
-  } });
-  var NoopLogger_1 = require_NoopLogger();
-  Object.defineProperty(exports, "NOOP_LOGGER", { enumerable: true, get: function() {
-    return NoopLogger_1.NOOP_LOGGER;
-  } });
-  Object.defineProperty(exports, "NoopLogger", { enumerable: true, get: function() {
-    return NoopLogger_1.NoopLogger;
-  } });
-  var NoopLoggerProvider_1 = require_NoopLoggerProvider();
-  Object.defineProperty(exports, "NOOP_LOGGER_PROVIDER", { enumerable: true, get: function() {
-    return NoopLoggerProvider_1.NOOP_LOGGER_PROVIDER;
-  } });
-  Object.defineProperty(exports, "NoopLoggerProvider", { enumerable: true, get: function() {
-    return NoopLoggerProvider_1.NoopLoggerProvider;
-  } });
-  var ProxyLogger_1 = require_ProxyLogger();
-  Object.defineProperty(exports, "ProxyLogger", { enumerable: true, get: function() {
-    return ProxyLogger_1.ProxyLogger;
-  } });
-  var ProxyLoggerProvider_1 = require_ProxyLoggerProvider();
-  Object.defineProperty(exports, "ProxyLoggerProvider", { enumerable: true, get: function() {
-    return ProxyLoggerProvider_1.ProxyLoggerProvider;
-  } });
-  var logs_1 = require_logs();
-  exports.logs = logs_1.LogsAPI.getInstance();
-});
-
 // src/commands/market-data-vendor-backfill.ts
 import { createHash as createHash5, randomUUID as randomUUID2 } from "node:crypto";
 import path2 from "node:path";
@@ -22254,102 +22019,6 @@ var BaseTransport = class {
     return this.logger;
   }
 };
-var LoggerlessTransport = class {
-  id;
-  enabled;
-  level;
-  consoleDebug;
-  constructor(config2) {
-    this.id = Date.now().toString() + Math.random().toString();
-    this.enabled = config2.enabled ?? true;
-    this.consoleDebug = config2.consoleDebug ?? false;
-    this.level = config2.level ?? "trace";
-  }
-  _sendToLogger(params) {
-    if (!this.enabled)
-      return;
-    if (LogLevelPriority[params.logLevel] < LogLevelPriority[this.level])
-      return;
-    const messages = this.shipToLogger(params);
-    if (this.consoleDebug)
-      switch (params.logLevel) {
-        case LogLevel.info:
-          console.info(...messages);
-          break;
-        case LogLevel.warn:
-          console.warn(...messages);
-          break;
-        case LogLevel.error:
-          console.error(...messages);
-          break;
-        case LogLevel.trace:
-          console.debug(...messages);
-          break;
-        case LogLevel.debug:
-          console.debug(...messages);
-          break;
-        case LogLevel.fatal:
-          console.debug(...messages);
-          break;
-        default:
-          console.log(...messages);
-      }
-  }
-  getLoggerInstance() {
-    throw new Error("This transport does not have a logger instance");
-  }
-};
-
-// node_modules/@loglayer/transport-opentelemetry/dist/index.mjs
-var import_api_logs = __toESM(require_src2(), 1);
-var logLayerLevels = {
-  fatal: import_api_logs.SeverityNumber.FATAL,
-  error: import_api_logs.SeverityNumber.ERROR,
-  warn: import_api_logs.SeverityNumber.WARN,
-  info: import_api_logs.SeverityNumber.INFO,
-  debug: import_api_logs.SeverityNumber.DEBUG,
-  trace: import_api_logs.SeverityNumber.TRACE
-};
-function getSeverityNumber(level) {
-  return logLayerLevels[level] ?? import_api_logs.SeverityNumber.TRACE;
-}
-function emitLogRecord(record2, logger) {
-  const { message, level, ...splat } = record2;
-  const attributes = {};
-  for (const key in splat)
-    if (Object.hasOwn(splat, key))
-      attributes[key] = splat[key];
-  const logRecord = {
-    severityNumber: getSeverityNumber(level),
-    severityText: level,
-    body: message,
-    attributes
-  };
-  logger.emit(logRecord);
-}
-var OpenTelemetryTransport = class extends LoggerlessTransport {
-  _logger;
-  onError;
-  constructor(config2 = {}) {
-    super(config2);
-    this._logger = import_api_logs.logs.getLogger("loglayer");
-    this.onError = config2.onError;
-  }
-  shipToLogger({ logLevel, messages, data, hasData }) {
-    const assembled = {
-      level: logLevel,
-      message: messages.join(" "),
-      ...hasData ? data : {}
-    };
-    try {
-      emitLogRecord(assembled, this._logger);
-    } catch (error48) {
-      if (this.onError)
-        this.onError(error48);
-    }
-    return [assembled];
-  }
-};
 
 // node_modules/@loglayer/transport-tslog/dist/index.js
 var TsLogTransport = class extends BaseTransport {
@@ -24521,13 +24190,7 @@ var tslogLogger = new Logger({
   minLevel: process.env.LOG_LEVEL === "debug" ? 0 : 3
 });
 var baseLogger = new LogLayer({
-  transport: [
-    new TsLogTransport({ id: "tslog", logger: tslogLogger }),
-    new OpenTelemetryTransport({
-      id: "otel",
-      enabled: true
-    })
-  ],
+  transport: [new TsLogTransport({ id: "tslog", logger: tslogLogger })],
   plugins: [openTelemetryPlugin()],
   errorSerializer: serializeError
 });
@@ -25642,12 +25305,14 @@ var result_schema_default = {
 };
 
 // src/helpers/market-data-vendor-backfill/manifests.ts
-var CAPABILITY_POLICY_ID = "market-data-vendor-backfill-capabilities/v1";
-var RESOURCE_POLICY_ID = "market-data-vendor-backfill-resources/v1";
+var LEGACY_CAPABILITY_POLICY_ID = "market-data-vendor-backfill-capabilities/v1";
+var CAPABILITY_POLICY_ID = "market-data-vendor-backfill-capabilities/v2";
+var LEGACY_RESOURCE_POLICY_ID = "market-data-vendor-backfill-resources/v1";
+var RESOURCE_POLICY_ID = "market-data-vendor-backfill-resources/v2";
 var ADAPTER_POLICY_ID = "cryptohftdata-orderbook-adapter/v1";
 var ACQUISITION_POLICY_ID = "cryptohftdata-hourly-acquisition/v1";
-var capabilityPolicyContent = {
-  policy_id: CAPABILITY_POLICY_ID,
+var legacyCapabilityPolicyContent = {
+  policy_id: LEGACY_CAPABILITY_POLICY_ID,
   provider: "cryptohftdata",
   adapter_policy: {
     policy_id: ADAPTER_POLICY_ID,
@@ -25673,12 +25338,37 @@ var capabilityPolicyContent = {
     }
   ]
 };
+var LEGACY_CAPABILITY_POLICY = Object.freeze({
+  ...legacyCapabilityPolicyContent,
+  policy_sha256: jcsSha256(legacyCapabilityPolicyContent)
+});
+var capabilityPolicyContent = {
+  ...legacyCapabilityPolicyContent,
+  policy_id: CAPABILITY_POLICY_ID,
+  profiles: [
+    ...legacyCapabilityPolicyContent.profiles.map((profile) => ({
+      ...profile,
+      source_policies: ["authoritative_window", "fill_gaps"]
+    })),
+    {
+      exchange: "okx",
+      market_type: "spot",
+      feed: "ORDERBOOK",
+      canonical_trading_pair: "ARB-USDC",
+      provider_exchange_id: "okx_spot",
+      resolved_symbol: "ARB-USDC",
+      construction_modes: ["sampled_top_n_snapshot"],
+      source_policies: ["authoritative_window", "fill_gaps"],
+      max_depth: 400
+    }
+  ]
+};
 var CAPABILITY_POLICY = Object.freeze({
   ...capabilityPolicyContent,
   policy_sha256: jcsSha256(capabilityPolicyContent)
 });
-var resourcePolicyContent = {
-  policy_id: RESOURCE_POLICY_ID,
+var legacyResourcePolicyContent = {
+  policy_id: LEGACY_RESOURCE_POLICY_ID,
   limits: {
     max_files: 1e4,
     max_bytes: 100 * 1024 * 1024 * 1024,
@@ -25692,17 +25382,29 @@ var resourcePolicyContent = {
     max_required_events: 1e5
   }
 };
+var LEGACY_RESOURCE_POLICY = Object.freeze({
+  ...legacyResourcePolicyContent,
+  policy_sha256: jcsSha256(legacyResourcePolicyContent)
+});
+var resourcePolicyContent = {
+  ...legacyResourcePolicyContent,
+  policy_id: RESOURCE_POLICY_ID,
+  request_bounds: {
+    ...legacyResourcePolicyContent.request_bounds,
+    max_window_ms: 31 * 24 * 60 * 60 * 1000
+  }
+};
 var RESOURCE_POLICY = Object.freeze({
   ...resourcePolicyContent,
   policy_sha256: jcsSha256(resourcePolicyContent)
 });
 var EFFECTIVE_ADAPTER_POLICY_PIN = Object.freeze({
   policy_id: ADAPTER_POLICY_ID,
-  policy_sha256: jcsSha256(capabilityPolicyContent.adapter_policy)
+  policy_sha256: jcsSha256(legacyCapabilityPolicyContent.adapter_policy)
 });
 var EFFECTIVE_ACQUISITION_POLICY_PIN = Object.freeze({
   policy_id: ACQUISITION_POLICY_ID,
-  policy_sha256: jcsSha256(capabilityPolicyContent.acquisition_policy)
+  policy_sha256: jcsSha256(legacyCapabilityPolicyContent.acquisition_policy)
 });
 var schemaArtifacts = [
   ["schemas/request.schema.json", request_schema_default],
@@ -25866,7 +25568,15 @@ var backfillRequestCodec = {
     if (request.idempotency_key !== createBackfillIdempotencyKey(request)) {
       throw new Error("idempotency_key does not match canonical business fields");
     }
-    if (request.product_pins.capability_policy.policy_id !== CAPABILITY_POLICY.policy_id || request.product_pins.capability_policy.policy_sha256 !== CAPABILITY_POLICY.policy_sha256 || request.product_pins.resource_policy.policy_id !== RESOURCE_POLICY.policy_id || request.product_pins.resource_policy.policy_sha256 !== RESOURCE_POLICY.policy_sha256) {
+    const capabilityPolicyMatches = [
+      CAPABILITY_POLICY,
+      LEGACY_CAPABILITY_POLICY
+    ].some((policy) => request.product_pins.capability_policy.policy_id === policy.policy_id && request.product_pins.capability_policy.policy_sha256 === policy.policy_sha256);
+    const resourcePolicyMatches = [
+      RESOURCE_POLICY,
+      LEGACY_RESOURCE_POLICY
+    ].some((policy) => request.product_pins.resource_policy.policy_id === policy.policy_id && request.product_pins.resource_policy.policy_sha256 === policy.policy_sha256);
+    if (!capabilityPolicyMatches || !resourcePolicyMatches) {
       throw new Error("request policy pins do not match the effective package policies");
     }
     if (request.required_clock.clock_id !== request.initial_selection.required_clock.clock_id || request.required_clock.clock_sha256 !== request.initial_selection.required_clock.clock_sha256 || request.required_clock.event_count !== request.initial_selection.required_clock.event_count) {
@@ -25981,6 +25691,10 @@ function decodeBackfillRunDocuments(input) {
     return targetTimeMs;
   });
   const capabilityProfile = CAPABILITY_POLICY.profiles.find((profile) => profile.exchange === wire.scope.exchange && profile.market_type === wire.scope.market_type && profile.feed === wire.scope.feed && profile.canonical_trading_pair === wire.scope.trading_pair);
+  const resourcePolicy = [RESOURCE_POLICY, LEGACY_RESOURCE_POLICY].find((policy) => wire.product_pins.resource_policy.policy_id === policy.policy_id && wire.product_pins.resource_policy.policy_sha256 === policy.policy_sha256);
+  if (!resourcePolicy) {
+    throw new Error("request resource policy pin is unsupported");
+  }
   return {
     schemaVersion: BACKFILL_REQUEST_SCHEMA_VERSION,
     requestId: wire.request_id,
@@ -26005,11 +25719,11 @@ function decodeBackfillRunDocuments(input) {
     maxPriorAsOfLagMs: wire.coverage_policy.max_asof_lag_ms,
     sourcePolicy: wire.source_policy,
     budgets: {
-      maxFiles: RESOURCE_POLICY.limits.max_files,
-      maxBytes: RESOURCE_POLICY.limits.max_bytes,
-      maxRows: RESOURCE_POLICY.limits.max_rows,
-      maxDurationMs: RESOURCE_POLICY.limits.max_duration_ms,
-      maxBoundaryLookbackMs: Math.min(RESOURCE_POLICY.limits.max_boundary_lookback_ms, CAPABILITY_POLICY.acquisition_policy.initialization_lookback_ms)
+      maxFiles: resourcePolicy.limits.max_files,
+      maxBytes: resourcePolicy.limits.max_bytes,
+      maxRows: resourcePolicy.limits.max_rows,
+      maxDurationMs: resourcePolicy.limits.max_duration_ms,
+      maxBoundaryLookbackMs: Math.min(resourcePolicy.limits.max_boundary_lookback_ms, CAPABILITY_POLICY.acquisition_policy.initialization_lookback_ms)
     },
     expectedProduct: {
       packageName: "@usherlabs/cex-broker",
@@ -27319,12 +27033,13 @@ function assertStoredSelectionMatchesRequest(request, selection) {
   }
 }
 function eligibleBundles(request, bundles) {
-  return bundles.filter((bundle) => {
-    if (bundle.captureOrigin === "production_capture") {
-      return request.sourcePolicy === "fill_gaps";
-    }
-    return bundle.qualification?.state === "qualified";
-  });
+  const qualifiedVendorBundles = bundles.filter((bundle) => bundle.captureOrigin === "vendor_historical_backfill" && bundle.qualification?.state === "qualified");
+  const productionBundles = bundles.filter((bundle) => bundle.captureOrigin === "production_capture");
+  if (request.sourcePolicy === "authoritative_window") {
+    const vendorSupport = chooseSupport(request, qualifiedVendorBundles);
+    return vendorSupport.length === request.requiredClockTargetsMs.length ? qualifiedVendorBundles : productionBundles;
+  }
+  return [...productionBundles, ...qualifiedVendorBundles];
 }
 function originPriority(request, origin) {
   if (request.sourcePolicy === "fill_gaps") {
@@ -27512,9 +27227,8 @@ function exactCandidateMatch(expected, actual) {
 function requestedShapeMatches(request, rows) {
   return rows.every(({ row }) => row.depth_limit === request.depth && row.construction_mode === request.constructionMode && row.schema_version === request.expectedProduct.canonicalSchemaVersion);
 }
-function requiredClockCoverage(request, rows) {
-  const summaryTimes = rows.filter(({ table }) => table === "market_data.cex_order_book_depth_summary").map(({ row }) => {
-    const value = row.source_time_ms;
+function requiredClockCoverage(request, rows, coverageSourceTimesMs) {
+  const summaryTimes = (coverageSourceTimesMs ?? rows.filter(({ table }) => table === "market_data.cex_order_book_depth_summary").map(({ row }) => row.source_time_ms)).map((value) => {
     if (typeof value !== "number" && (typeof value !== "string" || !/^\d+$/.test(value))) {
       return;
     }
@@ -27587,7 +27301,7 @@ function verifySemanticPromotion(evidence) {
       coverageVerified: false
     };
   }
-  const coverageVerified = requiredClockCoverage(evidence.request, evidence.candidateRows);
+  const coverageVerified = requiredClockCoverage(evidence.request, evidence.candidateRows, evidence.coverageSourceTimesMs);
   if (!coverageVerified) {
     return {
       ...base,
@@ -27962,7 +27676,13 @@ class QualifiedOrderBookArchiveReader {
       suffixDigestBefore: baseline.verificationBaseline.suffixDigest,
       suffixDigestAfter: timelineDigest(suffix),
       seamVerified: this.seamIsOrdered(queriedRows),
-      exporterCompatible: queriedRows.every(({ row }) => typeof row.capture_bundle_id === "string" && typeof row.normalized_row_checksum === "string")
+      exporterCompatible: queriedRows.every(({ row }) => typeof row.capture_bundle_id === "string" && typeof row.normalized_row_checksum === "string"),
+      ...request.sourcePolicy === "fill_gaps" ? {
+        coverageSourceTimesMs: [
+          ...baseline.selection.support_anchors.map((anchor) => Date.parse(anchor.source_time)),
+          ...summaries.map((row) => numberField(row, "source_time_ms"))
+        ]
+      } : {}
     });
     return { ...semantic, captureBundleId };
   }
@@ -28078,388 +27798,8 @@ function buildForwarderBatches(input) {
   return batches;
 }
 
-// src/helpers/market-data-vendor-backfill/qualification.ts
-var UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/;
-var SHA256 = /^[0-9a-f]{64}$/;
-var REASON = /^[a-z][a-z0-9_]{0,127}$/;
-var EVENT_FIELDS = new Set([
-  "qualification_event_id",
-  "capture_bundle_id",
-  "state",
-  "receipt_id",
-  "promotion_identity_sha256",
-  "window",
-  "event_at",
-  "reason_code"
-]);
-function deterministicUuid(value) {
-  const digest = jcsSha256(value).slice(0, 32).split("");
-  digest[12] = "5";
-  digest[16] = "8";
-  const hex3 = digest.join("");
-  return `${hex3.slice(0, 8)}-${hex3.slice(8, 12)}-${hex3.slice(12, 16)}-${hex3.slice(16, 20)}-${hex3.slice(20)}`;
-}
-function semanticEvent(event) {
-  const { qualification_event_id: _eventId, ...semantic } = event;
-  return semantic;
-}
-function assertTimestamp(value, field) {
-  const parsed = Date.parse(value);
-  if (!Number.isSafeInteger(parsed) || new Date(parsed).toISOString() !== value) {
-    throw new Error(`${field} must be a fixed UTC RFC3339 timestamp`);
-  }
-  return parsed;
-}
-function parseQualificationEvent(value) {
-  if (!value || typeof value !== "object" || Array.isArray(value)) {
-    throw new Error("qualification event must be an object");
-  }
-  const event = value;
-  if (Object.keys(event).length !== EVENT_FIELDS.size || !Object.keys(event).every((field) => EVENT_FIELDS.has(field)) || !UUID.test(event.qualification_event_id) || !SHA256.test(event.capture_bundle_id) || !["qualified", "quarantined", "revoked"].includes(event.state) || !SHA256.test(event.receipt_id) || !SHA256.test(event.promotion_identity_sha256) || !event.window || typeof event.window !== "object" || Object.keys(event.window).length !== 2 || !REASON.test(event.reason_code)) {
-    throw new Error("qualification event fields are invalid");
-  }
-  if (assertTimestamp(event.window.end_at, "window.end_at") <= assertTimestamp(event.window.start_at, "window.start_at")) {
-    throw new Error("qualification window must be increasing");
-  }
-  assertTimestamp(event.event_at, "event_at");
-  if (deterministicUuid(semanticEvent(event)) !== event.qualification_event_id) {
-    throw new Error("qualification_event_id does not match event content");
-  }
-  return event;
-}
-function finalizeQualificationEvent(event) {
-  const semantic = semanticEvent(event);
-  return parseQualificationEvent({
-    ...semantic,
-    qualification_event_id: deterministicUuid(semantic)
-  });
-}
-function qualificationEventToArchiveRow(eventInput) {
-  const event = parseQualificationEvent(eventInput);
-  return {
-    table: "market_data.cex_order_book_capture_qualifications",
-    row: {
-      source: "external_backfill",
-      capture_origin: "vendor_historical_backfill",
-      source_mode: "vendor_historical_backfill_v1",
-      deployment_id: "market-data-vendor-backfill",
-      qualification_event_id: event.qualification_event_id,
-      capture_bundle_id: event.capture_bundle_id,
-      state: event.state,
-      receipt_id: event.receipt_id,
-      promotion_identity_sha256: event.promotion_identity_sha256,
-      window_start_ms: Date.parse(event.window.start_at),
-      window_end_ms: Date.parse(event.window.end_at),
-      event_at_ms: Date.parse(event.event_at),
-      reason_code: event.reason_code,
-      event_json: jcsCanonicalize(event)
-    }
-  };
-}
-
-// src/helpers/market-data-vendor-backfill/core.ts
-function outcome(request, status, reasonCode, extra = {}) {
-  return {
-    status,
-    reasonCode,
-    ...request ? {
-      requestId: request.requestId,
-      idempotencyKey: request.idempotencyKey,
-      ...request.target ? { target: request.target } : {}
-    } : {},
-    ...extra
-  };
-}
-function captureBundleId(request, capability, dataset) {
-  return sha256Canonical({
-    request_business_identity: request.idempotencyKey,
-    provider: capability.provider,
-    provider_exchange_id: capability.providerExchangeId,
-    resolved_symbol: capability.resolvedSymbol,
-    adapter_version: capability.adapterVersion,
-    objects: dataset.objects.map(({ identity, checksum, bytes, rows }) => ({
-      identity,
-      checksum,
-      bytes,
-      rows
-    })),
-    canonical_schema_version: request.expectedProduct.canonicalSchemaVersion,
-    checksum_algorithm: request.expectedProduct.checksumAlgorithm
-  });
-}
-function buildPromotionReceipt(request, capability, normalized, verification, verificationTimeMs) {
-  if (!request.wire || !request.initialSelection || !request.expectedCanonicalSchema || !request.coveragePolicy || !request.productPins) {
-    throw new Error("decoded final-v1 request context is missing");
-  }
-  return finalizePromotionReceipt({
-    schema_id: PROMOTION_RECEIPT_SCHEMA_ID,
-    verified_at: new Date(verificationTimeMs).toISOString(),
-    request_id: request.requestId,
-    idempotency_key: request.idempotencyKey,
-    source: EXTERNAL_BACKFILL_SOURCE,
-    capture_origin: "vendor_historical_backfill",
-    source_mode: "vendor_historical_backfill_v1",
-    provider: capability.provider,
-    adapter_version: capability.adapterVersion,
-    effective_policies: {
-      capability_policy: request.productPins.capability_policy,
-      resource_policy: request.productPins.resource_policy,
-      adapter_policy: EFFECTIVE_ADAPTER_POLICY_PIN,
-      acquisition_policy: EFFECTIVE_ACQUISITION_POLICY_PIN
-    },
-    capture_bundle_id: normalized.captureBundleId,
-    scope: request.wire.scope,
-    window: request.wire.window,
-    depth: request.depth,
-    construction_mode: request.constructionMode,
-    canonical_schema: request.expectedCanonicalSchema,
-    coverage_policy: request.coveragePolicy,
-    selection_sha256: request.initialSelection.selection_sha256,
-    vendor_semantic_digest: normalized.vendorSemanticDigest,
-    canonical_semantic_digest: verification.canonicalSemanticDigest,
-    prefix_digest: verification.prefixDigest,
-    suffix_digest: verification.suffixDigest,
-    seam_verified: true,
-    coverage_verified: true,
-    dataset_objects: normalized.objects
-  });
-}
-async function submitAll(dependencies, batches) {
-  const maxAttempts = Math.max(1, Math.min(10, dependencies.retry?.maxAttempts ?? 3));
-  for (const batch of batches) {
-    let accepted = false;
-    for (let attempt = 1;attempt <= maxAttempts; attempt += 1) {
-      try {
-        const response = await dependencies.forwarder.submit(batch);
-        accepted = response.ok && response.inserted === batch.rows.length;
-      } catch {
-        accepted = false;
-      }
-      if (accepted)
-        break;
-      if (attempt < maxAttempts)
-        await dependencies.retry?.wait?.(attempt);
-    }
-    if (!accepted)
-      return false;
-  }
-  return true;
-}
-function stableFailureReason(error48, fallback) {
-  if (error48 && typeof error48 === "object") {
-    const reason = error48.reason;
-    if (typeof reason === "string" && /^[a-z][a-z0-9_]{0,127}$/.test(reason)) {
-      return reason;
-    }
-  }
-  return fallback;
-}
-function assertArchivePreflight(request, resolution) {
-  if (!request.target || !request.productionAuthorizationId) {
-    throw new Error("request target or production authorization ID is missing");
-  }
-  const selection = archiveSelectionCodec.decode(resolution.selection);
-  const receipts = resolution.receipts.map((receipt) => promotionReceiptCodec.decode(receipt));
-  const receiptById = new Map;
-  for (const receipt of receipts) {
-    const existing = receiptById.get(receipt.receipt_id);
-    if (existing && jcsCanonicalize(existing) !== jcsCanonicalize(receipt)) {
-      throw new Error("stored receipt identity has conflicting content");
-    }
-    receiptById.set(receipt.receipt_id, receipt);
-  }
-  for (const bundle of selection.bundles) {
-    if (bundle.capture_origin === "vendor_historical_backfill" && (!bundle.qualification || !receiptById.has(bundle.qualification.receipt_id))) {
-      throw new Error("vendor selection lacks its validated stored receipt");
-    }
-  }
-  if (resolution.readerIdentity.environment !== request.target.environment || resolution.readerIdentity.cluster !== request.target.cluster) {
-    throw new Error("archive reader cluster identity mismatch");
-  }
-}
-function assertForwarderPreflight(request, resolution, nowMs) {
-  if (!request.target || !request.productionAuthorizationId) {
-    throw new Error("request target or production authorization ID is missing");
-  }
-  if (resolution.forwarderIdentity.environment !== request.target.environment || resolution.forwarderIdentity.cluster !== request.target.cluster) {
-    throw new Error("archive forwarder cluster identity mismatch");
-  }
-  const authorization = resolution.authorization;
-  const expiresAtMs = Date.parse(authorization.expiresAt);
-  if (authorization.authorizationId !== request.productionAuthorizationId || authorization.scope !== "production" || authorization.environment !== request.target.environment || authorization.cluster !== request.target.cluster || authorization.credentialValidated !== true || !Number.isSafeInteger(expiresAtMs) || new Date(expiresAtMs).toISOString() !== authorization.expiresAt || expiresAtMs <= nowMs) {
-    throw new Error("production forwarder authorization is invalid");
-  }
-}
-function resourcePolicyScopeExceeded(request) {
-  return request.depth > RESOURCE_POLICY.request_bounds.max_depth || request.window.endTimeMs - request.window.startTimeMs > RESOURCE_POLICY.request_bounds.max_window_ms || request.requiredClockTargetsMs.length > RESOURCE_POLICY.request_bounds.max_required_events;
-}
-function storedReceiptForSelection(resolution) {
-  const receiptId = resolution.selection.receipt_ids[0];
-  return receiptId ? resolution.receipts.find((receipt) => receipt.receipt_id === receiptId) : undefined;
-}
-async function runMarketDataVendorBackfill(input, dependencies) {
-  let request;
-  try {
-    const documents = input;
-    request = decodeBackfillRunDocuments({
-      request: documents.request,
-      requiredClock: documents.requiredClock
-    });
-  } catch {
-    return outcome(undefined, "request_invalid", "request_invalid");
-  }
-  let initialResolution;
-  try {
-    initialResolution = await dependencies.archive.resolveSelection(request);
-    assertArchivePreflight(request, initialResolution);
-    const forwarderPreflight = await dependencies.forwarder.preflight({
-      authorizationId: request.productionAuthorizationId,
-      target: request.target
-    });
-    assertForwarderPreflight(request, forwarderPreflight, dependencies.clock.nowMs());
-  } catch {
-    return outcome(request, "archive_preflight_failed", "archive_preflight_failed");
-  }
-  if (initialResolution.selection.coverage_class === "complete") {
-    const receipt2 = storedReceiptForSelection(initialResolution);
-    return outcome(request, "already_covered", "qualified_coverage_complete", {
-      selection: initialResolution.selection,
-      ...receipt2 ? { receipt: receipt2 } : {}
-    });
-  }
-  if (resourcePolicyScopeExceeded(request)) {
-    return outcome(request, "capability_unsupported", "capability_unsupported", { reasonSubcode: "resource_policy_scope_exceeded" });
-  }
-  let capability;
-  try {
-    capability = dependencies.providers.capabilityFor(request);
-  } catch {
-    return outcome(request, "capability_unsupported", "capability_probe_failed");
-  }
-  if (!capability) {
-    return outcome(request, "capability_unsupported", "scope_unsupported");
-  }
-  if (!request.providerPolicy.allowedAdapterVersions.includes(capability.adapterVersion)) {
-    return outcome(request, "capability_unsupported", "adapter_version_unpinned");
-  }
-  let credential;
-  try {
-    credential = await dependencies.credentials.resolve(capability.provider);
-  } catch {
-    return outcome(request, "credentials_missing", "credential_resolution_failed");
-  }
-  if (credential === undefined || credential === null) {
-    return outcome(request, "credentials_missing", "provider_credentials_missing");
-  }
-  let dataset;
-  let normalized;
-  try {
-    dataset = await dependencies.providers.acquire(request, capability, credential);
-    const bundleId = captureBundleId(request, capability, dataset);
-    normalized = await dependencies.providers.normalize(request, capability, dataset, bundleId);
-    if (normalized.captureBundleId !== bundleId) {
-      return outcome(request, "vendor_fetch_failed", "vendor_fetch_failed", {
-        reasonSubcode: "capture_identity_mismatch"
-      });
-    }
-  } catch (error48) {
-    const reason = stableFailureReason(error48, "provider_dataset_invalid");
-    return outcome(request, "vendor_fetch_failed", "vendor_fetch_failed", {
-      reasonSubcode: reason.startsWith("budget_") ? "resource_limit_exceeded" : reason
-    });
-  }
-  try {
-    const candidateBatches = buildForwarderBatches({
-      captureBundleId: normalized.captureBundleId,
-      deploymentId: "market-data-vendor-backfill",
-      rows: normalized.rows
-    });
-    if (!await submitAll(dependencies, candidateBatches)) {
-      return outcome(request, "archive_ingest_failed", "candidate_batch_rejected");
-    }
-  } catch {
-    return outcome(request, "archive_ingest_failed", "candidate_submission_failed");
-  }
-  let verification;
-  try {
-    verification = await dependencies.archive.verifyCandidate(request, normalized, normalized.captureBundleId, initialResolution);
-  } catch {
-    return outcome(request, "promotion_verification_failed", "candidate_query_failed");
-  }
-  if (!verification.passed || verification.captureBundleId !== normalized.captureBundleId || verification.canonicalSemanticDigest !== normalized.canonicalSemanticDigest || !verification.seamVerified || !verification.coverageVerified) {
-    return outcome(request, "promotion_verification_failed", verification.reasonCode ?? "semantic_verification_failed");
-  }
-  let receipt;
-  try {
-    receipt = buildPromotionReceipt(request, capability, normalized, verification, dependencies.clock.nowMs());
-    const [batch] = buildForwarderBatches({
-      captureBundleId: normalized.captureBundleId,
-      deploymentId: "market-data-vendor-backfill",
-      rows: [promotionReceiptToArchiveRow(receipt)]
-    });
-    if (!batch || !await submitAll(dependencies, [batch])) {
-      return outcome(request, "archive_ingest_failed", "promotion_commit_failed");
-    }
-    const qualification = finalizeQualificationEvent({
-      capture_bundle_id: receipt.capture_bundle_id,
-      state: "qualified",
-      receipt_id: receipt.receipt_id,
-      promotion_identity_sha256: receipt.promotion_identity_sha256,
-      window: receipt.window,
-      event_at: receipt.verified_at,
-      reason_code: "promotion_verified"
-    });
-    const [qualificationBatch] = buildForwarderBatches({
-      captureBundleId: normalized.captureBundleId,
-      deploymentId: "market-data-vendor-backfill",
-      rows: [qualificationEventToArchiveRow(qualification)]
-    });
-    if (!qualificationBatch || !await submitAll(dependencies, [qualificationBatch])) {
-      return outcome(request, "archive_ingest_failed", "qualification_commit_failed", { receipt });
-    }
-  } catch {
-    return outcome(request, "archive_ingest_failed", "promotion_commit_failed");
-  }
-  let finalResolution;
-  try {
-    finalResolution = await dependencies.archive.resolveSelection(request);
-    assertArchivePreflight(request, finalResolution);
-  } catch (error48) {
-    return outcome(request, "promotion_verification_failed", "post_promotion_selection_failed", {
-      receipt,
-      reasonSubcode: stableFailureReason(error48, "archive_selection_resolution_failed")
-    });
-  }
-  if (finalResolution.selection.coverage_class !== "complete") {
-    return outcome(request, "promotion_verification_failed", "qualified_coverage_incomplete", { receipt, selection: finalResolution.selection });
-  }
-  if (finalResolution.selection.bundles.some((bundle) => bundle.capture_bundle_id === receipt.capture_bundle_id && bundle.capture_origin === "vendor_historical_backfill" && bundle.qualification?.receipt_id === receipt.receipt_id) === false) {
-    return outcome(request, "promotion_verification_failed", "promoted_receipt_not_selected", { receipt, selection: finalResolution.selection });
-  }
-  try {
-    if (!request.wire)
-      throw new Error("decoded request wire is missing");
-    const [selectionBatch] = buildForwarderBatches({
-      captureBundleId: receipt.capture_bundle_id,
-      deploymentId: "market-data-vendor-backfill",
-      rows: [
-        archiveSelectionToArchiveRow(request.wire, finalResolution.selection)
-      ]
-    });
-    if (!selectionBatch || !await submitAll(dependencies, [selectionBatch])) {
-      return outcome(request, "archive_ingest_failed", "selection_persistence_failed", { receipt, selection: finalResolution.selection });
-    }
-  } catch {
-    return outcome(request, "archive_ingest_failed", "selection_persistence_failed", { receipt, selection: finalResolution.selection });
-  }
-  return outcome(request, "promoted", "promotion_qualified", {
-    receipt,
-    selection: finalResolution.selection
-  });
-}
-
-// src/helpers/market-data-vendor-backfill/cryptohftdata.ts
-import { createHash as createHash4 } from "node:crypto";
+// src/helpers/market-data-vendor-backfill/cryptohftdata.ts
+import { createHash as createHash4 } from "node:crypto";
 
 // node_modules/fzstd/esm/index.mjs
 var ab = ArrayBuffer;
@@ -32458,7 +31798,23 @@ var CRYPTOHFTDATA_OKX_SPOT_ARBUSDT_PROFILE = Object.freeze({
   snapshotGrouping: "event_time_final_update_id_object",
   sequenceSemantics: "okx_seq_id_prev_seq_id",
   constructionModes: ["sampled_top_n_snapshot"],
-  sourcePolicies: ["authoritative_window"]
+  sourcePolicies: ["authoritative_window", "fill_gaps"]
+});
+var CRYPTOHFTDATA_OKX_SPOT_ARBUSDC_PROFILE = Object.freeze({
+  profileId: "cryptohftdata/okx_spot/ARB-USDC/v1",
+  exchange: "okx",
+  tradingPair: "ARB-USDC",
+  sourceSymbol: "ARB-USDC",
+  marketType: "spot",
+  providerExchangeId: "okx_spot",
+  historyStartMs: CRYPTOHFTDATA_HISTORY_START_MS,
+  maxDepth: 400,
+  eventTimeUnit: "milliseconds",
+  receivedTimeUnit: "nanoseconds",
+  snapshotGrouping: "event_time_final_update_id_object",
+  sequenceSemantics: "okx_seq_id_prev_seq_id",
+  constructionModes: ["sampled_top_n_snapshot"],
+  sourcePolicies: ["authoritative_window", "fill_gaps"]
 });
 
 class CryptoHftDataError extends Error {
@@ -32469,498 +31825,916 @@ class CryptoHftDataError extends Error {
     this.name = "CryptoHftDataError";
   }
 }
-function cryptoHftDataCapabilityFor(request, profiles = []) {
-  if (request.providerPolicy.provider !== "cryptohftdata" || request.scope.feed !== "ORDERBOOK" || request.scope.exchange.trim().toLowerCase() === "mexc") {
-    return;
-  }
-  const profile = profiles.find((candidate) => candidate.exchange === request.scope.exchange.trim().toLowerCase() && candidate.tradingPair === request.scope.tradingPair && candidate.sourceSymbol === request.scope.sourceSymbol && candidate.marketType === request.scope.marketType && candidate.constructionModes.includes(request.constructionMode) && candidate.sourcePolicies.includes(request.sourcePolicy) && request.window.startTimeMs >= candidate.historyStartMs && request.depth <= candidate.maxDepth);
-  if (!profile)
-    return;
-  return {
-    provider: "cryptohftdata",
-    adapterVersion: CRYPTOHFTDATA_ADAPTER_VERSION,
-    providerExchangeId: profile.providerExchangeId,
-    resolvedSymbol: profile.sourceSymbol
-  };
+function cryptoHftDataCapabilityFor(request, profiles = []) {
+  if (request.providerPolicy.provider !== "cryptohftdata" || request.scope.feed !== "ORDERBOOK" || request.scope.exchange.trim().toLowerCase() === "mexc") {
+    return;
+  }
+  const profile = profiles.find((candidate) => candidate.exchange === request.scope.exchange.trim().toLowerCase() && candidate.tradingPair === request.scope.tradingPair && candidate.sourceSymbol === request.scope.sourceSymbol && candidate.marketType === request.scope.marketType && candidate.constructionModes.includes(request.constructionMode) && candidate.sourcePolicies.includes(request.sourcePolicy) && request.window.startTimeMs >= candidate.historyStartMs && request.depth <= candidate.maxDepth);
+  if (!profile)
+    return;
+  return {
+    provider: "cryptohftdata",
+    adapterVersion: CRYPTOHFTDATA_ADAPTER_VERSION,
+    providerExchangeId: profile.providerExchangeId,
+    resolvedSymbol: profile.sourceSymbol
+  };
+}
+function utcHourPath(hourMs) {
+  const date5 = new Date(hourMs);
+  return {
+    date: `${date5.getUTCFullYear()}-${String(date5.getUTCMonth() + 1).padStart(2, "0")}-${String(date5.getUTCDate()).padStart(2, "0")}`,
+    hour: String(date5.getUTCHours()).padStart(2, "0")
+  };
+}
+function enumerateCryptoHftDataObjects(request, providerExchangeId, resolvedSymbol) {
+  if (request.sourcePolicy === "fill_gaps") {
+    const hours = new Set;
+    for (const targetTimeMs of request.requiredClockTargetsMs) {
+      const firstHour2 = Math.floor(Math.max(0, targetTimeMs - request.budgets.maxBoundaryLookbackMs) / HOUR_MS) * HOUR_MS;
+      const lastHour = Math.floor(targetTimeMs / HOUR_MS) * HOUR_MS;
+      for (let hourMs = firstHour2;hourMs <= lastHour; hourMs += HOUR_MS) {
+        hours.add(hourMs);
+      }
+    }
+    return [...hours].sort((left, right) => left - right).map((hourMs) => {
+      const utc = utcHourPath(hourMs);
+      return `${providerExchangeId}/${utc.date}/${utc.hour}/${resolvedSymbol}_orderbook.parquet.zst`;
+    });
+  }
+  const firstHour = Math.floor((request.window.startTimeMs - request.budgets.maxBoundaryLookbackMs) / HOUR_MS) * HOUR_MS;
+  const objects = [];
+  for (let hourMs = Math.max(0, firstHour);hourMs < request.window.endTimeMs; hourMs += HOUR_MS) {
+    const utc = utcHourPath(hourMs);
+    objects.push(`${providerExchangeId}/${utc.date}/${utc.hour}/${resolvedSymbol}_orderbook.parquet.zst`);
+  }
+  return objects;
+}
+function initialArchiveCoversTarget(request, targetTimeMs) {
+  return (request.initialSelection?.support_anchors ?? []).some((anchor) => {
+    const sourceTimeMs = Date.parse(anchor.source_time);
+    return Number.isSafeInteger(sourceTimeMs) && sourceTimeMs <= targetTimeMs && targetTimeMs - sourceTimeMs <= request.maxPriorAsOfLagMs;
+  });
+}
+function providerAcquisitionRequest(request) {
+  if (request.sourcePolicy !== "fill_gaps")
+    return request;
+  const requiredClockTargetsMs = request.requiredClockTargetsMs.filter((targetTimeMs) => !initialArchiveCoversTarget(request, targetTimeMs));
+  if (requiredClockTargetsMs.length === 0) {
+    throw new CryptoHftDataError("fill_gaps_has_no_uncovered_clock_targets");
+  }
+  return { ...request, requiredClockTargetsMs };
+}
+function unsignedString(value, field, required2 = false) {
+  if (value === null || value === undefined) {
+    if (required2)
+      throw new CryptoHftDataError(`schema_${field}_missing`);
+    return;
+  }
+  const rendered = String(value);
+  if (!/^\d+$/.test(rendered)) {
+    throw new CryptoHftDataError(`schema_${field}_invalid`);
+  }
+  const parsed = BigInt(rendered);
+  if (parsed > 18446744073709551615n) {
+    throw new CryptoHftDataError(`schema_${field}_exceeds_uint64`);
+  }
+  return parsed.toString(10);
+}
+function timestampMs2(value, field) {
+  const rendered = String(value);
+  if (!/^\d+$/.test(rendered)) {
+    throw new CryptoHftDataError(`schema_${field}_invalid`);
+  }
+  const raw = BigInt(rendered);
+  const milliseconds = field === "received_time" ? raw / 1000000n : raw;
+  if (milliseconds > BigInt(Number.MAX_SAFE_INTEGER)) {
+    throw new CryptoHftDataError(`schema_${field}_unsafe`);
+  }
+  return Number(milliseconds);
+}
+function decimal(value, field, allowZero) {
+  if (!/^(?:0|[1-9]\d*)(?:\.\d+)?$/.test(value)) {
+    throw new CryptoHftDataError(`schema_${field}_invalid`);
+  }
+  const parsed = Number(value);
+  if (!Number.isFinite(parsed) || (allowZero ? parsed < 0 : parsed <= 0)) {
+    throw new CryptoHftDataError(`schema_${field}_invalid`);
+  }
+  return parsed;
+}
+function validatedRow(request, row) {
+  if (row.symbol !== request.scope.sourceSymbol) {
+    throw new CryptoHftDataError("schema_symbol_mismatch");
+  }
+  if (row.event_type !== "snapshot" && row.event_type !== "update") {
+    throw new CryptoHftDataError("schema_event_type_invalid");
+  }
+  if (row.side !== "bid" && row.side !== "ask") {
+    throw new CryptoHftDataError("schema_side_invalid");
+  }
+  decimal(row.price, "price", false);
+  decimal(row.quantity, "quantity", true);
+  if (!/^[a-f0-9]{64}$/.test(row.dataset_object_checksum)) {
+    throw new CryptoHftDataError("schema_object_checksum_invalid");
+  }
+  const eventTimeMs = timestampMs2(row.event_time, "event_time");
+  const receivedTimeMs = timestampMs2(row.received_time, "received_time");
+  if (receivedTimeMs < eventTimeMs) {
+    throw new CryptoHftDataError("received_time_precedes_event_time");
+  }
+  return { ...row, eventTimeMs, receivedTimeMs };
+}
+function groupKey(row, profile) {
+  const sequence = row.event_type === "snapshot" ? profile.snapshotGrouping === "event_time_final_update_id_object" ? unsignedString(row.final_update_id, "final_update_id", true) : unsignedString(row.last_update_id, "last_update_id", true) : unsignedString(row.final_update_id, "final_update_id", true);
+  return [
+    row.event_type,
+    row.eventTimeMs,
+    sequence,
+    row.dataset_object_identity
+  ].join("\x00");
+}
+function absent(value) {
+  return value === null || value === undefined;
+}
+function snapshotSequence(row, profile) {
+  if (profile.sequenceSemantics === "okx_seq_id_prev_seq_id") {
+    if (String(row.last_update_id) !== "-1") {
+      throw new CryptoHftDataError("schema_last_update_id_snapshot_sentinel");
+    }
+    if (!absent(row.first_update_id) || !absent(row.prev_final_update_id)) {
+      throw new CryptoHftDataError("ambiguous_snapshot_group");
+    }
+    return unsignedString(row.final_update_id, "final_update_id", true);
+  }
+  return unsignedString(row.last_update_id, "last_update_id", true);
+}
+function sortedSide(levels, side) {
+  return [...levels.entries()].map(([price, quantity]) => [Number(price), quantity]).sort((left, right) => side === "bid" ? right[0] - left[0] : left[0] - right[0]);
+}
+function applyRows(state, rows) {
+  for (const row of rows) {
+    const levels = row.side === "bid" ? state.bids : state.asks;
+    const quantity = decimal(row.quantity, "quantity", true);
+    if (quantity === 0)
+      levels.delete(row.price);
+    else
+      levels.set(row.price, quantity);
+  }
+}
+function reconstructCryptoHftDataOrderBooks(request, inputRows, profile = CRYPTOHFTDATA_BINANCE_SPOT_BTCUSDT_PROFILE) {
+  const rows = inputRows.map((row, index) => ({
+    ...validatedRow(request, row),
+    originalIndex: index
+  })).sort((left, right) => left.eventTimeMs - right.eventTimeMs || left.originalIndex - right.originalIndex);
+  const groups = [];
+  for (const row of rows) {
+    const current = groups.at(-1);
+    if (!current || groupKey(current[0], profile) !== groupKey(row, profile)) {
+      groups.push([row]);
+    } else {
+      current.push(row);
+    }
+  }
+  const earliestTargetTimeMs = Math.min(...request.requiredClockTargetsMs);
+  const latestTargetTimeMs = Math.max(...request.requiredClockTargetsMs);
+  const anchorIndex = groups.findIndex((group) => {
+    const first = group[0];
+    return first.event_type === "snapshot" && first.eventTimeMs <= earliestTargetTimeMs;
+  });
+  if (anchorIndex < 0) {
+    throw new CryptoHftDataError("update_before_snapshot");
+  }
+  let state;
+  let previousFinalUpdateId;
+  const states = [];
+  for (const group of groups.slice(anchorIndex)) {
+    const first = group[0];
+    if (first.eventTimeMs > latestTargetTimeMs)
+      break;
+    if (first.event_type === "snapshot") {
+      const sequence = snapshotSequence(first, profile);
+      for (const row of group) {
+        if (snapshotSequence(row, profile) !== sequence) {
+          throw new CryptoHftDataError("ambiguous_snapshot_group");
+        }
+      }
+      if (profile.sequenceSemantics === "binance_u_U_pu" && previousFinalUpdateId !== undefined && BigInt(sequence) < previousFinalUpdateId) {
+        throw new CryptoHftDataError("snapshot_sequence_regression");
+      }
+      state = {
+        bids: new Map,
+        asks: new Map,
+        sequence,
+        sourceTimeMs: first.eventTimeMs,
+        receivedTimeMs: Math.max(...group.map(({ receivedTimeMs }) => receivedTimeMs)),
+        datasetObjectIdentity: first.dataset_object_identity,
+        datasetObjectChecksum: first.dataset_object_checksum
+      };
+      applyRows(state, group);
+      previousFinalUpdateId = BigInt(sequence);
+    } else {
+      if (!state || previousFinalUpdateId === undefined) {
+        throw new CryptoHftDataError("update_before_snapshot");
+      }
+      const finalUpdate = BigInt(unsignedString(first.final_update_id, "final_update_id", true));
+      if (profile.sequenceSemantics === "okx_seq_id_prev_seq_id") {
+        if (!absent(first.first_update_id) || !absent(first.prev_final_update_id)) {
+          throw new CryptoHftDataError("ambiguous_update_group");
+        }
+        const previous = unsignedString(first.last_update_id, "last_update_id", true);
+        for (const row of group) {
+          if (!absent(row.first_update_id) || !absent(row.prev_final_update_id) || unsignedString(row.final_update_id, "final_update_id", true) !== finalUpdate.toString() || unsignedString(row.last_update_id, "last_update_id", true) !== previous) {
+            throw new CryptoHftDataError("ambiguous_update_group");
+          }
+        }
+        if (BigInt(previous) !== previousFinalUpdateId) {
+          throw new CryptoHftDataError("update_chain_gap");
+        }
+      } else {
+        const firstUpdate = BigInt(unsignedString(first.first_update_id, "first_update_id", true));
+        const previous = unsignedString(first.prev_final_update_id, "prev_final_update_id");
+        for (const row of group) {
+          if (unsignedString(row.first_update_id, "first_update_id", true) !== firstUpdate.toString() || unsignedString(row.final_update_id, "final_update_id", true) !== finalUpdate.toString() || unsignedString(row.prev_final_update_id, "prev_final_update_id") !== previous) {
+            throw new CryptoHftDataError("ambiguous_update_group");
+          }
+        }
+        const expected = previousFinalUpdateId + 1n;
+        if (firstUpdate > expected || finalUpdate < expected || previous !== undefined && BigInt(previous) !== previousFinalUpdateId) {
+          throw new CryptoHftDataError("update_chain_gap");
+        }
+      }
+      applyRows(state, group);
+      state.sequence = finalUpdate.toString();
+      state.sourceTimeMs = first.eventTimeMs;
+      state.receivedTimeMs = Math.max(...group.map(({ receivedTimeMs }) => receivedTimeMs));
+      state.datasetObjectIdentity = first.dataset_object_identity;
+      state.datasetObjectChecksum = first.dataset_object_checksum;
+      previousFinalUpdateId = finalUpdate;
+    }
+    if (state) {
+      states.push({
+        ...state,
+        bids: new Map(state.bids),
+        asks: new Map(state.asks)
+      });
+    }
+  }
+  const samples = [];
+  for (const targetTimeMs of request.requiredClockTargetsMs) {
+    let prior;
+    for (const candidate of states) {
+      if (candidate.sourceTimeMs > targetTimeMs)
+        break;
+      prior = candidate;
+    }
+    if (!prior || targetTimeMs - prior.sourceTimeMs > request.maxPriorAsOfLagMs) {
+      throw new CryptoHftDataError("required_clock_coverage_insufficient");
+    }
+    const bids = sortedSide(prior.bids, "bid").slice(0, request.depth);
+    const asks = sortedSide(prior.asks, "ask").slice(0, request.depth);
+    if (bids.length === 0 || asks.length === 0) {
+      throw new CryptoHftDataError("book_side_missing");
+    }
+    if (bids[0]?.[0] >= asks[0]?.[0]) {
+      throw new CryptoHftDataError("book_crossed_or_locked");
+    }
+    samples.push({
+      targetTimeMs,
+      sourceTimeMs: prior.sourceTimeMs,
+      receivedTimeMs: prior.receivedTimeMs,
+      sequence: prior.sequence,
+      bids,
+      asks,
+      datasetObjectIdentity: prior.datasetObjectIdentity,
+      datasetObjectChecksum: prior.datasetObjectChecksum
+    });
+  }
+  return samples;
+}
+function sha256Bytes(bytes) {
+  return createHash4("sha256").update(bytes).digest("hex");
 }
-function utcHourPath(hourMs) {
-  const date5 = new Date(hourMs);
+async function decodeCryptoHftParquetZstd(bytes) {
+  const parquet = decompress(bytes);
+  const buffer = parquet.buffer.slice(parquet.byteOffset, parquet.byteOffset + parquet.byteLength);
+  return parquetReadObjects({ file: buffer });
+}
+function parsedDatasetRow(value, object2) {
   return {
-    date: `${date5.getUTCFullYear()}-${String(date5.getUTCMonth() + 1).padStart(2, "0")}-${String(date5.getUTCDate()).padStart(2, "0")}`,
-    hour: String(date5.getUTCHours()).padStart(2, "0")
+    received_time: value.received_time,
+    event_time: value.event_time,
+    transaction_time: value.transaction_time,
+    symbol: value.symbol,
+    event_type: value.event_type,
+    first_update_id: value.first_update_id,
+    final_update_id: value.final_update_id,
+    prev_final_update_id: value.prev_final_update_id,
+    last_update_id: value.last_update_id,
+    side: value.side,
+    price: value.price,
+    quantity: value.quantity,
+    order_count: value.order_count,
+    dataset_object_identity: object2.identity,
+    dataset_object_checksum: object2.checksum
   };
 }
-function enumerateCryptoHftDataObjects(request, providerExchangeId, resolvedSymbol) {
-  const firstHour = Math.floor((request.window.startTimeMs - request.budgets.maxBoundaryLookbackMs) / HOUR_MS) * HOUR_MS;
-  const objects = [];
-  for (let hourMs = Math.max(0, firstHour);hourMs < request.window.endTimeMs; hourMs += HOUR_MS) {
-    const utc = utcHourPath(hourMs);
-    objects.push(`${providerExchangeId}/${utc.date}/${utc.hour}/${resolvedSymbol}_orderbook.parquet.zst`);
+async function readBoundedObject(response, remainingBytes) {
+  if (!response.body)
+    return new Uint8Array;
+  const reader = response.body.getReader();
+  const chunks = [];
+  let total = 0;
+  while (true) {
+    const { done, value } = await reader.read();
+    if (done)
+      break;
+    total += value.byteLength;
+    if (total > remainingBytes) {
+      await reader.cancel();
+      throw new CryptoHftDataError("budget_max_bytes_exceeded");
+    }
+    chunks.push(value);
+  }
+  const bytes = new Uint8Array(total);
+  let offset = 0;
+  for (const chunk of chunks) {
+    bytes.set(chunk, offset);
+    offset += chunk.byteLength;
+  }
+  return bytes;
+}
+
+class CryptoHftDataAdapter {
+  baseUrl;
+  request;
+  nowMs;
+  decode;
+  profiles;
+  constructor(options = {}) {
+    this.baseUrl = options.baseUrl ?? CRYPTOHFTDATA_API_URL;
+    this.request = options.fetch ?? fetch;
+    this.nowMs = options.nowMs ?? Date.now;
+    this.decode = options.decode ?? decodeCryptoHftParquetZstd;
+    this.profiles = options.profiles ?? [];
+  }
+  capabilityFor(request) {
+    return cryptoHftDataCapabilityFor(request, this.profiles);
+  }
+  async discoverSymbols(providerExchangeId) {
+    if (!/^[a-z0-9_]+$/.test(providerExchangeId)) {
+      throw new CryptoHftDataError("symbol_discovery_exchange_invalid");
+    }
+    const endpoint = new URL("/symbols", this.baseUrl);
+    endpoint.searchParams.set("exchange", providerExchangeId);
+    endpoint.searchParams.set("data_type", "orderbook");
+    let response;
+    try {
+      response = await this.request(endpoint);
+    } catch {
+      throw new CryptoHftDataError("symbol_discovery_failed");
+    }
+    if (!response.ok) {
+      throw new CryptoHftDataError("symbol_discovery_failed");
+    }
+    let body;
+    try {
+      body = await response.json();
+    } catch {
+      throw new CryptoHftDataError("symbol_discovery_response_invalid");
+    }
+    const record2 = body;
+    if (!body || typeof body !== "object" || Array.isArray(body) || String(record2.exchange).toLowerCase() !== providerExchangeId || String(record2.data_type).toLowerCase() !== "orderbook" || !Array.isArray(record2.symbols) || !record2.symbols.every((symbol2) => typeof symbol2 === "string" && /^[A-Z0-9_-]+$/.test(symbol2))) {
+      throw new CryptoHftDataError("symbol_discovery_response_invalid");
+    }
+    return [...new Set(record2.symbols)].sort();
+  }
+  async acquire(request, capability, credential) {
+    const apiKey = credential && typeof credential === "object" ? credential.apiKey : undefined;
+    if (typeof apiKey !== "string" || apiKey.length === 0) {
+      throw new CryptoHftDataError("credentials_invalid");
+    }
+    const paths = enumerateCryptoHftDataObjects(request, capability.providerExchangeId, capability.resolvedSymbol);
+    if (paths.length > request.budgets.maxFiles) {
+      throw new CryptoHftDataError("budget_max_files_exceeded");
+    }
+    const started = this.nowMs();
+    const tokenResponse = await this.request(`${this.baseUrl}/jwt-token`, {
+      method: "POST",
+      headers: { "content-type": "application/json", "X-API-Key": apiKey }
+    });
+    if (!tokenResponse.ok)
+      throw new CryptoHftDataError("jwt_issuance_failed");
+    const tokenBody = await tokenResponse.json();
+    if (typeof tokenBody.jwt_token !== "string" || !tokenBody.jwt_token) {
+      throw new CryptoHftDataError("jwt_response_invalid");
+    }
+    let totalBytes = 0;
+    let totalRows = 0;
+    const objects = [];
+    const rows = [];
+    for (const path2 of paths) {
+      if (this.nowMs() - started > request.budgets.maxDurationMs) {
+        throw new CryptoHftDataError("budget_max_duration_exceeded");
+      }
+      const endpoint = new URL("/download", this.baseUrl);
+      endpoint.searchParams.set("file", path2);
+      const response = await this.request(endpoint, {
+        headers: { Authorization: `Bearer ${tokenBody.jwt_token}` }
+      });
+      if (!response.ok)
+        throw new CryptoHftDataError("object_download_failed");
+      const declaredBytes = Number(response.headers.get("content-length"));
+      if (Number.isFinite(declaredBytes) && totalBytes + declaredBytes > request.budgets.maxBytes) {
+        throw new CryptoHftDataError("budget_max_bytes_exceeded");
+      }
+      const bytes = await readBoundedObject(response, request.budgets.maxBytes - totalBytes);
+      totalBytes += bytes.byteLength;
+      if (totalBytes > request.budgets.maxBytes) {
+        throw new CryptoHftDataError("budget_max_bytes_exceeded");
+      }
+      const decoded = await this.decode(bytes);
+      totalRows += decoded.length;
+      if (totalRows > request.budgets.maxRows) {
+        throw new CryptoHftDataError("budget_max_rows_exceeded");
+      }
+      const object2 = {
+        identity: path2,
+        checksum: sha256Bytes(bytes),
+        bytes: bytes.byteLength,
+        rows: decoded.length
+      };
+      objects.push(object2);
+      for (const decodedRow of decoded) {
+        const parsed = parsedDatasetRow(decodedRow, object2);
+        validatedRow(request, parsed);
+        rows.push(parsed);
+      }
+    }
+    if (this.nowMs() - started > request.budgets.maxDurationMs) {
+      throw new CryptoHftDataError("budget_max_duration_exceeded");
+    }
+    return {
+      objects,
+      rows,
+      vendorSemanticDigest: sha256Canonical(rows)
+    };
+  }
+  async normalize(request, capability, dataset, captureBundleId) {
+    const profile = this.profiles.find((candidate) => candidate.exchange === request.scope.exchange.trim().toLowerCase() && candidate.tradingPair === request.scope.tradingPair && candidate.sourceSymbol === request.scope.sourceSymbol && candidate.marketType === request.scope.marketType && candidate.providerExchangeId === capability.providerExchangeId);
+    if (!profile) {
+      throw new CryptoHftDataError("profile_semantics_unavailable");
+    }
+    const samples = reconstructCryptoHftDataOrderBooks(request, dataset.rows, profile);
+    const context2 = {
+      source: EXTERNAL_BACKFILL_SOURCE,
+      deploymentId: "market-data-vendor-backfill",
+      captureBundleId,
+      exchange: request.scope.exchange,
+      symbol: request.scope.tradingPair,
+      tradingPair: request.scope.tradingPair,
+      sourceSymbol: request.scope.sourceSymbol,
+      assetType: request.scope.marketType,
+      feed: "ORDERBOOK",
+      provider: "cryptohftdata",
+      sourceMode: HISTORICAL_VENDOR_SOURCE_MODE,
+      schemaVersion: MARKET_CAPTURE_SCHEMA_VERSION,
+      checksumAlgorithm: CHECKSUM_ALGORITHM,
+      provenanceComplete: true
+    };
+    const rows = samples.flatMap((sample) => {
+      const rawCapture = {
+        rawCaptureId: sha256Canonical({
+          capture_bundle_id: captureBundleId,
+          dataset_object_identity: sample.datasetObjectIdentity,
+          dataset_object_checksum: sample.datasetObjectChecksum,
+          source_time_ms: sample.sourceTimeMs,
+          target_time_ms: sample.targetTimeMs
+        }),
+        rawCaptureScope: VENDOR_DATASET_RAW_CAPTURE_SCOPE,
+        rawChecksum: sample.datasetObjectChecksum,
+        redactedPayload: {
+          dataset_object_identity: sample.datasetObjectIdentity,
+          dataset_object_checksum: sample.datasetObjectChecksum
+        },
+        eventTimeMs: sample.sourceTimeMs,
+        receivedTimeMs: sample.receivedTimeMs,
+        checksumAlgorithm: CHECKSUM_ALGORITHM
+      };
+      const canonical = buildCanonicalOrderBookRows({
+        context: context2,
+        rawCapture,
+        depthLimit: request.depth,
+        constructionMode: request.constructionMode,
+        snapshot: {
+          bids: sample.bids,
+          asks: sample.asks,
+          timestamp: sample.sourceTimeMs,
+          receivedTimestamp: sample.receivedTimeMs,
+          exchange: request.scope.exchange,
+          symbol: request.scope.tradingPair,
+          depthLimit: request.depth,
+          sequence: sample.sequence
+        }
+      });
+      return [...canonical.levels, canonical.summary];
+    });
+    return {
+      captureBundleId,
+      objects: dataset.objects,
+      rows,
+      vendorSemanticDigest: dataset.vendorSemanticDigest,
+      canonicalSemanticDigest: semanticDigest(rows)
+    };
   }
-  return objects;
 }
-function unsignedString(value, field, required2 = false) {
-  if (value === null || value === undefined) {
-    if (required2)
-      throw new CryptoHftDataError(`schema_${field}_missing`);
-    return;
-  }
-  const rendered = String(value);
-  if (!/^\d+$/.test(rendered)) {
-    throw new CryptoHftDataError(`schema_${field}_invalid`);
-  }
-  const parsed = BigInt(rendered);
-  if (parsed > 18446744073709551615n) {
-    throw new CryptoHftDataError(`schema_${field}_exceeds_uint64`);
-  }
-  return parsed.toString(10);
+
+// src/helpers/market-data-vendor-backfill/qualification.ts
+var UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/;
+var SHA256 = /^[0-9a-f]{64}$/;
+var REASON = /^[a-z][a-z0-9_]{0,127}$/;
+var EVENT_FIELDS = new Set([
+  "qualification_event_id",
+  "capture_bundle_id",
+  "state",
+  "receipt_id",
+  "promotion_identity_sha256",
+  "window",
+  "event_at",
+  "reason_code"
+]);
+function deterministicUuid(value) {
+  const digest = jcsSha256(value).slice(0, 32).split("");
+  digest[12] = "5";
+  digest[16] = "8";
+  const hex3 = digest.join("");
+  return `${hex3.slice(0, 8)}-${hex3.slice(8, 12)}-${hex3.slice(12, 16)}-${hex3.slice(16, 20)}-${hex3.slice(20)}`;
 }
-function timestampMs2(value, field) {
-  const rendered = String(value);
-  if (!/^\d+$/.test(rendered)) {
-    throw new CryptoHftDataError(`schema_${field}_invalid`);
-  }
-  const raw = BigInt(rendered);
-  const milliseconds = field === "received_time" ? raw / 1000000n : raw;
-  if (milliseconds > BigInt(Number.MAX_SAFE_INTEGER)) {
-    throw new CryptoHftDataError(`schema_${field}_unsafe`);
-  }
-  return Number(milliseconds);
+function semanticEvent(event) {
+  const { qualification_event_id: _eventId, ...semantic } = event;
+  return semantic;
 }
-function decimal(value, field, allowZero) {
-  if (!/^(?:0|[1-9]\d*)(?:\.\d+)?$/.test(value)) {
-    throw new CryptoHftDataError(`schema_${field}_invalid`);
-  }
-  const parsed = Number(value);
-  if (!Number.isFinite(parsed) || (allowZero ? parsed < 0 : parsed <= 0)) {
-    throw new CryptoHftDataError(`schema_${field}_invalid`);
+function assertTimestamp(value, field) {
+  const parsed = Date.parse(value);
+  if (!Number.isSafeInteger(parsed) || new Date(parsed).toISOString() !== value) {
+    throw new Error(`${field} must be a fixed UTC RFC3339 timestamp`);
   }
   return parsed;
 }
-function validatedRow(request, row) {
-  if (row.symbol !== request.scope.sourceSymbol) {
-    throw new CryptoHftDataError("schema_symbol_mismatch");
-  }
-  if (row.event_type !== "snapshot" && row.event_type !== "update") {
-    throw new CryptoHftDataError("schema_event_type_invalid");
+function parseQualificationEvent(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    throw new Error("qualification event must be an object");
   }
-  if (row.side !== "bid" && row.side !== "ask") {
-    throw new CryptoHftDataError("schema_side_invalid");
+  const event = value;
+  if (Object.keys(event).length !== EVENT_FIELDS.size || !Object.keys(event).every((field) => EVENT_FIELDS.has(field)) || !UUID.test(event.qualification_event_id) || !SHA256.test(event.capture_bundle_id) || !["qualified", "quarantined", "revoked"].includes(event.state) || !SHA256.test(event.receipt_id) || !SHA256.test(event.promotion_identity_sha256) || !event.window || typeof event.window !== "object" || Object.keys(event.window).length !== 2 || !REASON.test(event.reason_code)) {
+    throw new Error("qualification event fields are invalid");
   }
-  decimal(row.price, "price", false);
-  decimal(row.quantity, "quantity", true);
-  if (!/^[a-f0-9]{64}$/.test(row.dataset_object_checksum)) {
-    throw new CryptoHftDataError("schema_object_checksum_invalid");
+  if (assertTimestamp(event.window.end_at, "window.end_at") <= assertTimestamp(event.window.start_at, "window.start_at")) {
+    throw new Error("qualification window must be increasing");
   }
-  const eventTimeMs = timestampMs2(row.event_time, "event_time");
-  const receivedTimeMs = timestampMs2(row.received_time, "received_time");
-  if (receivedTimeMs < eventTimeMs) {
-    throw new CryptoHftDataError("received_time_precedes_event_time");
+  assertTimestamp(event.event_at, "event_at");
+  if (deterministicUuid(semanticEvent(event)) !== event.qualification_event_id) {
+    throw new Error("qualification_event_id does not match event content");
   }
-  return { ...row, eventTimeMs, receivedTimeMs };
-}
-function groupKey(row, profile) {
-  const sequence = row.event_type === "snapshot" ? profile.snapshotGrouping === "event_time_final_update_id_object" ? unsignedString(row.final_update_id, "final_update_id", true) : unsignedString(row.last_update_id, "last_update_id", true) : unsignedString(row.final_update_id, "final_update_id", true);
-  return [
-    row.event_type,
-    row.eventTimeMs,
-    sequence,
-    row.dataset_object_identity
-  ].join("\x00");
+  return event;
 }
-function absent(value) {
-  return value === null || value === undefined;
+function finalizeQualificationEvent(event) {
+  const semantic = semanticEvent(event);
+  return parseQualificationEvent({
+    ...semantic,
+    qualification_event_id: deterministicUuid(semantic)
+  });
 }
-function snapshotSequence(row, profile) {
-  if (profile.sequenceSemantics === "okx_seq_id_prev_seq_id") {
-    if (String(row.last_update_id) !== "-1") {
-      throw new CryptoHftDataError("schema_last_update_id_snapshot_sentinel");
-    }
-    if (!absent(row.first_update_id) || !absent(row.prev_final_update_id)) {
-      throw new CryptoHftDataError("ambiguous_snapshot_group");
+function qualificationEventToArchiveRow(eventInput) {
+  const event = parseQualificationEvent(eventInput);
+  return {
+    table: "market_data.cex_order_book_capture_qualifications",
+    row: {
+      source: "external_backfill",
+      capture_origin: "vendor_historical_backfill",
+      source_mode: "vendor_historical_backfill_v1",
+      deployment_id: "market-data-vendor-backfill",
+      qualification_event_id: event.qualification_event_id,
+      capture_bundle_id: event.capture_bundle_id,
+      state: event.state,
+      receipt_id: event.receipt_id,
+      promotion_identity_sha256: event.promotion_identity_sha256,
+      window_start_ms: Date.parse(event.window.start_at),
+      window_end_ms: Date.parse(event.window.end_at),
+      event_at_ms: Date.parse(event.event_at),
+      reason_code: event.reason_code,
+      event_json: jcsCanonicalize(event)
     }
-    return unsignedString(row.final_update_id, "final_update_id", true);
-  }
-  return unsignedString(row.last_update_id, "last_update_id", true);
-}
-function sortedSide(levels, side) {
-  return [...levels.entries()].map(([price, quantity]) => [Number(price), quantity]).sort((left, right) => side === "bid" ? right[0] - left[0] : left[0] - right[0]);
-}
-function applyRows(state, rows) {
-  for (const row of rows) {
-    const levels = row.side === "bid" ? state.bids : state.asks;
-    const quantity = decimal(row.quantity, "quantity", true);
-    if (quantity === 0)
-      levels.delete(row.price);
-    else
-      levels.set(row.price, quantity);
-  }
+  };
 }
-function reconstructCryptoHftDataOrderBooks(request, inputRows, profile = CRYPTOHFTDATA_BINANCE_SPOT_BTCUSDT_PROFILE) {
-  const rows = inputRows.map((row, index) => ({
-    ...validatedRow(request, row),
-    originalIndex: index
-  })).sort((left, right) => left.eventTimeMs - right.eventTimeMs || left.originalIndex - right.originalIndex);
-  const groups = [];
-  for (const row of rows) {
-    const current = groups.at(-1);
-    if (!current || groupKey(current[0], profile) !== groupKey(row, profile)) {
-      groups.push([row]);
-    } else {
-      current.push(row);
-    }
-  }
-  const earliestTargetTimeMs = Math.min(...request.requiredClockTargetsMs);
-  const latestTargetTimeMs = Math.max(...request.requiredClockTargetsMs);
-  const anchorIndex = groups.findIndex((group) => {
-    const first = group[0];
-    return first.event_type === "snapshot" && first.eventTimeMs <= earliestTargetTimeMs;
-  });
-  if (anchorIndex < 0) {
-    throw new CryptoHftDataError("update_before_snapshot");
-  }
-  let state;
-  let previousFinalUpdateId;
-  const states = [];
-  for (const group of groups.slice(anchorIndex)) {
-    const first = group[0];
-    if (first.eventTimeMs > latestTargetTimeMs)
-      break;
-    if (first.event_type === "snapshot") {
-      const sequence = snapshotSequence(first, profile);
-      for (const row of group) {
-        if (snapshotSequence(row, profile) !== sequence) {
-          throw new CryptoHftDataError("ambiguous_snapshot_group");
-        }
-      }
-      if (profile.sequenceSemantics === "binance_u_U_pu" && previousFinalUpdateId !== undefined && BigInt(sequence) < previousFinalUpdateId) {
-        throw new CryptoHftDataError("snapshot_sequence_regression");
-      }
-      state = {
-        bids: new Map,
-        asks: new Map,
-        sequence,
-        sourceTimeMs: first.eventTimeMs,
-        receivedTimeMs: Math.max(...group.map(({ receivedTimeMs }) => receivedTimeMs)),
-        datasetObjectIdentity: first.dataset_object_identity,
-        datasetObjectChecksum: first.dataset_object_checksum
-      };
-      applyRows(state, group);
-      previousFinalUpdateId = BigInt(sequence);
-    } else {
-      if (!state || previousFinalUpdateId === undefined) {
-        throw new CryptoHftDataError("update_before_snapshot");
-      }
-      const finalUpdate = BigInt(unsignedString(first.final_update_id, "final_update_id", true));
-      if (profile.sequenceSemantics === "okx_seq_id_prev_seq_id") {
-        if (!absent(first.first_update_id) || !absent(first.prev_final_update_id)) {
-          throw new CryptoHftDataError("ambiguous_update_group");
-        }
-        const previous = unsignedString(first.last_update_id, "last_update_id", true);
-        for (const row of group) {
-          if (!absent(row.first_update_id) || !absent(row.prev_final_update_id) || unsignedString(row.final_update_id, "final_update_id", true) !== finalUpdate.toString() || unsignedString(row.last_update_id, "last_update_id", true) !== previous) {
-            throw new CryptoHftDataError("ambiguous_update_group");
-          }
-        }
-        if (BigInt(previous) !== previousFinalUpdateId) {
-          throw new CryptoHftDataError("update_chain_gap");
-        }
-      } else {
-        const firstUpdate = BigInt(unsignedString(first.first_update_id, "first_update_id", true));
-        const previous = unsignedString(first.prev_final_update_id, "prev_final_update_id");
-        for (const row of group) {
-          if (unsignedString(row.first_update_id, "first_update_id", true) !== firstUpdate.toString() || unsignedString(row.final_update_id, "final_update_id", true) !== finalUpdate.toString() || unsignedString(row.prev_final_update_id, "prev_final_update_id") !== previous) {
-            throw new CryptoHftDataError("ambiguous_update_group");
-          }
-        }
-        const expected = previousFinalUpdateId + 1n;
-        if (firstUpdate > expected || finalUpdate < expected || previous !== undefined && BigInt(previous) !== previousFinalUpdateId) {
-          throw new CryptoHftDataError("update_chain_gap");
-        }
-      }
-      applyRows(state, group);
-      state.sequence = finalUpdate.toString();
-      state.sourceTimeMs = first.eventTimeMs;
-      state.receivedTimeMs = Math.max(...group.map(({ receivedTimeMs }) => receivedTimeMs));
-      state.datasetObjectIdentity = first.dataset_object_identity;
-      state.datasetObjectChecksum = first.dataset_object_checksum;
-      previousFinalUpdateId = finalUpdate;
-    }
-    if (state) {
-      states.push({
-        ...state,
-        bids: new Map(state.bids),
-        asks: new Map(state.asks)
-      });
-    }
+
+// src/helpers/market-data-vendor-backfill/core.ts
+function outcome(request, status, reasonCode, extra = {}) {
+  return {
+    status,
+    reasonCode,
+    ...request ? {
+      requestId: request.requestId,
+      idempotencyKey: request.idempotencyKey,
+      ...request.target ? { target: request.target } : {}
+    } : {},
+    ...extra
+  };
+}
+function captureBundleId(request, capability, dataset) {
+  return sha256Canonical({
+    request_business_identity: request.idempotencyKey,
+    provider: capability.provider,
+    provider_exchange_id: capability.providerExchangeId,
+    resolved_symbol: capability.resolvedSymbol,
+    adapter_version: capability.adapterVersion,
+    objects: dataset.objects.map(({ identity, checksum, bytes, rows }) => ({
+      identity,
+      checksum,
+      bytes,
+      rows
+    })),
+    canonical_schema_version: request.expectedProduct.canonicalSchemaVersion,
+    checksum_algorithm: request.expectedProduct.checksumAlgorithm
+  });
+}
+function buildPromotionReceipt(request, capability, normalized, verification, verificationTimeMs) {
+  if (!request.wire || !request.initialSelection || !request.expectedCanonicalSchema || !request.coveragePolicy || !request.productPins) {
+    throw new Error("decoded final-v1 request context is missing");
   }
-  const samples = [];
-  for (const targetTimeMs of request.requiredClockTargetsMs) {
-    let prior;
-    for (const candidate of states) {
-      if (candidate.sourceTimeMs > targetTimeMs)
+  return finalizePromotionReceipt({
+    schema_id: PROMOTION_RECEIPT_SCHEMA_ID,
+    verified_at: new Date(verificationTimeMs).toISOString(),
+    request_id: request.requestId,
+    idempotency_key: request.idempotencyKey,
+    source: EXTERNAL_BACKFILL_SOURCE,
+    capture_origin: "vendor_historical_backfill",
+    source_mode: "vendor_historical_backfill_v1",
+    provider: capability.provider,
+    adapter_version: capability.adapterVersion,
+    effective_policies: {
+      capability_policy: request.productPins.capability_policy,
+      resource_policy: request.productPins.resource_policy,
+      adapter_policy: EFFECTIVE_ADAPTER_POLICY_PIN,
+      acquisition_policy: EFFECTIVE_ACQUISITION_POLICY_PIN
+    },
+    capture_bundle_id: normalized.captureBundleId,
+    scope: request.wire.scope,
+    window: request.wire.window,
+    depth: request.depth,
+    construction_mode: request.constructionMode,
+    canonical_schema: request.expectedCanonicalSchema,
+    coverage_policy: request.coveragePolicy,
+    selection_sha256: request.initialSelection.selection_sha256,
+    vendor_semantic_digest: normalized.vendorSemanticDigest,
+    canonical_semantic_digest: verification.canonicalSemanticDigest,
+    prefix_digest: verification.prefixDigest,
+    suffix_digest: verification.suffixDigest,
+    seam_verified: true,
+    coverage_verified: true,
+    dataset_objects: normalized.objects
+  });
+}
+async function submitAll(dependencies, batches) {
+  const maxAttempts = Math.max(1, Math.min(10, dependencies.retry?.maxAttempts ?? 3));
+  for (const batch of batches) {
+    let accepted = false;
+    for (let attempt = 1;attempt <= maxAttempts; attempt += 1) {
+      try {
+        const response = await dependencies.forwarder.submit(batch);
+        accepted = response.ok && response.inserted === batch.rows.length;
+      } catch {
+        accepted = false;
+      }
+      if (accepted)
         break;
-      prior = candidate;
+      if (attempt < maxAttempts)
+        await dependencies.retry?.wait?.(attempt);
     }
-    if (!prior || targetTimeMs - prior.sourceTimeMs > request.maxPriorAsOfLagMs) {
-      throw new CryptoHftDataError("required_clock_coverage_insufficient");
+    if (!accepted)
+      return false;
+  }
+  return true;
+}
+function stableFailureReason(error48, fallback) {
+  if (error48 && typeof error48 === "object") {
+    const reason = error48.reason;
+    if (typeof reason === "string" && /^[a-z][a-z0-9_]{0,127}$/.test(reason)) {
+      return reason;
     }
-    const bids = sortedSide(prior.bids, "bid").slice(0, request.depth);
-    const asks = sortedSide(prior.asks, "ask").slice(0, request.depth);
-    if (bids.length === 0 || asks.length === 0) {
-      throw new CryptoHftDataError("book_side_missing");
+  }
+  return fallback;
+}
+function assertArchivePreflight(request, resolution) {
+  if (!request.target || !request.productionAuthorizationId) {
+    throw new Error("request target or production authorization ID is missing");
+  }
+  const selection = archiveSelectionCodec.decode(resolution.selection);
+  const receipts = resolution.receipts.map((receipt) => promotionReceiptCodec.decode(receipt));
+  const receiptById = new Map;
+  for (const receipt of receipts) {
+    const existing = receiptById.get(receipt.receipt_id);
+    if (existing && jcsCanonicalize(existing) !== jcsCanonicalize(receipt)) {
+      throw new Error("stored receipt identity has conflicting content");
     }
-    if (bids[0]?.[0] >= asks[0]?.[0]) {
-      throw new CryptoHftDataError("book_crossed_or_locked");
+    receiptById.set(receipt.receipt_id, receipt);
+  }
+  for (const bundle of selection.bundles) {
+    if (bundle.capture_origin === "vendor_historical_backfill" && (!bundle.qualification || !receiptById.has(bundle.qualification.receipt_id))) {
+      throw new Error("vendor selection lacks its validated stored receipt");
     }
-    samples.push({
-      targetTimeMs,
-      sourceTimeMs: prior.sourceTimeMs,
-      receivedTimeMs: prior.receivedTimeMs,
-      sequence: prior.sequence,
-      bids,
-      asks,
-      datasetObjectIdentity: prior.datasetObjectIdentity,
-      datasetObjectChecksum: prior.datasetObjectChecksum
-    });
   }
-  return samples;
+  if (resolution.readerIdentity.environment !== request.target.environment || resolution.readerIdentity.cluster !== request.target.cluster) {
+    throw new Error("archive reader cluster identity mismatch");
+  }
 }
-function sha256Bytes(bytes) {
-  return createHash4("sha256").update(bytes).digest("hex");
+function assertForwarderPreflight(request, resolution, nowMs) {
+  if (!request.target || !request.productionAuthorizationId) {
+    throw new Error("request target or production authorization ID is missing");
+  }
+  if (resolution.forwarderIdentity.environment !== request.target.environment || resolution.forwarderIdentity.cluster !== request.target.cluster) {
+    throw new Error("archive forwarder cluster identity mismatch");
+  }
+  const authorization = resolution.authorization;
+  const expiresAtMs = Date.parse(authorization.expiresAt);
+  if (authorization.authorizationId !== request.productionAuthorizationId || authorization.scope !== "production" || authorization.environment !== request.target.environment || authorization.cluster !== request.target.cluster || authorization.credentialValidated !== true || !Number.isSafeInteger(expiresAtMs) || new Date(expiresAtMs).toISOString() !== authorization.expiresAt || expiresAtMs <= nowMs) {
+    throw new Error("production forwarder authorization is invalid");
+  }
 }
-async function decodeCryptoHftParquetZstd(bytes) {
-  const parquet = decompress(bytes);
-  const buffer = parquet.buffer.slice(parquet.byteOffset, parquet.byteOffset + parquet.byteLength);
-  return parquetReadObjects({ file: buffer });
+function resourcePolicyScopeExceeded(request) {
+  const policy = [RESOURCE_POLICY, LEGACY_RESOURCE_POLICY].find((candidate) => request.productPins?.resource_policy.policy_id === candidate.policy_id && request.productPins.resource_policy.policy_sha256 === candidate.policy_sha256);
+  if (!policy)
+    return true;
+  return request.depth > policy.request_bounds.max_depth || request.window.endTimeMs - request.window.startTimeMs > policy.request_bounds.max_window_ms || request.requiredClockTargetsMs.length > policy.request_bounds.max_required_events;
 }
-function parsedDatasetRow(value, object2) {
-  return {
-    received_time: value.received_time,
-    event_time: value.event_time,
-    transaction_time: value.transaction_time,
-    symbol: value.symbol,
-    event_type: value.event_type,
-    first_update_id: value.first_update_id,
-    final_update_id: value.final_update_id,
-    prev_final_update_id: value.prev_final_update_id,
-    last_update_id: value.last_update_id,
-    side: value.side,
-    price: value.price,
-    quantity: value.quantity,
-    order_count: value.order_count,
-    dataset_object_identity: object2.identity,
-    dataset_object_checksum: object2.checksum
-  };
+function storedReceiptForSelection(resolution) {
+  const receiptId = resolution.selection.receipt_ids[0];
+  return receiptId ? resolution.receipts.find((receipt) => receipt.receipt_id === receiptId) : undefined;
 }
-async function readBoundedObject(response, remainingBytes) {
-  if (!response.body)
-    return new Uint8Array;
-  const reader = response.body.getReader();
-  const chunks = [];
-  let total = 0;
-  while (true) {
-    const { done, value } = await reader.read();
-    if (done)
-      break;
-    total += value.byteLength;
-    if (total > remainingBytes) {
-      await reader.cancel();
-      throw new CryptoHftDataError("budget_max_bytes_exceeded");
-    }
-    chunks.push(value);
+async function runMarketDataVendorBackfill(input, dependencies) {
+  let request;
+  try {
+    const documents = input;
+    request = decodeBackfillRunDocuments({
+      request: documents.request,
+      requiredClock: documents.requiredClock
+    });
+  } catch {
+    return outcome(undefined, "request_invalid", "request_invalid");
   }
-  const bytes = new Uint8Array(total);
-  let offset = 0;
-  for (const chunk of chunks) {
-    bytes.set(chunk, offset);
-    offset += chunk.byteLength;
+  let initialResolution;
+  try {
+    initialResolution = await dependencies.archive.resolveSelection(request);
+    assertArchivePreflight(request, initialResolution);
+    const forwarderPreflight = await dependencies.forwarder.preflight({
+      authorizationId: request.productionAuthorizationId,
+      target: request.target
+    });
+    assertForwarderPreflight(request, forwarderPreflight, dependencies.clock.nowMs());
+  } catch {
+    return outcome(request, "archive_preflight_failed", "archive_preflight_failed");
   }
-  return bytes;
-}
-
-class CryptoHftDataAdapter {
-  baseUrl;
-  request;
-  nowMs;
-  decode;
-  profiles;
-  constructor(options = {}) {
-    this.baseUrl = options.baseUrl ?? CRYPTOHFTDATA_API_URL;
-    this.request = options.fetch ?? fetch;
-    this.nowMs = options.nowMs ?? Date.now;
-    this.decode = options.decode ?? decodeCryptoHftParquetZstd;
-    this.profiles = options.profiles ?? [];
+  if (initialResolution.selection.coverage_class === "complete") {
+    const receipt2 = storedReceiptForSelection(initialResolution);
+    return outcome(request, "already_covered", "qualified_coverage_complete", {
+      selection: initialResolution.selection,
+      ...receipt2 ? { receipt: receipt2 } : {}
+    });
+  }
+  if (resourcePolicyScopeExceeded(request)) {
+    return outcome(request, "capability_unsupported", "capability_unsupported", { reasonSubcode: "resource_policy_scope_exceeded" });
+  }
+  if (request.sourcePolicy === "fill_gaps" && (request.productPins?.capability_policy.policy_id !== CAPABILITY_POLICY.policy_id || request.productPins.capability_policy.policy_sha256 !== CAPABILITY_POLICY.policy_sha256)) {
+    return outcome(request, "capability_unsupported", "scope_unsupported", {
+      reasonSubcode: "fill_gaps_requires_capability_policy_v2"
+    });
+  }
+  let capability;
+  try {
+    capability = dependencies.providers.capabilityFor(request);
+  } catch {
+    return outcome(request, "capability_unsupported", "capability_probe_failed");
+  }
+  if (!capability) {
+    return outcome(request, "capability_unsupported", "scope_unsupported");
+  }
+  if (!request.providerPolicy.allowedAdapterVersions.includes(capability.adapterVersion)) {
+    return outcome(request, "capability_unsupported", "adapter_version_unpinned");
   }
-  capabilityFor(request) {
-    return cryptoHftDataCapabilityFor(request, this.profiles);
+  let credential;
+  try {
+    credential = await dependencies.credentials.resolve(capability.provider);
+  } catch {
+    return outcome(request, "credentials_missing", "credential_resolution_failed");
   }
-  async discoverSymbols(providerExchangeId) {
-    if (!/^[a-z0-9_]+$/.test(providerExchangeId)) {
-      throw new CryptoHftDataError("symbol_discovery_exchange_invalid");
-    }
-    const endpoint = new URL("/symbols", this.baseUrl);
-    endpoint.searchParams.set("exchange", providerExchangeId);
-    endpoint.searchParams.set("data_type", "orderbook");
-    let response;
-    try {
-      response = await this.request(endpoint);
-    } catch {
-      throw new CryptoHftDataError("symbol_discovery_failed");
-    }
-    if (!response.ok) {
-      throw new CryptoHftDataError("symbol_discovery_failed");
-    }
-    let body;
-    try {
-      body = await response.json();
-    } catch {
-      throw new CryptoHftDataError("symbol_discovery_response_invalid");
-    }
-    const record2 = body;
-    if (!body || typeof body !== "object" || Array.isArray(body) || String(record2.exchange).toLowerCase() !== providerExchangeId || String(record2.data_type).toLowerCase() !== "orderbook" || !Array.isArray(record2.symbols) || !record2.symbols.every((symbol2) => typeof symbol2 === "string" && /^[A-Z0-9_-]+$/.test(symbol2))) {
-      throw new CryptoHftDataError("symbol_discovery_response_invalid");
-    }
-    return [...new Set(record2.symbols)].sort();
+  if (credential === undefined || credential === null) {
+    return outcome(request, "credentials_missing", "provider_credentials_missing");
   }
-  async acquire(request, capability, credential) {
-    const apiKey = credential && typeof credential === "object" ? credential.apiKey : undefined;
-    if (typeof apiKey !== "string" || apiKey.length === 0) {
-      throw new CryptoHftDataError("credentials_invalid");
-    }
-    const paths = enumerateCryptoHftDataObjects(request, capability.providerExchangeId, capability.resolvedSymbol);
-    if (paths.length > request.budgets.maxFiles) {
-      throw new CryptoHftDataError("budget_max_files_exceeded");
+  let dataset;
+  let normalized;
+  try {
+    const acquisitionRequest = providerAcquisitionRequest(request);
+    dataset = await dependencies.providers.acquire(acquisitionRequest, capability, credential);
+    const bundleId = captureBundleId(request, capability, dataset);
+    normalized = await dependencies.providers.normalize(acquisitionRequest, capability, dataset, bundleId);
+    if (normalized.captureBundleId !== bundleId) {
+      return outcome(request, "vendor_fetch_failed", "vendor_fetch_failed", {
+        reasonSubcode: "capture_identity_mismatch"
+      });
     }
-    const started = this.nowMs();
-    const tokenResponse = await this.request(`${this.baseUrl}/jwt-token`, {
-      method: "POST",
-      headers: { "content-type": "application/json", "X-API-Key": apiKey }
+  } catch (error48) {
+    const reason = stableFailureReason(error48, "provider_dataset_invalid");
+    return outcome(request, "vendor_fetch_failed", "vendor_fetch_failed", {
+      reasonSubcode: reason.startsWith("budget_") ? "resource_limit_exceeded" : reason
     });
-    if (!tokenResponse.ok)
-      throw new CryptoHftDataError("jwt_issuance_failed");
-    const tokenBody = await tokenResponse.json();
-    if (typeof tokenBody.jwt_token !== "string" || !tokenBody.jwt_token) {
-      throw new CryptoHftDataError("jwt_response_invalid");
+  }
+  try {
+    const candidateBatches = buildForwarderBatches({
+      captureBundleId: normalized.captureBundleId,
+      deploymentId: "market-data-vendor-backfill",
+      rows: normalized.rows
+    });
+    if (!await submitAll(dependencies, candidateBatches)) {
+      return outcome(request, "archive_ingest_failed", "candidate_batch_rejected");
     }
-    let totalBytes = 0;
-    let totalRows = 0;
-    const objects = [];
-    const rows = [];
-    for (const path2 of paths) {
-      if (this.nowMs() - started > request.budgets.maxDurationMs) {
-        throw new CryptoHftDataError("budget_max_duration_exceeded");
-      }
-      const endpoint = new URL("/download", this.baseUrl);
-      endpoint.searchParams.set("file", path2);
-      const response = await this.request(endpoint, {
-        headers: { Authorization: `Bearer ${tokenBody.jwt_token}` }
-      });
-      if (!response.ok)
-        throw new CryptoHftDataError("object_download_failed");
-      const declaredBytes = Number(response.headers.get("content-length"));
-      if (Number.isFinite(declaredBytes) && totalBytes + declaredBytes > request.budgets.maxBytes) {
-        throw new CryptoHftDataError("budget_max_bytes_exceeded");
-      }
-      const bytes = await readBoundedObject(response, request.budgets.maxBytes - totalBytes);
-      totalBytes += bytes.byteLength;
-      if (totalBytes > request.budgets.maxBytes) {
-        throw new CryptoHftDataError("budget_max_bytes_exceeded");
-      }
-      const decoded = await this.decode(bytes);
-      totalRows += decoded.length;
-      if (totalRows > request.budgets.maxRows) {
-        throw new CryptoHftDataError("budget_max_rows_exceeded");
-      }
-      const object2 = {
-        identity: path2,
-        checksum: sha256Bytes(bytes),
-        bytes: bytes.byteLength,
-        rows: decoded.length
-      };
-      objects.push(object2);
-      for (const decodedRow of decoded) {
-        const parsed = parsedDatasetRow(decodedRow, object2);
-        validatedRow(request, parsed);
-        rows.push(parsed);
-      }
+  } catch {
+    return outcome(request, "archive_ingest_failed", "candidate_submission_failed");
+  }
+  let verification;
+  try {
+    verification = await dependencies.archive.verifyCandidate(request, normalized, normalized.captureBundleId, initialResolution);
+  } catch {
+    return outcome(request, "promotion_verification_failed", "candidate_query_failed");
+  }
+  if (!verification.passed || verification.captureBundleId !== normalized.captureBundleId || verification.canonicalSemanticDigest !== normalized.canonicalSemanticDigest || !verification.seamVerified || !verification.coverageVerified) {
+    return outcome(request, "promotion_verification_failed", verification.reasonCode ?? "semantic_verification_failed");
+  }
+  let receipt;
+  try {
+    receipt = buildPromotionReceipt(request, capability, normalized, verification, dependencies.clock.nowMs());
+    const [batch] = buildForwarderBatches({
+      captureBundleId: normalized.captureBundleId,
+      deploymentId: "market-data-vendor-backfill",
+      rows: [promotionReceiptToArchiveRow(receipt)]
+    });
+    if (!batch || !await submitAll(dependencies, [batch])) {
+      return outcome(request, "archive_ingest_failed", "promotion_commit_failed");
     }
-    if (this.nowMs() - started > request.budgets.maxDurationMs) {
-      throw new CryptoHftDataError("budget_max_duration_exceeded");
+    const qualification = finalizeQualificationEvent({
+      capture_bundle_id: receipt.capture_bundle_id,
+      state: "qualified",
+      receipt_id: receipt.receipt_id,
+      promotion_identity_sha256: receipt.promotion_identity_sha256,
+      window: receipt.window,
+      event_at: receipt.verified_at,
+      reason_code: "promotion_verified"
+    });
+    const [qualificationBatch] = buildForwarderBatches({
+      captureBundleId: normalized.captureBundleId,
+      deploymentId: "market-data-vendor-backfill",
+      rows: [qualificationEventToArchiveRow(qualification)]
+    });
+    if (!qualificationBatch || !await submitAll(dependencies, [qualificationBatch])) {
+      return outcome(request, "archive_ingest_failed", "qualification_commit_failed", { receipt });
     }
-    return {
-      objects,
-      rows,
-      vendorSemanticDigest: sha256Canonical(rows)
-    };
+  } catch {
+    return outcome(request, "archive_ingest_failed", "promotion_commit_failed");
   }
-  async normalize(request, capability, dataset, captureBundleId2) {
-    const profile = this.profiles.find((candidate) => candidate.exchange === request.scope.exchange.trim().toLowerCase() && candidate.tradingPair === request.scope.tradingPair && candidate.sourceSymbol === request.scope.sourceSymbol && candidate.marketType === request.scope.marketType && candidate.providerExchangeId === capability.providerExchangeId);
-    if (!profile) {
-      throw new CryptoHftDataError("profile_semantics_unavailable");
-    }
-    const samples = reconstructCryptoHftDataOrderBooks(request, dataset.rows, profile);
-    const context2 = {
-      source: EXTERNAL_BACKFILL_SOURCE,
+  let finalResolution;
+  try {
+    finalResolution = await dependencies.archive.resolveSelection(request);
+    assertArchivePreflight(request, finalResolution);
+  } catch (error48) {
+    return outcome(request, "promotion_verification_failed", "post_promotion_selection_failed", {
+      receipt,
+      reasonSubcode: stableFailureReason(error48, "archive_selection_resolution_failed")
+    });
+  }
+  if (finalResolution.selection.coverage_class !== "complete") {
+    return outcome(request, "promotion_verification_failed", "qualified_coverage_incomplete", { receipt, selection: finalResolution.selection });
+  }
+  if (finalResolution.selection.bundles.some((bundle) => bundle.capture_bundle_id === receipt.capture_bundle_id && bundle.capture_origin === "vendor_historical_backfill" && bundle.qualification?.receipt_id === receipt.receipt_id) === false) {
+    return outcome(request, "promotion_verification_failed", "promoted_receipt_not_selected", { receipt, selection: finalResolution.selection });
+  }
+  try {
+    if (!request.wire)
+      throw new Error("decoded request wire is missing");
+    const [selectionBatch] = buildForwarderBatches({
+      captureBundleId: receipt.capture_bundle_id,
       deploymentId: "market-data-vendor-backfill",
-      captureBundleId: captureBundleId2,
-      exchange: request.scope.exchange,
-      symbol: request.scope.tradingPair,
-      tradingPair: request.scope.tradingPair,
-      sourceSymbol: request.scope.sourceSymbol,
-      assetType: request.scope.marketType,
-      feed: "ORDERBOOK",
-      provider: "cryptohftdata",
-      sourceMode: HISTORICAL_VENDOR_SOURCE_MODE,
-      schemaVersion: MARKET_CAPTURE_SCHEMA_VERSION,
-      checksumAlgorithm: CHECKSUM_ALGORITHM,
-      provenanceComplete: true
-    };
-    const rows = samples.flatMap((sample) => {
-      const rawCapture = {
-        rawCaptureId: sha256Canonical({
-          capture_bundle_id: captureBundleId2,
-          dataset_object_identity: sample.datasetObjectIdentity,
-          dataset_object_checksum: sample.datasetObjectChecksum,
-          source_time_ms: sample.sourceTimeMs,
-          target_time_ms: sample.targetTimeMs
-        }),
-        rawCaptureScope: VENDOR_DATASET_RAW_CAPTURE_SCOPE,
-        rawChecksum: sample.datasetObjectChecksum,
-        redactedPayload: {
-          dataset_object_identity: sample.datasetObjectIdentity,
-          dataset_object_checksum: sample.datasetObjectChecksum
-        },
-        eventTimeMs: sample.sourceTimeMs,
-        receivedTimeMs: sample.receivedTimeMs,
-        checksumAlgorithm: CHECKSUM_ALGORITHM
-      };
-      const canonical = buildCanonicalOrderBookRows({
-        context: context2,
-        rawCapture,
-        depthLimit: request.depth,
-        constructionMode: request.constructionMode,
-        snapshot: {
-          bids: sample.bids,
-          asks: sample.asks,
-          timestamp: sample.sourceTimeMs,
-          receivedTimestamp: sample.receivedTimeMs,
-          exchange: request.scope.exchange,
-          symbol: request.scope.tradingPair,
-          depthLimit: request.depth,
-          sequence: sample.sequence
-        }
-      });
-      return [...canonical.levels, canonical.summary];
+      rows: [
+        archiveSelectionToArchiveRow(request.wire, finalResolution.selection)
+      ]
     });
-    return {
-      captureBundleId: captureBundleId2,
-      objects: dataset.objects,
-      rows,
-      vendorSemanticDigest: dataset.vendorSemanticDigest,
-      canonicalSemanticDigest: semanticDigest(rows)
-    };
+    if (!selectionBatch || !await submitAll(dependencies, [selectionBatch])) {
+      return outcome(request, "archive_ingest_failed", "selection_persistence_failed", { receipt, selection: finalResolution.selection });
+    }
+  } catch {
+    return outcome(request, "archive_ingest_failed", "selection_persistence_failed", { receipt, selection: finalResolution.selection });
   }
+  return outcome(request, "promoted", "promotion_qualified", {
+    receipt,
+    selection: finalResolution.selection
+  });
 }
 
 // src/helpers/market-data-vendor-backfill/forwarder-client.ts
@@ -33081,8 +32855,8 @@ function validateReleaseIdentity(release) {
   return release;
 }
 function bakedReleaseIdentity() {
-  const packageVersion = "0.2.48";
-  const gitHead = "3b42f32422c587afbdfab6ed16b0969980eaaddb";
+  const packageVersion = "0.2.50";
+  const gitHead = "41dbe7cc296da1c5a7964dca8f418800522f27e5";
   return validateReleaseIdentity({ packageVersion, gitHead });
 }
 function readOptionalEnvironment(environment, name) {
@@ -33106,7 +32880,10 @@ function createBackfillDependenciesFromEnv(environment, sensitiveValues = new Se
       password: clickhousePassword
     })),
     providers: new CryptoHftDataAdapter({
-      profiles: [CRYPTOHFTDATA_OKX_SPOT_ARBUSDT_PROFILE]
+      profiles: [
+        CRYPTOHFTDATA_OKX_SPOT_ARBUSDC_PROFILE,
+        CRYPTOHFTDATA_OKX_SPOT_ARBUSDT_PROFILE
+      ]
     }),
     forwarder: createArchiveForwarderClient({
       url: forwarderUrl,
@@ -33313,4 +33090,4 @@ export {
   createBackfillDependenciesFromEnv
 };
 
-//# debugId=D04AAF122F979D2864756E2164756E21
+//# debugId=7BCBC113F3C0009864756E2164756E21