@bithomp/xrpl-api 3.6.5 → 3.6.9

package/lib/models/index.d.ts

@@ -34,4 +34,5 @@ import parseTrustlineFlags from "../parse/ledger/trustline-flags";
 import parseOfferFlags from "../parse/ledger/offer-flags";
 import parseCredentialFlags from "../parse/ledger/credential-flags";
 import parseMPTokenIssuanceFlags from "../parse/ledger/mptoken-issuance-flags";
-export { parseNFTokenMint, parseNFTokenBurn, parseNFTokenFlags, parseNFTOfferFlags, parseNFTokenAcceptOffer, parseNFTokenCancelOffer, parseNFTokenCreateOffer, parseURITokenFlags, parseTrustlineFlags, parseOfferFlags, parseCredentialFlags, parseMPTokenIssuanceFlags, };
+import parseMPTokenFlags from "../parse/ledger/mptoken-flags";
+export { parseNFTokenMint, parseNFTokenBurn, parseNFTokenFlags, parseNFTOfferFlags, parseNFTokenAcceptOffer, parseNFTokenCancelOffer, parseNFTokenCreateOffer, parseURITokenFlags, parseTrustlineFlags, parseOfferFlags, parseCredentialFlags, parseMPTokenIssuanceFlags, parseMPTokenFlags, };

package/lib/models/index.js

@@ -17,7 +17,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseMPTokenIssuanceFlags = exports.parseCredentialFlags = exports.parseOfferFlags = exports.parseTrustlineFlags = exports.parseURITokenFlags = exports.parseNFTokenCreateOffer = exports.parseNFTokenCancelOffer = exports.parseNFTokenAcceptOffer = exports.parseNFTOfferFlags = exports.parseNFTokenFlags = exports.parseNFTokenBurn = exports.parseNFTokenMint = exports.parseMPTokenChanges = exports.parseMPTokenIssuanceChanges = exports.parseOrderbookChanges = exports.parseChannelChanges = exports.parseLockedBalanceChanges = exports.parseFinalBalances = exports.parseBalanceChanges = exports.parseURITokenSellOfferChanges = exports.parseURITokenChanges = exports.parseNFTokenOfferChanges = exports.parseNFTokenChanges = exports.parseAffectedObjects = void 0;
+exports.parseMPTokenFlags = exports.parseMPTokenIssuanceFlags = exports.parseCredentialFlags = exports.parseOfferFlags = exports.parseTrustlineFlags = exports.parseURITokenFlags = exports.parseNFTokenCreateOffer = exports.parseNFTokenCancelOffer = exports.parseNFTokenAcceptOffer = exports.parseNFTOfferFlags = exports.parseNFTokenFlags = exports.parseNFTokenBurn = exports.parseNFTokenMint = exports.parseMPTokenChanges = exports.parseMPTokenIssuanceChanges = exports.parseOrderbookChanges = exports.parseChannelChanges = exports.parseLockedBalanceChanges = exports.parseFinalBalances = exports.parseBalanceChanges = exports.parseURITokenSellOfferChanges = exports.parseURITokenChanges = exports.parseNFTokenOfferChanges = exports.parseNFTokenChanges = exports.parseAffectedObjects = void 0;
 __exportStar(require("./account_info"), exports);
 __exportStar(require("./account_nfts"), exports);
 __exportStar(require("./account_object"), exports);
