@usherlabs/cex-broker 0.2.52 → 0.3.0

package/dist/helpers/public-market-data-feed/supervisor.d.ts

@@ -1,82 +0,0 @@
-import type { Metadata } from "@grpc/grpc-js";
-import type { Exchange } from "@usherlabs/ccxt";
-import { type BrokerPoolEntry } from "../broker";
-import type { BrokerExecutionArchiver } from "../broker-execution-archive";
-import { type OhlcvArchiveInput, type OhlcvBarTracker, type OrderbookArchiveInput, type TickerArchiveInput, type TradesArchiveInput } from "../market-data-archive";
-import { type BrokerMarketType } from "../market-type";
-import type { OtelMetrics } from "../otel";
-import { type PublicFeedName } from "./identity";
-import { type OrderBookAcquisitionProfile, type OrderBookAcquisitionProfileInput } from "./orderbook-profile";
-import { type PublicFeedFrame, type PublicFeedSubscriberBufferOptions } from "./subscriber-buffer";
-export type PublicFeedArchiveContext = {
-    deploymentId: string;
-    exchange: string;
-    symbol: string;
-    assetType: BrokerMarketType;
-    accountSelector?: string;
-};
-export interface PublicMarketDataArchiveSink {
-    orderbook(input: OrderbookArchiveInput, options: {
-        sampledOut: boolean;
-    }): void;
-    ticker(input: TickerArchiveInput): void;
-    trades(input: TradesArchiveInput): void;
-    ohlcv(tracker: OhlcvBarTracker, input: OhlcvArchiveInput): void;
-    ohlcvBootstrap(tracker: OhlcvBarTracker, input: OhlcvArchiveInput): void;
-}
-type Metrics = Pick<OtelMetrics, "recordCounter"> & Partial<Pick<OtelMetrics, "recordGauge">>;
-export type PublicMarketDataFeedSupervisorOptions = {
-    brokers: Record<string, BrokerPoolEntry>;
-    brokerArchiver?: BrokerExecutionArchiver;
-    otelMetrics?: OtelMetrics;
-    archiveSink?: PublicMarketDataArchiveSink;
-    metrics?: Metrics;
-    bufferLimits?: PublicFeedSubscriberBufferOptions;
-    retirementTimeoutMs?: number;
-    createRequestBroker?: (exchange: string, metadata: Metadata | undefined) => Exchange | null;
-    createPublicBroker?: (exchange: string) => Exchange | null;
-    resolveOrderBookProfile?: (input: OrderBookAcquisitionProfileInput) => OrderBookAcquisitionProfile;
-    enabledOrderBookProfileIds?: ReadonlySet<string>;
-    observer?: PublicMarketDataFeedObserver;
-};
-export type PublicFeedObservation = {
-    key: string;
-    exchange: string;
-    feed: PublicFeedName;
-    marketType: BrokerMarketType;
-    profile?: string;
-    subscriberCount: number;
-};
-export interface PublicMarketDataFeedObserver {
-    workerStarted?(observation: PublicFeedObservation): void;
-    subscriberAttached?(observation: PublicFeedObservation): void;
-    physicalFrame?(observation: PublicFeedObservation): void;
-    archiveDecision?(observation: PublicFeedObservation): void;
-    delivered?(observation: PublicFeedObservation): void;
-    overflow?(observation: PublicFeedObservation): void;
-    workerRetired?(observation: PublicFeedObservation): void;
-}
-export type PublicFeedSubscribeOptions = {
-    exchange: string;
-    symbol: string;
-    marketType?: string;
-    feed: PublicFeedName;
-    depthLimit?: number;
-    timeframe?: string;
-    bootstrapLimit?: number;
-    metadata?: Metadata;
-};
-export interface PublicMarketDataSubscription extends AsyncIterable<PublicFeedFrame> {
-    readonly key: string;
-    readonly acquisitionProfileId?: string;
-    close(): void;
-}
-/** Owns one physical public CCXT watch/archive path per canonical runtime key. */
-export declare class PublicMarketDataFeedSupervisor {
-    #private;
-    private readonly options;
-    constructor(options: PublicMarketDataFeedSupervisorOptions);
-    subscribe(input: PublicFeedSubscribeOptions): Promise<PublicMarketDataSubscription>;
-    close(): Promise<void>;
-}
-export {};

