@fairmint/canton-node-sdk 0.0.57 → 0.0.58

package/build/src/utils/contracts/contract-monitor.d.ts

@@ -0,0 +1,23 @@
+import { LedgerJsonApiClient } from '../../clients/ledger-json-api';
+/**
+ * Options for waiting for contract archival
+ */
+export interface WaitForContractArchivalOptions {
+    /** Maximum time to wait in milliseconds (default: 300000 = 5 minutes) */
+    maxWaitTimeMs?: number;
+    /** Interval between checks in milliseconds (default: 5000 = 5 seconds) */
+    checkIntervalMs?: number;
+    /** Whether to enable verbose logging */
+    verbose?: boolean;
+}
+/**
+ * Waits for a contract to be archived by periodically checking active contracts
+ *
+ * @param ledgerJsonApiClient - The Ledger JSON API client instance
+ * @param contractId - The ID of the contract to monitor
+ * @param options - Configuration options for the wait operation
+ * @returns Promise that resolves when the contract is archived or rejects on timeout
+ * @throws Error if the contract is not archived within the specified timeout
+ */
+export declare function waitForContractToBeArchived(ledgerJsonApiClient: LedgerJsonApiClient, contractId: string, options?: WaitForContractArchivalOptions): Promise<void>;
+//# sourceMappingURL=contract-monitor.d.ts.map

package/build/src/utils/contracts/contract-monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-monitor.d.ts","sourceRoot":"","sources":["../../../../src/utils/contracts/contract-monitor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C,yEAAyE;IACzE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0EAA0E;IAC1E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,wCAAwC;IACxC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,wBAAsB,2BAA2B,CAC/C,mBAAmB,EAAE,mBAAmB,EACxC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,8BAAmC,GAC3C,OAAO,CAAC,IAAI,CAAC,CAiDf"}

package/build/src/utils/contracts/contract-monitor.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.waitForContractToBeArchived = waitForContractToBeArchived;
+/**
+ * Waits for a contract to be archived by periodically checking active contracts
+ *
+ * @param ledgerJsonApiClient - The Ledger JSON API client instance
+ * @param contractId - The ID of the contract to monitor
+ * @param options - Configuration options for the wait operation
+ * @returns Promise that resolves when the contract is archived or rejects on timeout
+ * @throws Error if the contract is not archived within the specified timeout
+ */
+async function waitForContractToBeArchived(ledgerJsonApiClient, contractId, options = {}) {
+    const { maxWaitTimeMs = 300000, // 5 minutes default
+    checkIntervalMs = 5000, // 5 seconds default
+    verbose = true } = options;
+    const startTime = Date.now();
+    if (verbose) {
+        console.log(`⏳ Waiting for contract ${contractId} to be archived...`);
+    }
+    while (Date.now() - startTime < maxWaitTimeMs) {
+        try {
+            // Get active contracts to check if our contract is still active
+            const activeContracts = await ledgerJsonApiClient.getActiveContracts({
+                filter: { filtersByParty: { [ledgerJsonApiClient.getPartyId()]: {} } },
+                verbose: true,
+                activeAtOffset: (await ledgerJsonApiClient.getLedgerEnd(undefined)).offset,
+            });
+            // Check if our contract is still in the active contracts list
+            const isStillActive = Array.isArray(activeContracts) &&
+                activeContracts.some((contract) => {
+                    const createdEvent = contract?.contractEntry?.JsActiveContract?.createdEvent;
+                    return createdEvent?.contractId === contractId;
+                });
+            if (!isStillActive) {
+                if (verbose) {
+                    console.log(`✅ Contract ${contractId} has been archived successfully`);
+                }
+                return;
+            }
+            if (verbose) {
+                console.log(`⏳ Contract ${contractId} is still active, waiting...`);
+            }
+            await new Promise(resolve => setTimeout(resolve, checkIntervalMs));
+        }
+        catch (error) {
+            console.error('❌ Error checking contract status:', error instanceof Error ? error.message : 'Unknown error');
+            // Continue waiting even if there's an error checking status
+            await new Promise(resolve => setTimeout(resolve, checkIntervalMs));
+        }
+    }
+    throw new Error(`Timeout waiting for contract ${contractId} to be archived after ${maxWaitTimeMs / 1000} seconds`);
+}
+//# sourceMappingURL=contract-monitor.js.map