@@ -78,3 +78,5 @@ const credential_flags_1 = __importDefault(require("../parse/ledger/credential-f
 exports.parseCredentialFlags = credential_flags_1.default;
 const mptoken_issuance_flags_1 = __importDefault(require("../parse/ledger/mptoken-issuance-flags"));
 exports.parseMPTokenIssuanceFlags = mptoken_issuance_flags_1.default;
+const mptoken_flags_1 = __importDefault(require("../parse/ledger/mptoken-flags"));
+exports.parseMPTokenFlags = mptoken_flags_1.default;

package/lib/parse/ledger/mptoken-flags.d.ts

@@ -0,0 +1,6 @@
+import { MPTokenFlagsKeysInterface } from "../../types/mptokens";
+declare function parseMPTokenFlags(value: number, options?: {
+    excludeFalse?: boolean;
+    nativeCurrency?: string;
+}): MPTokenFlagsKeysInterface;
+export default parseMPTokenFlags;

package/lib/parse/ledger/mptoken-flags.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const mptokens_1 = require("../../types/mptokens");
+const flags_1 = require("./flags");
+function parseMPTokenFlags(value, options = {}) {
+    return (0, flags_1.parseFlags)(value, mptokens_1.MPTokenFlagsKeys, options);
+}
+exports.default = parseMPTokenFlags;

package/lib/parse/outcome/balance_changes.js

@@ -10,6 +10,7 @@ const bignumber_js_1 = __importDefault(require("bignumber.js"));
 const common_1 = require("../../common");
 const client_1 = require("../../client");
 const utils_1 = require("../utils");
+const mptoken_1 = require("../../models/mptoken");
 function groupByAddress(balanceChanges) {
     const grouped = lodash_1.default.groupBy(balanceChanges, function (node) {
         return node.address;
@@ -27,7 +28,7 @@ function parseValue(value) {
     if (typeof value === "string" || typeof value === "number") {
         return new bignumber_js_1.default(value);
     }
-    return new bignumber_js_1.default(value.value ?? value.MPTAmount ?? 0);
+    return new bignumber_js_1.default(value.value ?? 0);
 }
 function computeBalanceChange(node) {
     let value = null;
@@ -41,7 +42,16 @@ function computeBalanceChange(node) {
         value = parseValue(node.finalFields.Balance).minus(parseValue(node.previousFields.Balance));
     }
     else if (node.previousFields.MPTAmount || node.finalFields.MPTAmount) {
-        value = parseValue(node.finalFields).minus(parseValue(node.previousFields));
+        value = parseValue(node.finalFields.MPTAmount ?? 0).minus(parseValue(node.previousFields.MPTAmount ?? 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));
     }
     return value === null ? null : value.isZero() ? null : value;
 }
@@ -53,7 +63,16 @@ function parseFinalBalance(node) {
         return parseValue(node.finalFields.Balance);
     }
     else if (node.finalFields.MPTAmount) {
-        return parseValue(node.finalFields);
+        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));
     }
     return null;
 }
@@ -125,10 +144,24 @@ function parseMPTQuantity(node, valueParser) {
         },
     };
 }
