@usherlabs/cex-broker 0.2.52 → 0.3.0

package/dist/handlers/execute-action/context.d.ts

@@ -1,50 +0,0 @@
-import type * as grpc from "@grpc/grpc-js";
-import type { Metadata } from "@grpc/grpc-js";
-import type { Exchange } from "@usherlabs/ccxt";
-import type { z } from "zod";
-import type { BrokerAccount, BrokerPoolEntry } from "../../helpers";
-import type { BrokerExecutionArchiver, WithdrawalObservationTracker } from "../../helpers/broker-execution-archive";
-import type { Action as ActionType } from "../../helpers/constants";
-import type { OrderActivityTracker } from "../../helpers/order-activity-tracker";
-import type { OtelMetrics } from "../../helpers/otel";
-import type { PolicyConfig } from "../../types";
-import type { ActionRequest, ActionResponse } from "../types";
-export type ActionHandler = (ctx: ExecuteActionContext) => Promise<void>;
-export type ExecuteActionContext = {
-    call: grpc.ServerUnaryCall<ActionRequest, ActionResponse>;
-    wrappedCallback: grpc.sendUnaryData<ActionResponse>;
-    action: ActionType;
-    policy: PolicyConfig;
-    brokers: Record<string, BrokerPoolEntry>;
-    metadata: Metadata;
-    normalizedCex: string;
-    cex: string;
-    symbol?: string;
-    selectedBrokerAccount?: BrokerAccount;
-    broker: Exchange;
-    verity: {
-        proof: string;
-    };
-    applyVerityToBroker: (target: Exchange) => void;
-    useVerity: boolean;
-    verityProverUrl: string;
-    otelMetrics?: OtelMetrics;
-    brokerArchiver?: BrokerExecutionArchiver;
-    orderActivityTracker?: OrderActivityTracker;
-    withdrawalObservationTracker: WithdrawalObservationTracker;
-};
-export declare function requireSymbol(ctx: ExecuteActionContext, message?: string): ctx is ExecuteActionContext & {
-    symbol: string;
-};
-export declare function parsePayloadForAction<T>(ctx: ExecuteActionContext, schema: z.ZodType<T>): T | null;
-export declare function rejectWithGrpcError(ctx: ExecuteActionContext, error: unknown, options?: {
-    message?: string;
-    prefix?: string;
-    preferStableMessageOnly?: boolean;
-    /** Append the caught error's class name (e.g. InsufficientFunds) as a
-     * suffix. It goes last, not in front, because the gRPC status code is
-     * derived from the raw message via stableGrpcErrorCode; prepending the
-     * class name would break that prefix match. */
-    appendClassName?: boolean;
-}): void;
-export declare function successWithProof(ctx: ExecuteActionContext, result: unknown): void;

package/dist/handlers/execute-action/deposit.d.ts

@@ -1,2 +0,0 @@
-import type { ExecuteActionContext } from "./context";
-export declare function handleDeposit(ctx: ExecuteActionContext): Promise<void>;

package/dist/handlers/execute-action/handler.d.ts

@@ -1,19 +0,0 @@
-import * as grpc from "@grpc/grpc-js";
-import { type BrokerPoolEntry } from "../../helpers/broker";
-import { type BrokerExecutionArchiver, WithdrawalObservationTracker } from "../../helpers/broker-execution-archive";
-import type { OrderActivityTracker } from "../../helpers/order-activity-tracker";
-import type { OtelMetrics } from "../../helpers/otel";
-import type { PolicyConfig } from "../../types";
-import type { ActionRequest, ActionResponse } from "../types";
-export type ExecuteActionDeps = {
-    policy: PolicyConfig;
-    brokers: Record<string, BrokerPoolEntry>;
-    whitelistIps: string[];
-    useVerity: boolean;
-    verityProverUrl: string;
-    otelMetrics?: OtelMetrics;
-    brokerArchiver?: BrokerExecutionArchiver;
-    orderActivityTracker?: OrderActivityTracker;
-    withdrawalObservationTracker?: WithdrawalObservationTracker;
-};
-export declare function createExecuteActionHandler(deps: ExecuteActionDeps): (call: grpc.ServerUnaryCall<ActionRequest, ActionResponse>, callback: grpc.sendUnaryData<ActionResponse>) => Promise<void>;

