@decibeltrade/sdk 0.1.1

package/dist/gas/gas-price-manager.d.ts

@@ -0,0 +1,35 @@
+import { DecibelConfig } from "../constants";
+export interface GasPriceInfo {
+    gasEstimate: number;
+    timestamp: number;
+}
+export interface GasPriceManagerOptions {
+    nodeApiKey?: string;
+    multiplier: number;
+    refreshIntervalMs: number;
+}
+export declare class GasPriceManager {
+    private gasPrice;
+    private intervalId;
+    private readonly aptos;
+    private readonly refreshIntervalMs;
+    private isInitialized;
+    private readonly multiplier;
+    constructor(config: DecibelConfig, opts?: GasPriceManagerOptions);
+    getGasPrice(): number | undefined;
+    /**
+     * Initialize the gas price manager and start fetching gas prices
+     */
+    initialize(): Promise<void>;
+    refresh(): void;
+    /**
+     * Stop the gas price manager and clear the interval
+     */
+    destroy(): void;
+    fetchGasPriceEstimation(): Promise<number>;
+    /**
+     * Fetch gas price from the network
+     */
+    fetchAndSetGasPrice(): Promise<number>;
+}
+//# sourceMappingURL=gas-price-manager.d.ts.map

package/dist/gas/gas-price-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gas-price-manager.d.ts","sourceRoot":"","sources":["../../src/gas/gas-price-manager.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,MAAM,EAAE,aAAa,EAAE,IAAI,CAAC,EAAE,sBAAsB;IAYhE,WAAW,IAAI,MAAM,GAAG,SAAS;IAQjC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAwBjC,OAAO;IAIP;;OAEG;IACH,OAAO,IAAI,IAAI;IAST,uBAAuB,IAAI,OAAO,CAAC,MAAM,CAAC;IAMhD;;OAEG;IACG,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC;CAmB7C"}

package/dist/gas/gas-price-manager.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GasPriceManager = void 0;
+const ts_sdk_1 = require("@aptos-labs/ts-sdk");
+class GasPriceManager {
+    gasPrice = null;
+    intervalId = null;
+    aptos;
+    refreshIntervalMs;
+    isInitialized = false;
+    multiplier;
+    constructor(config, opts) {
+        this.aptos = new ts_sdk_1.Aptos(new ts_sdk_1.AptosConfig({
+            network: config.network,
+            fullnode: config.fullnodeUrl,
+            clientConfig: { API_KEY: opts?.nodeApiKey },
+        }));
+        this.refreshIntervalMs = opts?.refreshIntervalMs ?? 60_000; // default to 1 minute
+        this.multiplier = opts?.multiplier ?? 2; // default to 2x multilier to ensure we have enough gas for the transactipon
+    }
+    getGasPrice() {
+        const estimatedGasPrice = this.gasPrice?.gasEstimate;
+        if (!estimatedGasPrice) {
+            return undefined;
+        }
+        return estimatedGasPrice;
+    }
+    /**
+     * Initialize the gas price manager and start fetching gas prices
+     */
+    async initialize() {
+        try {
+            if (this.isInitialized) {
+                return;
+            }
+            // Fetch initial gas price
+            await this.fetchAndSetGasPrice();
+            // Set up interval to refresh gas price
+            this.intervalId = setInterval(async () => {
+                try {
+                    await this.fetchAndSetGasPrice();
+                }
+                catch (error) {
+                    console.warn("Failed to fetch gas price:", error);
+                }
+            }, this.refreshIntervalMs);
+            this.isInitialized = true;
+        }
+        catch (error) {
+            console.error("Failed to initialize gas price manager:", error);
+        }
+    }
+    refresh() {
+        void this.fetchAndSetGasPrice();
+    }
+    /**
+     * Stop the gas price manager and clear the interval
+     */
+    destroy() {
+        if (this.intervalId) {
+            clearInterval(this.intervalId);
+            this.intervalId = null;
+        }
+        this.isInitialized = false;
+        this.gasPrice = null; // Clear cached data
+    }
+    async fetchGasPriceEstimation() {
+        return this.aptos.getGasPriceEstimation().then((gasEstimation) => {
+            return gasEstimation.gas_estimate * this.multiplier; // Multiplier is applied here to ensure we have enough gas for the transaction
+        });
+    }
+    /**
+     * Fetch gas price from the network
+     */
+    async fetchAndSetGasPrice() {
+        try {
+            const gasEstimate = await this.fetchGasPriceEstimation();
+            if (!gasEstimate) {
+                throw new Error("Gas estimation returned no gas estimate");
+            }
+            this.gasPrice = {
+                gasEstimate,
+                timestamp: Date.now(),
+            };
+            return gasEstimate;
+        }
+        catch (error) {
+            console.error("Failed to fetch gas price:", error);
+            throw error;
+        }
+    }
+}
+exports.GasPriceManager = GasPriceManager;

