@open-captable-protocol/canton 0.2.106 → 0.2.107

package/dist/utils/ocfComparison.d.ts

@@ -0,0 +1,31 @@
+/**
+ * OCF (Open Cap Table Format) comparison utilities.
+ *
+ * Provides semantic equality comparison for OCF objects with normalization to handle common variations in numeric
+ * precision and empty values.
+ *
+ * @module ocfComparison
+ */
+/**
+ * Deep equality comparison for OCF objects with normalization.
+ *
+ * This comparison:
+ *
+ * - Normalizes numeric strings to fixed precision
+ * - Treats empty arrays/objects as equivalent to undefined
+ * - Trims string whitespace
+ * - Recursively compares nested objects
+ *
+ * @example
+ *   ```typescript
+ *   const obj1 = { quantity: '100.0000000000', name: 'Test' };
+ *   const obj2 = { quantity: '100', name: 'Test' };
+ *   ocfDeepEqual(obj1, obj2); // true - normalized numbers match
+ *   ```;
+ *
+ * @param a - First OCF object
+ * @param b - Second OCF object
+ * @returns True if objects are semantically equal
+ */
+export declare function ocfDeepEqual(a: unknown, b: unknown): boolean;
+//# sourceMappingURL=ocfComparison.d.ts.map

package/dist/utils/ocfComparison.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ocfComparison.d.ts","sourceRoot":"","sources":["../../src/utils/ocfComparison.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA8FH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CA4C5D"}

package/dist/utils/ocfComparison.js

