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

package/src/api/tokenStore.ts

@@ -1,30 +1,30 @@
-import config from "../../src/config/index.js";
-import type { AuthHeaders } from "./types.js";
-
-let userId: string | null = null;
-
-/**
- * Get the stored user ID, or null if not set.
- */
-export function getUserId(): string | null {
-	return userId;
-}
-
-/**
- * Set the user ID directly (e.g. from config at init time).
- */
-export function setUserId(id: string): void {
-	userId = id;
-}
-
-/**
- * Get the authorization header using the API key from config.
- * Returns null if no API key is configured.
- */
-export function getAuthHeader(): AuthHeaders | null {
-	const apiKey = config.API_KEY;
-	if (apiKey) {
-		return { "X-API-Key": apiKey };
-	}
-	return null;
-}
+import config from "../../src/config/index.js";
+import type { AuthHeaders } from "./types.js";
+
+let userId: string | null = null;
+
+/**
+ * Get the stored user ID, or null if not set.
+ */
+export function getUserId(): string | null {
+	return userId;
+}
+
+/**
+ * Set the user ID directly (e.g. from config at init time).
+ */
+export function setUserId(id: string): void {
+	userId = id;
+}
+
+/**
+ * Get the authorization header using the API key from config.
+ * Returns null if no API key is configured.
+ */
+export function getAuthHeader(): AuthHeaders | null {
+	const apiKey = config.API_KEY;
+	if (apiKey) {
+		return { "X-API-Key": apiKey };
+	}
+	return null;
+}

package/src/api/types.ts

@@ -1,195 +1,196 @@
-// ── Market Data ──
-
-export interface Ticker {
-	symbol: string;
-	last_price: string;
-	bid_price: string;
-	ask_price: string;
-	high_24h: string;
-	low_24h: string;
-	volume_24h: string;
-	change_24h: string;
-	change_pct_24h: string;
-	timestamp: string;
-}
-
-export interface OrderBookLevel {
-	price: string;
-	quantity: string;
-}
-
-export interface OrderBook {
-	symbol: string;
-	bids: OrderBookLevel[];
-	asks: OrderBookLevel[];
-	best_bid: string;
-	best_ask: string;
-	spread: string;
-	timestamp: string;
-}
-
-export interface OrderBookOptions {
-	levels?: number;
-	precision?: 2 | 4;
-}
-
-export interface SymbolConfig {
-	symbol: string;
-	paused: boolean;
-	max_decimals: number;
-	minimum_quantity: string;
-}
-
-export interface OpenInterest {
-	symbol: string;
-	bid_interest: string;
-	ask_interest: string;
-	bid_order_count: number;
-	ask_order_count: number;
-	timestamp: string;
-}
-
-export interface Trade {
-	trade_id: string;
-	symbol: string;
-	side: string;
-	quantity: string;
-	price: string;
-	timestamp: string;
-}
-
-export interface RecentTradesOptions {
-	limit?: number;
-}
-
-// ── Orders ──
-
-export interface ActiveOrder {
-	order_id: string;
-	symbol: string;
-	side: string;
-	quantity: string;
-	price: string;
-	status: string;
-	created_at: string;
-	updated_at: string;
-}
-
-export interface ActiveOrdersOptions {
-	symbol?: string;
-	limit?: number;
-}
-
-export interface CancelOrderResponse {
-	success: boolean;
-	order_id: string;
-	already_queued: boolean;
-	message: string;
-}
-
-export interface CancelAllOrdersOptions {
-	symbol?: string;
-}
-
-export interface CancelAllOrdersResponse {
-	success: boolean;
-	canceled_count: number;
-	already_queued_count: number;
-	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: DisclosuresData;
-}
-
-// ── Errors ──
-
-export interface ApiError {
-	error: true;
-	status: number | null;
-	code: string | null;
-	message: string;
-}
-
-// ── Auth ──
-
-export interface AuthHeaders {
-	"X-API-Key": string;
-}
+// ── Market Data ──
+
+export interface Ticker {
+	symbol: string;
+	last_price: string;
+	bid_price: string;
+	ask_price: string;
+	high_24h: string;
+	low_24h: string;
+	volume_24h: string;
+	change_24h: string;
+	change_pct_24h: string;
+	timestamp: string;
+}
+
+export interface OrderBookLevel {
+	price: string;
+	quantity: string;
+}
+
+export interface OrderBook {
+	symbol: string;
+	bids: OrderBookLevel[];
+	asks: OrderBookLevel[];
+	best_bid: string;
+	best_ask: string;
+	spread: string;
+	timestamp: string;
+}
+
+export interface OrderBookOptions {
+	levels?: number;
+	precision?: 2 | 4;
+}
+
+export interface SymbolConfig {
+	symbol: string;
+	paused: boolean;
+	max_decimals: number;
+	minimum_quantity: string;
+}
+
+export interface OpenInterest {
+	symbol: string;
+	bid_interest: string;
+	ask_interest: string;
+	bid_order_count: number;
+	ask_order_count: number;
+	timestamp: string;
+}
+
+export interface Trade {
+	trade_id: string;
+	symbol: string;
+	side: string;
+	quantity: string;
+	price: string;
+	timestamp: string;
+}
+
+export interface RecentTradesOptions {
+	limit?: number;
+}
+
+// ── Orders ──
+
+export interface ActiveOrder {
+	order_id: string;
+	symbol: string;
+	side: string;
+	quantity: string;
+	price: string;
+	status: string;
+	created_at: string;
+	updated_at: string;
+}
+
+export interface ActiveOrdersOptions {
+	symbol?: string;
+	limit?: number;
+}
+
+export interface CancelOrderResponse {
+	success: boolean;
+	order_id: string;
+	already_queued: boolean;
+	message: string;
+}
+
+export interface CancelAllOrdersOptions {
+	symbol?: string;
+}
+
+export interface CancelAllOrdersResponse {
+	success: boolean;
+	canceled_count: number;
+	already_queued_count: number;
+	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;
+	order_subtype?: "post_only";
+	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: DisclosuresData;
+}
+
+// ── Errors ──
+
+export interface ApiError {
+	error: true;
+	status: number | null;
+	code: string | null;
+	message: string;
+}
+
+// ── Auth ──
+
+export interface AuthHeaders {
+	"X-API-Key": string;
+}

