@usherlabs/cex-broker 0.2.40 → 0.2.42

package/dist/commands/cli.js

@@ -6,25 +6,43 @@ var __getProtoOf = Object.getPrototypeOf;
 var __defProp = Object.defineProperty;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toESMCache_node;
+var __toESMCache_esm;
 var __toESM = (mod, isNodeMode, target) => {
+  var canCache = mod != null && typeof mod === "object";
+  if (canCache) {
+    var cache = isNodeMode ? __toESMCache_node ??= new WeakMap : __toESMCache_esm ??= new WeakMap;
+    var cached = cache.get(mod);
+    if (cached)
+      return cached;
+  }
   target = mod != null ? __create(__getProtoOf(mod)) : {};
   const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
   for (let key of __getOwnPropNames(mod))
     if (!__hasOwnProp.call(to, key))
       __defProp(to, key, {
-        get: () => mod[key],
+        get: __accessProp.bind(mod, key),
         enumerable: true
       });
+  if (canCache)
+    cache.set(mod, to);
   return to;
 };
 var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, {
       get: all[name],
       enumerable: true,
       configurable: true,
-      set: (newValue) => all[name] = () => newValue
+      set: __exportSetter.bind(all, name)
     });
 };
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
@@ -997,7 +1015,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
         this._exitCallback = (err) => {
           if (err.code !== "commander.executeSubCommandAsync") {
             throw err;
-          } else {}
+          }
         };
       }
       return this;
@@ -50030,7 +50048,7 @@ var require_tracestate_impl = __commonJS((exports) => {
           const value = listMember.slice(i2 + 1, part.length);
           if ((0, tracestate_validators_1.validateKey)(key) && (0, tracestate_validators_1.validateValue)(value)) {
             agg.set(key, value);
-          } else {}
+          }
         }
         return agg;
       }, new Map);
@@ -59163,7 +59181,7 @@ var require_TraceState = __commonJS((exports) => {
           const value = listMember.slice(i2 + 1, part.length);
           if ((0, validators_1.validateKey)(key) && (0, validators_1.validateValue)(value)) {
             agg.set(key, value);
-          } else {}
+          }
         }
         return agg;
       }, new Map);
@@ -314993,6 +315011,20 @@ function validateDeposit(policy, exchange, network, ticker) {
   return { valid: true };
 }
 
+// src/helpers/broker-execution-archive/rows.ts
+import { createHash as createHash2 } from "node:crypto";
+
+// src/helpers/shared/guards.ts
+function isRecord(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function asRecord(value) {
+  return isRecord(value) ? value : undefined;
+}
+
+// src/helpers/broker-execution-archive/redact.ts
+import { createHash } from "node:crypto";
+
 // src/helpers/shared/errors.ts
 var MAX_ERROR_DETAIL_LENGTH = 512;
 var REDACTED_ERROR_MESSAGE = "redacted_error";
@@ -315052,226 +315084,7 @@ function safeLogRedactedError(context2, error) {
   }
 }
 
-// src/helpers/shared/guards.ts
-function isRecord(value) {
-  return value !== null && typeof value === "object" && !Array.isArray(value);
-}
-function asRecord(value) {
-  return isRecord(value) ? value : undefined;
-}
-
-// src/helpers/order-telemetry.ts
-var NUMERIC_METRICS = [
-  ["requestedQuantity", "cex_market_action_requested_quantity"],
-  ["requestedNotional", "cex_market_action_requested_notional"],
-  ["executedBaseQuantity", "cex_market_action_executed_base_quantity"],
-  ["executedQuoteQuantity", "cex_market_action_executed_quote_quantity"],
-  ["averageExecutionPrice", "cex_market_action_average_execution_price"],
-  ["filledAmount", "cex_market_action_filled_amount"],
-  ["remainingAmount", "cex_market_action_remaining_amount"],
-  ["feeAmount", "cex_market_action_fee_amount"],
-  ["feeRate", "cex_market_action_fee_rate"]
-];
-async function emitOrderExecutionTelemetry(otelMetrics, context2, order, error) {
-  try {
-    const telemetry = buildOrderExecutionTelemetry(context2, order, error);
-    log.info("CEX market action execution telemetry", telemetry);
-    const labels = {
-      action: telemetry.action,
-      cex: telemetry.cex,
-      account: telemetry.accountLabel,
-      symbol: telemetry.symbol,
-      side: telemetry.side,
-      order_type: telemetry.orderType,
-      status: telemetry.status
-    };
-    await otelMetrics?.recordCounter("cex_market_action_executions_total", 1, {
-      ...labels,
-      result: error ? "error" : "ok"
-    });
-    for (const [key, metricName] of NUMERIC_METRICS) {
-      const value = telemetry[key];
-      if (typeof value === "number" && Number.isFinite(value)) {
-        await otelMetrics?.recordHistogram(metricName, value, labels);
-      }
-    }
-    return telemetry;
-  } catch (telemetryError) {
-    try {
-      log.error("Failed to emit CEX order telemetry", {
-        error: telemetryError
-      });
-    } catch {}
-    return;
-  }
-}
-function buildOrderExecutionTelemetry(context2, order, error) {
-  const record = asRecord(order);
-  const info = asRecord(record?.info);
-  const fees = getFees(record, info);
-  const fee = summarizeFees(fees);
-  const executedBaseQuantity = firstNumber(record?.filled, info?.executedQty, info?.cumExecQty) ?? computeFilledFromAmount(record);
-  const executedQuoteQuantity = firstNumber(record?.cost, info?.cummulativeQuoteQty, info?.cumQuote, info?.cumExecValue);
-  const averageExecutionPrice = firstNumber(record?.average, info?.avgPrice) ?? computeAveragePrice(executedBaseQuantity, executedQuoteQuantity);
-  const exchangeTimestamp = normalizeTimestamp(firstValue(record?.timestamp, info?.time, info?.transactTime, record?.datetime));
-  const status = firstString(record?.status, info?.status) ?? (error ? "failed" : "unknown");
-  const errorRecord = error instanceof Error ? error : undefined;
-  return compactUndefined({
-    event: "cex_market_action_execution",
-    action: context2.action,
-    cex: context2.cex.trim().toLowerCase() || "unknown",
-    accountLabel: context2.accountLabel ?? "unknown",
-    symbol: firstString(record?.symbol, info?.symbol, context2.symbol) ?? "unknown",
-    side: firstString(record?.side, info?.side, context2.side) ?? "unknown",
-    orderType: firstString(record?.type, info?.type, context2.orderType) ?? "unknown",
-    orderId: firstString(record?.id, info?.orderId, info?.orderID),
-    orderAuthor: context2.orderAuthor,
-    clientOrderId: firstString(context2.clientOrderId, record?.clientOrderId, record?.clientOrderID, record?.clientOid, info?.clientOrderId, info?.clientOrderID, info?.clientOid),
-    idempotencyId: context2.idempotencyId,
-    makerActionId: context2.makerActionId,
-    status: status.toLowerCase(),
-    requestedQuantity: context2.requestedQuantity ?? firstNumber(record?.amount),
-    requestedNotional: context2.requestedNotional,
-    executedBaseQuantity,
-    executedQuoteQuantity,
-    averageExecutionPrice,
-    filledAmount: firstNumber(record?.filled, info?.executedQty),
-    remainingAmount: firstNumber(record?.remaining, info?.remainingQty),
-    feeAmount: fee.amount,
-    feeCurrency: fee.currency,
-    feeRate: fee.rate,
-    exchangeTimestamp,
-    brokerObservedTimestamp: context2.brokerObservedTimestamp ?? new Date().toISOString(),
-    errorType: errorRecord?.name,
-    errorMessage: errorRecord ? REDACTED_ERROR_MESSAGE : undefined
-  });
-}
-function emitOrderExecutionTelemetryInBackground(otelMetrics, context2, order, error) {
-  emitOrderExecutionTelemetry(otelMetrics, context2, order, error).catch((telemetryError) => {
-    try {
-      log.warn("Telemetry emit failed", { error: telemetryError });
-    } catch {
-      console.warn("Telemetry emit failed", telemetryError);
-    }
-  });
-}
-function extractOrderTelemetryIds(params) {
-  const record = params ?? {};
-  return {
-    clientOrderId: firstString(record.clientOrderId, record.clientOrderID, record.newClientOrderId, record.clientOid),
-    idempotencyId: firstString(record.idempotencyId, record.idempotencyID, record.idempotencyKey, record.requestId, record.requestID),
-    makerActionId: firstString(record.makerActionId, record.maker_action_id, record.actionId, record.action_id)
-  };
-}
-function firstValue(...values2) {
-  return values2.find((value) => value !== undefined && value !== null);
-}
-function firstString(...values2) {
-  for (const value of values2) {
-    if (typeof value === "string" && value.trim()) {
-      return value.trim();
-    }
-    if (typeof value === "number" && Number.isFinite(value)) {
-      return String(value);
-    }
-  }
-  return;
-}
-function firstNumber(...values2) {
-  for (const value of values2) {
-    const numberValue = typeof value === "number" ? value : typeof value === "string" && value.trim() ? Number(value) : Number.NaN;
-    if (Number.isFinite(numberValue)) {
-      return numberValue;
-    }
-  }
-  return;
-}
-function computeFilledFromAmount(record) {
-  const amount = firstNumber(record?.amount);
-  const remaining = firstNumber(record?.remaining);
-  if (amount === undefined || remaining === undefined) {
-    return;
-  }
-  return amount - remaining;
-}
-function computeAveragePrice(executedBaseQuantity, executedQuoteQuantity) {
-  if (executedBaseQuantity === undefined || executedQuoteQuantity === undefined || executedBaseQuantity === 0) {
-    return;
-  }
-  return executedQuoteQuantity / executedBaseQuantity;
-}
-function normalizeTimestamp(value) {
-  if (typeof value === "string" && value.trim()) {
-    return value.trim();
-  }
-  const timestamp = firstNumber(value);
-  if (timestamp === undefined) {
-    return;
-  }
-  const date = new Date(timestamp);
-  return Number.isNaN(date.getTime()) ? undefined : date.toISOString();
-}
-function getFees(record, info) {
-  const fees = [];
-  if (record?.fee)
-    fees.push(record.fee);
-  if (Array.isArray(record?.fees))
-    fees.push(...record.fees);
-  if (Array.isArray(record?.trades)) {
-    for (const trade of record.trades) {
-      const tradeRecord = asRecord(trade);
-      if (tradeRecord?.fee)
-        fees.push(tradeRecord.fee);
-      if (Array.isArray(tradeRecord?.fees))
-        fees.push(...tradeRecord.fees);
-    }
-  }
-  if (Array.isArray(info?.fills)) {
-    for (const fill of info.fills) {
-      const fillRecord = asRecord(fill);
-      const commission = firstNumber(fillRecord?.commission);
-      if (commission !== undefined) {
-        fees.push({
-          cost: commission,
-          currency: firstString(fillRecord?.commissionAsset)
-        });
-      }
-    }
-  }
-  return fees;
-}
-function summarizeFees(fees) {
-  let amount = 0;
-  let amountFound = false;
-  let currency;
-  let rate;
-  for (const rawFee of fees) {
-    const fee = asRecord(rawFee);
-    if (!fee)
-      continue;
-    const cost = firstNumber(fee.cost, fee.amount);
-    if (cost !== undefined) {
-      amount += cost;
-      amountFound = true;
-    }
-    currency ??= firstString(fee.currency);
-    rate ??= firstNumber(fee.rate);
-  }
-  return {
-    amount: amountFound ? amount : undefined,
-    currency,
-    rate
-  };
-}
-function compactUndefined(record) {
-  return Object.fromEntries(Object.entries(record).filter(([, value]) => value !== undefined));
-}
-
-// src/helpers/broker-execution-archive/rows.ts
-import { createHash as createHash2 } from "node:crypto";
-
 // src/helpers/broker-execution-archive/redact.ts