@@ -0,0 +1,167 @@
+"use strict";
+/**
+ * OCF (Open Cap Table Format) comparison utilities.
+ *
+ * Provides semantic equality comparison for OCF objects with normalization to handle common variations in numeric
+ * precision and empty values.
+ *
+ * @module ocfComparison
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ocfDeepEqual = ocfDeepEqual;
+/**
+ * Normalize a value for OCF comparison.
+ *
+ * Handles common variations that should be considered equal:
+ *
+ * - Numbers as strings are converted to fixed precision
+ * - Whitespace is trimmed from strings
+ *
+ * @param value - Value to normalize
+ * @returns Normalized value for comparison
+ */
+function normalizeOcfValue(value) {
+    if (typeof value === 'string') {
+        // Trim whitespace to avoid mismatches due to leading/trailing spaces
+        const trimmed = value.trim();
+        // Try to parse as a number after trimming
+        const num = Number(trimmed);
+        if (!isNaN(num) && isFinite(num)) {
+            // Convert to fixed precision for consistent comparison
+            return num.toFixed(10);
+        }
+        return trimmed;
+    }
+    return value;
+}
+/**
+ * Check if a value should be treated as undefined/empty for comparison purposes.
+ *
+ * Handles OCF-specific patterns where empty/null/placeholder values should match:
+ *
+ * - Null, undefined
+ * - Empty strings or whitespace-only strings
+ * - Empty arrays or arrays where all elements are undefined-like
+ * - Empty objects or objects where all values are undefined-like
+ * - ShareNumberRange objects with 0-0 range (placeholder)
+ *
+ * @param value - Value to check
+ * @returns True if value should be treated as undefined
+ */
+function isUndefinedLike(value) {
+    // Null or undefined
+    if (value === undefined || value === null)
+        return true;
+    // Blank string (including whitespace-only)
+    if (typeof value === 'string' && value.trim() === '')
+        return true;
+    // Helper: detect a ShareNumberRange object with both start/end equal to zero
+    const isZeroShareRange = (v) => {
+        if (!v || typeof v !== 'object')
+            return false;
+        const obj = v;
+        const startRaw = obj['starting_share_number'];
+        const endRaw = obj['ending_share_number'];
+        // Both keys must exist
+        if (startRaw === undefined || endRaw === undefined)
+            return false;
+        const parseToNumber = (x) => {
+            if (typeof x === 'number')
+                return x;
+            if (typeof x === 'string') {
+                const n = Number(x.trim());
+                return isNaN(n) ? NaN : n;
+            }
+            return NaN;
+        };
+        const start = parseToNumber(startRaw);
+        const end = parseToNumber(endRaw);
+        return !isNaN(start) && !isNaN(end) && start === 0 && end === 0;
+    };
+    // Arrays: treat as undefined-like if empty or every element is undefined-like
+    // Also treat arrays composed entirely of 0-0 share number ranges as undefined-like placeholders
+    if (Array.isArray(value)) {
+        if (value.length === 0)
+            return true;
+        if (value.every((v) => isUndefinedLike(v)))
+            return true;
+        if (value.every((v) => isZeroShareRange(v)))
+            return true;
+        return false;
+    }
+    // Objects: treat as undefined-like if empty or every property is undefined-like
+    // Also treat a single 0-0 ShareNumberRange object as undefined-like placeholder
+    if (typeof value === 'object') {
+        const obj = value;
+        const keys = Object.keys(obj);
+        if (keys.length === 0)
+            return true;
+        if (isZeroShareRange(value))
+            return true;
+        return keys.every((k) => isUndefinedLike(obj[k]));
+    }
+    return false;
+}
+/**
+ * Deep equality comparison for OCF objects with normalization.
+ *
+ * This comparison:
+ *
+ * - Normalizes numeric strings to fixed precision
+ * - Treats empty arrays/objects as equivalent to undefined
+ * - Trims string whitespace
+ * - Recursively compares nested objects
+ *
+ * @example
+ *   ```typescript
+ *   const obj1 = { quantity: '100.0000000000', name: 'Test' };
+ *   const obj2 = { quantity: '100', name: 'Test' };
+ *   ocfDeepEqual(obj1, obj2); // true - normalized numbers match
+ *   ```;
+ *
+ * @param a - First OCF object
+ * @param b - Second OCF object
+ * @returns True if objects are semantically equal
+ */
+function ocfDeepEqual(a, b) {
+    // Consider empty arrays equivalent to undefined
+    if (isUndefinedLike(a) && isUndefinedLike(b))
+        return true;
+    // Handle null/undefined
+    if (a === b)
+        return true;
+    if (a == null || b == null)
+        return false;
+    // Handle different types
+    if (typeof a !== typeof b)
+        return false;
+    // Handle objects and arrays
+    if (typeof a === 'object' && typeof b === 'object') {
+        const objA = a;
+        const objB = b;
+        // Get all keys
+        const keysA = Object.keys(objA);
+        const keysB = Object.keys(objB);
+        const allKeys = Array.from(new Set([...keysA, ...keysB]));
+        // Check if all keys match
+        for (const key of allKeys) {
+            const valA = objA[key];
+            const valB = objB[key];
+            // Treat empty arrays as undefined-like and skip if both are undefined-like
+            if (isUndefinedLike(valA) && isUndefinedLike(valB))
+                continue;
+            // If one is undefined-like and the other isn't, they don't match
+            if (isUndefinedLike(valA) !== isUndefinedLike(valB))
+                return false;
+            // Recursively compare values
+            if (!ocfDeepEqual(valA, valB))
+                return false;
+        }
+        return true;
+    }
+    // Handle primitive values with normalization
+    const normalizedA = normalizeOcfValue(a);
+    const normalizedB = normalizeOcfValue(b);
+    return normalizedA === normalizedB;
+}
+//# sourceMappingURL=ocfComparison.js.map

package/dist/utils/ocfComparison.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ocfComparison.js","sourceRoot":"","sources":["../../src/utils/ocfComparison.ts"],"names":[],"mappings":"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"}

package/dist/utils/ocfHelpers.d.ts