package/dist/handlers/execute-action/index.d.ts

@@ -1,10 +0,0 @@
-export type { ActionHandler, ExecuteActionContext } from "./context";
-export { handleDeposit } from "./deposit";
-export { createExecuteActionHandler, type ExecuteActionDeps, } from "./handler";
-export { handleInternalTransfer } from "./internal-transfer";
-export { handleOrderBookCall } from "./order-book-call";
-export { handleOrders } from "./orders";
-export { handlePassThrough } from "./pass-through";
-export { ACTION_HANDLERS, dispatchExecuteAction } from "./registry";
-export { handleTreasuryCall } from "./treasury-call";
-export { handleWithdraw } from "./withdraw";

package/dist/handlers/execute-action/internal-transfer.d.ts

@@ -1,2 +0,0 @@
-import type { ExecuteActionContext } from "./context";
-export declare function handleInternalTransfer(ctx: ExecuteActionContext): Promise<void>;

package/dist/handlers/execute-action/order-book-call.d.ts

@@ -1,3 +0,0 @@
-import type { ExecuteActionContext } from "./context";
-/** Handles Action.Call order-book methods before generic broker dispatch. Returns true when fully handled. */
-export declare function handleOrderBookCall(ctx: ExecuteActionContext): Promise<boolean>;

package/dist/handlers/execute-action/orders.d.ts

@@ -1,2 +0,0 @@
-import type { ExecuteActionContext } from "./context";
-export declare function handleOrders(ctx: ExecuteActionContext): Promise<void>;

package/dist/handlers/execute-action/pass-through.d.ts

@@ -1,2 +0,0 @@
-import type { ExecuteActionContext } from "./context";
-export declare function handlePassThrough(ctx: ExecuteActionContext): Promise<void>;

package/dist/handlers/execute-action/perp-config.d.ts

@@ -1,2 +0,0 @@
-import type { ExecuteActionContext } from "./context";
-export declare function handlePerpConfig(ctx: ExecuteActionContext): Promise<void>;

package/dist/handlers/execute-action/registry.d.ts

@@ -1,5 +0,0 @@
-import { type Action as ActionType } from "../../helpers/constants";
-import type { ActionHandler, ExecuteActionContext } from "./context";
-/** Maps each ExecuteAction to its handler module. Cluster routers (orders, pass-through) are registered per action. */
-export declare const ACTION_HANDLERS: Partial<Record<ActionType, ActionHandler>>;
-export declare function dispatchExecuteAction(ctx: ExecuteActionContext): Promise<void>;

package/dist/handlers/execute-action/treasury-call.d.ts

@@ -1,2 +0,0 @@
-import type { ExecuteActionContext } from "./context";
-export declare function handleTreasuryCall(ctx: ExecuteActionContext): Promise<void>;

package/dist/handlers/execute-action/withdraw.d.ts

@@ -1,2 +0,0 @@
-import type { ExecuteActionContext } from "./context";
-export declare function handleWithdraw(ctx: ExecuteActionContext): Promise<void>;

package/dist/handlers/subscribe/broker-lifecycle.d.ts

@@ -1,13 +0,0 @@
-import type { Exchange } from "@usherlabs/ccxt";
-type BrokerContext = {
-    cex: string;
-    symbol: string;
-};
-export type BrokerCloseOutcome = "closed" | "failed";
-export declare class SubscribeBrokerLifecycle {
-    #private;
-    register(broker: Exchange, context: BrokerContext): void;
-    close(broker: Exchange): Promise<BrokerCloseOutcome>;
-    closeAll(): Promise<void>;
-}
-export {};

package/dist/handlers/subscribe/handler.d.ts

