@temple-digital-group/temple-canton-js 1.0.38-beta → 1.0.39-beta.0

package/dist/api/index.d.ts

@@ -1,5 +1,5 @@
-import type { ApiError, LoginUser, LoginResponse, RefreshResponse, Ticker, OrderBook, OrderBookOptions, SymbolConfig, OpenInterest, Trade, RecentTradesOptions, ActiveOrder, ActiveOrdersOptions, CancelOrderResponse, CancelAllOrdersOptions, CancelAllOrdersResponse, DisclosuresResponse } from "./types.js";
-export type { ApiError, LoginUser, LoginResponse, RefreshResponse, Ticker, OrderBook, OrderBookOptions, SymbolConfig, OpenInterest, Trade, RecentTradesOptions, ActiveOrder, ActiveOrdersOptions, CancelOrderResponse, CancelAllOrdersOptions, CancelAllOrdersResponse, DisclosuresResponse, };
+import type { ApiError, LoginUser, LoginResponse, RefreshResponse, 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, LoginUser, LoginResponse, RefreshResponse, Ticker, OrderBook, OrderBookOptions, SymbolConfig, OpenInterest, Trade, RecentTradesOptions, ActiveOrder, ActiveOrdersOptions, CancelOrderResponse, CancelAllOrdersOptions, CancelAllOrdersResponse, CreateOrderRequestResponse, DelegationResponse, WithdrawalResponse, WithdrawalStatusResponse, TradingBalanceResponse, AmuletDisclosure, DisclosuresResponse, };
 export { setApiKey, getUserId } from "./tokenStore.js";
 export { setWalletAdapter } from "../../src/config/index.js";
 /**
@@ -75,3 +75,30 @@ export declare function cancelAllOrders(options?: CancelAllOrdersOptions): Promi
  * @param partyId - Canton party ID
  */
 export declare function getDisclosures(partyId: string): Promise<DisclosuresResponse | ApiError>;
+/**
+ * Get the user's trading delegation status.
+ * The user ID is extracted from the JWT token automatically.
+ */
+export declare function getDelegation(): Promise<DelegationResponse | ApiError>;
+/**
+ * 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 declare function createOrderRequest(opts: CreateOrderRequestOpts): Promise<CreateOrderRequestResponse | ApiError>;
+/**
+ * Create a withdrawal request.
+ * @param assetId - Instrument symbol (e.g. "USDCx", "Amulet")
+ * @param amount - Amount to withdraw
+ */
+export declare function createWithdrawalRequest(assetId: string, amount: string | number): Promise<WithdrawalResponse | ApiError>;
+/**
+ * Get the status of a withdrawal request.
+ * @param requestId - The request ID returned by createWithdrawalRequest
+ */
+export declare function getWithdrawalRequestStatus(requestId: string | number): Promise<WithdrawalStatusResponse | ApiError>;
+/**
+ * Get the user's trading balances.
+ *
+ * GET /api/trading/balances
+ */
+export declare function getTradingBalance(): Promise<TradingBalanceResponse | ApiError>;

package/dist/api/index.js