package/dist/gas-price-manager.d.ts

@@ -0,0 +1,31 @@
+import { Aptos } from "@aptos-labs/ts-sdk";
+export interface GasPriceInfo {
+    gasEstimate: number;
+    timestamp: number;
+}
+export declare class GasPriceManager {
+    private gasPrice;
+    private intervalId;
+    private readonly aptos;
+    private readonly refreshIntervalMs;
+    private isInitialized;
+    constructor(aptos: Aptos, refreshIntervalMs?: number);
+    /**
+     * Initialize the gas price manager and start fetching gas prices
+     */
+    initialize(): Promise<void>;
+    /**
+     * Get the current cached gas price info with timestamp
+     */
+    getGasPrice(): Promise<number>;
+    refresh(): Promise<void>;
+    /**
+     * Stop the gas price manager and clear the interval
+     */
+    destroy(): void;
+    /**
+     * Fetch gas price from the network
+     */
+    private fetchGasPrice;
+}
+//# sourceMappingURL=gas-price-manager.d.ts.map

package/dist/gas-price-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gas-price-manager.d.ts","sourceRoot":"","sources":["../src/gas-price-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAiB;IACnD,OAAO,CAAC,aAAa,CAAS;gBAElB,KAAK,EAAE,KAAK,EAAE,iBAAiB,SAAQ;IAKnD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAoBjC;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC;IAc9B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAS9B;;OAEG;IACH,OAAO,IAAI,IAAI;IASf;;OAEG;YACW,aAAa;CAc5B"}

package/dist/gas-price-manager.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GasPriceManager = void 0;
+class GasPriceManager {
+    gasPrice = null;
+    intervalId = null;
+    aptos;
+    refreshIntervalMs = 60000;
+    isInitialized = false;
+    constructor(aptos, refreshIntervalMs = 60000) {
+        this.aptos = aptos;
+        this.refreshIntervalMs = refreshIntervalMs;
+    }
+    /**
+     * Initialize the gas price manager and start fetching gas prices
+     */
+    async initialize() {
+        if (this.isInitialized) {
+            return;
+        }
+        // Fetch initial gas price
+        await this.fetchGasPrice();
+        // Set up interval to refresh gas price
+        this.intervalId = setInterval(async () => {
+            try {
+                await this.fetchGasPrice();
+            }
+            catch (error) {
+                console.warn("Failed to fetch gas price:", error);
+            }
+        }, this.refreshIntervalMs);
+        this.isInitialized = true;
+    }
+    /**
+     * Get the current cached gas price info with timestamp
+     */
+    async getGasPrice() {
+        if (this.gasPrice) {
+            // If the gas price is too stale, fetch a new one
+            if (Date.now() - this.gasPrice.timestamp > this.refreshIntervalMs * 2) {
+                return await this.fetchGasPrice();
+            }
+            // Return the cached gas price
+            return this.gasPrice.gasEstimate;
+        }
+        return await this.fetchGasPrice();
+    }
+    async refresh() {
+        await this.fetchGasPrice().then((gasEstimate) => {
+            this.gasPrice = {
+                gasEstimate,
+                timestamp: Date.now(),
+            };
+        });
+    }
+    /**
+     * Stop the gas price manager and clear the interval
+     */
+    destroy() {
+        if (this.intervalId) {
+            clearInterval(this.intervalId);
+            this.intervalId = null;
+        }
+        this.isInitialized = false;
+        this.gasPrice = null; // Clear cached data
+    }
+    /**
+     * Fetch gas price from the network
+     */
+    async fetchGasPrice() {
+        try {
+            const gasEstimation = await this.aptos.getGasPriceEstimation();
+            if (!gasEstimation.gas_estimate) {
+                throw new Error("Gas estimation returned no gas estimate");
+            }
+            return gasEstimation.gas_estimate;
+        }
+        catch (error) {
+            console.error("Failed to fetch gas price:", error);
+            throw error;
+        }
+    }
+}
+exports.GasPriceManager = GasPriceManager;

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export * from "./admin";
+export * from "./constants";
+export * from "./fee-pay";
+export * from "./gas/gas-price-manager";
+export * from "./order-event.types";
+export * from "./order-status";
+export * from "./read/index";
+export * from "./subaccount-types";
+export * from "./utils";
+export * from "./write";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,26 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./admin"), exports);
+__exportStar(require("./constants"), exports);
+__exportStar(require("./fee-pay"), exports);
+__exportStar(require("./gas/gas-price-manager"), exports);
+__exportStar(require("./order-event.types"), exports);
+__exportStar(require("./order-status"), exports);
+__exportStar(require("./read/index"), exports);
+__exportStar(require("./subaccount-types"), exports);
+__exportStar(require("./utils"), exports);
+__exportStar(require("./write"), exports);