@@ -1,20 +0,0 @@
-import * as grpc from "@grpc/grpc-js";
-import { type BrokerPoolEntry } from "../../helpers/broker";
-import type { BrokerExecutionArchiver } from "../../helpers/broker-execution-archive";
-import type { OtelMetrics } from "../../helpers/otel";
-import { PublicMarketDataFeedSupervisor } from "../../helpers/public-market-data-feed";
-import type { UserDataStreamSupervisor } from "../../helpers/user-data-stream-supervisor";
-import type { SubscribeRequest, SubscribeResponse } from "../types";
-import { SubscribeBrokerLifecycle } from "./broker-lifecycle";
-export type SubscribeDeps = {
-    brokers: Record<string, BrokerPoolEntry>;
-    whitelistIps: string[];
-    otelMetrics?: OtelMetrics;
-    brokerArchiver?: BrokerExecutionArchiver;
-    brokerLifecycle?: SubscribeBrokerLifecycle;
-    userDataStreamSupervisor?: UserDataStreamSupervisor;
-    publicMarketDataFeedSupervisor?: PublicMarketDataFeedSupervisor;
-};
-type SubscribeCall = grpc.ServerWritableStream<SubscribeRequest, SubscribeResponse>;
-export declare function createSubscribeHandler(deps: SubscribeDeps): (call: SubscribeCall) => Promise<void>;
-export {};

package/dist/handlers/subscribe/index.d.ts

@@ -1,2 +0,0 @@
-export { SubscribeBrokerLifecycle } from "./broker-lifecycle";
-export { createSubscribeHandler, type SubscribeDeps } from "./handler";

package/dist/handlers/types.d.ts

@@ -1,23 +0,0 @@
-import type { ActionName, Action as ActionType, SubscriptionTypeName, SubscriptionType as SubscriptionTypeValue } from "../helpers/constants";
-export type ActionRequest = {
-    action?: ActionType | ActionName;
-    payload?: Record<string, string>;
-    cex?: string;
-    symbol?: string;
-};
-export type ActionResponse = {
-    result: string;
-    proof?: string;
-};
-export type SubscribeRequest = {
-    cex?: string;
-    symbol?: string;
-    type?: SubscriptionTypeValue | SubscriptionTypeName;
-    options?: Record<string, string>;
-};
-export type SubscribeResponse = {
-    data: string;
-    timestamp: number;
-    symbol: string;
-    type: SubscriptionTypeValue;
-};

package/dist/helpers/account-balance-archive-poller.d.ts

@@ -1,19 +0,0 @@
-import type { BrokerPoolEntry } from "./broker";
-import { type BrokerExecutionArchiver } from "./broker-execution-archive";
-import type { OtelMetrics } from "./otel";
-export type AccountBalanceArchivePollerConfig = {
-    pollIntervalMs: number;
-};
-export declare class AccountBalanceArchivePoller {
-    #private;
-    private readonly params;
-    constructor(params: {
-        brokers: Record<string, BrokerPoolEntry>;
-        archiver: BrokerExecutionArchiver;
-        metrics?: OtelMetrics;
-        config?: Partial<AccountBalanceArchivePollerConfig>;
-    });
-    start(): void;
-    stop(): Promise<void>;
-    pollAllOnce(): Promise<boolean>;
-}

package/dist/helpers/auth.d.ts

@@ -1,5 +0,0 @@
-type GrpcPeerCall = {
-    getPeer(): string;
-};
-export declare function authenticateRequest(call: GrpcPeerCall, whitelistIps: string[]): boolean;
-export {};

package/dist/helpers/balance-update-archive-consumer.d.ts

@@ -1,16 +0,0 @@
-import type { BrokerPoolEntry } from "./broker";
-import { type BrokerExecutionArchiver } from "./broker-execution-archive";
-import type { UserDataStreamSupervisor } from "./user-data-stream-supervisor";
-type BalanceUpdateSubscriptionSource = Pick<UserDataStreamSupervisor, "subscribe">;
-export declare class BalanceUpdateArchiveConsumer {
-    #private;
-    private readonly params;
-    constructor(params: {
-        brokers: Record<string, BrokerPoolEntry>;
-        archiver: BrokerExecutionArchiver;
-        userDataStreamSupervisor: BalanceUpdateSubscriptionSource;
-    });
-    start(): void;
-    stop(): Promise<void>;
-}
-export {};

