@lightconexyz/lightcone-sdk 0.1.0

package/dist/api/types/order.d.ts

@@ -0,0 +1,190 @@
+/**
+ * Order-related types for the Lightcone REST API.
+ */
+/**
+ * Order side enum.
+ */
+export type ApiOrderSide = 0 | 1;
+/**
+ * Order status values.
+ */
+export type OrderStatusValue = "accepted" | "partial_fill" | "filled" | "rejected";
+/**
+ * Fill information from order matching.
+ */
+export interface Fill {
+    /** Counterparty address */
+    counterparty: string;
+    /** Counterparty's order hash */
+    counterparty_order_hash: string;
+    /** Amount filled as decimal string */
+    fill_amount: string;
+    /** Fill price as decimal string */
+    price: string;
+    /** Whether this order was the maker */
+    is_maker: boolean;
+}
+/**
+ * Request for POST /api/orders/submit.
+ */
+export interface SubmitOrderRequest {
+    /** Order creator's pubkey (Base58) */
+    maker: string;
+    /** User's nonce for uniqueness (u32 as string) */
+    nonce: string;
+    /** Market address (Base58) */
+    market_pubkey: string;
+    /** Token being bought/sold (Base58) */
+    base_token: string;
+    /** Token used for payment (Base58) */
+    quote_token: string;
+    /** Order side (0=BID, 1=ASK) */
+    side: number;
+    /** Amount maker gives (u64 as string) */
+    maker_amount: string;
+    /** Amount maker wants to receive (u64 as string) */
+    taker_amount: string;
+    /** Unix timestamp, 0=no expiration */
+    expiration?: number;
+    /** Ed25519 signature (hex, 128 chars) */
+    signature: string;
+    /** Target orderbook */
+    orderbook_id: string;
+}
+/**
+ * Response for POST /api/orders/submit.
+ */
+export interface OrderResponse {
+    /** Order hash (hex) */
+    order_hash: string;
+    /** Order status */
+    status: OrderStatusValue;
+    /** Remaining amount as decimal string */
+    remaining: string;
+    /** Filled amount as decimal string */
+    filled: string;
+    /** Fill details */
+    fills: Fill[];
+}
+/**
+ * Request for POST /api/orders/cancel.
+ */
+export interface CancelOrderRequest {
+    /** Hash of order to cancel (hex) */
+    order_hash: string;
+    /** Must match order creator (Base58) */
+    maker: string;
+    /** Ed25519 signature over the order hash (hex, 128 chars) */
+    signature: string;
+}
+/**
+ * Response for POST /api/orders/cancel.
+ */
+export interface CancelResponse {
+    /** Cancellation status */
+    status: string;
+    /** Order hash */
+    order_hash: string;
+    /** Remaining amount that was cancelled as decimal string */
+    remaining: string;
+}
+/**
+ * Request for POST /api/orders/cancel-all.
+ */
+export interface CancelAllOrdersRequest {
+    /** User's public key (Base58) */
+    user_pubkey: string;
+    /** Limit to specific orderbook (empty = all) */
+    orderbook_id?: string;
+    /** Ed25519 signature over "cancel_all:{pubkey}:{timestamp}" (hex, 128 chars) */
+    signature: string;
+    /** Unix timestamp used in the signed message */
+    timestamp: number;
+}
+/**
+ * Response for POST /api/orders/cancel-all.
+ */
+export interface CancelAllResponse {
+    /** Status (success) */
+    status: string;
+    /** User pubkey */
+    user_pubkey: string;
+    /** Orderbook ID if specified */
+    orderbook_id?: string;
+    /** List of cancelled order hashes */
+    cancelled_order_hashes: string[];
+    /** Count of cancelled orders */
+    count: number;
+    /** Human-readable message */
+    message: string;
+}
+/**
+ * User order from GET /api/users/orders.
+ */
+export interface UserOrder {
+    /** Order hash */
+    order_hash: string;
+    /** Market pubkey */
+    market_pubkey: string;
+    /** Orderbook ID */
+    orderbook_id: string;
+    /** Order side (0=BID, 1=ASK) */
+    side: ApiOrderSide;
+    /** Maker amount as decimal string */
+    maker_amount: string;
+    /** Taker amount as decimal string */
+    taker_amount: string;
+    /** Remaining amount as decimal string */
+    remaining: string;
+    /** Filled amount as decimal string */
+    filled: string;
+    /** Order price as decimal string */
+    price: string;
+    /** Creation timestamp */
+    created_at: string;
+    /** Expiration timestamp */
+    expiration: number;
+}
+/**
+ * Request for POST /api/users/orders.
+ */
+export interface GetUserOrdersRequest {
+    /** User's public key (Base58) */
+    user_pubkey: string;
+}
+/**
+ * Outcome balance in user orders response.
+ */
+export interface UserOrderOutcomeBalance {
+    /** Outcome index */
+    outcome_index: number;
+    /** Conditional token address */
+    conditional_token: string;
+    /** Idle balance as decimal string */
+    idle: string;
+    /** Balance on order book as decimal string */
+    on_book: string;
+}
+/**
+ * User balance from GET /api/users/orders.
+ */
+export interface UserBalance {
+    /** Market pubkey */
+    market_pubkey: string;
+    /** Deposit asset */
+    deposit_asset: string;
+    /** Outcome balances */
+    outcomes: UserOrderOutcomeBalance[];
+}
+/**
+ * Response for POST /api/users/orders.
+ */
+export interface UserOrdersResponse {
+    /** User pubkey */
+    user_pubkey: string;
+    /** Open orders */
+    orders: UserOrder[];
+    /** User balances */
+    balances: UserBalance[];
+}
+//# sourceMappingURL=order.d.ts.map