+function parseMPTokenIssuanceQuantity(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.Issuer,
+        balance: {
+            value: value.toString(),
+            mpt_issuance_id: (0, mptoken_1.buildMPTokenIssuanceID)(fields.Sequence, fields.Issuer),
+        },
+    };
+}
 function parseQuantities(metadata, valueParser, nativeCurrency) {
     const values = metadata.AffectedNodes.map(function (affectedNode) {
         const node = affectedNode.CreatedNode || affectedNode.ModifiedNode || affectedNode.DeletedNode;
-        if (!["AccountRoot", "RippleState", "MPToken"].includes(node.LedgerEntryType)) {
+        if (!["AccountRoot", "RippleState", "MPToken", "MPTokenIssuance"].includes(node.LedgerEntryType)) {
             return [];
         }
         const normalizedNode = (0, utils_1.normalizeNode)(affectedNode);
@@ -141,6 +174,9 @@ function parseQuantities(metadata, valueParser, nativeCurrency) {
         else if (node.LedgerEntryType === "MPToken") {
             return [parseMPTQuantity(normalizedNode, valueParser)];
         }
+        else if (node.LedgerEntryType === "MPTokenIssuance") {
+            return [parseMPTokenIssuanceQuantity(normalizedNode, valueParser)];
+        }
         return [];
     });
     return groupByAddress(lodash_1.default.compact(lodash_1.default.flatten(values)));

package/lib/parse/outcome/mptoken_changes.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseMPTokenChanges = parseMPTokenChanges;
 const bignumber_js_1 = __importDefault(require("bignumber.js"));
 const common_1 = require("../../common");
+const mptoken_flags_1 = __importDefault(require("../ledger/mptoken-flags"));
 function parseMPTokenChanges(tx) {
     return new MPTokenChanges(tx).call();
 }
@@ -45,7 +46,7 @@ class MPTokenChanges {
                     const account = node.NewFields.Account;
                     this.addChange(mptIssuanceID, account, {
                         status: "added",
-                        flags: node.NewFields.Flags,
+                        flags: (0, mptoken_flags_1.default)(node.NewFields.Flags),
                         mptIssuanceID,
                         account,
                         amount: node.NewFields.MPTAmount,
@@ -60,14 +61,18 @@ class MPTokenChanges {
                     if (amountChange === "0") {
                         amountChange = undefined;
                     }
+                    let flagsChange;
+                    if (node.PreviousFields?.Flags !== undefined) {
+                        flagsChange = (0, mptoken_flags_1.default)(node.PreviousFields.Flags);
+                    }
                     this.addChange(mptIssuanceID, account, {
                         status: "modified",
-                        flags: node.FinalFields.Flags,
+                        flags: (0, mptoken_flags_1.default)(node.FinalFields.Flags),
                         mptIssuanceID,
                         account,
                         amount: node.FinalFields.MPTAmount,
                         amountChange,
-                        flagsChange: node.PreviousFields.Flags,
+                        flagsChange,
                     });
                 }
                 if (affectedNode.DeletedNode) {
@@ -75,7 +80,7 @@ class MPTokenChanges {
                     const account = node.FinalFields.Account;
                     this.addChange(mptIssuanceID, account, {
                         status: "removed",
-                        flags: node.FinalFields.Flags,
+                        flags: (0, mptoken_flags_1.default)(node.FinalFields.Flags),
                         mptIssuanceID,
                         account,
                         amount: node.FinalFields.MPTAmount,

package/lib/types/mptokens.d.ts

@@ -74,3 +74,11 @@ export type FormattedMPTokenIssuanceSetSpecification = {
     holder?: string;
     mptIssuanceID?: string;
 } & FormattedBaseSpecification;
+export declare const MPTokenFlagsKeys: {
+    locked: number;
+    authorized: number;
+};
+export interface MPTokenFlagsKeysInterface {
+    locked?: boolean;
+    authorized?: boolean;
+}

package/lib/types/mptokens.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MPTokenAuthorizeFlagsKeys = exports.MPTokenIssuanceSetFlagsKeys = exports.MPTokenIssuanceCreateFlagsKeys = exports.MPTokenIssuanceFlagsKeys = void 0;
+exports.MPTokenFlagsKeys = exports.MPTokenAuthorizeFlagsKeys = exports.MPTokenIssuanceSetFlagsKeys = exports.MPTokenIssuanceCreateFlagsKeys = exports.MPTokenIssuanceFlagsKeys = void 0;
 exports.getMPTokenIssuanceCreateFlagsKeys = getMPTokenIssuanceCreateFlagsKeys;
 exports.getMPTokenIssuanceSetFlagsKeys = getMPTokenIssuanceSetFlagsKeys;
 exports.getMPTokenAuthorizeFlagsKeys = getMPTokenAuthorizeFlagsKeys;
@@ -70,3 +70,7 @@ function getMPTokenAuthorizeFlagsKeys(nativeCurrency) {
     }
     return nativeCurrencyMPTokenAuthorizeFlags[nativeCurrency];
 }
+exports.MPTokenFlagsKeys = {
+    locked: 0x00000001,
+    authorized: 0x00000002,
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bithomp/xrpl-api",
-  "version": "3.6.5",
+  "version": "3.6.9",
   "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"
@@ -74,16 +74,16 @@
     "@typescript-eslint/parser": "^8.45.0",
     "chai": "^6.2.0",
     "chai-as-promised": "^8.0.2",
-    "eslint": "^9.36.0",
+    "eslint": "^9.37.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-chai-friendly": "^1.1.0",
     "eslint-plugin-import": "^2.32.0",
     "eslint-plugin-n": "^17.23.1",
     "eslint-plugin-promise": "^7.2.1",
-    "mocha": "^11.7.2",
+    "mocha": "^11.7.4",
     "nconf": "^0.13.0",
     "ts-jest": "^29.4.4",
     "ts-node": "^10.9.2",
-    "typescript": "^5.9.2"
+    "typescript": "^5.9.3"
   }
 }