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

package/README.md

@@ -66,7 +66,7 @@ The v2 flow covers the full trading lifecycle: onboarding, deposits, trading, an
 1. Check onboarding   →  isUserOnboarded(party)
    If NOT onboarded   →  onboardUser(party)
 
-2. Deposit funds      →  depositFunds({ sender, assetId, amount, holdingCids, ... })
+2. Deposit funds      →  deposit(amount, symbol)
 
 3. Check balance      →  getTradingBalance()
 
@@ -98,35 +98,30 @@ if (!delegation) {
 
 ### 2. Deposit Funds
 
-Deposit funds into the user's trading balance. Use `prepareDepositHoldings` to resolve the holdings for the deposit amount.
+The simplest way to deposit is the `deposit()` helper — pass the amount and symbol, and it handles everything:
 
 ```javascript
-import { prepareDepositHoldings, depositFunds } from "@temple-digital-group/temple-canton-js";
-
-// Prepare holdings for the deposit
-const depositOpts = await prepareDepositHoldings(100, "USDCx");
+import { deposit } from "@temple-digital-group/temple-canton-js";
 
-// Submit the deposit
-const result = await depositFunds(depositOpts);
+const result = await deposit(100, "USDCx");
+// or
+const result = await deposit(10, "CC");
 ```
 
-`depositFunds` accepts:
+`deposit()` requires the wallet adapter to be connected. It:
+1. Checks your CC balance to ensure at least 10 CC is reserved for transaction fees
+2. For utility deposits (USDCx, CBTC), verifies you have enough of the token **and** 10 CC for fees
+3. Selects the right UTXOs from your wallet
+4. Submits the deposit allocation
+
+If you need more control, use `prepareDepositHoldings` + `depositFunds` directly:
 
-| Option           | Required | Description                                                |
-| ---------------- | -------- | ---------------------------------------------------------- |
-| `sender`         | Yes      | Party allocating the assets                                |
-| `assetId`        | Yes      | Instrument symbol (`USDCx`, `Amulet`, `CBTC`)              |
-| `amount`         | Yes      | Amount to allocate                                         |
-| `holdingCids`    | Yes      | Holding contract IDs that fund the allocation              |
-| `receiver`       | No       | Counterparty (defaults to sender)                          |
-| `settlementId`   | No       | Reference ID for the settlement                            |
-| `transferLegId`  | No       | Unique ID for this transfer leg                            |
-| `allocateBefore` | No       | ISO timestamp; allocation deadline (default: +1h)          |
-| `settleBefore`   | No       | ISO timestamp; settlement deadline (default: +2h)          |
-| `disclosures`    | No       | Pre-fetched Amulet disclosures (for FE without API access) |
-| `userId`         | No       | User ID (falls back to wallet adapter / config)            |
+```javascript
+import { prepareDepositHoldings, depositFunds } from "@temple-digital-group/temple-canton-js";
 
-For Amulet deposits, the SDK fetches disclosures automatically. You can also pass them manually via `opts.disclosures`.
+const depositOpts = await prepareDepositHoldings(100, "USDCx");
+const result = await depositFunds(depositOpts);
+```
 
 ### 3. Trading Balance
 
@@ -144,14 +139,21 @@ 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: "Amulet/USDCx",
+	symbol: "CC/USDCx",
 	side: "buy",
 	quantity: 10.5,
 	price: 1.25,
 	order_type: "limit",
-	expires_at: new Date(Date.now() + 24 * 60 * 60 * 1000).toISOString(),
 });
+
+// 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 }
 ```
 
 ### 5. Cancel Orders
@@ -159,11 +161,15 @@ const result = await createOrderRequest({
 ```javascript
 import { cancelOrder, cancelAllOrders } from "@temple-digital-group/temple-canton-js";
 
-// Cancel a specific order
-await cancelOrder("order-id-123");
+// Cancel a single 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: "Amulet/USDCx" });
+await cancelAllOrders({ symbol: "CC/USDCx" });
 
 // Cancel ALL orders
 await cancelAllOrders();
@@ -368,8 +374,9 @@ const unsubOrder = ws.onUserEvent("user_order", (data) => { ... });
 
 | Function                                  | Provider | Description                                           |
 | ----------------------------------------- | -------- | ----------------------------------------------------- |
-| `prepareDepositHoldings(amount, assetId)` | **W**    | Resolve holdings for a deposit amount                 |
-| `depositFunds(opts)`                      | **W**    | Deposit funds into the user's trading balance         |
+| `deposit(amount, symbol)`                 | **W**    | Deposit funds (validates balance, reserves 10 CC for fees) |
+| `prepareDepositHoldings(amount, assetId)` | **W**    | Resolve holdings for a deposit amount (low-level)     |
+| `depositFunds(opts)`                      | **W**    | Submit deposit allocation (low-level)                 |
 | `withdrawFunds({ asset_id, amount })`     | **W**    | Withdraw available trading balance back to wallet     |
 | `emergencyWithdrawFunds(opts)`            | **W**    | Cancel all orders and withdraw everything immediately |
 
@@ -413,13 +420,15 @@ const unsubOrder = ws.onUserEvent("user_order", (data) => { ... });
 
 #### Trading
 
-| Function                    | Description                                            |
-| --------------------------- | ------------------------------------------------------ |
-| `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`)         |
+| 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                  |
+| `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`)          |
 
 #### Withdrawals
 

package/package.json

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