package/src/auth0/index.d.ts

@@ -1 +1 @@
-export function getJWTToken(): Promise<string | null>;
+export function getJWTToken(): Promise<string | null>;

package/src/auth0/index.js

@@ -1,50 +1,50 @@
-import config from "../config/index.js";
-import axios from "axios";
-
-let jwtToken = null;
-let tokenExpiryTime = null;
-
-/**
- * Get an Auth0 JWT access token with automatic caching and refresh.
- * Tokens are cached and reused until they expire (with a 60-second buffer).
- * Requires AUTH0_TOKEN_URL, AUTH0_CLIENT_ID, AUTH0_CLIENT_SECRET, and AUTH0_AUDIENCE to be configured.
- * @returns {Promise<string|null>} The JWT access token, or null on failure
- */
-export async function getJWTToken() {
-	// Return cached token if not expired
-	if (jwtToken != null && tokenExpiryTime != null) {
-		// Check if expired (with 60 second buffer to avoid edge cases)
-		const isExpired = Date.now() >= tokenExpiryTime - 60000;
-		if (!isExpired) {
-			return jwtToken.access_token;
-		}
-	}
-	const encodedParams = new URLSearchParams();
-	encodedParams.set("grant_type", config.AUTH0_GRANT_TYPE);
-	encodedParams.set("client_id", config.AUTH0_CLIENT_ID);
-	encodedParams.set("client_secret", config.AUTH0_CLIENT_SECRET);
-	encodedParams.set("audience", config.AUTH0_AUDIENCE);
-	encodedParams.set("scope", config.AUTH0_SCOPE);
-
-	const options = {
-		method: "POST",
-		url: config.AUTH0_TOKEN_URL,
-		headers: {
-			"content-type": "application/x-www-form-urlencoded",
-		},
-		data: encodedParams,
-	};
-
-	try {
-		const { data } = await axios.request(options);
-		jwtToken = data;
-		// Calculate expiry time: current time + expires_in (in seconds) * 1000 (to convert to milliseconds)
-		tokenExpiryTime = Date.now() + data.expires_in * 1000;
-		return jwtToken.access_token;
-	} catch (error) {
-		console.error(error);
-		tokenExpiryTime = null;
-		jwtToken = null;
-		return null;
-	}
-}
+import config from "../config/index.js";
+import axios from "axios";
+
+let jwtToken = null;
+let tokenExpiryTime = null;
+
+/**
+ * Get an Auth0 JWT access token with automatic caching and refresh.
+ * Tokens are cached and reused until they expire (with a 60-second buffer).
+ * Requires AUTH0_TOKEN_URL, AUTH0_CLIENT_ID, AUTH0_CLIENT_SECRET, and AUTH0_AUDIENCE to be configured.
+ * @returns {Promise<string|null>} The JWT access token, or null on failure
+ */
+export async function getJWTToken() {
+	// Return cached token if not expired
+	if (jwtToken != null && tokenExpiryTime != null) {
+		// Check if expired (with 60 second buffer to avoid edge cases)
+		const isExpired = Date.now() >= tokenExpiryTime - 60000;
+		if (!isExpired) {
+			return jwtToken.access_token;
+		}
+	}
+	const encodedParams = new URLSearchParams();
+	encodedParams.set("grant_type", config.AUTH0_GRANT_TYPE);
+	encodedParams.set("client_id", config.AUTH0_CLIENT_ID);
+	encodedParams.set("client_secret", config.AUTH0_CLIENT_SECRET);
+	encodedParams.set("audience", config.AUTH0_AUDIENCE);
+	encodedParams.set("scope", config.AUTH0_SCOPE);
+
+	const options = {
+		method: "POST",
+		url: config.AUTH0_TOKEN_URL,
+		headers: {
+			"content-type": "application/x-www-form-urlencoded",
+		},
+		data: encodedParams,
+	};
+
+	try {
+		const { data } = await axios.request(options);
+		jwtToken = data;
+		// Calculate expiry time: current time + expires_in (in seconds) * 1000 (to convert to milliseconds)
+		tokenExpiryTime = Date.now() + data.expires_in * 1000;
+		return jwtToken.access_token;
+	} catch (error) {
+		console.error(error);
+		tokenExpiryTime = null;
+		jwtToken = null;
+		return null;
+	}
+}