package/dist/order-event.types.d.ts

@@ -0,0 +1,55 @@
+export interface OrderEventClientOrderId {
+    vec: unknown[];
+}
+export interface OrderEventStatus {
+    __variant__: string;
+}
+export interface OrderEventTimeInForce {
+    __variant__: string;
+}
+export interface OrderEventTriggerCondition {
+    vec: unknown[];
+}
+export interface OrderEventOrderId {
+    order_id: string;
+}
+export interface OrderEvent {
+    client_order_id: OrderEventClientOrderId;
+    details: string;
+    is_bid: boolean;
+    is_taker: boolean;
+    market: string;
+    metadata_bytes: string;
+    order_id: string;
+    orig_size: string;
+    parent: string;
+    price: string;
+    remaining_size: string;
+    size_delta: string;
+    status: OrderEventStatus;
+    time_in_force: OrderEventTimeInForce;
+    trigger_condition: OrderEventTriggerCondition;
+    user: string;
+}
+export interface TwapEvent {
+    account: string;
+    duration_s: string;
+    frequency_s: string;
+    is_buy: boolean;
+    is_reduce_only: boolean;
+    market: string;
+    order_id: OrderEventOrderId;
+    orig_size: string;
+    remain_size: string;
+    start_time_s: string;
+    status: OrderEventStatus;
+}
+export type PlaceOrderResult = {
+    success: true;
+    orderId: string | undefined;
+    transactionHash: string;
+} | {
+    success: false;
+    error: string;
+};
+//# sourceMappingURL=order-event.types.d.ts.map

package/dist/order-event.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"order-event.types.d.ts","sourceRoot":"","sources":["../src/order-event.types.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,uBAAuB;IACtC,GAAG,EAAE,OAAO,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,0BAA0B;IACzC,GAAG,EAAE,OAAO,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,eAAe,EAAE,uBAAuB,CAAC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,gBAAgB,CAAC;IACzB,aAAa,EAAE,qBAAqB,CAAC;IACrC,iBAAiB,EAAE,0BAA0B,CAAC;IAC9C,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,cAAc,EAAE,OAAO,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,gBAAgB,CAAC;CAC1B;AAED,MAAM,MAAM,gBAAgB,GACxB;IACE,OAAO,EAAE,IAAI,CAAC;IACd,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;CACzB,GACD;IACE,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf,CAAC"}

package/dist/order-event.types.js

@@ -0,0 +1,3 @@
+"use strict";
+// Type definitions for OrderEvent returned by placeOrder transactions
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/order-status.d.ts

@@ -0,0 +1,43 @@
+import z from "zod/v4";
+import { DecibelConfig } from "./constants";
+export declare const OrderStatusSchema: z.ZodObject<{
+    parent: z.ZodString;
+    market: z.ZodString;
+    order_id: z.ZodString;
+    status: z.ZodString;
+    orig_size: z.ZodNumber;
+    remaining_size: z.ZodNumber;
+    size_delta: z.ZodNumber;
+    price: z.ZodNumber;
+    is_buy: z.ZodBoolean;
+    details: z.ZodString;
+    transaction_version: z.ZodNumber;
+    unix_ms: z.ZodNumber;
+}, z.core.$strip>;
+export type OrderStatus = z.infer<typeof OrderStatusSchema>;
+export type OrderStatusType = "Acknowledged" | "Filled" | "Cancelled" | "Rejected" | "Unknown";
+export declare class OrderStatusClient {
+    private config;
+    constructor(config: DecibelConfig);
+    /**
+     * Get order status by order ID and market address using REST API
+     */
+    getOrderStatus(orderId: string, marketAddress: string, userAddress: string): Promise<OrderStatus | null>;
+    /**
+     * Parse order status string to enum-like type
+     */
+    parseOrderStatusType(status: string | undefined | null): OrderStatusType;
+    /**
+     * Check if order status represents success
+     */
+    isSuccessStatus(status: string | undefined | null): boolean;
+    /**
+     * Check if order status represents failure
+     */
+    isFailureStatus(status: string | undefined | null): boolean;
+    /**
+     * Check if order status is final (success or failure)
+     */
+    isFinalStatus(status: string | undefined | null): boolean;
+}
+//# sourceMappingURL=order-status.d.ts.map