package/dist/api/types/order.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"order.d.ts","sourceRoot":"","sources":["../../../src/api/types/order.ts"],"names":[],"mappings":"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"}

package/dist/api/types/order.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Order-related types for the Lightcone REST API.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=order.js.map

package/dist/api/types/order.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"order.js","sourceRoot":"","sources":["../../../src/api/types/order.ts"],"names":[],"mappings":";AAAA;;GAEG","sourcesContent":["/**\n * Order-related types for the Lightcone REST API.\n */\n\n/**\n * Order side enum.\n */\nexport type ApiOrderSide = 0 | 1;\n\n/**\n * Order status values.\n */\nexport type OrderStatusValue = \"accepted\" | \"partial_fill\" | \"filled\" | \"rejected\";\n\n/**\n * Fill information from order matching.\n */\nexport interface Fill {\n  /** Counterparty address */\n  counterparty: string;\n  /** Counterparty's order hash */\n  counterparty_order_hash: string;\n  /** Amount filled as decimal string */\n  fill_amount: string;\n  /** Fill price as decimal string */\n  price: string;\n  /** Whether this order was the maker */\n  is_maker: boolean;\n}\n\n/**\n * Request for POST /api/orders/submit.\n */\nexport interface SubmitOrderRequest {\n  /** Order creator's pubkey (Base58) */\n  maker: string;\n  /** User's nonce for uniqueness (u32 as string) */\n  nonce: string;\n  /** Market address (Base58) */\n  market_pubkey: string;\n  /** Token being bought/sold (Base58) */\n  base_token: string;\n  /** Token used for payment (Base58) */\n  quote_token: string;\n  /** Order side (0=BID, 1=ASK) */\n  side: number;\n  /** Amount maker gives (u64 as string) */\n  maker_amount: string;\n  /** Amount maker wants to receive (u64 as string) */\n  taker_amount: string;\n  /** Unix timestamp, 0=no expiration */\n  expiration?: number;\n  /** Ed25519 signature (hex, 128 chars) */\n  signature: string;\n  /** Target orderbook */\n  orderbook_id: string;\n}\n\n/**\n * Response for POST /api/orders/submit.\n */\nexport interface OrderResponse {\n  /** Order hash (hex) */\n  order_hash: string;\n  /** Order status */\n  status: OrderStatusValue;\n  /** Remaining amount as decimal string */\n  remaining: string;\n  /** Filled amount as decimal string */\n  filled: string;\n  /** Fill details */\n  fills: Fill[];\n}\n\n/**\n * Request for POST /api/orders/cancel.\n */\nexport interface CancelOrderRequest {\n  /** Hash of order to cancel (hex) */\n  order_hash: string;\n  /** Must match order creator (Base58) */\n  maker: string;\n  /** Ed25519 signature over the order hash (hex, 128 chars) */\n  signature: string;\n}\n\n/**\n * Response for POST /api/orders/cancel.\n */\nexport interface CancelResponse {\n  /** Cancellation status */\n  status: string;\n  /** Order hash */\n  order_hash: string;\n  /** Remaining amount that was cancelled as decimal string */\n  remaining: string;\n}\n\n/**\n * Request for POST /api/orders/cancel-all.\n */\nexport interface CancelAllOrdersRequest {\n  /** User's public key (Base58) */\n  user_pubkey: string;\n  /** Limit to specific orderbook (empty = all) */\n  orderbook_id?: string;\n  /** Ed25519 signature over \"cancel_all:{pubkey}:{timestamp}\" (hex, 128 chars) */\n  signature: string;\n  /** Unix timestamp used in the signed message */\n  timestamp: number;\n}\n\n/**\n * Response for POST /api/orders/cancel-all.\n */\nexport interface CancelAllResponse {\n  /** Status (success) */\n  status: string;\n  /** User pubkey */\n  user_pubkey: string;\n  /** Orderbook ID if specified */\n  orderbook_id?: string;\n  /** List of cancelled order hashes */\n  cancelled_order_hashes: string[];\n  /** Count of cancelled orders */\n  count: number;\n  /** Human-readable message */\n  message: string;\n}\n\n/**\n * User order from GET /api/users/orders.\n */\nexport interface UserOrder {\n  /** Order hash */\n  order_hash: string;\n  /** Market pubkey */\n  market_pubkey: string;\n  /** Orderbook ID */\n  orderbook_id: string;\n  /** Order side (0=BID, 1=ASK) */\n  side: ApiOrderSide;\n  /** Maker amount as decimal string */\n  maker_amount: string;\n  /** Taker amount as decimal string */\n  taker_amount: string;\n  /** Remaining amount as decimal string */\n  remaining: string;\n  /** Filled amount as decimal string */\n  filled: string;\n  /** Order price as decimal string */\n  price: string;\n  /** Creation timestamp */\n  created_at: string;\n  /** Expiration timestamp */\n  expiration: number;\n}\n\n/**\n * Request for POST /api/users/orders.\n */\nexport interface GetUserOrdersRequest {\n  /** User's public key (Base58) */\n  user_pubkey: string;\n}\n\n/**\n * Outcome balance in user orders response.\n */\nexport interface UserOrderOutcomeBalance {\n  /** Outcome index */\n  outcome_index: number;\n  /** Conditional token address */\n  conditional_token: string;\n  /** Idle balance as decimal string */\n  idle: string;\n  /** Balance on order book as decimal string */\n  on_book: string;\n}\n\n/**\n * User balance from GET /api/users/orders.\n */\nexport interface UserBalance {\n  /** Market pubkey */\n  market_pubkey: string;\n  /** Deposit asset */\n  deposit_asset: string;\n  /** Outcome balances */\n  outcomes: UserOrderOutcomeBalance[];\n}\n\n/**\n * Response for POST /api/users/orders.\n */\nexport interface UserOrdersResponse {\n  /** User pubkey */\n  user_pubkey: string;\n  /** Open orders */\n  orders: UserOrder[];\n  /** User balances */\n  balances: UserBalance[];\n}\n"]}

