@fairmint/canton-node-sdk 0.0.214 → 0.0.215

package/build/src/utils/canton-response-utils.d.ts

@@ -1,3 +1,44 @@
+export type CantonContractCreateArgument = readonly unknown[] | Record<string, unknown> | string | number | boolean | null;
+export interface CantonNormalizedContract {
+    readonly contractId: string;
+    readonly templateId: string;
+    readonly createArgument: CantonContractCreateArgument;
+    readonly createdEventBlob: string | null;
+    readonly createdAt: string | null;
+}
+export interface CantonInstrumentId {
+    readonly admin: string;
+    readonly id: string;
+}
+export interface CantonUnlockedUtxo {
+    readonly contractId: string;
+    readonly amount: string;
+    readonly metadata?: Record<string, unknown>;
+}
+export interface CantonLockedUtxo {
+    readonly contractId: string;
+    readonly amount: string;
+    readonly lock?: Record<string, unknown>;
+    readonly metadata?: Record<string, unknown>;
+}
+export interface CantonTokenBalance {
+    readonly instrumentId: CantonInstrumentId;
+    readonly totalUnlockedBalance: string;
+    readonly totalLockedBalance: string;
+    readonly totalBalance: string;
+    readonly unlockedUtxos: readonly CantonUnlockedUtxo[];
+    readonly lockedUtxos: readonly CantonLockedUtxo[];
+}
+export interface CantonWalletBalances {
+    readonly partyId: string;
+    readonly fetchedAt: string;
+    readonly tokens: readonly CantonTokenBalance[];
+}
+export interface CantonCoinBalanceLookupOptions {
+    readonly expectedAdmin: string;
+}
 export declare function readRequiredString(source: unknown, key: string, operation: string): string;
 export declare function objectOrEmpty(value: unknown): Record<string, unknown>;
+export declare function normalizeCantonContractItem(item: unknown): CantonNormalizedContract;
+export declare function findCantonCoinBalance(balances: CantonWalletBalances | null | undefined, options: CantonCoinBalanceLookupOptions): CantonTokenBalance | null;
 //# sourceMappingURL=canton-response-utils.d.ts.map

