@bithomp/xrpl-api 3.6.14 → 3.6.15

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

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

package/lib/parse/outcome/balance_changes.js

@@ -12,6 +12,8 @@ const client_1 = require("../../client");
 const utils_1 = require("../utils");
 const mptoken_1 = require("../../models/mptoken");
 const mptoken_normalize_1 = require("../mptoken_normalize");
+const amount_1 = __importDefault(require("../ledger/amount"));
+const ESCROW_TYPES = ["EscrowFinish", "EscrowCreate", "EscrowCancel"];
 function groupByAddress(balanceChanges) {
     const grouped = lodash_1.default.groupBy(balanceChanges, function (node) {
         return node.address;
@@ -188,11 +190,64 @@ function parseQuantities(metadata, valueParser, nativeCurrency) {
     });
     return groupByAddress(lodash_1.default.compact(lodash_1.default.flatten(values)));
 }
-function parseBalanceChanges(metadata, nativeCurrency, tx) {
+function adjustBalancesForNativeEscrow(balanceChanges, metadata, nativeCurrency, tx) {
+    let escrow;
+    if (tx.TransactionType === "EscrowCreate") {
+        escrow = metadata.AffectedNodes.find((node) => node.CreatedNode?.LedgerEntryType === "Escrow");
+    }
+    else {
+        escrow = metadata.AffectedNodes.find((node) => node.DeletedNode?.LedgerEntryType === "Escrow");
+    }
+    if (!escrow) {
+        return;
+    }
+    const fields = escrow.CreatedNode?.NewFields || escrow.DeletedNode?.FinalFields;
+    if (!fields || !fields.Amount) {
+        return;
+    }
+    const amount = (0, amount_1.default)(fields.Amount);
+    if (!amount || amount.currency !== (nativeCurrency || common_1.MAINNET_NATIVE_CURRENCY) || !amount.value) {
+        return;
+    }
+    const source = fields.Account;
+    if (tx.TransactionType === "EscrowCreate") {
+        adjustBalancesChanges(balanceChanges, source, [{ currency: amount.currency, value: amount.value }]);
+    }
+    else if (tx.TransactionType === "EscrowFinish" || tx.TransactionType === "EscrowCancel") {
+        adjustBalancesChanges(balanceChanges, source, [{ currency: amount.currency, value: `-${amount.value}` }]);
+    }
+}
+function adjustBalancesChanges(balanceChanges, address, changes) {
+    const existingChanges = balanceChanges[address] || [];
+    const change = existingChanges.find((c) => c.currency === changes[0].currency && c.issuer === changes[0].issuer);
+    if (change) {
+        const newValue = new bignumber_js_1.default(change.value).plus(new bignumber_js_1.default(changes[0].value));
+        if (newValue.isZero()) {
+            balanceChanges[address] = existingChanges.filter((c) => c !== change);
+            if (balanceChanges[address].length === 0) {
+                delete balanceChanges[address];
+            }
+        }
+        else {
+            change.value = newValue.toString();
+        }
+    }
+    else {
+        existingChanges.push(changes[0]);
+        balanceChanges[address] = existingChanges;
+    }
+}
+function parseBalanceChanges(metadata, nativeCurrency, tx, options) {
     if (tx && nativeCurrency === common_1.MAINNET_NATIVE_CURRENCY && metadata.TransactionResult === "tesSUCCESS") {
         (0, mptoken_normalize_1.normalizeMPTokensPreviousFields)(metadata, tx);
     }
-    return parseQuantities(metadata, computeBalanceChange, nativeCurrency);
+    const balanceChanges = parseQuantities(metadata, computeBalanceChange, nativeCurrency);
+    if (tx && options && options.adjustBalancesForNativeEscrow) {
+        if (tx.TransactionType && ESCROW_TYPES.includes(tx.TransactionType)) {
+            adjustBalancesForNativeEscrow(balanceChanges, metadata, nativeCurrency, tx);
+        }
+    }
+    return balanceChanges;
 }
 function parseFinalBalances(metadata, nativeCurrency) {
     return parseQuantities(metadata, parseFinalBalance, nativeCurrency);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bithomp/xrpl-api",
-  "version": "3.6.14",
+  "version": "3.6.15",
   "description": "A Bithomp JavaScript/TypeScript library for interacting with the XRP Ledger",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -43,7 +43,7 @@
     "format": "prettier --write \"src/**/*.ts\" \"src/**/*.js\"",
     "lint": "eslint",
     "prepare": "npm run build",
-    "prepublishOnly": "npm test && npm run lint",
+    "-prepublishOnly": "npm test && npm run lint",
     "preversion": "npm run lint",
     "version": "npm run format && git add -A src",
     "postversion": "git push && git push --tags"
@@ -70,8 +70,8 @@
     "@types/mocha": "^10.0.10",
     "@types/nconf": "^0.10.7",
     "@types/node": "^22.15.21",
-    "@typescript-eslint/eslint-plugin": "^8.45.0",
-    "@typescript-eslint/parser": "^8.45.0",
+    "@typescript-eslint/eslint-plugin": "^8.46.1",
+    "@typescript-eslint/parser": "^8.46.1",
     "chai": "^6.2.0",
     "chai-as-promised": "^8.0.2",
     "eslint": "^9.37.0",
@@ -82,7 +82,7 @@
     "eslint-plugin-promise": "^7.2.1",
     "mocha": "^11.7.4",
     "nconf": "^0.13.0",
-    "ts-jest": "^29.4.4",
+    "ts-jest": "^29.4.5",
     "ts-node": "^10.9.2",
     "typescript": "^5.9.3"
   }