package/dist/api/types/orderbook.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Orderbook-related types for the Lightcone REST API.
+ */
+/**
+ * Price level in the orderbook.
+ */
+export interface PriceLevel {
+    /** Price as decimal string (e.g., "0.500000") */
+    price: string;
+    /** Total size at this price level as decimal string */
+    size: string;
+    /** Number of orders at this level */
+    orders: number;
+}
+/**
+ * Response for GET /api/orderbook/{orderbook_id}.
+ */
+export interface OrderbookResponse {
+    /** Market pubkey */
+    market_pubkey: string;
+    /** Orderbook identifier */
+    orderbook_id: string;
+    /** Bid levels (buy orders), sorted by price descending */
+    bids: PriceLevel[];
+    /** Ask levels (sell orders), sorted by price ascending */
+    asks: PriceLevel[];
+    /** Best bid price as decimal string */
+    best_bid?: string;
+    /** Best ask price as decimal string */
+    best_ask?: string;
+    /** Spread (best_ask - best_bid) as decimal string */
+    spread?: string;
+    /** Tick size for this orderbook as decimal string */
+    tick_size: string;
+}
+//# sourceMappingURL=orderbook.d.ts.map

package/dist/api/types/orderbook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orderbook.d.ts","sourceRoot":"","sources":["../../../src/api/types/orderbook.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,oBAAoB;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,2BAA2B;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,IAAI,EAAE,UAAU,EAAE,CAAC;IACnB,0DAA0D;IAC1D,IAAI,EAAE,UAAU,EAAE,CAAC;IACnB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/api/types/orderbook.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Orderbook-related types for the Lightcone REST API.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=orderbook.js.map