@@ -0,0 +1,63 @@
+/**
+ * OCF (Open Cap Table Format) helper utilities.
+ *
+ * General-purpose utilities for working with OCF objects and DAML contracts:
+ *
+ * - OCF ID extraction from contract data
+ * - Human-readable type labels
+ *
+ * @module ocfHelpers
+ */
+import { getAllOcfTypes, getOcfMetadata, isValidOcfType, OCF_METADATA, type OcfObjectType } from './ocfMetadata';
+/**
+ * Get the data field name used in DAML contracts for a given OCF type.
+ *
+ * This is the field name where OCF data is stored in the contract's create arguments. Useful for extracting OCF data
+ * from transaction trees.
+ *
+ * @example
+ *   ```typescript
+ *   getOcfDataFieldName('STAKEHOLDER'); // 'stakeholder_data'
+ *   getOcfDataFieldName('TX_STOCK_ISSUANCE'); // 'issuance_data'
+ *   getOcfDataFieldName('STOCK_CLASS'); // 'stock_class_data'
+ *   ```;
+ *
+ * @param type - The OCF object type
+ * @returns The data field name (e.g., 'stakeholder_data', 'issuance_data')
+ */
+export declare function getOcfDataFieldName(type: OcfObjectType): string;
+/**
+ * Extract the OCF ID from contract create arguments.
+ *
+ * Uses the type's metadata to navigate to the ID field.
+ *
+ * @example
+ *   ```typescript
+ *   const args = { stakeholder_data: { id: 'sh-123', name: { legal_name: 'John' } } };
+ *   extractOcfIdFromCreateArgs('STAKEHOLDER', args); // 'sh-123'
+ *   ```;
+ *
+ * @param type - The OCF object type
+ * @param createArgs - The contract's create arguments from a transaction tree
+ * @returns The OCF ID string, or undefined if not found
+ */
+export declare function extractOcfIdFromCreateArgs(type: OcfObjectType, createArgs: unknown): string | undefined;
+/**
+ * Get human-readable display label for an OCF type.
+ *
+ * Useful for logging, notifications, and UI display.
+ *
+ * @example
+ *   ```typescript
+ *   getOcfTypeLabel('STAKEHOLDER', 1); // '1 Stakeholder'
+ *   getOcfTypeLabel('STAKEHOLDER', 5); // '5 Stakeholders'
+ *   getOcfTypeLabel('TX_STOCK_ISSUANCE', 1); // '1 Stock Issuance'
+ *   ```;
+ *
+ * @param type - The OCF object type
+ * @param count - Number of items (for pluralization)
+ * @returns Human-readable label
+ */
+export declare function getOcfTypeLabel(type: OcfObjectType, count: number): string;
+export { getAllOcfTypes, getOcfMetadata, isValidOcfType, OCF_METADATA, type OcfObjectType };
+//# sourceMappingURL=ocfHelpers.d.ts.map

package/dist/utils/ocfHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ocfHelpers.d.ts","sourceRoot":"","sources":["../../src/utils/ocfHelpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAEjH;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAI/D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAgBvG;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CA8C1E;AAGD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,CAAC"}

package/dist/utils/ocfHelpers.js