package/dist/helpers/binance-user-data-normalization.d.ts

@@ -1,3 +0,0 @@
-import type { Exchange } from "@usherlabs/ccxt";
-export declare function normalizeBinanceSpotBalanceEvent(exchange: Exchange, event: Record<string, unknown>): Promise<unknown>;
-export declare function normalizeBinanceExecutionReport(exchange: Exchange, event: Record<string, unknown>): Record<string, unknown>;

package/dist/helpers/binance-user-data-stream.d.ts

@@ -1,58 +0,0 @@
-import type { Exchange } from "@usherlabs/ccxt";
-export declare const BINANCE_SPOT_WS_API_URL = "wss://ws-api.binance.com:443/ws-api/v3";
-export declare const DEFAULT_BINANCE_USER_DATA_MAX_BUFFERED_EVENTS = 16;
-export type BinanceUserDataEvent = {
-    subscriptionId: number;
-    event: Record<string, unknown>;
-};
-export type BinanceUserDataStreamFailureKind = "auth_failed" | "transport_error" | "remote_closed" | "protocol_error" | "backpressure";
-export type BinanceUserDataStreamObserver = {
-    onConnected?: () => void;
-    onAuthenticated?: () => void;
-    onEvent?: (event: BinanceUserDataEvent) => void;
-    onFailure?: (failure: {
-        kind: BinanceUserDataStreamFailureKind;
-        reason: string;
-    }) => void;
-};
-type WebSocketLike = {
-    on(event: "open", listener: () => void): unknown;
-    on(event: "message", listener: (data: unknown) => void): unknown;
-    on(event: "error", listener: (error: unknown) => void): unknown;
-    on(event: "close", listener: (code: unknown, reason: unknown) => void): unknown;
-    send(data: string): void;
-    close(code?: number, reason?: string): void;
-};
-type WebSocketFactory = (url: string) => WebSocketLike;
-type BinanceSpotUserDataStreamOptions = {
-    maxBufferedEvents?: number;
-    observer?: BinanceUserDataStreamObserver;
-};
-export declare function setBinanceUserDataWebSocketFactoryForTests(factory: WebSocketFactory): () => void;
-export declare function getBinanceSpotWsApiUrl(exchange: Exchange): string;
-export declare class BinanceSpotUserDataStream implements AsyncIterable<BinanceUserDataEvent> {
-    private readonly exchange;
-    private readonly ws;
-    private readonly secretValues;
-    private readonly requestId;
-    private readonly maxBufferedEvents;
-    private readonly observer?;
-    private readonly queue;
-    private readonly waiters;
-    private closed;
-    private closeError;
-    private subscriptionId;
-    constructor(exchange: Exchange, options?: BinanceSpotUserDataStreamOptions);
-    [Symbol.asyncIterator](): AsyncIterator<BinanceUserDataEvent>;
-    close(): void;
-    private handleClose;
-    private subscribe;
-    private handleMessage;
-    private push;
-    private nextEvent;
-    private fail;
-    private flushWaiters;
-}
-export declare function isBinanceBalanceUserDataEvent(event: Record<string, unknown>): boolean;
-export declare function isBinanceOrderUserDataEvent(event: Record<string, unknown>): boolean;
-export {};

package/dist/helpers/broker-execution-archive/capture.d.ts