package/dist/api/types/orderbook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orderbook.js","sourceRoot":"","sources":["../../../src/api/types/orderbook.ts"],"names":[],"mappings":";AAAA;;GAEG","sourcesContent":["/**\n * Orderbook-related types for the Lightcone REST API.\n */\n\n/**\n * Price level in the orderbook.\n */\nexport interface PriceLevel {\n  /** Price as decimal string (e.g., \"0.500000\") */\n  price: string;\n  /** Total size at this price level as decimal string */\n  size: string;\n  /** Number of orders at this level */\n  orders: number;\n}\n\n/**\n * Response for GET /api/orderbook/{orderbook_id}.\n */\nexport interface OrderbookResponse {\n  /** Market pubkey */\n  market_pubkey: string;\n  /** Orderbook identifier */\n  orderbook_id: string;\n  /** Bid levels (buy orders), sorted by price descending */\n  bids: PriceLevel[];\n  /** Ask levels (sell orders), sorted by price ascending */\n  asks: PriceLevel[];\n  /** Best bid price as decimal string */\n  best_bid?: string;\n  /** Best ask price as decimal string */\n  best_ask?: string;\n  /** Spread (best_ask - best_bid) as decimal string */\n  spread?: string;\n  /** Tick size for this orderbook as decimal string */\n  tick_size: string;\n}\n"]}

package/dist/api/types/position.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Position-related types for the Lightcone REST API.
+ */
+/**
+ * Outcome balance in a position.
+ */
+export interface OutcomeBalance {
+    /** Outcome index */
+    outcome_index: number;
+    /** Conditional token address */
+    conditional_token: string;
+    /** Total balance as decimal string */
+    balance: string;
+    /** Idle balance (not on book) as decimal string */
+    balance_idle: string;
+    /** Balance on order book as decimal string */
+    balance_on_book: string;
+}
+/**
+ * User position in a market.
+ */
+export interface Position {
+    /** Database ID */
+    id: number;
+    /** Position PDA address */
+    position_pubkey: string;
+    /** Position owner */
+    owner: string;
+    /** Market pubkey */
+    market_pubkey: string;
+    /** Outcome balances */
+    outcomes: OutcomeBalance[];
+    /** Creation timestamp */
+    created_at: string;
+    /** Last update timestamp */
+    updated_at: string;
+}
+/**
+ * Response for GET /api/users/{user_pubkey}/positions.
+ */
+export interface PositionsResponse {
+    /** Position owner */
+    owner: string;
+    /** Total markets with positions */
+    total_markets: number;
+    /** User positions */
+    positions: Position[];
+}
+/**
+ * Response for GET /api/users/{user_pubkey}/markets/{market_pubkey}/positions.
+ */
+export interface MarketPositionsResponse {
+    /** Position owner */
+    owner: string;
+    /** Market pubkey */
+    market_pubkey: string;
+    /** Positions in this market */
+    positions: Position[];
+}
+//# sourceMappingURL=position.d.ts.map

package/dist/api/types/position.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"position.d.ts","sourceRoot":"","sources":["../../../src/api/types/position.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,oBAAoB;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,gCAAgC;IAChC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,YAAY,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,kBAAkB;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,2BAA2B;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,oBAAoB;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,uBAAuB;IACvB,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,qBAAqB;IACrB,SAAS,EAAE,QAAQ,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,oBAAoB;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,SAAS,EAAE,QAAQ,EAAE,CAAC;CACvB"}

package/dist/api/types/position.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Position-related types for the Lightcone REST API.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=position.js.map

package/dist/api/types/position.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"position.js","sourceRoot":"","sources":["../../../src/api/types/position.ts"],"names":[],"mappings":";AAAA;;GAEG","sourcesContent":["/**\n * Position-related types for the Lightcone REST API.\n */\n\n/**\n * Outcome balance in a position.\n */\nexport interface OutcomeBalance {\n  /** Outcome index */\n  outcome_index: number;\n  /** Conditional token address */\n  conditional_token: string;\n  /** Total balance as decimal string */\n  balance: string;\n  /** Idle balance (not on book) as decimal string */\n  balance_idle: string;\n  /** Balance on order book as decimal string */\n  balance_on_book: string;\n}\n\n/**\n * User position in a market.\n */\nexport interface Position {\n  /** Database ID */\n  id: number;\n  /** Position PDA address */\n  position_pubkey: string;\n  /** Position owner */\n  owner: string;\n  /** Market pubkey */\n  market_pubkey: string;\n  /** Outcome balances */\n  outcomes: OutcomeBalance[];\n  /** Creation timestamp */\n  created_at: string;\n  /** Last update timestamp */\n  updated_at: string;\n}\n\n/**\n * Response for GET /api/users/{user_pubkey}/positions.\n */\nexport interface PositionsResponse {\n  /** Position owner */\n  owner: string;\n  /** Total markets with positions */\n  total_markets: number;\n  /** User positions */\n  positions: Position[];\n}\n\n/**\n * Response for GET /api/users/{user_pubkey}/markets/{market_pubkey}/positions.\n */\nexport interface MarketPositionsResponse {\n  /** Position owner */\n  owner: string;\n  /** Market pubkey */\n  market_pubkey: string;\n  /** Positions in this market */\n  positions: Position[];\n}\n"]}