@@ -0,0 +1,132 @@
+"use strict";
+/**
+ * OCF (Open Cap Table Format) helper utilities.
+ *
+ * General-purpose utilities for working with OCF objects and DAML contracts:
+ *
+ * - OCF ID extraction from contract data
+ * - Human-readable type labels
+ *
+ * @module ocfHelpers
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OCF_METADATA = exports.isValidOcfType = exports.getOcfMetadata = exports.getAllOcfTypes = void 0;
+exports.getOcfDataFieldName = getOcfDataFieldName;
+exports.extractOcfIdFromCreateArgs = extractOcfIdFromCreateArgs;
+exports.getOcfTypeLabel = getOcfTypeLabel;
+const ocfMetadata_1 = require("./ocfMetadata");
+Object.defineProperty(exports, "getAllOcfTypes", { enumerable: true, get: function () { return ocfMetadata_1.getAllOcfTypes; } });
+Object.defineProperty(exports, "getOcfMetadata", { enumerable: true, get: function () { return ocfMetadata_1.getOcfMetadata; } });
+Object.defineProperty(exports, "isValidOcfType", { enumerable: true, get: function () { return ocfMetadata_1.isValidOcfType; } });
+Object.defineProperty(exports, "OCF_METADATA", { enumerable: true, get: function () { return ocfMetadata_1.OCF_METADATA; } });
+/**
+ * Get the data field name used in DAML contracts for a given OCF type.
+ *
+ * This is the field name where OCF data is stored in the contract's create arguments. Useful for extracting OCF data
+ * from transaction trees.
+ *
+ * @example
+ *   ```typescript
+ *   getOcfDataFieldName('STAKEHOLDER'); // 'stakeholder_data'
+ *   getOcfDataFieldName('TX_STOCK_ISSUANCE'); // 'issuance_data'
+ *   getOcfDataFieldName('STOCK_CLASS'); // 'stock_class_data'
+ *   ```;
+ *
+ * @param type - The OCF object type
+ * @returns The data field name (e.g., 'stakeholder_data', 'issuance_data')
+ */
+function getOcfDataFieldName(type) {
+    const metadata = (0, ocfMetadata_1.getOcfMetadata)(type);
+    // The first element of ocfIdPath is the data field name
+    return metadata.ocfIdPath[0];
+}
+/**
+ * Extract the OCF ID from contract create arguments.
+ *
+ * Uses the type's metadata to navigate to the ID field.
+ *
+ * @example
+ *   ```typescript
+ *   const args = { stakeholder_data: { id: 'sh-123', name: { legal_name: 'John' } } };
+ *   extractOcfIdFromCreateArgs('STAKEHOLDER', args); // 'sh-123'
+ *   ```;
+ *
+ * @param type - The OCF object type
+ * @param createArgs - The contract's create arguments from a transaction tree
+ * @returns The OCF ID string, or undefined if not found
+ */
+function extractOcfIdFromCreateArgs(type, createArgs) {
+    if (!createArgs || typeof createArgs !== 'object') {
+        return undefined;
+    }
+    const metadata = (0, ocfMetadata_1.getOcfMetadata)(type);
+    let current = createArgs;
+    for (const key of metadata.ocfIdPath) {
+        if (current === null || current === undefined || typeof current !== 'object') {
+            return undefined;
+        }
+        current = current[key];
+    }
+    return typeof current === 'string' ? current : undefined;
+}
+/**
+ * Get human-readable display label for an OCF type.
+ *
+ * Useful for logging, notifications, and UI display.
+ *
+ * @example
+ *   ```typescript
+ *   getOcfTypeLabel('STAKEHOLDER', 1); // '1 Stakeholder'
+ *   getOcfTypeLabel('STAKEHOLDER', 5); // '5 Stakeholders'
+ *   getOcfTypeLabel('TX_STOCK_ISSUANCE', 1); // '1 Stock Issuance'
+ *   ```;
+ *
+ * @param type - The OCF object type
+ * @param count - Number of items (for pluralization)
+ * @returns Human-readable label
+ */
+function getOcfTypeLabel(type, count) {
+    // Convert type to title case and handle special cases
+    const labelMap = {
+        STOCK_CLASS: { singular: 'Stock Class', plural: 'Stock Classes' },
+        STAKEHOLDER: { singular: 'Stakeholder', plural: 'Stakeholders' },
+        STOCK_PLAN: { singular: 'Stock Plan', plural: 'Stock Plans' },
+        STOCK_LEGEND_TEMPLATE: { singular: 'Stock Legend Template', plural: 'Stock Legend Templates' },
+        DOCUMENT: { singular: 'Document', plural: 'Documents' },
+        VESTING_TERMS: { singular: 'Vesting Terms', plural: 'Vesting Terms' },
+        TX_STOCK_ISSUANCE: { singular: 'Stock Issuance', plural: 'Stock Issuances' },
+        TX_WARRANT_ISSUANCE: { singular: 'Warrant Issuance', plural: 'Warrant Issuances' },
+        TX_CONVERTIBLE_ISSUANCE: { singular: 'Convertible Issuance', plural: 'Convertible Issuances' },
+        TX_STOCK_PLAN_POOL_ADJUSTMENT: { singular: 'Stock Plan Pool Adjustment', plural: 'Stock Plan Pool Adjustments' },
+        TX_STOCK_CLASS_AUTHORIZED_SHARES_ADJUSTMENT: {
+            singular: 'Stock Class Authorized Shares Adjustment',
+            plural: 'Stock Class Authorized Shares Adjustments',
+        },
+        TX_STOCK_CANCELLATION: { singular: 'Stock Cancellation', plural: 'Stock Cancellations' },
+        TX_ISSUER_AUTHORIZED_SHARES_ADJUSTMENT: {
+            singular: 'Issuer Authorized Shares Adjustment',
+            plural: 'Issuer Authorized Shares Adjustments',
+        },
+        TX_EQUITY_COMPENSATION_ISSUANCE: {
+            singular: 'Equity Compensation Issuance',
+            plural: 'Equity Compensation Issuances',
+        },
+        TX_EQUITY_COMPENSATION_EXERCISE: {
+            singular: 'Equity Compensation Exercise',
+            plural: 'Equity Compensation Exercises',
+        },
+    };
+    const labels = labelMap[type];
+    if (labels) {
+        const label = count === 1 ? labels.singular : labels.plural;
+        return `${count} ${label}`;
+    }
+    // Fallback: convert type to title case
+    const fallback = type
+        .replace(/^TX_/, '')
+        .split('_')
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+        .join(' ');
+    return `${count} ${fallback}${count === 1 ? '' : 's'}`;
+}
+//# sourceMappingURL=ocfHelpers.js.map