package/dist/order-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"order-status.d.ts","sourceRoot":"","sources":["../src/order-status.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,QAAQ,CAAC;AAEvB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;iBAa5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,MAAM,MAAM,eAAe,GAAG,cAAc,GAAG,QAAQ,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,CAAC;AAE/F,qBAAa,iBAAiB;IAChB,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,aAAa;IAEzC;;OAEG;IACG,cAAc,CAClB,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAoB9B;;OAEG;IACH,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,eAAe;IAUxE;;OAEG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,OAAO;IAI3D;;OAEG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,OAAO;IAK3D;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,OAAO;CAG1D"}

package/dist/order-status.js

@@ -0,0 +1,86 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OrderStatusClient = exports.OrderStatusSchema = void 0;
+const v4_1 = __importDefault(require("zod/v4"));
+// Order status response schema
+exports.OrderStatusSchema = v4_1.default.object({
+    parent: v4_1.default.string(),
+    market: v4_1.default.string(),
+    order_id: v4_1.default.string(),
+    status: v4_1.default.string(),
+    orig_size: v4_1.default.number(),
+    remaining_size: v4_1.default.number(),
+    size_delta: v4_1.default.number(),
+    price: v4_1.default.number(),
+    is_buy: v4_1.default.boolean(),
+    details: v4_1.default.string(),
+    transaction_version: v4_1.default.number(),
+    unix_ms: v4_1.default.number(),
+});
+class OrderStatusClient {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Get order status by order ID and market address using REST API
+     */
+    async getOrderStatus(orderId, marketAddress, userAddress) {
+        try {
+            const url = `${this.config.tradingHttpUrl}/api/v1/orders?order_id=${orderId}&market_address=${marketAddress}&user_address=${userAddress}`;
+            const response = await fetch(url);
+            if (!response.ok) {
+                if (response.status === 404) {
+                    return null; // Order not found yet
+                }
+                throw new Error(`HTTP error! status: ${response.status}`);
+            }
+            const data = await response.json();
+            return exports.OrderStatusSchema.parse(data);
+        }
+        catch (error) {
+            console.error("Error fetching order status:", error);
+            return null;
+        }
+    }
+    /**
+     * Parse order status string to enum-like type
+     */
+    parseOrderStatusType(status) {
+        if (!status)
+            return "Unknown";
+        const upperStatus = status.toLowerCase();
+        if (upperStatus.includes("acknowledged"))
+            return "Acknowledged";
+        if (upperStatus.includes("filled"))
+            return "Filled";
+        if (upperStatus.includes("cancelled"))
+            return "Cancelled";
+        if (upperStatus.includes("rejected"))
+            return "Rejected";
+        return "Unknown";
+    }
+    /**
+     * Check if order status represents success
+     */
+    isSuccessStatus(status) {
+        return this.parseOrderStatusType(status) === "Filled";
+    }
+    /**
+     * Check if order status represents failure
+     */
+    isFailureStatus(status) {
+        const statusType = this.parseOrderStatusType(status);
+        return statusType === "Cancelled" || statusType === "Rejected";
+    }
+    /**
+     * Check if order status is final (success or failure)
+     */
+    isFinalStatus(status) {
+        return this.isSuccessStatus(status) || this.isFailureStatus(status);
+    }
+}
+exports.OrderStatusClient = OrderStatusClient;

package/dist/read/account-overview/account-overview.reader.d.ts