package/build/src/utils/contracts/contract-monitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-monitor.js","sourceRoot":"","sources":["../../../../src/utils/contracts/contract-monitor.ts"],"names":[],"mappings":";;AAuBA,kEAqDC;AA9DD;;;;;;;;GAQG;AACI,KAAK,UAAU,2BAA2B,CAC/C,mBAAwC,EACxC,UAAkB,EAClB,UAA0C,EAAE;IAE5C,MAAM,EACJ,aAAa,GAAG,MAAM,EAAE,oBAAoB;IAC5C,eAAe,GAAG,IAAI,EAAE,oBAAoB;IAC5C,OAAO,GAAG,IAAI,EACf,GAAG,OAAO,CAAC;IAEZ,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,CAAC,GAAG,CAAC,0BAA0B,UAAU,oBAAoB,CAAC,CAAC;IACxE,CAAC;IAED,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,GAAG,aAAa,EAAE,CAAC;QAC9C,IAAI,CAAC;YACH,gEAAgE;YAChE,MAAM,eAAe,GAAG,MAAM,mBAAmB,CAAC,kBAAkB,CAAC;gBACnE,MAAM,EAAE,EAAE,cAAc,EAAE,EAAE,CAAC,mBAAmB,CAAC,UAAU,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE;gBACtE,OAAO,EAAE,IAAI;gBACb,cAAc,EAAE,CAAC,MAAM,mBAAmB,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM;aAC3E,CAAC,CAAC;YAEH,8DAA8D;YAC9D,MAAM,aAAa,GAAG,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC;gBAClD,eAAe,CAAC,IAAI,CAAC,CAAC,QAAa,EAAE,EAAE;oBACrC,MAAM,YAAY,GAAG,QAAQ,EAAE,aAAa,EAAE,gBAAgB,EAAE,YAAY,CAAC;oBAC7E,OAAO,YAAY,EAAE,UAAU,KAAK,UAAU,CAAC;gBACjD,CAAC,CAAC,CAAC;YAEL,IAAI,CAAC,aAAa,EAAE,CAAC;gBACnB,IAAI,OAAO,EAAE,CAAC;oBACZ,OAAO,CAAC,GAAG,CAAC,cAAc,UAAU,iCAAiC,CAAC,CAAC;gBACzE,CAAC;gBACD,OAAO;YACT,CAAC;YAED,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,GAAG,CAAC,cAAc,UAAU,8BAA8B,CAAC,CAAC;YACtE,CAAC;YACD,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC;QAErE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;YAC7G,4DAA4D;YAC5D,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,gCAAgC,UAAU,yBAAyB,aAAa,GAAG,IAAI,UAAU,CAAC,CAAC;AACrH,CAAC"}

package/build/src/utils/contracts/index.d.ts

@@ -1,2 +1,3 @@
 export * from './disclosed-contracts';
+export * from './contract-monitor';
 //# sourceMappingURL=index.d.ts.map

package/build/src/utils/contracts/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/contracts/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/contracts/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC"}

package/build/src/utils/contracts/index.js

@@ -15,4 +15,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./disclosed-contracts"), exports);
+__exportStar(require("./contract-monitor"), exports);
 //# sourceMappingURL=index.js.map

package/build/src/utils/contracts/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/utils/contracts/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/utils/contracts/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC;AACtC,qDAAmC"}

package/build/src/utils/mining/mining-rounds.d.ts