package/dist/utils/ocfHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ocfHelpers.js","sourceRoot":"","sources":["../../src/utils/ocfHelpers.ts"],"names":[],"mappings":"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"}

package/dist/utils/typeConversions.d.ts

@@ -24,6 +24,14 @@ export declare function relTimeToDAML(microseconds: string): {
 export declare function damlTimeToDateString(timeString: string): string;
 /** Convert a number or string to a string Used for DAML numeric fields that require string values */
 export declare function numberToString(value: number | string): string;
+/**
+ * Normalize a numeric string by removing trailing zeros after the decimal point. DAML returns numbers like
+ * "5000000.0000000000" but OCF expects "5000000". Also handles removing the decimal point if all fractional digits are
+ * zeros.
+ *
+ * @throws Error if the string contains scientific notation (e.g., "1.5e10") or is not a valid numeric string
+ */
+export declare function normalizeNumericString(value: string): string;
 /**
  * Convert a number, string, null or undefined to a string or undefined Used for optional DAML numeric fields that
  * require string values

package/dist/utils/typeConversions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"typeConversions.d.ts","sourceRoot":"","sources":["../../src/utils/typeConversions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,uCAAuC,EAAE,MAAM,wEAAwE,CAAC;AACtI,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0CAA0C,CAAC;AACzE,OAAO,KAAK,EAAE,OAAO,EAAe,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAItE;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAM/D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG;IAAE,YAAY,EAAE,MAAM,CAAA;CAAE,CAE5E;AAED,uHAAuH;AACvH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAG/D;AAED,qGAAqG;AACrG,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAE7D;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAGpG;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAE9E;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAYjD;AAID,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAAC,YAAY,CAAC,KAAK,CAAC,WAAW,CAK1F;AAED,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,QAAQ,CAAC,YAAY,CAAC,KAAK,CAAC,WAAW,GAAG,QAAQ,CAKpG;AAkCD,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ,CAAC,YAAY,CAAC,KAAK,CAAC,UAAU,CAStF;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,QAAQ,CAAC,YAAY,CAAC,KAAK,CAAC,UAAU,GAAG,OAAO,CAWhG;AAID,gGAAgG;AAChG,wBAAgB,aAAa,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,MAAM,EAAE,CAOvE;AAID;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,uCAAuC,GAAG,MAAM,CAezF"}
+{"version":3,"file":"typeConversions.d.ts","sourceRoot":"","sources":["../../src/utils/typeConversions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,uCAAuC,EAAE,MAAM,wEAAwE,CAAC;AACtI,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0CAA0C,CAAC;AACzE,OAAO,KAAK,EAAE,OAAO,EAAe,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAItE;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAM/D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG;IAAE,YAAY,EAAE,MAAM,CAAA;CAAE,CAE5E;AAED,uHAAuH;AACvH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAG/D;AAED,qGAAqG;AACrG,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAE7D;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CA0B5D;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAGpG;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAE9E;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAYjD;AAID,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAAC,YAAY,CAAC,KAAK,CAAC,WAAW,CAK1F;AAED,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,QAAQ,CAAC,YAAY,CAAC,KAAK,CAAC,WAAW,GAAG,QAAQ,CAKpG;AAkCD,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ,CAAC,YAAY,CAAC,KAAK,CAAC,UAAU,CAStF;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,QAAQ,CAAC,YAAY,CAAC,KAAK,CAAC,UAAU,GAAG,OAAO,CAWhG;AAID,gGAAgG;AAChG,wBAAgB,aAAa,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,MAAM,EAAE,CAOvE;AAID;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,uCAAuC,GAAG,MAAM,CAezF"}

package/dist/utils/typeConversions.js

@@ -10,6 +10,7 @@ exports.dateStringToDAMLTime = dateStringToDAMLTime;
 exports.relTimeToDAML = relTimeToDAML;
 exports.damlTimeToDateString = damlTimeToDateString;
 exports.numberToString = numberToString;
+exports.normalizeNumericString = normalizeNumericString;
 exports.optionalNumberToString = optionalNumberToString;
 exports.optionalString = optionalString;
 exports.safeString = safeString;
@@ -48,6 +49,35 @@ function damlTimeToDateString(timeString) {
 function numberToString(value) {
     return typeof value === 'number' ? value.toString() : value;
 }
+/**
+ * Normalize a numeric string by removing trailing zeros after the decimal point. DAML returns numbers like
+ * "5000000.0000000000" but OCF expects "5000000". Also handles removing the decimal point if all fractional digits are
+ * zeros.
+ *
+ * @throws Error if the string contains scientific notation (e.g., "1.5e10") or is not a valid numeric string
+ */
+function normalizeNumericString(value) {
+    // Validate: reject scientific notation
+    if (value.toLowerCase().includes('e')) {
+        throw new Error(`Invalid numeric string: scientific notation is not supported (got "${value}")`);
+    }
+    // Validate: must be a valid numeric string (optional minus, digits, optional decimal and more digits)
+    if (!/^-?\d+(\.\d+)?$/.test(value)) {
+        throw new Error(`Invalid numeric string format (got "${value}")`);
+    }
+    // If no decimal point, return as-is
+    if (!value.includes('.')) {
+        return value;
+    }
+    // Remove trailing zeros after decimal point
+    const result = value.replace(/\.?0+$/, '');
+    // If we ended up with just an empty string after the decimal, it means there was nothing before it
+    // This shouldn't happen with valid numeric strings, but just in case:
+    if (result === '') {
+        return '0';
+    }
+    return result;
+}
 /**
  * Convert a number, string, null or undefined to a string or undefined Used for optional DAML numeric fields that
  * require string values
@@ -93,7 +123,7 @@ function monetaryToDaml(monetary) {
 }
 function damlMonetaryToNative(damlMonetary) {
     return {
-        amount: damlMonetary.amount,
+        amount: normalizeNumericString(damlMonetary.amount),
         currency: damlMonetary.currency,
     };
 }

package/dist/utils/typeConversions.js.map

@@ -1 +1 @@
-{"version":3,"file":"typeConversions.js","sourceRoot":"","sources":["../../src/utils/typeConversions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"typeConversions.js","sourceRoot":"","sources":["../../src/utils/typeConversions.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-captable-protocol/canton",
-  "version": "0.2.106",
+  "version": "0.2.107",
   "description": "A TypeScript SDK for interacting with the Open CapTable Protocol (OCP) Factory contract on Canton blockchain",
   "license": "MIT",
   "main": "dist/index.js",
@@ -26,36 +26,40 @@
     "test": "npm run -s typecheck && jest --passWithNoTests",
     "test:ci": "npm run -s typecheck && jest --runInBand",
     "test:coverage": "jest --coverage --passWithNoTests",
+    "test:integration": "npm run -s typecheck && jest -c jest.integration.config.js --passWithNoTests",
+    "test:integration:ci": "npm run -s typecheck && jest -c jest.integration.config.js --runInBand",
     "test:watch": "jest --watch",
     "typecheck": "tsc -p tsconfig.tests.json --noEmit"
   },
   "dependencies": {
-    "@daml/ledger": "2.10.2",
-    "@daml/types": "2.10.2",
-    "@fairmint/canton-node-sdk": "0.0.131",
-    "@fairmint/open-captable-protocol-daml-js": "0.2.50"
+    "@daml/ledger": "2.10.3",
+    "@daml/types": "3.4.9",
+    "@fairmint/canton-node-sdk": "0.0.142",
+    "@fairmint/open-captable-protocol-daml-js": "0.2.55"
   },
   "devDependencies": {
-    "@eslint/eslintrc": "^3.3.1",
+    "@eslint/eslintrc": "3.3.3",
     "@types/jest": "30.0.0",
-    "@types/node": "24.7.2",
-    "@typescript-eslint/eslint-plugin": "8.46.1",
-    "@typescript-eslint/parser": "8.46.1",
+    "@types/jsonwebtoken": "9.0.10",
+    "@types/node": "25.0.3",
+    "@typescript-eslint/eslint-plugin": "8.51.0",
+    "@typescript-eslint/parser": "8.51.0",
     "ajv": "8.17.1",
     "ajv-formats": "3.0.1",
-    "eslint": "9.37.0",
+    "eslint": "9.39.2",
     "eslint-config-prettier": "10.1.8",
     "eslint-import-resolver-typescript": "4.4.4",
     "eslint-plugin-import": "2.32.0",
-    "eslint-plugin-unused-imports": "4.2.0",
+    "eslint-plugin-unused-imports": "4.3.0",
     "jest": "30.2.0",
-    "prettier": "3.6.2",
-    "prettier-plugin-jsdoc": "1.3.3",
+    "jsonwebtoken": "9.0.3",
+    "prettier": "3.7.4",
+    "prettier-plugin-jsdoc": "1.8.0",
     "prettier-plugin-organize-imports": "4.3.0",
-    "prettier-plugin-packagejson": "2.5.19",
-    "ts-jest": "29.4.5",
+    "prettier-plugin-packagejson": "2.5.20",
+    "ts-jest": "29.4.6",
     "ts-node": "10.9.2",
-    "typedoc": "0.28.14",
+    "typedoc": "0.28.15",
     "typescript": "5.9.3"
   },
   "publishConfig": {

package/dist/functions/CantonPayments/airdrop/executeBatchTransfers.d.ts

@@ -1,24 +0,0 @@
-import type { CommandWithDisclosedContracts } from '../../../types';
-export interface ExecuteBatchTransfersParams {
-    factoryContractId: string;
-    personalAirdropCids: string[];
-    amuletInputs: string[];
-    openMiningRoundCid: string;
-    amount: string | number;
-    numberOfTransfers: number;
-    lockedAmuletCid?: string;
-}
-/**
- * Build command to execute batch transfers on multiple PersonalAirdrop contracts
- *
- * Supports two modes:
- * 1. Regular amulets: Provide amuletInputs, leave lockedAmuletCid undefined
- * 2. LockedAmulet: Provide lockedAmuletCid, leave amuletInputs empty
- *
- * When using LockedAmulet:
- * - The locked amulet is unlocked before batch processing
- * - Used for all transfers in the batch
- * - Re-locked with preserved lock details (holders, expiry, context) after completion
- */
-export declare function buildExecuteBatchTransfersCommand(params: ExecuteBatchTransfersParams): CommandWithDisclosedContracts;
-//# sourceMappingURL=executeBatchTransfers.d.ts.map

package/dist/functions/CantonPayments/airdrop/executeBatchTransfers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"executeBatchTransfers.d.ts","sourceRoot":"","sources":["../../../../src/functions/CantonPayments/airdrop/executeBatchTransfers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,gBAAgB,CAAC;AAEpE,MAAM,WAAW,2BAA2B;IAC1C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,2BAA2B,GAAG,6BAA6B,CA+BpH"}