package/dist/api/types/price_history.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Price history types for the Lightcone REST API.
+ */
+import { Resolution } from "../../shared";
+/**
+ * Price point data.
+ */
+export interface PricePoint {
+    /** Timestamp (milliseconds) */
+    t: number;
+    /** Midpoint price as decimal string */
+    m: string;
+    /** Open price (only with include_ohlcv) as decimal string */
+    o?: string;
+    /** High price (only with include_ohlcv) as decimal string */
+    h?: string;
+    /** Low price (only with include_ohlcv) as decimal string */
+    l?: string;
+    /** Close price (only with include_ohlcv) as decimal string */
+    c?: string;
+    /** Volume (only with include_ohlcv) as decimal string */
+    v?: string;
+    /** Best bid (only with include_ohlcv) as decimal string */
+    bb?: string;
+    /** Best ask (only with include_ohlcv) as decimal string */
+    ba?: string;
+}
+/**
+ * Query parameters for GET /api/price-history.
+ */
+export interface PriceHistoryParams {
+    /** Orderbook identifier (required) */
+    orderbook_id: string;
+    /** Candle resolution */
+    resolution?: Resolution;
+    /** Start timestamp (milliseconds) */
+    from?: number;
+    /** End timestamp (milliseconds) */
+    to?: number;
+    /** Pagination cursor */
+    cursor?: number;
+    /** Max results (1-1000) */
+    limit?: number;
+    /** Include full OHLCV data */
+    include_ohlcv?: boolean;
+}
+/**
+ * Create new PriceHistoryParams with required orderbook_id.
+ */
+export declare function createPriceHistoryParams(orderbook_id: string): PriceHistoryParams;
+/**
+ * Response for GET /api/price-history.
+ */
+export interface PriceHistoryResponse {
+    /** Orderbook ID */
+    orderbook_id: string;
+    /** Resolution used */
+    resolution: string;
+    /** Whether OHLCV data is included */
+    include_ohlcv: boolean;
+    /** Price points */
+    prices: PricePoint[];
+    /** Next pagination cursor */
+    next_cursor?: number;
+    /** Whether more results exist */
+    has_more: boolean;
+}
+//# sourceMappingURL=price_history.d.ts.map

package/dist/api/types/price_history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"price_history.d.ts","sourceRoot":"","sources":["../../../src/api/types/price_history.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,+BAA+B;IAC/B,CAAC,EAAE,MAAM,CAAC;IACV,uCAAuC;IACvC,CAAC,EAAE,MAAM,CAAC;IACV,6DAA6D;IAC7D,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,6DAA6D;IAC7D,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,4DAA4D;IAC5D,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,8DAA8D;IAC9D,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,yDAAyD;IACzD,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,2DAA2D;IAC3D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,2DAA2D;IAC3D,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,wBAAwB;IACxB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,wBAAwB;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,MAAM,GAAG,kBAAkB,CAEjF;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,mBAAmB;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,sBAAsB;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,aAAa,EAAE,OAAO,CAAC;IACvB,mBAAmB;IACnB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iCAAiC;IACjC,QAAQ,EAAE,OAAO,CAAC;CACnB"}

package/dist/api/types/price_history.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * Price history types for the Lightcone REST API.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPriceHistoryParams = createPriceHistoryParams;
+/**
+ * Create new PriceHistoryParams with required orderbook_id.
+ */
+function createPriceHistoryParams(orderbook_id) {
+    return { orderbook_id };
+}
+//# sourceMappingURL=price_history.js.map

