@bithomp/xrpl-api 3.2.19 → 3.2.21

package/lib/parse/ledger/amount.js

@@ -9,7 +9,7 @@ function parseAmount(amount) {
             value: (0, common_1.dropsToXrp)(amount),
         };
     }
-    if ("value" in amount && "currency" in amount && "issuer" in amount) {
+    if (amount && "value" in amount && "currency" in amount && "issuer" in amount) {
         return {
             issuer: amount.issuer,
             currency: amount.currency,

package/lib/parse/outcome/nftoken_changes.js

@@ -55,8 +55,13 @@ class NFTokenChanges {
         if (this.hasAffectedNodes() === false) {
             return this.changes;
         }
-        this.parseAffectedNodes();
-        this.parseNFTokensChanges();
+        if (this.tx.TransactionType === "NFTokenModify") {
+            this.parseNFTokensURIChanges();
+        }
+        else {
+            this.parseAffectedNodes();
+            this.parseNFTokensChanges();
+        }
         return this.changes;
     }
     hasAffectedNodes() {
@@ -172,4 +177,58 @@ class NFTokenChanges {
         }
         return undefined;
     }
+    parseNFTokensURIChanges() {
+        const nftokenID = this.tx.NFTokenID;
+        const nftokenChanges = this.findNFTokenChangedNode(nftokenID);
+        if (!nftokenChanges) {
+            return;
+        }
+        const [currentTokenNode, previousTokenNode] = nftokenChanges;
+        const uri = currentTokenNode?.URI;
+        const previousURI = previousTokenNode?.URI;
+        if (uri === previousURI) {
+            return;
+        }
+        this.addChange(currentTokenNode.account, {
+            status: "modified",
+            nftokenID,
+            uri,
+            previousURI,
+        });
+    }
+    findNFTokenChangedNode(nftokenID) {
+        let currentTokenNode;
+        let previousTokenNode;
+        for (const affectedNode of this.tx.meta.AffectedNodes) {
+            const node = affectedNode.ModifiedNode;
+            if (node?.LedgerEntryType === "NFTokenPage") {
+                if (Array.isArray(node.FinalFields?.NFTokens)) {
+                    for (const tokenNode of node.FinalFields?.NFTokens) {
+                        if (tokenNode.NFToken.NFTokenID === nftokenID) {
+                            currentTokenNode = tokenNode.NFToken;
+                            const account = AddressCodec.encodeAccountID(Buffer.from(node?.LedgerIndex.slice(0, 40), "hex"));
+                            currentTokenNode.account = account;
+                            if (currentTokenNode && previousTokenNode) {
+                                return [currentTokenNode, previousTokenNode];
+                            }
+                        }
+                    }
+                }
+                if (Array.isArray(node.PreviousFields?.NFTokens)) {
+                    for (const tokenNode of node.PreviousFields?.NFTokens) {
+                        if (tokenNode.NFToken.NFTokenID === nftokenID) {
+                            previousTokenNode = tokenNode.NFToken;
+                            if (currentTokenNode && previousTokenNode) {
+                                return [currentTokenNode, previousTokenNode];
+                            }
+                        }
+                    }
+                }
+            }
+        }
+        if (!currentTokenNode || !previousTokenNode) {
+            return undefined;
+        }
+        return [currentTokenNode, previousTokenNode];
+    }
 }

package/lib/parse/specification/nftoken-modify.d.ts

@@ -0,0 +1,3 @@
+import { FormattedNFTokenModifySpecification } from "../../types/nftokens";
+declare function parseNFTokenModify(tx: any): FormattedNFTokenModifySpecification;
+export default parseNFTokenModify;

package/lib/parse/specification/nftoken-modify.js

@@ -0,0 +1,56 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const assert = __importStar(require("assert"));
+const common_1 = require("../../common");
+const emit_details_1 = require("../ledger/emit_details");
+const memos_1 = require("../ledger/memos");
+const signers_1 = require("../ledger/signers");
+const regular_key_1 = require("../ledger/regular-key");
+const source_1 = require("../ledger/source");
+function parseNFTokenModify(tx) {
+    assert.ok(tx.TransactionType === "NFTokenModify");
+    return (0, common_1.removeUndefined)({
+        signers: (0, signers_1.parseSigners)(tx),
+        signer: (0, regular_key_1.parseSignerRegularKey)(tx),
+        source: (0, source_1.parseSource)(tx),
+        nftokenID: tx.NFTokenID,
+        owner: tx.Owner,
+        uri: tx.URI,
+        emittedDetails: (0, emit_details_1.parseEmittedDetails)(tx),
+        memos: (0, memos_1.parseMemos)(tx),
+    });
+}
+exports.default = parseNFTokenModify;

package/lib/parse/transaction.d.ts

@@ -11,7 +11,7 @@ import { FormattedPaymentSpecification } from "../types/payments";
 import { FormattedPaymentChannelClaimSpecification, FormattedPaymentChannelCreateSpecification, FormattedPaymentChannelFundSpecification } from "../types/payment_channels";
 import { FormattedTicketCreateSpecification } from "../types/tickets";
 import { FormattedTrustlineSpecification } from "../types/trustlines";
-import { FormattedNFTokenBurnSpecification, FormattedNFTokenMintSpecification, FormattedNFTokenCancelOfferSpecification, FormattedNFTokenCreateOfferSpecification, FormattedNFTokenAcceptOfferSpecification } from "../types/nftokens";
+import { FormattedNFTokenBurnSpecification, FormattedNFTokenMintSpecification, FormattedNFTokenModifySpecification, FormattedNFTokenCancelOfferSpecification, FormattedNFTokenCreateOfferSpecification, FormattedNFTokenAcceptOfferSpecification } from "../types/nftokens";
 import { FormattedURITokenBurnSpecification, FormattedURITokenBuySpecification, FormattedURITokenCreateSellOfferSpecification, FormattedURITokenCancelSellOfferSpecification, FormattedURITokenMintSpecification } from "../types/uritokens";
 import { FormattedImportSpecification } from "../types/import";
 import { FormattedInvokeSpecification } from "../types/invoke";
@@ -26,7 +26,7 @@ import { FormattedGenesisMintSpecification } from "../types/genesis_mint";
 import { FormattedAmendmentSpecification } from "../types/amendments";
 import { FormattedFeeUpdateSpecification } from "../types/fees";
 declare function parseTransactionType(type: string): string;
-export type FormattedSpecification = FormattedUnrecognizedParserSpecification | FormattedSettingsSpecification | FormattedAccountDeleteSpecification | FormattedCheckCancelSpecification | FormattedCheckCashSpecification | FormattedCheckCreateSpecification | FormattedDepositPreauthSpecification | FormattedEscrowCancelSpecification | FormattedEscrowCreateSpecification | FormattedEscrowFinishSpecification | FormattedOfferCancelSpecification | FormattedOfferCreateSpecification | FormattedPaymentSpecification | FormattedPaymentChannelClaimSpecification | FormattedPaymentChannelCreateSpecification | FormattedPaymentChannelFundSpecification | FormattedTicketCreateSpecification | FormattedTrustlineSpecification | FormattedNFTokenBurnSpecification | FormattedNFTokenMintSpecification | FormattedNFTokenCancelOfferSpecification | FormattedNFTokenCreateOfferSpecification | FormattedNFTokenAcceptOfferSpecification | FormattedURITokenBurnSpecification | FormattedURITokenBuySpecification | FormattedURITokenCreateSellOfferSpecification | FormattedURITokenCancelSellOfferSpecification | FormattedURITokenMintSpecification | FormattedImportSpecification | FormattedInvokeSpecification | FormattedUNLReportSpecification | FormattedRemitsSpecification | FormattedClawbackSpecification | FormattedAmmBidSpecification | FormattedAmmCreateSpecification | FormattedAmmDeleteSpecification | FormattedAmmDepositSpecification | FormattedAmmWithdrawSpecification | FormattedAmmVoteSpecification | FormattedAmmClawbackSpecification | FormattedGenesisMintSpecification | FormattedAmendmentSpecification | FormattedFeeUpdateSpecification | FormattedDIDSetSpecification | FormattedDIDDeleteSpecification | FormattedOracleSetSpecification | FormattedOracleDeleteSpecification | FormattedMPTokenIssuanceCreateSpecification | FormattedMPTokenAuthorizeSpecification | FormattedMPTokenIssuanceSetSpecification | FormattedMPTokenIssuanceDestroySpecification;
+export type FormattedSpecification = FormattedUnrecognizedParserSpecification | FormattedSettingsSpecification | FormattedAccountDeleteSpecification | FormattedCheckCancelSpecification | FormattedCheckCashSpecification | FormattedCheckCreateSpecification | FormattedDepositPreauthSpecification | FormattedEscrowCancelSpecification | FormattedEscrowCreateSpecification | FormattedEscrowFinishSpecification | FormattedOfferCancelSpecification | FormattedOfferCreateSpecification | FormattedPaymentSpecification | FormattedPaymentChannelClaimSpecification | FormattedPaymentChannelCreateSpecification | FormattedPaymentChannelFundSpecification | FormattedTicketCreateSpecification | FormattedTrustlineSpecification | FormattedNFTokenBurnSpecification | FormattedNFTokenMintSpecification | FormattedNFTokenModifySpecification | FormattedNFTokenCancelOfferSpecification | FormattedNFTokenCreateOfferSpecification | FormattedNFTokenAcceptOfferSpecification | FormattedURITokenBurnSpecification | FormattedURITokenBuySpecification | FormattedURITokenCreateSellOfferSpecification | FormattedURITokenCancelSellOfferSpecification | FormattedURITokenMintSpecification | FormattedImportSpecification | FormattedInvokeSpecification | FormattedUNLReportSpecification | FormattedRemitsSpecification | FormattedClawbackSpecification | FormattedAmmBidSpecification | FormattedAmmCreateSpecification | FormattedAmmDeleteSpecification | FormattedAmmDepositSpecification | FormattedAmmWithdrawSpecification | FormattedAmmVoteSpecification | FormattedAmmClawbackSpecification | FormattedGenesisMintSpecification | FormattedAmendmentSpecification | FormattedFeeUpdateSpecification | FormattedDIDSetSpecification | FormattedDIDDeleteSpecification | FormattedOracleSetSpecification | FormattedOracleDeleteSpecification | FormattedMPTokenIssuanceCreateSpecification | FormattedMPTokenAuthorizeSpecification | FormattedMPTokenIssuanceSetSpecification | FormattedMPTokenIssuanceDestroySpecification;
 export interface FormattedTransaction {
     type: string;
     address: string;

package/lib/parse/transaction.js

@@ -28,6 +28,7 @@ const ticket_create_1 = __importDefault(require("./specification/ticket-create")
 const trustline_1 = __importDefault(require("./specification/trustline"));
 const nftoken_burn_1 = __importDefault(require("./specification/nftoken-burn"));
 const nftoken_mint_1 = __importDefault(require("./specification/nftoken-mint"));
+const nftoken_modify_1 = __importDefault(require("./specification/nftoken-modify"));
 const nftoken_cancel_offer_1 = __importDefault(require("./specification/nftoken-cancel-offer"));
 const nftoken_create_offer_1 = __importDefault(require("./specification/nftoken-create-offer"));
 const nftoken_accept_offer_1 = __importDefault(require("./specification/nftoken-accept-offer"));
@@ -81,6 +82,7 @@ const transactionTypeToType = {
     TrustSet: "trustline",
     NFTokenBurn: "nftokenBurn",
     NFTokenMint: "nftokenMint",
+    NFTokenModify: "NFTokenModify",
     NFTokenCancelOffer: "nftokenCancelOffer",
     NFTokenCreateOffer: "nftokenCreateOffer",
     NFTokenAcceptOffer: "nftokenAcceptOffer",
@@ -136,6 +138,7 @@ const parserTypeFunc = {
     trustline: trustline_1.default,
     nftokenBurn: nftoken_burn_1.default,
     nftokenMint: nftoken_mint_1.default,
+    NFTokenModify: nftoken_modify_1.default,
     nftokenCancelOffer: nftoken_cancel_offer_1.default,
     nftokenCreateOffer: nftoken_create_offer_1.default,
     nftokenAcceptOffer: nftoken_accept_offer_1.default,

package/lib/types/nftokens.d.ts

@@ -36,6 +36,11 @@ export type FormattedNFTokenMintSpecification = {
     destination?: FormattedDestinationAddress;
     expiration?: number;
 } & FormattedBaseSpecification;
+export type FormattedNFTokenModifySpecification = {
+    nftokenID: string;
+    owner?: string;
+    uri?: string;
+} & FormattedBaseSpecification;
 export type FormattedNFTokenCancelOfferSpecification = {
     nftokenOffers: string[];
 } & FormattedBaseSpecification;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bithomp/xrpl-api",
-  "version": "3.2.19",
+  "version": "3.2.21",
   "description": "A Bithomp JavaScript/TypeScript library for interacting with the XRP Ledger",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -69,8 +69,8 @@
     "@types/mocha": "^10.0.10",
     "@types/nconf": "^0.10.7",
     "@types/node": "^22.14.1",
-    "@typescript-eslint/eslint-plugin": "^8.29.1",
-    "@typescript-eslint/parser": "^8.29.1",
+    "@typescript-eslint/eslint-plugin": "^8.30.1",
+    "@typescript-eslint/parser": "^8.30.1",
     "chai": "^4.5.0",
     "chai-as-promised": "^7.1.2",
     "eslint": "^9.24.0",