@bithomp/xrpl-api 3.6.9 → 3.6.14

package/lib/ledger/account_tx.js

@@ -102,7 +102,8 @@ async function getTransactions(account, options = { limit: DEFAULT_LIMIT }) {
         if (options.balanceChanges === true || options.specification === true) {
             for (const transaction of result.transactions) {
                 if (options.balanceChanges === true) {
-                    transaction.balanceChanges = (0, balance_changes_1.parseBalanceChanges)(transaction.meta, Client.getNativeCurrency());
+                    const tx = transaction.tx || transaction;
+                    transaction.balanceChanges = (0, balance_changes_1.parseBalanceChanges)(transaction.meta, Client.getNativeCurrency(), tx);
                 }
                 if (options.specification === true) {
                     const details = (0, transaction_1.getAccountTxDetails)(transaction, options.includeRawTransactions);
@@ -184,7 +185,8 @@ async function findTransactionsExt(account, options = { limit: DEFAULT_LIMIT, ti
         if (formatted !== true && (loadOptions.balanceChanges === true || loadOptions.specification === true)) {
             for (const newTransaction of newTransactions) {
                 if (loadOptions.balanceChanges === true) {
-                    newTransaction.balanceChanges = (0, balance_changes_1.parseBalanceChanges)(newTransaction.meta, Client.getNativeCurrency());
+                    const tx = newTransaction.tx || newTransaction;
+                    newTransaction.balanceChanges = (0, balance_changes_1.parseBalanceChanges)(newTransaction.meta, Client.getNativeCurrency(), tx);
                 }
                 if (loadOptions.specification === true) {
                     const details = (0, transaction_1.getAccountTxDetails)(newTransaction, options.includeRawTransactions);

package/lib/ledger/transaction.js

@@ -91,7 +91,8 @@ async function getTransaction(transaction, options = {}) {
             return (0, transaction_1.getTxDetails)(result, options.includeRawTransaction === true, Client.getNativeCurrency(), options.definitions);
         }
         if (options.balanceChanges === true && typeof result.meta === "object") {
-            result.balanceChanges = (0, balance_changes_1.parseBalanceChanges)(result.meta, Client.getNativeCurrency());
+            const tx = result.tx || result.tx_json || result;
+            result.balanceChanges = (0, balance_changes_1.parseBalanceChanges)(result.meta, Client.getNativeCurrency(), tx);
         }
         if (options.specification === true) {
             const details = (0, transaction_1.getTxDetails)(result, options.includeRawTransaction, Client.getNativeCurrency(), options.definitions);
@@ -174,7 +175,8 @@ async function getTransactionByCTID(ctid, options = {}) {
         return (0, transaction_1.getTxDetails)(result, options.includeRawTransaction === true, Client.getNativeCurrency(), options.definitions);
     }
     if (options.balanceChanges === true && typeof result.meta === "object") {
-        result.balanceChanges = (0, balance_changes_1.parseBalanceChanges)(result.meta, Client.getNativeCurrency());
+        const tx = result.tx || result.tx_json || result;
+        result.balanceChanges = (0, balance_changes_1.parseBalanceChanges)(result.meta, Client.getNativeCurrency(), tx);
     }
     if (options.specification === true) {
         const details = (0, transaction_1.getTxDetails)(result, options.includeRawTransaction, Client.getNativeCurrency(), options.definitions);

package/lib/parse/index.d.ts

@@ -3,3 +3,4 @@ export * as Utils from "./utils";
 export * as Outcomes from "./outcome/index";
 export { parseOutcome } from "./outcome";
 export { parseTransactionType, parseTransaction } from "./transaction";
+export { normalizeMPTokensPreviousFields } from "./mptoken_normalize";

package/lib/parse/index.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseTransaction = exports.parseTransactionType = exports.parseOutcome = exports.Outcomes = exports.Utils = exports.Ledger = void 0;
+exports.normalizeMPTokensPreviousFields = exports.parseTransaction = exports.parseTransactionType = exports.parseOutcome = exports.Outcomes = exports.Utils = exports.Ledger = void 0;
 exports.Ledger = __importStar(require("./ledger"));
 exports.Utils = __importStar(require("./utils"));
 exports.Outcomes = __importStar(require("./outcome/index"));
@@ -42,3 +42,5 @@ Object.defineProperty(exports, "parseOutcome", { enumerable: true, get: function
 var transaction_1 = require("./transaction");
 Object.defineProperty(exports, "parseTransactionType", { enumerable: true, get: function () { return transaction_1.parseTransactionType; } });
 Object.defineProperty(exports, "parseTransaction", { enumerable: true, get: function () { return transaction_1.parseTransaction; } });
+var mptoken_normalize_1 = require("./mptoken_normalize");
+Object.defineProperty(exports, "normalizeMPTokensPreviousFields", { enumerable: true, get: function () { return mptoken_normalize_1.normalizeMPTokensPreviousFields; } });

package/lib/parse/mptoken_normalize.d.ts

@@ -0,0 +1,5 @@
+export declare function normalizeMPTokensPreviousFields(meta: any, tx: any): void;
+export declare function normalizeMPTokensPreviousFieldsEscrowCreate(meta: any): void;
+export declare function normalizeMPTokensPreviousFieldsEscrowFinish(meta: any): void;
+export declare function normalizeMPTokensPreviousFieldsEscrowCancel(meta: any): void;
+export declare function normalizeMPTokensPreviousFieldsTransfer(meta: any, tx: any): void;

package/lib/parse/mptoken_normalize.js

@@ -0,0 +1,215 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeMPTokensPreviousFields = normalizeMPTokensPreviousFields;
+exports.normalizeMPTokensPreviousFieldsEscrowCreate = normalizeMPTokensPreviousFieldsEscrowCreate;
+exports.normalizeMPTokensPreviousFieldsEscrowFinish = normalizeMPTokensPreviousFieldsEscrowFinish;
+exports.normalizeMPTokensPreviousFieldsEscrowCancel = normalizeMPTokensPreviousFieldsEscrowCancel;
+exports.normalizeMPTokensPreviousFieldsTransfer = normalizeMPTokensPreviousFieldsTransfer;
+const TRANSFER_TRANSACTION_TYPES = ["Payment", "CheckCash", "EscrowFinish", "Clawback", "AMMClawback"];
+function normalizeMPTokensPreviousFields(meta, tx) {
+    if (meta.TransactionResult !== "tesSUCCESS") {
+        return;
+    }
+    if (tx.TransactionType === "EscrowCreate") {
+        normalizeMPTokensPreviousFieldsEscrowCreate(meta);
+    }
+    else if (tx.TransactionType === "EscrowFinish") {
+        normalizeMPTokensPreviousFieldsEscrowFinish(meta);
+    }
+    else if (tx.TransactionType === "EscrowCancel") {
+        normalizeMPTokensPreviousFieldsEscrowCancel(meta);
+    }
+    else if (TRANSFER_TRANSACTION_TYPES.includes(tx.TransactionType)) {
+        normalizeMPTokensPreviousFieldsTransfer(meta, tx);
+    }
+}
+function normalizeMPTokensPreviousFieldsEscrowCreate(meta) {
+    const escrowNode = meta.AffectedNodes.find((node) => {
+        const createdNode = node.CreatedNode;
+        return createdNode && createdNode.LedgerEntryType === "Escrow";
+    });
+    if (!escrowNode) {
+        return;
+    }
+    const escrowFields = escrowNode.CreatedNode.NewFields;
+    const mptokenIssuanceID = escrowFields?.Amount?.mpt_issuance_id;
+    if (!mptokenIssuanceID) {
+        return;
+    }
+    const mptIssuanceNode = meta.AffectedNodes.find((node) => {
+        const modifiedNode = node.ModifiedNode;
+        return modifiedNode && modifiedNode.LedgerEntryType === "MPTokenIssuance";
+    });
+    if (mptIssuanceNode) {
+        const prevFields = mptIssuanceNode.ModifiedNode.PreviousFields;
+        if (prevFields && prevFields.LockedAmount === undefined) {
+            if (prevFields.LockedAmount === undefined) {
+                prevFields.LockedAmount = "0";
+            }
+        }
+    }
+    const mptokenNode = meta.AffectedNodes.find((node) => {
+        const modifiedNode = node.ModifiedNode;
+        return (modifiedNode &&
+            modifiedNode.LedgerEntryType === "MPToken" &&
+            modifiedNode.FinalFields.Account === escrowFields.Account &&
+            modifiedNode.FinalFields.MPTokenIssuanceID === mptokenIssuanceID);
+    });
+    if (mptokenNode) {
+        const finalFields = mptokenNode.ModifiedNode.FinalFields;
+        const prevFields = mptokenNode.ModifiedNode.PreviousFields;
+        if (prevFields && prevFields.LockedAmount === undefined) {
+            if (finalFields.Amount === undefined) {
+                finalFields.Amount = "0";
+            }
+            if (prevFields.LockedAmount === undefined) {
+                prevFields.LockedAmount = "0";
+            }
+        }
+    }
+}
+function normalizeMPTokensPreviousFieldsEscrowFinish(meta) {
+    const escrowNode = meta.AffectedNodes.find((node) => {
+        const deletedNode = node.DeletedNode;
+        return deletedNode && deletedNode.LedgerEntryType === "Escrow";
+    });
+    if (!escrowNode) {
+        return;
+    }
+    const escrowFields = escrowNode.DeletedNode.FinalFields;
+    const mptokenIssuanceID = escrowFields?.Amount?.mpt_issuance_id;
+    if (!mptokenIssuanceID) {
+        return;
+    }
+    const value = escrowFields?.Amount?.value ?? "0";
+    if (escrowFields.Account === escrowFields.Destination) {
+        const mptokenNode = meta.AffectedNodes.find((node) => {
+            const modifiedNode = node.ModifiedNode;
+            return (modifiedNode &&
+                modifiedNode.LedgerEntryType === "MPToken" &&
+                modifiedNode.FinalFields.Account === escrowFields.Account &&
+                modifiedNode.FinalFields.MPTokenIssuanceID === mptokenIssuanceID);
+        });
+        if (mptokenNode) {
+            const finalFields = mptokenNode.ModifiedNode.FinalFields;
+            const prevFields = mptokenNode.ModifiedNode.PreviousFields;
+            if (prevFields && prevFields.LockedAmount === undefined) {
+                if (finalFields.LockedAmount === undefined) {
+                    finalFields.LockedAmount = "0";
+                }
+                if (prevFields.MPTAmount === undefined) {
+                    prevFields.MPTAmount = "0";
+                }
+            }
+        }
+        return;
+    }
+    const mptokenSourceNode = meta.AffectedNodes.find((node) => {
+        const modifiedNode = node.ModifiedNode;
+        return (modifiedNode &&
+            modifiedNode.LedgerEntryType === "MPToken" &&
+            modifiedNode.FinalFields.Account === escrowFields.Account &&
+            modifiedNode.FinalFields.MPTokenIssuanceID === mptokenIssuanceID);
+    });
+    if (mptokenSourceNode) {
+        const finalFields = mptokenSourceNode.ModifiedNode.FinalFields;
+        const prevFields = mptokenSourceNode.ModifiedNode.PreviousFields;
+        if (prevFields && prevFields.MPTAmount === undefined) {
+            if (finalFields.MPTAmount === undefined) {
+                finalFields.MPTAmount = "0";
+            }
+            if (finalFields.LockedAmount === undefined) {
+                finalFields.LockedAmount = "0";
+            }
+            if (prevFields.LockedAmount === undefined) {
+                prevFields.LockedAmount = value;
+            }
+        }
+    }
+    const mptokenDestNode = meta.AffectedNodes.find((node) => {
+        const modifiedNode = node.ModifiedNode;
+        return (modifiedNode &&
+            modifiedNode.LedgerEntryType === "MPToken" &&
+            modifiedNode.FinalFields.Account === escrowFields.Destination &&
+            modifiedNode.FinalFields.MPTokenIssuanceID === mptokenIssuanceID);
+    });
+    if (mptokenDestNode) {
+        const prevFields = mptokenDestNode.ModifiedNode.PreviousFields;
+        if (prevFields && prevFields.LockedAmount === undefined) {
+            if (prevFields.MPTAmount === undefined) {
+                prevFields.MPTAmount = "0";
+            }
+        }
+    }
+}
+function normalizeMPTokensPreviousFieldsEscrowCancel(meta) {
+    const escrowNode = meta.AffectedNodes.find((node) => {
+        const deletedNode = node.DeletedNode;
+        return deletedNode && deletedNode.LedgerEntryType === "Escrow";
+    });
+    if (!escrowNode) {
+        return;
+    }
+    const escrowFields = escrowNode.DeletedNode.FinalFields;
+    const mptokenIssuanceID = escrowFields?.Amount?.mpt_issuance_id;
+    if (!mptokenIssuanceID) {
+        return;
+    }
+    const mptokenNode = meta.AffectedNodes.find((node) => {
+        const modifiedNode = node.ModifiedNode;
+        return (modifiedNode &&
+            modifiedNode.LedgerEntryType === "MPToken" &&
+            modifiedNode.FinalFields.Account === escrowFields.Account &&
+            modifiedNode.FinalFields.MPTokenIssuanceID === mptokenIssuanceID);
+    });
+    if (mptokenNode) {
+        const finalFields = mptokenNode.ModifiedNode.FinalFields;
+        const prevFields = mptokenNode.ModifiedNode.PreviousFields;
+        if (prevFields && prevFields.LockedAmount === undefined) {
+            if (finalFields.LockedAmount === undefined) {
+                finalFields.LockedAmount = "0";
+            }
+            if (prevFields.MPTAmount === undefined) {
+                prevFields.MPTAmount = "0";
+            }
+        }
+    }
+}
+function normalizeMPTokensPreviousFieldsTransfer(meta, tx) {
+    if (tx.Destination === undefined) {
+        return;
+    }
+    let amount = null;
+    if (typeof tx.Amount === "object") {
+        amount = tx.Amount;
+    }
+    else if (typeof tx.SendMax === "object") {
+        amount = tx.SendMax;
+    }
+    else if (typeof tx.DeliverMax === "object") {
+        amount = tx.DeliverMax;
+    }
+    if (!amount) {
+        return;
+    }
+    const mptokenIssuanceID = amount.mpt_issuance_id;
+    const destination = tx.Destination;
+    if (!mptokenIssuanceID || !destination) {
+        return;
+    }
+    const mptokenNode = meta.AffectedNodes.find((node) => {
+        const modifiedNode = node.ModifiedNode;
+        return (modifiedNode &&
+            modifiedNode.LedgerEntryType === "MPToken" &&
+            modifiedNode.FinalFields.Account === destination &&
+            modifiedNode.FinalFields.MPTokenIssuanceID === mptokenIssuanceID);
+    });
+    if (mptokenNode) {
+        const prevFields = mptokenNode.ModifiedNode.PreviousFields;
+        if (prevFields && prevFields.LockedAmount === undefined) {
+            if (prevFields.MPTAmount === undefined) {
+                prevFields.MPTAmount = "0";
+            }
+        }
+    }
+}

package/lib/parse/outcome/balance_changes.d.ts

@@ -13,7 +13,7 @@ export interface AddressBalanceChangeQuantity {
 export interface BalanceChanges {
     [key: string]: BalanceChangeQuantity[];
 }
-declare function parseBalanceChanges(metadata: TransactionMetadata, nativeCurrency?: string): BalanceChanges;
+declare function parseBalanceChanges(metadata: TransactionMetadata, nativeCurrency?: string, tx?: any): BalanceChanges;
 declare function parseFinalBalances(metadata: TransactionMetadata, nativeCurrency?: string): {
     [x: string]: BalanceChangeQuantity[];
 };

package/lib/parse/outcome/balance_changes.js

@@ -11,6 +11,7 @@ const common_1 = require("../../common");
 const client_1 = require("../../client");
 const utils_1 = require("../utils");
 const mptoken_1 = require("../../models/mptoken");
+const mptoken_normalize_1 = require("../mptoken_normalize");
 function groupByAddress(balanceChanges) {
     const grouped = lodash_1.default.groupBy(balanceChanges, function (node) {
         return node.address;
@@ -22,9 +23,6 @@ function groupByAddress(balanceChanges) {
     });
 }
 function parseValue(value) {
-    if (Array.isArray(value)) {
-        return new bignumber_js_1.default(0);
-    }
     if (typeof value === "string" || typeof value === "number") {
         return new bignumber_js_1.default(value);
     }
@@ -36,22 +34,29 @@ function computeBalanceChange(node) {
         value = parseValue(node.newFields.Balance);
     }
     else if (node.newFields.MPTAmount) {
-        value = parseValue(node.newFields);
+        value = parseValue(node.newFields.MPTAmount);
     }
     else if (node.previousFields.Balance && node.finalFields.Balance) {
         value = parseValue(node.finalFields.Balance).minus(parseValue(node.previousFields.Balance));
     }
-    else if (node.previousFields.MPTAmount || node.finalFields.MPTAmount) {
+    else if (node.entryType === "MPToken" && (node.previousFields.MPTAmount || node.previousFields.LockedAmount)) {
         value = parseValue(node.finalFields.MPTAmount ?? 0).minus(parseValue(node.previousFields.MPTAmount ?? 0));
+        if (node.previousFields.LockedAmount) {
+            value = value
+                .plus(parseValue(node.finalFields.LockedAmount ?? 0))
+                .minus(parseValue(node.previousFields.LockedAmount ?? 0));
+        }
     }
-    else if (node.newFields.MaximumAmount) {
-        value = parseValue(node.newFields.MaximumAmount);
-    }
-    else if (node.diffType === "DeletedNode" && node.finalFields.MaximumAmount) {
-        value = parseValue(node.finalFields.MaximumAmount).multipliedBy(-1);
-    }
-    else if (node.previousFields.OutstandingAmount) {
-        value = parseValue(node.previousFields.OutstandingAmount ?? 0).minus(parseValue(node.finalFields.OutstandingAmount ?? 0));
+    else if (node.entryType === "MPTokenIssuance") {
+        if (node.newFields.MaximumAmount) {
+            value = parseValue(node.newFields.MaximumAmount);
+        }
+        else if (node.diffType === "DeletedNode" && node.finalFields.MaximumAmount) {
+            value = parseValue(node.finalFields.MaximumAmount).multipliedBy(-1);
+        }
+        else if (node.previousFields.OutstandingAmount) {
+            value = parseValue(node.previousFields.OutstandingAmount ?? 0).minus(parseValue(node.finalFields.OutstandingAmount ?? 0));
+        }
     }
     return value === null ? null : value.isZero() ? null : value;
 }
@@ -62,17 +67,19 @@ function parseFinalBalance(node) {
     else if (node.finalFields.Balance) {
         return parseValue(node.finalFields.Balance);
     }
-    else if (node.finalFields.MPTAmount) {
+    else if (node.entryType === "MPToken") {
         return parseValue(node.finalFields.MPTAmount);
     }
-    else if (node.newFields.MaximumAmount) {
-        return parseValue(node.newFields.MaximumAmount);
-    }
-    else if (node.diffType === "DeletedNode" && node.finalFields.MaximumAmount) {
-        return new bignumber_js_1.default(0);
-    }
-    else if (node.finalFields.MaximumAmount) {
-        return parseValue(node.finalFields.MaximumAmount).minus(parseValue(node.finalFields.OutstandingAmount));
+    else if (node.entryType === "MPTokenIssuance") {
+        if (node.newFields.MaximumAmount) {
+            return parseValue(node.newFields.MaximumAmount);
+        }
+        else if (node.diffType === "DeletedNode" && node.finalFields.MaximumAmount) {
+            return new bignumber_js_1.default(0);
+        }
+        else if (node.finalFields.MaximumAmount) {
+            return parseValue(node.finalFields.MaximumAmount).minus(parseValue(node.finalFields.OutstandingAmount));
+        }
     }
     return null;
 }
@@ -181,7 +188,10 @@ function parseQuantities(metadata, valueParser, nativeCurrency) {
     });
     return groupByAddress(lodash_1.default.compact(lodash_1.default.flatten(values)));
 }
-function parseBalanceChanges(metadata, nativeCurrency) {
+function parseBalanceChanges(metadata, nativeCurrency, tx) {
+    if (tx && nativeCurrency === common_1.MAINNET_NATIVE_CURRENCY && metadata.TransactionResult === "tesSUCCESS") {
+        (0, mptoken_normalize_1.normalizeMPTokensPreviousFields)(metadata, tx);
+    }
     return parseQuantities(metadata, computeBalanceChange, nativeCurrency);
 }
 function parseFinalBalances(metadata, nativeCurrency) {

package/lib/parse/outcome/delivered_amount.js

@@ -14,7 +14,7 @@ function parseDeliveredAmount(tx, balanceChanges) {
         return undefined;
     }
     if (tx.TransactionType === "Payment") {
-        const txBalanceChanges = balanceChanges || (0, balance_changes_1.parseBalanceChanges)(tx.meta, (0, client_1.getNativeCurrency)());
+        const txBalanceChanges = balanceChanges || (0, balance_changes_1.parseBalanceChanges)(tx.meta, (0, client_1.getNativeCurrency)(), tx);
         if (txBalanceChanges) {
             const account = tx.Destination;
             const changes = txBalanceChanges[account];
@@ -27,7 +27,7 @@ function parseDeliveredAmount(tx, balanceChanges) {
         }
     }
     else if (tx.TransactionType === "CheckCash") {
-        const txBalanceChanges = balanceChanges || (0, balance_changes_1.parseBalanceChanges)(tx.meta, (0, client_1.getNativeCurrency)());
+        const txBalanceChanges = balanceChanges || (0, balance_changes_1.parseBalanceChanges)(tx.meta, (0, client_1.getNativeCurrency)(), tx);
         if (txBalanceChanges) {
             const account = tx.Account;
             const changes = txBalanceChanges[account];
@@ -40,7 +40,7 @@ function parseDeliveredAmount(tx, balanceChanges) {
         }
     }
     else if (tx.TransactionType === "Import") {
-        const txBalanceChanges = balanceChanges || (0, balance_changes_1.parseBalanceChanges)(tx.meta, (0, client_1.getNativeCurrency)());
+        const txBalanceChanges = balanceChanges || (0, balance_changes_1.parseBalanceChanges)(tx.meta, (0, client_1.getNativeCurrency)(), tx);
         const blob = (0, import_1.parseImportBlob)(tx.Blob);
         if (typeof blob === "object") {
             const account = blob.transaction.tx.Account;

package/lib/parse/outcome/locked_balance_changes.d.ts

@@ -1,9 +1,10 @@
 import { TransactionMetadata } from "xrpl";
 interface LockedBalanceChangeQuantity {
-    issuer: string;
-    currency: string;
+    issuer?: string;
+    currency?: string;
     value: string;
-    counterparty: string;
+    counterparty?: string;
+    mpt_issuance_id?: string;
 }
 export interface AddressLockedBalanceChangeQuantity {
     address: string;
@@ -12,9 +13,7 @@ export interface AddressLockedBalanceChangeQuantity {
 export interface LockedBalanceChanges {
     [key: string]: LockedBalanceChangeQuantity[];
 }
-declare function parseLockedBalanceChanges(metadata: TransactionMetadata): {
-    [x: string]: LockedBalanceChangeQuantity[];
-};
+declare function parseLockedBalanceChanges(metadata: TransactionMetadata): LockedBalanceChanges;
 declare function parseFinalLockedBalances(metadata: TransactionMetadata): {
     [x: string]: LockedBalanceChangeQuantity[];
 };

package/lib/parse/outcome/locked_balance_changes.js

@@ -19,7 +19,10 @@ function groupByAddress(lockedBalanceChanges) {
     });
 }
 function parseValue(value) {
-    return new bignumber_js_1.default(value.value ?? value);
+    if (typeof value === "string" || typeof value === "number") {
+        return new bignumber_js_1.default(value);
+    }
+    return new bignumber_js_1.default(value.value ?? 0);
 }
 function computeBalanceChange(node) {
     let value = null;
@@ -32,6 +35,9 @@ function computeBalanceChange(node) {
     else if (node.previousFields.LockedBalance) {
         value = parseValue(node.previousFields.LockedBalance).negated();
     }
+    else if (node.finalFields.LockedAmount || node.previousFields.LockedAmount) {
+        value = parseValue(node.finalFields.LockedAmount ?? 0).minus(parseValue(node.previousFields.LockedAmount ?? 0));
+    }
     return value === null ? null : value.isZero() ? null : value;
 }
 function parseFinalBalance(node) {
@@ -72,16 +78,33 @@ function parseTrustlineQuantity(node, valueParser) {
     };
     return [result];
 }
+function parseMPTQuantity(node, valueParser) {
+    const value = valueParser(node);
+    if (value === null) {
+        return null;
+    }
+    const fields = lodash_1.default.isEmpty(node.newFields) ? node.finalFields : node.newFields;
+    return {
+        address: fields.Account,
+        lockedBalance: {
+            value: value.toString(),
+            mpt_issuance_id: fields.MPTokenIssuanceID,
+        },
+    };
+}
 function parseQuantities(metadata, valueParser) {
     const values = metadata.AffectedNodes.map(function (affectedNode) {
         const node = affectedNode.CreatedNode || affectedNode.ModifiedNode || affectedNode.DeletedNode;
-        if (node.LedgerEntryType !== "RippleState") {
+        if (!["RippleState", "MPToken"].includes(node.LedgerEntryType)) {
             return [];
         }
         const normalizedNode = (0, utils_1.normalizeNode)(affectedNode);
         if (node.LedgerEntryType === "RippleState") {
             return parseTrustlineQuantity(normalizedNode, valueParser);
         }
+        else if (node.LedgerEntryType === "MPToken") {
+            return [parseMPTQuantity(normalizedNode, valueParser)];
+        }
         return [];
     });
     return groupByAddress(lodash_1.default.compact(lodash_1.default.flatten(values)));

package/lib/parse/outcome/mptoken_changes.js

@@ -50,6 +50,7 @@ class MPTokenChanges {
                         mptIssuanceID,
                         account,
                         amount: node.NewFields.MPTAmount,
+                        lockedAmount: node.NewFields.LockedAmount,
                     });
                 }
                 if (affectedNode.ModifiedNode) {
@@ -61,6 +62,15 @@ class MPTokenChanges {
                     if (amountChange === "0") {
                         amountChange = undefined;
                     }
+                    let lockedAmountChange = undefined;
+                    if (node.PreviousFields.LockedAmount !== undefined) {
+                        lockedAmountChange = new bignumber_js_1.default(node.FinalFields.LockedAmount ?? 0)
+                            .minus(node.PreviousFields.LockedAmount ?? 0)
+                            .toString();
+                        if (lockedAmountChange === "0") {
+                            lockedAmountChange = undefined;
+                        }
+                    }
                     let flagsChange;
                     if (node.PreviousFields?.Flags !== undefined) {
                         flagsChange = (0, mptoken_flags_1.default)(node.PreviousFields.Flags);
@@ -71,7 +81,9 @@ class MPTokenChanges {
                         mptIssuanceID,
                         account,
                         amount: node.FinalFields.MPTAmount,
+                        lockedAmount: node.FinalFields.LockedAmount,
                         amountChange,
+                        lockedAmountChange,
                         flagsChange,
                     });
                 }
@@ -84,6 +96,7 @@ class MPTokenChanges {
                         mptIssuanceID,
                         account,
                         amount: node.FinalFields.MPTAmount,
+                        lockedAmount: node.FinalFields.LockedAmount,
                     });
                 }
             }

package/lib/parse/outcome/mptoken_issuance_changes.js

@@ -50,6 +50,7 @@ class MPTokenIssuanceChanges {
                         transferFee: node.NewFields.TransferFee,
                         maximumAmount: node.NewFields.MaximumAmount,
                         outstandingAmount: node.NewFields.OutstandingAmount,
+                        lockedAmount: node.NewFields.LockedAmount,
                         metadata: node.NewFields.Metadata,
                         scale: node.NewFields.AssetScale,
                     });
@@ -62,6 +63,23 @@ class MPTokenIssuanceChanges {
                     if (outstandingAmountChange === "0") {
                         outstandingAmountChange = undefined;
                     }
+                    let lockedAmountChange = undefined;
+                    if (node.PreviousFields.LockedAmount !== undefined) {
+                        lockedAmountChange = new bignumber_js_1.default(node.FinalFields.LockedAmount ?? 0)
+                            .minus(new bignumber_js_1.default(node.PreviousFields.LockedAmount ?? 0))
+                            .toString();
+                        if (lockedAmountChange === "0") {
+                            lockedAmountChange = undefined;
+                        }
+                    }
+                    let lockedAmount = node.FinalFields.LockedAmount;
+                    if (lockedAmount === undefined && lockedAmountChange !== undefined) {
+                        lockedAmount = "0";
+                    }
+                    let flagsChange;
+                    if (node.PreviousFields?.Flags !== undefined) {
+                        flagsChange = (0, mptoken_issuance_flags_1.default)(node.PreviousFields.Flags);
+                    }
                     this.addChange(mptIssuanceID, {
                         status: "modified",
                         flags: (0, mptoken_issuance_flags_1.default)(node.FinalFields.Flags),
@@ -71,10 +89,12 @@ class MPTokenIssuanceChanges {
                         transferFee: node.FinalFields.TransferFee,
                         maximumAmount: node.FinalFields.MaximumAmount,
                         outstandingAmount: node.FinalFields.OutstandingAmount,
+                        lockedAmount,
                         metadata: node.FinalFields.Metadata,
                         scale: node.FinalFields.AssetScale,
                         outstandingAmountChange,
-                        flagsChange: node.PreviousFields.hasOwnProperty("Flags") ? (0, mptoken_issuance_flags_1.default)(node.PreviousFields.Flags) : undefined,
+                        lockedAmountChange,
+                        flagsChange,
                     });
                 }
                 if (affectedNode.DeletedNode) {
@@ -88,6 +108,7 @@ class MPTokenIssuanceChanges {
                         transferFee: node.FinalFields.TransferFee,
                         maximumAmount: node.FinalFields.MaximumAmount,
                         outstandingAmount: node.FinalFields.OutstandingAmount,
+                        lockedAmount: node.FinalFields.LockedAmount,
                         metadata: node.FinalFields.Metadata,
                         scale: node.FinalFields.AssetScale,
                     });

package/lib/parse/outcome.js

@@ -35,6 +35,9 @@ const MPTOKEN_TYPES = [
     "MPTokenIssuanceDestroy",
     "Payment",
     "Clawback",
+    "EscrowFinish",
+    "EscrowCreate",
+    "EscrowCancel",
 ];
 const CREDENTIAL_TYPES = ["CredentialCreate", "CredentialAccept", "CredentialDelete"];
 const DELEGATE_TYPES = ["DelegateSet"];
@@ -79,7 +82,7 @@ function parseOutcome(tx, nativeCurrency, definitions) {
     });
 }
 function getBalanceChanges(tx, nativeCurrency) {
-    const balanceChanges = (0, index_1.parseBalanceChanges)(tx.meta, nativeCurrency);
+    const balanceChanges = (0, index_1.parseBalanceChanges)(tx.meta, nativeCurrency, tx);
     return Object.keys(balanceChanges).length > 0 ? balanceChanges : undefined;
 }
 function getLockedBalanceChanges(tx) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bithomp/xrpl-api",
-  "version": "3.6.9",
+  "version": "3.6.14",
   "description": "A Bithomp JavaScript/TypeScript library for interacting with the XRP Ledger",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",