@@ -1,41 +0,0 @@
-import type { Exchange } from "@usherlabs/ccxt";
-import { type OrderTelemetryAction, type OrderTelemetryContext } from "../order-telemetry";
-import { type TransferArchiveFields } from "./rows";
-import type { SubscribeArchiveType } from "./types";
-import type { WithdrawalObservationTracker } from "./withdrawal-observation-tracker";
-import { type BrokerExecutionArchiver } from "./writer";
-export declare function archiveOrderExecutionInBackground(archiver: BrokerExecutionArchiver | undefined, context: OrderTelemetryContext, order: unknown, error?: unknown, options?: {
-    marketMetadataHash?: string;
-}): void;
-export declare function archiveSubscribeStreamInBackground(archiver: BrokerExecutionArchiver | undefined, input: {
-    exchange: string;
-    accountSelector?: string;
-    symbol: string;
-    subscriptionType: SubscribeArchiveType;
-    streamPayload: unknown;
-    secretLiterals?: readonly string[];
-}): void;
-export declare function archiveTransferEventInBackground(archiver: BrokerExecutionArchiver | undefined, input: {
-    exchange: string;
-    accountSelector?: string;
-    assetSymbol?: string;
-    brokerObservedTimestamp?: string;
-    transfer: TransferArchiveFields;
-}): void;
-export declare function archiveWithdrawalObservationsInBackground(archiver: BrokerExecutionArchiver | undefined, tracker: WithdrawalObservationTracker, input: {
-    exchange: string;
-    accountSelector?: string;
-    transactions: unknown;
-}): void;
-export declare function captureMarketMetadataSnapshot(archiver: BrokerExecutionArchiver | undefined, broker: Exchange, input: {
-    exchange: string;
-    accountSelector?: string;
-    symbol: string;
-    action: OrderTelemetryAction;
-    clientOrderId?: string;
-    orderId?: string;
-    makerActionId?: string;
-    idempotencyId?: string;
-    brokerObservedTimestamp?: string;
-}): Promise<string | undefined>;
-export declare function captureMarketMetadataSnapshotInBackground(archiver: BrokerExecutionArchiver | undefined, broker: Exchange, input: Parameters<typeof captureMarketMetadataSnapshot>[2]): void;

package/dist/helpers/broker-execution-archive/index.d.ts

@@ -1,7 +0,0 @@
-export { archiveOrderExecutionInBackground, archiveSubscribeStreamInBackground, archiveTransferEventInBackground, archiveWithdrawalObservationsInBackground, captureMarketMetadataSnapshot, captureMarketMetadataSnapshotInBackground, } from "./capture";
-export { DeadLetterJournalExportError, type DeadLetterJournalExportResult, exportDeadLetterJournal, exportDeadLetterJournalFromEnv, } from "./journal-export";
-export { hashMarketMetadata, redactErrorForArchive, redactSecretLiterals, redactStreamPayload, } from "./redact";
-export { buildAccountBalanceSnapshotRow, buildCommonArchiveTags, buildFillEventArchiveRow, buildMarketMetadataSnapshotRow, buildOrderEventArchiveRow, buildSubscribeStreamArchiveRow, buildTransferEventArchiveRow, buildUserAssetSnapshotRow, extractBinanceInternalTransferId, type FillArchiveFields, type NormalizedCcxtBalance, type NormalizedCcxtTransfer, type NormalizedUserAssets, normalizeBinanceUserAssetsForArchive, normalizeCcxtBalanceForArchive, normalizeCcxtTradeForArchive, normalizeCcxtTransactionForArchive, normalizeTimestamp, type TransferArchiveFields, } from "./rows";
-export { ACCOUNT_BALANCE_PRECISION_BASIS, ACCOUNT_BALANCE_SCOPE, ARCHIVE_SCHEMA_VERSION, BROKER_READ_SOURCE, BROKER_WRITE_SOURCE, type BrokerArchiveCommonTags, type BrokerArchiveRow, type BrokerArchiveSource, type BrokerArchiveTable, type OrderArchiveAction, type SubscribeArchiveType, type TransferEventKind, type TransferLifecycleAction, USER_ASSET_BALANCE_SCOPE, USER_ASSET_PRECISION_BASIS, } from "./types";
-export { DEFAULT_WITHDRAWAL_OBSERVATION_TRACKER_MAX_ENTRIES, WithdrawalObservationTracker, } from "./withdrawal-observation-tracker";
-export { BrokerExecutionArchiveDurabilityError, BrokerExecutionArchiver, type BrokerExecutionArchiverOptions, createBrokerExecutionArchiverFromEnv, isArchiveOtelLogsEnabled, isBrokerExecutionArchiveTable, resolveArchiveForwarderUrlFromEnv, rethrowArchiveDurabilityError, } from "./writer";