package/dist/helpers/shared/errors.d.ts

@@ -1,14 +0,0 @@
-export declare const REDACTED_ERROR_MESSAGE = "redacted_error";
-export declare function getErrorMessage(error: unknown): string;
-/** Constructor/class name of a caught error (ccxt classes like InsufficientFunds,
- * BadSymbol, OrderNotFound carry the actionable signal). The generic `Error` name
- * adds nothing, so it is dropped; returns undefined for non-Error values. */
-export declare function errorClassName(error: unknown): string | undefined;
-/** Sanitized, single-line, length-capped detail for a caught error: the venue
- * error class, optional primitive code, and message. It never includes a stack
- * or attached payload. */
-export declare function sanitizeErrorDetail(error: unknown, options?: {
-    includeCode?: boolean;
-}): string;
-export declare function safeLogError(context: string, error: unknown): void;
-export declare function safeLogRedactedError(context: string, error: unknown): void;

package/dist/helpers/shared/guards.d.ts

@@ -1,2 +0,0 @@
-export declare function isRecord(value: unknown): value is Record<string, unknown>;
-export declare function asRecord<T extends Record<string, unknown> = Record<string, unknown>>(value: unknown): T | undefined;

package/dist/helpers/source-tape-sandbox.d.ts

@@ -1,82 +0,0 @@
-import type { ArchiveQueryClient } from "./market-data-vendor-backfill/archive-reader";
-import type { ArchiveSelectionWire, ForwarderBatch, MarketDataVendorBackfillRequest, ProviderObjectEvidence } from "./market-data-vendor-backfill/contracts";
-import type { CandidateVerification } from "./market-data-vendor-backfill/core";
-import { SOURCE_TAPE_CONSTRUCTION_MODE, SOURCE_TAPE_SANDBOX_TARGET, type SourceTapeArchiveSinkResult } from "./source-tape";
-export declare function verifySourceTapeArchive(input: {
-    request: MarketDataVendorBackfillRequest;
-    sinkResult: SourceTapeArchiveSinkResult;
-    client: ArchiveQueryClient;
-}): Promise<CandidateVerification>;
-export type SourceTapeExportArtifact = {
-    file_name: string;
-    rows: number;
-    bytes: number;
-    sha256: string;
-    projection_schema_id: string;
-    projection_schema_sha256: string;
-};
-export type SourceTapeExportResult = {
-    promotionReceiptIds: string[];
-    levels: SourceTapeExportArtifact;
-    summary: SourceTapeExportArtifact;
-};
-export type SourceTapeSandboxEvidence = {
-    schema_id: "market-data-source-tape-sandbox-evidence/v1";
-    archive_target: typeof SOURCE_TAPE_SANDBOX_TARGET;
-    construction_mode: typeof SOURCE_TAPE_CONSTRUCTION_MODE;
-    normal_archive_path: true;
-    tape_capability: {
-        policy_id: string;
-        policy_sha256: string;
-    };
-    state_count: number;
-    promotion: {
-        receipt_id: string;
-        promotion_identity_sha256: string;
-        qualification_event_id: string;
-    };
-    selection: {
-        selection_sha256: string;
-        receipt_ids: string[];
-    };
-    export: {
-        levels: SourceTapeExportArtifact;
-        summary: SourceTapeExportArtifact;
-    };
-    projection_schema_pins: readonly {
-        schema_id: string;
-        schema_sha256: string;
-    }[];
-};
-export declare function promoteAndExportSourceTapeSandbox(input: {
-    request: MarketDataVendorBackfillRequest;
-    sinkResult: SourceTapeArchiveSinkResult;
-    verification: CandidateVerification;
-    datasetObjects: ProviderObjectEvidence[];
-    vendorSemanticDigest: string;
-    verifiedAt: string;
-    forwarder: {
-        submit(batch: ForwarderBatch): Promise<{
-            ok: boolean;
-            inserted: number;
-        }>;
-    };
-    archive: {
-        resolveSelection(request: MarketDataVendorBackfillRequest): Promise<ArchiveSelectionWire>;
-    };
-    exporter: {
-        export(request: {
-            schema_id: "https://schemas.usher.so/cex-canonical-orderbook-export-request/v1";
-            request_id: string;
-            target: {
-                environment: string;
-                cluster: string;
-            };
-            selection: ArchiveSelectionWire;
-            depth: 100;
-            construction_mode: typeof SOURCE_TAPE_CONSTRUCTION_MODE;
-            canonical_schema_version: string;
-            checksum_algorithm: "sha256-canonical-json-v1";
-        }): Promise<SourceTapeExportResult>;
-    };
-}): Promise<SourceTapeSandboxEvidence>;

