@polyester/sdk 0.9.1 → 0.10.0

package/dist/services/orders/orders.js.map

@@ -1 +1 @@
-{"version":3,"file":"orders.js","names":["#readClient","ProtoRead.OrdersReadService","#writeClient","ProtoWrite.OrdersService","#realtime","#resolver","#scales","#orderSchema","#orderDetailsSchema","#newOrderInputSchema","#modifyOrderInputSchema","#batchCreateOrdersInputSchema","ProtoRead.OrderSchema"],"sources":["../../../src/services/orders/orders.ts"],"sourcesContent":["import * as ProtoRead from \"../../gen/orders/v1/orders_read_pb.js\";\nimport * as ProtoWrite from \"../../gen/orders/v1/orders_pb.js\";\nimport { createClient, type Client, type Transport } from \"@connectrpc/connect\";\nimport { publicationHandlerErrorContext } from \"../../shared/subscription-errors.js\";\nimport * as v from \"valibot\";\nimport { parse } from \"../../shared/validation.js\";\nimport { type SubaccountResolver, resolveAccountScopedInput } from \"../subaccount-resolver.js\";\nimport { removeUndefined } from \"../../utils/remove-undefined.js\";\nimport {\n    toConnectCallOptions,\n    type PolyesterMutationOptions,\n    type PolyesterRequestOptions,\n} from \"../../shared/request-options.js\";\nimport type { PolyesterRealtime } from \"../../realtime/types.js\";\nimport type { BaseSubscribeInput } from \"../../shared/types.js\";\nimport { createReadyGate, type SdkScales } from \"../../shared/decimal-surface.js\";\nimport { getOrderErrorDetail } from \"../../utils/connect-order-errors.js\";\nimport { formatConnectError, isResourceNotFoundError } from \"../../utils/errors.js\";\nimport {\n    OpenOrdersInputSchema,\n    OrderHistoryInputSchema,\n    type NewOrderInput,\n    createNewOrderInputSchema,\n    CancelOrderInputSchema,\n    CancelOrderResultSchema,\n    type CancelOrderResult,\n    CancelAllOrdersInputSchema,\n    CancelAllOrdersResponseSchema,\n    type CancelAllOrdersResponse,\n    type Order,\n    GetOrderDetailsInputSchema,\n    createCreateOrderResultSchema,\n    createPreviewOrderResultSchema,\n    type PreviewOrderResult,\n    type ModifyOrderInput,\n    assertKnownModifyOrderInputKeys,\n    createModifyOrderInputSchema,\n    ModifyOrderResultSchema,\n    type CreateOrderResult,\n    type ModifyOrderResult,\n    type OrderDetails,\n    createOrderSchema,\n    createOrderDetailsSchema,\n    CancelAllAfterInputSchema,\n    CancelAllAfterResultSchema,\n    type CancelAllAfterInput,\n    type CancelAllAfterResult,\n    BatchCancelOrdersInputSchema,\n    BatchCancelOrdersResultSchema,\n    type BatchCancelOrdersInput,\n    type BatchCancelOrdersResult,\n    createBatchCreateOrdersResultSchema,\n    type BatchCreateOrdersInput,\n    type BatchCreateOrdersResult,\n    BatchReplaceOrdersResultSchema,\n    type BatchReplaceOrdersInput,\n    type BatchReplaceOrdersResult,\n    GetBatchReplaceStatusInputSchema,\n    GetBatchReplaceStatusResultSchema,\n    type GetBatchReplaceStatusInput,\n    type GetBatchReplaceStatusResult,\n    assertKnownBatchReplaceOrderItemInputKeys,\n    createBatchCreateOrdersInputSchema,\n    createBatchReplaceOrdersInputSchema,\n} from \"./orders.schemas.js\";\n\nfunction hasKnownOrderSymbol(scales: SdkScales, order: { symbolId: number }): boolean {\n    try {\n        scales.baseQty(order.symbolId);\n        return true;\n    } catch {\n        return false;\n    }\n}\n\nconst MISCLASSIFIED_ORDER_NOT_FOUND_MESSAGE = \"order not found\";\n\nfunction isOrderNotFoundError(error: unknown): boolean {\n    return (\n        isResourceNotFoundError(error) ||\n        getOrderErrorDetail(error)?.code === \"NOT_FOUND\" ||\n        formatConnectError(error, \"\").toLowerCase() === MISCLASSIFIED_ORDER_NOT_FOUND_MESSAGE\n    );\n}\n\ninterface SubscribeOrdersInput extends BaseSubscribeInput<Order> {\n    accountId: string;\n}\n\nfunction createMutationRequestId(): string {\n    return (\n        globalThis.crypto?.randomUUID?.() ??\n        `req_${Date.now()}_${Math.random().toString(16).slice(2)}`\n    );\n}\n\nfunction assertBatchResultCount(operation: string, requested: number, returned: number): void {\n    if (requested !== returned) {\n        throw new Error(\n            `${operation} returned ${returned} results for ${requested} requested items.`,\n        );\n    }\n}\n\n/**\n * Manages account-scoped spot orders across read, write, and realtime order update surfaces.\n */\nexport class OrdersService {\n    #readClient: Client<typeof ProtoRead.OrdersReadService>;\n    #writeClient: Client<typeof ProtoWrite.OrdersService>;\n    #realtime: PolyesterRealtime;\n    #resolver?: SubaccountResolver;\n    #scales: SdkScales;\n    #orderSchema: ReturnType<typeof createOrderSchema>;\n    #orderDetailsSchema: ReturnType<typeof createOrderDetailsSchema>;\n    #newOrderInputSchema: ReturnType<typeof createNewOrderInputSchema>;\n    #modifyOrderInputSchema: ReturnType<typeof createModifyOrderInputSchema>;\n    #batchCreateOrdersInputSchema: ReturnType<typeof createBatchCreateOrdersInputSchema>;\n\n    constructor(\n        transport: Transport,\n        realtime: PolyesterRealtime,\n        resolver: SubaccountResolver | undefined,\n        scales: SdkScales,\n    ) {\n        this.#readClient = createClient(ProtoRead.OrdersReadService, transport);\n        this.#writeClient = createClient(ProtoWrite.OrdersService, transport);\n        this.#realtime = realtime;\n        this.#resolver = resolver;\n        this.#scales = scales;\n        this.#orderSchema = createOrderSchema(scales);\n        this.#orderDetailsSchema = createOrderDetailsSchema(scales);\n        this.#newOrderInputSchema = createNewOrderInputSchema(scales);\n        this.#modifyOrderInputSchema = createModifyOrderInputSchema(scales);\n        this.#batchCreateOrdersInputSchema = createBatchCreateOrdersInputSchema(scales);\n    }\n\n    /**\n     * Returns open orders for the resolved root account or subaccount, with optional symbol IDs, trigger ID, side, pagination, and attached-risk inclusion filters. Results are paginated with a server-determined page size: a single call is not the full set of open orders — keep calling with the returned nextPageToken until it is empty.\n     */\n    async listOpen(\n        input: v.InferInput<typeof OpenOrdersInputSchema> = {},\n        options?: PolyesterRequestOptions,\n    ): Promise<{ orders: Order[]; nextPageToken: string }> {\n        await this.#scales.ready();\n        const resolved = resolveAccountScopedInput(input, this.#resolver);\n        const validatedInput = parse(OpenOrdersInputSchema, resolved);\n        const res = await this.#readClient.getOpenOrders(\n            removeUndefined(validatedInput),\n            toConnectCallOptions(options),\n        );\n        return {\n            orders: parse(\n                v.array(this.#orderSchema),\n                res.orders.filter((order) => hasKnownOrderSymbol(this.#scales, order)),\n            ),\n            nextPageToken: res.nextPageToken,\n        };\n    }\n\n    /**\n     * Returns historical orders for the resolved account scope, supporting symbol IDs, trigger ID, side, status, time range, pagination, and attached-risk filters. Results are paginated with the backend nextPageToken.\n     */\n    async listHistory(\n        input: v.InferInput<typeof OrderHistoryInputSchema> = {},\n        options?: PolyesterRequestOptions,\n    ): Promise<{ orders: Order[]; nextPageToken: string }> {\n        await this.#scales.ready();\n        const resolved = resolveAccountScopedInput(input, this.#resolver);\n        const validatedInput = parse(OrderHistoryInputSchema, resolved);\n        const res = await this.#readClient.getOrderHistory(\n            removeUndefined(validatedInput),\n            toConnectCallOptions(options),\n        );\n        return {\n            orders: parse(\n                v.array(this.#orderSchema),\n                res.orders.filter((order) => hasKnownOrderSymbol(this.#scales, order)),\n            ),\n            nextPageToken: res.nextPageToken,\n        };\n    }\n\n    /**\n     * Evaluates one complete order intent against current market, policy, risk, and balance state without creating an order, reserving funds, or claiming its client order ID.\n     */\n    async preview(\n        input: NewOrderInput,\n        options?: PolyesterRequestOptions,\n    ): Promise<PreviewOrderResult> {\n        await this.#scales.ready();\n        const resolved = resolveAccountScopedInput(input, this.#resolver);\n        const request = parse(this.#newOrderInputSchema, resolved);\n        const response = await this.#writeClient.previewOrder(\n            removeUndefined(request),\n            toConnectCallOptions(options),\n        );\n        return parse(\n            createPreviewOrderResultSchema(this.#scales, request.order.symbolId),\n            response,\n        );\n    }\n\n    /**\n     * Places a spot order with an explicit market-IOC, limit-GTC, limit-IOC, or limit-FOK execution policy and optional attached risk controls. clientOrderId is the caller-controlled idempotency key and should be reused only for the same logical order.\n     */\n    async create(\n        input: NewOrderInput,\n        options?: PolyesterMutationOptions,\n    ): Promise<CreateOrderResult> {\n        await this.#scales.ready();\n        const resolved = resolveAccountScopedInput(input, this.#resolver);\n        const validatedInput = parse(this.#newOrderInputSchema, resolved);\n        const requestPayload = removeUndefined(validatedInput);\n        const res = await this.#writeClient.createOrder(\n            requestPayload,\n            toConnectCallOptions(options),\n        );\n        return parse(\n            createCreateOrderResultSchema(this.#scales, validatedInput.order.symbolId),\n            res,\n        );\n    }\n\n    /**\n     * Places 1–20 spot orders in one best-effort request. Results preserve item order and report admission as accepted or rejected; accepted orders still require lifecycle reconciliation. Supply a clientOrderId for each item and a stable requestId when an ambiguous batch may be retried.\n     */\n    async batchCreate(\n        input: BatchCreateOrdersInput,\n        options?: PolyesterMutationOptions,\n    ): Promise<BatchCreateOrdersResult> {\n        await this.#scales.ready();\n        const resolved = {\n            ...resolveAccountScopedInput(input, this.#resolver),\n            requestId: input.requestId ?? createMutationRequestId(),\n        };\n        const request = parse(this.#batchCreateOrdersInputSchema, resolved);\n        const response = await this.#writeClient.batchCreateOrders(\n            removeUndefined(request),\n            toConnectCallOptions(options),\n        );\n        const result = parse(\n            createBatchCreateOrdersResultSchema(\n                this.#scales,\n                request.items.map((item) => item.symbolId),\n            ),\n            response,\n        );\n        assertBatchResultCount(\"batchCreate\", input.items.length, result.results.length);\n        return result;\n    }\n\n    /**\n     * Requests cancellation of one order in the resolved account scope by order id or client order id, with optional symbol routing. The response acknowledges the cancellation request, not the order's final lifecycle state; reconcile through order reads or realtime before releasing local state. A missing target remains a {@link ResourceNotFoundError}; callers performing desired-state cleanup may treat that error as success when the order could already have filled or left the book.\n     */\n    async cancel(\n        input: v.InferInput<typeof CancelOrderInputSchema>,\n        options?: PolyesterMutationOptions,\n    ): Promise<CancelOrderResult> {\n        const resolved = resolveAccountScopedInput(input, this.#resolver);\n\n        const validated = parse(CancelOrderInputSchema, resolved);\n\n        const res = await this.#writeClient.cancelOrder(\n            {\n                key: validated.key,\n                symbolId: validated.symbolId,\n                subaccountId: validated.subaccountId,\n            },\n            toConnectCallOptions(options),\n        );\n        return parse(CancelOrderResultSchema, res);\n    }\n\n    /**\n     * Cancels 1–50 explicit orders in one best-effort request. Results preserve item order and acknowledge cancellation admission rather than final order state. Supply a stable requestId when an ambiguous batch may be retried.\n     */\n    async batchCancel(\n        input: BatchCancelOrdersInput,\n        options?: PolyesterMutationOptions,\n    ): Promise<BatchCancelOrdersResult> {\n        const resolved = {\n            ...resolveAccountScopedInput(input, this.#resolver),\n            requestId: input.requestId ?? createMutationRequestId(),\n        };\n        const request = parse(BatchCancelOrdersInputSchema, resolved);\n        const response = await this.#writeClient.batchCancelOrders(\n            removeUndefined(request),\n            toConnectCallOptions(options),\n        );\n        const result = parse(BatchCancelOrdersResultSchema, response);\n        assertBatchResultCount(\"batchCancel\", input.items.length, result.results.length);\n        return result;\n    }\n\n    /**\n     * Applies a price, quantity, client id, or attached-risk patch to one open order. The symbol ID routes policy checks and quantity scaling. A requestId is generated when omitted; provide a stable value when retrying the same logical modification.\n     */\n    async modify(\n        input: ModifyOrderInput,\n        options?: PolyesterMutationOptions,\n    ): Promise<ModifyOrderResult> {\n        await this.#scales.ready();\n        const resolved = {\n            ...resolveAccountScopedInput(input, this.#resolver),\n            requestId: input.requestId ?? createMutationRequestId(),\n        };\n        assertKnownModifyOrderInputKeys(resolved);\n        const validated = parse(this.#modifyOrderInputSchema, resolved);\n        const res = await this.#writeClient.modifyOrder(\n            removeUndefined(validated),\n            toConnectCallOptions(options),\n        );\n        return parse(ModifyOrderResultSchema, res);\n    }\n\n    /**\n     * Replaces 1–50 same-symbol orders and returns an index-stable durable admission receipt. Reuse requestId only when retrying the same logical batch; use the returned batchRequestId for later status reads.\n     */\n    async batchReplace(\n        input: BatchReplaceOrdersInput,\n        options?: PolyesterMutationOptions,\n    ): Promise<BatchReplaceOrdersResult> {\n        await this.#scales.ready();\n        for (const item of input.items) {\n            assertKnownBatchReplaceOrderItemInputKeys(item);\n        }\n        const resolved = {\n            ...resolveAccountScopedInput(input, this.#resolver),\n            requestId: input.requestId ?? createMutationRequestId(),\n        };\n        const request = parse(\n            createBatchReplaceOrdersInputSchema(this.#scales, input.symbolId),\n            resolved,\n        );\n        const response = await this.#writeClient.batchReplaceOrders(\n            removeUndefined(request),\n            toConnectCallOptions(options),\n        );\n        const result = parse(BatchReplaceOrdersResultSchema, response);\n        assertBatchResultCount(\"batchReplace\", input.items.length, result.results.length);\n        return result;\n    }\n\n    /**\n     * Reads the durable per-item execution status for a batch replacement receipt.\n     */\n    async getBatchReplaceStatus(\n        input: GetBatchReplaceStatusInput,\n        options?: PolyesterRequestOptions,\n    ): Promise<GetBatchReplaceStatusResult> {\n        const resolved = resolveAccountScopedInput(input, this.#resolver);\n        const request = parse(GetBatchReplaceStatusInputSchema, resolved);\n        const response = await this.#readClient.getBatchReplaceStatus(\n            removeUndefined(request),\n            toConnectCallOptions(options),\n        );\n        return parse(GetBatchReplaceStatusResultSchema, response);\n    }\n\n    /**\n     * Cancels all matching open orders for the resolved account scope, optionally narrowed by symbol ID and side, with dry-run preview. A requestId is generated when omitted; provide a stable value when retrying the same logical bulk cancellation.\n     */\n    async cancelAll(\n        input: v.InferInput<typeof CancelAllOrdersInputSchema>,\n        options?: PolyesterMutationOptions,\n    ): Promise<CancelAllOrdersResponse> {\n        const resolved = {\n            ...resolveAccountScopedInput(input, this.#resolver),\n            requestId: input.requestId ?? createMutationRequestId(),\n        };\n        const validated = parse(CancelAllOrdersInputSchema, resolved);\n        const res = await this.#writeClient.cancelAllOrders(\n            removeUndefined(validated),\n            toConnectCallOptions(options),\n        );\n        return parse(CancelAllOrdersResponseSchema, res);\n    }\n\n    /**\n     * Arms, refreshes, or disables the account dead-man switch, optionally scoped by symbol ID and side. timeoutSec 0 disables it; 10–120 arms it. Generate a new requestId for each deliberate heartbeat, but reuse the same ID when retrying one ambiguous heartbeat.\n     */\n    async cancelAllAfter(\n        input: CancelAllAfterInput,\n        options?: PolyesterMutationOptions,\n    ): Promise<CancelAllAfterResult> {\n        const resolved = {\n            ...resolveAccountScopedInput(input, this.#resolver),\n            requestId: input.requestId ?? createMutationRequestId(),\n        };\n        const request = parse(CancelAllAfterInputSchema, resolved);\n        const response = await this.#writeClient.cancelAllAfter(\n            removeUndefined(request),\n            toConnectCallOptions(options),\n        );\n        return parse(CancelAllAfterResultSchema, response);\n    }\n\n    /**\n     * Fetches one order by id or client order id and returns its order, trades, and transfer details when found. Returns null when the requested order is not found.\n     */\n    async getDetails(\n        input: v.InferInput<typeof GetOrderDetailsInputSchema>,\n        options?: PolyesterRequestOptions,\n    ): Promise<OrderDetails | null> {\n        await this.#scales.ready();\n        const resolved = resolveAccountScopedInput(input, this.#resolver);\n        const validatedInput = parse(GetOrderDetailsInputSchema, resolved);\n        let res: ProtoRead.GetOrderResponse;\n        try {\n            res = await this.#readClient.getOrder(\n                removeUndefined(validatedInput),\n                toConnectCallOptions(options),\n            );\n        } catch (error) {\n            if (isOrderNotFoundError(error)) return null;\n            throw error;\n        }\n        if (!res.order) return null;\n        return parse(this.#orderDetailsSchema, res);\n    }\n\n    /**\n     * Subscribes to private order updates on private:spot:orders:{accountId}:proto and emits parsed order records until the returned unsubscribe function is called.\n     */\n    subscribe(input: SubscribeOrdersInput): () => void {\n        const channel = `private:spot:orders:${input.accountId}:proto`;\n        const gate = createReadyGate(\n            () => this.#scales.ready(),\n            (error) => input.onError?.(publicationHandlerErrorContext(channel, error)),\n        );\n        return this.#realtime.connectProtoChannel({\n            channel,\n            schema: ProtoRead.OrderSchema,\n            onPublication: (data) => {\n                gate.run(() => {\n                    const order = parse(this.#orderSchema, data);\n                    input.onEvent(order);\n                });\n            },\n            onConnected: () => input.onOpen?.(),\n            onDisconnected: () => input.onClose?.(),\n            onError: input.onError,\n        });\n    }\n}\n"],"mappings":"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"}
+{"version":3,"file":"orders.js","names":["#readClient","ProtoRead.OrdersReadService","#writeClient","ProtoWrite.OrdersService","#realtime","#resolver","#scales","#orderSchema","#orderDetailsSchema","#newOrderInputSchema","#modifyOrderInputSchema","#batchCreateOrdersInputSchema","ProtoRead.OrderSchema"],"sources":["../../../src/services/orders/orders.ts"],"sourcesContent":["import * as ProtoRead from \"../../gen/orders/v1/orders_read_pb.js\";\nimport * as ProtoWrite from \"../../gen/orders/v1/orders_pb.js\";\nimport { createClient, type Client, type Transport } from \"@connectrpc/connect\";\nimport * as v from \"valibot\";\nimport { parse } from \"../../shared/validation.js\";\nimport { type SubaccountResolver, resolveAccountScopedInput } from \"../subaccount-resolver.js\";\nimport { removeUndefined } from \"../../utils/remove-undefined.js\";\nimport {\n    toConnectCallOptions,\n    type PolyesterMutationOptions,\n    type PolyesterRequestOptions,\n} from \"../../shared/request-options.js\";\nimport type { PolyesterRealtime } from \"../../realtime/types.js\";\nimport { connectReadyGatedProtoChannel } from \"../../realtime/ready-gated-subscription.js\";\nimport type { BaseSubscribeInput } from \"../../shared/types.js\";\nimport type { SdkScales } from \"../../shared/decimal-surface.js\";\nimport { getOrderErrorDetail } from \"../../utils/connect-order-errors.js\";\nimport { formatConnectError, isResourceNotFoundError } from \"../../utils/errors.js\";\nimport {\n    OpenOrdersInputSchema,\n    OrderHistoryInputSchema,\n    type NewOrderInput,\n    createNewOrderInputSchema,\n    CancelOrderInputSchema,\n    CancelOrderResultSchema,\n    type CancelOrderResult,\n    CancelAllOrdersInputSchema,\n    CancelAllOrdersResponseSchema,\n    type CancelAllOrdersResponse,\n    type Order,\n    GetOrderDetailsInputSchema,\n    createCreateOrderResultSchema,\n    createPreviewOrderResultSchema,\n    type PreviewOrderResult,\n    type ModifyOrderInput,\n    assertKnownModifyOrderInputKeys,\n    createModifyOrderInputSchema,\n    ModifyOrderResultSchema,\n    type CreateOrderResult,\n    type ModifyOrderResult,\n    type OrderDetails,\n    createOrderSchema,\n    createOrderDetailsSchema,\n    CancelAllAfterInputSchema,\n    CancelAllAfterResultSchema,\n    type CancelAllAfterInput,\n    type CancelAllAfterResult,\n    BatchCancelOrdersInputSchema,\n    BatchCancelOrdersResultSchema,\n    type BatchCancelOrdersInput,\n    type BatchCancelOrdersResult,\n    createBatchCreateOrdersResultSchema,\n    type BatchCreateOrdersInput,\n    type BatchCreateOrdersResult,\n    BatchReplaceOrdersResultSchema,\n    type BatchReplaceOrdersInput,\n    type BatchReplaceOrdersResult,\n    GetBatchReplaceStatusInputSchema,\n    GetBatchReplaceStatusResultSchema,\n    type GetBatchReplaceStatusInput,\n    type GetBatchReplaceStatusResult,\n    assertKnownBatchReplaceOrderItemInputKeys,\n    createBatchCreateOrdersInputSchema,\n    createBatchReplaceOrdersInputSchema,\n} from \"./orders.schemas.js\";\n\nfunction hasKnownOrderSymbol(scales: SdkScales, order: { symbolId: number }): boolean {\n    try {\n        scales.baseQty(order.symbolId);\n        return true;\n    } catch {\n        return false;\n    }\n}\n\nconst MISCLASSIFIED_ORDER_NOT_FOUND_MESSAGE = \"order not found\";\n\nfunction isOrderNotFoundError(error: unknown): boolean {\n    return (\n        isResourceNotFoundError(error) ||\n        getOrderErrorDetail(error)?.code === \"NOT_FOUND\" ||\n        formatConnectError(error, \"\").toLowerCase() === MISCLASSIFIED_ORDER_NOT_FOUND_MESSAGE\n    );\n}\n\ninterface SubscribeOrdersInput extends BaseSubscribeInput<Order> {\n    accountId: string;\n}\n\nfunction createMutationRequestId(): string {\n    return (\n        globalThis.crypto?.randomUUID?.() ??\n        `req_${Date.now()}_${Math.random().toString(16).slice(2)}`\n    );\n}\n\nfunction assertBatchResultCount(operation: string, requested: number, returned: number): void {\n    if (requested !== returned) {\n        throw new Error(\n            `${operation} returned ${returned} results for ${requested} requested items.`,\n        );\n    }\n}\n\n/**\n * Manages account-scoped spot orders across read, write, and realtime order update surfaces.\n */\nexport class OrdersService {\n    #readClient: Client<typeof ProtoRead.OrdersReadService>;\n    #writeClient: Client<typeof ProtoWrite.OrdersService>;\n    #realtime: PolyesterRealtime;\n    #resolver?: SubaccountResolver;\n    #scales: SdkScales;\n    #orderSchema: ReturnType<typeof createOrderSchema>;\n    #orderDetailsSchema: ReturnType<typeof createOrderDetailsSchema>;\n    #newOrderInputSchema: ReturnType<typeof createNewOrderInputSchema>;\n    #modifyOrderInputSchema: ReturnType<typeof createModifyOrderInputSchema>;\n    #batchCreateOrdersInputSchema: ReturnType<typeof createBatchCreateOrdersInputSchema>;\n\n    constructor(\n        transport: Transport,\n        realtime: PolyesterRealtime,\n        resolver: SubaccountResolver | undefined,\n        scales: SdkScales,\n    ) {\n        this.#readClient = createClient(ProtoRead.OrdersReadService, transport);\n        this.#writeClient = createClient(ProtoWrite.OrdersService, transport);\n        this.#realtime = realtime;\n        this.#resolver = resolver;\n        this.#scales = scales;\n        this.#orderSchema = createOrderSchema(scales);\n        this.#orderDetailsSchema = createOrderDetailsSchema(scales);\n        this.#newOrderInputSchema = createNewOrderInputSchema(scales);\n        this.#modifyOrderInputSchema = createModifyOrderInputSchema(scales);\n        this.#batchCreateOrdersInputSchema = createBatchCreateOrdersInputSchema(scales);\n    }\n\n    /**\n     * Returns open orders for the resolved root account or subaccount, with optional symbol IDs, trigger ID, side, pagination, and attached-risk inclusion filters. Results are paginated with a server-determined page size: a single call is not the full set of open orders — keep calling with the returned nextPageToken until it is empty.\n     */\n    async listOpen(\n        input: v.InferInput<typeof OpenOrdersInputSchema> = {},\n        options?: PolyesterRequestOptions,\n    ): Promise<{ orders: Order[]; nextPageToken: string }> {\n        await this.#scales.ready();\n        const resolved = resolveAccountScopedInput(input, this.#resolver);\n        const validatedInput = parse(OpenOrdersInputSchema, resolved);\n        const res = await this.#readClient.getOpenOrders(\n            removeUndefined(validatedInput),\n            toConnectCallOptions(options),\n        );\n        return {\n            orders: parse(\n                v.array(this.#orderSchema),\n                res.orders.filter((order) => hasKnownOrderSymbol(this.#scales, order)),\n            ),\n            nextPageToken: res.nextPageToken,\n        };\n    }\n\n    /**\n     * Returns historical orders for the resolved account scope, supporting symbol IDs, trigger ID, side, status, time range, pagination, and attached-risk filters. Results are paginated with the backend nextPageToken.\n     */\n    async listHistory(\n        input: v.InferInput<typeof OrderHistoryInputSchema> = {},\n        options?: PolyesterRequestOptions,\n    ): Promise<{ orders: Order[]; nextPageToken: string }> {\n        await this.#scales.ready();\n        const resolved = resolveAccountScopedInput(input, this.#resolver);\n        const validatedInput = parse(OrderHistoryInputSchema, resolved);\n        const res = await this.#readClient.getOrderHistory(\n            removeUndefined(validatedInput),\n            toConnectCallOptions(options),\n        );\n        return {\n            orders: parse(\n                v.array(this.#orderSchema),\n                res.orders.filter((order) => hasKnownOrderSymbol(this.#scales, order)),\n            ),\n            nextPageToken: res.nextPageToken,\n        };\n    }\n\n    /**\n     * Evaluates one complete order intent against current market, policy, risk, and balance state without creating an order, reserving funds, or claiming its client order ID.\n     */\n    async preview(\n        input: NewOrderInput,\n        options?: PolyesterRequestOptions,\n    ): Promise<PreviewOrderResult> {\n        await this.#scales.ready();\n        const resolved = resolveAccountScopedInput(input, this.#resolver);\n        const request = parse(this.#newOrderInputSchema, resolved);\n        const response = await this.#writeClient.previewOrder(\n            removeUndefined(request),\n            toConnectCallOptions(options),\n        );\n        return parse(\n            createPreviewOrderResultSchema(this.#scales, request.order.symbolId),\n            response,\n        );\n    }\n\n    /**\n     * Places a spot order with an explicit market-IOC, limit-GTC, limit-IOC, or limit-FOK execution policy and optional attached risk controls. clientOrderId is the caller-controlled idempotency key and should be reused only for the same logical order.\n     */\n    async create(\n        input: NewOrderInput,\n        options?: PolyesterMutationOptions,\n    ): Promise<CreateOrderResult> {\n        await this.#scales.ready();\n        const resolved = resolveAccountScopedInput(input, this.#resolver);\n        const validatedInput = parse(this.#newOrderInputSchema, resolved);\n        const requestPayload = removeUndefined(validatedInput);\n        const res = await this.#writeClient.createOrder(\n            requestPayload,\n            toConnectCallOptions(options),\n        );\n        return parse(\n            createCreateOrderResultSchema(this.#scales, validatedInput.order.symbolId),\n            res,\n        );\n    }\n\n    /**\n     * Places 1–20 spot orders in one best-effort request. Results preserve item order and report admission as accepted or rejected; accepted orders still require lifecycle reconciliation. Supply a clientOrderId for each item and a stable requestId when an ambiguous batch may be retried.\n     */\n    async batchCreate(\n        input: BatchCreateOrdersInput,\n        options?: PolyesterMutationOptions,\n    ): Promise<BatchCreateOrdersResult> {\n        await this.#scales.ready();\n        const resolved = {\n            ...resolveAccountScopedInput(input, this.#resolver),\n            requestId: input.requestId ?? createMutationRequestId(),\n        };\n        const request = parse(this.#batchCreateOrdersInputSchema, resolved);\n        const response = await this.#writeClient.batchCreateOrders(\n            removeUndefined(request),\n            toConnectCallOptions(options),\n        );\n        const result = parse(\n            createBatchCreateOrdersResultSchema(\n                this.#scales,\n                request.items.map((item) => item.symbolId),\n            ),\n            response,\n        );\n        assertBatchResultCount(\"batchCreate\", input.items.length, result.results.length);\n        return result;\n    }\n\n    /**\n     * Requests cancellation of one order in the resolved account scope by order id or client order id, with optional symbol routing. The response acknowledges the cancellation request, not the order's final lifecycle state; reconcile through order reads or realtime before releasing local state. A missing target remains a {@link ResourceNotFoundError}; callers performing desired-state cleanup may treat that error as success when the order could already have filled or left the book.\n     */\n    async cancel(\n        input: v.InferInput<typeof CancelOrderInputSchema>,\n        options?: PolyesterMutationOptions,\n    ): Promise<CancelOrderResult> {\n        const resolved = resolveAccountScopedInput(input, this.#resolver);\n\n        const validated = parse(CancelOrderInputSchema, resolved);\n\n        const res = await this.#writeClient.cancelOrder(\n            {\n                key: validated.key,\n                symbolId: validated.symbolId,\n                subaccountId: validated.subaccountId,\n            },\n            toConnectCallOptions(options),\n        );\n        return parse(CancelOrderResultSchema, res);\n    }\n\n    /**\n     * Cancels 1–50 explicit orders in one best-effort request. Results preserve item order and acknowledge cancellation admission rather than final order state. Supply a stable requestId when an ambiguous batch may be retried.\n     */\n    async batchCancel(\n        input: BatchCancelOrdersInput,\n        options?: PolyesterMutationOptions,\n    ): Promise<BatchCancelOrdersResult> {\n        const resolved = {\n            ...resolveAccountScopedInput(input, this.#resolver),\n            requestId: input.requestId ?? createMutationRequestId(),\n        };\n        const request = parse(BatchCancelOrdersInputSchema, resolved);\n        const response = await this.#writeClient.batchCancelOrders(\n            removeUndefined(request),\n            toConnectCallOptions(options),\n        );\n        const result = parse(BatchCancelOrdersResultSchema, response);\n        assertBatchResultCount(\"batchCancel\", input.items.length, result.results.length);\n        return result;\n    }\n\n    /**\n     * Applies a price, quantity, client id, or attached-risk patch to one open order. The symbol ID routes policy checks and quantity scaling. A requestId is generated when omitted; provide a stable value when retrying the same logical modification.\n     */\n    async modify(\n        input: ModifyOrderInput,\n        options?: PolyesterMutationOptions,\n    ): Promise<ModifyOrderResult> {\n        await this.#scales.ready();\n        const resolved = {\n            ...resolveAccountScopedInput(input, this.#resolver),\n            requestId: input.requestId ?? createMutationRequestId(),\n        };\n        assertKnownModifyOrderInputKeys(resolved);\n        const validated = parse(this.#modifyOrderInputSchema, resolved);\n        const res = await this.#writeClient.modifyOrder(\n            removeUndefined(validated),\n            toConnectCallOptions(options),\n        );\n        return parse(ModifyOrderResultSchema, res);\n    }\n\n    /**\n     * Replaces 1–50 same-symbol orders and returns an index-stable durable admission receipt. Reuse requestId only when retrying the same logical batch; use the returned batchRequestId for later status reads.\n     */\n    async batchReplace(\n        input: BatchReplaceOrdersInput,\n        options?: PolyesterMutationOptions,\n    ): Promise<BatchReplaceOrdersResult> {\n        await this.#scales.ready();\n        for (const item of input.items) {\n            assertKnownBatchReplaceOrderItemInputKeys(item);\n        }\n        const resolved = {\n            ...resolveAccountScopedInput(input, this.#resolver),\n            requestId: input.requestId ?? createMutationRequestId(),\n        };\n        const request = parse(createBatchReplaceOrdersInputSchema(this.#scales), resolved);\n        const response = await this.#writeClient.batchReplaceOrders(\n            removeUndefined(request),\n            toConnectCallOptions(options),\n        );\n        const result = parse(BatchReplaceOrdersResultSchema, response);\n        assertBatchResultCount(\"batchReplace\", input.items.length, result.results.length);\n        return result;\n    }\n\n    /**\n     * Reads the durable per-item execution status for a batch replacement receipt.\n     */\n    async getBatchReplaceStatus(\n        input: GetBatchReplaceStatusInput,\n        options?: PolyesterRequestOptions,\n    ): Promise<GetBatchReplaceStatusResult> {\n        const resolved = resolveAccountScopedInput(input, this.#resolver);\n        const request = parse(GetBatchReplaceStatusInputSchema, resolved);\n        const response = await this.#readClient.getBatchReplaceStatus(\n            removeUndefined(request),\n            toConnectCallOptions(options),\n        );\n        return parse(GetBatchReplaceStatusResultSchema, response);\n    }\n\n    /**\n     * Cancels all matching open orders for the resolved account scope, optionally narrowed by symbol ID and side, with dry-run preview. A requestId is generated when omitted; provide a stable value when retrying the same logical bulk cancellation.\n     */\n    async cancelAll(\n        input: v.InferInput<typeof CancelAllOrdersInputSchema>,\n        options?: PolyesterMutationOptions,\n    ): Promise<CancelAllOrdersResponse> {\n        const resolved = {\n            ...resolveAccountScopedInput(input, this.#resolver),\n            requestId: input.requestId ?? createMutationRequestId(),\n        };\n        const validated = parse(CancelAllOrdersInputSchema, resolved);\n        const res = await this.#writeClient.cancelAllOrders(\n            removeUndefined(validated),\n            toConnectCallOptions(options),\n        );\n        return parse(CancelAllOrdersResponseSchema, res);\n    }\n\n    /**\n     * Arms, refreshes, or disables the account dead-man switch, optionally scoped by symbol ID and side. timeoutSec 0 disables it; 10–120 arms it. Generate a new requestId for each deliberate heartbeat, but reuse the same ID when retrying one ambiguous heartbeat.\n     */\n    async cancelAllAfter(\n        input: CancelAllAfterInput,\n        options?: PolyesterMutationOptions,\n    ): Promise<CancelAllAfterResult> {\n        const resolved = {\n            ...resolveAccountScopedInput(input, this.#resolver),\n            requestId: input.requestId ?? createMutationRequestId(),\n        };\n        const request = parse(CancelAllAfterInputSchema, resolved);\n        const response = await this.#writeClient.cancelAllAfter(\n            removeUndefined(request),\n            toConnectCallOptions(options),\n        );\n        return parse(CancelAllAfterResultSchema, response);\n    }\n\n    /**\n     * Fetches one order by id or client order id and returns its order, trades, and transfer details when found. Returns null when the requested order is not found.\n     */\n    async getDetails(\n        input: v.InferInput<typeof GetOrderDetailsInputSchema>,\n        options?: PolyesterRequestOptions,\n    ): Promise<OrderDetails | null> {\n        await this.#scales.ready();\n        const resolved = resolveAccountScopedInput(input, this.#resolver);\n        const validatedInput = parse(GetOrderDetailsInputSchema, resolved);\n        let res: ProtoRead.GetOrderResponse;\n        try {\n            res = await this.#readClient.getOrder(\n                removeUndefined(validatedInput),\n                toConnectCallOptions(options),\n            );\n        } catch (error) {\n            if (isOrderNotFoundError(error)) return null;\n            throw error;\n        }\n        if (!res.order) return null;\n        return parse(this.#orderDetailsSchema, res);\n    }\n\n    /**\n     * Subscribes to private order updates on private:spot:orders:{accountId}:proto and emits parsed order records until the returned unsubscribe function is called.\n     */\n    subscribe(input: SubscribeOrdersInput): () => void {\n        const channel = `private:spot:orders:${input.accountId}:proto`;\n        return connectReadyGatedProtoChannel(this.#realtime, {\n            channel,\n            schema: ProtoRead.OrderSchema,\n            ready: () => this.#scales.ready(),\n            onPublication: (data) => {\n                const order = parse(this.#orderSchema, data);\n                input.onEvent(order);\n            },\n            onConnected: () => input.onOpen?.(),\n            onDisconnected: () => input.onClose?.(),\n            onError: input.onError,\n        });\n    }\n}\n"],"mappings":"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"}

