@temple-digital-group/temple-canton-js 1.0.33 → 1.0.35

package/README.md

@@ -10,11 +10,11 @@ npm install @temple-digital-group/temple-canton-js
 
 ## Configuration
 
-There are three ways to use the SDK depending on your environment:
+Call `initializeConfig()` before using any SDK functions. This is required in all environments.
 
-### 1. Browser with Custom Validator
+### Custom Validator
 
-For browser apps connecting to your own validator. Requires `initializeConfig()` with your validator URLs and a pre-authenticated JWT token.
+For apps connecting to your own validator (browser or server-side):
 
 ```javascript
 import { initializeConfig } from '@temple-digital-group/temple-canton-js';
@@ -23,10 +23,14 @@ initializeConfig({
   NETWORK: 'mainnet',
   VALIDATOR_API_URL: 'https://your-validator-url',
   VALIDATOR_SCAN_API_URL: 'https://your-scan-api-url',
-  TEMPLE_PARTY_ID: 'your-temple-party-id',
-  VALIDATOR_DSO_PARTY_ID: 'your-dso-party-id',
-  JWT_TOKEN: 'your-jwt-token',
-  VALIDATOR_USER_PARTY_ID: 'your-user-party-id'
+  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',
 });
 ```
 
@@ -35,81 +39,43 @@ initializeConfig({
 | `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 |
-| `TEMPLE_PARTY_ID` | Yes | Temple's party ID on the network |
-| `VALIDATOR_DSO_PARTY_ID` | Yes | The DSO (Decentralized Synchronizer Operator) party ID |
-| `JWT_TOKEN` | Yes | Pre-authenticated JWT token for ledger API calls |
 | `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 |
 
-### 2. Browser with Wallet Provider
+\* Provide either `JWT_TOKEN` (browser) or the `AUTH0_*` fields (server-side). The SDK fetches and caches JWT tokens automatically when Auth0 credentials are provided.
 
-For browser apps using a wallet (e.g., Loop Wallet). Requires `initializeConfig()` with base network config only. Use `returnCommand = true` to get the command back for the wallet to sign.
+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',
-  TEMPLE_PARTY_ID: 'your-temple-party-id',
-  VALIDATOR_DSO_PARTY_ID: 'your-dso-party-id'
+  NETWORK: 'mainnet'
 });
 
-// returnCommand=true returns the command for the wallet to sign
 const command = await createOrderProposal(orderArgs, true, walletProvider);
-const result = await walletProvider.signAndSubmit(command);
 ```
 
 | Key | Required | Description |
 |-----|----------|-------------|
 | `NETWORK` | Yes | `mainnet`, `testnet`, or `localhost` |
-| `TEMPLE_PARTY_ID` | Yes | Temple's party ID on the network |
-| `VALIDATOR_DSO_PARTY_ID` | Yes | The DSO (Decentralized Synchronizer Operator) party ID |
-
-### 3. Node.js / Server-Side
 
-For server-side applications. Uses environment variables directly — no `initializeConfig()` call needed. Create a `.env` file:
-
-```env
-NETWORK=mainnet
-VALIDATOR_API_URL=https://your-validator-url
-VALIDATOR_SCAN_API_URL=https://your-scan-api-url
-TEMPLE_PARTY_ID=your-temple-party-id
-VALIDATOR_DSO_PARTY_ID=your-dso-party-id
-
-AUTH0_TOKEN_URL=https://your-auth0-domain.auth0.com/oauth/token
-AUTH0_USER_ID=your-auth0-user-id
-AUTH0_CLIENT_ID=your-client-id
-AUTH0_CLIENT_SECRET=your-client-secret
-AUTH0_AUDIENCE=https://your-audience
-```
-
-| Parameter | 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 |
-| `TEMPLE_PARTY_ID` | Yes | Temple's party ID on the network |
-| `VALIDATOR_DSO_PARTY_ID` | Yes | The DSO (Decentralized Synchronizer Operator) party ID |
-| `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 |
-
-The SDK fetches and caches JWT tokens automatically via Auth0.
-
-You can also call `initializeConfig()` in Node.js to override specific environment variables at runtime. For example, if a frontend passes a JWT token to your server:
-
-```javascript
-import { initializeConfig, getUserBalances } from '@temple-digital-group/temple-canton-js';
-
-// .env provides base config (NETWORK, VALIDATOR_API_URL, etc.)
-// Override with a token received from the frontend
-initializeConfig({ JWT_TOKEN: tokenFromFrontend });
-
-const balances = await getUserBalances(partyId);
-```
-
-Runtime config values take precedence over environment variables.
+> **Legacy:** Environment variables are still supported for backwards compatibility, but `initializeConfig()` is the recommended approach.
 
 
 ## Supported Instruments