package/dist/helpers/source-tape.d.ts

@@ -1,165 +0,0 @@
-import type { BackfillArchiveRow, ForwarderBatch } from "./market-data-vendor-backfill/contracts";
-import { type PolicyNeutralCryptoHftBookState, type PolicyNeutralTapeSink } from "./market-data-vendor-backfill/cryptohftdata";
-export declare const SOURCE_TAPE_CAPABILITY: Readonly<{
-    policy_id: string;
-    provider: string;
-    adapter_version: string;
-    acquisition_policy_id: string;
-    exchange: string;
-    market_type: string;
-    feed: string;
-    trading_pairs: string[];
-    construction_mode: string;
-    canonical_schema_id: string;
-    depth: number;
-    source_window_scan: string;
-    provider_object_inventory: string;
-    state_emission: string;
-    state_window: string;
-    archive_target: {
-        environment: string;
-        cluster: string;
-    };
-    archive_path: string;
-    submission_bounds: {
-        max_states_per_yield: number;
-        max_rows_per_batch: number;
-        max_bytes_per_batch: number;
-        max_in_flight: number;
-    };
-    clickhouse_image: string;
-    clickhouse_server_version: string;
-    projection_schema_ids: string[];
-    policy_sha256: string;
-}>;
-export declare const SOURCE_TAPE_CAPABILITY_ID: string;
-export declare const SOURCE_TAPE_CONSTRUCTION_MODE: "policy_neutral_top_n_state_change_tape/v1";
-export declare const SOURCE_TAPE_DEPTH: 100;
-export declare const SOURCE_TAPE_MAX_STATES_PER_YIELD: 4;
-export declare const SOURCE_TAPE_MAX_BATCH_ROWS = 1000;
-export declare const SOURCE_TAPE_MAX_BATCH_BYTES: number;
-export declare const SOURCE_TAPE_MAX_IN_FLIGHT: 1;
-export declare const SOURCE_TAPE_SANDBOX_TARGET: Readonly<{
-    environment: "sandbox";
-    cluster: "cex-archive-local";
-}>;
-export declare const SOURCE_TAPE_PROJECTION_PINS: readonly Readonly<{
-    schema_id: string;
-    schema_sha256: string;
-}>[];
-export type SourceTapeProviderObjectInventory = {
-    expected_identities: string[];
-    observed_identities: string[];
-    complete: boolean;
-};
-export declare function sourceTapeCaptureBundleId(input: {
-    idempotencyKey: string;
-    tradingPair: "ARB-USDC" | "ARB-USDT";
-    window: {
-        startTimeMs: number;
-        endTimeMs: number;
-    };
-    expectedObjectIdentities: readonly string[];
-}): string;
-/**
- * `production` is the stable forwarder mutation-authorization class. It is not
- * an environment assertion: source-tape qualification remains sandbox-local.
- */
-export declare function assertSourceTapeSandboxAuthorization(input: {
-    requestAuthorizationId: string;
-    requestTarget: {
-        environment: string;
-        cluster: string;
-    };
-    preflight: {
-        authorizationId: string;
-        scope: "production";
-        environment: string;
-        cluster: string;
-        credentialValidated: boolean;
-    };
-}): void;
-export type SourceTapeArchiveSinkResult = {
-    capture_bundle_id: string;
-    state_count: number;
-    level_row_count: number;
-    summary_row_count: number;
-    forwarder_batch_count: number;
-    forwarder_batch_identity_sha256: string;
-    initializer: {
-        canonical_snapshot_id: string;
-        source_time_ms: number;
-        sequence: string;
-        semantic_stream_position: 0;
-    };
-    expected_semantic_digest: string;
-    first_state_descriptor_sha256: string;
-    last_state_descriptor_sha256: string;
-    provider_object_inventory_complete: true;
-    max_states_per_yield: typeof SOURCE_TAPE_MAX_STATES_PER_YIELD;
-    max_batch_rows: typeof SOURCE_TAPE_MAX_BATCH_ROWS;
-    max_batch_bytes: typeof SOURCE_TAPE_MAX_BATCH_BYTES;
-    max_in_flight_submissions: typeof SOURCE_TAPE_MAX_IN_FLIGHT;
-};
-export type SourceTapeSemanticStateDescriptor = {
-    state_kind: "initialization" | "change";
-    semantic_stream_position: number;
-    canonical_snapshot_id: string;
-    source_time_ms: number;
-    sequence: string;
-    canonical_rows_sha256: string;
-};
-export declare class SourceTapeSemanticDigestAccumulator {
-    private readonly hash;
-    private count;
-    constructor();
-    append(descriptor: SourceTapeSemanticStateDescriptor): void;
-    digest(): string;
-}
-export declare function sourceTapeSemanticStateDescriptor(input: {
-    stateKind: "initialization" | "change";
-    semanticStreamPosition: number;
-    rows: readonly BackfillArchiveRow[];
-}): SourceTapeSemanticStateDescriptor;
-export type SourceTapeArchiveSink = PolicyNeutralTapeSink & {
-    result(): SourceTapeArchiveSinkResult;
-};
-/**
- * Streams canonical tape rows to the existing archive-forwarder admission
- * tables. Promotion, selection and exporter-v2 finalization remain later
- * gates; this sink never creates a receipt or a success manifest by itself.
- */
-export declare function createSourceTapeArchiveSink(input: {
-    captureBundleId: string;
-    tradingPair: "ARB-USDC" | "ARB-USDT";
-    window: {
-        startTimeMs: number;
-        endTimeMs: number;
-    };
-    forwarder: {
-        submit(batch: ForwarderBatch): Promise<{
-            ok: boolean;
-            inserted: number;
-        }>;
-    };
-}): SourceTapeArchiveSink;
-export declare function providerObjectInventoryIsComplete(inventory: SourceTapeProviderObjectInventory): boolean;
-export declare function evaluateSourceTapeEligibility(input: {
-    source_enumeration_eligible: boolean;
-    provider_object_inventory: SourceTapeProviderObjectInventory;
-    tape_complete: boolean;
-    capability_id: string;
-    capability_sha256: string;
-    construction_mode: string;
-    projection_schema_pins: readonly {
-        schema_id: string;
-        schema_sha256: string;
-    }[];
-    artifact_sha256s: readonly string[];
-    tape_manifest_sha256: string;
-}): boolean;
-export declare function normalizeSourceTapeStates(input: {
-    tape: readonly PolicyNeutralCryptoHftBookState[];
-    capture_bundle_id: string;
-    trading_pair: "ARB-USDC" | "ARB-USDT";
-}): BackfillArchiveRow[];