@@ -0,0 +1,37 @@
+import { BaseReader } from "../base-reader";
+import { AccountOverviewWsMessage, VolumeWindow } from "./account-overview.types";
+export declare class AccountOverviewReader extends BaseReader {
+    /**
+     * Get the account overview for a given user
+     * @param subAddr The subaccount address to get the account overview for
+     * @returns The account overview for the given subaccount address
+     */
+    getByAddr(subAddr: string, volumeWindow?: VolumeWindow): Promise<{
+        perp_equity_balance: number;
+        unrealized_pnl: number;
+        unrealized_funding_cost: number;
+        cross_margin_ratio: number;
+        maintenance_margin: number;
+        cross_account_leverage_ratio: number | null;
+        volume: number | null;
+        all_time_return: number | null;
+        pnl_90d: number | null;
+        sharpe_ratio: number | null;
+        max_drawdown: number | null;
+        weekly_win_rate_12w: number | null;
+        average_cash_position: number | null;
+        average_leverage: number | null;
+        cross_account_position: number;
+        total_margin: number;
+        usdc_cross_withdrawable_balance: number;
+        usdc_isolated_withdrawable_balance: number;
+    }>;
+    /**
+     * Subscribe to account overview
+     * @param subAddr The subaccount address of the user to subscribe to
+     * @param onData Callback function for received account overview data
+     * @returns A function to unsubscribe from the account overview updates
+     */
+    subscribeByAddr(subAddr: string, onData: (data: AccountOverviewWsMessage) => void): () => void;
+}
+//# sourceMappingURL=account-overview.reader.d.ts.map

package/dist/read/account-overview/account-overview.reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-overview.reader.d.ts","sourceRoot":"","sources":["../../../src/read/account-overview/account-overview.reader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAEL,wBAAwB,EAExB,YAAY,EACb,MAAM,0BAA0B,CAAC;AAElC,qBAAa,qBAAsB,SAAQ,UAAU;IACnD;;;;OAIG;IACG,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,YAAY;;;;;;;;;;;;;;;;;;;;IAgB5D;;;;;OAKG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,wBAAwB,KAAK,IAAI;CAKlF"}

package/dist/read/account-overview/account-overview.reader.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AccountOverviewReader = void 0;
+const base_reader_1 = require("../base-reader");
+const account_overview_types_1 = require("./account-overview.types");
+class AccountOverviewReader extends base_reader_1.BaseReader {
+    /**
+     * Get the account overview for a given user
+     * @param subAddr The subaccount address to get the account overview for
+     * @returns The account overview for the given subaccount address
+     */
+    async getByAddr(subAddr, volumeWindow) {
+        const queryParams = new URLSearchParams({ user: subAddr });
+        if (volumeWindow) {
+            queryParams.set("volume_window", volumeWindow);
+        }
+        const response = await this.getRequest({
+            schema: account_overview_types_1.AccountOverviewSchema,
+            url: `${this.deps.config.tradingHttpUrl}/api/v1/account_overviews`,
+            queryParams,
+        });
+        return response.data;
+    }
+    /**
+     * Subscribe to account overview
+     * @param subAddr The subaccount address of the user to subscribe to
+     * @param onData Callback function for received account overview data
+     * @returns A function to unsubscribe from the account overview updates
+     */
+    subscribeByAddr(subAddr, onData) {
+        const topic = `account_overview:${subAddr}`;
+        return this.deps.ws.subscribe(topic, account_overview_types_1.AccountOverviewWsMessageSchema, onData);
+    }
+}
+exports.AccountOverviewReader = AccountOverviewReader;

package/dist/read/account-overview/account-overview.types.d.ts

