@temple-digital-group/temple-canton-js 2.0.0-beta.7 → 2.0.0-beta.9

package/README.md

@@ -139,7 +139,6 @@ Use this to check available funds before placing orders or withdrawals.
 ```javascript
 import { createOrderRequest } from "@temple-digital-group/temple-canton-js";
 
-// Single order
 const result = await createOrderRequest({
 	symbol: "CC/USDCx",
 	side: "buy",
@@ -148,12 +147,15 @@ const result = await createOrderRequest({
 	order_type: "limit",
 });
 
-// Batch orders (max 20)
-const batchResult = await createOrderRequest([
-	{ symbol: "CC/USDCx", side: "buy", quantity: 100, price: 1.25, order_type: "limit" },
-	{ symbol: "CC/USDCx", side: "sell", quantity: 50, price: 1.50, order_type: "limit" },
-]);
-// Returns { success, request_ids, count, message }
+// Post-only order (rejected if it would match immediately)
+const postOnly = await createOrderRequest({
+	symbol: "CC/USDCx",
+	side: "buy",
+	quantity: 10.5,
+	price: 1.25,
+	order_type: "limit",
+	order_subtype: "post_only",
+});
 ```
 
 ### 5. Cancel Orders
@@ -161,13 +163,9 @@ const batchResult = await createOrderRequest([
 ```javascript
 import { cancelOrder, cancelAllOrders } from "@temple-digital-group/temple-canton-js";
 
-// Cancel a single order
+// Cancel a specific order
 await cancelOrder("ord_abc123");
 
-// Cancel multiple orders (max 20)
-await cancelOrder(["ord_abc123", "ord_def456", "ord_ghi789"]);
-// Returns { success, canceled, already_queued, not_found, message }
-
 // Cancel all orders for a symbol
 await cancelAllOrders({ symbol: "CC/USDCx" });
 
@@ -422,10 +420,8 @@ const unsubOrder = ws.onUserEvent("user_order", (data) => { ... });
 
 | Function                            | Description                                            |
 | ----------------------------------- | ------------------------------------------------------ |
-| `createOrderRequest(opts)`          | Place a single order                                   |
-| `createOrderRequest(opts[])`        | Place up to 20 orders in one request                   |
-| `cancelOrder(orderId)`              | Cancel a single order                                  |
-| `cancelOrder(orderIds[])`           | Cancel up to 20 orders in one request                  |
+| `createOrderRequest(opts)`          | Place a buy/sell order via the trading backend          |
+| `cancelOrder(orderId)`              | Cancel a specific order                                |
 | `cancelAllOrders(options?)`         | Cancel all orders (options: `symbol` filter)            |
 | `getTradingBalance()`               | Get user's trading balance (unlocked/locked/in-flight)  |
 | `getActiveOrders(options?)`         | Get active orders (options: `symbol`, `limit`)          |

package/dist/api/index.d.ts

@@ -1,5 +1,5 @@
-import type { ApiError, Ticker, OrderBook, OrderBookOptions, SymbolConfig, OpenInterest, Trade, RecentTradesOptions, ActiveOrder, ActiveOrdersOptions, CancelOrderResponse, BatchCancelOrdersResponse, CancelAllOrdersOptions, CancelAllOrdersResponse, CreateOrderRequestOpts, CreateOrderRequestResponse, BatchCreateOrderRequestResponse, DelegationResponse, WithdrawalResponse, WithdrawalStatusResponse, TradingBalanceResponse, AmuletDisclosure, DisclosuresResponse } from "./types.js";
-export type { ApiError, Ticker, OrderBook, OrderBookOptions, SymbolConfig, OpenInterest, Trade, RecentTradesOptions, ActiveOrder, ActiveOrdersOptions, CancelOrderResponse, BatchCancelOrdersResponse, CancelAllOrdersOptions, CancelAllOrdersResponse, CreateOrderRequestResponse, BatchCreateOrderRequestResponse, DelegationResponse, WithdrawalResponse, WithdrawalStatusResponse, TradingBalanceResponse, AmuletDisclosure, DisclosuresResponse, };
+import type { ApiError, Ticker, OrderBook, OrderBookOptions, SymbolConfig, OpenInterest, Trade, RecentTradesOptions, ActiveOrder, ActiveOrdersOptions, CancelOrderResponse, CancelAllOrdersOptions, CancelAllOrdersResponse, CreateOrderRequestOpts, CreateOrderRequestResponse, DelegationResponse, WithdrawalResponse, WithdrawalStatusResponse, TradingBalanceResponse, AmuletDisclosure, DisclosuresResponse } from "./types.js";
+export type { ApiError, Ticker, OrderBook, OrderBookOptions, SymbolConfig, OpenInterest, Trade, RecentTradesOptions, ActiveOrder, ActiveOrdersOptions, CancelOrderResponse, CancelAllOrdersOptions, CancelAllOrdersResponse, CreateOrderRequestResponse, DelegationResponse, WithdrawalResponse, WithdrawalStatusResponse, TradingBalanceResponse, AmuletDisclosure, DisclosuresResponse, };
 export { getUserId } from "./tokenStore.js";
 export { setWalletAdapter } from "../../src/config/index.js";
 /**
@@ -40,15 +40,10 @@ export declare function getRecentTrades(symbol: string, options?: RecentTradesOp
  */
 export declare function getActiveOrders(options?: ActiveOrdersOptions): Promise<ActiveOrder[] | ApiError>;
 /**
- * Cancel a single order by ID.
+ * Cancel a specific order by ID.
  * @param orderId - The order ID to cancel
  */
 export declare function cancelOrder(orderId: string): Promise<CancelOrderResponse | ApiError>;
-/**
- * Cancel multiple orders by ID (max 20).
- * @param orderIds - Array of order IDs to cancel
- */
-export declare function cancelOrder(orderIds: string[]): Promise<BatchCancelOrdersResponse | ApiError>;
 /**
  * Cancel all active orders, optionally filtered by symbol.
  * @param options - Optional symbol filter
@@ -66,10 +61,9 @@ export declare function getDisclosures(partyId: string): Promise<DisclosuresResp
 export declare function getDelegation(): Promise<DelegationResponse | ApiError>;
 /**
  * Create an order request (limit buy/sell) on the Temple trading backend.
- * @param opts - Single order or array of orders (max 20)
+ * @param opts - Order parameters: symbol, side, quantity, price, order_type, expires_at
  */
 export declare function createOrderRequest(opts: CreateOrderRequestOpts): Promise<CreateOrderRequestResponse | ApiError>;
-export declare function createOrderRequest(opts: CreateOrderRequestOpts[]): Promise<BatchCreateOrderRequestResponse | ApiError>;
 /**
  * Create a withdrawal request.
  * @param assetId - Instrument symbol (e.g. "USDCx", "Amulet")

package/dist/api/index.js

@@ -154,20 +154,15 @@ export async function getActiveOrders(options = {}) {
         limit: options.limit,
     });
 }
-export async function cancelOrder(orderIdOrIds) {
-    if (Array.isArray(orderIdOrIds)) {
-        if (orderIdOrIds.length === 0) {
-            return { error: true, status: null, code: "INVALID_PARAMS", message: "At least one order ID is required." };
-        }
-        if (orderIdOrIds.length > 20) {
-            return { error: true, status: null, code: "INVALID_PARAMS", message: "Maximum 20 order IDs per batch." };
-        }
-        return authenticatedPost("/api/trading/orders/cancel", { order_ids: orderIdOrIds });
-    }
-    if (!orderIdOrIds) {
+/**
+ * Cancel a specific order by ID.
+ * @param orderId - The order ID to cancel
+ */
+export async function cancelOrder(orderId) {
+    if (!orderId) {
         return { error: true, status: null, code: "INVALID_PARAMS", message: "Order ID is required." };
     }
-    return authenticatedPost("/api/trading/orders/cancel", { order_id: orderIdOrIds });
+    return authenticatedPost(`/api/trading/orders/${encodeURIComponent(orderId)}/cancel`);
 }
 /**
  * Cancel all active orders, optionally filtered by symbol.
@@ -195,29 +190,20 @@ export async function getDisclosures(partyId) {
 export async function getDelegation() {
     return authenticatedGet("/api/trading/delegation");
 }
+// ── Order Requests ──
+/**
+ * Create an order request (limit buy/sell) on the Temple trading backend.
+ * @param opts - Order parameters: symbol, side, quantity, price, order_type, expires_at
+ */
 export async function createOrderRequest(opts) {
-    if (Array.isArray(opts)) {
-        if (opts.length === 0) {
-            return { error: true, status: null, code: "INVALID_PARAMS", message: "At least one order is required." };
-        }
-        if (opts.length > 20) {
-            return { error: true, status: null, code: "INVALID_PARAMS", message: "Maximum 20 orders per batch." };
-        }
-        const body = opts.map((o) => {
-            const { symbol: rawSymbol, side, quantity, price, order_type = "limit", expires_at } = o;
-            const order = { symbol: normalizeSymbol(rawSymbol), side, quantity: Number(quantity), price: Number(price), order_type };
-            if (expires_at)
-                order.expires_at = expires_at;
-            return order;
-        });
-        return authenticatedPost("/api/trading/orders", body);
-    }
-    const { symbol: rawSymbol, side, quantity, price, order_type = "limit", expires_at } = opts || {};
+    const { symbol: rawSymbol, side, quantity, price, order_type = "limit", order_subtype, expires_at } = opts || {};
     if (!rawSymbol || !side || quantity == null || price == null) {
         return { error: true, status: null, code: "INVALID_PARAMS", message: "symbol, side, quantity, and price are required." };
     }
     const symbol = normalizeSymbol(rawSymbol);
     const body = { symbol, side, quantity: Number(quantity), price: Number(price), order_type };
+    if (order_subtype)
+        body.order_subtype = order_subtype;
     if (expires_at)
         body.expires_at = expires_at;
     return authenticatedPost("/api/trading/orders", body);

package/dist/api/types.d.ts

@@ -72,13 +72,6 @@ export interface CancelOrderResponse {
     already_queued: boolean;
     message: string;
 }
-export interface BatchCancelOrdersResponse {
-    success: boolean;
-    canceled: string[];
-    already_queued: string[];
-    not_found: string[];
-    message: string;
-}
 export interface CancelAllOrdersOptions {
     symbol?: string;
 }
@@ -103,14 +96,9 @@ export interface CreateOrderRequestOpts {
     quantity: number;
     price: number;
     order_type?: string;
+    order_subtype?: "post_only";
     expires_at?: string;
 }
-export interface BatchCreateOrderRequestResponse {
-    success: boolean;
-    request_ids: number[];
-    count: number;
-    message: string;
-}
 export interface CreateOrderRequestResponse {
     [key: string]: unknown;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@temple-digital-group/temple-canton-js",
-  "version": "2.0.0-beta.7",
+  "version": "2.0.0-beta.9",
   "description": "JavaScript library for interacting with Temple Canton blockchain",
   "type": "module",
   "main": "index.js",

package/src/api/index.ts

@@ -16,12 +16,10 @@ import type {
 	ActiveOrder,
 	ActiveOrdersOptions,
 	CancelOrderResponse,
-	BatchCancelOrdersResponse,
 	CancelAllOrdersOptions,
 	CancelAllOrdersResponse,
 	CreateOrderRequestOpts,
 	CreateOrderRequestResponse,
-	BatchCreateOrderRequestResponse,
 	DelegationResponse,
 	WithdrawalResponse,
 	WithdrawalStatusResponse,
@@ -43,11 +41,9 @@ export type {
 	ActiveOrder,
 	ActiveOrdersOptions,
 	CancelOrderResponse,
-	BatchCancelOrdersResponse,
 	CancelAllOrdersOptions,
 	CancelAllOrdersResponse,
 	CreateOrderRequestResponse,
-	BatchCreateOrderRequestResponse,
 	DelegationResponse,
 	WithdrawalResponse,
 	WithdrawalStatusResponse,
@@ -232,30 +228,14 @@ export async function getActiveOrders(options: ActiveOrdersOptions = {}): Promis
 }
 
 /**
- * Cancel a single order by ID.
+ * Cancel a specific order by ID.
  * @param orderId - The order ID to cancel
  */
-export async function cancelOrder(orderId: string): Promise<CancelOrderResponse | ApiError>;
-/**
- * Cancel multiple orders by ID (max 20).
- * @param orderIds - Array of order IDs to cancel
- */
-export async function cancelOrder(orderIds: string[]): Promise<BatchCancelOrdersResponse | ApiError>;
-export async function cancelOrder(orderIdOrIds: string | string[]): Promise<CancelOrderResponse | BatchCancelOrdersResponse | ApiError> {
-	if (Array.isArray(orderIdOrIds)) {
-		if (orderIdOrIds.length === 0) {
-			return { error: true, status: null, code: "INVALID_PARAMS", message: "At least one order ID is required." };
-		}
-		if (orderIdOrIds.length > 20) {
-			return { error: true, status: null, code: "INVALID_PARAMS", message: "Maximum 20 order IDs per batch." };
-		}
-		return authenticatedPost("/api/trading/orders/cancel", { order_ids: orderIdOrIds });
-	}
-
-	if (!orderIdOrIds) {
+export async function cancelOrder(orderId: string): Promise<CancelOrderResponse | ApiError> {
+	if (!orderId) {
 		return { error: true, status: null, code: "INVALID_PARAMS", message: "Order ID is required." };
 	}
-	return authenticatedPost("/api/trading/orders/cancel", { order_id: orderIdOrIds });
+	return authenticatedPost(`/api/trading/orders/${encodeURIComponent(orderId)}/cancel`);
 }
 
 /**
@@ -293,33 +273,16 @@ export async function getDelegation(): Promise<DelegationResponse | ApiError> {
 
 /**
  * Create an order request (limit buy/sell) on the Temple trading backend.
- * @param opts - Single order or array of orders (max 20)
+ * @param opts - Order parameters: symbol, side, quantity, price, order_type, expires_at
  */
-export async function createOrderRequest(opts: CreateOrderRequestOpts): Promise<CreateOrderRequestResponse | ApiError>;
-export async function createOrderRequest(opts: CreateOrderRequestOpts[]): Promise<BatchCreateOrderRequestResponse | ApiError>;
-export async function createOrderRequest(opts: CreateOrderRequestOpts | CreateOrderRequestOpts[]): Promise<CreateOrderRequestResponse | BatchCreateOrderRequestResponse | ApiError> {
-	if (Array.isArray(opts)) {
-		if (opts.length === 0) {
-			return { error: true, status: null, code: "INVALID_PARAMS", message: "At least one order is required." };
-		}
-		if (opts.length > 20) {
-			return { error: true, status: null, code: "INVALID_PARAMS", message: "Maximum 20 orders per batch." };
-		}
-		const body = opts.map((o) => {
-			const { symbol: rawSymbol, side, quantity, price, order_type = "limit", expires_at } = o;
-			const order: Record<string, unknown> = { symbol: normalizeSymbol(rawSymbol), side, quantity: Number(quantity), price: Number(price), order_type };
-			if (expires_at) order.expires_at = expires_at;
-			return order;
-		});
-		return authenticatedPost("/api/trading/orders", body as unknown as Record<string, unknown>);
-	}
-
-	const { symbol: rawSymbol, side, quantity, price, order_type = "limit", expires_at } = opts || {};
+export async function createOrderRequest(opts: CreateOrderRequestOpts): Promise<CreateOrderRequestResponse | ApiError> {
+	const { symbol: rawSymbol, side, quantity, price, order_type = "limit", order_subtype, expires_at } = opts || {};
 	if (!rawSymbol || !side || quantity == null || price == null) {
 		return { error: true, status: null, code: "INVALID_PARAMS", message: "symbol, side, quantity, and price are required." };
 	}
 	const symbol = normalizeSymbol(rawSymbol);
 	const body: Record<string, unknown> = { symbol, side, quantity: Number(quantity), price: Number(price), order_type };
+	if (order_subtype) body.order_subtype = order_subtype;
 	if (expires_at) body.expires_at = expires_at;
 	return authenticatedPost("/api/trading/orders", body);
 }

package/src/api/types.ts

@@ -87,14 +87,6 @@ export interface CancelOrderResponse {
 	message: string;
 }
 
-export interface BatchCancelOrdersResponse {
-	success: boolean;
-	canceled: string[];
-	already_queued: string[];
-	not_found: string[];
-	message: string;
-}
-
 export interface CancelAllOrdersOptions {
 	symbol?: string;
 }
@@ -127,15 +119,10 @@ export interface CreateOrderRequestOpts {
 	quantity: number;
 	price: number;
 	order_type?: string;
+	order_subtype?: "post_only";
 	expires_at?: string;
 }
 
-export interface BatchCreateOrderRequestResponse {
-	success: boolean;
-	request_ids: number[];
-	count: number;
-	message: string;
-}
 
 export interface CreateOrderRequestResponse {
 	[key: string]: unknown;