package/dist/helpers/stream-health-publisher.d.ts

@@ -1,41 +0,0 @@
-export type StreamHealthState = "connecting" | "connected" | "disconnected" | "error";
-export type StreamHealthFailureKind = "none" | "auth_failed" | "transport_error" | "remote_closed" | "protocol_error" | "backpressure" | "unsupported_connector" | "shutdown";
-export type StreamHealthSnapshot = {
-    exchange: string;
-    accountSelector: string;
-    accountRole?: string;
-    streamKind: "user_data";
-    accountScope: "spot";
-    registryStatus: "active" | "retired";
-    retiredAt: string | null;
-    state: StreamHealthState;
-    stateChangedAt: string;
-    lastConnectedAt: string | null;
-    lastAuthenticatedAt: string | null;
-    lastReceivedAt: string | null;
-    connectAttemptCount: string;
-    reconnectCount: string;
-    errorCount: string;
-    lastFailureKind: StreamHealthFailureKind;
-    lastFailureReason: string;
-    trafficMode: "event_driven" | "continuous" | "unknown";
-    sourceWatermark: string | null;
-};
-export type StreamHealthPublisherOptions = {
-    deploymentId: string;
-    statePath: string;
-    forwarderUrl: string;
-    forwarderAuthToken?: string;
-    heartbeatIntervalMs?: number;
-    forwarderTimeoutMs?: number;
-    post?: (body: string) => Promise<void>;
-};
-/** A whole health batch is persisted before POST so retries are exact replays. */
-export declare class StreamHealthPublisher {
-    #private;
-    constructor(options: StreamHealthPublisherOptions);
-    start(): void;
-    publish(snapshots: readonly StreamHealthSnapshot[]): void;
-    close(snapshots: readonly StreamHealthSnapshot[], timeoutMs?: number): Promise<void>;
-}
-export declare function streamHealthPublisherConfigFromEnv(env?: NodeJS.ProcessEnv): StreamHealthPublisherOptions;