@@ -0,0 +1,52 @@
+import z from "zod/v4";
+export declare const VolumeWindow: {
+    readonly SevenDays: "7d";
+    readonly FourteenDays: "14d";
+    readonly ThirtyDays: "30d";
+    readonly NinetyDays: "90d";
+};
+export type VolumeWindow = (typeof VolumeWindow)[keyof typeof VolumeWindow];
+export declare const AccountOverviewSchema: z.ZodObject<{
+    perp_equity_balance: z.ZodNumber;
+    unrealized_pnl: z.ZodNumber;
+    unrealized_funding_cost: z.ZodNumber;
+    cross_margin_ratio: z.ZodNumber;
+    maintenance_margin: z.ZodNumber;
+    cross_account_leverage_ratio: z.ZodNullable<z.ZodNumber>;
+    volume: z.ZodNullable<z.ZodNumber>;
+    all_time_return: z.ZodNullable<z.ZodNumber>;
+    pnl_90d: z.ZodNullable<z.ZodNumber>;
+    sharpe_ratio: z.ZodNullable<z.ZodNumber>;
+    max_drawdown: z.ZodNullable<z.ZodNumber>;
+    weekly_win_rate_12w: z.ZodNullable<z.ZodNumber>;
+    average_cash_position: z.ZodNullable<z.ZodNumber>;
+    average_leverage: z.ZodNullable<z.ZodNumber>;
+    cross_account_position: z.ZodNumber;
+    total_margin: z.ZodNumber;
+    usdc_cross_withdrawable_balance: z.ZodNumber;
+    usdc_isolated_withdrawable_balance: z.ZodNumber;
+}, z.core.$strip>;
+export declare const AccountOverviewWsMessageSchema: z.ZodObject<{
+    account_overview: z.ZodObject<{
+        perp_equity_balance: z.ZodNumber;
+        unrealized_pnl: z.ZodNumber;
+        unrealized_funding_cost: z.ZodNumber;
+        cross_margin_ratio: z.ZodNumber;
+        maintenance_margin: z.ZodNumber;
+        cross_account_leverage_ratio: z.ZodNullable<z.ZodNumber>;
+        all_time_return: z.ZodNullable<z.ZodNumber>;
+        pnl_90d: z.ZodNullable<z.ZodNumber>;
+        sharpe_ratio: z.ZodNullable<z.ZodNumber>;
+        max_drawdown: z.ZodNullable<z.ZodNumber>;
+        weekly_win_rate_12w: z.ZodNullable<z.ZodNumber>;
+        average_cash_position: z.ZodNullable<z.ZodNumber>;
+        average_leverage: z.ZodNullable<z.ZodNumber>;
+        cross_account_position: z.ZodNumber;
+        total_margin: z.ZodNumber;
+        usdc_cross_withdrawable_balance: z.ZodNumber;
+        usdc_isolated_withdrawable_balance: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type AccountOverview = z.infer<typeof AccountOverviewSchema>;
+export type AccountOverviewWsMessage = z.infer<typeof AccountOverviewWsMessageSchema>;
+//# sourceMappingURL=account-overview.types.d.ts.map

package/dist/read/account-overview/account-overview.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-overview.types.d.ts","sourceRoot":"","sources":["../../../src/read/account-overview/account-overview.types.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,QAAQ,CAAC;AAEvB,eAAO,MAAM,YAAY;;;;;CAKf,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC;AAE5E,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;iBAmBhC,CAAC;AAEH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;iBAEzC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC"}

package/dist/read/account-overview/account-overview.types.js

@@ -0,0 +1,36 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AccountOverviewWsMessageSchema = exports.AccountOverviewSchema = exports.VolumeWindow = void 0;
+const v4_1 = __importDefault(require("zod/v4"));
+exports.VolumeWindow = {
+    SevenDays: "7d",
+    FourteenDays: "14d",
+    ThirtyDays: "30d",
+    NinetyDays: "90d",
+};
+exports.AccountOverviewSchema = v4_1.default.object({
+    perp_equity_balance: v4_1.default.number(),
+    unrealized_pnl: v4_1.default.number(),
+    unrealized_funding_cost: v4_1.default.number(),
+    cross_margin_ratio: v4_1.default.number(),
+    maintenance_margin: v4_1.default.number(),
+    cross_account_leverage_ratio: v4_1.default.number().nullable(),
+    volume: v4_1.default.number().nullable(),
+    all_time_return: v4_1.default.number().nullable(),
+    pnl_90d: v4_1.default.number().nullable(),
+    sharpe_ratio: v4_1.default.number().nullable(),
+    max_drawdown: v4_1.default.number().nullable(),
+    weekly_win_rate_12w: v4_1.default.number().nullable(),
+    average_cash_position: v4_1.default.number().nullable(),
+    average_leverage: v4_1.default.number().nullable(),
+    cross_account_position: v4_1.default.number(),
+    total_margin: v4_1.default.number(),
+    usdc_cross_withdrawable_balance: v4_1.default.number(),
+    usdc_isolated_withdrawable_balance: v4_1.default.number(),
+});
+exports.AccountOverviewWsMessageSchema = v4_1.default.object({
+    account_overview: exports.AccountOverviewSchema.omit({ volume: true }),
+});