@@ -196,6 +162,7 @@ if (counts.largestUnlocked >= requiredAmount) {
 | 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
@@ -265,7 +232,3 @@ These functions are synchronous and work in all environments (no ledger or provi
 | 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) |
-
-## License
-
-MIT

package/package.json

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

package/src/config/index.js

@@ -15,6 +15,18 @@ export function initializeConfig(config) {
 	appConfig = config;
 }
 
+/**
+ * Update the JWT token without re-initializing the full config.
+ * Useful when refreshing tokens for custom validator connections.
+ * @param {string} token - The new JWT token
+ */
+export function setJWTToken(token) {
+	if (!appConfig) {
+		appConfig = {};
+	}
+	appConfig.JWT_TOKEN = token;
+}
+
 /**
  * Get a configuration value from:
  * 1. App-provided config (if initializeConfig was called)
@@ -45,6 +57,8 @@ export const NETWORK_MAINNET = "mainnet";
 // Network-specific contract values (Orchestrator & Featured App)
 const NETWORK_CONTRACTS = {
 	[NETWORK_MAINNET]: {
+		TEMPLE_PARTY_ID: "temple-mainnet-1::1220f238bb79df3efbbac2ea964c3cd501003971a2cb59043e2dac50b06e85b8620f",
+		VALIDATOR_DSO_PARTY_ID: "DSO::1220b1431ef217342db44d516bb9befde802be7d8899637d290895fa58880f19accc",
 		CONTRACT_ORCHESTRATOR_ID: "0026c99f5f6b8962cba69aee6392c65a2b5968a426ea18e971ec711259acd2e02eca12122024481221b69db9257de7875d2d74484a25a8b5795c77bc684442e812ff06ce81",
 		TEMPLATE_ID_ORCHESTRATOR: "0110667c2e17ca40d2aa7396d3b40e228c770d203676b6950ac819de86cf6964:Temple.Order.Orchestrator:Orchestrator",
 		DISCLOSURE_ORCHESTRATOR: "CgMyLjEStgMKRQAmyZ9fa4liy6aa7mOSxlorWWikJuoY6XHscRJZrNLgLsoSEiAkSBIhtp25JX3nh10tdEhKJai1eVx3vGhEQugS/wbOgRIRdGVtcGxlLW9yZGVyLWltcGwabQpAMDExMDY2N2MyZTE3Y2E0MGQyYWE3Mzk2ZDNiNDBlMjI4Yzc3MGQyMDM2NzZiNjk1MGFjODE5ZGU4NmNmNjk2NBIGVGVtcGxlEgVPcmRlchIMT3JjaGVzdHJhdG9yGgxPcmNoZXN0cmF0b3IiXmpcCloKWDpWdGVtcGxlLW1haW5uZXQtMTo6MTIyMGYyMzhiYjc5ZGYzZWZiYmFjMmVhOTY0YzNjZDUwMTAwMzk3MWEyY2I1OTA0M2UyZGFjNTBiMDZlODViODYyMGYqVnRlbXBsZS1tYWlubmV0LTE6OjEyMjBmMjM4YmI3OWRmM2VmYmJhYzJlYTk2NGMzY2Q1MDEwMDM5NzFhMmNiNTkwNDNlMmRhYzUwYjA2ZTg1Yjg2MjBmOeBCMhKJSAYAQioKJgokCAESIFBZFBJVc2L/ITJ2Y+Bz1lRHAVUnkiSiZJFuvzwlYwUyEB4=",
@@ -55,6 +69,8 @@ const NETWORK_CONTRACTS = {
 		SYNCHRONIZER_FEATURED_APP: "global-domain::1220b1431ef217342db44d516bb9befde802be7d8899637d290895fa58880f19accc",
 	},
 	[NETWORK_TESTNET]: {
+		TEMPLE_PARTY_ID: "temple-testnet-1::12209b8dd6bb0fdc220f1a78ec54a10ece9e959e30d369c391b2f1efdb84f2b48262",
+		VALIDATOR_DSO_PARTY_ID: "DSO::1220f22a8b8f2d813c25b9a684dc4dd52b532a0174d8e73a13cdf2baabfff7518337",
 		CONTRACT_ORCHESTRATOR_ID: "00ef7791cb51b45194791ba1d6d83f969878f17dfde50970daf9f8279c87417346ca1212202bb3d941b036cfcb8893b99d1ffd1bcc66e3999b5d67d4f6b77a728298f4fcdf",
 		TEMPLATE_ID_ORCHESTRATOR: "0110667c2e17ca40d2aa7396d3b40e228c770d203676b6950ac819de86cf6964:Temple.Order.Orchestrator:Orchestrator",
 		DISCLOSURE_ORCHESTRATOR: "CgMyLjEStgMKRQDvd5HLUbRRlHkbodbYP5aYePF9/eUJcNr5+Cech0FzRsoSEiArs9lBsDbPy4iTuZ0f/RvMZuOZm11n1Pa3enKCmPT83xIRdGVtcGxlLW9yZGVyLWltcGwabQpAMDExMDY2N2MyZTE3Y2E0MGQyYWE3Mzk2ZDNiNDBlMjI4Yzc3MGQyMDM2NzZiNjk1MGFjODE5ZGU4NmNmNjk2NBIGVGVtcGxlEgVPcmRlchIMT3JjaGVzdHJhdG9yGgxPcmNoZXN0cmF0b3IiXmpcCloKWDpWdGVtcGxlLXRlc3RuZXQtMTo6MTIyMDliOGRkNmJiMGZkYzIyMGYxYTc4ZWM1NGExMGVjZTllOTU5ZTMwZDM2OWMzOTFiMmYxZWZkYjg0ZjJiNDgyNjIqVnRlbXBsZS10ZXN0bmV0LTE6OjEyMjA5YjhkZDZiYjBmZGMyMjBmMWE3OGVjNTRhMTBlY2U5ZTk1OWUzMGQzNjljMzkxYjJmMWVmZGI4NGYyYjQ4MjYyOREf61eFSAYAQioKJgokCAESIIENK9R3ypVBYdnm6oV0J/a3GgdUNLbBFReq5znIYhc4EB4=",
@@ -85,9 +101,9 @@ const config = {
 	// Validator connection settings
 	get VALIDATOR_API_URL() { return getConfigValue("VALIDATOR_API_URL"); },
 	get VALIDATOR_SCAN_API_URL() { return getConfigValue("VALIDATOR_SCAN_API_URL"); },
-	get VALIDATOR_DSO_PARTY_ID() { return getConfigValue("VALIDATOR_DSO_PARTY_ID"); },
+	get VALIDATOR_DSO_PARTY_ID() { return getNetworkContract("VALIDATOR_DSO_PARTY_ID"); },
 	get VALIDATOR_USER_PARTY_ID() { return getConfigValue("VALIDATOR_USER_PARTY_ID"); },
-	get TEMPLE_PARTY_ID() { return getConfigValue("TEMPLE_PARTY_ID"); },
+	get TEMPLE_PARTY_ID() { return getNetworkContract("TEMPLE_PARTY_ID"); },
 
 	// Auth0 settings
 	get AUTH0_TOKEN_URL() { return getConfigValue("AUTH0_TOKEN_URL"); },

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2025 Temple Digital Group
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.