package/dist/helpers/trace-context.d.ts

@@ -1,8 +0,0 @@
-import type { Metadata } from "@grpc/grpc-js";
-/** gRPC metadata key for lightweight operational correlation with callers. */
-export declare const TRACE_METADATA_KEY = "x-trace-id";
-/**
- * Returns a validated caller correlation ID without mutating inbound metadata.
- * Invalid values are deliberately discarded before they can reach telemetry.
- */
-export declare function extractTraceId(metadata: Metadata): string | undefined;

package/dist/helpers/transfer-network.d.ts

@@ -1,12 +0,0 @@
-import type { Exchange } from "@usherlabs/ccxt";
-export type TransferNetworkResolution = {
-    operatorAlias: string;
-    brokerNetworkId: string;
-    exchangeNetworkId: string;
-    networkKey: string | null;
-};
-export declare function buildTransferNetworkEvidence(currencyInfo: Record<string, unknown>): {
-    networks: Record<string, unknown>;
-    aliases: Record<string, TransferNetworkResolution>;
-};
-export declare function resolveTransferNetwork(broker: Exchange, assetCode: string, operatorAlias: string): Promise<TransferNetworkResolution>;

package/dist/helpers/travel-rule-deposit-reconciler.d.ts

@@ -1,159 +0,0 @@
-import type { PolicyConfig, TravelRuleDepositConfig, TravelRuleDepositQuestionnaire } from "../types";
-import type { BrokerPoolEntry } from "./broker";
-import type { OtelMetrics } from "./otel";
-/**
- * Auto-clear reconciler for Binance travel-rule-frozen DEPOSITS.
- *
- * Under the AUSTRAC travel rule Binance credits an inbound deposit but holds it
- * in `getUserAsset.freeze` (invisible to free+locked balances) until a per-deposit
- * questionnaire is answered. This reconciler polls `localentity/deposit/history`
- * for such frozen deposits and submits the questionnaire — but only for deposits
- * whose on-chain sender is PROVEN (via `eth_getTransactionByHash`) to be one of
- * our configured originator wallets. Everything else is left frozen and surfaced.
- *
- * Compliance invariant: a deposit is NEVER auto-declared unless its origin is
- * proven ours. Undeclared origin, unresolvable sender, entity drift, or any
- * uncertainty all fail closed (skip + surface), never "declare anyway".
- *
- * This runs entirely broker-internal (not through the gRPC verity path), so
- * provide-info carries no verity proof — acceptable for a compliance attestation
- * that is not a trading action; see the plan's edge-case notes.
- */
-export type LocalEntityDeposit = {
-    tranId: string;
-    coin: string;
-    amount: string;
-    network: string;
-    txId: string;
-    travelRuleStatus: string;
-    requireQuestionnaire: boolean;
-    raw: Record<string, unknown>;
-};
-/**
- * Parses one raw `localentity/deposit/history` row. Returns null when the row
- * lacks a tranId (the only id valid for provide-info — the `capital/deposit/hisrec`
- * id is a different id space and yields "Deposit request not found").
- */
-export declare function parseLocalEntityDeposit(raw: Record<string, unknown>): LocalEntityDeposit | null;
-/**
- * Resolves the on-chain sender (`tx.from`) of a deposit's transaction hash via a
- * JSON-RPC `eth_getTransactionByHash`. Returns the lowercased sender, or null
- * when the hash is not a well-formed EVM tx hash or the tx is not found (pruned
- * node / reorg / not yet mined) — both of which mean the origin is UNPROVEN and
- * the caller must skip rather than assume.
- *
- * `tx.from` is the EOA that signed the deposit transaction. For our funding
- * churn (owner wallet → Binance via a direct ERC20 transfer) that equals the
- * token originator. A transfer routed through a contract could differ; hardening
- * to the ERC20 Transfer event's `from` is possible later if that case arises.
- *
- * Uses `node:https` rather than the global `fetch`: inside the Gramine SGX
- * enclave undici (which backs global fetch) fails to establish outbound
- * connections — the same failure mode as the enclave's dead Binance user-data
- * WebSocket — while the ccxt HTTP path (node http/https) works. Using node's
- * request keeps this on the transport that is proven to work in the enclave.
- */
-export declare function resolveOnChainSender(rpcUrl: string, txHash: string, timeoutMs?: number): Promise<string | null>;
-/** Binance rate-limit signals (-1003 / HTTP 429 / DDoS guard). */
-export declare function isRateLimitError(error: unknown): boolean;
-/**
- * A provide-info call that Binance treats as already-satisfied. Re-submitting a
- * tranId that was already provided (a manual release, or a reconciler restart)
- * must be idempotent, so these responses/errors count as success.
- */
-export declare function isAlreadyProvidedError(error: unknown): boolean;
-export type ReconcilerAccountState = {
-    submittedTranIds: Set<string>;
-    surfacedFailed: Set<string>;
-    backoffUntil: Map<string, number>;
-    rateLimitedUntil: number;
-};
-export declare function createAccountState(): ReconcilerAccountState;
-export type ReconcileOutcome = {
-    kind: "submitted";
-    deposit: LocalEntityDeposit;
-    sender: string;
-} | {
-    kind: "already-provided";
-    deposit: LocalEntityDeposit;
-    sender: string;
-} | {
-    kind: "undeclared-origin";
-    deposit: LocalEntityDeposit;
-    sender: string;
-} | {
-    kind: "unproven-origin";
-    deposit: LocalEntityDeposit;
-    error?: string;
-} | {
-    kind: "entity-drift";
-    deposit: LocalEntityDeposit;
-    country: string | null;
-} | {
-    kind: "failed-terminal";
-    deposit: LocalEntityDeposit;
-} | {
-    kind: "submit-error";
-    deposit: LocalEntityDeposit;
-    error: string;
-} | {
-    kind: "poll-error";
-    error: string;
-};
-export type ReconcileAccountReport = {
-    accountLabel: string;
-    frozenDeposits: LocalEntityDeposit[];
-    outcomes: ReconcileOutcome[];
-    hadActionableWork: boolean;
-};
-export type ReconcileAccountDeps = {
-    accountLabel: string;
-    depositConfig: TravelRuleDepositConfig;
-    expectedCountry: string;
-    failureBackoffMs: number;
-    rateLimitCooldownMs: number;
-    now: number;
-    state: ReconcilerAccountState;
-    fetchDepositHistory: () => Promise<Array<Record<string, unknown>>>;
-    fetchQuestionnaireCountry: () => Promise<string | null>;
-    resolveSender: (network: string, txId: string) => Promise<string | null>;
-    submitProvideInfo: (tranId: string, questionnaire: TravelRuleDepositQuestionnaire) => Promise<Record<string, unknown>>;
-    resolveQuestionnaire: (config: TravelRuleDepositConfig, sender: string) => TravelRuleDepositQuestionnaire | null;
-};
-/**
- * Reconciles a single account once. Pure orchestration: all I/O is injected so
- * the compliance invariants (never submit an unproven/undeclared/entity-drifted
- * deposit) are unit-testable without a network. Fetch/poll errors are captured
- * as outcomes rather than thrown so one bad account never stalls the loop.
- */
-export declare function reconcileAccountOnce(deps: ReconcileAccountDeps): Promise<ReconcileAccountReport>;
-export type TravelRuleDepositReconcilerConfig = {
-    rpcUrlsByNetwork: Record<string, string>;
-    pollIntervalActiveMs: number;
-    pollIntervalIdleMs: number;
-    expectedQuestionnaireCountry: string;
-    failureBackoffMs: number;
-    rateLimitCooldownMs: number;
-};
-/**
- * Builds reconciler config from the environment. RPC URLs are read from
- * `TRAVEL_RULE_RPC_URL_<NETWORK>` vars (network suffix must match Binance's
- * network code, e.g. `TRAVEL_RULE_RPC_URL_ARBITRUM`). These are intentionally NOT
- * `CEX_BROKER_`-prefixed so the credential env scan ignores them. Cadence and the
- * expected questionnaire country are overridable but default to the AU rollout.
- */
-export declare function loadTravelRuleDepositReconcilerConfigFromEnv(env: Record<string, string | undefined>): TravelRuleDepositReconcilerConfig;
-export declare class TravelRuleDepositReconciler {
-    #private;
-    private readonly params;
-    constructor(params: {
-        policy: PolicyConfig;
-        brokers: Record<string, BrokerPoolEntry>;
-        config: TravelRuleDepositReconcilerConfig;
-        metrics?: OtelMetrics;
-    });
-    /** True when at least one exchange has deposit auto-clear enabled in policy. */
-    static hasEnabledExchange(policy: PolicyConfig): boolean;
-    start(): void;
-    stop(): void;
-}