package/build/src/utils/canton-response-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"canton-response-utils.d.ts","sourceRoot":"","sources":["../../../src/utils/canton-response-utils.ts"],"names":[],"mappings":"AAGA,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAS1F;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAErE"}
+{"version":3,"file":"canton-response-utils.d.ts","sourceRoot":"","sources":["../../../src/utils/canton-response-utils.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,4BAA4B,GACpC,SAAS,OAAO,EAAE,GAClB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACvB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,CAAC;AAET,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,4BAA4B,CAAC;IACtD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAC;IAC1C,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACtD,QAAQ,CAAC,WAAW,EAAE,SAAS,gBAAgB,EAAE,CAAC;CACnD;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,kBAAkB,EAAE,CAAC;CAChD;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAS1F;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAErE;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,OAAO,GAAG,wBAAwB,CAMnF;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,oBAAoB,GAAG,IAAI,GAAG,SAAS,EACjD,OAAO,EAAE,8BAA8B,GACtC,kBAAkB,GAAG,IAAI,CAe3B"}

package/build/src/utils/canton-response-utils.js

@@ -2,6 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.readRequiredString = readRequiredString;
 exports.objectOrEmpty = objectOrEmpty;
+exports.normalizeCantonContractItem = normalizeCantonContractItem;
+exports.findCantonCoinBalance = findCantonCoinBalance;
 const errors_1 = require("../core/errors");
 const utils_1 = require("../core/utils");
 function readRequiredString(source, key, operation) {
@@ -15,4 +17,72 @@ function readRequiredString(source, key, operation) {
 function objectOrEmpty(value) {
     return (0, utils_1.isRecord)(value) ? value : {};
 }
+function normalizeCantonContractItem(item) {
+    if (!(0, utils_1.isRecord)(item)) {
+        return emptyNormalizedContract();
+    }
+    return contractFromCreatedEvent(findCreatedEventPayload(item));
+}
+function findCantonCoinBalance(balances, options) {
+    const expectedAdmin = options.expectedAdmin.trim();
+    if (!expectedAdmin)
+        return null;
+    let partialMatch = null;
+    for (const token of balances?.tokens ?? []) {
+        if (token.instrumentId.admin !== expectedAdmin)
+            continue;
+        const instrumentId = token.instrumentId.id;
+        if (instrumentId === 'Amulet')
+            return token;
+        if (!partialMatch && instrumentId.toLowerCase() === 'amulet') {
+            partialMatch = token;
+        }
+    }
+    return partialMatch;
+}
+function findCreatedEventPayload(item) {
+    const contractEntry = toRecord(item['contractEntry']);
+    const activeContract = toRecord(contractEntry?.['JsActiveContract']);
+    const createdEvent = toRecord(activeContract?.['createdEvent']);
+    return createdEvent ?? item;
+}
+function contractFromCreatedEvent(createdEvent) {
+    return {
+        contractId: toStringField(createdEvent['contractId']),
+        templateId: toStringField(createdEvent['templateId']),
+        createArgument: toCreateArgument(createdEvent['createArgument']),
+        createdEventBlob: toNullableStringField(createdEvent['createdEventBlob']),
+        createdAt: toNullableStringField(createdEvent['createdAt']),
+    };
+}
+function emptyNormalizedContract() {
+    return {
+        contractId: '',
+        templateId: '',
+        createArgument: null,
+        createdEventBlob: null,
+        createdAt: null,
+    };
+}
+function toRecord(value) {
+    return (0, utils_1.isRecord)(value) ? value : null;
+}
+function toCreateArgument(value) {
+    if (value == null)
+        return null;
+    if (Array.isArray(value))
+        return value;
+    if ((0, utils_1.isRecord)(value))
+        return value;
+    if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {
+        return value;
+    }
+    return null;
+}
+function toStringField(value) {
+    return typeof value === 'string' ? value : '';
+}
+function toNullableStringField(value) {
+    return typeof value === 'string' ? value : null;
+}
 //# sourceMappingURL=canton-response-utils.js.map

package/build/src/utils/canton-response-utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"canton-response-utils.js","sourceRoot":"","sources":["../../../src/utils/canton-response-utils.ts"],"names":[],"mappings":";;AAGA,gDASC;AAED,sCAEC;AAhBD,2CAAoE;AACpE,yCAAyC;AAEzC,SAAgB,kBAAkB,CAAC,MAAe,EAAE,GAAW,EAAE,SAAiB;IAChF,IAAI,IAAA,gBAAQ,EAAC,MAAM,CAAC,IAAI,GAAG,IAAI,MAAM,EAAE,CAAC;QACtC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE;YAAE,OAAO,KAAK,CAAC;IAC9D,CAAC;IACD,MAAM,IAAI,uBAAc,CACtB,UAAU,SAAS,6BAA6B,GAAG,EAAE,EACrD,2BAAkB,CAAC,kBAAkB,CACtC,CAAC;AACJ,CAAC;AAED,SAAgB,aAAa,CAAC,KAAc;IAC1C,OAAO,IAAA,gBAAQ,EAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AACtC,CAAC"}
+{"version":3,"file":"canton-response-utils.js","sourceRoot":"","sources":["../../../src/utils/canton-response-utils.ts"],"names":[],"mappings":"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"}

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

@@ -1,4 +1,5 @@
 export * from './amulet';
+export * from './canton-response-utils';
 export * from './contracts';
 export * from './external-signing';
 export * from './health';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,yBAAyB,CAAC;AACxC,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC"}

package/build/src/utils/index.js

@@ -15,6 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./amulet"), exports);
+__exportStar(require("./canton-response-utils"), exports);
 __exportStar(require("./contracts"), exports);
 __exportStar(require("./external-signing"), exports);
 __exportStar(require("./health"), exports);

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,8CAA4B;AAC5B,qDAAmC;AACnC,2CAAyB;AACzB,2CAAyB;AACzB,4CAA0B;AAC1B,0CAAwB;AACxB,4CAA0B;AAC1B,iDAA+B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,0DAAwC;AACxC,8CAA4B;AAC5B,qDAAmC;AACnC,2CAAyB;AACzB,2CAAyB;AACzB,4CAA0B;AAC1B,0CAAwB;AACxB,4CAA0B;AAC1B,iDAA+B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fairmint/canton-node-sdk",
-  "version": "0.0.214",
+  "version": "0.0.215",
   "description": "Canton Node SDK",
   "keywords": [
     "canton",