@@ -176,13 +176,18 @@ export async function refreshAccessToken(refreshTokenOverride) {
 export function logout() {
     clearTokens();
 }
+// ── Helpers ──
+/** Normalize CC → Amulet in symbol strings (e.g. "CC/SBC" → "Amulet/SBC", "CC" → "Amulet") */
+function normalizeSymbol(symbol) {
+    return symbol.replace(/\bCC\b/g, "Amulet");
+}
 // ── Market Data ──
 /**
  * Get ticker data for one or all trading pairs.
  * @param symbol - Optional symbol filter (e.g., "Amulet/USDCx")
  */
 export async function getTicker(symbol) {
-    return authenticatedGet("/api/v1/market/ticker", { symbol });
+    return authenticatedGet("/api/v1/market/ticker", { symbol: symbol ? normalizeSymbol(symbol) : undefined });
 }
 /**
  * Get the order book for a trading pair.
@@ -194,7 +199,7 @@ export async function getOrderBook(symbol, options = {}) {
         return { error: true, status: null, code: "INVALID_PARAMS", message: "Symbol is required." };
     }
     return authenticatedGet("/api/v1/market/orderbook", {
-        symbol,
+        symbol: normalizeSymbol(symbol),
         levels: options.levels,
         precision: options.precision,
     });
@@ -207,7 +212,7 @@ export async function getSymbolConfig(symbol) {
     if (!symbol) {
         return { error: true, status: null, code: "INVALID_PARAMS", message: "Symbol is required." };
     }
-    return authenticatedGet("/api/v1/trading/symbol-config", { symbol });
+    return authenticatedGet("/api/v1/trading/symbol-config", { symbol: normalizeSymbol(symbol) });
 }
 /**
  * Get open interest for a trading pair.
@@ -217,7 +222,7 @@ export async function getOpenInterest(symbol) {
     if (!symbol) {
         return { error: true, status: null, code: "INVALID_PARAMS", message: "Symbol is required." };
     }
-    return authenticatedGet("/api/v1/market/open-interest", { symbol });
+    return authenticatedGet("/api/v1/market/open-interest", { symbol: normalizeSymbol(symbol) });
 }
 /**
  * Get recent trades for a trading pair.
@@ -229,7 +234,7 @@ export async function getRecentTrades(symbol, options = {}) {
         return { error: true, status: null, code: "INVALID_PARAMS", message: "Symbol is required." };
     }
     return authenticatedGet("/api/v1/market/trades", {
-        symbol,
+        symbol: normalizeSymbol(symbol),
         limit: options.limit,
     });
 }
@@ -240,7 +245,7 @@ export async function getRecentTrades(symbol, options = {}) {
  */
 export async function getActiveOrders(options = {}) {
     return authenticatedGet("/api/trading/orders/active", {
-        symbol: options.symbol,
+        symbol: options.symbol ? normalizeSymbol(options.symbol) : undefined,
         limit: options.limit,
     });
 }
@@ -259,7 +264,7 @@ export async function cancelOrder(orderId) {
  * @param options - Optional symbol filter
  */
 export async function cancelAllOrders(options = {}) {
-    return authenticatedPost("/api/v1/trading/orders/cancel-all", options.symbol ? { symbol: options.symbol } : undefined);
+    return authenticatedPost("/api/trading/orders/cancel-all", options.symbol ? { symbol: normalizeSymbol(options.symbol) } : undefined);
 }
 // ── Disclosures ──
 /**
@@ -273,3 +278,57 @@ export async function getDisclosures(partyId) {
     }
     return authenticatedGet("/api/amulet/disclosures", { partyId });
 }
+// ── Delegation ──
+/**
+ * Get the user's trading delegation status.
+ * The user ID is extracted from the JWT token automatically.
+ */
+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) {
+    const { symbol: rawSymbol, side, quantity, price, order_type = "limit", 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 (expires_at)
+        body.expires_at = expires_at;
+    return authenticatedPost("/api/trading/orders", body);
+}
+// ── Withdrawals ──
+/**
+ * Create a withdrawal request.
+ * @param assetId - Instrument symbol (e.g. "USDCx", "Amulet")
+ * @param amount - Amount to withdraw
+ */
+export async function createWithdrawalRequest(assetId, amount) {
+    if (!assetId || amount == null) {
+        return { error: true, status: null, code: "INVALID_PARAMS", message: "asset_id and amount are required." };
+    }
+    return authenticatedPost("/api/trading/withdrawals", { asset_id: normalizeSymbol(assetId), amount: String(amount) });
+}
+/**
+ * Get the status of a withdrawal request.
+ * @param requestId - The request ID returned by createWithdrawalRequest
+ */
+export async function getWithdrawalRequestStatus(requestId) {
+    if (requestId == null) {
+        return { error: true, status: null, code: "INVALID_PARAMS", message: "requestId is required." };
+    }
+    return authenticatedGet(`/api/trading/withdrawals/${encodeURIComponent(requestId)}`);
+}
+/**
+ * Get the user's trading balances.
+ *
+ * GET /api/trading/balances
+ */
+export async function getTradingBalance() {
+    return authenticatedGet("/api/trading/balances");
+}

package/dist/api/types.d.ts

@@ -98,8 +98,62 @@ export interface CancelAllOrdersResponse {
     already_queued_count: number;
     order_ids: string[];
 }
+export interface Delegation {
+    user_id: number;
+    delegation_cid: string;
+    created_at: string;
+    updated_at: string;
+}
+export interface DelegationResponse {
+    delegation: Delegation;
+}
+export interface CreateOrderRequestOpts {
+    symbol: string;
+    side: string;
+    quantity: number;
+    price: number;
+    order_type?: string;
+    expires_at?: string;
+}
+export interface CreateOrderRequestResponse {
+    [key: string]: unknown;
+}
+export interface WithdrawalRequest {
+    asset_id: string;
+    amount: string;
+}
+export interface WithdrawalResponse {
+    [key: string]: unknown;
+}
+export interface WithdrawalStatusResponse {
+    [key: string]: unknown;
+}
+export interface TradingBalanceResponse {
+    [key: string]: unknown;
+}
+export interface AmuletDisclosure {
+    contractId: string;
+    createdEventBlob: string;
+    synchronizerId: string;
+    templateId: string;
+}
+export interface ChoiceContextValue {
+    tag: string;
+    value: string;
+}
+export interface ChoiceContext {
+    choiceContextData: {
+        values: Record<string, ChoiceContextValue>;
+    };
+    disclosedContracts: AmuletDisclosure[];
+}
+export interface DisclosuresData {
+    choiceContext: ChoiceContext;
+    factoryId: string;
+    transferKind: string;
+}
 export interface DisclosuresResponse {
-    disclosures: Record<string, unknown>;
+    disclosures: DisclosuresData;
 }
 export interface ApiError {
     error: true;

package/package.json

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

package/src/api/index.ts

@@ -27,6 +27,13 @@ import type {
 	CancelOrderResponse,
 	CancelAllOrdersOptions,
 	CancelAllOrdersResponse,
+	CreateOrderRequestOpts,
+	CreateOrderRequestResponse,
+	DelegationResponse,
+	WithdrawalResponse,
+	WithdrawalStatusResponse,
+	TradingBalanceResponse,
+	AmuletDisclosure,
 	DisclosuresResponse,
 } from "./types.js";
 
@@ -48,6 +55,12 @@ export type {
 	CancelOrderResponse,
 	CancelAllOrdersOptions,
 	CancelAllOrdersResponse,
+	CreateOrderRequestResponse,
+	DelegationResponse,
+	WithdrawalResponse,
+	WithdrawalStatusResponse,
+	TradingBalanceResponse,
+	AmuletDisclosure,
 	DisclosuresResponse,
 };
 export { setApiKey, getUserId } from "./tokenStore.js";
@@ -245,6 +258,13 @@ export function logout(): void {
 	clearTokens();
 }
 
+// ── Helpers ──
+
+/** Normalize CC → Amulet in symbol strings (e.g. "CC/SBC" → "Amulet/SBC", "CC" → "Amulet") */
+function normalizeSymbol(symbol: string): string {
+	return symbol.replace(/\bCC\b/g, "Amulet");
+}
+
 // ── Market Data ──
 
 /**
@@ -252,7 +272,7 @@ export function logout(): void {
  * @param symbol - Optional symbol filter (e.g., "Amulet/USDCx")
  */
 export async function getTicker(symbol?: string): Promise<Ticker | Ticker[] | ApiError> {
-	return authenticatedGet("/api/v1/market/ticker", { symbol });
+	return authenticatedGet("/api/v1/market/ticker", { symbol: symbol ? normalizeSymbol(symbol) : undefined });
 }
 
 /**
@@ -265,7 +285,7 @@ export async function getOrderBook(symbol: string, options: OrderBookOptions = {
 		return { error: true, status: null, code: "INVALID_PARAMS", message: "Symbol is required." };
 	}
 	return authenticatedGet("/api/v1/market/orderbook", {
-		symbol,
+		symbol: normalizeSymbol(symbol),
 		levels: options.levels,
 		precision: options.precision,
 	});
@@ -279,7 +299,7 @@ export async function getSymbolConfig(symbol: string): Promise<SymbolConfig | Ap
 	if (!symbol) {
 		return { error: true, status: null, code: "INVALID_PARAMS", message: "Symbol is required." };
 	}
-	return authenticatedGet("/api/v1/trading/symbol-config", { symbol });
+	return authenticatedGet("/api/v1/trading/symbol-config", { symbol: normalizeSymbol(symbol) });
 }
 
 /**
@@ -290,7 +310,7 @@ export async function getOpenInterest(symbol: string): Promise<OpenInterest | Ap
 	if (!symbol) {
 		return { error: true, status: null, code: "INVALID_PARAMS", message: "Symbol is required." };
 	}
-	return authenticatedGet("/api/v1/market/open-interest", { symbol });
+	return authenticatedGet("/api/v1/market/open-interest", { symbol: normalizeSymbol(symbol) });
 }
 
 /**
@@ -303,7 +323,7 @@ export async function getRecentTrades(symbol: string, options: RecentTradesOptio
 		return { error: true, status: null, code: "INVALID_PARAMS", message: "Symbol is required." };
 	}
 	return authenticatedGet("/api/v1/market/trades", {
-		symbol,
+		symbol: normalizeSymbol(symbol),
 		limit: options.limit,
 	});
 }
@@ -316,7 +336,7 @@ export async function getRecentTrades(symbol: string, options: RecentTradesOptio
  */
 export async function getActiveOrders(options: ActiveOrdersOptions = {}): Promise<ActiveOrder[] | ApiError> {
 	return authenticatedGet("/api/trading/orders/active", {
-		symbol: options.symbol,
+		symbol: options.symbol ? normalizeSymbol(options.symbol) : undefined,
 		limit: options.limit,
 	});
 }
@@ -337,7 +357,7 @@ export async function cancelOrder(orderId: string): Promise<CancelOrderResponse
  * @param options - Optional symbol filter
  */
 export async function cancelAllOrders(options: CancelAllOrdersOptions = {}): Promise<CancelAllOrdersResponse | ApiError> {
-	return authenticatedPost("/api/v1/trading/orders/cancel-all", options.symbol ? { symbol: options.symbol } : undefined);
+	return authenticatedPost("/api/trading/orders/cancel-all", options.symbol ? { symbol: normalizeSymbol(options.symbol) } : undefined);
 }
 
 // ── Disclosures ──
@@ -353,3 +373,64 @@ export async function getDisclosures(partyId: string): Promise<DisclosuresRespon
 	}
 	return authenticatedGet("/api/amulet/disclosures", { partyId });
 }
+
+// ── Delegation ──
+
+/**
+ * Get the user's trading delegation status.
+ * The user ID is extracted from the JWT token automatically.
+ */
+export async function getDelegation(): Promise<DelegationResponse | ApiError> {
+	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: CreateOrderRequestOpts): Promise<CreateOrderRequestResponse | ApiError> {
+	const { symbol: rawSymbol, side, quantity, price, order_type = "limit", 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 (expires_at) body.expires_at = expires_at;
+	return authenticatedPost("/api/trading/orders", body);
+}
+
+// ── Withdrawals ──
+
+/**
+ * Create a withdrawal request.
+ * @param assetId - Instrument symbol (e.g. "USDCx", "Amulet")
+ * @param amount - Amount to withdraw
+ */
+export async function createWithdrawalRequest(assetId: string, amount: string | number): Promise<WithdrawalResponse | ApiError> {
+	if (!assetId || amount == null) {
+		return { error: true, status: null, code: "INVALID_PARAMS", message: "asset_id and amount are required." };
+	}
+	return authenticatedPost("/api/trading/withdrawals", { asset_id: normalizeSymbol(assetId), amount: String(amount) });
+}
+
+/**
+ * Get the status of a withdrawal request.
+ * @param requestId - The request ID returned by createWithdrawalRequest
+ */
+export async function getWithdrawalRequestStatus(requestId: string | number): Promise<WithdrawalStatusResponse | ApiError> {
+	if (requestId == null) {
+		return { error: true, status: null, code: "INVALID_PARAMS", message: "requestId is required." };
+	}
+	return authenticatedGet(`/api/trading/withdrawals/${encodeURIComponent(requestId)}`);
+}
+
+/**
+ * Get the user's trading balances.
+ *
+ * GET /api/trading/balances
+ */
+export async function getTradingBalance(): Promise<TradingBalanceResponse | ApiError> {
+	return authenticatedGet("/api/trading/balances");
+}

package/src/api/types.ts

@@ -120,10 +120,84 @@ export interface CancelAllOrdersResponse {
 	order_ids: string[];
 }
 
+// ── Delegation ──
+
+export interface Delegation {
+	user_id: number;
+	delegation_cid: string;
+	created_at: string;
+	updated_at: string;
+}
+
+export interface DelegationResponse {
+	delegation: Delegation;
+}
+
+// ── Order Requests ──
+
+export interface CreateOrderRequestOpts {
+	symbol: string;
+	side: string;
+	quantity: number;
+	price: number;
+	order_type?: string;
+	expires_at?: string;
+}
+
+export interface CreateOrderRequestResponse {
+	[key: string]: unknown;
+}
+
+// ── Withdrawals ──
+
+export interface WithdrawalRequest {
+	asset_id: string;
+	amount: string;
+}
+
+export interface WithdrawalResponse {
+	[key: string]: unknown;
+}
+
+export interface WithdrawalStatusResponse {
+	[key: string]: unknown;
+}
+
+// ── Trading Balances ──
+
+export interface TradingBalanceResponse {
+	[key: string]: unknown;
+}
+
 // ── Disclosures ──
 
+export interface AmuletDisclosure {
+	contractId: string;
+	createdEventBlob: string;
+	synchronizerId: string;
+	templateId: string;
+}
+
+export interface ChoiceContextValue {
+	tag: string;
+	value: string;
+}
+
+export interface ChoiceContext {
+	choiceContextData: {
+		values: Record<string, ChoiceContextValue>;
+	};
+	disclosedContracts: AmuletDisclosure[];
+}
+
+export interface DisclosuresData {
+	choiceContext: ChoiceContext;
+	factoryId: string;
+	transferKind: string;
+}
+
 export interface DisclosuresResponse {
-	disclosures: Record<string, unknown>;
+	disclosures: DisclosuresData;
 }
 
 // ── Errors ──