feat: add ledger entry types for NFTokens

packages/xrpl/src/models/common/index.ts

@@ -119,7 +119,7 @@ export interface NFTOffer {
 }
 
 /**
- * One NFToken that might be returned from either an {@link NFTInfoResponse}
+ * One NFToken that might be returned from a {@link NFTInfoResponse}
  *
  * @category Responses
  */

packages/xrpl/src/models/ledger/NFTokenOffer.ts

@@ -0,0 +1,16 @@
+import { Amount } from '../common'
+
+import BaseLedgerEntry from './BaseLedgerEntry'
+
+export interface NFTokenOffer extends BaseLedgerEntry {
+  LedgerEntryType: 'NFTokenOffer'
+  Amount: Amount
+  Destination?: string
+  Expiration: number
+  Flags: number
+  NFTokenOfferNode?: string
+  Owner: string
+  OwnerNode?: string
+  PreviousTxnID: string
+  PreviousTxnLgrSeq: number
+}

packages/xrpl/src/models/ledger/NFTokenPage.ts

@@ -0,0 +1,30 @@
+import { ModifiedNode, Node } from '../transactions/metadata'
+
+import BaseLedgerEntry from './BaseLedgerEntry'
+
+export interface NFToken {
+  Flags: number
+  Issuer: string
+  NFTokenID: string
+  NFTokenTaxon: number
+  URI?: string
+}
+
+export interface NFTokenWrapper {
+  NFToken: NFToken
+}
+
+export interface NFTokenPage extends BaseLedgerEntry {
+  LedgerEntryType: 'NFTokenPage'
+  NextPageMin?: string
+  NFTokens: NFTokenWrapper[]
+  PreviousPageMin?: string
+  PreviousTxnID?: string
+  PreviousTxnLgrSeq?: number
+}
+
+export function isNFTokenPage(
+  ledgerEntry: BaseLedgerEntry,
+): ledgerEntry is NFTokenPage {
+  return Object.prototype.hasOwnProperty.call(ledgerEntry, `NFTokens`)
+}

packages/xrpl/src/models/ledger/index.ts

@@ -12,6 +12,8 @@ import Ledger from './Ledger'
 import LedgerEntry from './LedgerEntry'
 import LedgerHashes from './LedgerHashes'
 import NegativeUNL from './NegativeUNL'
+import { NFTokenOffer } from './NFTokenOffer'
+import { NFToken, NFTokenPage } from './NFTokenPage'
 import Offer, { OfferFlags } from './Offer'
 import PayChannel from './PayChannel'
 import RippleState, { RippleStateFlags } from './RippleState'
@@ -32,6 +34,9 @@ export {
   LedgerEntry,
   LedgerHashes,
   NegativeUNL,
+  NFTokenOffer,
+  NFTokenPage,
+  NFToken,
   Offer,
   OfferFlags,
   PayChannel,

packages/xrpl/src/models/methods/nftInfo.ts

@@ -3,8 +3,7 @@ import { LedgerIndex, NFToken } from '../common'
 import { BaseRequest, BaseResponse } from './baseMethod'
 
 /**
- * The `nft_info` method retrieves information about NFToken
- * NFToken.
+ * The `nft_info` method retrieves information about a NFToken.
  *
  * @category Requests
  */

packages/xrpl/src/utils/getNFTokenID.ts

@@ -1,5 +1,6 @@
 import flatMap from 'lodash/flatMap'
 
+import { NFTokenWrapper } from '../models/ledger/NFTokenPage'
 import {
   CreatedNode,
   isCreatedNode,
@@ -8,13 +9,6 @@ import {
   TransactionMetadata,
 } from '../models/transactions/metadata'
 
-interface NFToken {
-  NFToken: {
-    NFTokenID: string
-    URI: string
-  }
-}
-
 /**
  * Gets the NFTokenID for an NFT recently minted with NFTokenMint.
  *
@@ -62,7 +56,7 @@ export default function getNFTokenID(
   const previousTokenIDSet = new Set(
     flatMap(affectedNodes, (node) => {
       const nftokens = isModifiedNode(node)
-        ? (node.ModifiedNode.PreviousFields?.NFTokens as NFToken[])
+        ? (node.ModifiedNode.PreviousFields?.NFTokens as NFTokenWrapper[])
         : []
       return nftokens.map((token) => token.NFToken.NFTokenID)
     }).filter((id) => Boolean(id)),
@@ -72,8 +66,8 @@ export default function getNFTokenID(
   const finalTokenIDs = flatMap(affectedNodes, (node) =>
     (
       (((node as ModifiedNode).ModifiedNode?.FinalFields?.NFTokens ??
-        (node as CreatedNode).CreatedNode?.NewFields?.NFTokens) as NFToken[]) ??
-      []
+        (node as CreatedNode).CreatedNode?.NewFields
+          ?.NFTokens) as NFTokenWrapper[]) ?? []
     ).map((token) => token.NFToken.NFTokenID),
   ).filter((nftokenID) => Boolean(nftokenID))
   /* eslint-enable @typescript-eslint/consistent-type-assertions -- Necessary for parsing metadata */