package/dist/api/types/price_history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"price_history.js","sourceRoot":"","sources":["../../../src/api/types/price_history.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAmDH,4DAEC;AALD;;GAEG;AACH,SAAgB,wBAAwB,CAAC,YAAoB;IAC3D,OAAO,EAAE,YAAY,EAAE,CAAC;AAC1B,CAAC","sourcesContent":["/**\n * Price history types for the Lightcone REST API.\n */\n\nimport { Resolution } from \"../../shared\";\n\n/**\n * Price point data.\n */\nexport interface PricePoint {\n  /** Timestamp (milliseconds) */\n  t: number;\n  /** Midpoint price as decimal string */\n  m: string;\n  /** Open price (only with include_ohlcv) as decimal string */\n  o?: string;\n  /** High price (only with include_ohlcv) as decimal string */\n  h?: string;\n  /** Low price (only with include_ohlcv) as decimal string */\n  l?: string;\n  /** Close price (only with include_ohlcv) as decimal string */\n  c?: string;\n  /** Volume (only with include_ohlcv) as decimal string */\n  v?: string;\n  /** Best bid (only with include_ohlcv) as decimal string */\n  bb?: string;\n  /** Best ask (only with include_ohlcv) as decimal string */\n  ba?: string;\n}\n\n/**\n * Query parameters for GET /api/price-history.\n */\nexport interface PriceHistoryParams {\n  /** Orderbook identifier (required) */\n  orderbook_id: string;\n  /** Candle resolution */\n  resolution?: Resolution;\n  /** Start timestamp (milliseconds) */\n  from?: number;\n  /** End timestamp (milliseconds) */\n  to?: number;\n  /** Pagination cursor */\n  cursor?: number;\n  /** Max results (1-1000) */\n  limit?: number;\n  /** Include full OHLCV data */\n  include_ohlcv?: boolean;\n}\n\n/**\n * Create new PriceHistoryParams with required orderbook_id.\n */\nexport function createPriceHistoryParams(orderbook_id: string): PriceHistoryParams {\n  return { orderbook_id };\n}\n\n/**\n * Response for GET /api/price-history.\n */\nexport interface PriceHistoryResponse {\n  /** Orderbook ID */\n  orderbook_id: string;\n  /** Resolution used */\n  resolution: string;\n  /** Whether OHLCV data is included */\n  include_ohlcv: boolean;\n  /** Price points */\n  prices: PricePoint[];\n  /** Next pagination cursor */\n  next_cursor?: number;\n  /** Whether more results exist */\n  has_more: boolean;\n}\n"]}

package/dist/api/types/trade.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Trade-related types for the Lightcone REST API.
+ */
+/**
+ * Trade side (API returns uppercase strings).
+ */
+export type TradeSide = "BID" | "ASK";
+/**
+ * Executed trade information.
+ */
+export interface Trade {
+    /** Trade ID */
+    id: number;
+    /** Orderbook ID */
+    orderbook_id: string;
+    /** Taker's pubkey */
+    taker_pubkey: string;
+    /** Maker's pubkey */
+    maker_pubkey: string;
+    /** Trade side ("BID" or "ASK") */
+    side: TradeSide;
+    /** Trade size as decimal string */
+    size: string;
+    /** Trade price as decimal string */
+    price: string;
+    /** Taker fee as decimal string */
+    taker_fee: string;
+    /** Maker fee as decimal string */
+    maker_fee: string;
+    /** Execution timestamp (milliseconds since epoch) */
+    executed_at: number;
+}
+/**
+ * Query parameters for GET /api/trades.
+ */
+export interface TradesParams {
+    /** Orderbook identifier (required) */
+    orderbook_id: string;
+    /** Filter by user pubkey */
+    user_pubkey?: string;
+    /** Start timestamp (milliseconds) */
+    from?: number;
+    /** End timestamp (milliseconds) */
+    to?: number;
+    /** Pagination cursor (trade ID) */
+    cursor?: number;
+    /** Max results (1-500) */
+    limit?: number;
+}
+/**
+ * Create new TradesParams with required orderbook_id.
+ */
+export declare function createTradesParams(orderbook_id: string): TradesParams;
+/**
+ * Response for GET /api/trades.
+ */
+export interface TradesResponse {
+    /** Orderbook ID */
+    orderbook_id: string;
+    /** Trade list */
+    trades: Trade[];
+    /** Next pagination cursor */
+    next_cursor?: number;
+    /** Whether more results exist */
+    has_more: boolean;
+}
+//# sourceMappingURL=trade.d.ts.map

package/dist/api/types/trade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trade.d.ts","sourceRoot":"","sources":["../../../src/api/types/trade.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,KAAK,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,eAAe;IACf,EAAE,EAAE,MAAM,CAAC;IACX,mBAAmB;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,qBAAqB;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,qBAAqB;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,IAAI,EAAE,SAAS,CAAC;IAChB,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,sCAAsC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,4BAA4B;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,YAAY,CAErE;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,mBAAmB;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB;IACjB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iCAAiC;IACjC,QAAQ,EAAE,OAAO,CAAC;CACnB"}

package/dist/api/types/trade.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * Trade-related types for the Lightcone REST API.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTradesParams = createTradesParams;
+/**
+ * Create new TradesParams with required orderbook_id.
+ */
+function createTradesParams(orderbook_id) {
+    return { orderbook_id };
+}
+//# sourceMappingURL=trade.js.map