package/dist/services/subaccounts/subaccounts.schemas.d.ts

@@ -176,7 +176,7 @@ declare const SubaccountInviteSchema: v.SchemaWithPipe<readonly [v.ObjectSchema<
   readonly granteeAccountId: v.SchemaWithPipe<readonly [v.BigintSchema<undefined>, v.TransformAction<bigint, string>]>;
   readonly inviterAccountId: v.SchemaWithPipe<readonly [v.BigintSchema<undefined>, v.TransformAction<bigint, string>]>;
   readonly role: v.SchemaWithPipe<readonly [v.EnumSchema<typeof SubaccountRole$1, undefined>, v.TransformAction<SubaccountRole$1, "unspecified" | "owner" | "admin" | "treasury" | "leveraged_trader" | "trader" | "viewer">]>;
-  readonly status: v.SchemaWithPipe<readonly [v.EnumSchema<typeof SubaccountInviteStatus$1, undefined>, v.TransformAction<SubaccountInviteStatus$1, "unspecified" | "pending" | "cancelled" | "accepted" | "declined">]>;
+  readonly status: v.SchemaWithPipe<readonly [v.EnumSchema<typeof SubaccountInviteStatus$1, undefined>, v.TransformAction<SubaccountInviteStatus$1, "unspecified" | "pending" | "accepted" | "declined" | "cancelled">]>;
   readonly createdAt: v.SchemaWithPipe<readonly [v.OptionalSchema<v.ObjectSchema<{
     readonly seconds: v.BigintSchema<undefined>;
     readonly nanos: v.OptionalSchema<v.NumberSchema<undefined>, 0>;
@@ -203,7 +203,7 @@ declare const SubaccountInviteSchema: v.SchemaWithPipe<readonly [v.ObjectSchema<
   granteeAccountId: string;
   inviterAccountId: string;
   role: "unspecified" | "owner" | "admin" | "treasury" | "leveraged_trader" | "trader" | "viewer";
-  status: "unspecified" | "pending" | "cancelled" | "accepted" | "declined";
+  status: "unspecified" | "pending" | "accepted" | "declined" | "cancelled";
   createdAt?: number | undefined;
   respondedAt?: number | undefined;
   granteeUsername: string;
@@ -221,7 +221,7 @@ declare const SubaccountInviteSchema: v.SchemaWithPipe<readonly [v.ObjectSchema<
   granteeAccountId: string;
   inviterAccountId: string;
   role: "unspecified" | "owner" | "admin" | "treasury" | "leveraged_trader" | "trader" | "viewer";
-  status: "unspecified" | "pending" | "cancelled" | "accepted" | "declined";
+  status: "unspecified" | "pending" | "accepted" | "declined" | "cancelled";
   createdAt?: number | undefined;
   respondedAt?: number | undefined;
   granteeUsername: string;

package/dist/services/trades/trades.js

@@ -2,8 +2,7 @@ import { parse } from "../../shared/validation.js";
 import { toConnectCallOptions } from "../../shared/request-options.js";
 import { removeUndefined } from "../../utils/remove-undefined.js";
 import { resolveAccountScopedInput } from "../subaccount-resolver.js";
-import { publicationHandlerErrorContext } from "../../shared/subscription-errors.js";
-import { createReadyGate } from "../../shared/decimal-surface.js";
+import { connectReadyGatedProtoChannel } from "../../realtime/ready-gated-subscription.js";
 import { OrdersReadService, UserTradeSchema } from "../../gen/orders/v1/orders_read_pb.js";
 import { GetUserTradesInputSchema, createUserTradeSchema } from "./trades.schemas.js";
 import { createClient } from "@connectrpc/connect";
@@ -43,15 +42,13 @@ var TradesService = class {
 	*/
 	subscribe(input) {
 		const channel = `private:spot:trades:${input.accountId}:proto`;
-		const gate = createReadyGate(() => this.#scales.ready(), (error) => input.onError?.(publicationHandlerErrorContext(channel, error)));
-		return this.#realtime.connectProtoChannel({
+		return connectReadyGatedProtoChannel(this.#realtime, {
 			channel,
 			schema: UserTradeSchema,
+			ready: () => this.#scales.ready(),
 			onPublication: (data) => {
-				gate.run(() => {
-					const trade = parse(this.#userTradeSchema, data);
-					input.onEvent(trade);
-				});
+				const trade = parse(this.#userTradeSchema, data);
+				input.onEvent(trade);
 			},
 			onConnected: () => input.onOpen?.(),
 			onDisconnected: () => input.onClose?.(),

package/dist/services/trades/trades.js.map

@@ -1 +1 @@
-{"version":3,"file":"trades.js","names":["#client","Proto.OrdersReadService","#realtime","#resolver","#scales","#userTradeSchema","Proto.UserTradeSchema"],"sources":["../../../src/services/trades/trades.ts"],"sourcesContent":["import * as Proto from \"../../gen/orders/v1/orders_read_pb.js\";\nimport { createClient, type Client, type Transport } from \"@connectrpc/connect\";\nimport { publicationHandlerErrorContext } from \"../../shared/subscription-errors.js\";\nimport * as v from \"valibot\";\nimport { parse } from \"../../shared/validation.js\";\nimport { removeUndefined } from \"../../utils/remove-undefined.js\";\nimport { type SubaccountResolver, resolveAccountScopedInput } from \"../subaccount-resolver.js\";\nimport type { PolyesterRealtime } from \"../../realtime/types.js\";\nimport type { BaseSubscribeInput } from \"../../shared/types.js\";\nimport {\n    toConnectCallOptions,\n    type PolyesterRequestOptions,\n} from \"../../shared/request-options.js\";\nimport { createReadyGate, type SdkScales } from \"../../shared/decimal-surface.js\";\nimport { GetUserTradesInputSchema, createUserTradeSchema, type Trade } from \"./trades.schemas.js\";\n\ninterface SubscribeTradesInput extends BaseSubscribeInput<Trade> {\n    accountId: string;\n}\n\n/**\n * Reads and streams authenticated user trade fills.\n */\nexport class TradesService {\n    #client: Client<typeof Proto.OrdersReadService>;\n    #realtime: PolyesterRealtime;\n    #resolver?: SubaccountResolver;\n    #scales: SdkScales;\n    #userTradeSchema: ReturnType<typeof createUserTradeSchema>;\n\n    constructor(\n        transport: Transport,\n        realtime: PolyesterRealtime,\n        resolver: SubaccountResolver | undefined,\n        scales: SdkScales,\n    ) {\n        this.#client = createClient(Proto.OrdersReadService, transport);\n        this.#realtime = realtime;\n        this.#resolver = resolver;\n        this.#scales = scales;\n        this.#userTradeSchema = createUserTradeSchema(scales);\n    }\n\n    /**\n     * Returns user trades for the resolved root account or subaccount, supporting symbol, side, time range, limit, and page token filters. Results include the next page token from GetUserTrades.\n     */\n    async list(\n        input: v.InferInput<typeof GetUserTradesInputSchema> = {},\n        options?: PolyesterRequestOptions,\n    ): Promise<{ trades: Trade[]; nextPageToken: string }> {\n        await this.#scales.ready();\n        const resolved = resolveAccountScopedInput(input, this.#resolver);\n        const validatedInput = parse(GetUserTradesInputSchema, resolved);\n        const res = await this.#client.getUserTrades(\n            removeUndefined(validatedInput),\n            toConnectCallOptions(options),\n        );\n        return {\n            trades: parse(v.array(this.#userTradeSchema), res.trades),\n            nextPageToken: res.nextPageToken,\n        };\n    }\n\n    /**\n     * Subscribes to private user trade updates on private:spot:trades:{accountId}:proto and emits parsed fills.\n     */\n    subscribe(input: SubscribeTradesInput) {\n        const channel = `private:spot:trades:${input.accountId}:proto`;\n        const gate = createReadyGate(\n            () => this.#scales.ready(),\n            (error) => input.onError?.(publicationHandlerErrorContext(channel, error)),\n        );\n        return this.#realtime.connectProtoChannel({\n            channel,\n            schema: Proto.UserTradeSchema,\n            onPublication: (data) => {\n                gate.run(() => {\n                    const trade = parse(this.#userTradeSchema, data);\n                    input.onEvent(trade);\n                });\n            },\n            onConnected: () => input.onOpen?.(),\n            onDisconnected: () => input.onClose?.(),\n            onError: input.onError,\n        });\n    }\n}\n"],"mappings":";;;;;;;;;;;;;;AAuBA,IAAa,gBAAb,MAA2B;CACvB;CACA;CACA;CACA;CACA;CAEA,YACI,WACA,UACA,UACA,QACF;EACE,KAAKA,UAAU,aAAaC,mBAAyB,SAAS;EAC9D,KAAKC,YAAY;EACjB,KAAKC,YAAY;EACjB,KAAKC,UAAU;EACf,KAAKC,mBAAmB,sBAAsB,MAAM;CACxD;;;;CAKA,MAAM,KACF,QAAuD,CAAC,GACxD,SACmD;EACnD,MAAM,KAAKD,QAAQ,MAAM;EACzB,MAAM,WAAW,0BAA0B,OAAO,KAAKD,SAAS;EAChE,MAAM,iBAAiB,MAAM,0BAA0B,QAAQ;EAC/D,MAAM,MAAM,MAAM,KAAKH,QAAQ,cAC3B,gBAAgB,cAAc,GAC9B,qBAAqB,OAAO,CAChC;EACA,OAAO;GACH,QAAQ,MAAM,EAAE,MAAM,KAAKK,gBAAgB,GAAG,IAAI,MAAM;GACxD,eAAe,IAAI;EACvB;CACJ;;;;CAKA,UAAU,OAA6B;EACnC,MAAM,UAAU,uBAAuB,MAAM,UAAU;EACvD,MAAM,OAAO,sBACH,KAAKD,QAAQ,MAAM,IACxB,UAAU,MAAM,UAAU,+BAA+B,SAAS,KAAK,CAAC,CAC7E;EACA,OAAO,KAAKF,UAAU,oBAAoB;GACtC;GACA,QAAQI;GACR,gBAAgB,SAAS;IACrB,KAAK,UAAU;KACX,MAAM,QAAQ,MAAM,KAAKD,kBAAkB,IAAI;KAC/C,MAAM,QAAQ,KAAK;IACvB,CAAC;GACL;GACA,mBAAmB,MAAM,SAAS;GAClC,sBAAsB,MAAM,UAAU;GACtC,SAAS,MAAM;EACnB,CAAC;CACL;AACJ"}
+{"version":3,"file":"trades.js","names":["#client","Proto.OrdersReadService","#realtime","#resolver","#scales","#userTradeSchema","Proto.UserTradeSchema"],"sources":["../../../src/services/trades/trades.ts"],"sourcesContent":["import * as Proto from \"../../gen/orders/v1/orders_read_pb.js\";\nimport { createClient, type Client, type Transport } from \"@connectrpc/connect\";\nimport * as v from \"valibot\";\nimport { parse } from \"../../shared/validation.js\";\nimport { removeUndefined } from \"../../utils/remove-undefined.js\";\nimport { type SubaccountResolver, resolveAccountScopedInput } from \"../subaccount-resolver.js\";\nimport type { PolyesterRealtime } from \"../../realtime/types.js\";\nimport { connectReadyGatedProtoChannel } from \"../../realtime/ready-gated-subscription.js\";\nimport type { BaseSubscribeInput } from \"../../shared/types.js\";\nimport {\n    toConnectCallOptions,\n    type PolyesterRequestOptions,\n} from \"../../shared/request-options.js\";\nimport type { SdkScales } from \"../../shared/decimal-surface.js\";\nimport { GetUserTradesInputSchema, createUserTradeSchema, type Trade } from \"./trades.schemas.js\";\n\ninterface SubscribeTradesInput extends BaseSubscribeInput<Trade> {\n    accountId: string;\n}\n\n/**\n * Reads and streams authenticated user trade fills.\n */\nexport class TradesService {\n    #client: Client<typeof Proto.OrdersReadService>;\n    #realtime: PolyesterRealtime;\n    #resolver?: SubaccountResolver;\n    #scales: SdkScales;\n    #userTradeSchema: ReturnType<typeof createUserTradeSchema>;\n\n    constructor(\n        transport: Transport,\n        realtime: PolyesterRealtime,\n        resolver: SubaccountResolver | undefined,\n        scales: SdkScales,\n    ) {\n        this.#client = createClient(Proto.OrdersReadService, transport);\n        this.#realtime = realtime;\n        this.#resolver = resolver;\n        this.#scales = scales;\n        this.#userTradeSchema = createUserTradeSchema(scales);\n    }\n\n    /**\n     * Returns user trades for the resolved root account or subaccount, supporting symbol, side, time range, limit, and page token filters. Results include the next page token from GetUserTrades.\n     */\n    async list(\n        input: v.InferInput<typeof GetUserTradesInputSchema> = {},\n        options?: PolyesterRequestOptions,\n    ): Promise<{ trades: Trade[]; nextPageToken: string }> {\n        await this.#scales.ready();\n        const resolved = resolveAccountScopedInput(input, this.#resolver);\n        const validatedInput = parse(GetUserTradesInputSchema, resolved);\n        const res = await this.#client.getUserTrades(\n            removeUndefined(validatedInput),\n            toConnectCallOptions(options),\n        );\n        return {\n            trades: parse(v.array(this.#userTradeSchema), res.trades),\n            nextPageToken: res.nextPageToken,\n        };\n    }\n\n    /**\n     * Subscribes to private user trade updates on private:spot:trades:{accountId}:proto and emits parsed fills.\n     */\n    subscribe(input: SubscribeTradesInput) {\n        const channel = `private:spot:trades:${input.accountId}:proto`;\n        return connectReadyGatedProtoChannel(this.#realtime, {\n            channel,\n            schema: Proto.UserTradeSchema,\n            ready: () => this.#scales.ready(),\n            onPublication: (data) => {\n                const trade = parse(this.#userTradeSchema, data);\n                input.onEvent(trade);\n            },\n            onConnected: () => input.onOpen?.(),\n            onDisconnected: () => input.onClose?.(),\n            onError: input.onError,\n        });\n    }\n}\n"],"mappings":";;;;;;;;;;;;;AAuBA,IAAa,gBAAb,MAA2B;CACvB;CACA;CACA;CACA;CACA;CAEA,YACI,WACA,UACA,UACA,QACF;EACE,KAAKA,UAAU,aAAaC,mBAAyB,SAAS;EAC9D,KAAKC,YAAY;EACjB,KAAKC,YAAY;EACjB,KAAKC,UAAU;EACf,KAAKC,mBAAmB,sBAAsB,MAAM;CACxD;;;;CAKA,MAAM,KACF,QAAuD,CAAC,GACxD,SACmD;EACnD,MAAM,KAAKD,QAAQ,MAAM;EACzB,MAAM,WAAW,0BAA0B,OAAO,KAAKD,SAAS;EAChE,MAAM,iBAAiB,MAAM,0BAA0B,QAAQ;EAC/D,MAAM,MAAM,MAAM,KAAKH,QAAQ,cAC3B,gBAAgB,cAAc,GAC9B,qBAAqB,OAAO,CAChC;EACA,OAAO;GACH,QAAQ,MAAM,EAAE,MAAM,KAAKK,gBAAgB,GAAG,IAAI,MAAM;GACxD,eAAe,IAAI;EACvB;CACJ;;;;CAKA,UAAU,OAA6B;EACnC,MAAM,UAAU,uBAAuB,MAAM,UAAU;EACvD,OAAO,8BAA8B,KAAKH,WAAW;GACjD;GACA,QAAQI;GACR,aAAa,KAAKF,QAAQ,MAAM;GAChC,gBAAgB,SAAS;IACrB,MAAM,QAAQ,MAAM,KAAKC,kBAAkB,IAAI;IAC/C,MAAM,QAAQ,KAAK;GACvB;GACA,mBAAmB,MAAM,SAAS;GAClC,sBAAsB,MAAM,UAAU;GACtC,SAAS,MAAM;EACnB,CAAC;CACL;AACJ"}

package/dist/services/trailing-oneof-inputs.js

@@ -1,5 +1,5 @@
 import { parseOptionalPositiveIntLike } from "../utils/numbers.js";
-import "../shared/wire-bounds.js";
+import { PROTOBUF_INT32_MAX } from "../shared/wire-bounds.js";
 import { CatalogConversionError } from "../catalogs/types.js";
 import { positiveDecimalInputToScaled } from "../shared/decimal-surface.js";
 //#region src/services/trailing-oneof-inputs.ts
@@ -13,7 +13,7 @@ function parseTrailingDistanceInput(scales, distance, fieldName) {
 		value: positiveDecimalInputToScaled(`${fieldName}.distance`, distance.distance, scales.price())
 	};
 	const bps = parseOptionalPositiveIntLike(distance.bps);
-	if (bps === void 0 || bps <= 0) throw new Error(`${fieldName}Bps must be a positive integer`);
+	if (bps === void 0 || bps > Number(2147483647n)) throw new CatalogConversionError(`${fieldName}.bps`, `${fieldName}Bps must be a positive integer no greater than ${PROTOBUF_INT32_MAX}`);
 	return {
 		case: "trailingDistanceBps",
 		value: bps
@@ -33,7 +33,7 @@ function parseSlippageInput(scales, slippage, options) {
 		};
 	}
 	const bps = parseOptionalPositiveIntLike(slippage.bps);
-	if (bps === void 0 || bps <= 0 || exceedsMax(bps, options.maxBps)) throw new Error(`${options.fieldName}Bps must be ${options.maxBps === void 0 ? "a positive integer" : `between 1 and ${options.maxBps}`}`);
+	if (bps === void 0 || bps <= 0 || exceedsMax(bps, options.maxBps)) throw new CatalogConversionError(`${options.fieldName}.bps`, `${options.fieldName}Bps must be ${options.maxBps === void 0 ? "a positive integer" : `between 1 and ${options.maxBps}`}`);
 	return {
 		case: options.bpsCase,
 		value: bps

package/dist/services/trailing-oneof-inputs.js.map

@@ -1 +1 @@
-{"version":3,"file":"trailing-oneof-inputs.js","names":[],"sources":["../../src/services/trailing-oneof-inputs.ts"],"sourcesContent":["import { positiveDecimalInputToScaled, type SdkScales } from \"../shared/decimal-surface.js\";\nimport { CatalogConversionError } from \"../catalogs/types.js\";\nimport { parseOptionalPositiveIntLike } from \"../utils/numbers.js\";\nimport { PROTOBUF_INT32_MAX } from \"../shared/wire-bounds.js\";\n\ntype PositiveIntLikeInput = string | number;\n\n/**\n * Trailing distance and slippage inputs: absolute price distances and\n * slippages are decimal price strings (e.g. \"0.50\"), converted to wire ticks\n * via the price scale; basis points are integers.\n */\nexport type TrailingDistanceInput =\n    | { kind: \"distance\"; distance: string }\n    | { kind: \"bps\"; bps: PositiveIntLikeInput }\n    | { kind: \"none\" };\n\nexport type SlippageInput =\n    | { kind: \"slippage\"; slippage: string }\n    | { kind: \"bps\"; bps: PositiveIntLikeInput }\n    | { kind: \"none\" };\n\ntype UnsetOneof = { case: undefined; value: undefined };\n\ntype TrailingDistanceOneof =\n    | { case: \"trailingDistanceTicks\"; value: bigint }\n    | { case: \"trailingDistanceBps\"; value: number }\n    | UnsetOneof;\n\ntype SlippageOneof<TicksCase extends string, BpsCase extends string> =\n    | { case: TicksCase; value: number }\n    | { case: BpsCase; value: number }\n    | UnsetOneof;\n\ntype SlippageOptions<TicksCase extends string, BpsCase extends string> = {\n    fieldName: string;\n    ticksCase: TicksCase;\n    bpsCase: BpsCase;\n    maxBps?: number;\n};\n\nexport function parseTrailingDistanceInput(\n    scales: SdkScales,\n    distance: TrailingDistanceInput,\n    fieldName: string,\n): TrailingDistanceOneof {\n    if (distance.kind === \"none\") {\n        return { case: undefined, value: undefined };\n    }\n    if (distance.kind === \"distance\") {\n        return {\n            case: \"trailingDistanceTicks\",\n            value: positiveDecimalInputToScaled(\n                `${fieldName}.distance`,\n                distance.distance,\n                scales.price(),\n            ),\n        };\n    }\n\n    const bps = parseOptionalPositiveIntLike(distance.bps);\n    if (bps === undefined || bps <= 0) {\n        throw new Error(`${fieldName}Bps must be a positive integer`);\n    }\n    return { case: \"trailingDistanceBps\", value: bps };\n}\n\nexport function parseSlippageInput<const TicksCase extends string, const BpsCase extends string>(\n    scales: SdkScales,\n    slippage: SlippageInput | undefined,\n    options: SlippageOptions<TicksCase, BpsCase>,\n): SlippageOneof<TicksCase, BpsCase> {\n    if (!slippage || slippage.kind === \"none\") {\n        return { case: undefined, value: undefined };\n    }\n    if (slippage.kind === \"slippage\") {\n        const ticks = positiveDecimalInputToScaled(\n            `${options.fieldName}.slippage`,\n            slippage.slippage,\n            scales.price(),\n        );\n        if (ticks > PROTOBUF_INT32_MAX) {\n            throw new CatalogConversionError(\n                `${options.fieldName}.slippage`,\n                `${options.fieldName}.slippage exceeds the maximum supported price distance: ${slippage.slippage}`,\n            );\n        }\n        return { case: options.ticksCase, value: Number(ticks) };\n    }\n\n    const bps = parseOptionalPositiveIntLike(slippage.bps);\n    if (bps === undefined || bps <= 0 || exceedsMax(bps, options.maxBps)) {\n        throw new Error(\n            `${options.fieldName}Bps must be ${\n                options.maxBps === undefined\n                    ? \"a positive integer\"\n                    : `between 1 and ${options.maxBps}`\n            }`,\n        );\n    }\n    return { case: options.bpsCase, value: bps };\n}\n\nfunction exceedsMax(value: number, max: number | undefined): boolean {\n    return max !== undefined && value > max;\n}\n"],"mappings":";;;;;AAyCA,SAAgB,2BACZ,QACA,UACA,WACqB;CACrB,IAAI,SAAS,SAAS,QAClB,OAAO;EAAE,MAAM,KAAA;EAAW,OAAO,KAAA;CAAU;CAE/C,IAAI,SAAS,SAAS,YAClB,OAAO;EACH,MAAM;EACN,OAAO,6BACH,GAAG,UAAU,YACb,SAAS,UACT,OAAO,MAAM,CACjB;CACJ;CAGJ,MAAM,MAAM,6BAA6B,SAAS,GAAG;CACrD,IAAI,QAAQ,KAAA,KAAa,OAAO,GAC5B,MAAM,IAAI,MAAM,GAAG,UAAU,+BAA+B;CAEhE,OAAO;EAAE,MAAM;EAAuB,OAAO;CAAI;AACrD;AAEA,SAAgB,mBACZ,QACA,UACA,SACiC;CACjC,IAAI,CAAC,YAAY,SAAS,SAAS,QAC/B,OAAO;EAAE,MAAM,KAAA;EAAW,OAAO,KAAA;CAAU;CAE/C,IAAI,SAAS,SAAS,YAAY;EAC9B,MAAM,QAAQ,6BACV,GAAG,QAAQ,UAAU,YACrB,SAAS,UACT,OAAO,MAAM,CACjB;EACA,IAAI,QAAA,aACA,MAAM,IAAI,uBACN,GAAG,QAAQ,UAAU,YACrB,GAAG,QAAQ,UAAU,0DAA0D,SAAS,UAC5F;EAEJ,OAAO;GAAE,MAAM,QAAQ;GAAW,OAAO,OAAO,KAAK;EAAE;CAC3D;CAEA,MAAM,MAAM,6BAA6B,SAAS,GAAG;CACrD,IAAI,QAAQ,KAAA,KAAa,OAAO,KAAK,WAAW,KAAK,QAAQ,MAAM,GAC/D,MAAM,IAAI,MACN,GAAG,QAAQ,UAAU,cACjB,QAAQ,WAAW,KAAA,IACb,uBACA,iBAAiB,QAAQ,UAEvC;CAEJ,OAAO;EAAE,MAAM,QAAQ;EAAS,OAAO;CAAI;AAC/C;AAEA,SAAS,WAAW,OAAe,KAAkC;CACjE,OAAO,QAAQ,KAAA,KAAa,QAAQ;AACxC"}
+{"version":3,"file":"trailing-oneof-inputs.js","names":[],"sources":["../../src/services/trailing-oneof-inputs.ts"],"sourcesContent":["import { positiveDecimalInputToScaled, type SdkScales } from \"../shared/decimal-surface.js\";\nimport { CatalogConversionError } from \"../catalogs/types.js\";\nimport { parseOptionalPositiveIntLike } from \"../utils/numbers.js\";\nimport { PROTOBUF_INT32_MAX } from \"../shared/wire-bounds.js\";\n\ntype PositiveIntLikeInput = string | number;\n\n/**\n * Trailing distance and slippage inputs: absolute price distances and\n * slippages are decimal price strings (e.g. \"0.50\"), converted to wire ticks\n * via the price scale; basis points are integers.\n */\nexport type TrailingDistanceInput =\n    | { kind: \"distance\"; distance: string }\n    | { kind: \"bps\"; bps: PositiveIntLikeInput }\n    | { kind: \"none\" };\n\nexport type SlippageInput =\n    | { kind: \"slippage\"; slippage: string }\n    | { kind: \"bps\"; bps: PositiveIntLikeInput }\n    | { kind: \"none\" };\n\ntype UnsetOneof = { case: undefined; value: undefined };\n\ntype TrailingDistanceOneof =\n    | { case: \"trailingDistanceTicks\"; value: bigint }\n    | { case: \"trailingDistanceBps\"; value: number }\n    | UnsetOneof;\n\ntype SlippageOneof<TicksCase extends string, BpsCase extends string> =\n    | { case: TicksCase; value: number }\n    | { case: BpsCase; value: number }\n    | UnsetOneof;\n\ntype SlippageOptions<TicksCase extends string, BpsCase extends string> = {\n    fieldName: string;\n    ticksCase: TicksCase;\n    bpsCase: BpsCase;\n    maxBps?: number;\n};\n\nexport function parseTrailingDistanceInput(\n    scales: SdkScales,\n    distance: TrailingDistanceInput,\n    fieldName: string,\n): TrailingDistanceOneof {\n    if (distance.kind === \"none\") {\n        return { case: undefined, value: undefined };\n    }\n    if (distance.kind === \"distance\") {\n        return {\n            case: \"trailingDistanceTicks\",\n            value: positiveDecimalInputToScaled(\n                `${fieldName}.distance`,\n                distance.distance,\n                scales.price(),\n            ),\n        };\n    }\n\n    const bps = parseOptionalPositiveIntLike(distance.bps);\n    if (bps === undefined || bps > Number(PROTOBUF_INT32_MAX)) {\n        throw new CatalogConversionError(\n            `${fieldName}.bps`,\n            `${fieldName}Bps must be a positive integer no greater than ${PROTOBUF_INT32_MAX}`,\n        );\n    }\n    return { case: \"trailingDistanceBps\", value: bps };\n}\n\nexport function parseSlippageInput<const TicksCase extends string, const BpsCase extends string>(\n    scales: SdkScales,\n    slippage: SlippageInput | undefined,\n    options: SlippageOptions<TicksCase, BpsCase>,\n): SlippageOneof<TicksCase, BpsCase> {\n    if (!slippage || slippage.kind === \"none\") {\n        return { case: undefined, value: undefined };\n    }\n    if (slippage.kind === \"slippage\") {\n        const ticks = positiveDecimalInputToScaled(\n            `${options.fieldName}.slippage`,\n            slippage.slippage,\n            scales.price(),\n        );\n        if (ticks > PROTOBUF_INT32_MAX) {\n            throw new CatalogConversionError(\n                `${options.fieldName}.slippage`,\n                `${options.fieldName}.slippage exceeds the maximum supported price distance: ${slippage.slippage}`,\n            );\n        }\n        return { case: options.ticksCase, value: Number(ticks) };\n    }\n\n    const bps = parseOptionalPositiveIntLike(slippage.bps);\n    if (bps === undefined || bps <= 0 || exceedsMax(bps, options.maxBps)) {\n        throw new CatalogConversionError(\n            `${options.fieldName}.bps`,\n            `${options.fieldName}Bps must be ${\n                options.maxBps === undefined\n                    ? \"a positive integer\"\n                    : `between 1 and ${options.maxBps}`\n            }`,\n        );\n    }\n    return { case: options.bpsCase, value: bps };\n}\n\nfunction exceedsMax(value: number, max: number | undefined): boolean {\n    return max !== undefined && value > max;\n}\n"],"mappings":";;;;;AAyCA,SAAgB,2BACZ,QACA,UACA,WACqB;CACrB,IAAI,SAAS,SAAS,QAClB,OAAO;EAAE,MAAM,KAAA;EAAW,OAAO,KAAA;CAAU;CAE/C,IAAI,SAAS,SAAS,YAClB,OAAO;EACH,MAAM;EACN,OAAO,6BACH,GAAG,UAAU,YACb,SAAS,UACT,OAAO,MAAM,CACjB;CACJ;CAGJ,MAAM,MAAM,6BAA6B,SAAS,GAAG;CACrD,IAAI,QAAQ,KAAA,KAAa,MAAM,OAAA,WAAyB,GACpD,MAAM,IAAI,uBACN,GAAG,UAAU,OACb,GAAG,UAAU,iDAAiD,oBAClE;CAEJ,OAAO;EAAE,MAAM;EAAuB,OAAO;CAAI;AACrD;AAEA,SAAgB,mBACZ,QACA,UACA,SACiC;CACjC,IAAI,CAAC,YAAY,SAAS,SAAS,QAC/B,OAAO;EAAE,MAAM,KAAA;EAAW,OAAO,KAAA;CAAU;CAE/C,IAAI,SAAS,SAAS,YAAY;EAC9B,MAAM,QAAQ,6BACV,GAAG,QAAQ,UAAU,YACrB,SAAS,UACT,OAAO,MAAM,CACjB;EACA,IAAI,QAAA,aACA,MAAM,IAAI,uBACN,GAAG,QAAQ,UAAU,YACrB,GAAG,QAAQ,UAAU,0DAA0D,SAAS,UAC5F;EAEJ,OAAO;GAAE,MAAM,QAAQ;GAAW,OAAO,OAAO,KAAK;EAAE;CAC3D;CAEA,MAAM,MAAM,6BAA6B,SAAS,GAAG;CACrD,IAAI,QAAQ,KAAA,KAAa,OAAO,KAAK,WAAW,KAAK,QAAQ,MAAM,GAC/D,MAAM,IAAI,uBACN,GAAG,QAAQ,UAAU,OACrB,GAAG,QAAQ,UAAU,cACjB,QAAQ,WAAW,KAAA,IACb,uBACA,iBAAiB,QAAQ,UAEvC;CAEJ,OAAO;EAAE,MAAM,QAAQ;EAAS,OAAO;CAAI;AAC/C;AAEA,SAAS,WAAW,OAAe,KAAkC;CACjE,OAAO,QAAQ,KAAA,KAAa,QAAQ;AACxC"}

package/dist/services/transfers/index.d.ts

@@ -1,4 +1,4 @@
-import { LedgerTransfer, LedgerTransferSide, LedgerTransferSideSchema, ListTransfersInput, ListTransfersInputSchema, createLedgerTransferSchema } from "./transfers.schemas.js";
+import { LedgerTransfer, LedgerTransferSchema, LedgerTransferSide, LedgerTransferSideSchema, ListTransfersInput, ListTransfersInputSchema } from "./transfers.schemas.js";
 import { TransfersService } from "./transfers.js";
 import { TRANSFER_SIDE_KIND_VALUES, TransferSideKind } from "./transfers.codecs.js";
-export { LedgerTransfer, LedgerTransferSide, LedgerTransferSideSchema, ListTransfersInput, ListTransfersInputSchema, TRANSFER_SIDE_KIND_VALUES, TransferSideKind, TransfersService, createLedgerTransferSchema };
+export { LedgerTransfer, LedgerTransferSchema, LedgerTransferSide, LedgerTransferSideSchema, ListTransfersInput, ListTransfersInputSchema, TRANSFER_SIDE_KIND_VALUES, TransferSideKind, TransfersService };

package/dist/services/transfers/transfers.d.ts

@@ -3,7 +3,6 @@ import { SubaccountResolver } from "../subaccount-resolver.js";
 import { PolyesterRealtime } from "../../realtime/types.js";
 import "../../realtime/index.js";
 import { BaseSubscribeInput } from "../../shared/types.js";
-import { SdkScales } from "../../shared/decimal-surface.js";
 import { LedgerTransfer, ListTransfersInput } from "./transfers.schemas.js";
 import { Transport } from "@connectrpc/connect";
 //#region src/services/transfers/transfers.d.ts
@@ -15,7 +14,7 @@ interface SubscribeTransfersInput extends BaseSubscribeInput<LedgerTransfer> {
  */
 declare class TransfersService {
   #private;
-  constructor(transport: Transport, realtime: PolyesterRealtime, resolver: SubaccountResolver | undefined, scales: SdkScales);
+  constructor(transport: Transport, realtime: PolyesterRealtime, resolver: SubaccountResolver | undefined);
   /**
    * Returns ledger transfers for the resolved account scope with limit, direction, timestamp, code, ledger, and page-token filters.
    */

package/dist/services/transfers/transfers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transfers.d.ts","names":[],"sources":["../../../src/services/transfers/transfers.ts"],"mappings":";;;;;;;;;UAoBU,gCAAgC,mBAAmB;EACzD;;;;;cAMS;;EAQL,YAAA,WAAW,WACX,UAAU,mBACV,UAAU,gCACV,QAAQ;;;;EAYN,KACF,QAAO,oBACP,UAAU,0BACX;IAAU,WAAW;IAAkB;;;;;EAY1C,UAAU,OAAO"}
+{"version":3,"file":"transfers.d.ts","names":[],"sources":["../../../src/services/transfers/transfers.ts"],"mappings":";;;;;;;;UAmBU,gCAAgC,mBAAmB;EACzD;;;;;cAMS;;EAML,YAAA,WAAW,WACX,UAAU,mBACV,UAAU;;;;EAUR,KACF,QAAO,oBACP,UAAU,0BACX;IAAU,WAAW;IAAkB;;;;;EAW1C,UAAU,OAAO"}

package/dist/services/transfers/transfers.js

@@ -3,8 +3,7 @@ import { toConnectCallOptions } from "../../shared/request-options.js";
 import { resolveAccountScopedInput } from "../subaccount-resolver.js";
 import { LedgerReadService, TransferRowSchema } from "../../gen/ledger/read/v1/ledger_read_pb.js";
 import { publicationHandlerErrorContext } from "../../shared/subscription-errors.js";
-import { createReadyGate } from "../../shared/decimal-surface.js";
-import { ListTransfersInputSchema, createLedgerTransferSchema } from "./transfers.schemas.js";
+import { LedgerTransferSchema, ListTransfersInputSchema } from "./transfers.schemas.js";
 import { createClient } from "@connectrpc/connect";
 import * as v from "valibot";
 //#region src/services/transfers/transfers.ts
@@ -15,25 +14,20 @@ var TransfersService = class {
 	#client;
 	#realtime;
 	#resolver;
-	#scales;
-	#ledgerTransferSchema;
-	constructor(transport, realtime, resolver, scales) {
+	constructor(transport, realtime, resolver) {
 		this.#client = createClient(LedgerReadService, transport);
 		this.#realtime = realtime;
 		this.#resolver = resolver;
-		this.#scales = scales;
-		this.#ledgerTransferSchema = createLedgerTransferSchema(scales);
 	}
 	/**
 	* Returns ledger transfers for the resolved account scope with limit, direction, timestamp, code, ledger, and page-token filters.
 	*/
 	async list(input = {}, options) {
-		await this.#scales.ready();
 		const resolved = resolveAccountScopedInput(input, this.#resolver);
 		const validatedInput = parse(ListTransfersInputSchema, resolved);
 		const res = await this.#client.listTransfers(validatedInput, toConnectCallOptions(options));
 		return {
-			transfers: parse(v.array(this.#ledgerTransferSchema), res.transfers),
+			transfers: parse(v.array(LedgerTransferSchema), res.transfers),
 			nextPageToken: res.nextPageToken
 		};
 	}
@@ -42,15 +36,16 @@ var TransfersService = class {
 	*/
 	subscribe(input) {
 		const channel = `private:ledger:transfers:${input.accountId}:proto`;
-		const gate = createReadyGate(() => this.#scales.ready(), (error) => input.onError?.(publicationHandlerErrorContext(channel, error)));
 		return this.#realtime.connectProtoChannel({
 			channel,
 			schema: TransferRowSchema,
 			onPublication: (m) => {
-				gate.run(() => {
-					const tr = parse(this.#ledgerTransferSchema, m);
+				try {
+					const tr = parse(LedgerTransferSchema, m);
 					input.onEvent(tr);
-				});
+				} catch (error) {
+					input.onError?.(publicationHandlerErrorContext(channel, error));
+				}
 			},
 			onConnected: input.onOpen,
 			onDisconnected: input.onClose,

package/dist/services/transfers/transfers.js.map

@@ -1 +1 @@
-{"version":3,"file":"transfers.js","names":["#client","Proto.LedgerReadService","#realtime","#resolver","#scales","#ledgerTransferSchema","Proto.TransferRowSchema"],"sources":["../../../src/services/transfers/transfers.ts"],"sourcesContent":["import * as Proto from \"../../gen/ledger/read/v1/ledger_read_pb.js\";\nimport { createClient, type Client, type Transport } from \"@connectrpc/connect\";\nimport { publicationHandlerErrorContext } from \"../../shared/subscription-errors.js\";\nimport * as v from \"valibot\";\nimport { parse } from \"../../shared/validation.js\";\nimport type { PolyesterRealtime } from \"../../realtime/index.js\";\nimport { type SubaccountResolver, resolveAccountScopedInput } from \"../subaccount-resolver.js\";\nimport type { BaseSubscribeInput } from \"../../shared/types.js\";\nimport {\n    toConnectCallOptions,\n    type PolyesterRequestOptions,\n} from \"../../shared/request-options.js\";\nimport { createReadyGate, type SdkScales } from \"../../shared/decimal-surface.js\";\nimport {\n    createLedgerTransferSchema,\n    ListTransfersInputSchema,\n    type LedgerTransfer,\n    type ListTransfersInput,\n} from \"./transfers.schemas.js\";\n\ninterface SubscribeTransfersInput extends BaseSubscribeInput<LedgerTransfer> {\n    accountId: string;\n}\n\n/**\n * Reads and streams ledger transfer activity for the authenticated account scope.\n */\nexport class TransfersService {\n    #client: Client<typeof Proto.LedgerReadService>;\n    #realtime: PolyesterRealtime;\n    #resolver?: SubaccountResolver;\n    #scales: SdkScales;\n    #ledgerTransferSchema: ReturnType<typeof createLedgerTransferSchema>;\n\n    constructor(\n        transport: Transport,\n        realtime: PolyesterRealtime,\n        resolver: SubaccountResolver | undefined,\n        scales: SdkScales,\n    ) {\n        this.#client = createClient(Proto.LedgerReadService, transport);\n        this.#realtime = realtime;\n        this.#resolver = resolver;\n        this.#scales = scales;\n        this.#ledgerTransferSchema = createLedgerTransferSchema(scales);\n    }\n\n    /**\n     * Returns ledger transfers for the resolved account scope with limit, direction, timestamp, code, ledger, and page-token filters.\n     */\n    async list(\n        input: ListTransfersInput = {},\n        options?: PolyesterRequestOptions,\n    ): Promise<{ transfers: LedgerTransfer[]; nextPageToken: string }> {\n        await this.#scales.ready();\n        const resolved = resolveAccountScopedInput(input, this.#resolver);\n        const validatedInput = parse(ListTransfersInputSchema, resolved);\n        const res = await this.#client.listTransfers(validatedInput, toConnectCallOptions(options));\n        const transfers = parse(v.array(this.#ledgerTransferSchema), res.transfers);\n        return { transfers, nextPageToken: res.nextPageToken };\n    }\n\n    /**\n     * Subscribes to private ledger transfer updates on private:ledger:transfers:{accountId}:proto and emits parsed transfer rows.\n     */\n    subscribe(input: SubscribeTransfersInput): () => void {\n        const channel = `private:ledger:transfers:${input.accountId}:proto`;\n        const gate = createReadyGate(\n            () => this.#scales.ready(),\n            (error) => input.onError?.(publicationHandlerErrorContext(channel, error)),\n        );\n        return this.#realtime.connectProtoChannel({\n            channel,\n            schema: Proto.TransferRowSchema,\n            onPublication: (m) => {\n                gate.run(() => {\n                    const tr = parse(this.#ledgerTransferSchema, m);\n                    input.onEvent(tr);\n                });\n            },\n            onConnected: input.onOpen,\n            onDisconnected: input.onClose,\n            onError: input.onError,\n        });\n    }\n}\n"],"mappings":";;;;;;;;;;;;;AA2BA,IAAa,mBAAb,MAA8B;CAC1B;CACA;CACA;CACA;CACA;CAEA,YACI,WACA,UACA,UACA,QACF;EACE,KAAKA,UAAU,aAAaC,mBAAyB,SAAS;EAC9D,KAAKC,YAAY;EACjB,KAAKC,YAAY;EACjB,KAAKC,UAAU;EACf,KAAKC,wBAAwB,2BAA2B,MAAM;CAClE;;;;CAKA,MAAM,KACF,QAA4B,CAAC,GAC7B,SAC+D;EAC/D,MAAM,KAAKD,QAAQ,MAAM;EACzB,MAAM,WAAW,0BAA0B,OAAO,KAAKD,SAAS;EAChE,MAAM,iBAAiB,MAAM,0BAA0B,QAAQ;EAC/D,MAAM,MAAM,MAAM,KAAKH,QAAQ,cAAc,gBAAgB,qBAAqB,OAAO,CAAC;EAE1F,OAAO;GAAE,WADS,MAAM,EAAE,MAAM,KAAKK,qBAAqB,GAAG,IAAI,SAChD;GAAG,eAAe,IAAI;EAAc;CACzD;;;;CAKA,UAAU,OAA4C;EAClD,MAAM,UAAU,4BAA4B,MAAM,UAAU;EAC5D,MAAM,OAAO,sBACH,KAAKD,QAAQ,MAAM,IACxB,UAAU,MAAM,UAAU,+BAA+B,SAAS,KAAK,CAAC,CAC7E;EACA,OAAO,KAAKF,UAAU,oBAAoB;GACtC;GACA,QAAQI;GACR,gBAAgB,MAAM;IAClB,KAAK,UAAU;KACX,MAAM,KAAK,MAAM,KAAKD,uBAAuB,CAAC;KAC9C,MAAM,QAAQ,EAAE;IACpB,CAAC;GACL;GACA,aAAa,MAAM;GACnB,gBAAgB,MAAM;GACtB,SAAS,MAAM;EACnB,CAAC;CACL;AACJ"}
+{"version":3,"file":"transfers.js","names":["#client","Proto.LedgerReadService","#realtime","#resolver","Proto.TransferRowSchema"],"sources":["../../../src/services/transfers/transfers.ts"],"sourcesContent":["import * as Proto from \"../../gen/ledger/read/v1/ledger_read_pb.js\";\nimport { createClient, type Client, type Transport } from \"@connectrpc/connect\";\nimport { publicationHandlerErrorContext } from \"../../shared/subscription-errors.js\";\nimport * as v from \"valibot\";\nimport { parse } from \"../../shared/validation.js\";\nimport type { PolyesterRealtime } from \"../../realtime/index.js\";\nimport { type SubaccountResolver, resolveAccountScopedInput } from \"../subaccount-resolver.js\";\nimport type { BaseSubscribeInput } from \"../../shared/types.js\";\nimport {\n    toConnectCallOptions,\n    type PolyesterRequestOptions,\n} from \"../../shared/request-options.js\";\nimport {\n    LedgerTransferSchema,\n    ListTransfersInputSchema,\n    type LedgerTransfer,\n    type ListTransfersInput,\n} from \"./transfers.schemas.js\";\n\ninterface SubscribeTransfersInput extends BaseSubscribeInput<LedgerTransfer> {\n    accountId: string;\n}\n\n/**\n * Reads and streams ledger transfer activity for the authenticated account scope.\n */\nexport class TransfersService {\n    #client: Client<typeof Proto.LedgerReadService>;\n    #realtime: PolyesterRealtime;\n    #resolver?: SubaccountResolver;\n\n    constructor(\n        transport: Transport,\n        realtime: PolyesterRealtime,\n        resolver: SubaccountResolver | undefined,\n    ) {\n        this.#client = createClient(Proto.LedgerReadService, transport);\n        this.#realtime = realtime;\n        this.#resolver = resolver;\n    }\n\n    /**\n     * Returns ledger transfers for the resolved account scope with limit, direction, timestamp, code, ledger, and page-token filters.\n     */\n    async list(\n        input: ListTransfersInput = {},\n        options?: PolyesterRequestOptions,\n    ): Promise<{ transfers: LedgerTransfer[]; nextPageToken: string }> {\n        const resolved = resolveAccountScopedInput(input, this.#resolver);\n        const validatedInput = parse(ListTransfersInputSchema, resolved);\n        const res = await this.#client.listTransfers(validatedInput, toConnectCallOptions(options));\n        const transfers = parse(v.array(LedgerTransferSchema), res.transfers);\n        return { transfers, nextPageToken: res.nextPageToken };\n    }\n\n    /**\n     * Subscribes to private ledger transfer updates on private:ledger:transfers:{accountId}:proto and emits parsed transfer rows.\n     */\n    subscribe(input: SubscribeTransfersInput): () => void {\n        const channel = `private:ledger:transfers:${input.accountId}:proto`;\n        return this.#realtime.connectProtoChannel({\n            channel,\n            schema: Proto.TransferRowSchema,\n            onPublication: (m) => {\n                try {\n                    const tr = parse(LedgerTransferSchema, m);\n                    input.onEvent(tr);\n                } catch (error) {\n                    input.onError?.(publicationHandlerErrorContext(channel, error));\n                }\n            },\n            onConnected: input.onOpen,\n            onDisconnected: input.onClose,\n            onError: input.onError,\n        });\n    }\n}\n"],"mappings":";;;;;;;;;;;;AA0BA,IAAa,mBAAb,MAA8B;CAC1B;CACA;CACA;CAEA,YACI,WACA,UACA,UACF;EACE,KAAKA,UAAU,aAAaC,mBAAyB,SAAS;EAC9D,KAAKC,YAAY;EACjB,KAAKC,YAAY;CACrB;;;;CAKA,MAAM,KACF,QAA4B,CAAC,GAC7B,SAC+D;EAC/D,MAAM,WAAW,0BAA0B,OAAO,KAAKA,SAAS;EAChE,MAAM,iBAAiB,MAAM,0BAA0B,QAAQ;EAC/D,MAAM,MAAM,MAAM,KAAKH,QAAQ,cAAc,gBAAgB,qBAAqB,OAAO,CAAC;EAE1F,OAAO;GAAE,WADS,MAAM,EAAE,MAAM,oBAAoB,GAAG,IAAI,SAC1C;GAAG,eAAe,IAAI;EAAc;CACzD;;;;CAKA,UAAU,OAA4C;EAClD,MAAM,UAAU,4BAA4B,MAAM,UAAU;EAC5D,OAAO,KAAKE,UAAU,oBAAoB;GACtC;GACA,QAAQE;GACR,gBAAgB,MAAM;IAClB,IAAI;KACA,MAAM,KAAK,MAAM,sBAAsB,CAAC;KACxC,MAAM,QAAQ,EAAE;IACpB,SAAS,OAAO;KACZ,MAAM,UAAU,+BAA+B,SAAS,KAAK,CAAC;IAClE;GACJ;GACA,aAAa,MAAM;GACnB,gBAAgB,MAAM;GACtB,SAAS,MAAM;EACnB,CAAC;CACL;AACJ"}

package/dist/services/transfers/transfers.schemas.d.ts

@@ -1,6 +1,5 @@
 import { TransferCode } from "../../gen/ledger/v1/catalog_pb.js";
 import { TransferSideKind } from "../../gen/ledger/read/v1/ledger_read_pb.js";
-import { SdkScales } from "../../shared/decimal-surface.js";
 import * as v from "valibot";
 //#region src/services/transfers/transfers.schemas.d.ts
 declare const LedgerTransferSideSchema: v.ObjectSchema<{
@@ -9,7 +8,8 @@ declare const LedgerTransferSideSchema: v.ObjectSchema<{
   readonly address: v.OptionalSchema<v.StringSchema<undefined>, "">;
 }, undefined>;
 type LedgerTransferSide = v.InferOutput<typeof LedgerTransferSideSchema>;
-declare function createLedgerTransferSchema(scales: SdkScales): v.SchemaWithPipe<readonly [v.ObjectSchema<{
+/** Parses ledger transfer rows whose monetary fields use the protocol's fixed E18 scale. */
+declare const LedgerTransferSchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
   readonly assetId: v.NumberSchema<undefined>;
   readonly amountE18: v.OptionalSchema<v.ObjectSchema<{
     readonly hi: v.BigintSchema<undefined>;
@@ -79,10 +79,10 @@ declare function createLedgerTransferSchema(scales: SdkScales): v.SchemaWithPipe
   accountCode: "unspecified" | "funding" | "trading";
   timestamp: number;
   isDebit: boolean;
-  linkId: number | undefined;
+  linkId: string | undefined;
   flowId: string;
 }>]>;
-type LedgerTransfer = v.InferOutput<ReturnType<typeof createLedgerTransferSchema>>;
+type LedgerTransfer = v.InferOutput<typeof LedgerTransferSchema>;
 declare const ListTransfersInputSchema: v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
   readonly ledger: v.OptionalSchema<v.NumberSchema<undefined>, 0>;
   readonly limit: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
@@ -117,5 +117,5 @@ declare const ListTransfersInputSchema: v.SchemaWithPipe<readonly [v.StrictObjec
 }>]>;
 type ListTransfersInput = v.InferInput<typeof ListTransfersInputSchema>;
 //#endregion
-export { LedgerTransfer, LedgerTransferSide, LedgerTransferSideSchema, ListTransfersInput, ListTransfersInputSchema, createLedgerTransferSchema };
+export { LedgerTransfer, LedgerTransferSchema, LedgerTransferSide, LedgerTransferSideSchema, ListTransfersInput, ListTransfersInputSchema };
 //# sourceMappingURL=transfers.schemas.d.ts.map

package/dist/services/transfers/transfers.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transfers.schemas.d.ts","names":[],"sources":["../../../src/services/transfers/transfers.schemas.ts"],"mappings":";;;;;cA2Ca,0BAAwB,EAAA;;;;;KAMzB,qBAAqB,EAAE,mBAAmB;iBAEtC,2BAA2B,QAAQ,YAAS,EAAA,yBAAA,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAuDhD,iBAAiB,EAAE,YAAY,kBAAkB;cAEhD,0BAAwB,EAAA,yBAAA,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAwBzB,qBAAqB,EAAE,kBAAkB"}
+{"version":3,"file":"transfers.schemas.d.ts","names":[],"sources":["../../../src/services/transfers/transfers.schemas.ts"],"mappings":";;;;cA2Ca,0BAAwB,EAAA;;;;;KAMzB,qBAAqB,EAAE,mBAAmB;;cAGzC,sBAAoB,EAAA,yBAAA,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAmDrB,iBAAiB,EAAE,mBAAmB;cAErC,0BAAwB,EAAA,yBAAA,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAwBzB,qBAAqB,EAAE,kBAAkB"}

package/dist/services/transfers/transfers.schemas.js

@@ -24,38 +24,36 @@ const LedgerTransferSideSchema = v.object({
 	accountId: OptionalPublicIdSchema,
 	address: v.optional(v.string(), "")
 });
-function createLedgerTransferSchema(scales) {
-	return v.pipe(v.object({
-		assetId: v.number(),
-		amountE18: v.optional(U128Schema),
-		balanceAfterE18: v.optional(U128Schema),
-		isDebit: v.boolean(),
-		transferCode: v.number(),
-		accountCode: v.number(),
-		tsUs: WireTimestampInputSchema,
-		linkId: v.optional(v.bigint()),
-		flowId: v.optional(v.string()),
-		source: v.optional(LedgerTransferSideSchema),
-		destination: v.optional(LedgerTransferSideSchema)
-	}), v.transform((tr) => {
-		scales.ledgerAmount(tr.assetId);
-		const amount = fromU128(tr.amountE18);
-		const linkIdNum = Number(tr.linkId ?? 0n);
-		return {
-			assetId: tr.assetId,
-			amount: scaledToDecimalOutput(amount, 18),
-			balanceAfter: tr.balanceAfterE18 !== void 0 ? scaledToDecimalOutput(fromU128(tr.balanceAfterE18), 18) : void 0,
-			type: requiredEnumLabel(TransferCodeCodec.protoToOutput, tr.transferCode, "LedgerTransferSchema", "transfer code"),
-			accountCode: requiredEnumLabel(AccountCodeCodec.protoToOutput, tr.accountCode, "LedgerTransferSchema", "account code"),
-			timestamp: wireTimestampToMs(tr.tsUs),
-			isDebit: tr.isDebit,
-			linkId: linkIdNum || void 0,
-			flowId: tr.flowId?.trim() ?? "",
-			...tr.source ? { source: tr.source } : {},
-			...tr.destination ? { destination: tr.destination } : {}
-		};
-	}));
-}
+/** Parses ledger transfer rows whose monetary fields use the protocol's fixed E18 scale. */
+const LedgerTransferSchema = v.pipe(v.object({
+	assetId: v.number(),
+	amountE18: v.optional(U128Schema),
+	balanceAfterE18: v.optional(U128Schema),
+	isDebit: v.boolean(),
+	transferCode: v.number(),
+	accountCode: v.number(),
+	tsUs: WireTimestampInputSchema,
+	linkId: v.optional(v.bigint()),
+	flowId: v.optional(v.string()),
+	source: v.optional(LedgerTransferSideSchema),
+	destination: v.optional(LedgerTransferSideSchema)
+}), v.transform((tr) => {
+	const amount = fromU128(tr.amountE18);
+	const linkId = tr.linkId && tr.linkId > 0n ? tr.linkId.toString() : void 0;
+	return {
+		assetId: tr.assetId,
+		amount: scaledToDecimalOutput(amount, 18),
+		balanceAfter: tr.balanceAfterE18 !== void 0 ? scaledToDecimalOutput(fromU128(tr.balanceAfterE18), 18) : void 0,
+		type: requiredEnumLabel(TransferCodeCodec.protoToOutput, tr.transferCode, "LedgerTransferSchema", "transfer code"),
+		accountCode: requiredEnumLabel(AccountCodeCodec.protoToOutput, tr.accountCode, "LedgerTransferSchema", "account code"),
+		timestamp: wireTimestampToMs(tr.tsUs),
+		isDebit: tr.isDebit,
+		linkId,
+		flowId: tr.flowId?.trim() ?? "",
+		...tr.source ? { source: tr.source } : {},
+		...tr.destination ? { destination: tr.destination } : {}
+	};
+}));
 const ListTransfersInputSchema = v.pipe(v.strictObject({
 	...AccountScopeInputEntries,
 	ledger: v.optional(v.number(), 0),
@@ -72,6 +70,6 @@ const ListTransfersInputSchema = v.pipe(v.strictObject({
 	subaccountId: accountScopeToSubaccountId(account)
 })));
 //#endregion
-export { LedgerTransferSideSchema, ListTransfersInputSchema, createLedgerTransferSchema };
+export { LedgerTransferSchema, LedgerTransferSideSchema, ListTransfersInputSchema };
 
 //# sourceMappingURL=transfers.schemas.js.map

package/dist/services/transfers/transfers.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"transfers.schemas.js","names":["Proto.TransferSideKind"],"sources":["../../../src/services/transfers/transfers.schemas.ts"],"sourcesContent":["import * as v from \"valibot\";\nimport * as Proto from \"../../gen/ledger/read/v1/ledger_read_pb.js\";\nimport { fromU128 } from \"../../utils/u128.js\";\nimport {\n    AccountCodeCodec,\n    TRANSFER_CODE_VALUES,\n    TransferCodeCodec,\n} from \"../../shared/ledger-codes.js\";\nimport { requiredEnumLabel } from \"../../shared/proto-enum-codec.js\";\nimport { wireTimestampToMs } from \"../../utils/time.js\";\nimport {\n    OptionalPublicIdSchema,\n    OptionalTimestampMsToUsInputSchema,\n} from \"../../shared/schemas.js\";\nimport {\n    AccountScopeInputEntries,\n    accountScopeToSubaccountId,\n} from \"../../shared/account-scope.js\";\nimport { E18_SCALE, scaledToDecimalOutput, type SdkScales } from \"../../shared/decimal-surface.js\";\nimport { TransferSideKindCodec } from \"./transfers.codecs.js\";\n\nconst U128Schema = v.object({\n    hi: v.bigint(),\n    lo: v.bigint(),\n});\n\nconst WireTimestampInputSchema = v.union([\n    v.bigint(),\n    v.number(),\n    v.pipe(\n        v.string(),\n        v.regex(/^\\d+$/),\n        v.transform((value) => BigInt(value)),\n    ),\n]);\n\nconst TransferSideKindSchema = v.pipe(\n    v.enum(Proto.TransferSideKind),\n    v.transform((kind) =>\n        requiredEnumLabel(TransferSideKindCodec.protoToOutput, kind, \"TransferSideSchema\", \"kind\"),\n    ),\n);\n\nexport const LedgerTransferSideSchema = v.object({\n    kind: TransferSideKindSchema,\n    accountId: OptionalPublicIdSchema,\n    address: v.optional(v.string(), \"\"),\n});\n\nexport type LedgerTransferSide = v.InferOutput<typeof LedgerTransferSideSchema>;\n\nexport function createLedgerTransferSchema(scales: SdkScales) {\n    return v.pipe(\n        v.object({\n            assetId: v.number(),\n            amountE18: v.optional(U128Schema),\n            balanceAfterE18: v.optional(U128Schema),\n            isDebit: v.boolean(),\n            transferCode: v.number(),\n            accountCode: v.number(),\n            tsUs: WireTimestampInputSchema,\n            linkId: v.optional(v.bigint()),\n            flowId: v.optional(v.string()),\n            source: v.optional(LedgerTransferSideSchema),\n            destination: v.optional(LedgerTransferSideSchema),\n        }),\n        v.transform((tr) => {\n            // Keep the catalog lookup for readiness/fallback parity; u128 amount fields are always E18 on the wire.\n            scales.ledgerAmount(tr.assetId);\n            const amount = fromU128(tr.amountE18);\n            const linkIdNum = Number(tr.linkId ?? 0n);\n\n            const output = {\n                assetId: tr.assetId,\n                amount: scaledToDecimalOutput(amount, E18_SCALE),\n                balanceAfter:\n                    tr.balanceAfterE18 !== undefined\n                        ? scaledToDecimalOutput(fromU128(tr.balanceAfterE18), E18_SCALE)\n                        : undefined,\n                type: requiredEnumLabel(\n                    TransferCodeCodec.protoToOutput,\n                    tr.transferCode,\n                    \"LedgerTransferSchema\",\n                    \"transfer code\",\n                ),\n                accountCode: requiredEnumLabel(\n                    AccountCodeCodec.protoToOutput,\n                    tr.accountCode,\n                    \"LedgerTransferSchema\",\n                    \"account code\",\n                ),\n                timestamp: wireTimestampToMs(tr.tsUs),\n                isDebit: tr.isDebit,\n                linkId: linkIdNum || undefined,\n                flowId: tr.flowId?.trim() ?? \"\",\n            };\n\n            return {\n                ...output,\n                ...(tr.source ? { source: tr.source } : {}),\n                ...(tr.destination ? { destination: tr.destination } : {}),\n            };\n        }),\n    );\n}\n\nexport type LedgerTransfer = v.InferOutput<ReturnType<typeof createLedgerTransferSchema>>;\n\nexport const ListTransfersInputSchema = v.pipe(\n    v.strictObject({\n        ...AccountScopeInputEntries,\n        ledger: v.optional(v.number(), 0),\n        limit: v.optional(v.number()),\n        reversed: v.optional(v.boolean(), false),\n        timestampMin: OptionalTimestampMsToUsInputSchema,\n        timestampMax: OptionalTimestampMsToUsInputSchema,\n        transferCode: v.optional(\n            v.pipe(\n                v.picklist(TRANSFER_CODE_VALUES),\n                v.transform((value) => TransferCodeCodec.inputToProto[value]),\n            ),\n        ),\n        pageToken: v.optional(v.pipe(v.string(), v.trim()), \"\"),\n    }),\n    v.transform(({ account, timestampMin, timestampMax, ...input }) => ({\n        ...input,\n        tsMinUs: timestampMin,\n        tsMaxUs: timestampMax,\n        subaccountId: accountScopeToSubaccountId(account),\n    })),\n);\n\nexport type ListTransfersInput = v.InferInput<typeof ListTransfersInputSchema>;\n"],"mappings":";;;;;;;;;;;AAqBA,MAAM,aAAa,EAAE,OAAO;CACxB,IAAI,EAAE,OAAO;CACb,IAAI,EAAE,OAAO;AACjB,CAAC;AAED,MAAM,2BAA2B,EAAE,MAAM;CACrC,EAAE,OAAO;CACT,EAAE,OAAO;CACT,EAAE,KACE,EAAE,OAAO,GACT,EAAE,MAAM,OAAO,GACf,EAAE,WAAW,UAAU,OAAO,KAAK,CAAC,CACxC;AACJ,CAAC;AAED,MAAM,yBAAyB,EAAE,KAC7B,EAAE,KAAKA,gBAAsB,GAC7B,EAAE,WAAW,SACT,kBAAkB,sBAAsB,eAAe,MAAM,sBAAsB,MAAM,CAC7F,CACJ;AAEA,MAAa,2BAA2B,EAAE,OAAO;CAC7C,MAAM;CACN,WAAW;CACX,SAAS,EAAE,SAAS,EAAE,OAAO,GAAG,EAAE;AACtC,CAAC;AAID,SAAgB,2BAA2B,QAAmB;CAC1D,OAAO,EAAE,KACL,EAAE,OAAO;EACL,SAAS,EAAE,OAAO;EAClB,WAAW,EAAE,SAAS,UAAU;EAChC,iBAAiB,EAAE,SAAS,UAAU;EACtC,SAAS,EAAE,QAAQ;EACnB,cAAc,EAAE,OAAO;EACvB,aAAa,EAAE,OAAO;EACtB,MAAM;EACN,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC;EAC7B,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC;EAC7B,QAAQ,EAAE,SAAS,wBAAwB;EAC3C,aAAa,EAAE,SAAS,wBAAwB;CACpD,CAAC,GACD,EAAE,WAAW,OAAO;EAEhB,OAAO,aAAa,GAAG,OAAO;EAC9B,MAAM,SAAS,SAAS,GAAG,SAAS;EACpC,MAAM,YAAY,OAAO,GAAG,UAAU,EAAE;EA2BxC,OAAO;GAxBH,SAAS,GAAG;GACZ,QAAQ,sBAAsB,QAAA,EAAiB;GAC/C,cACI,GAAG,oBAAoB,KAAA,IACjB,sBAAsB,SAAS,GAAG,eAAe,GAAA,EAAY,IAC7D,KAAA;GACV,MAAM,kBACF,kBAAkB,eAClB,GAAG,cACH,wBACA,eACJ;GACA,aAAa,kBACT,iBAAiB,eACjB,GAAG,aACH,wBACA,cACJ;GACA,WAAW,kBAAkB,GAAG,IAAI;GACpC,SAAS,GAAG;GACZ,QAAQ,aAAa,KAAA;GACrB,QAAQ,GAAG,QAAQ,KAAK,KAAK;GAK7B,GAAI,GAAG,SAAS,EAAE,QAAQ,GAAG,OAAO,IAAI,CAAC;GACzC,GAAI,GAAG,cAAc,EAAE,aAAa,GAAG,YAAY,IAAI,CAAC;EAC5D;CACJ,CAAC,CACL;AACJ;AAIA,MAAa,2BAA2B,EAAE,KACtC,EAAE,aAAa;CACX,GAAG;CACH,QAAQ,EAAE,SAAS,EAAE,OAAO,GAAG,CAAC;CAChC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC;CAC5B,UAAU,EAAE,SAAS,EAAE,QAAQ,GAAG,KAAK;CACvC,cAAc;CACd,cAAc;CACd,cAAc,EAAE,SACZ,EAAE,KACE,EAAE,SAAS,oBAAoB,GAC/B,EAAE,WAAW,UAAU,kBAAkB,aAAa,MAAM,CAChE,CACJ;CACA,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE;AAC1D,CAAC,GACD,EAAE,WAAW,EAAE,SAAS,cAAc,cAAc,GAAG,aAAa;CAChE,GAAG;CACH,SAAS;CACT,SAAS;CACT,cAAc,2BAA2B,OAAO;AACpD,EAAE,CACN"}
+{"version":3,"file":"transfers.schemas.js","names":["Proto.TransferSideKind"],"sources":["../../../src/services/transfers/transfers.schemas.ts"],"sourcesContent":["import * as v from \"valibot\";\nimport * as Proto from \"../../gen/ledger/read/v1/ledger_read_pb.js\";\nimport { fromU128 } from \"../../utils/u128.js\";\nimport {\n    AccountCodeCodec,\n    TRANSFER_CODE_VALUES,\n    TransferCodeCodec,\n} from \"../../shared/ledger-codes.js\";\nimport { requiredEnumLabel } from \"../../shared/proto-enum-codec.js\";\nimport { wireTimestampToMs } from \"../../utils/time.js\";\nimport {\n    OptionalPublicIdSchema,\n    OptionalTimestampMsToUsInputSchema,\n} from \"../../shared/schemas.js\";\nimport {\n    AccountScopeInputEntries,\n    accountScopeToSubaccountId,\n} from \"../../shared/account-scope.js\";\nimport { E18_SCALE, scaledToDecimalOutput } from \"../../shared/decimal-surface.js\";\nimport { TransferSideKindCodec } from \"./transfers.codecs.js\";\n\nconst U128Schema = v.object({\n    hi: v.bigint(),\n    lo: v.bigint(),\n});\n\nconst WireTimestampInputSchema = v.union([\n    v.bigint(),\n    v.number(),\n    v.pipe(\n        v.string(),\n        v.regex(/^\\d+$/),\n        v.transform((value) => BigInt(value)),\n    ),\n]);\n\nconst TransferSideKindSchema = v.pipe(\n    v.enum(Proto.TransferSideKind),\n    v.transform((kind) =>\n        requiredEnumLabel(TransferSideKindCodec.protoToOutput, kind, \"TransferSideSchema\", \"kind\"),\n    ),\n);\n\nexport const LedgerTransferSideSchema = v.object({\n    kind: TransferSideKindSchema,\n    accountId: OptionalPublicIdSchema,\n    address: v.optional(v.string(), \"\"),\n});\n\nexport type LedgerTransferSide = v.InferOutput<typeof LedgerTransferSideSchema>;\n\n/** Parses ledger transfer rows whose monetary fields use the protocol's fixed E18 scale. */\nexport const LedgerTransferSchema = v.pipe(\n    v.object({\n        assetId: v.number(),\n        amountE18: v.optional(U128Schema),\n        balanceAfterE18: v.optional(U128Schema),\n        isDebit: v.boolean(),\n        transferCode: v.number(),\n        accountCode: v.number(),\n        tsUs: WireTimestampInputSchema,\n        linkId: v.optional(v.bigint()),\n        flowId: v.optional(v.string()),\n        source: v.optional(LedgerTransferSideSchema),\n        destination: v.optional(LedgerTransferSideSchema),\n    }),\n    v.transform((tr) => {\n        const amount = fromU128(tr.amountE18);\n        const linkId = tr.linkId && tr.linkId > 0n ? tr.linkId.toString() : undefined;\n\n        const output = {\n            assetId: tr.assetId,\n            amount: scaledToDecimalOutput(amount, E18_SCALE),\n            balanceAfter:\n                tr.balanceAfterE18 !== undefined\n                    ? scaledToDecimalOutput(fromU128(tr.balanceAfterE18), E18_SCALE)\n                    : undefined,\n            type: requiredEnumLabel(\n                TransferCodeCodec.protoToOutput,\n                tr.transferCode,\n                \"LedgerTransferSchema\",\n                \"transfer code\",\n            ),\n            accountCode: requiredEnumLabel(\n                AccountCodeCodec.protoToOutput,\n                tr.accountCode,\n                \"LedgerTransferSchema\",\n                \"account code\",\n            ),\n            timestamp: wireTimestampToMs(tr.tsUs),\n            isDebit: tr.isDebit,\n            linkId,\n            flowId: tr.flowId?.trim() ?? \"\",\n        };\n\n        return {\n            ...output,\n            ...(tr.source ? { source: tr.source } : {}),\n            ...(tr.destination ? { destination: tr.destination } : {}),\n        };\n    }),\n);\n\nexport type LedgerTransfer = v.InferOutput<typeof LedgerTransferSchema>;\n\nexport const ListTransfersInputSchema = v.pipe(\n    v.strictObject({\n        ...AccountScopeInputEntries,\n        ledger: v.optional(v.number(), 0),\n        limit: v.optional(v.number()),\n        reversed: v.optional(v.boolean(), false),\n        timestampMin: OptionalTimestampMsToUsInputSchema,\n        timestampMax: OptionalTimestampMsToUsInputSchema,\n        transferCode: v.optional(\n            v.pipe(\n                v.picklist(TRANSFER_CODE_VALUES),\n                v.transform((value) => TransferCodeCodec.inputToProto[value]),\n            ),\n        ),\n        pageToken: v.optional(v.pipe(v.string(), v.trim()), \"\"),\n    }),\n    v.transform(({ account, timestampMin, timestampMax, ...input }) => ({\n        ...input,\n        tsMinUs: timestampMin,\n        tsMaxUs: timestampMax,\n        subaccountId: accountScopeToSubaccountId(account),\n    })),\n);\n\nexport type ListTransfersInput = v.InferInput<typeof ListTransfersInputSchema>;\n"],"mappings":";;;;;;;;;;;AAqBA,MAAM,aAAa,EAAE,OAAO;CACxB,IAAI,EAAE,OAAO;CACb,IAAI,EAAE,OAAO;AACjB,CAAC;AAED,MAAM,2BAA2B,EAAE,MAAM;CACrC,EAAE,OAAO;CACT,EAAE,OAAO;CACT,EAAE,KACE,EAAE,OAAO,GACT,EAAE,MAAM,OAAO,GACf,EAAE,WAAW,UAAU,OAAO,KAAK,CAAC,CACxC;AACJ,CAAC;AAED,MAAM,yBAAyB,EAAE,KAC7B,EAAE,KAAKA,gBAAsB,GAC7B,EAAE,WAAW,SACT,kBAAkB,sBAAsB,eAAe,MAAM,sBAAsB,MAAM,CAC7F,CACJ;AAEA,MAAa,2BAA2B,EAAE,OAAO;CAC7C,MAAM;CACN,WAAW;CACX,SAAS,EAAE,SAAS,EAAE,OAAO,GAAG,EAAE;AACtC,CAAC;;AAKD,MAAa,uBAAuB,EAAE,KAClC,EAAE,OAAO;CACL,SAAS,EAAE,OAAO;CAClB,WAAW,EAAE,SAAS,UAAU;CAChC,iBAAiB,EAAE,SAAS,UAAU;CACtC,SAAS,EAAE,QAAQ;CACnB,cAAc,EAAE,OAAO;CACvB,aAAa,EAAE,OAAO;CACtB,MAAM;CACN,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC;CAC7B,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC;CAC7B,QAAQ,EAAE,SAAS,wBAAwB;CAC3C,aAAa,EAAE,SAAS,wBAAwB;AACpD,CAAC,GACD,EAAE,WAAW,OAAO;CAChB,MAAM,SAAS,SAAS,GAAG,SAAS;CACpC,MAAM,SAAS,GAAG,UAAU,GAAG,SAAS,KAAK,GAAG,OAAO,SAAS,IAAI,KAAA;CA2BpE,OAAO;EAxBH,SAAS,GAAG;EACZ,QAAQ,sBAAsB,QAAA,EAAiB;EAC/C,cACI,GAAG,oBAAoB,KAAA,IACjB,sBAAsB,SAAS,GAAG,eAAe,GAAA,EAAY,IAC7D,KAAA;EACV,MAAM,kBACF,kBAAkB,eAClB,GAAG,cACH,wBACA,eACJ;EACA,aAAa,kBACT,iBAAiB,eACjB,GAAG,aACH,wBACA,cACJ;EACA,WAAW,kBAAkB,GAAG,IAAI;EACpC,SAAS,GAAG;EACZ;EACA,QAAQ,GAAG,QAAQ,KAAK,KAAK;EAK7B,GAAI,GAAG,SAAS,EAAE,QAAQ,GAAG,OAAO,IAAI,CAAC;EACzC,GAAI,GAAG,cAAc,EAAE,aAAa,GAAG,YAAY,IAAI,CAAC;CAC5D;AACJ,CAAC,CACL;AAIA,MAAa,2BAA2B,EAAE,KACtC,EAAE,aAAa;CACX,GAAG;CACH,QAAQ,EAAE,SAAS,EAAE,OAAO,GAAG,CAAC;CAChC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC;CAC5B,UAAU,EAAE,SAAS,EAAE,QAAQ,GAAG,KAAK;CACvC,cAAc;CACd,cAAc;CACd,cAAc,EAAE,SACZ,EAAE,KACE,EAAE,SAAS,oBAAoB,GAC/B,EAAE,WAAW,UAAU,kBAAkB,aAAa,MAAM,CAChE,CACJ;CACA,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE;AAC1D,CAAC,GACD,EAAE,WAAW,EAAE,SAAS,cAAc,cAAc,GAAG,aAAa;CAChE,GAAG;CACH,SAAS;CACT,SAAS;CACT,cAAc,2BAA2B,OAAO;AACpD,EAAE,CACN"}