@open-captable-protocol/canton 0.2.222 → 0.2.224

package/dist/functions/OpenCapTable/convertibleIssuance/getConvertibleIssuanceAsOcf.js

@@ -1,428 +1,391 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.damlConvertibleIssuanceDataToNative = damlConvertibleIssuanceDataToNative;
 exports.getConvertibleIssuanceAsOcf = getConvertibleIssuanceAsOcf;
 const errors_1 = require("../../../errors");
 const typeConversions_1 = require("../../../utils/typeConversions");
-/** Retrieve a ConvertibleIssuance contract and return it as an OCF JSON object */
-async function getConvertibleIssuanceAsOcf(client, params) {
-    const res = await client.getEventsByContractId({ contractId: params.contractId });
-    const created = res.created?.createdEvent;
-    if (!created?.createArgument) {
-        throw new errors_1.OcpContractError('Missing createArgument for ConvertibleIssuance', {
-            contractId: params.contractId,
-            code: errors_1.OcpErrorCodes.RESULT_NOT_FOUND,
-        });
-    }
-    const arg = created.createArgument;
-    if (typeof arg !== 'object' || !('issuance_data' in arg)) {
-        throw new errors_1.OcpParseError('Unexpected createArgument for ConvertibleIssuance', {
-            source: 'ConvertibleIssuance.createArgument',
-            code: errors_1.OcpErrorCodes.SCHEMA_MISMATCH,
-        });
-    }
-    const d = arg.issuance_data;
-    const typeMap = {
-        OcfConvertibleNote: 'NOTE',
-        OcfConvertibleSafe: 'SAFE',
-        OcfConvertibleSecurity: 'SECURITY',
-    };
-    const convertTriggers = (ts, convertibleType, issuanceId) => {
-        if (!Array.isArray(ts))
-            return [];
-        const mapTagToType = (tag) => {
-            if (tag === 'OcfTriggerTypeTypeAutomaticOnDate')
-                return 'AUTOMATIC_ON_DATE';
-            if (tag === 'OcfTriggerTypeTypeElectiveInRange')
-                return 'ELECTIVE_IN_RANGE';
-            if (tag === 'OcfTriggerTypeTypeElectiveOnCondition')
-                return 'ELECTIVE_ON_CONDITION';
-            if (tag === 'OcfTriggerTypeTypeElectiveAtWill')
-                return 'ELECTIVE_AT_WILL';
-            if (tag === 'OcfTriggerTypeTypeUnspecified')
-                return 'UNSPECIFIED';
-            return 'AUTOMATIC_ON_CONDITION';
+const typeMap = {
+    OcfConvertibleNote: 'NOTE',
+    OcfConvertibleSafe: 'SAFE',
+    OcfConvertibleSecurity: 'SECURITY',
+};
+const convertTriggers = (ts, issuanceId) => {
+    if (!Array.isArray(ts))
+        return [];
+    const mapMechanism = (m) => {
+        // Handle both string enum and DAML variant { tag, value }
+        const mapTiming = (t) => {
+            const s = (0, typeConversions_1.safeString)(t);
+            if (s.endsWith('PreMoney'))
+                return 'PRE_MONEY';
+            if (s.endsWith('PostMoney'))
+                return 'POST_MONEY';
+            return undefined;
         };
-        const mapMechanism = (m) => {
-            // Handle both string enum and DAML variant { tag, value }
-            const mapMonetary = (mon) => {
-                if (!mon || typeof mon !== 'object')
-                    return undefined;
-                const monObj = mon;
-                // Validate amount exists and is string or number
-                if (monObj.amount === undefined || monObj.amount === null) {
-                    throw new errors_1.OcpValidationError('monetary.amount', 'Required field is missing', {
-                        code: errors_1.OcpErrorCodes.REQUIRED_FIELD_MISSING,
-                    });
-                }
-                if (typeof monObj.amount !== 'string' && typeof monObj.amount !== 'number') {
-                    throw new errors_1.OcpValidationError('monetary.amount', `Must be string or number, got ${typeof monObj.amount}`, {
-                        code: errors_1.OcpErrorCodes.INVALID_TYPE,
-                        expectedType: 'string | number',
-                        receivedValue: monObj.amount,
-                    });
-                }
-                // Validate currency exists and is string
-                if (typeof monObj.currency !== 'string' || !monObj.currency) {
-                    throw new errors_1.OcpValidationError('monetary.currency', 'Required field must be a non-empty string', {
-                        code: errors_1.OcpErrorCodes.REQUIRED_FIELD_MISSING,
-                        expectedType: 'string',
-                        receivedValue: monObj.currency,
-                    });
-                }
-                const amount = (0, typeConversions_1.normalizeNumericString)(typeof monObj.amount === 'number' ? monObj.amount.toString() : monObj.amount);
-                return {
-                    amount,
-                    currency: monObj.currency,
-                };
-            };
-            const mapTiming = (t) => {
-                const s = (0, typeConversions_1.safeString)(t);
-                if (s.endsWith('PreMoney'))
-                    return 'PRE_MONEY';
-                if (s.endsWith('PostMoney'))
-                    return 'POST_MONEY';
-                return undefined;
-            };
-            if (typeof m === 'string') {
-                throw new errors_1.OcpParseError(`conversion_mechanism missing variant value (got tag '${m}')`, {
-                    source: 'conversionRight.conversion_mechanism',
-                    code: errors_1.OcpErrorCodes.SCHEMA_MISMATCH,
+        if (typeof m === 'string') {
+            throw new errors_1.OcpParseError(`conversion_mechanism missing variant value (got tag '${m}')`, {
+                source: 'conversionRight.conversion_mechanism',
+                code: errors_1.OcpErrorCodes.SCHEMA_MISMATCH,
+            });
+        }
+        if (m && typeof m === 'object') {
+            const tag = m.tag;
+            const value = m.value;
+            if (!tag || !value) {
+                throw new errors_1.OcpValidationError('conversion_mechanism', 'Tag and value are required', {
+                    code: errors_1.OcpErrorCodes.REQUIRED_FIELD_MISSING,
                 });
             }
-            if (m && typeof m === 'object') {
-                const tag = m.tag;
-                const value = m.value;
-                if (!tag || !value) {
-                    throw new errors_1.OcpValidationError('conversion_mechanism', 'Tag and value are required', {
-                        code: errors_1.OcpErrorCodes.REQUIRED_FIELD_MISSING,
-                    });
-                }
-                switch (tag) {
-                    case 'OcfConvMechSAFE': {
-                        const mech = {
-                            type: 'SAFE_CONVERSION',
-                            conversion_mfn: Boolean(value.conversion_mfn),
-                            ...(typeof value.conversion_discount === 'number' || typeof value.conversion_discount === 'string'
-                                ? {
-                                    conversion_discount: (0, typeConversions_1.normalizeNumericString)(typeof value.conversion_discount === 'number'
-                                        ? value.conversion_discount.toString()
-                                        : value.conversion_discount),
-                                }
-                                : {}),
-                            ...(value.conversion_valuation_cap
-                                ? {
-                                    conversion_valuation_cap: mapMonetary(value.conversion_valuation_cap) ?? {
-                                        amount: '',
-                                        currency: '',
-                                    },
-                                }
-                                : {}),
-                            ...(value.conversion_timing ? { conversion_timing: mapTiming(value.conversion_timing) } : {}),
-                            ...(value.capitalization_definition
-                                ? { capitalization_definition: value.capitalization_definition }
-                                : {}),
-                            ...(value.capitalization_definition_rules
-                                ? { capitalization_definition_rules: value.capitalization_definition_rules }
-                                : {}),
-                            ...(value.exit_multiple
-                                ? {
-                                    exit_multiple: {
-                                        numerator: (0, typeConversions_1.normalizeNumericString)(String(value.exit_multiple.numerator)),
-                                        denominator: (0, typeConversions_1.normalizeNumericString)(String(value.exit_multiple.denominator)),
-                                    },
-                                }
-                                : {}),
-                        };
-                        return mech;
-                    }
-                    case 'OcfConvMechPercentCapitalization': {
-                        const mech = {
-                            type: 'FIXED_PERCENT_OF_CAPITALIZATION_CONVERSION',
-                            converts_to_percent: (0, typeConversions_1.normalizeNumericString)(typeof value.converts_to_percent === 'number'
-                                ? value.converts_to_percent.toString()
-                                : (() => {
-                                    if (typeof value.converts_to_percent !== 'string') {
-                                        throw new errors_1.OcpValidationError('conversion_mechanism.converts_to_percent', `Must be string or number, got ${typeof value.converts_to_percent}`, {
-                                            code: errors_1.OcpErrorCodes.INVALID_TYPE,
-                                            expectedType: 'string | number',
-                                            receivedValue: value.converts_to_percent,
-                                        });
-                                    }
-                                    return value.converts_to_percent;
-                                })()),
-                            ...(value.capitalization_definition
-                                ? { capitalization_definition: value.capitalization_definition }
-                                : {}),
-                            ...(value.capitalization_definition_rules
-                                ? { capitalization_definition_rules: value.capitalization_definition_rules }
-                                : {}),
-                        };
-                        return mech;
-                    }
-                    case 'OcfConvMechFixedAmount': {
-                        const mech = {
-                            type: 'FIXED_AMOUNT_CONVERSION',
-                            converts_to_quantity: (0, typeConversions_1.normalizeNumericString)(typeof value.converts_to_quantity === 'number'
-                                ? value.converts_to_quantity.toString()
-                                : (() => {
-                                    if (typeof value.converts_to_quantity !== 'string') {
-                                        throw new errors_1.OcpValidationError('conversion_mechanism.converts_to_quantity', `Must be string or number, got ${typeof value.converts_to_quantity}`, {
-                                            code: errors_1.OcpErrorCodes.INVALID_TYPE,
-                                            expectedType: 'string | number',
-                                            receivedValue: value.converts_to_quantity,
-                                        });
+            switch (tag) {
+                case 'OcfConvMechSAFE': {
+                    const mech = {
+                        type: 'SAFE_CONVERSION',
+                        conversion_mfn: Boolean(value.conversion_mfn),
+                        ...(typeof value.conversion_discount === 'number' || typeof value.conversion_discount === 'string'
+                            ? {
+                                conversion_discount: (0, typeConversions_1.normalizeNumericString)(typeof value.conversion_discount === 'number'
+                                    ? value.conversion_discount.toString()
+                                    : value.conversion_discount),
+                            }
+                            : {}),
+                        ...(value.conversion_valuation_cap
+                            ? {
+                                conversion_valuation_cap: (() => {
+                                    const monetary = (0, typeConversions_1.damlMonetaryToNativeWithValidation)(value.conversion_valuation_cap);
+                                    if (!monetary) {
+                                        throw new errors_1.OcpValidationError('convertibleIssuance.conversion_valuation_cap', 'Invalid monetary value for conversion_valuation_cap', { code: errors_1.OcpErrorCodes.INVALID_TYPE, receivedValue: value.conversion_valuation_cap });
                                     }
-                                    return value.converts_to_quantity;
-                                })()),
-                        };
-                        return mech;
-                    }
-                    case 'OcfConvMechValuationBased': {
-                        const mech = {
-                            type: 'VALUATION_BASED_CONVERSION',
-                            valuation_type: value.valuation_type,
-                            ...(value.valuation_amount
-                                ? {
-                                    valuation_amount: mapMonetary(value.valuation_amount) ?? {
-                                        amount: '',
-                                        currency: '',
-                                    },
-                                }
-                                : {}),
-                            ...(value.capitalization_definition
-                                ? { capitalization_definition: value.capitalization_definition }
-                                : {}),
-                            ...(value.capitalization_definition_rules
-                                ? { capitalization_definition_rules: value.capitalization_definition_rules }
-                                : {}),
-                        };
-                        return mech;
-                    }
-                    case 'OcfConvMechSharePriceBased': {
-                        const mech = {
-                            type: 'SHARE_PRICE_BASED_CONVERSION',
-                            description: value.description,
-                            discount: Boolean(value.discount),
-                            ...(value.discount_percentage !== undefined && value.discount_percentage !== null
-                                ? {
-                                    discount_percentage: (0, typeConversions_1.normalizeNumericString)(typeof value.discount_percentage === 'number'
-                                        ? value.discount_percentage.toString()
-                                        : typeof value.discount_percentage === 'string'
-                                            ? value.discount_percentage
-                                            : (() => {
-                                                throw new errors_1.OcpValidationError('conversion_mechanism.discount_percentage', `Must be string or number, got ${typeof value.discount_percentage}`, {
-                                                    code: errors_1.OcpErrorCodes.INVALID_TYPE,
-                                                    expectedType: 'string | number',
-                                                    receivedValue: value.discount_percentage,
-                                                });
-                                            })()),
-                                }
-                                : {}),
-                            ...(value.discount_amount
-                                ? {
-                                    discount_amount: mapMonetary(value.discount_amount) ?? {
-                                        amount: '',
-                                        currency: '',
-                                    },
-                                }
-                                : {}),
-                        };
-                        return mech;
-                    }
-                    case 'OcfConvMechNote': {
-                        const interest_rates = Array.isArray(value.interest_rates)
-                            ? value.interest_rates.map((ir) => {
-                                const irObj = ir;
-                                // Validate interest rate
-                                if (irObj.rate === undefined || irObj.rate === null) {
-                                    throw new errors_1.OcpValidationError('interest_rate.rate', 'Required field is missing', {
-                                        code: errors_1.OcpErrorCodes.REQUIRED_FIELD_MISSING,
-                                    });
-                                }
-                                if (typeof irObj.rate !== 'string' && typeof irObj.rate !== 'number') {
-                                    throw new errors_1.OcpValidationError('interest_rate.rate', `Must be string or number, got ${typeof irObj.rate}`, {
+                                    return monetary;
+                                })(),
+                            }
+                            : {}),
+                        ...(value.conversion_timing ? { conversion_timing: mapTiming(value.conversion_timing) } : {}),
+                        ...(value.capitalization_definition ? { capitalization_definition: value.capitalization_definition } : {}),
+                        ...(value.capitalization_definition_rules
+                            ? { capitalization_definition_rules: value.capitalization_definition_rules }
+                            : {}),
+                        ...(value.exit_multiple
+                            ? {
+                                exit_multiple: {
+                                    numerator: (0, typeConversions_1.normalizeNumericString)(String(value.exit_multiple.numerator)),
+                                    denominator: (0, typeConversions_1.normalizeNumericString)(String(value.exit_multiple.denominator)),
+                                },
+                            }
+                            : {}),
+                    };
+                    return mech;
+                }
+                case 'OcfConvMechPercentCapitalization': {
+                    const mech = {
+                        type: 'FIXED_PERCENT_OF_CAPITALIZATION_CONVERSION',
+                        converts_to_percent: (0, typeConversions_1.normalizeNumericString)(typeof value.converts_to_percent === 'number'
+                            ? value.converts_to_percent.toString()
+                            : (() => {
+                                if (typeof value.converts_to_percent !== 'string') {
+                                    throw new errors_1.OcpValidationError('conversion_mechanism.converts_to_percent', `Must be string or number, got ${typeof value.converts_to_percent}`, {
                                         code: errors_1.OcpErrorCodes.INVALID_TYPE,
                                         expectedType: 'string | number',
-                                        receivedValue: irObj.rate,
+                                        receivedValue: value.converts_to_percent,
                                     });
                                 }
-                                // Validate accrual_start_date
-                                if (typeof irObj.accrual_start_date !== 'string' || !irObj.accrual_start_date) {
-                                    throw new errors_1.OcpValidationError('interest_rate.accrual_start_date', 'Required field must be a non-empty string', {
-                                        code: errors_1.OcpErrorCodes.REQUIRED_FIELD_MISSING,
-                                        expectedType: 'string',
-                                        receivedValue: irObj.accrual_start_date,
+                                return value.converts_to_percent;
+                            })()),
+                        ...(value.capitalization_definition ? { capitalization_definition: value.capitalization_definition } : {}),
+                        ...(value.capitalization_definition_rules
+                            ? { capitalization_definition_rules: value.capitalization_definition_rules }
+                            : {}),
+                    };
+                    return mech;
+                }
+                case 'OcfConvMechFixedAmount': {
+                    const mech = {
+                        type: 'FIXED_AMOUNT_CONVERSION',
+                        converts_to_quantity: (0, typeConversions_1.normalizeNumericString)(typeof value.converts_to_quantity === 'number'
+                            ? value.converts_to_quantity.toString()
+                            : (() => {
+                                if (typeof value.converts_to_quantity !== 'string') {
+                                    throw new errors_1.OcpValidationError('conversion_mechanism.converts_to_quantity', `Must be string or number, got ${typeof value.converts_to_quantity}`, {
+                                        code: errors_1.OcpErrorCodes.INVALID_TYPE,
+                                        expectedType: 'string | number',
+                                        receivedValue: value.converts_to_quantity,
                                     });
                                 }
-                                return {
-                                    rate: (0, typeConversions_1.normalizeNumericString)(typeof irObj.rate === 'number' ? irObj.rate.toString() : irObj.rate),
-                                    accrual_start_date: irObj.accrual_start_date.split('T')[0],
-                                    ...(irObj.accrual_end_date
-                                        ? { accrual_end_date: irObj.accrual_end_date.split('T')[0] }
-                                        : {}),
-                                };
-                            })
-                            : null;
-                        const accrualFromDaml = (v) => {
-                            const s = (0, typeConversions_1.safeString)(v);
-                            if (s.endsWith('OcfAccrualDaily') || s === 'OcfAccrualDaily')
-                                return 'DAILY';
-                            if (s.endsWith('OcfAccrualMonthly') || s === 'OcfAccrualMonthly')
-                                return 'MONTHLY';
-                            if (s.endsWith('OcfAccrualQuarterly') || s === 'OcfAccrualQuarterly')
-                                return 'QUARTERLY';
-                            if (s.endsWith('OcfAccrualSemiAnnual') || s === 'OcfAccrualSemiAnnual')
-                                return 'SEMI_ANNUAL';
-                            if (s.endsWith('OcfAccrualAnnual') || s === 'OcfAccrualAnnual')
-                                return 'ANNUAL';
+                                return value.converts_to_quantity;
+                            })()),
+                    };
+                    return mech;
+                }
+                case 'OcfConvMechValuationBased': {
+                    const mech = {
+                        type: 'VALUATION_BASED_CONVERSION',
+                        valuation_type: value.valuation_type,
+                        ...(value.valuation_amount
+                            ? {
+                                valuation_amount: (() => {
+                                    const monetary = (0, typeConversions_1.damlMonetaryToNativeWithValidation)(value.valuation_amount);
+                                    if (!monetary) {
+                                        throw new errors_1.OcpValidationError('convertibleIssuance.valuation_amount', 'Invalid monetary value for valuation_amount', { code: errors_1.OcpErrorCodes.INVALID_TYPE, receivedValue: value.valuation_amount });
+                                    }
+                                    return monetary;
+                                })(),
+                            }
+                            : {}),
+                        ...(value.capitalization_definition ? { capitalization_definition: value.capitalization_definition } : {}),
+                        ...(value.capitalization_definition_rules
+                            ? { capitalization_definition_rules: value.capitalization_definition_rules }
+                            : {}),
+                    };
+                    return mech;
+                }
+                case 'OcfConvMechSharePriceBased': {
+                    const mech = {
+                        type: 'SHARE_PRICE_BASED_CONVERSION',
+                        description: value.description,
+                        discount: Boolean(value.discount),
+                        ...(value.discount_percentage !== undefined && value.discount_percentage !== null
+                            ? {
+                                discount_percentage: (0, typeConversions_1.normalizeNumericString)(typeof value.discount_percentage === 'number'
+                                    ? value.discount_percentage.toString()
+                                    : typeof value.discount_percentage === 'string'
+                                        ? value.discount_percentage
+                                        : (() => {
+                                            throw new errors_1.OcpValidationError('conversion_mechanism.discount_percentage', `Must be string or number, got ${typeof value.discount_percentage}`, {
+                                                code: errors_1.OcpErrorCodes.INVALID_TYPE,
+                                                expectedType: 'string | number',
+                                                receivedValue: value.discount_percentage,
+                                            });
+                                        })()),
+                            }
+                            : {}),
+                        ...(value.discount_amount
+                            ? {
+                                discount_amount: (() => {
+                                    const monetary = (0, typeConversions_1.damlMonetaryToNativeWithValidation)(value.discount_amount);
+                                    if (!monetary) {
+                                        throw new errors_1.OcpValidationError('convertibleIssuance.discount_amount', 'Invalid monetary value for discount_amount', { code: errors_1.OcpErrorCodes.INVALID_TYPE, receivedValue: value.discount_amount });
+                                    }
+                                    return monetary;
+                                })(),
+                            }
+                            : {}),
+                    };
+                    return mech;
+                }
+                case 'OcfConvMechNote': {
+                    const interest_rates = Array.isArray(value.interest_rates)
+                        ? value.interest_rates.map((ir) => {
+                            const irObj = ir;
+                            // Validate interest rate
+                            if (irObj.rate === undefined || irObj.rate === null) {
+                                throw new errors_1.OcpValidationError('interest_rate.rate', 'Required field is missing', {
+                                    code: errors_1.OcpErrorCodes.REQUIRED_FIELD_MISSING,
+                                });
+                            }
+                            if (typeof irObj.rate !== 'string' && typeof irObj.rate !== 'number') {
+                                throw new errors_1.OcpValidationError('interest_rate.rate', `Must be string or number, got ${typeof irObj.rate}`, {
+                                    code: errors_1.OcpErrorCodes.INVALID_TYPE,
+                                    expectedType: 'string | number',
+                                    receivedValue: irObj.rate,
+                                });
+                            }
+                            // Validate accrual_start_date
+                            if (typeof irObj.accrual_start_date !== 'string' || !irObj.accrual_start_date) {
+                                throw new errors_1.OcpValidationError('interest_rate.accrual_start_date', 'Required field must be a non-empty string', {
+                                    code: errors_1.OcpErrorCodes.REQUIRED_FIELD_MISSING,
+                                    expectedType: 'string',
+                                    receivedValue: irObj.accrual_start_date,
+                                });
+                            }
+                            return {
+                                rate: (0, typeConversions_1.normalizeNumericString)(typeof irObj.rate === 'number' ? irObj.rate.toString() : irObj.rate),
+                                accrual_start_date: irObj.accrual_start_date.split('T')[0],
+                                ...(irObj.accrual_end_date
+                                    ? { accrual_end_date: irObj.accrual_end_date.split('T')[0] }
+                                    : {}),
+                            };
+                        })
+                        : null;
+                    const accrualFromDaml = (v) => {
+                        const s = (0, typeConversions_1.safeString)(v);
+                        if (s.endsWith('OcfAccrualDaily') || s === 'OcfAccrualDaily')
+                            return 'DAILY';
+                        if (s.endsWith('OcfAccrualMonthly') || s === 'OcfAccrualMonthly')
+                            return 'MONTHLY';
+                        if (s.endsWith('OcfAccrualQuarterly') || s === 'OcfAccrualQuarterly')
+                            return 'QUARTERLY';
+                        if (s.endsWith('OcfAccrualSemiAnnual') || s === 'OcfAccrualSemiAnnual')
+                            return 'SEMI_ANNUAL';
+                        if (s.endsWith('OcfAccrualAnnual') || s === 'OcfAccrualAnnual')
+                            return 'ANNUAL';
+                        return undefined;
+                    };
+                    const compoundingFromDaml = (v) => {
+                        const s = (0, typeConversions_1.safeString)(v);
+                        if (!s)
                             return undefined;
-                        };
-                        const compoundingFromDaml = (v) => {
-                            const s = (0, typeConversions_1.safeString)(v);
-                            if (!s)
-                                return undefined;
-                            if (s === 'OcfSimple')
-                                return 'SIMPLE';
-                            if (s === 'OcfCompounding')
-                                return 'COMPOUNDING';
-                            throw new errors_1.OcpParseError(`Unknown compounding_type: ${(0, typeConversions_1.safeString)(v)}`, {
-                                source: 'conversion_mechanism.compounding_type',
-                                code: errors_1.OcpErrorCodes.UNKNOWN_ENUM_VALUE,
-                            });
-                        };
-                        const mech = {
-                            type: 'CONVERTIBLE_NOTE_CONVERSION',
-                            interest_rates,
-                            ...(value.day_count_convention
-                                ? {
-                                    day_count_convention: (0, typeConversions_1.safeString)(value.day_count_convention).endsWith('Actual365')
-                                        ? 'ACTUAL_365'
-                                        : '30_360',
-                                }
-                                : {}),
-                            ...(value.interest_payout
-                                ? {
-                                    interest_payout: (0, typeConversions_1.safeString)(value.interest_payout).endsWith('Deferred') ? 'DEFERRED' : 'CASH',
-                                }
-                                : {}),
-                            ...(value.interest_accrual_period
-                                ? { interest_accrual_period: accrualFromDaml(value.interest_accrual_period) }
-                                : {}),
-                            ...(value.compounding_type ? { compounding_type: compoundingFromDaml(value.compounding_type) } : {}),
-                            ...(typeof value.conversion_discount === 'number' || typeof value.conversion_discount === 'string'
-                                ? {
-                                    conversion_discount: (0, typeConversions_1.normalizeNumericString)(typeof value.conversion_discount === 'number'
-                                        ? value.conversion_discount.toString()
-                                        : value.conversion_discount),
-                                }
-                                : {}),
-                            ...(value.conversion_valuation_cap
-                                ? {
-                                    conversion_valuation_cap: mapMonetary(value.conversion_valuation_cap) ?? {
-                                        amount: '',
-                                        currency: '',
-                                    },
-                                }
-                                : {}),
-                            ...(value.capitalization_definition
-                                ? { capitalization_definition: value.capitalization_definition }
-                                : {}),
-                            ...(value.capitalization_definition_rules
-                                ? { capitalization_definition_rules: value.capitalization_definition_rules }
-                                : {}),
-                            ...(value.exit_multiple
-                                ? {
-                                    exit_multiple: {
-                                        numerator: (0, typeConversions_1.normalizeNumericString)(String(value.exit_multiple.numerator)),
-                                        denominator: (0, typeConversions_1.normalizeNumericString)(String(value.exit_multiple.denominator)),
-                                    },
-                                }
-                                : {}),
-                            ...(value.conversion_mfn ? { conversion_mfn: Boolean(value.conversion_mfn) } : {}),
-                        };
-                        return mech;
-                    }
-                    case 'OcfConvMechCustom': {
-                        if (!value.custom_conversion_description) {
-                            throw new errors_1.OcpValidationError('conversion_mechanism.custom_conversion_description', 'Required for CUSTOM_CONVERSION', { code: errors_1.OcpErrorCodes.REQUIRED_FIELD_MISSING });
-                        }
-                        const mech = {
-                            type: 'CUSTOM_CONVERSION',
-                            custom_conversion_description: value.custom_conversion_description,
-                        };
-                        return mech;
-                    }
-                    default:
-                        throw new errors_1.OcpParseError(`Unknown convertible conversion mechanism tag: ${String(tag)}`, {
-                            source: 'conversion_mechanism.tag',
+                        if (s === 'OcfSimple')
+                            return 'SIMPLE';
+                        if (s === 'OcfCompounding')
+                            return 'COMPOUNDING';
+                        throw new errors_1.OcpParseError(`Unknown compounding_type: ${(0, typeConversions_1.safeString)(v)}`, {
+                            source: 'conversion_mechanism.compounding_type',
                             code: errors_1.OcpErrorCodes.UNKNOWN_ENUM_VALUE,
                         });
+                    };
+                    const mech = {
+                        type: 'CONVERTIBLE_NOTE_CONVERSION',
+                        interest_rates,
+                        ...(value.day_count_convention
+                            ? {
+                                day_count_convention: (0, typeConversions_1.safeString)(value.day_count_convention).endsWith('Actual365')
+                                    ? 'ACTUAL_365'
+                                    : '30_360',
+                            }
+                            : {}),
+                        ...(value.interest_payout
+                            ? {
+                                interest_payout: (0, typeConversions_1.safeString)(value.interest_payout).endsWith('Deferred') ? 'DEFERRED' : 'CASH',
+                            }
+                            : {}),
+                        ...(value.interest_accrual_period
+                            ? { interest_accrual_period: accrualFromDaml(value.interest_accrual_period) }
+                            : {}),
+                        ...(value.compounding_type ? { compounding_type: compoundingFromDaml(value.compounding_type) } : {}),
+                        ...(typeof value.conversion_discount === 'number' || typeof value.conversion_discount === 'string'
+                            ? {
+                                conversion_discount: (0, typeConversions_1.normalizeNumericString)(typeof value.conversion_discount === 'number'
+                                    ? value.conversion_discount.toString()
+                                    : value.conversion_discount),
+                            }
+                            : {}),
+                        ...(value.conversion_valuation_cap
+                            ? {
+                                conversion_valuation_cap: (() => {
+                                    const monetary = (0, typeConversions_1.damlMonetaryToNativeWithValidation)(value.conversion_valuation_cap);
+                                    if (!monetary) {
+                                        throw new errors_1.OcpValidationError('convertibleIssuance.conversion_valuation_cap', 'Invalid monetary value for conversion_valuation_cap', { code: errors_1.OcpErrorCodes.INVALID_TYPE, receivedValue: value.conversion_valuation_cap });
+                                    }
+                                    return monetary;
+                                })(),
+                            }
+                            : {}),
+                        ...(value.capitalization_definition ? { capitalization_definition: value.capitalization_definition } : {}),
+                        ...(value.capitalization_definition_rules
+                            ? { capitalization_definition_rules: value.capitalization_definition_rules }
+                            : {}),
+                        ...(value.exit_multiple
+                            ? {
+                                exit_multiple: {
+                                    numerator: (0, typeConversions_1.normalizeNumericString)(String(value.exit_multiple.numerator)),
+                                    denominator: (0, typeConversions_1.normalizeNumericString)(String(value.exit_multiple.denominator)),
+                                },
+                            }
+                            : {}),
+                        ...(value.conversion_mfn ? { conversion_mfn: Boolean(value.conversion_mfn) } : {}),
+                    };
+                    return mech;
                 }
+                case 'OcfConvMechCustom': {
+                    if (!value.custom_conversion_description) {
+                        throw new errors_1.OcpValidationError('conversion_mechanism.custom_conversion_description', 'Required for CUSTOM_CONVERSION', { code: errors_1.OcpErrorCodes.REQUIRED_FIELD_MISSING });
+                    }
+                    const mech = {
+                        type: 'CUSTOM_CONVERSION',
+                        custom_conversion_description: value.custom_conversion_description,
+                    };
+                    return mech;
+                }
+                default:
+                    throw new errors_1.OcpParseError(`Unknown convertible conversion mechanism tag: ${String(tag)}`, {
+                        source: 'conversion_mechanism.tag',
+                        code: errors_1.OcpErrorCodes.UNKNOWN_ENUM_VALUE,
+                    });
             }
-            throw new errors_1.OcpParseError('Unknown conversion_mechanism shape', {
-                source: 'conversionRight.conversion_mechanism',
-                code: errors_1.OcpErrorCodes.SCHEMA_MISMATCH,
+        }
+        throw new errors_1.OcpParseError('Unknown conversion_mechanism shape', {
+            source: 'conversionRight.conversion_mechanism',
+            code: errors_1.OcpErrorCodes.SCHEMA_MISMATCH,
+        });
+    };
+    return ts.map((raw, idx) => {
+        const r = (raw ?? {});
+        const tag = typeof r.type_ === 'string' ? r.type_ : typeof r.tag === 'string' ? r.tag : typeof raw === 'string' ? raw : '';
+        const type = (0, typeConversions_1.mapDamlTriggerTypeToOcf)(String(tag));
+        const trigger_id = typeof r.trigger_id === 'string' && r.trigger_id.length ? r.trigger_id : `${issuanceId}-trigger-${idx + 1}`;
+        const nickname = typeof r.nickname === 'string' && r.nickname.length ? r.nickname : undefined;
+        const trigger_description = typeof r.trigger_description === 'string' && r.trigger_description.length ? r.trigger_description : undefined;
+        const trigger_date = typeof r.trigger_date === 'string' && r.trigger_date.length ? r.trigger_date.split('T')[0] : undefined;
+        const trigger_condition = typeof r.trigger_condition === 'string' && r.trigger_condition.length ? r.trigger_condition : undefined;
+        // Parse conversion_right if present and convertible variant is used
+        let conversion_right;
+        if (r.conversion_right && typeof r.conversion_right === 'object' && 'OcfRightConvertible' in r.conversion_right) {
+            const right = r.conversion_right.OcfRightConvertible;
+            conversion_right = {
+                type: 'CONVERTIBLE_CONVERSION_RIGHT',
+                conversion_mechanism: mapMechanism(right.conversion_mechanism),
+                ...(typeof right.converts_to_future_round === 'boolean'
+                    ? { converts_to_future_round: right.converts_to_future_round }
+                    : {}),
+                ...(typeof right.converts_to_stock_class_id === 'string' && right.converts_to_stock_class_id.length
+                    ? { converts_to_stock_class_id: right.converts_to_stock_class_id }
+                    : {}),
+            };
+        }
+        else if (r.conversion_right &&
+            typeof r.conversion_right === 'object' &&
+            'conversion_mechanism' in r.conversion_right) {
+            // Handle direct convertible right shape (no OcfRightConvertible wrapper)
+            const right = r.conversion_right;
+            conversion_right = {
+                type: 'CONVERTIBLE_CONVERSION_RIGHT',
+                conversion_mechanism: mapMechanism(right.conversion_mechanism),
+                ...(typeof right.converts_to_future_round === 'boolean'
+                    ? { converts_to_future_round: right.converts_to_future_round }
+                    : {}),
+                ...(typeof right.converts_to_stock_class_id === 'string' && right.converts_to_stock_class_id.length
+                    ? { converts_to_stock_class_id: right.converts_to_stock_class_id }
+                    : {}),
+            };
+        }
+        if (!conversion_right) {
+            throw new errors_1.OcpValidationError('conversionTrigger.conversion_right', 'Required field is missing', {
+                code: errors_1.OcpErrorCodes.REQUIRED_FIELD_MISSING,
             });
+        }
+        const trigger = {
+            type,
+            trigger_id,
+            conversion_right,
+            ...(nickname ? { nickname } : {}),
+            ...(trigger_description ? { trigger_description } : {}),
+            ...(trigger_date ? { trigger_date } : {}),
+            ...(trigger_condition ? { trigger_condition } : {}),
         };
-        return ts.map((raw, idx) => {
-            const r = (raw ?? {});
-            const tag = typeof r.type_ === 'string' ? r.type_ : typeof r.tag === 'string' ? r.tag : typeof raw === 'string' ? raw : '';
-            const type = mapTagToType(String(tag));
-            const trigger_id = typeof r.trigger_id === 'string' && r.trigger_id.length ? r.trigger_id : `${issuanceId}-trigger-${idx + 1}`;
-            const nickname = typeof r.nickname === 'string' && r.nickname.length ? r.nickname : undefined;
-            const trigger_description = typeof r.trigger_description === 'string' && r.trigger_description.length ? r.trigger_description : undefined;
-            const trigger_date = typeof r.trigger_date === 'string' && r.trigger_date.length ? r.trigger_date.split('T')[0] : undefined;
-            const trigger_condition = typeof r.trigger_condition === 'string' && r.trigger_condition.length ? r.trigger_condition : undefined;
-            // Parse conversion_right if present and convertible variant is used
-            let conversion_right;
-            if (r.conversion_right && typeof r.conversion_right === 'object' && 'OcfRightConvertible' in r.conversion_right) {
-                const right = r.conversion_right.OcfRightConvertible;
-                conversion_right = {
-                    type: 'CONVERTIBLE_CONVERSION_RIGHT',
-                    conversion_mechanism: mapMechanism(right.conversion_mechanism),
-                    ...(typeof right.converts_to_future_round === 'boolean'
-                        ? { converts_to_future_round: right.converts_to_future_round }
-                        : {}),
-                    ...(typeof right.converts_to_stock_class_id === 'string' && right.converts_to_stock_class_id.length
-                        ? { converts_to_stock_class_id: right.converts_to_stock_class_id }
-                        : {}),
-                };
-            }
-            else if (r.conversion_right &&
-                typeof r.conversion_right === 'object' &&
-                'conversion_mechanism' in r.conversion_right) {
-                // Handle direct convertible right shape (no OcfRightConvertible wrapper)
-                const right = r.conversion_right;
-                conversion_right = {
-                    type: 'CONVERTIBLE_CONVERSION_RIGHT',
-                    conversion_mechanism: mapMechanism(right.conversion_mechanism),
-                    ...(typeof right.converts_to_future_round === 'boolean'
-                        ? { converts_to_future_round: right.converts_to_future_round }
-                        : {}),
-                    ...(typeof right.converts_to_stock_class_id === 'string' && right.converts_to_stock_class_id.length
-                        ? { converts_to_stock_class_id: right.converts_to_stock_class_id }
-                        : {}),
-                };
-            }
-            if (!conversion_right) {
-                throw new errors_1.OcpValidationError('conversionTrigger.conversion_right', 'Required field is missing', {
-                    code: errors_1.OcpErrorCodes.REQUIRED_FIELD_MISSING,
-                });
-            }
-            const trigger = {
-                type,
-                trigger_id,
-                conversion_right,
-                ...(nickname ? { nickname } : {}),
-                ...(trigger_description ? { trigger_description } : {}),
-                ...(trigger_date ? { trigger_date } : {}),
-                ...(trigger_condition ? { trigger_condition } : {}),
-            };
-            return trigger;
+        return trigger;
+    });
+};
+/** Convert DAML ConvertibleIssuance data to native OCF format */
+function damlConvertibleIssuanceDataToNative(d) {
+    // Validate required fields
+    if (typeof d.id !== 'string' || !d.id) {
+        throw new errors_1.OcpValidationError('convertibleIssuance.id', 'Required field is missing or invalid', {
+            code: errors_1.OcpErrorCodes.REQUIRED_FIELD_MISSING,
+            receivedValue: d.id,
         });
-    };
+    }
+    if (typeof d.date !== 'string' || !d.date) {
+        throw new errors_1.OcpValidationError('convertibleIssuance.date', 'Required field is missing or invalid', {
+            code: errors_1.OcpErrorCodes.REQUIRED_FIELD_MISSING,
+            receivedValue: d.date,
+        });
+    }
+    if (typeof d.security_id !== 'string' || !d.security_id) {
+        throw new errors_1.OcpValidationError('convertibleIssuance.security_id', 'Required field is missing or invalid', {
+            code: errors_1.OcpErrorCodes.REQUIRED_FIELD_MISSING,
+            receivedValue: d.security_id,
+        });
+    }
     const investmentAmount = d.investment_amount;
-    const comments = d.comments;
     // Validate investment amount
     if (!investmentAmount ||
         (typeof investmentAmount.amount !== 'string' && typeof investmentAmount.amount !== 'number')) {
@@ -441,8 +404,10 @@ async function getConvertibleIssuanceAsOcf(client, params) {
     }
     // Convert to string after validation
     const investmentAmountStr = typeof investmentAmount.amount === 'number' ? investmentAmount.amount.toString() : investmentAmount.amount;
-    const event = {
-        object_type: 'TX_CONVERTIBLE_ISSUANCE',
+    // Build the issuance object - use type assertion because the local helper types
+    // (ConversionTrigger, etc.) have compatible structure but different TypeScript definitions
+    // than the native types (ConvertibleConversionTrigger, etc.)
+    const issuance = {
         id: d.id,
         date: d.date.split('T')[0],
         security_id: d.security_id,
@@ -462,7 +427,7 @@ async function getConvertibleIssuanceAsOcf(client, params) {
             ? { consideration_text: d.consideration_text }
             : {}),
         convertible_type: typeMap[d.convertible_type || 'OcfConvertibleNote'],
-        conversion_triggers: convertTriggers(d.conversion_triggers, typeMap[d.convertible_type || 'OcfConvertibleNote'], d.id),
+        conversion_triggers: convertTriggers(d.conversion_triggers, d.id),
         ...(typeof d.pro_rata === 'number' || typeof d.pro_rata === 'string'
             ? {
                 pro_rata: (0, typeConversions_1.normalizeNumericString)(typeof d.pro_rata === 'number' ? d.pro_rata.toString() : d.pro_rata),
@@ -470,7 +435,33 @@ async function getConvertibleIssuanceAsOcf(client, params) {
             : {}),
         seniority: typeof d.seniority === 'number' ? d.seniority : Number(d.seniority),
         security_law_exemptions: d.security_law_exemptions,
-        ...(comments.length ? { comments } : {}),
+        ...(Array.isArray(d.comments) && d.comments.length > 0 ? { comments: d.comments } : {}),
+    };
+    return issuance;
+}
+/** Retrieve a ConvertibleIssuance contract and return it as an OCF JSON object */
+async function getConvertibleIssuanceAsOcf(client, params) {
+    const res = await client.getEventsByContractId({ contractId: params.contractId });
+    const created = res.created?.createdEvent;
+    if (!created?.createArgument) {
+        throw new errors_1.OcpContractError('Missing createArgument for ConvertibleIssuance', {
+            contractId: params.contractId,
+            code: errors_1.OcpErrorCodes.RESULT_NOT_FOUND,
+        });
+    }
+    const arg = created.createArgument;
+    if (typeof arg !== 'object' || !('issuance_data' in arg)) {
+        throw new errors_1.OcpParseError('Unexpected createArgument for ConvertibleIssuance', {
+            source: 'ConvertibleIssuance.createArgument',
+            code: errors_1.OcpErrorCodes.SCHEMA_MISMATCH,
+        });
+    }
+    const d = arg.issuance_data;
+    const native = damlConvertibleIssuanceDataToNative(d);
+    // Add object_type to create the full event type
+    const event = {
+        object_type: 'TX_CONVERTIBLE_ISSUANCE',
+        ...native,
     };
     return { event, contractId: params.contractId };
 }