package/dist/api/types/trade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trade.js","sourceRoot":"","sources":["../../../src/api/types/trade.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAsDH,gDAEC;AALD;;GAEG;AACH,SAAgB,kBAAkB,CAAC,YAAoB;IACrD,OAAO,EAAE,YAAY,EAAE,CAAC;AAC1B,CAAC","sourcesContent":["/**\n * Trade-related types for the Lightcone REST API.\n */\n\n/**\n * Trade side (API returns uppercase strings).\n */\nexport type TradeSide = \"BID\" | \"ASK\";\n\n/**\n * Executed trade information.\n */\nexport interface Trade {\n  /** Trade ID */\n  id: number;\n  /** Orderbook ID */\n  orderbook_id: string;\n  /** Taker's pubkey */\n  taker_pubkey: string;\n  /** Maker's pubkey */\n  maker_pubkey: string;\n  /** Trade side (\"BID\" or \"ASK\") */\n  side: TradeSide;\n  /** Trade size as decimal string */\n  size: string;\n  /** Trade price as decimal string */\n  price: string;\n  /** Taker fee as decimal string */\n  taker_fee: string;\n  /** Maker fee as decimal string */\n  maker_fee: string;\n  /** Execution timestamp (milliseconds since epoch) */\n  executed_at: number;\n}\n\n/**\n * Query parameters for GET /api/trades.\n */\nexport interface TradesParams {\n  /** Orderbook identifier (required) */\n  orderbook_id: string;\n  /** Filter by user pubkey */\n  user_pubkey?: string;\n  /** Start timestamp (milliseconds) */\n  from?: number;\n  /** End timestamp (milliseconds) */\n  to?: number;\n  /** Pagination cursor (trade ID) */\n  cursor?: number;\n  /** Max results (1-500) */\n  limit?: number;\n}\n\n/**\n * Create new TradesParams with required orderbook_id.\n */\nexport function createTradesParams(orderbook_id: string): TradesParams {\n  return { orderbook_id };\n}\n\n/**\n * Response for GET /api/trades.\n */\nexport interface TradesResponse {\n  /** Orderbook ID */\n  orderbook_id: string;\n  /** Trade list */\n  trades: Trade[];\n  /** Next pagination cursor */\n  next_cursor?: number;\n  /** Whether more results exist */\n  has_more: boolean;\n}\n"]}

package/dist/api/validation.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Input validation utilities for the Lightcone REST API.
+ */
+/** Maximum allowed pagination limit */
+export declare const MAX_PAGINATION_LIMIT = 500;
+/** Default request timeout in milliseconds */
+export declare const DEFAULT_TIMEOUT_MS = 30000;
+/**
+ * Validate a Solana public key (Base58-encoded).
+ * Uses @solana/web3.js PublicKey for proper validation.
+ * @throws {ApiError} If the value is not a valid Solana pubkey
+ */
+export declare function validatePubkey(value: string, fieldName: string): void;
+/**
+ * Validate an Ed25519 signature (128 hex characters).
+ * @throws {ApiError} If the signature is invalid
+ */
+export declare function validateSignature(signature: string): void;
+/**
+ * Validate pagination limit (1-500).
+ * @throws {ApiError} If the limit is out of bounds
+ */
+export declare function validateLimit(limit: number | undefined): void;
+//# sourceMappingURL=validation.d.ts.map

package/dist/api/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/api/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,uCAAuC;AACvC,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAExC,8CAA8C;AAC9C,eAAO,MAAM,kBAAkB,QAAQ,CAAC;AAExC;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CASrE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CASzD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAI7D"}

package/dist/api/validation.js

@@ -0,0 +1,53 @@
+"use strict";
+/**
+ * Input validation utilities for the Lightcone REST API.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_TIMEOUT_MS = exports.MAX_PAGINATION_LIMIT = void 0;
+exports.validatePubkey = validatePubkey;
+exports.validateSignature = validateSignature;
+exports.validateLimit = validateLimit;
+const web3_js_1 = require("@solana/web3.js");
+const error_1 = require("./error");
+/** Maximum allowed pagination limit */
+exports.MAX_PAGINATION_LIMIT = 500;
+/** Default request timeout in milliseconds */
+exports.DEFAULT_TIMEOUT_MS = 30000;
+/**
+ * Validate a Solana public key (Base58-encoded).
+ * Uses @solana/web3.js PublicKey for proper validation.
+ * @throws {ApiError} If the value is not a valid Solana pubkey
+ */
+function validatePubkey(value, fieldName) {
+    if (!value || value.length === 0) {
+        throw error_1.ApiError.invalidParameter(`${fieldName} cannot be empty`);
+    }
+    try {
+        new web3_js_1.PublicKey(value);
+    }
+    catch {
+        throw error_1.ApiError.invalidParameter(`${fieldName} is not a valid Solana public key`);
+    }
+}
+/**
+ * Validate an Ed25519 signature (128 hex characters).
+ * @throws {ApiError} If the signature is invalid
+ */
+function validateSignature(signature) {
+    if (signature.length !== 128) {
+        throw error_1.ApiError.invalidParameter(`Signature must be 128 hex characters, got ${signature.length}`);
+    }
+    if (!/^[0-9a-fA-F]+$/.test(signature)) {
+        throw error_1.ApiError.invalidParameter("Signature must contain only hex characters");
+    }
+}
+/**
+ * Validate pagination limit (1-500).
+ * @throws {ApiError} If the limit is out of bounds
+ */
+function validateLimit(limit) {
+    if (limit !== undefined && (limit < 1 || limit > exports.MAX_PAGINATION_LIMIT)) {
+        throw error_1.ApiError.invalidParameter(`Limit must be 1-${exports.MAX_PAGINATION_LIMIT}`);
+    }
+}
+//# sourceMappingURL=validation.js.map