-import { createHash } from "node:crypto";
 var SECRET_KEY_PATTERN = /\b(api[_-]?key|api[_-]?secret|secret|signature|passphrase|password|token|credential)\b/i;
 var SECRET_VALUE_PATTERN = /(\b(?:apiKey|api_key|apiSecret|api_secret|secret|signature|passphrase|password|token)\b\s*[=:]\s*)[^\s&,;)}\]]+/gi;
 var SECRET_JSON_PATTERN = /("(?:apiKey|api_key|apiSecret|api_secret|secret|signature|passphrase|password|token)"\s*:\s*")[^"]*(")/gi;
@@ -315344,9 +315157,11 @@ var ARCHIVE_SCHEMA_VERSION = "1";
 var FILL_EVENT_KIND = "trade_history_fill";
 var ACCOUNT_BALANCE_SCOPE = "spot";
 var ACCOUNT_BALANCE_PRECISION_BASIS = "ccxt_normalized_number";
+var USER_ASSET_BALANCE_SCOPE = "user_asset";
+var USER_ASSET_PRECISION_BASIS = "venue_raw_string";
 
 // src/helpers/broker-execution-archive/rows.ts
-function firstString2(...values2) {
+function firstString(...values2) {
   for (const value of values2) {
     if (typeof value === "string" && value.trim()) {
       return value.trim();
@@ -315357,7 +315172,7 @@ function firstString2(...values2) {
   }
   return;
 }
-function firstNumber2(...values2) {
+function firstNumber(...values2) {
   for (const value of values2) {
     const numeric = typeof value === "number" ? value : typeof value === "string" && value.trim() ? Number(value) : Number.NaN;
     if (Number.isFinite(numeric)) {
@@ -315366,11 +315181,11 @@ function firstNumber2(...values2) {
   }
   return;
 }
-function normalizeTimestamp2(value) {
+function normalizeTimestamp(value) {
   if (typeof value === "string" && value.trim()) {
     return value.trim();
   }
-  const ms = firstNumber2(value);
+  const ms = firstNumber(value);
   if (ms === undefined) {
     return;
   }
@@ -315477,7 +315292,7 @@ function normalizeCcxtBalanceForArchive(balance) {
     }
   }
   return {
-    exchangeTimestamp: normalizeTimestamp2(record.timestamp ?? record.datetime),
+    exchangeTimestamp: normalizeTimestamp(record.timestamp ?? record.datetime),
     reportedAssets: [...reportedAssets].sort(),
     assetEntryAssets: [...assetEntryAssets].sort(),
     freeBalances: sortedBalanceMap(maps.free),
@@ -315500,7 +315315,7 @@ function buildAccountBalanceSnapshotRow(input) {
   })).digest("hex");
   return {
     table: "broker_account.balance_snapshots",
-    row: compactUndefined2({
+    row: compactUndefined({
       broker_observed_timestamp: tags.broker_observed_timestamp,
       exchange_timestamp: balance.exchangeTimestamp,
       source: tags.source,
@@ -315522,7 +315337,101 @@ function buildAccountBalanceSnapshotRow(input) {
     })
   };
 }
-function compactUndefined2(record) {
+var USER_ASSET_BUCKETS = {
+  freeBalances: "free",
+  lockedBalances: "locked",
+  freezeBalances: "freeze",
+  withdrawingBalances: "withdrawing"
+};
+function userAssetQuantity(value) {
+  if (typeof value === "number") {
+    return decimalString(value);
+  }
+  if (typeof value !== "string") {
+    return;
+  }
+  const trimmed = value.trim();
+  if (!trimmed || !Number.isFinite(Number(trimmed))) {
+    return;
+  }
+  return trimmed;
+}
+function normalizeBinanceUserAssetsForArchive(response) {
+  if (!Array.isArray(response)) {
+    throw new Error("binance_user_asset_malformed_response: getUserAsset did not return an array");
+  }
+  const reportedAssets = [];
+  const incompleteAssets = [];
+  const maps = {
+    freeBalances: {},
+    lockedBalances: {},
+    freezeBalances: {},
+    withdrawingBalances: {}
+  };
+  for (const entry of response) {
+    const record = asRecord(entry);
+    const asset = typeof record?.asset === "string" ? record.asset.trim() : undefined;
+    if (!record || !asset) {
+      throw new Error("binance_user_asset_malformed_response: getUserAsset entry has no asset key");
+    }
+    if (reportedAssets.includes(asset)) {
+      throw new Error(`binance_user_asset_malformed_response: getUserAsset returned duplicate entries for ${asset}`);
+    }
+    reportedAssets.push(asset);
+    let complete = true;
+    for (const [field, venueKey] of Object.entries(USER_ASSET_BUCKETS)) {
+      const quantity = userAssetQuantity(record[venueKey]);
+      if (quantity === undefined) {
+        complete = false;
+        continue;
+      }
+      maps[field][asset] = quantity;
+    }
+    if (!complete) {
+      incompleteAssets.push(asset);
+    }
+  }
+  return {
+    reportedAssets: reportedAssets.sort(),
+    incompleteAssets: incompleteAssets.sort(),
+    freeBalances: sortedBalanceMap(maps.freeBalances),
+    lockedBalances: sortedBalanceMap(maps.lockedBalances),
+    freezeBalances: sortedBalanceMap(maps.freezeBalances),
+    withdrawingBalances: sortedBalanceMap(maps.withdrawingBalances)
+  };
+}
+function buildUserAssetSnapshotRow(input) {
+  const { tags, userAssets } = input;
+  const observationId = createHash2("sha256").update(JSON.stringify({
+    deployment_id: tags.deployment_id,
+    exchange: tags.exchange,
+    account_selector: tags.account_selector,
+    balance_scope: USER_ASSET_BALANCE_SCOPE,
+    broker_observed_timestamp: tags.broker_observed_timestamp,
+    userAssets
+  })).digest("hex");
+  return {
+    table: "broker_account.user_asset_snapshots",
+    row: {
+      broker_observed_timestamp: tags.broker_observed_timestamp,
+      source: tags.source,
+      deployment_id: tags.deployment_id,
+      schema_version: ARCHIVE_SCHEMA_VERSION,
+      exchange: tags.exchange,
+      account_selector: tags.account_selector,
+      balance_scope: USER_ASSET_BALANCE_SCOPE,
+      observation_id: observationId,
+      reported_assets: userAssets.reportedAssets,
+      incomplete_assets: userAssets.incompleteAssets,
+      free_balances: userAssets.freeBalances,
+      locked_balances: userAssets.lockedBalances,
+      freeze_balances: userAssets.freezeBalances,
+      withdrawing_balances: userAssets.withdrawingBalances,
+      precision_basis: USER_ASSET_PRECISION_BASIS
+    }
+  };
+}
+function compactUndefined(record) {
   return Object.fromEntries(Object.entries(record).filter(([, value]) => value !== undefined));
 }
 function buildCommonArchiveTags(input) {
@@ -315539,7 +315448,7 @@ function buildOrderEventArchiveRow(input) {
   const { tags, telemetry, action } = input;
   return {
     table: "broker_execution.order_events",
-    row: compactUndefined2({
+    row: compactUndefined({
       ...tags,
       event_kind: input.eventKind ?? "execute_action",
       action,
@@ -315576,35 +315485,35 @@ function buildSubscribeStreamArchiveRow(input) {
   const info = asRecord(record?.info);
   return {
     table: "broker_execution.order_events",
-    row: compactUndefined2({
+    row: compactUndefined({
       ...input.tags,
       event_kind: "subscribe_stream",
       subscription_type: input.subscriptionType,
-      order_id: firstString2(record?.id, record?.orderId, record?.i, info?.orderId, info?.i),
-      client_order_id: firstString2(record?.clientOrderId, record?.clientOrderID, record?.c, info?.clientOrderId, info?.c),
-      status: firstString2(record?.status, record?.X, info?.status, info?.X)?.toLowerCase(),
+      order_id: firstString(record?.id, record?.orderId, record?.i, info?.orderId, info?.i),
+      client_order_id: firstString(record?.clientOrderId, record?.clientOrderID, record?.c, info?.clientOrderId, info?.c),
+      status: firstString(record?.status, record?.X, info?.status, info?.X)?.toLowerCase(),
       payload_json: JSON.stringify(redactedPayload)
     })
   };
 }
 function quantityString(...values2) {
-  return firstString2(...values2);
+  return firstString(...values2);
 }
 function extractBinanceInternalTransferId(response) {
   const record = asRecord(response);
-  return firstString2(record?.txnId, record?.tranId);
+  return firstString(record?.txnId, record?.tranId);
 }
 function buildTransferEventArchiveRow(input) {
   const { tags, transfer } = input;
   return {
     table: "broker_execution.transfer_events",
-    row: compactUndefined2({
+    row: compactUndefined({
       ...tags,
       schema_version: ARCHIVE_SCHEMA_VERSION,
       event_kind: transfer.eventKind,
       lifecycle_action: transfer.lifecycleAction,
       status: transfer.status ?? "",
-      asset_symbol: tags.symbol,
+      asset_symbol: transfer.assetSymbol ?? tags.symbol,
       amount: transfer.amount,
       address: transfer.address,
       network: transfer.network,
@@ -315624,18 +315533,18 @@ function normalizeCcxtTransactionForArchive(transaction) {
   const record = asRecord(transaction);
   const info = asRecord(record?.info);
   const fee = asRecord(record?.fee);
-  return compactUndefined2({
-    externalId: firstString2(record?.id, info?.id, record?.txid, info?.txId),
-    clientWithdrawalId: firstString2(info?.withdrawOrderId),
-    txid: firstString2(record?.txid, info?.txId, info?.txid, info?.tx_hash),
-    address: firstString2(record?.address, record?.addressTo, info?.address),
-    network: firstString2(record?.network, info?.network),
+  return compactUndefined({
+    externalId: firstString(record?.id, info?.id, record?.txid, info?.txId),
+    clientWithdrawalId: firstString(info?.withdrawOrderId),
+    txid: firstString(record?.txid, info?.txId, info?.txid, info?.tx_hash),
+    address: firstString(record?.address, record?.addressTo, info?.address),
+    network: firstString(record?.network, info?.network),
     amount: quantityString(info?.amount, record?.amount),
-    assetSymbol: firstString2(record?.currency, info?.coin, info?.asset),
-    status: firstString2(record?.status, info?.status)?.toLowerCase(),
+    assetSymbol: firstString(record?.currency, info?.coin, info?.asset),
+    status: firstString(record?.status, info?.status)?.toLowerCase(),
     feeAmount: quantityString(fee?.cost, record?.feeCost),
-    feeCurrency: firstString2(fee?.currency, record?.feeCurrency),
-    exchangeTimestamp: normalizeTimestamp2(firstValueForTransfer(record?.timestamp, record?.datetime, info?.applyTime))
+    feeCurrency: firstString(fee?.currency, record?.feeCurrency),
+    exchangeTimestamp: normalizeTimestamp(firstValueForTransfer(record?.timestamp, record?.datetime, info?.applyTime))
   });
 }
 function firstValueForTransfer(...values2) {
@@ -315645,7 +315554,7 @@ function buildFillEventArchiveRow(input) {
   const { tags, fill } = input;
   return {
     table: "broker_execution.fill_events",
-    row: compactUndefined2({
+    row: compactUndefined({
       ...tags,
       schema_version: ARCHIVE_SCHEMA_VERSION,
       event_kind: FILL_EVENT_KIND,
@@ -315671,18 +315580,18 @@ function normalizeCcxtTradeForArchive(trade) {
   const info = asRecord(record?.info);
   const fee = asRecord(record?.fee);
   return {
-    orderId: firstString2(record?.order, info?.orderId, info?.orderID),
-    clientOrderId: firstString2(record?.clientOrderId, info?.clientOrderId, info?.origClientOrderId),
-    fillId: firstString2(record?.id, info?.id, info?.tradeId),
-    side: firstString2(record?.side, info?.side)?.toLowerCase(),
-    orderType: firstString2(record?.type, info?.type)?.toLowerCase(),
+    orderId: firstString(record?.order, info?.orderId, info?.orderID),
+    clientOrderId: firstString(record?.clientOrderId, info?.clientOrderId, info?.origClientOrderId),
+    fillId: firstString(record?.id, info?.id, info?.tradeId),
+    side: firstString(record?.side, info?.side)?.toLowerCase(),
+    orderType: firstString(record?.type, info?.type)?.toLowerCase(),
     price: quantityString(info?.price, record?.price),
     baseQuantity: quantityString(info?.qty, record?.amount),
     quoteQuantity: quantityString(info?.quoteQty, record?.cost),
     feeAmount: quantityString(fee?.cost, info?.commission),
-    feeCurrency: firstString2(fee?.currency, info?.commissionAsset),
+    feeCurrency: firstString(fee?.currency, info?.commissionAsset),
     feeRate: quantityString(fee?.rate),
-    exchangeTimestamp: normalizeTimestamp2(firstValueForTransfer(record?.timestamp, record?.datetime, info?.time)),
+    exchangeTimestamp: normalizeTimestamp(firstValueForTransfer(record?.timestamp, record?.datetime, info?.time)),
     payload: trade
   };
 }
@@ -315691,7 +315600,7 @@ function buildMarketMetadataSnapshotRow(input) {
   const metadataHash = hashMarketMetadata(redactedSnapshot);
   return {
     table: "broker_execution.market_metadata_snapshots",
-    row: compactUndefined2({
+    row: compactUndefined({
       ...input.tags,
       client_order_id: input.clientOrderId,
       order_id: input.orderId,
@@ -315703,10 +315612,209 @@ function buildMarketMetadataSnapshotRow(input) {
   };
 }
 
+// src/helpers/order-telemetry.ts
+var NUMERIC_METRICS = [
+  ["requestedQuantity", "cex_market_action_requested_quantity"],
+  ["requestedNotional", "cex_market_action_requested_notional"],
+  ["executedBaseQuantity", "cex_market_action_executed_base_quantity"],
+  ["executedQuoteQuantity", "cex_market_action_executed_quote_quantity"],
+  ["averageExecutionPrice", "cex_market_action_average_execution_price"],
+  ["filledAmount", "cex_market_action_filled_amount"],
+  ["remainingAmount", "cex_market_action_remaining_amount"],
+  ["feeAmount", "cex_market_action_fee_amount"],
+  ["feeRate", "cex_market_action_fee_rate"]
+];
+async function emitOrderExecutionTelemetry(otelMetrics, context2, order, error) {
+  try {
+    const telemetry = buildOrderExecutionTelemetry(context2, order, error);
+    log.info("CEX market action execution telemetry", telemetry);
+    const labels = {
+      action: telemetry.action,
+      cex: telemetry.cex,
+      account: telemetry.accountLabel,
+      symbol: telemetry.symbol,
+      side: telemetry.side,
+      order_type: telemetry.orderType,
+      status: telemetry.status
+    };
+    await otelMetrics?.recordCounter("cex_market_action_executions_total", 1, {
+      ...labels,
+      result: error ? "error" : "ok"
+    });
+    for (const [key, metricName] of NUMERIC_METRICS) {
+      const value = telemetry[key];
+      if (typeof value === "number" && Number.isFinite(value)) {
+        await otelMetrics?.recordHistogram(metricName, value, labels);
+      }
+    }
+    return telemetry;
+  } catch (telemetryError) {
+    try {
+      log.error("Failed to emit CEX order telemetry", {
+        error: telemetryError
+      });
+    } catch {}
+    return;
+  }
+}
+function buildOrderExecutionTelemetry(context2, order, error) {
+  const record = asRecord(order);
+  const info = asRecord(record?.info);
+  const fees = getFees(record, info);
+  const fee = summarizeFees(fees);
+  const executedBaseQuantity = firstNumber2(record?.filled, info?.executedQty, info?.cumExecQty) ?? computeFilledFromAmount(record);
+  const executedQuoteQuantity = firstNumber2(record?.cost, info?.cummulativeQuoteQty, info?.cumQuote, info?.cumExecValue);
+  const averageExecutionPrice = firstNumber2(record?.average, info?.avgPrice) ?? computeAveragePrice(executedBaseQuantity, executedQuoteQuantity);
+  const exchangeTimestamp = normalizeTimestamp(firstValue(record?.timestamp, info?.time, info?.transactTime, record?.datetime));
+  const status = firstString2(record?.status, info?.status) ?? (error ? "failed" : "unknown");
+  const errorRecord = error instanceof Error ? error : undefined;
+  return compactUndefined2({
+    event: "cex_market_action_execution",
+    action: context2.action,
+    cex: context2.cex.trim().toLowerCase() || "unknown",
+    accountLabel: context2.accountLabel ?? "unknown",
+    symbol: firstString2(record?.symbol, info?.symbol, context2.symbol) ?? "unknown",
+    side: firstString2(record?.side, info?.side, context2.side) ?? "unknown",
+    orderType: firstString2(record?.type, info?.type, context2.orderType) ?? "unknown",
+    orderId: firstString2(record?.id, info?.orderId, info?.orderID),
+    orderAuthor: context2.orderAuthor,
+    clientOrderId: firstString2(context2.clientOrderId, record?.clientOrderId, record?.clientOrderID, record?.clientOid, info?.clientOrderId, info?.clientOrderID, info?.clientOid),
+    idempotencyId: context2.idempotencyId,
+    makerActionId: context2.makerActionId,
+    status: status.toLowerCase(),
+    requestedQuantity: context2.requestedQuantity ?? firstNumber2(record?.amount),
+    requestedNotional: context2.requestedNotional,
+    executedBaseQuantity,
+    executedQuoteQuantity,
+    averageExecutionPrice,
+    filledAmount: firstNumber2(record?.filled, info?.executedQty),
+    remainingAmount: firstNumber2(record?.remaining, info?.remainingQty),
+    feeAmount: fee.amount,
+    feeCurrency: fee.currency,
+    feeRate: fee.rate,
+    exchangeTimestamp,
+    brokerObservedTimestamp: context2.brokerObservedTimestamp ?? new Date().toISOString(),
+    errorType: errorRecord?.name,
+    errorMessage: errorRecord ? REDACTED_ERROR_MESSAGE : undefined
+  });
+}
+function emitOrderExecutionTelemetryInBackground(otelMetrics, context2, order, error) {
+  emitOrderExecutionTelemetry(otelMetrics, context2, order, error).catch((telemetryError) => {
+    try {
+      log.warn("Telemetry emit failed", { error: telemetryError });
+    } catch {
+      console.warn("Telemetry emit failed", telemetryError);
+    }
+  });
+}
+function extractOrderTelemetryIds(params) {
+  const record = params ?? {};
+  return {
+    clientOrderId: firstString2(record.clientOrderId, record.clientOrderID, record.newClientOrderId, record.clientOid),
+    idempotencyId: firstString2(record.idempotencyId, record.idempotencyID, record.idempotencyKey, record.requestId, record.requestID),
+    makerActionId: firstString2(record.makerActionId, record.maker_action_id, record.actionId, record.action_id)
+  };
+}
+function firstValue(...values2) {
+  return values2.find((value) => value !== undefined && value !== null);
+}
+function firstString2(...values2) {
+  for (const value of values2) {
+    if (typeof value === "string" && value.trim()) {
+      return value.trim();
+    }
+    if (typeof value === "number" && Number.isFinite(value)) {
+      return String(value);
+    }
+  }
+  return;
+}
+function firstNumber2(...values2) {
+  for (const value of values2) {
+    const numberValue = typeof value === "number" ? value : typeof value === "string" && value.trim() ? Number(value) : Number.NaN;
+    if (Number.isFinite(numberValue)) {
+      return numberValue;
+    }
+  }
+  return;
+}
+function computeFilledFromAmount(record) {
+  const amount = firstNumber2(record?.amount);
+  const remaining = firstNumber2(record?.remaining);
+  if (amount === undefined || remaining === undefined) {
+    return;
+  }
+  return amount - remaining;
+}
+function computeAveragePrice(executedBaseQuantity, executedQuoteQuantity) {
+  if (executedBaseQuantity === undefined || executedQuoteQuantity === undefined || executedBaseQuantity === 0) {
+    return;
+  }
+  return executedQuoteQuantity / executedBaseQuantity;
+}
+function getFees(record, info) {
+  const fees = [];
+  if (record?.fee)
+    fees.push(record.fee);
+  if (Array.isArray(record?.fees))
+    fees.push(...record.fees);
+  if (Array.isArray(record?.trades)) {
+    for (const trade of record.trades) {
+      const tradeRecord = asRecord(trade);
+      if (tradeRecord?.fee)
+        fees.push(tradeRecord.fee);
+      if (Array.isArray(tradeRecord?.fees))
+        fees.push(...tradeRecord.fees);
+    }
+  }
+  if (Array.isArray(info?.fills)) {
+    for (const fill of info.fills) {
+      const fillRecord = asRecord(fill);
+      const commission = firstNumber2(fillRecord?.commission);
+      if (commission !== undefined) {
+        fees.push({
+          cost: commission,
+          currency: firstString2(fillRecord?.commissionAsset)
+        });
+      }
+    }
+  }
+  return fees;
+}
+function summarizeFees(fees) {
+  let amount = 0;
+  let amountFound = false;
+  let currency;
+  let rate;
+  for (const rawFee of fees) {
+    const fee = asRecord(rawFee);
+    if (!fee)
+      continue;
+    const cost = firstNumber2(fee.cost, fee.amount);
+    if (cost !== undefined) {
+      amount += cost;
+      amountFound = true;
+    }
+    currency ??= firstString2(fee.currency);
+    rate ??= firstNumber2(fee.rate);
+  }
+  return {
+    amount: amountFound ? amount : undefined,
+    currency,
+    rate
+  };
+}
+function compactUndefined2(record) {
+  return Object.fromEntries(Object.entries(record).filter(([, value]) => value !== undefined));
+}
+
 // src/helpers/broker-execution-archive/writer.ts
 var import_api_logs2 = __toESM(require_src7(), 1);
+import { randomUUID } from "node:crypto";
 import { closeSync, fsyncSync, openSync, writeSync } from "node:fs";
-import { request as httpRequest2 } from "node:http";
+import {
+  request as httpRequest2
+} from "node:http";
 import { request as httpsRequest2 } from "node:https";
 var BROKER_EXECUTION_ARCHIVE_TABLES = new Set([
   "broker_execution.order_events",
@@ -315734,6 +315842,7 @@ var DEFAULT_BATCH_SIZE = 10;
 var DEFAULT_FLUSH_INTERVAL_MS = 1000;
 var DEFAULT_FORWARDER_TIMEOUT_MS = 3000;
 var SHED_WARN_INTERVAL_MS = 60000;
+var MAX_PINNED_BATCH_ATTEMPTS = 10;
 var MARKET_FEEDS = new Set(["ORDERBOOK", "TICKER", "TRADES", "OHLCV"]);
 function archiveFeed(row) {
   const declared = row.row.feed ?? row.row.stream_type;
@@ -315779,14 +315888,26 @@ class BrokerExecutionArchiver {
   flushIntervalMs;
   forwarderTimeoutMs;
   queue = [];
+  enqueueTimes = new WeakMap;
   stats = {
     enqueued: 0,
     shed: 0,
     flushed: 0,
     forwarderFailures: 0
   };
+  pendingRetry = null;
   flushTimer = null;
   flushInFlight = null;
+  inFlightBatch = null;
+  inFlightStartedAtMs = null;
+  lastFailureAtMs = null;
+  lastShedAtMs = null;
+  lastSuccessAtMs = null;
+  lastFailureEventSequence = null;
+  lastShedEventSequence = null;
+  lastSuccessEventSequence = null;
+  lastSinkLatencyMs = null;
+  healthEventSequence = 0;
   lastShedWarnAtMs = 0;
   closing = false;
   closed = false;
@@ -315820,6 +315941,7 @@ class BrokerExecutionArchiver {
     }
     try {
       this.flushTimer = setInterval(() => {
+        this.emitArchiveHealthMetrics();
         this.flush();
       }, this.flushIntervalMs);
       this.flushTimer.unref?.();
@@ -315863,32 +315985,34 @@ class BrokerExecutionArchiver {
       row: { ...row.row, source: this.source }
     };
     if (this.queue.length >= this.maxQueueSize) {
-      const shedRow = this.queue[0];
-      if (shedRow) {
-        this.appendLossRecords([shedRow], "queue_shed");
+      const shedEntry = this.queue[0];
+      if (shedEntry) {
+        this.appendLossRecords([shedEntry], "queue_shed");
         this.queue.shift();
       }
       this.stats.shed += 1;
+      this.recordHealthEvent("shed");
       this.recordArchiveMetric("cex_archive_rows_shed_total", {
-        table: shedRow?.table ?? "unknown",
+        table: shedEntry?.table ?? "unknown",
         source: this.source,
-        feed: shedRow ? archiveFeed(shedRow) : "NON_MARKET"
+        feed: shedEntry ? archiveFeed(shedEntry) : "NON_MARKET"
       });
       this.recordArchiveMetric("cex_archive_queue_saturated_rows_total", {
-        table: shedRow?.table ?? "unknown",
+        table: shedEntry?.table ?? "unknown",
         source: this.source,
-        feed: shedRow ? archiveFeed(shedRow) : "NON_MARKET"
+        feed: shedEntry ? archiveFeed(shedEntry) : "NON_MARKET"
       });
       const now3 = Date.now();
       if (now3 - this.lastShedWarnAtMs >= SHED_WARN_INTERVAL_MS) {
         log.warn("Archive queue full: shedding oldest rows", {
           shed_total: this.stats.shed,
           queue_max: this.maxQueueSize,
-          table: shedRow?.table ?? "unknown"
+          table: shedEntry?.table ?? "unknown"
         });
         this.lastShedWarnAtMs = now3;
       }
     }
+    this.enqueueTimes.set(archiveRow, Date.now());
     this.queue.push(archiveRow);
     this.stats.enqueued += 1;
     this.recordArchiveMetric("cex_archive_rows_enqueued_total", {
@@ -315896,6 +316020,7 @@ class BrokerExecutionArchiver {
       source: this.source,
       feed: archiveFeed(archiveRow)
     });
+    this.emitArchiveHealthMetrics();
     if (this.queue.length >= this.batchSize) {
       this.flush();
     }
@@ -315904,20 +316029,25 @@ class BrokerExecutionArchiver {
     queueMicrotask(() => this.enqueue(row));
   }
   async flush() {
-    if (!this.enabled || this.closed || this.queue.length === 0) {
+    if (!this.enabled || this.closed || this.queue.length === 0 && this.pendingRetry === null) {
       return;
     }
     if (this.flushInFlight) {
       return this.flushInFlight;
     }
+    const inFlightState = {};
     const inFlight = this.flushBatch().then(() => {
       return;
     }).finally(() => {
+      if (this.flushInFlight !== inFlightState.promise) {
+        return;
+      }
       this.flushInFlight = null;
       if (!this.closed && !this.closing && this.enabled && this.queue.length >= this.batchSize) {
         queueMicrotask(() => void this.flush());
       }
     });
+    inFlightState.promise = inFlight;
     this.flushInFlight = inFlight;
     return inFlight;
   }
@@ -315929,16 +316059,18 @@ class BrokerExecutionArchiver {
     }
     let closeError;
     try {
-      while (this.queue.length > 0 || this.flushInFlight) {
+      while (this.pendingRetry !== null || this.queue.length > 0 || this.flushInFlight) {
         if (this.flushInFlight) {
           await this.flushInFlight;
           continue;
         }
-        const depthBefore = this.queue.length;
-        const flushed = await this.flushBatch();
-        if (!flushed && this.queue.length >= depthBefore && depthBefore > 0) {
-          const undelivered = [...this.queue];
+        if (!await this.flushBatch()) {
+          const undelivered = [
+            ...this.pendingRetry?.rows ?? [],
+            ...this.queue
+          ];
           this.appendLossRecords(undelivered, "shutdown_forwarder_failure");
+          this.pendingRetry = null;
           this.queue.length = 0;
           break;
         }
@@ -315962,7 +316094,87 @@ class BrokerExecutionArchiver {
     return { ...this.stats };
   }
   getQueueDepth() {
-    return this.queue.length;
+    return this.queue.length + (this.pendingRetry?.rows.length ?? 0);
+  }
+  getHealthSnapshot() {
+    const now3 = Date.now();
+    const oldestPendingAtMs = this.oldestPendingEnqueueAtMs();
+    const oldestPendingAgeMs = oldestPendingAtMs === null ? 0 : Math.max(0, now3 - oldestPendingAtMs);
+    const inFlightAgeMs = this.inFlightStartedAtMs === null ? 0 : Math.max(0, now3 - this.inFlightStartedAtMs);
+    const lastUnhealthyEventSequence = Math.max(this.lastFailureEventSequence ?? Number.NEGATIVE_INFINITY, this.lastShedEventSequence ?? Number.NEGATIVE_INFINITY);
+    const recoveredFromEvents = lastUnhealthyEventSequence === Number.NEGATIVE_INFINITY || this.lastSuccessEventSequence !== null && this.lastSuccessEventSequence > lastUnhealthyEventSequence;
+    const healthy = this.enabled && !this.closing && !this.closed && this.queue.length < this.maxQueueSize && oldestPendingAgeMs <= this.forwarderTimeoutMs && inFlightAgeMs <= this.forwarderTimeoutMs && recoveredFromEvents;
+    return {
+      healthy,
+      queue_depth: this.getQueueDepth(),
+      oldest_pending_age_ms: oldestPendingAgeMs,
+      shed_total: this.stats.shed,
+      last_failure_at: this.lastFailureAtMs,
+      last_shed_at: this.lastShedAtMs,
+      last_success_at: this.lastSuccessAtMs,
+      sink_latency_ms: this.lastSinkLatencyMs,
+      sink_errors_total: this.stats.forwarderFailures,
+      in_flight: this.inFlightBatch !== null,
+      in_flight_age_ms: inFlightAgeMs
+    };
+  }
+  oldestPendingEnqueueAtMs() {
+    let oldest = null;
+    for (const entry of this.pendingRetry?.rows ?? []) {
+      const enqueuedAtMs = this.enqueueTimes.get(entry);
+      if (enqueuedAtMs === undefined) {
+        continue;
+      }
+      oldest = oldest === null ? enqueuedAtMs : Math.min(oldest, enqueuedAtMs);
+    }
+    for (const entry of this.queue) {
+      const enqueuedAtMs = this.enqueueTimes.get(entry);
+      if (enqueuedAtMs === undefined) {
+        continue;
+      }
+      oldest = oldest === null ? enqueuedAtMs : Math.min(oldest, enqueuedAtMs);
+    }
+    for (const entry of this.inFlightBatch ?? []) {
+      const enqueuedAtMs = this.enqueueTimes.get(entry);
+      if (enqueuedAtMs === undefined) {
+        continue;
+      }
+      oldest = oldest === null ? enqueuedAtMs : Math.min(oldest, enqueuedAtMs);
+    }
+    return oldest;
+  }
+  recordHealthEvent(event) {
+    const eventSequence = ++this.healthEventSequence;
+    const eventTimestampMs = Date.now();
+    switch (event) {
+      case "failure":
+        this.lastFailureAtMs = eventTimestampMs;
+        this.lastFailureEventSequence = eventSequence;
+        return;
+      case "shed":
+        this.lastShedAtMs = eventTimestampMs;
+        this.lastShedEventSequence = eventSequence;
+        return;
+      case "success":
+        this.lastSuccessAtMs = eventTimestampMs;
+        this.lastSuccessEventSequence = eventSequence;
+        return;
+    }
+  }
+  emitArchiveHealthMetrics() {
+    const snapshot = this.getHealthSnapshot();
+    const labels = { source: this.source };
+    this.recordArchiveObservableGauge("cex_archive_health", snapshot.healthy ? 1 : 0, labels);
+    this.recordArchiveGauge("cex_archive_queue_depth", snapshot.queue_depth, labels);
+    this.recordArchiveGauge("cex_archive_oldest_pending_age_ms", snapshot.oldest_pending_age_ms, labels);
+    this.recordArchiveGauge("cex_archive_shed_total", snapshot.shed_total, labels);
+    this.recordArchiveGauge("cex_archive_last_failure_at", snapshot.last_failure_at ?? 0, labels);
+    this.recordArchiveGauge("cex_archive_last_shed_at", snapshot.last_shed_at ?? 0, labels);
+    this.recordArchiveGauge("cex_archive_last_success_at", snapshot.last_success_at ?? 0, labels);
+    this.recordArchiveGauge("cex_archive_sink_latency_ms", snapshot.sink_latency_ms ?? 0, labels);
+    this.recordArchiveGauge("cex_archive_sink_errors_total", snapshot.sink_errors_total, labels);
+    this.recordArchiveGauge("cex_archive_in_flight", snapshot.in_flight ? 1 : 0, labels);
+    this.recordArchiveGauge("cex_archive_in_flight_age_ms", snapshot.in_flight_age_ms, labels);
   }
   closeLossJournal() {
     if (this.deadLetterFd === undefined) {
@@ -315977,27 +316189,6 @@ class BrokerExecutionArchiver {
       this.deadLetterFd = undefined;
     }
   }
-  enforceQueueBound() {
-    while (this.queue.length > this.maxQueueSize) {
-      const dropped = this.queue[0];
-      if (!dropped) {
-        return;
-      }
-      this.appendLossRecords([dropped], "queue_shed");
-      this.queue.shift();
-      this.stats.shed += 1;
-      this.recordArchiveMetric("cex_archive_rows_shed_total", {
-        table: dropped?.table ?? "unknown",
-        source: this.source,
-        feed: archiveFeed(dropped)
-      });
-      this.recordArchiveMetric("cex_archive_queue_saturated_rows_total", {
-        table: dropped.table,
-        source: this.source,
-        feed: archiveFeed(dropped)
-      });
-    }
-  }
   appendLossRecords(rows, reason) {
     if (rows.length === 0) {
       return;
@@ -316042,10 +316233,14 @@ class BrokerExecutionArchiver {
     }
   }
   async flushBatch() {
-    const batch = this.queue.splice(0, this.batchSize);
+    const pinned = this.pendingRetry;
+    const batch = pinned ? pinned.rows : this.queue.splice(0, this.batchSize);
     if (batch.length === 0) {
       return true;
     }
+    const batchId = pinned?.batchId ?? randomUUID();
+    this.inFlightBatch = batch;
+    this.inFlightStartedAtMs = Date.now();
     for (const entry of batch) {
       if (isBrokerExecutionArchiveTable(entry.table)) {
         this.emitOtelLog(entry);
@@ -316053,11 +316248,27 @@ class BrokerExecutionArchiver {
     }
     if (this.forwarderUrl) {
       try {
-        await this.postToForwarder(batch);
+        await this.postToForwarder(batch, batchId);
       } catch (error) {
         this.stats.forwarderFailures += 1;
-        this.queue.push(...batch);
-        this.enforceQueueBound();
+        this.recordHealthEvent("failure");
+        this.lastSinkLatencyMs = Math.max(0, Date.now() - (this.inFlightStartedAtMs ?? Date.now()));
+        const attempts = (pinned?.attempts ?? 0) + 1;
+        try {
+          if (attempts >= MAX_PINNED_BATCH_ATTEMPTS) {
+            this.pendingRetry = null;
+            this.appendLossRecords(batch, "retry_exhausted");
+            log.warn("Broker execution archive gave up on a batch", {
+              attempts,
+              rows: batch.length
+            });
+          } else {
+            this.pendingRetry = { batchId, rows: batch, attempts };
+          }
+        } finally {
+          this.clearInFlightBatch(batch);
+          this.emitArchiveHealthMetrics();
+        }
         this.recordArchiveMetric("cex_archive_forwarder_failures_total", {
           count: batch.length
         });
@@ -316065,15 +316276,28 @@ class BrokerExecutionArchiver {
         return false;
       }
     }
+    this.pendingRetry = null;
     this.stats.flushed += batch.length;
+    this.recordHealthEvent("success");
+    this.lastSinkLatencyMs = Math.max(0, Date.now() - (this.inFlightStartedAtMs ?? Date.now()));
+    this.clearInFlightBatch(batch);
     this.recordFlushHealth(batch);
+    this.emitArchiveHealthMetrics();
     return true;
   }
+  clearInFlightBatch(batch) {
+    if (this.inFlightBatch !== batch) {
+      return;
+    }
+    this.inFlightBatch = null;
+    this.inFlightStartedAtMs = null;
+  }
   recordFlushHealth(batch) {
     const countByTable = new Map;
     for (const entry of batch) {
-      const key = `${entry.table}\x00${archiveFeed(entry)}`;
-      const grouped = countByTable.get(key) ?? { row: entry, count: 0 };
+      const row = entry;
+      const key = `${row.table}\x00${archiveFeed(row)}`;
+      const grouped = countByTable.get(key) ?? { row, count: 0 };
       grouped.count += 1;
       countByTable.set(key, grouped);
     }
@@ -316091,9 +316315,14 @@ class BrokerExecutionArchiver {
       await this.otelMetrics?.recordCounter(metricName, value, labels);
     } catch {}
   }
-  async recordArchiveGauge(metricName, value) {
+  async recordArchiveGauge(metricName, value, labels = {}) {
     try {
-      await this.otelMetrics?.recordGauge(metricName, value, {});
+      await this.otelMetrics?.recordGauge(metricName, value, labels);
+    } catch {}
+  }
+  async recordArchiveObservableGauge(metricName, value, labels) {
+    try {
+      await this.otelMetrics?.setObservableGauge(metricName, value, labels);
     } catch {}
   }
   emitOtelLog(entry) {
@@ -316111,13 +316340,14 @@ class BrokerExecutionArchiver {
       log.warn("Broker execution archive OTLP emit failed", { error });
     }
   }
-  postToForwarder(batch) {
+  postToForwarder(batch, batchId) {
     if (!this.forwarderUrl || batch.length === 0) {
       return Promise.resolve();
     }
     const body = JSON.stringify({
       source: this.source,
       deployment_id: this.deploymentId,
+      batch_id: batchId,
       rows: batch
     });
     const url2 = new URL(this.forwarderUrl);
@@ -316130,27 +316360,136 @@ class BrokerExecutionArchiver {
       headers.authorization = `Bearer ${this.forwarderAuthToken}`;
     }
     return new Promise((resolve, reject) => {
-      const req = doRequest(url2, {
-        method: "POST",
-        headers,
-        timeout: this.forwarderTimeoutMs
-      }, (res) => {
-        res.on("data", () => {});
-        res.on("end", () => {
-          const status = res.statusCode ?? 0;
-          if (status < 200 || status >= 300) {
-            reject(new Error(`Archive forwarder returned ${status} ${res.statusMessage ?? ""}`));
-            return;
-          }
+      let req;
+      let response;
+      let settled = false;
+      let requestClosed = false;
+      let requestCloseFailureScheduled = false;
+      let responseClosed = false;
+      let responseEnded = false;
+      let outerTimer;
+      function cleanupRequestListeners() {
+        req?.removeListener("error", onRequestError);
+        req?.removeListener("timeout", onRequestTimeout);
+        req?.removeListener("close", onRequestClose);
+      }
+      function cleanupResponseListeners() {
+        response?.removeListener("data", onResponseData);
+        response?.removeListener("end", onResponseEnd);
+        response?.removeListener("aborted", onResponseAborted);
+        response?.removeListener("error", onResponseError);
+        response?.removeListener("close", onResponseClose);
+      }
+      function onRequestClose() {
+        requestClosed = true;
+        if (!settled && !response && !requestCloseFailureScheduled) {
+          requestCloseFailureScheduled = true;
+          queueMicrotask(() => {
+            if (!settled && !response) {
+              settle2(new Error("Archive forwarder request closed before response headers"), false, true);
+            }
+          });
+        }
+        if (settled) {
+          cleanupRequestListeners();
+        }
+      }
+      function onRequestError(error) {
+        if (!settled) {
+          settle2(error, true);
+        } else {
+          cleanupRequestListeners();
+        }
+      }
+      function onRequestTimeout() {
+        settle2(new Error("Archive forwarder socket timed out"), true);
+      }
+      function onResponseData() {}
+      function onResponseEnd() {
+        responseEnded = true;
+        if (!response?.complete) {
+          settle2(new Error("Archive forwarder response was incomplete"), true);
+          return;
+        }
+        const status = response.statusCode ?? 0;
+        if (status < 200 || status >= 300) {
+          settle2(new Error(`Archive forwarder returned ${status} ${response.statusMessage ?? ""}`), false);
+          return;
+        }
+        settle2(undefined, false);
+      }
+      function onResponseAborted() {
+        settle2(new Error("Archive forwarder response was aborted"), true);
+      }
+      function onResponseError(error) {
+        if (!settled) {
+          settle2(error, true);
+        }
+      }
+      function onResponseClose() {
+        responseClosed = true;
+        if (!settled && !responseEnded) {
+          settle2(new Error("Archive forwarder response closed before completion"), true);
+          return;
+        }
+        cleanupResponseListeners();
+      }
+      function settle2(error, destroyRequest, retainClosedRequestError = false) {
+        if (settled) {
+          return;
+        }
+        settled = true;
+        if (outerTimer) {
+          clearTimeout(outerTimer);
+          outerTimer = undefined;
+        }
+        response?.removeListener("data", onResponseData);
+        response?.removeListener("end", onResponseEnd);
+        response?.removeListener("aborted", onResponseAborted);
+        if (responseClosed) {
+          cleanupResponseListeners();
+        }
+        if (destroyRequest && req && !requestClosed) {
+          req.destroy(error);
+        } else if (retainClosedRequestError && req && requestClosed) {
+          req.removeListener("timeout", onRequestTimeout);
+          req.removeListener("close", onRequestClose);
+        } else if (!req || requestClosed) {
+          cleanupRequestListeners();
+        }
+        if (error) {
+          reject(error);
+        } else {
           resolve();
+        }
+      }
+      outerTimer = setTimeout(() => {
+        settle2(new Error("Archive forwarder request deadline exceeded"), true);
+      }, this.forwarderTimeoutMs);
+      try {
+        req = doRequest(url2, {
+          method: "POST",
+          headers,
+          timeout: this.forwarderTimeoutMs
+        }, (nextResponse) => {
+          response = nextResponse;
+          response.on("data", onResponseData);
+          response.on("end", onResponseEnd);
+          response.on("aborted", onResponseAborted);
+          response.on("error", onResponseError);
+          response.on("close", onResponseClose);
+          if (settled) {
+            response.resume();
+          }
         });
-      });
-      req.on("error", reject);
-      req.on("timeout", () => {
-        req.destroy(new Error("Archive forwarder request timed out"));
-      });
-      req.write(body);
-      req.end();
+        req.on("error", onRequestError);
+        req.on("timeout", onRequestTimeout);
+        req.on("close", onRequestClose);
+        req.write(body);
+        req.end();
+      } catch (error) {
+        settle2(error instanceof Error ? error : new Error(String(error)), true);
+      }
     });
   }
 }
@@ -316620,6 +316959,94 @@ class AccountBalanceArchivePoller {
   }
 }
 
+// src/helpers/balance-update-archive-consumer.ts
+class BalanceUpdateArchiveConsumer {
+  params;
+  #started = false;
+  #stopping = false;
+  #subscriptions = new Set;
+  #runs = [];
+  constructor(params) {
+    this.params = params;
+  }
+  start() {
+    if (this.#started || this.#stopping)
+      return;
+    this.#started = true;
+    const targets = this.#targets();
+    log.info("\uD83D\uDCB8 Balance-update archive consumer started", {
+      accounts: targets.length
+    });
+    for (const target of targets) {
+      this.#runs.push(this.#consume(target));
+    }
+  }
+  async stop() {
+    this.#stopping = true;
+    for (const subscription of [...this.#subscriptions]) {
+      subscription.close();
+    }
+    await Promise.all(this.#runs);
+  }
+  #targets() {
+    const targets = [];
+    for (const [exchange, pool] of Object.entries(this.params.brokers)) {
+      for (const account of [pool.primary, ...pool.secondaryBrokers]) {
+        targets.push({ exchange, accountSelector: account.label });
+      }
+    }
+    return targets;
+  }
+  async#consume(target) {
+    while (!this.#stopping) {
+      let subscription;
+      try {
+        subscription = this.params.userDataStreamSupervisor.subscribe({
+          exchange: target.exchange,
+          accountSelector: target.accountSelector,
+          kind: "balance"
+        });
+        this.#subscriptions.add(subscription);
+        for await (const message of subscription) {
+          if (this.#stopping)
+            break;
+          const event = message.event;
+          if (event.e !== "balanceUpdate")
+            continue;
+          this.params.archiver.enqueue(buildTransferEventArchiveRow({
+            tags: buildCommonArchiveTags({
+              deploymentId: this.params.archiver.getDeploymentId(),
+              accountSelector: target.accountSelector,
+              exchange: target.exchange
+            }),
+            transfer: {
+              eventKind: "balance_delta",
+              lifecycleAction: "observe_balance_update",
+              amount: typeof event.d === "string" ? event.d : undefined,
+              assetSymbol: typeof event.a === "string" ? event.a : undefined,
+              exchangeTimestamp: normalizeTimestamp(event.T),
+              payload: event
+            }
+          }));
+        }
+      } catch (error) {
+        if (!this.#stopping) {
+          log.warn("Balance-update archive subscription failed", {
+            exchange: target.exchange,
+            accountSelector: target.accountSelector,
+            errorType: error instanceof Error ? error.name : typeof error
+          });
+        }
+      } finally {
+        if (subscription) {
+          this.#subscriptions.delete(subscription);
+          subscription.close();
+        }
+      }
+    }
+  }
+}
+
 // src/helpers/deposit-archive-poller.ts
 var DEFAULT_CONFIG2 = {
   pollIntervalMs: 60000,
@@ -316829,7 +317256,7 @@ class DepositArchivePoller {
           network: network === undefined ? undefined : String(network),
           externalId: depositTxid,
           txid: depositTxid,
-          exchangeTimestamp: normalizeTimestamp2(creditedAt),
+          exchangeTimestamp: normalizeTimestamp(creditedAt),
           payload: record
         }
       }));
@@ -317691,7 +318118,7 @@ function createOtelLogsFromEnv() {
 }
 
 // src/helpers/stream-health-publisher.ts
-import { createHash as createHash4, randomUUID } from "node:crypto";
+import { createHash as createHash4, randomUUID as randomUUID2 } from "node:crypto";
 import {
   closeSync as closeSync2,
   fsyncSync as fsyncSync2,
@@ -317816,7 +318243,7 @@ class StreamHealthPublisher {
       version: STATE_VERSION,
       producerId: PRODUCER_ID,
       producerEpoch: "1",
-      runId: randomUUID(),
+      runId: randomUUID2(),
       nextBatchSequence: "1",
       nextStreamSequences: {}
     };
@@ -317885,7 +318312,7 @@ class StreamHealthPublisher {
       return;
     if (this.#advanceRun) {
       this.#state.producerEpoch = next(this.#state.producerEpoch);
-      this.#state.runId = randomUUID();
+      this.#state.runId = randomUUID2();
       this.#state.nextBatchSequence = "1";
       this.#state.nextStreamSequences = {};
       this.#advanceRun = false;
@@ -318001,7 +318428,7 @@ class StreamHealthPublisher {
         cause: error
       });
     }
-    const temporary = `${this.#statePath}.${process.pid}.${randomUUID()}.tmp`;
+    const temporary = `${this.#statePath}.${process.pid}.${randomUUID2()}.tmp`;
     let fd2;
     try {
       fd2 = openSync2(temporary, "wx", 384);
@@ -318046,6 +318473,143 @@ function streamHealthPublisherConfigFromEnv(env = process.env) {
   };
 }
 
+// src/helpers/user-asset-archive-poller.ts
+var DEFAULT_CONFIG4 = {
+  pollIntervalMs: 60000
+};
+var USER_ASSET_EXCHANGE_ID = "binance";
+var metricLabels2 = (target) => ({
+  exchange: target.exchangeId,
+  account_selector: target.account.label,
+  balance_scope: USER_ASSET_BALANCE_SCOPE
+});
+
+class UserAssetArchivePoller {
+  params;
+  #timer = null;
+  #stopped = false;
+  #running = null;
+  #lastSuccessMs = new Map;
+  #config;
+  constructor(params) {
+    this.params = params;
+    this.#config = { ...DEFAULT_CONFIG4, ...params.config };
+  }
+  start() {
+    if (this.#timer || this.#stopped || !this.params.archiver.canPersistAccountBalanceSnapshots() || this.#targets().length === 0) {
+      return;
+    }
+    log.info("\uD83E\uDDCA User asset archive poller started", {
+      balanceScope: USER_ASSET_BALANCE_SCOPE
+    });
+    this.#schedule(0);
+  }
+  async stop() {
+    this.#stopped = true;
+    if (this.#timer) {
+      clearTimeout(this.#timer);
+      this.#timer = null;
+    }
+    await this.#running;
+  }
+  async pollAllOnce() {
+    if (this.#stopped || this.#running || !this.params.archiver.canPersistAccountBalanceSnapshots()) {
+      return false;
+    }
+    this.#running = this.#pollAllSequentially();
+    try {
+      return await this.#running;
+    } finally {
+      this.#running = null;
+    }
+  }
+  #targets() {
+    const targets = [];
+    for (const [exchangeId, pool] of Object.entries(this.params.brokers)) {
+      if (exchangeId.trim().toLowerCase() !== USER_ASSET_EXCHANGE_ID) {
+        continue;
+      }
+      for (const account of [pool.primary, ...pool.secondaryBrokers]) {
+        targets.push({ exchangeId, account });
+      }
+    }
+    return targets;
+  }
+  async#pollAllSequentially() {
+    for (const target of this.#targets()) {
+      if (this.#stopped) {
+        break;
+      }
+      await this.#pollOne(target);
+    }
+    return true;
+  }
+  async#pollOne(target) {
+    const labels = metricLabels2(target);
+    this.params.metrics?.recordCounter("cex_user_asset_poll_attempts_total", 1, labels);
+    try {
+      const exchange = target.account.exchange;
+      if (typeof exchange.sapiV3PostAssetGetUserAsset !== "function") {
+        throw new Error("binance_user_asset_unavailable: getUserAsset is not defined on this exchange instance");
+      }
+      const response = await exchange.sapiV3PostAssetGetUserAsset({});
+      const observedAt = new Date;
+      const normalized = normalizeBinanceUserAssetsForArchive(response);
+      this.params.archiver.enqueue(buildUserAssetSnapshotRow({
+        tags: buildCommonArchiveTags({
+          deploymentId: this.params.archiver.getDeploymentId(),
+          accountSelector: target.account.label,
+          exchange: target.exchangeId,
+          brokerObservedTimestamp: observedAt.toISOString()
+        }),
+        userAssets: normalized
+      }));
+      const successMs = Date.now();
+      this.#lastSuccessMs.set(this.#targetKey(target), successMs);
+      this.params.metrics?.recordCounter("cex_user_asset_poll_successes_total", 1, labels);
+      this.params.metrics?.recordGauge("cex_user_asset_poll_last_success_timestamp_seconds", Math.floor(successMs / 1000), labels);
+      this.#recordFreshness(labels, successMs, successMs);
+    } catch (error) {
+      rethrowArchiveDurabilityError(error);
+      this.params.metrics?.recordCounter("cex_user_asset_poll_failures_total", 1, labels);
+      const now3 = Date.now();
+      const lastSuccess = this.#lastSuccessMs.get(this.#targetKey(target));
+      if (lastSuccess !== undefined) {
+        this.#recordFreshness(labels, lastSuccess, now3);
+      }
+      log.warn("User asset archive poll failed", {
+        exchange: target.exchangeId,
+        account: target.account.label,
+        balanceScope: USER_ASSET_BALANCE_SCOPE,
+        errorType: error instanceof Error ? error.name : "unknown"
+      });
+    }
+  }
+  #recordFreshness(labels, lastSuccessMs, nowMs) {
+    this.params.metrics?.recordGauge("cex_user_asset_poll_freshness_seconds", Math.max(0, (nowMs - lastSuccessMs) / 1000), labels);
+  }
+  #targetKey(target) {
+    return `${target.exchangeId}|${target.account.label}|${USER_ASSET_BALANCE_SCOPE}`;
+  }
+  #schedule(delayMs) {
+    this.#timer = setTimeout(() => void this.#tick(), delayMs);
+    this.#timer.unref?.();
+  }
+  async#tick() {
+    this.#timer = null;
+    try {
+      await this.pollAllOnce();
+    } catch (error) {
+      rethrowArchiveDurabilityError(error);
+      log.error("User asset archive poller tick failed", error);
+    } finally {
+      if (!this.#stopped) {
+        this.#schedule(this.#config.pollIntervalMs);
+      }
+    }
+  }
+}
+
 // src/helpers/binance-user-data-stream.ts
 import { Buffer as Buffer2 } from "node:buffer";
 import { createHmac } from "node:crypto";
@@ -329666,7 +330230,7 @@ function finalize(ctx, schema) {
     result.$schema = "http://json-schema.org/draft-07/schema#";
   } else if (ctx.target === "draft-04") {
     result.$schema = "http://json-schema.org/draft-04/schema#";
-  } else if (ctx.target === "openapi-3.0") {} else {}
+  } else if (ctx.target === "openapi-3.0") {}
   if (ctx.external?.uri) {
     const id2 = ctx.external.registry.get(schema)?.id;
     if (!id2)
@@ -329914,7 +330478,7 @@ var literalProcessor = (schema, ctx, json3, _params) => {
     if (val === undefined) {
       if (ctx.unrepresentable === "throw") {
         throw new Error("Literal `undefined` cannot be represented in JSON Schema");
-      } else {}
+      }
     } else if (typeof val === "bigint") {
       if (ctx.unrepresentable === "throw") {
         throw new Error("BigInt literals cannot be represented in JSON Schema");
@@ -332573,7 +333137,7 @@ async function handleDeposit(ctx) {
           network: depositNetwork?.exchangeNetworkId,
           externalId: depositTxid,
           txid: depositTxid,
-          exchangeTimestamp: normalizeTimestamp2(creditedAt),
+          exchangeTimestamp: normalizeTimestamp(creditedAt),
           payload: deposit
         }
       });
@@ -336091,6 +336655,8 @@ class CEXBroker {
   fillArchivePoller;
   depositArchivePoller;
   accountBalanceArchivePoller;
+  userAssetArchivePoller;
+  balanceUpdateArchiveConsumer;
   userDataStreamSupervisor;
   loadEnvConfig() {
     log.info("\uD83D\uDD27 Loading CEX_BROKER_ environment variables:");
@@ -336244,6 +336810,14 @@ class CEXBroker {
       await this.accountBalanceArchivePoller.stop();
       this.accountBalanceArchivePoller = undefined;
     }
+    if (this.userAssetArchivePoller) {
+      await this.userAssetArchivePoller.stop();
+      this.userAssetArchivePoller = undefined;
+    }
+    if (this.balanceUpdateArchiveConsumer) {
+      await this.balanceUpdateArchiveConsumer.stop();
+      this.balanceUpdateArchiveConsumer = undefined;
+    }
     if (this.server) {
       await this.server.forceShutdown();
     }
@@ -336289,6 +336863,14 @@ class CEXBroker {
       await this.accountBalanceArchivePoller.stop();
       this.accountBalanceArchivePoller = undefined;
     }
+    if (this.userAssetArchivePoller) {
+      await this.userAssetArchivePoller.stop();
+      this.userAssetArchivePoller = undefined;
+    }
+    if (this.balanceUpdateArchiveConsumer) {
+      await this.balanceUpdateArchiveConsumer.stop();
+      this.balanceUpdateArchiveConsumer = undefined;
+    }
     log.info(`Running CEXBroker at ${new Date().toISOString()}`);
     if (this.otelMetrics?.isOtelEnabled()) {
       await this.otelMetrics.initialize();
@@ -336330,6 +336912,14 @@ class CEXBroker {
         metrics: this.otelMetrics
       });
       this.depositArchivePoller.start();
+      if (this.userDataStreamSupervisor) {
+        this.balanceUpdateArchiveConsumer = new BalanceUpdateArchiveConsumer({
+          brokers: this.brokers,
+          archiver: this.brokerArchiver,
+          userDataStreamSupervisor: this.userDataStreamSupervisor
+        });
+        this.balanceUpdateArchiveConsumer.start();
+      }
     }
     if (this.brokerArchiver?.canPersistAccountBalanceSnapshots()) {
       this.accountBalanceArchivePoller = new AccountBalanceArchivePoller({
@@ -336338,6 +336928,12 @@ class CEXBroker {
         metrics: this.otelMetrics
       });
       this.accountBalanceArchivePoller.start();
+      this.userAssetArchivePoller = new UserAssetArchivePoller({
+        brokers: this.brokers,
+        archiver: this.brokerArchiver,
+        metrics: this.otelMetrics
+      });
+      this.userAssetArchivePoller.start();
     }
     return this;
   }