@0xmonaco/core 0.1.6 → 0.1.7

package/README.md

@@ -11,7 +11,7 @@ This package is currently in **early development** (v0.1.0).
 
 ---
 
-Core SDK implementation for interacting with Monaco Protocol. This SDK provides a comprehensive implementation with Vault and Trading APIs, featuring EIP-712 intent signatures and secure API Gateway integration.
+Core SDK implementation for interacting with Monaco Protocol. This SDK provides a comprehensive implementation with Authentication, Vault, Trading, Market, and Profile APIs, featuring JWT authentication and secure API Gateway integration.
 
 ## Installation
 
@@ -21,25 +21,38 @@ npm install @0xmonaco/core
 
 ## Features
 
+### 🔐 **Authentication**
+- **JWT-based Authentication**: Secure token-based authentication
+- **Wallet Signature Verification**: EIP-712 signature-based login
+- **Token Refresh**: Automatic token refresh and management
+- **Session Management**: Secure session handling
+
 ### 🏦 **Vault Operations**
 - **Token Approvals**: ERC20 token approvals for vault usage
-- **Deposits**: Secure token deposits with EIP-712 signatures
+- **Deposits**: Secure token deposits with signature validation
 - **Withdrawals**: Token withdrawals with cryptographic validation
 - **Balance Queries**: Real-time vault balance tracking
-- **Allowance Management**: Efficient approval checking and management
 
 ### 📈 **Trading Operations**
-- **Order Types**: Limit (with timeInForce: GTC/IOC/FOK), Market, Post-Only orders
-- **Order Management**: Place, replace (cancel + new), and cancel orders
-- **Position Management**: Close positions with slippage control
-- **Order Queries**: Open orders, order history, and individual order details
-- **Real-time Updates**: Live order status and execution tracking
+- **Order Types**: Limit and Market orders
+- **Order Management**: Place, replace, and cancel orders
+- **Order Queries**: Paginated orders, order history, and individual order details
+- **Real-time Updates**: WebSocket support for live order updates
+
+### 📊 **Market Data**
+- **Trading Pairs**: Complete trading pair metadata
+- **Market Information**: Fees, tick sizes, order limits
+- **Pair Discovery**: Search and filter available markets
+
+### 👤 **Profile Management**
+- **User Profiles**: Account information and settings
+- **Sub-accounts**: Multi-account management
+- **Balance Tracking**: Cross-platform balance monitoring
 
 ### 🔐 **Security Features**
-- **EIP-712 Signatures**: Type-safe, structured data signing
-- **Intent-Based Authorization**: Every action explicitly authorized
+- **JWT Authentication**: Secure API access with token validation
+- **EIP-712 Signatures**: Type-safe, structured data signing for authentication
 - **API Gateway Integration**: Secure communication with Monaco backend
-- **Nonce Protection**: Replay attack prevention
 - **TLS Encryption**: Secure API communications
 
 ## Test Setup