package/dist/api/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/api/validation.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAgBH,wCASC;AAMD,8CASC;AAMD,sCAIC;AAhDD,6CAA4C;AAC5C,mCAAmC;AAEnC,uCAAuC;AAC1B,QAAA,oBAAoB,GAAG,GAAG,CAAC;AAExC,8CAA8C;AACjC,QAAA,kBAAkB,GAAG,KAAK,CAAC;AAExC;;;;GAIG;AACH,SAAgB,cAAc,CAAC,KAAa,EAAE,SAAiB;IAC7D,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,MAAM,gBAAQ,CAAC,gBAAgB,CAAC,GAAG,SAAS,kBAAkB,CAAC,CAAC;IAClE,CAAC;IACD,IAAI,CAAC;QACH,IAAI,mBAAS,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,gBAAQ,CAAC,gBAAgB,CAAC,GAAG,SAAS,mCAAmC,CAAC,CAAC;IACnF,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAgB,iBAAiB,CAAC,SAAiB;IACjD,IAAI,SAAS,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QAC7B,MAAM,gBAAQ,CAAC,gBAAgB,CAC7B,6CAA6C,SAAS,CAAC,MAAM,EAAE,CAChE,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QACtC,MAAM,gBAAQ,CAAC,gBAAgB,CAAC,4CAA4C,CAAC,CAAC;IAChF,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAgB,aAAa,CAAC,KAAyB;IACrD,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,4BAAoB,CAAC,EAAE,CAAC;QACvE,MAAM,gBAAQ,CAAC,gBAAgB,CAAC,mBAAmB,4BAAoB,EAAE,CAAC,CAAC;IAC7E,CAAC;AACH,CAAC","sourcesContent":["/**\n * Input validation utilities for the Lightcone REST API.\n */\n\nimport { PublicKey } from \"@solana/web3.js\";\nimport { ApiError } from \"./error\";\n\n/** Maximum allowed pagination limit */\nexport const MAX_PAGINATION_LIMIT = 500;\n\n/** Default request timeout in milliseconds */\nexport const DEFAULT_TIMEOUT_MS = 30000;\n\n/**\n * Validate a Solana public key (Base58-encoded).\n * Uses @solana/web3.js PublicKey for proper validation.\n * @throws {ApiError} If the value is not a valid Solana pubkey\n */\nexport function validatePubkey(value: string, fieldName: string): void {\n  if (!value || value.length === 0) {\n    throw ApiError.invalidParameter(`${fieldName} cannot be empty`);\n  }\n  try {\n    new PublicKey(value);\n  } catch {\n    throw ApiError.invalidParameter(`${fieldName} is not a valid Solana public key`);\n  }\n}\n\n/**\n * Validate an Ed25519 signature (128 hex characters).\n * @throws {ApiError} If the signature is invalid\n */\nexport function validateSignature(signature: string): void {\n  if (signature.length !== 128) {\n    throw ApiError.invalidParameter(\n      `Signature must be 128 hex characters, got ${signature.length}`\n    );\n  }\n  if (!/^[0-9a-fA-F]+$/.test(signature)) {\n    throw ApiError.invalidParameter(\"Signature must contain only hex characters\");\n  }\n}\n\n/**\n * Validate pagination limit (1-500).\n * @throws {ApiError} If the limit is out of bounds\n */\nexport function validateLimit(limit: number | undefined): void {\n  if (limit !== undefined && (limit < 1 || limit > MAX_PAGINATION_LIMIT)) {\n    throw ApiError.invalidParameter(`Limit must be 1-${MAX_PAGINATION_LIMIT}`);\n  }\n}\n"]}