package/dist/helpers/travel-rule.d.ts

@@ -1,75 +0,0 @@
-import type { Exchange } from "@usherlabs/ccxt";
-import Joi from "joi";
-import type { PolicyConfig, TravelRuleDepositConfig, TravelRuleDepositQuestionnaire, TravelRuleQuestionnaire } from "../types";
-export declare const australiaQuestionnaireSchema: Joi.ObjectSchema<any>;
-export type TravelRuleDecision = {
-    mode: "standard";
-} | {
-    mode: "localentity";
-    questionnaire: TravelRuleQuestionnaire;
-} | {
-    mode: "denied";
-    error: string;
-};
-/**
- * Decides whether a withdrawal must use Binance's travel-rule endpoint.
- *
- * Travel rule is opt-in per exchange via the `enabled` flag, so a non-AU account
- * keeps using the standard endpoint. When enabled, the destination address must
- * have a configured questionnaire; if it does not we fail closed rather than fall
- * back to the standard endpoint (which would just reproduce the -4104 rejection).
- */
-export declare function resolveTravelRuleDecision(policy: PolicyConfig, exchange: string, recipientAddress: string): TravelRuleDecision;
-/**
- * Registers Binance's `localentity/withdraw/apply` endpoint on the exchange
- * instance. No-op for non-Binance exchanges. Idempotent — ccxt just reassigns
- * the generated implicit method if called again.
- */
-export declare function registerBinanceTravelRuleWithdrawEndpoint(exchange: Exchange): void;
-export declare const australiaDepositQuestionnaireSchema: Joi.ObjectSchema<any>;
-/**
- * Returns the enabled deposit travel-rule config for an exchange, or null when
- * the feature is absent or disabled. Gated solely by `deposits.enabled` (not the
- * entry's withdraw `enabled` flag): when null the reconciler does nothing for the
- * exchange, preserving exact pre-feature behavior.
- */
-export declare function getEnabledTravelRuleDepositConfig(policy: PolicyConfig, exchange: string): TravelRuleDepositConfig | null;
-/**
- * Looks up the questionnaire for a PROVEN on-chain sender. Matching is
- * case-insensitive. Returns null when the sender is not a declared originator —
- * the reconciler must then leave the deposit frozen and surface an anomaly
- * rather than attest an origin it cannot prove is ours.
- */
-export declare function resolveDepositOriginatorQuestionnaire(config: TravelRuleDepositConfig, senderAddress: string): TravelRuleDepositQuestionnaire | null;
-/**
- * Registers Binance's localentity deposit endpoints used by the reconciler:
- * the two read endpoints (deposit history + questionnaire requirements) and the
- * provide-info write. No-op for non-Binance exchanges. Idempotent.
- *
- * `localentity/deposit/provide-info` must be signed with the questionnaire JSON
- * RAW (unencoded) — see the @usherlabs/ccxt patch (`binance.sign` rawencode
- * branch). Signing it url-encoded yields Binance error -1022. The two GETs carry
- * only simple params and sign fine either way.
- *
- * provide-info is a 600-weight UID-limited write (same class as
- * capital/withdraw/apply), so it carries ccxt-binance's `4.0002` cost encoding
- * (`.0002` = charge the UID limiter) rather than a naive `1`, which would
- * under-throttle the write and invite -1003 once attestation is active.
- */
-export declare function registerBinanceTravelRuleDepositEndpoints(exchange: Exchange): void;
-type LocalEntityWithdrawArgs = {
-    code: string;
-    amount: number;
-    address: string;
-    network: string;
-    questionnaire: TravelRuleQuestionnaire;
-    params?: Record<string, string | number>;
-};
-/**
- * Mirrors ccxt's `binance.withdraw` currency/network/precision handling, but
- * targets the travel-rule endpoint and attaches the questionnaire. ccxt's
- * `urlencode` applies `encodeURIComponent` to the value, satisfying Binance's
- * requirement that the questionnaire JSON be URL-encoded in the request body.
- */
-export declare function withdrawViaLocalEntity(broker: Exchange, args: LocalEntityWithdrawArgs): Promise<import("@usherlabs/ccxt").Transaction>;
-export {};

package/dist/helpers/treasury-discovery.d.ts

@@ -1,17 +0,0 @@
-import type { Exchange } from "@usherlabs/ccxt";
-export type ExchangeWithDiscovery = Exchange & {
-    has?: Record<string, unknown>;
-    markets?: Record<string, unknown>;
-    currencies?: Record<string, unknown>;
-    fetchMarkets?: (...args: unknown[]) => Promise<unknown>;
-    fetchCurrencies?: (...args: unknown[]) => Promise<Record<string, unknown>>;
-    fetchDeposits?: (code?: string, since?: number, limit?: number, params?: Record<string, unknown>) => Promise<Array<Record<string, unknown>>>;
-};
-export declare function callArgs(args: unknown[] | undefined, params: Record<string, unknown> | undefined): unknown[];
-export declare function handleTreasuryDiscoveryCall(broker: Exchange, functionName: string, args: unknown[], params: Record<string, unknown>): Promise<{
-    handled: true;
-    result: unknown;
-} | {
-    handled: false;
-}>;
-export declare function fetchCurrencyMetadata(broker: Exchange, assetCode: string): Promise<Record<string, unknown> | undefined>;