package/dist/helpers/broker-execution-archive/journal-export.d.ts

@@ -1,20 +0,0 @@
-export declare class DeadLetterJournalExportError extends Error {
-    constructor(message: string, options?: ErrorOptions);
-}
-export type DeadLetterJournalExportResult = {
-    status: "disabled";
-} | {
-    status: "skipped_export_exists";
-    exportPath: string;
-} | {
-    status: "skipped_missing_journal";
-    journalPath: string;
-} | {
-    status: "exported";
-    journalPath: string;
-    exportPath: string;
-    bytes: number;
-    sha256: string;
-};
-export declare function exportDeadLetterJournalFromEnv(): DeadLetterJournalExportResult;
-export declare function exportDeadLetterJournal(journalPath: string, exportPath: string): DeadLetterJournalExportResult;

package/dist/helpers/broker-execution-archive/loss-journal.d.ts

@@ -1,36 +0,0 @@
-import type { BrokerArchiveRow, BrokerArchiveSource } from "./types";
-export declare const LOSS_JOURNAL_RECORD_VERSION: 1;
-export type ArchiveLossReason = "queue_shed" | "shutdown_forwarder_failure" | "retry_exhausted";
-export type ArchiveLossRecord = {
-    timestamp: string;
-    source: BrokerArchiveSource;
-    deployment_id: string;
-    reason: ArchiveLossReason;
-    payload: BrokerArchiveRow;
-    record_version: typeof LOSS_JOURNAL_RECORD_VERSION;
-    batch_id: string | null;
-    batch_row_index: number;
-    batch_row_count: number;
-};
-type ParsedArchiveLossRecordBase = Omit<ArchiveLossRecord, "payload" | "record_version" | "batch_id" | "batch_row_index" | "batch_row_count"> & {
-    payload: {
-        table: string;
-        row: Record<string, unknown>;
-    };
-};
-export type ParsedArchiveLossRecord = ParsedArchiveLossRecordBase & (Pick<ArchiveLossRecord, "record_version" | "batch_id" | "batch_row_index" | "batch_row_count"> | {
-    record_version?: never;
-    batch_id?: never;
-    batch_row_index?: never;
-    batch_row_count?: never;
-});
-export type ParsedLossJournalLine = {
-    ok: true;
-    record: ParsedArchiveLossRecord;
-} | {
-    ok: false;
-    reason: string;
-};
-export declare function parseLossJournalLine(line: string): ParsedLossJournalLine;
-export declare function lossJournalLineDigest(rawLine: string): string;
-export {};

package/dist/helpers/broker-execution-archive/redact.d.ts

@@ -1,7 +0,0 @@
-export declare function redactErrorForArchive(error: unknown): {
-    error_type?: string;
-    error_message?: string;
-};
-export declare function redactSecretLiterals(value: string, secretLiterals?: readonly string[]): string;
-export declare function redactStreamPayload(payload: unknown, secretLiterals?: readonly string[]): Record<string, unknown>;
-export declare function hashMarketMetadata(payload: unknown): string | undefined;

package/dist/helpers/broker-execution-archive/rows.d.ts