@@ -110,80 +123,103 @@ const testnetConfig = NETWORK_ENDPOINTS.testnet; // Atlantic-2 testnet
 
 ```typescript
 import { MonacoSDK } from "@0xmonaco/core";
+import { createWalletClient, http } from "viem";
+import { privateKeyToAccount } from "viem/accounts";
+
+// Initialize the SDK with wallet client
+const account = privateKeyToAccount("0x...");
+const walletClient = createWalletClient({
+  account,
+  transport: http()
+});
 
-// Initialize the SDK with private key
 const monaco = new MonacoSDK({
-  privateKey: "0x...", // Your private key
+  walletClient,
   network: "mainnet", // or "testnet"
 });
 
+// Authentication
+async function authExample() {
+  // Login with client ID
+  const authState = await monaco.login("your-client-id");
+  console.log("Authenticated:", authState.user);
+  
+  // Check authentication status
+  console.log("Is authenticated:", monaco.isAuthenticated());
+}
+
+// Market Data
+async function marketExample() {
+  // Get all trading pairs
+  const pairs = await monaco.market.getTradingPairs();
+  console.log("Available pairs:", pairs.length);
+  
+  // Get specific trading pair
+  const btcPair = await monaco.market.getTradingPairBySymbol("BTC/USDC");
+  console.log("BTC pair:", btcPair?.symbol, btcPair?.maker_fee_bps);
+}
+
 // Vault Operations
 async function vaultExample() {
   // Check vault balance
   const balance = await monaco.vault.getBalance("0x..."); // token address
   console.log("Vault balance:", balance.formatted, balance.symbol);
 
-  // Check if approval is needed
-  const needsApproval = await monaco.vault.needsApproval("0x...", parseEther("100"));
-  if (needsApproval) {
-    // Approve vault to spend tokens
-    const approval = await monaco.vault.approve("0x...", parseEther("1000"));
-    console.log("Approval transaction:", approval.hash);
-  }
+  // Approve vault to spend tokens
+  const approval = await monaco.vault.approve("0x...", parseEther("1000"));
+  console.log("Approval transaction:", approval.hash);
 
   // Deposit tokens
   const result = await monaco.vault.deposit("0x...", parseEther("100"));
   console.log("Deposit transaction:", result.hash);
+  
+  // Withdraw tokens
+  const withdrawal = await monaco.vault.withdraw("0x...", parseEther("50"));
+  console.log("Withdrawal transaction:", withdrawal.hash);
 }
 
 // Trading Operations
 async function tradingExample() {
   // Place a limit order
   const order = await monaco.trading.placeLimitOrder(
-    "ETH-USDC", // market
-    "buy", // side
-    parseEther("1.0"), // size (1 ETH)
-    parseUnits("2000", 6) // price (2000 USDC)
+    "BTC/USDC", // market
+    "BUY", // side
+    "0.001", // quantity
+    "50000" // price
   );
-  console.log("Order placed:", order.orderId);
+  console.log("Order placed:", order.order_id);
 
-  // Place a market order with slippage protection
+  // Place a market order
   const marketOrder = await monaco.trading.placeMarketOrder(
-    "ETH-USDC",
-    "sell",
-    parseEther("0.5"),
-    { slippageToleranceBps: 50 } // 0.5% max slippage (50 basis points)
-  );
-  console.log("Market order placed:", marketOrder.orderId);
-
-  // Place a limit order with IOC time in force
-  const iocOrder = await monaco.trading.placeLimitOrder(
-    "ETH-USDC",
-    "buy",
-    parseEther("1.0"),
-    parseUnits("2000", 6),
-    { timeInForce: "IOC" } // Immediate-or-Cancel
+    "BTC/USDC",
+    "SELL",
+    "0.001"
   );
-  console.log("IOC order placed:", iocOrder.orderId);
-
-  // Get open orders
-  const openOrders = await monaco.trading.getOpenOrders({ market: "ETH-USDC" });
-  console.log("Open orders:", openOrders.length);
+  console.log("Market order placed:", marketOrder.order_id);
+
+  // Get paginated orders
+  const orders = await monaco.trading.getPaginatedOrders({
+    status: "PENDING",
+    trading_pair: "BTC/USDC",
+    page: 1,
+    page_size: 10
+  });
+  console.log("Orders:", orders.data.length);
 
-  // Replace an order (cancel + new)
+  // Replace an order
   const replaceResult = await monaco.trading.replaceOrder("order-id", {
-    market: "ETH-USDC",
-    side: "buy",
-    size: parseEther("2.0"),
-    price: parseUnits("2100", 6),
-    type: "limit",
-    timeInForce: "FOK" // Fill-or-Kill
+    quantity: "0.002",
+    price: "51000"
   });
-  console.log("Order replaced:", replaceResult.orderId);
+  console.log("Order replaced:", replaceResult.order_id);
 
   // Cancel an order
   const cancelResult = await monaco.trading.cancelOrder("order-id");
   console.log("Order cancelled:", cancelResult.status);
+  
+  // Get specific order
+  const orderDetails = await monaco.trading.getOrder("order-id");
+  console.log("Order details:", orderDetails.order);
 }
 ```
 
@@ -195,12 +231,31 @@ The main SDK class that provides access to all protocol features.
 
 ```typescript
 class MonacoSDK {
+  readonly applications: ApplicationsAPI;
+  readonly auth: AuthAPI;
   readonly vault: VaultAPI;
   readonly trading: TradingAPI;
+  readonly market: MarketAPI;
+  readonly profile: ProfileAPI;
+  readonly websocket: OrderWebSocketClient;
   readonly walletClient: WalletClient;
   readonly publicClient: PublicClient;
 
   constructor(config: SDKConfig);
+  
+  // Authentication
+  login(clientId: string): Promise<AuthState>;
+  logout(): Promise<void>;
+  refreshAuth(): Promise<AuthState>;
+  getAuthState(): AuthState | undefined;
+  isAuthenticated(): boolean;
+  
+  // Network utilities
+  isConnected(): boolean;
+  getAccountAddress(): string;
+  getNetwork(): Network;
+  getChainId(): number;
+  waitForTransaction(hash: string, confirmations?: number, timeout?: number): Promise<TransactionReceipt>;
 }
 ```
 