package/src/canton/deposits.ts

@@ -2,7 +2,7 @@ import config from "../../src/config/index.js";
 import axios from "axios";
 import { getDisclosures } from "../api/index.js";
 import { getUserId } from "../api/tokenStore.js";
-import { getAdapterPartyId, getWalletAdapter, submitCommand } from "../../src/canton/walletAdapter.js";
+import { getAdapterPartyId, getWalletAdapter, submitCommand, payDueGasIfAny } from "../../src/canton/walletAdapter.js";
 import { normalizeAssetId, instrumentCatalog } from "../../src/canton/instrumentCatalog.js";
 import {
 	randomUUID,
@@ -183,6 +183,9 @@ export async function deposit(
 		return { error: "deposit: could not resolve party ID from wallet adapter." };
 	}
 
+	// Pay any outstanding network gas first so the balance check below is accurate.
+	await payDueGasIfAny();
+
 	const assetId = normalizeAssetId(symbol);
 	if (!instrumentCatalog[assetId]) {
 		return { error: `deposit: unsupported symbol "${symbol}"` };
@@ -536,6 +539,7 @@ export async function depositFunds(
 	// Auto-submit via wallet adapter if available
 	if (getWalletAdapter()) {
 		try {
+			await payDueGasIfAny();
 			return (await submitCommand(command)) as Record<string, unknown>;
 		} catch (error: unknown) {
 			const msg = `depositFunds: wallet adapter submission failed: ${(error as Error).message}`;