@@ -1,134 +0,0 @@
-import type { OrderExecutionTelemetry } from "../order-telemetry";
-import { type BrokerArchiveCommonTags, type BrokerArchiveRow, type BrokerArchiveSource, type OrderArchiveAction, type SubscribeArchiveType, type TransferEventKind, type TransferLifecycleAction } from "./types";
-type BalanceQuantityMap = Record<string, string>;
-export type NormalizedCcxtBalance = {
-    exchangeTimestamp?: string;
-    reportedAssets: string[];
-    assetEntryAssets: string[];
-    freeBalances: BalanceQuantityMap;
-    usedBalances: BalanceQuantityMap;
-    totalBalances: BalanceQuantityMap;
-    freeMapPresent: boolean;
-    usedMapPresent: boolean;
-    totalMapPresent: boolean;
-};
-export declare function normalizeTimestamp(value: unknown): string | undefined;
-export declare function normalizeCcxtBalanceForArchive(balance: unknown): NormalizedCcxtBalance;
-export declare function buildAccountBalanceSnapshotRow(input: {
-    tags: BrokerArchiveCommonTags;
-    balance: NormalizedCcxtBalance;
-}): BrokerArchiveRow;
-export type NormalizedUserAssets = {
-    reportedAssets: string[];
-    incompleteAssets: string[];
-    freeBalances: BalanceQuantityMap;
-    lockedBalances: BalanceQuantityMap;
-    freezeBalances: BalanceQuantityMap;
-    withdrawingBalances: BalanceQuantityMap;
-};
-/**
- * Normalizes a `POST /sapi/v3/asset/getUserAsset` response into one coherent
- * snapshot.
- *
- * Fails closed on a response shape we cannot account for: a non-array body or a
- * duplicate/unkeyed asset entry would each drop owned quantity on the floor, and
- * an under-counted NAV is worse than an absent one. Per-bucket uncertainty is
- * narrower and is reported rather than thrown: the asset is listed in
- * `incompleteAssets` and its key is left out of the bucket map, so a reader sees
- * "unknown", never an implicit zero.
- */
-export declare function normalizeBinanceUserAssetsForArchive(response: unknown): NormalizedUserAssets;
-export declare function buildUserAssetSnapshotRow(input: {
-    tags: BrokerArchiveCommonTags;
-    userAssets: NormalizedUserAssets;
-}): BrokerArchiveRow;
-export declare function buildCommonArchiveTags(input: {
-    source?: BrokerArchiveSource;
-    deploymentId: string;
-    accountSelector?: string;
-    exchange: string;
-    symbol?: string;
-    brokerObservedTimestamp?: string;
-}): BrokerArchiveCommonTags;
-export declare function buildOrderEventArchiveRow(input: {
-    tags: BrokerArchiveCommonTags;
-    action: OrderArchiveAction;
-    telemetry: OrderExecutionTelemetry;
-    errorDetail?: string;
-    eventKind?: "execute_action" | "subscribe_stream";
-    subscriptionType?: SubscribeArchiveType;
-    marketMetadataHash?: string;
-}): BrokerArchiveRow;
-export declare function buildSubscribeStreamArchiveRow(input: {
-    tags: BrokerArchiveCommonTags;
-    subscriptionType: SubscribeArchiveType;
-    streamPayload: unknown;
-    secretLiterals?: readonly string[];
-}): BrokerArchiveRow;
-export declare function extractBinanceInternalTransferId(response: unknown): string | undefined;
-export type TransferArchiveFields = {
-    eventKind: TransferEventKind;
-    lifecycleAction: TransferLifecycleAction;
-    status?: string;
-    assetSymbol?: string;
-    amount?: string;
-    address?: string;
-    network?: string;
-    externalId?: string;
-    clientWithdrawalId?: string;
-    txid?: string;
-    resultIndex?: number;
-    feeAmount?: string;
-    feeCurrency?: string;
-    exchangeTimestamp?: string;
-    errorSummary?: string;
-    payload: unknown;
-};
-export declare function buildTransferEventArchiveRow(input: {
-    tags: BrokerArchiveCommonTags;
-    transfer: TransferArchiveFields;
-}): BrokerArchiveRow;
-export type NormalizedCcxtTransfer = {
-    externalId?: string;
-    clientWithdrawalId?: string;
-    txid?: string;
-    address?: string;
-    network?: string;
-    amount?: string;
-    assetSymbol?: string;
-    status?: string;
-    feeAmount?: string;
-    feeCurrency?: string;
-    exchangeTimestamp?: string;
-};
-export declare function normalizeCcxtTransactionForArchive(transaction: unknown): NormalizedCcxtTransfer;
-export type FillArchiveFields = {
-    orderId?: string;
-    clientOrderId?: string;
-    fillId?: string;
-    fillIndex?: number;
-    side?: string;
-    orderType?: string;
-    price?: string;
-    baseQuantity?: string;
-    quoteQuantity?: string;
-    feeAmount?: string;
-    feeCurrency?: string;
-    feeRate?: string;
-    exchangeTimestamp?: string;
-    payload: unknown;
-};
-export declare function buildFillEventArchiveRow(input: {
-    tags: BrokerArchiveCommonTags;
-    fill: FillArchiveFields;
-}): BrokerArchiveRow;
-export declare function normalizeCcxtTradeForArchive(trade: unknown): FillArchiveFields;
-export declare function buildMarketMetadataSnapshotRow(input: {
-    tags: BrokerArchiveCommonTags;
-    clientOrderId?: string;
-    orderId?: string;
-    makerActionId?: string;
-    idempotencyId?: string;
-    marketSnapshot: unknown;
-}): BrokerArchiveRow;
-export {};