@@ -208,17 +263,14 @@ class MonacoSDK {
 
 ```typescript
 interface SDKConfig {
-  /** Private key as hex string (0x-prefixed) */
-  privateKey?: Hex;
-  
-  /** Viem Account for advanced account management */
-  signer?: PrivateKeyAccount;
-  
-  /** Custom Account implementation (overrides privateKey/signer) */
-  account?: Account;
+  /** Wallet client for signing operations */
+  walletClient: WalletClient;
   
   /** Optional network override (defaults to 'mainnet') */
   network?: Network;
+  
+  /** Optional transport for the public client */
+  transport?: Transport;
 }
 ```
 
@@ -227,58 +279,73 @@ interface SDKConfig {
 The vault API provides secure token management operations:
 
 ```typescript
-interface VaultAPI {
-  // Token approvals
-  approve(token: string, amount: bigint): Promise<TransactionResult>;
+interface VaultAPI extends BaseAPI {
+  // Vault address management
+  setVaultAddress(vaultAddress: Address): void;
+  getVaultAddress(): Address | undefined;
   
-  // Deposit and withdrawal
-  deposit(token: string, amount: bigint): Promise<TransactionResult>;
-  withdraw(token: string, amount: bigint): Promise<TransactionResult>;
+  // Token operations
+  approve(token: string, amount: bigint, autoWait?: boolean): Promise<TransactionResult>;
+  deposit(token: string, amount: bigint, autoWait?: boolean): Promise<TransactionResult>;
+  withdraw(token: string, amount: bigint, autoWait?: boolean): Promise<TransactionResult>;
   
-  // Balance and allowance queries
+  // Balance queries
   getBalance(token: string): Promise<Balance>;
-  getAllowance(token: string): Promise<bigint>;
-  needsApproval(token: string, amount: bigint): Promise<boolean>;
 }
 ```
 
 ### Trading API
 
-The trading API provides comprehensive order management with support for different execution policies:
-
-#### Order Types and Execution Policies
-
-- **Limit Orders**: Standard limit orders with optional `timeInForce` parameter
-  - `GTC` (Good Till Cancelled): Default behavior, order stays active until filled or cancelled
-  - `IOC` (Immediate or Cancel): Order fills what it can immediately, then cancels the rest
-  - `FOK` (Fill or Kill): Order must fill completely or not at all
-
-- **Market Orders**: Immediate execution with optional slippage protection
-- **Post-Only Orders**: Limit orders that never execute immediately, only add liquidity
-
-#### Order Management
-
-- **Replace Orders**: Cancel existing order and place a new one (atomic operation)
-- **Cancel Orders**: Cancel any open order by ID
+The trading API provides comprehensive order management:
 
 ```typescript
-interface TradingAPI {
+interface TradingAPI extends BaseAPI {
   // Order placement
-  placeLimitOrder(market: string, side: OrderSide, size: bigint, price: bigint, options?: { timeInForce?: TimeInForce }): Promise<OrderResponse>;
-  placeMarketOrder(market: string, side: OrderSide, size: bigint, options?: { slippageToleranceBps?: number }): Promise<OrderResponse>;
-  placePostOnlyOrder(market: string, side: OrderSide, size: bigint, price: bigint): Promise<OrderResponse>;
+  placeLimitOrder(
+    market: string, 
+    side: OrderSide, 
+    quantity: string, 
+    price: string, 
+    options?: {
+      tradingMode?: string;
+      useMasterBalance?: boolean;
+      expirationDate?: string;
+    }
+  ): Promise<CreateOrderResponse>;
+  
+  placeMarketOrder(
+    market: string, 
+    side: OrderSide, 
+    quantity: string, 
+    options?: { tradingMode?: string; }
+  ): Promise<CreateOrderResponse>;
   
   // Order management
-  replaceOrder(originalOrderId: string, newOrder: { market: string; side: OrderSide; size: bigint; price?: bigint; type: OrderType; timeInForce?: TimeInForce }): Promise<OrderResponse>;
   cancelOrder(orderId: string): Promise<CancelOrderResponse>;
-  
-  // Position management
-  closePosition(market: string, options?: { maxSlippage?: number }): Promise<ClosePositionResponse>;
+  replaceOrder(
+    orderId: string, 
+    newOrder: {
+      price?: string;
+      quantity: string;
+      useMasterBalance?: boolean;
+    }
+  ): Promise<ReplaceOrderResponse>;
   
   // Order queries
-  getOrder(orderId: string): Promise<Order>;
-  getOpenOrders(params?: GetOpenOrdersParams): Promise<Order[]>;
-  getOrderHistory(params: OrderHistoryParams): Promise<PaginatedOrders>;
+  getPaginatedOrders(params?: GetPaginatedOrdersParams): Promise<GetPaginatedOrdersResponse>;
+  getOrder(orderId: string): Promise<GetOrderResponse>;
+}
+```
+
+### Market API
+
+The market API provides access to trading pair metadata:
+
+```typescript
+interface MarketAPI extends BaseAPI {
+  // Market data
+  getTradingPairs(): Promise<TradingPair[]>;
+  getTradingPairBySymbol(symbol: string): Promise<TradingPair | undefined>;
 }
 ```
 
@@ -322,11 +389,16 @@ try {
 packages/core/
 ├── src/                   # Source code
 │   ├── api/               # API implementations
+│   │   ├── applications/  # Applications API
+│   │   ├── auth/          # Authentication API
+│   │   ├── base.ts        # Base API class
+│   │   ├── market/        # Market data API
+│   │   ├── profile/       # Profile management API
+│   │   ├── trading/       # Trading operations API
 │   │   ├── vault/         # Vault operations API
-│   │   │   └── api.ts     # Vault API implementation with comprehensive docs
-│   │   └── trading/       # Trading operations API
-│   │       └── api.ts     # Trading API implementation with comprehensive docs
-│   ├── chains.ts          # Chain definitions (Sei mainnet/testnet)
+│   │   ├── websocket/     # WebSocket client
+│   │   └── index.ts       # API exports
+│   ├── constants/         # Constants and configurations
 │   ├── errors.ts          # Error classes and codes
 │   ├── networks.ts        # Network endpoint configurations
 │   ├── sdk.ts             # Main SDK implementation
@@ -371,22 +443,22 @@ pnpm lint --filter @0xmonaco/core
 
 ## Security Features
 
-### EIP-712 Intent Signatures
-- **Type-safe signing**: Structured data with domain separation
-- **Intent-based authorization**: Every action explicitly authorized
-- **Nonce protection**: Prevents replay attacks
-- **Domain validation**: Ensures signatures are valid for specific contracts
+### JWT Authentication
+- **Token-based security**: Secure JWT tokens for API access
+- **EIP-712 login**: Wallet signature-based authentication
+- **Automatic refresh**: Seamless token renewal
+- **Session management**: Secure session handling
 
 ### API Gateway Integration
 - **Secure communication**: TLS encryption for all API calls
-- **Signature validation**: Backend validates all signed intents
+- **Token validation**: Backend validates all JWT tokens
 - **Rate limiting**: Protection against abuse
 - **Audit logging**: Complete transaction history
 
 ### On-chain Security
 - **Smart contract validation**: All operations validated on-chain
+- **Signature verification**: EIP-712 signatures for authentication
 - **Multi-signature support**: Advanced security for institutional users
-- **Emergency stops**: Circuit breakers for critical situations
 
 ## Performance Considerations
 

package/dist/api/index.d.ts

@@ -7,6 +7,7 @@ export * from "./applications";
 export * from "./base";
 export * from "./profile";
 export * from "./trading";
+export * from "./market";
 export * from "./vault";
 export * from "./websocket";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC"}

package/dist/api/index.js

@@ -7,6 +7,7 @@ export * from "./applications";
 export * from "./base";
 export * from "./profile";
 export * from "./trading";
+export * from "./market";
 export * from "./vault";
 export * from "./websocket";
 //# sourceMappingURL=index.js.map

package/dist/api/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC"}

package/dist/api/market/api.d.ts

@@ -0,0 +1,12 @@
+import type { MarketAPI, TradingPair } from "@0xmonaco/types";
+import { BaseAPI } from "../base";
+/**
+ * Market API Implementation
+ *
+ * Provides read-only market metadata endpoints such as trading pair listings.
+ */
+export declare class MarketAPIImpl extends BaseAPI implements MarketAPI {
+    getTradingPairs(): Promise<TradingPair[]>;
+    getTradingPairBySymbol(symbol: string): Promise<TradingPair | undefined>;
+}
+//# sourceMappingURL=api.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/api/market/api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,SAAS,EACT,WAAW,EAGX,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC;;;;GAIG;AACH,qBAAa,aAAc,SAAQ,OAAQ,YAAW,SAAS;IACxD,eAAe,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAczC,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;CAa9E"}

package/dist/api/market/api.js

@@ -0,0 +1,31 @@
+import { BaseAPI } from "../base";
+/**
+ * Market API Implementation
+ *
+ * Provides read-only market metadata endpoints such as trading pair listings.
+ */
+export class MarketAPIImpl extends BaseAPI {
+    async getTradingPairs() {
+        try {
+            const response = await this.makePublicRequest("/api/v1/market/pairs");
+            return response.data.data;
+        }
+        catch (error) {
+            // For now, return empty array on error - could throw APIError instead
+            console.error("Failed to fetch trading pairs:", error);
+            return [];
+        }
+    }
+    async getTradingPairBySymbol(symbol) {
+        try {
+            const response = await this.makePublicRequest(`/api/v1/market/pairs/${encodeURIComponent(symbol)}`);
+            return response.data;
+        }
+        catch (error) {
+            // Return undefined if not found or on error
+            console.error(`Failed to fetch trading pair ${symbol}:`, error);
+            return undefined;
+        }
+    }
+}
+//# sourceMappingURL=api.js.map

package/dist/api/market/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../src/api/market/api.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC;;;;GAIG;AACH,MAAM,OAAO,aAAc,SAAQ,OAAO;IACzC,KAAK,CAAC,eAAe;QACpB,IAAI,CAAC;YACJ,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAC5C,sBAAsB,CACtB,CAAC;YAEF,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;QAC3B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,sEAAsE;YACtE,OAAO,CAAC,KAAK,CAAC,gCAAgC,EAAE,KAAK,CAAC,CAAC;YACvD,OAAO,EAAE,CAAC;QACX,CAAC;IACF,CAAC;IAED,KAAK,CAAC,sBAAsB,CAAC,MAAc;QAC1C,IAAI,CAAC;YACJ,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAC5C,wBAAwB,kBAAkB,CAAC,MAAM,CAAC,EAAE,CACpD,CAAC;YAEF,OAAO,QAAQ,CAAC,IAAI,CAAC;QACtB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,4CAA4C;YAC5C,OAAO,CAAC,KAAK,CAAC,gCAAgC,MAAM,GAAG,EAAE,KAAK,CAAC,CAAC;YAChE,OAAO,SAAS,CAAC;QAClB,CAAC;IACF,CAAC;CACD"}

package/dist/api/market/index.d.ts

@@ -0,0 +1,3 @@
+export { MarketAPIImpl } from "./api";
+export type { MarketAPI } from "@0xmonaco/types";
+//# sourceMappingURL=index.d.ts.map

package/dist/api/market/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/market/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/api/market/index.js

@@ -0,0 +1,2 @@
+export { MarketAPIImpl } from "./api";
+//# sourceMappingURL=index.js.map

package/dist/api/market/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api/market/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC"}

package/dist/api/trading/api.d.ts

@@ -24,15 +24,33 @@
  * const openOrders = await tradingAPI.getOpenOrders({ market: "ETH-USD" });
  * ```
  */
-import type { TradingAPI, CreateOrderResponse, CancelOrderResponse, UpdateOrderResponse, ReplaceOrderResponse, GetPaginatedOrdersResponse, GetPaginatedOrdersParams, GetOrderResponse, OrderSide } from "@0xmonaco/types";
+import type { TradingAPI, CreateOrderResponse, CancelOrderResponse, ReplaceOrderResponse, GetPaginatedOrdersResponse, GetPaginatedOrdersParams, GetOrderResponse, OrderSide, MarketAPI } from "@0xmonaco/types";
 import { BaseAPI } from "../base";
 export declare class TradingAPIImpl extends BaseAPI implements TradingAPI {
+    private marketAPI;
     /**
      * Creates a new TradingAPI instance.
      *
+     * @param marketAPI - The market API instance for symbol validation
      * @param apiUrl - The base URL for the Monaco API Gateway
      */
-    constructor(apiUrl: string);
+    constructor(marketAPI: MarketAPI, apiUrl: string);
+    /**
+     * Validates if a trading symbol exists and is active.
+     *
+     * @param symbol - The trading pair symbol to validate (e.g., "BTC-USDC")
+     * @returns Promise resolving to true if valid and active, false if invalid/inactive.
+     *          Returns true on API errors (fail-open approach to avoid blocking trades).
+     *
+     * @example
+     * ```typescript
+     * const isValid = await tradingAPI.validateSymbol("BTC-USDC");
+     * if (!isValid) {
+     *   throw new Error("Invalid trading pair");
+     * }
+     * ```
+     */
+    private validateSymbol;
     /**
      * Places a limit order on the order book.
      *
@@ -122,33 +140,6 @@ export declare class TradingAPIImpl extends BaseAPI implements TradingAPI {
      * ```
      */
     cancelOrder(orderId: string): Promise<CancelOrderResponse>;
-    /**
-     * Updates an existing order (price and/or quantity).
-     *
-     * Updates an open order by changing its price or quantity.
-     * This creates a new order and cancels the old one.
-     *
-     * @param orderId - The ID of the order to update
-     * @param updates - Fields to update
-     * @param updates.price - New price (optional)
-     * @param updates.quantity - New quantity (optional)
-     * @returns Promise resolving to UpdateOrderResponse with update details
-     * @throws {OrderError} When update fails
-     * @throws {APIError} When API communication fails
-     *
-     * @example
-     * ```typescript
-     * const result = await tradingAPI.updateOrder("order_123", {
-     *   price: "2100.00",
-     *   quantity: "2.0"
-     * });
-     * console.log(`Order updated: ${result.order_id}`);
-     * ```
-     */
-    updateOrder(orderId: string, updates: {
-        price?: string;
-        quantity?: string;
-    }): Promise<UpdateOrderResponse>;
     replaceOrder(orderId: string, newOrder: {
         price?: string;
         quantity: string;

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

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/api/trading/api.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,0BAA0B,EAC1B,wBAAwB,EACxB,gBAAgB,EAChB,SAAS,EAEV,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,qBAAa,cAAe,SAAQ,OAAQ,YAAW,UAAU;IAC/D;;;;OAIG;gBACS,MAAM,EAAE,MAAM;IAI1B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuCG;IACG,eAAe,CACnB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QACR,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,GACA,OAAO,CAAC,mBAAmB,CAAC;IA6B/B;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACG,gBAAgB,CACpB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;QACR,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GACA,OAAO,CAAC,mBAAmB,CAAC;IA2B/B;;;;;;;;;;;;;;;;OAgBG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAsBhE;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACG,WAAW,CACf,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;QACP,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GACA,OAAO,CAAC,mBAAmB,CAAC;IA8BzB,YAAY,CAChB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE;QACR,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,gBAAgB,CAAC,EAAE,OAAO,CAAC;KAC5B,GACA,OAAO,CAAC,oBAAoB,CAAC;IA+BhC;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACG,kBAAkB,CAAC,MAAM,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAmChG;;;;;;;;;;;;;;;;;OAiBG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAgB3D"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/api/trading/api.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,0BAA0B,EAC1B,wBAAwB,EACxB,gBAAgB,EAChB,SAAS,EAET,SAAS,EACV,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,qBAAa,cAAe,SAAQ,OAAQ,YAAW,UAAU;IAC/D,OAAO,CAAC,SAAS,CAAY;IAE9B;;;;;OAKG;gBACS,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM;IAK/C;;;;;;;;;;;;;;OAcG;YACW,cAAc;IAW5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuCG;IACG,eAAe,CACnB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QACR,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,GACA,OAAO,CAAC,mBAAmB,CAAC;IAuC/B;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACG,gBAAgB,CACpB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;QACR,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GACA,OAAO,CAAC,mBAAmB,CAAC;IAqC/B;;;;;;;;;;;;;;;;OAgBG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAuB1D,YAAY,CAChB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE;QACR,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,gBAAgB,CAAC,EAAE,OAAO,CAAC;KAC5B,GACA,OAAO,CAAC,oBAAoB,CAAC;IA+BhC;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACG,kBAAkB,CAAC,MAAM,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAmChG;;;;;;;;;;;;;;;;;OAiBG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAgB3D"}