@@ -21,4 +21,13 @@ export interface MiningRoundContext {
  * @throws Error if no mining round satisfies the criteria
  */
 export declare function getCurrentMiningRoundContext(validatorClient: ValidatorApiClient): Promise<MiningRoundContext>;
+/**
+ * Gets the domain ID from the current mining round context.
+ * This is useful for operations that need to automatically determine the domain ID.
+ *
+ * @param validatorClient - Validator API client for getting mining round information
+ * @returns Promise resolving to the domain ID string
+ * @throws Error if no mining round satisfies the criteria
+ */
+export declare function getCurrentMiningRoundDomainId(validatorClient: ValidatorApiClient): Promise<string>;
 //# sourceMappingURL=mining-rounds.d.ts.map

package/build/src/utils/mining/mining-rounds.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mining-rounds.d.ts","sourceRoot":"","sources":["../../../../src/utils/mining/mining-rounds.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,oEAAoE;IACpE,eAAe,EAAE,MAAM,CAAC;IACxB,8EAA8E;IAC9E,uBAAuB,EAAE,YAAY,CAAC;IACtC,4DAA4D;IAC5D,mBAAmB,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnE;AAED;;;;;GAKG;AACH,wBAAsB,4BAA4B,CAChD,eAAe,EAAE,kBAAkB,GAClC,OAAO,CAAC,kBAAkB,CAAC,CA2C7B"}
+{"version":3,"file":"mining-rounds.d.ts","sourceRoot":"","sources":["../../../../src/utils/mining/mining-rounds.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,oEAAoE;IACpE,eAAe,EAAE,MAAM,CAAC;IACxB,8EAA8E;IAC9E,uBAAuB,EAAE,YAAY,CAAC;IACtC,4DAA4D;IAC5D,mBAAmB,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnE;AAED;;;;;GAKG;AACH,wBAAsB,4BAA4B,CAChD,eAAe,EAAE,kBAAkB,GAClC,OAAO,CAAC,kBAAkB,CAAC,CA2C7B;AAED;;;;;;;GAOG;AACH,wBAAsB,6BAA6B,CACjD,eAAe,EAAE,kBAAkB,GAClC,OAAO,CAAC,MAAM,CAAC,CAGjB"}

package/build/src/utils/mining/mining-rounds.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getCurrentMiningRoundContext = getCurrentMiningRoundContext;
+exports.getCurrentMiningRoundDomainId = getCurrentMiningRoundDomainId;
 /**
  * Finds the latest mining round that is currently open (\`opensAt\` is in the past)
  * and returns useful context information.
@@ -44,4 +45,16 @@ async function getCurrentMiningRoundContext(validatorClient) {
         issuingMiningRounds,
     };
 }
+/**
+ * Gets the domain ID from the current mining round context.
+ * This is useful for operations that need to automatically determine the domain ID.
+ *
+ * @param validatorClient - Validator API client for getting mining round information
+ * @returns Promise resolving to the domain ID string
+ * @throws Error if no mining round satisfies the criteria
+ */
+async function getCurrentMiningRoundDomainId(validatorClient) {
+    const miningRoundContext = await getCurrentMiningRoundContext(validatorClient);
+    return miningRoundContext.openMiningRoundContract.synchronizerId;
+}
 //# sourceMappingURL=mining-rounds.js.map

package/build/src/utils/mining/mining-rounds.js.map

@@ -1 +1 @@
-{"version":3,"file":"mining-rounds.js","sourceRoot":"","sources":["../../../../src/utils/mining/mining-rounds.ts"],"names":[],"mappings":";;AAsBA,oEA6CC;AAnDD;;;;;GAKG;AACI,KAAK,UAAU,4BAA4B,CAChD,eAAmC;IAEnC,MAAM,oBAAoB,GACxB,MAAM,eAAe,CAAC,6BAA6B,EAAE,CAAC;IAExD,8DAA8D;IAC9D,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,eAAe,GAAG,oBAAoB,CAAC,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;QAC7E,IAAI,CAAC;YACH,MAAM,UAAU,GAAI,KAAa,EAAE,QAAQ,EAAE,OAAO,EAAE,OAA6B,CAAC;YACpF,IAAI,CAAC,UAAU;gBAAE,OAAO,KAAK,CAAC;YAC9B,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC;YACrC,OAAO,OAAO,IAAI,GAAG,CAAC;QACxB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IAED,kEAAkE;IAClE,MAAM,aAAa,GAAG,eAAe,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,CAAQ,CAAC;IAEzE,MAAM,uBAAuB,GAAiB;QAC5C,UAAU,EAAE,aAAa,CAAC,QAAQ,CAAC,WAAW;QAC9C,UAAU,EAAE,aAAa,CAAC,QAAQ,CAAC,WAAW;QAC9C,gBAAgB,EAAE,aAAa,CAAC,QAAQ,CAAC,kBAAkB;QAC3D,cAAc,EAAE,aAAa,CAAC,SAAS,EAAE,sDAAsD;KAChG,CAAC;IAEF,MAAM,mBAAmB,GAAG,CAAC,oBAAoB,CAAC,qBAAqB,IAAI,EAAE,CAAC,CAAC,GAAG,CAChF,CAAC,KAAU,EAAE,EAAE,CAAC,CAAC;QACf,KAAK,EAAE,KAAK,CAAC,YAAsB;QACnC,UAAU,EAAE,CAAC,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,QAAQ,EAAE,WAAW,CAAW;KACzE,CAAC,CACH,CAAC;IAEF,OAAO;QACL,eAAe,EAAE,uBAAuB,CAAC,UAAU;QACnD,uBAAuB;QACvB,mBAAmB;KACpB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"mining-rounds.js","sourceRoot":"","sources":["../../../../src/utils/mining/mining-rounds.ts"],"names":[],"mappings":";;AAsBA,oEA6CC;AAUD,sEAKC;AAlED;;;;;GAKG;AACI,KAAK,UAAU,4BAA4B,CAChD,eAAmC;IAEnC,MAAM,oBAAoB,GACxB,MAAM,eAAe,CAAC,6BAA6B,EAAE,CAAC;IAExD,8DAA8D;IAC9D,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,eAAe,GAAG,oBAAoB,CAAC,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;QAC7E,IAAI,CAAC;YACH,MAAM,UAAU,GAAI,KAAa,EAAE,QAAQ,EAAE,OAAO,EAAE,OAA6B,CAAC;YACpF,IAAI,CAAC,UAAU;gBAAE,OAAO,KAAK,CAAC;YAC9B,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC;YACrC,OAAO,OAAO,IAAI,GAAG,CAAC;QACxB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IAED,kEAAkE;IAClE,MAAM,aAAa,GAAG,eAAe,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,CAAQ,CAAC;IAEzE,MAAM,uBAAuB,GAAiB;QAC5C,UAAU,EAAE,aAAa,CAAC,QAAQ,CAAC,WAAW;QAC9C,UAAU,EAAE,aAAa,CAAC,QAAQ,CAAC,WAAW;QAC9C,gBAAgB,EAAE,aAAa,CAAC,QAAQ,CAAC,kBAAkB;QAC3D,cAAc,EAAE,aAAa,CAAC,SAAS,EAAE,sDAAsD;KAChG,CAAC;IAEF,MAAM,mBAAmB,GAAG,CAAC,oBAAoB,CAAC,qBAAqB,IAAI,EAAE,CAAC,CAAC,GAAG,CAChF,CAAC,KAAU,EAAE,EAAE,CAAC,CAAC;QACf,KAAK,EAAE,KAAK,CAAC,YAAsB;QACnC,UAAU,EAAE,CAAC,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,QAAQ,EAAE,WAAW,CAAW;KACzE,CAAC,CACH,CAAC;IAEF,OAAO;QACL,eAAe,EAAE,uBAAuB,CAAC,UAAU;QACnD,uBAAuB;QACvB,mBAAmB;KACpB,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACI,KAAK,UAAU,6BAA6B,CACjD,eAAmC;IAEnC,MAAM,kBAAkB,GAAG,MAAM,4BAA4B,CAAC,eAAe,CAAC,CAAC;IAC/E,OAAO,kBAAkB,CAAC,uBAAuB,CAAC,cAAc,CAAC;AACnE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fairmint/canton-node-sdk",
-  "version": "0.0.57",
+  "version": "0.0.58",
   "description": "Canton Node SDK",
   "main": "build/src/index.js",
   "types": "build/src/index.d.ts",