package/dist/helpers/broker-execution-archive/types.d.ts

@@ -1,26 +0,0 @@
-export declare const BROKER_READ_SOURCE: "broker_read";
-export declare const BROKER_WRITE_SOURCE: "broker_write";
-export type BrokerArchiveSource = typeof BROKER_READ_SOURCE | typeof BROKER_WRITE_SOURCE;
-export declare const ARCHIVE_SCHEMA_VERSION: "1";
-export type BrokerArchiveTable = "broker_execution.order_events" | "broker_execution.market_metadata_snapshots" | "broker_execution.transfer_events" | "broker_execution.fill_events" | "broker_account.balance_snapshots" | "broker_account.user_asset_snapshots" | "market_data.orderbook_snapshots" | "market_data.candles" | "market_data.cex_stream_events" | "market_data.cex_ticker_events" | "market_data.cex_trades" | "market_data.cex_ohlcv" | "market_data.cex_order_book_levels" | "market_data.cex_order_book_depth_summary";
-export type BrokerArchiveRow = {
-    table: BrokerArchiveTable;
-    row: Record<string, unknown>;
-};
-export type BrokerArchiveCommonTags = {
-    source: BrokerArchiveSource;
-    deployment_id: string;
-    account_selector: string;
-    exchange: string;
-    symbol: string;
-    broker_observed_timestamp: string;
-};
-export type OrderArchiveAction = "CreateOrder" | "CancelOrder" | "GetOrderDetails";
-export type SubscribeArchiveType = "ORDERS" | "BALANCE";
-export type TransferEventKind = "withdrawal" | "deposit" | "internal_transfer" | "balance_delta";
-export type TransferLifecycleAction = "submit_withdrawal" | "observe_withdrawal" | "observe_deposit" | "observe_balance_update" | "submit_internal_transfer";
-export declare const FILL_EVENT_KIND: "trade_history_fill";
-export declare const ACCOUNT_BALANCE_SCOPE: "spot";
-export declare const ACCOUNT_BALANCE_PRECISION_BASIS: "ccxt_normalized_number";
-export declare const USER_ASSET_BALANCE_SCOPE: "user_asset";
-export declare const USER_ASSET_PRECISION_BASIS: "venue_raw_string";

package/dist/helpers/broker-execution-archive/withdrawal-observation-tracker.d.ts

@@ -1,23 +0,0 @@
-import type { NormalizedCcxtTransfer } from "./rows";
-export declare const DEFAULT_WITHDRAWAL_OBSERVATION_TRACKER_MAX_ENTRIES = 10000;
-type WithdrawalObservation = {
-    exchange: string;
-    accountSelector?: string;
-    assetSymbol?: string;
-    transaction: unknown;
-    normalized: NormalizedCcxtTransfer;
-};
-/**
- * Suppresses unchanged withdrawal-history observations within one broker process.
- * The tracker intentionally persists no state: restart replay is absorbed by
- * archive consumers, while the in-process bound prevents unbounded venue history.
- */
-export declare class WithdrawalObservationTracker {
-    #private;
-    constructor(options?: {
-        maxEntries?: number;
-    });
-    shouldArchive(observation: WithdrawalObservation): boolean;
-    getSize(): number;
-}
-export {};