@temple-digital-group/temple-canton-js 1.0.35 → 1.0.37-beta.0

package/README.md

@@ -1,234 +1,339 @@
-# Temple Canton JS
-
-JavaScript SDK for interacting with the Temple Canton blockchain exchange. Supports Amulet, USDCx, and CBTC tokens on the Canton network.
-
-## Installation
-
-```bash
-npm install @temple-digital-group/temple-canton-js
-```
-
-## Configuration
-
-Call `initializeConfig()` before using any SDK functions. This is required in all environments.
-
-### Custom Validator
-
-For apps connecting to your own validator (browser or server-side):
-
-```javascript
-import { initializeConfig } from '@temple-digital-group/temple-canton-js';
-
-initializeConfig({
-  NETWORK: 'mainnet',
-  VALIDATOR_API_URL: 'https://your-validator-url',
-  VALIDATOR_SCAN_API_URL: 'https://your-scan-api-url',
-  VALIDATOR_USER_PARTY_ID: 'your-user-party-id',
-  JWT_TOKEN: 'your-jwt-token',           // Browser: pass a pre-authenticated JWT
-  // — OR for server-side Auth0 —
-  // AUTH0_TOKEN_URL: 'https://your-auth0-domain/oauth/token',
-  // AUTH0_USER_ID: 'your-auth0-user-id',
-  // AUTH0_CLIENT_ID: 'your-client-id',
-  // AUTH0_CLIENT_SECRET: 'your-client-secret',
-  // AUTH0_AUDIENCE: 'your-audience',
-});
-```
-
-| Key | Required | Description |
-|-----|----------|-------------|
-| `NETWORK` | Yes | `mainnet`, `testnet`, or `localhost` |
-| `VALIDATOR_API_URL` | Yes | Base URL of the Canton validator ledger API |
-| `VALIDATOR_SCAN_API_URL` | Yes | Base URL of the Canton Scan API |
-| `VALIDATOR_USER_PARTY_ID` | Yes | The user's party ID on the network |
-| `JWT_TOKEN` | Yes* | Pre-authenticated JWT token for ledger API calls |
-| `AUTH0_TOKEN_URL` | Yes* | Auth0 OAuth token endpoint |
-| `AUTH0_CLIENT_ID` | Yes* | Auth0 application client ID |
-| `AUTH0_CLIENT_SECRET` | Yes* | Auth0 application client secret |
-| `AUTH0_AUDIENCE` | Yes* | Auth0 API audience identifier |
-| `AUTH0_USER_ID` | Yes* | Auth0 user ID for the service account |
-
-\* Provide either `JWT_TOKEN` (browser) or the `AUTH0_*` fields (server-side). The SDK fetches and caches JWT tokens automatically when Auth0 credentials are provided.
-
-To update the JWT token later without re-initializing:
-
-```javascript
-import { setJWTToken } from '@temple-digital-group/temple-canton-js';
-
-setJWTToken(newToken);
-```
-
-### Wallet Provider
-
-For apps using a wallet provider (e.g., Loop Wallet). Use `returnCommand = true` to get the command data back.
-
-```javascript
-import { initializeConfig, createOrderProposal } from '@temple-digital-group/temple-canton-js';
-
-initializeConfig({
-  NETWORK: 'mainnet'
-});
-
-const command = await createOrderProposal(orderArgs, true, walletProvider);
-```
-
-| Key | Required | Description |
-|-----|----------|-------------|
-| `NETWORK` | Yes | `mainnet`, `testnet`, or `localhost` |
-
-> **Legacy:** Environment variables are still supported for backwards compatibility, but `initializeConfig()` is the recommended approach.
-
-
-## Supported Instruments
-
-| Asset   | Type    | Networks          |
-|---------|---------|-------------------|
-| Amulet  | Amulet  | testnet, mainnet  |
-| USDCx   | Utility | testnet, mainnet  |
-| CBTC    | Utility | testnet, mainnet  |
-
-## Supported Trading Pairs
-
-- `Amulet/USDCx`
-- `CBTC/USDCx`
-
-## Usage
-
-### Get User Balances
-
-```javascript
-import { getUserBalances } from '@temple-digital-group/temple-canton-js';
-
-const balances = await getUserBalances(partyId);
-```
-
-### Create an Order
-
-```javascript
-import { createOrderProposal } from '@temple-digital-group/temple-canton-js';
-
-const result = await createOrderProposal({
-  party: partyId,
-  symbol: 'Amulet/USDCx',
-  side: 'Buy',
-  quantity: '100',
-  pricePerUnit: '1.5',
-  expiration: new Date(Date.now() + 3600000).toISOString(),
-  userId: auth0UserId,
-  orderType: 'limit'
-});
-```
-
-### Get Orders and Proposals
-
-```javascript
-import { getOrdersForParty, getOrderProposalsForParty } from '@temple-digital-group/temple-canton-js';
-
-const orders = await getOrdersForParty(partyId);
-const proposals = await getOrderProposalsForParty(partyId);
-```
-
-### Merge Holdings
-
-```javascript
-import { mergeAmuletHoldingsForParty, mergeUtilityHoldingsForParty, getAmuletDisclosures, getUtxoCount } from '@temple-digital-group/temple-canton-js';
-
-// Custom Validator (server-side)
-await mergeAmuletHoldingsForParty(partyId);
-await mergeUtilityHoldingsForParty(partyId, 'USDCx');
-
-// Wallet Provider — merge up to 5 smallest USDCx UTXOs
-const command = await mergeUtilityHoldingsForParty(partyId, 'USDCx', true, walletProvider, 5);
-const result = await walletProvider.signAndSubmit(command);
-
-// Wallet Provider — merge Amulet (requires amulet disclosures)
-const disclosures = await getAmuletDisclosures(partyId);
-const cmd = await mergeAmuletHoldingsForParty(partyId, true, walletProvider, 5, disclosures);
-const res = await walletProvider.signAndSubmit(cmd);
-
-// Check UTXO status after merge — confirm the order amount is now covered
-const counts = await getUtxoCount(partyId, 'USDCx', walletProvider);
-// { total: 5, unlocked: 1, locked: 4, largestUnlocked: 27.26, unlockedBalance: 27.26 }
-if (counts.largestUnlocked >= requiredAmount) {
-  // Safe to retry createOrderProposal
-}
-```
-
-## API Reference
-
-> Functions marked with **W** support a wallet provider parameter. All other functions require a custom validator (ledger access via `VALIDATOR_API_URL` and `JWT_TOKEN`).
-
-### Configuration
-
-| Function | Description |
-|----------|-------------|
-| `initializeConfig(config)` | Initialize the library with a runtime config object |
-| `setJWTToken(token)` | Update the JWT token without re-initializing the config |
-| `getConfigValue(key)` | Get a config value from runtime config or environment |
-
-### Authentication
-
-| Function | Description |
-|----------|-------------|
-| `getJWTToken()` | Get Auth0 JWT access token (cached with auto-refresh) |
-
-### Instrument Catalog
-
-These functions are synchronous and work in all environments (no ledger or provider needed).
-
-| Function | Description |
-|----------|-------------|
-| `resolveInstrumentDefinition(assetId)` | Look up an instrument definition from the catalog |
-| `getInstrumentRegistrar(assetId)` | Get the registrar party for a utility instrument |
-| `getSupportedTradingPairs()` | Get the list of supported trading pairs |
-| `getInstrumentCatalog()` | Get the full instrument catalog |
-| `checkAmuletContext(baseAsset, quoteAsset, side)` | Check if an order requires Amulet context |
-
-### Holdings
-
-| Function | Provider | Description |
-|----------|----------|-------------|
-| `getAmuletHoldingsForParty(party)` | **W** | Get Amulet holdings |
-| `getUtilityHoldingsForParty(party)` | **W** | Get utility token holdings |
-| `getCandidateHoldingForOrderCreation(party, isAmulet, quantity, assetId)` | **W** | Find a holding suitable for an order |
-| `getUserBalances(party)` | | Get all balances for a party, grouped by asset |
-| `getLockedAmuletHoldingsForParty(party)` | | Get locked Amulet holdings |
-
-### Orders
-
-| Function | Provider | Description |
-|----------|----------|-------------|
-| `createOrderProposal(orderArguments)` | **W** | Create an order proposal |
-| `getOrderProposalsForParty(party)` | | Get pending order proposals |
-| `getOrdersForParty(party)` | | Get active orders |
-
-### Holding Operations
-
-| Function | Provider | Description |
-|----------|----------|-------------|
-| `mergeAmuletHoldingsForParty(party, returnCommand, provider, maxUtxos, amuletDisclosures)` | **W** | Merge Amulet holdings into one |
-| `mergeUtilityHoldingsForParty(party, utilityAsset, returnCommand, provider, maxUtxos)` | **W** | Merge utility holdings into one |
-| `getUtxoCount(party, assetId, provider)` | **W** | Get UTXO summary: counts, largest unlocked amount, and total unlocked balance |
-| `splitAmuletHoldingForParty(party, outputQuantity)` | | Split an Amulet holding |
-| `unlockLockedAmulets(party)` | | Unlock locked Amulet holdings |
-
-### Ledger Queries
-
-| Function | Description |
-|----------|-------------|
-| `getTransferFactory(investor, admin, amount, holdingIds)` | Get transfer factory from Scan API |
-| `getAmuletDisclosures(party)` | Get Amulet disclosure contracts |
-| `getAmuletRules(dso)` | Get AmuletRules contract |
-| `getExternalAmuletRules(dso)` | Get ExternalPartyAmuletRules contract |
-| `getFeaturedAppRight()` | Get FeaturedAppRight contract |
-| `getOpenMiningRounds(dso)` | Get open mining rounds |
-| `getCandidateMiningRoundContract(dso)` | Get a currently-open mining round |
-| `getUtilityInstrumentConfigurations()` | Get utility instrument configurations |
-| `getUtilityAllocationFactory()` | Get utility allocation factory |
-| `getUtilitySenderCredentials(sender)` | Get sender credentials |
-| `createUtilityCredential(holder, registrar)` | Create a utility credential |
-
-### Deprecated
-
-| Function | Description |
-|----------|-------------|
-| ~~`cancelOrders(party, orderContractIds, assetType)`~~ | Batch cancel orders (deprecated — use the [Cancel Order](https://apidocs.templedigitalgroup.com/reference/cancelorder) or [Cancel All Orders](https://apidocs.templedigitalgroup.com/reference/cancelallorders) REST API instead) |
+# Temple Canton JS
+
+JavaScript SDK for interacting with the Temple Canton blockchain exchange. Supports CC, USDCx, and CBTC tokens on the Canton network.
+
+## Installation
+
+```bash
+npm install @temple-digital-group/temple-canton-js
+```
+
+## Configuration
+
+Call `initialize()` before using any SDK functions. It sets up the config and optionally authenticates with the Temple REST API.
+
+### Custom Validator
+
+For apps connecting to your own validator (browser or server-side):
+
+```javascript
+import { initialize } from '@temple-digital-group/temple-canton-js';
+
+await initialize({
+  NETWORK: 'mainnet',
+  VALIDATOR_API_URL: 'https://your-validator-url',
+  VALIDATOR_SCAN_API_URL: 'https://your-scan-api-url',
+  VALIDATOR_USER_PARTY_ID: 'your-user-party-id',
+  JWT_TOKEN: 'your-jwt-token',           // Browser: pass a pre-authenticated JWT
+  // — OR for server-side Auth0 —
+  // AUTH0_TOKEN_URL: 'https://your-auth0-domain/oauth/token',
+  // AUTH0_USER_ID: 'your-auth0-user-id',
+  // AUTH0_CLIENT_ID: 'your-client-id',
+  // AUTH0_CLIENT_SECRET: 'your-client-secret',
+  // AUTH0_AUDIENCE: 'your-audience',
+});
+```
+
+### Custom Validator + REST API
+
+To also authenticate with the Temple REST API at init time, pass `API_EMAIL`/`API_PASSWORD`:
+
+```javascript
+import { initialize } from '@temple-digital-group/temple-canton-js';
+
+await initialize({
+  NETWORK: 'mainnet',
+  VALIDATOR_API_URL: 'https://your-validator-url',
+  VALIDATOR_SCAN_API_URL: 'https://your-scan-api-url',
+  VALIDATOR_USER_PARTY_ID: 'your-user-party-id',
+  JWT_TOKEN: 'your-jwt-token',
+  API_EMAIL: 'user@example.com',         // REST API login (optional)
+  API_PASSWORD: 'password',
+});
+```
+
+| Key | Required | Description |
+|-----|----------|-------------|
+| `NETWORK` | Yes | `mainnet`, `testnet`, or `localhost` |
+| `VALIDATOR_API_URL` | Yes | Base URL of the Canton validator ledger API |
+| `VALIDATOR_SCAN_API_URL` | Yes | Base URL of the Canton Scan API |
+| `VALIDATOR_USER_PARTY_ID` | Yes | The user's party ID on the network |
+| `JWT_TOKEN` | Yes* | Pre-authenticated JWT token for ledger API calls |
+| `AUTH0_TOKEN_URL` | Yes* | Auth0 OAuth token endpoint |
+| `AUTH0_CLIENT_ID` | Yes* | Auth0 application client ID |
+| `AUTH0_CLIENT_SECRET` | Yes* | Auth0 application client secret |
+| `AUTH0_AUDIENCE` | Yes* | Auth0 API audience identifier |
+| `AUTH0_USER_ID` | Yes* | Auth0 user ID for the service account |
+| `API_EMAIL` | No | Temple REST API email (triggers login at init) |
+| `API_PASSWORD` | No | Temple REST API password (required with `API_EMAIL`) |
+
+\* Provide either `JWT_TOKEN` (browser) or the `AUTH0_*` fields (server-side). The SDK fetches and caches JWT tokens automatically when Auth0 credentials are provided.
+
+To update the JWT token later without re-initializing:
+
+```javascript
+import { setJWTToken } from '@temple-digital-group/temple-canton-js';
+
+setJWTToken(newToken);
+```
+
+### Wallet Provider
+
+For apps using a wallet provider (e.g., Loop Wallet). Use `returnCommand = true` to get the command data back.
+
+```javascript
+import { initialize, createOrderProposal } from '@temple-digital-group/temple-canton-js';
+
+await initialize({
+  NETWORK: 'mainnet',
+});
+
+const command = await createOrderProposal(orderArgs, true, walletProvider);
+```
+
+| Key | Required | Description |
+|-----|----------|-------------|
+| `NETWORK` | Yes | `mainnet`, `testnet`, or `localhost` |
+
+> You can optionally pass `API_EMAIL`/`API_PASSWORD` to any `initialize()` call to also authenticate with the REST API at init time.
+
+> **Legacy:** `initializeConfig()` is still available as a sync-only alternative (no REST API auth). `initialize()` is the recommended approach.
+
+
+## Supported Instruments
+
+| Asset   | Type    | Networks          |
+|---------|---------|-------------------|
+| CC      | Canton Coin | testnet, mainnet  |
+| USDCx   | Utility | testnet, mainnet  |
+| CBTC    | Utility | testnet, mainnet  |
+
+## Supported Trading Pairs
+
+- `CC/USDCx`
+- `CBTC/USDCx`
+
+## Usage
+
+### Get User Balances
+
+```javascript
+import { getUserBalances } from '@temple-digital-group/temple-canton-js';
+
+// Custom Validator
+const balances = await getUserBalances(partyId);
+
+// Wallet Provider
+const balances = await getUserBalances(partyId, walletProvider);
+```
+
+Each entry in the returned array contains:
+
+```javascript
+{
+  asset: 'USDCx',              // Catalog symbol
+  total_balance: 170.5,        // Unlocked + locked combined
+  available_balance: 150.5,    // Unlocked balance (usable for orders)
+  locked_balance: 20.0,        // Locked balance
+  dso: null,                   // DSO party (CC only)
+  registrar: '...',            // Registrar party (utility tokens)
+  operator: '...',             // Operator party
+  provider: '...',             // Provider party
+  merge_warning: true,         // true if multiple unlocked holdings exist
+  holdings: [...],             // Unlocked holding contracts
+  locked_holdings: [...],      // Locked holding contracts
+  utilityContext: { ... }      // CIP-56 context (null when using wallet provider)
+}
+```
+
+> **Note:** `utilityContext` is only resolved when using a custom validator (ledger API access). When using a wallet provider, it will be `null`.
+
+### Create an Order
+
+```javascript
+import { createOrderProposal } from '@temple-digital-group/temple-canton-js';
+
+const result = await createOrderProposal({
+  party: partyId,
+  symbol: 'CC/USDCx',
+  side: 'Buy',
+  quantity: '100',
+  pricePerUnit: '1.5',
+  expiration: new Date(Date.now() + 3600000).toISOString(),
+  userId: auth0UserId,
+  orderType: 'limit'
+});
+```
+
+### Get Orders and Proposals
+
+```javascript
+import { getOrdersForParty, getOrderProposalsForParty } from '@temple-digital-group/temple-canton-js';
+
+const orders = await getOrdersForParty(partyId);
+const proposals = await getOrderProposalsForParty(partyId);
+```
+
+### REST API (Optional) — Market Data and Orders
+
+The REST API functions are optional. If you pass `API_EMAIL`/`API_PASSWORD` in `initialize()`, the SDK authenticates at init time. You can also call `login()` directly.
+
+```javascript
+import { initialize, getTicker, getOrderBook, getActiveOrders, cancelOrder } from '@temple-digital-group/temple-canton-js';
+
+await initialize({
+  NETWORK: 'mainnet',
+  API_EMAIL: 'user@example.com',
+  API_PASSWORD: 'password',
+});
+
+// Market data
+const ticker = await getTicker('CC/USDCx');
+const book = await getOrderBook('CC/USDCx', { levels: 10 });
+
+// Orders
+const orders = await getActiveOrders({ symbol: 'CC/USDCx' });
+const result = await cancelOrder('order-id-123');
+
+// All functions return { error: true, status, code, message } on failure
+if (result.error) {
+  console.log(`Failed: ${result.message}`);
+}
+```
+
+### Merge Holdings
+
+```javascript
+import { mergeAmuletHoldingsForParty, mergeUtilityHoldingsForParty, getAmuletDisclosures, getUtxoCount } from '@temple-digital-group/temple-canton-js';
+
+// Custom Validator (server-side)
+await mergeAmuletHoldingsForParty(partyId);
+await mergeUtilityHoldingsForParty(partyId, 'USDCx');
+
+// Wallet Provider — merge up to 5 smallest USDCx UTXOs
+const command = await mergeUtilityHoldingsForParty(partyId, 'USDCx', true, walletProvider, 5);
+const result = await walletProvider.signAndSubmit(command);
+
+// Wallet Provider — merge CC (requires disclosures)
+const disclosures = await getAmuletDisclosures(partyId);
+const cmd = await mergeAmuletHoldingsForParty(partyId, true, walletProvider, 5, disclosures);
+const res = await walletProvider.signAndSubmit(cmd);
+
+// Check UTXO status after merge — confirm the order amount is now covered
+const counts = await getUtxoCount(partyId, 'USDCx', walletProvider);
+// { total: 5, unlocked: 1, locked: 4, largestUnlocked: 27.26, unlockedBalance: 27.26 }
+if (counts.largestUnlocked >= requiredAmount) {
+  // Safe to retry createOrderProposal
+}
+```
+
+## API Reference
+
+> Functions marked with **W** support a wallet provider parameter. All other functions require a custom validator (ledger access via `VALIDATOR_API_URL` and `JWT_TOKEN`).
+
+### Configuration
+
+| Function | Description |
+|----------|-------------|
+| `initialize(config)` | Initialize the SDK, set config, and optionally authenticate with the REST API |
+| `initializeConfig(config)` | Sync-only config init (no REST API auth). Use `initialize()` instead |
+| `setJWTToken(token)` | Update the JWT token without re-initializing the config |
+| `getConfigValue(key)` | Get a config value from runtime config or environment |
+
+### Authentication
+
+| Function | Description |
+|----------|-------------|
+| `getJWTToken()` | Get Auth0 JWT access token (cached with auto-refresh) |
+
+### Instrument Catalog
+
+These functions are synchronous and work in all environments (no ledger or provider needed).
+
+| Function | Description |
+|----------|-------------|
+| `resolveInstrumentDefinition(assetId)` | Look up an instrument definition from the catalog |
+| `getInstrumentRegistrar(assetId)` | Get the registrar party for a utility instrument |
+| `getSupportedTradingPairs()` | Get the list of supported trading pairs |
+| `getInstrumentCatalog()` | Get the full instrument catalog |
+| `checkAmuletContext(baseAsset, quoteAsset, side)` | Check if an order requires CC context |
+
+### Holdings
+
+| Function | Provider | Description |
+|----------|----------|-------------|
+| `getAmuletHoldingsForParty(party, returnCommand, provider)` | **W** | Get CC holdings |
+| `getLockedAmuletHoldingsForParty(party, returnCommand, provider)` | **W** | Get locked CC holdings |
+| `getUtilityHoldingsForParty(party, returnCommand, provider)` | **W** | Get utility token holdings |
+| `getCandidateHoldingForOrderCreation(party, isAmulet, quantity, assetId)` | **W** | Find a holding suitable for an order |
+| `getUserBalances(party, provider)` | **W** | Get all balances grouped by asset (CC, locked CC, and utility) |
+
+### Orders
+
+| Function | Provider | Description |
+|----------|----------|-------------|
+| `createOrderProposal(orderArguments)` | **W** | Create an order proposal |
+| `getOrderProposalsForParty(party)` | | Get pending order proposals |
+| `getOrdersForParty(party)` | | Get active orders |
+
+### Holding Operations
+
+| Function | Provider | Description |
+|----------|----------|-------------|
+| `mergeAmuletHoldingsForParty(party, returnCommand, provider, maxUtxos, amuletDisclosures)` | **W** | Merge CC holdings into one |
+| `mergeUtilityHoldingsForParty(party, utilityAsset, returnCommand, provider, maxUtxos)` | **W** | Merge utility holdings into one |
+| `getUtxoCount(party, assetId, provider)` | **W** | Get UTXO summary: counts, largest unlocked amount, and total unlocked balance |
+| `splitAmuletHoldingForParty(party, outputQuantity)` | | Split a CC holding |
+| `unlockLockedAmulets(party)` | | Unlock locked CC holdings |
+
+### Ledger Queries
+
+| Function | Description |
+|----------|-------------|
+| `getTransferFactory(investor, admin, amount, holdingIds)` | Get transfer factory from Scan API |
+| `getAmuletDisclosures(party)` | Get CC disclosure contracts |
+| `getAmuletRules(dso)` | Get CC rules contract |
+| `getExternalAmuletRules(dso)` | Get external party CC rules contract |
+| `getFeaturedAppRight()` | Get FeaturedAppRight contract |
+| `getOpenMiningRounds(dso)` | Get open mining rounds |
+| `getCandidateMiningRoundContract(dso)` | Get a currently-open mining round |
+| `getUtilityInstrumentConfigurations()` | Get utility instrument configurations |
+| `getUtilityAllocationFactory()` | Get utility allocation factory |
+| `getUtilitySenderCredentials(sender)` | Get sender credentials |
+| `createUtilityCredential(holder, registrar)` | Create a utility credential |
+
+### Temple REST API (Optional)
+
+> These functions call the Temple public REST API and are entirely optional. Pass `API_EMAIL`/`API_PASSWORD` in `initialize()`, or call `login()` directly — tokens are stored and auto-refreshed.
+
+#### Auth
+
+| Function | Description |
+|----------|-------------|
+| `login(email, password)` | Login and store access/refresh tokens |
+| `refreshAccessToken(refreshToken?)` | Refresh the access token (auto-called when expired) |
+| `logout()` | Clear stored tokens |
+
+#### Market Data
+
+| Function | Description |
+|----------|-------------|
+| `getTicker(symbol?)` | Get ticker data for one or all trading pairs |
+| `getOrderBook(symbol, options?)` | Get the order book (options: `levels`, `precision`) |
+| `getSymbolConfig(symbol)` | Get symbol configuration (paused, decimals, min quantity) |
+| `getOpenInterest(symbol)` | Get open interest for a trading pair |
+| `getRecentTrades(symbol, options?)` | Get recent trades (options: `limit`, max 500) |
+
+#### Orders
+
+| Function | Description |
+|----------|-------------|
+| `getActiveOrders(options?)` | Get active orders (options: `symbol`, `limit`) |
+| `cancelOrder(orderId)` | Cancel a specific order |
+| `cancelAllOrders(options?)` | Cancel all orders (options: `symbol` filter) |
+
+#### Disclosures
+
+| Function | Description |
+|----------|-------------|
+| `getDisclosures(partyId)` | Get CC disclosure data (amulet rules, open mining rounds, external party rules) |

package/dist/api/index.d.ts

@@ -0,0 +1,76 @@
+import type { ApiError, LoginResponse, RefreshResponse, Ticker, OrderBook, OrderBookOptions, SymbolConfig, OpenInterest, Trade, RecentTradesOptions, ActiveOrder, ActiveOrdersOptions, CancelOrderResponse, CancelAllOrdersOptions, CancelAllOrdersResponse, DisclosuresResponse } from "./types.js";
+export type { ApiError, LoginResponse, RefreshResponse, Ticker, OrderBook, OrderBookOptions, SymbolConfig, OpenInterest, Trade, RecentTradesOptions, ActiveOrder, ActiveOrdersOptions, CancelOrderResponse, CancelAllOrdersOptions, CancelAllOrdersResponse, DisclosuresResponse, };
+export { setApiKey } from "./tokenStore.js";
+/**
+ * Initialize the Temple SDK — sets config and optionally authenticates with the REST API.
+ * Pass `API_EMAIL`/`API_PASSWORD` or `API_KEY` to authenticate eagerly at init time.
+ *
+ * @returns The login response on success, or an ApiError on failure.
+ *          Returns `null` if no API credentials were provided (config-only init).
+ */
+export declare function initialize(cfg: Record<string, unknown>): Promise<LoginResponse | ApiError | null>;
+/**
+ * Login to the Temple REST API with email and password.
+ * Stores tokens automatically for subsequent API calls.
+ * @param email - User email
+ * @param password - User password
+ */
+export declare function login(email: string, password: string): Promise<LoginResponse | ApiError>;
+/**
+ * Refresh the access token using the stored or provided refresh token.
+ * Updates the token store automatically on success.
+ * @param refreshTokenOverride - Optional explicit refresh token (uses stored one if omitted)
+ */
+export declare function refreshAccessToken(refreshTokenOverride?: string): Promise<RefreshResponse | ApiError>;
+/**
+ * Logout: clear all stored REST API tokens.
+ */
+export declare function logout(): void;
+/**
+ * Get ticker data for one or all trading pairs.
+ * @param symbol - Optional symbol filter (e.g., "Amulet/USDCx")
+ */
+export declare function getTicker(symbol?: string): Promise<Ticker | Ticker[] | ApiError>;
+/**
+ * Get the order book for a trading pair.
+ * @param symbol - Trading pair symbol (required)
+ * @param options - Optional levels and precision parameters
+ */
+export declare function getOrderBook(symbol: string, options?: OrderBookOptions): Promise<OrderBook | ApiError>;
+/**
+ * Get symbol configuration (paused status, decimals, minimum quantity).
+ * @param symbol - Trading pair symbol (required)
+ */
+export declare function getSymbolConfig(symbol: string): Promise<SymbolConfig | ApiError>;
+/**
+ * Get open interest for a trading pair.
+ * @param symbol - Trading pair symbol (required)
+ */
+export declare function getOpenInterest(symbol: string): Promise<OpenInterest | ApiError>;
+/**
+ * Get recent trades for a trading pair.
+ * @param symbol - Trading pair symbol (required)
+ * @param options - Optional limit (max 500)
+ */
+export declare function getRecentTrades(symbol: string, options?: RecentTradesOptions): Promise<Trade[] | ApiError>;
+/**
+ * Get active orders, optionally filtered by symbol.
+ * @param options - Optional symbol and limit filters
+ */
+export declare function getActiveOrders(options?: ActiveOrdersOptions): Promise<ActiveOrder[] | ApiError>;
+/**
+ * Cancel a specific order by ID.
+ * @param orderId - The order ID to cancel
+ */
+export declare function cancelOrder(orderId: string): Promise<CancelOrderResponse | ApiError>;
+/**
+ * Cancel all active orders, optionally filtered by symbol.
+ * @param options - Optional symbol filter
+ */
+export declare function cancelAllOrders(options?: CancelAllOrdersOptions): Promise<CancelAllOrdersResponse | ApiError>;
+/**
+ * Get amulet disclosure data for a party from the Temple REST API.
+ * Returns protocol disclosures (amulet rules, open mining rounds, external party amulet rules).
+ * @param partyId - Canton party ID
+ */
+export declare function getDisclosures(partyId: string): Promise<DisclosuresResponse | ApiError>;