xrpl 1.0.0-mpt-beta

package/src/models/ledger/index.ts

@@ -0,0 +1,70 @@
+import AccountRoot, {
+  AccountRootFlags,
+  AccountRootFlagsInterface,
+} from './AccountRoot'
+import Amendments, { Majority, AMENDMENTS_ID } from './Amendments'
+import AMM, { VoteSlot } from './AMM'
+import Bridge from './Bridge'
+import Check from './Check'
+import DepositPreauth from './DepositPreauth'
+import DID from './DID'
+import DirectoryNode from './DirectoryNode'
+import Escrow from './Escrow'
+import FeeSettings, {
+  FeeSettingsPreAmendmentFields,
+  FeeSettingsPostAmendmentFields,
+  FEE_SETTINGS_ID,
+} from './FeeSettings'
+import Ledger from './Ledger'
+import { LedgerEntry, LedgerEntryFilter } from './LedgerEntry'
+import LedgerHashes from './LedgerHashes'
+import NegativeUNL, { NEGATIVE_UNL_ID } 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'
+import SignerList, { SignerListFlags } from './SignerList'
+import Ticket from './Ticket'
+import XChainOwnedClaimID from './XChainOwnedClaimID'
+import XChainOwnedCreateAccountClaimID from './XChainOwnedCreateAccountClaimID'
+
+export {
+  AccountRoot,
+  AccountRootFlags,
+  AccountRootFlagsInterface,
+  AMENDMENTS_ID,
+  Amendments,
+  AMM,
+  Bridge,
+  Check,
+  DepositPreauth,
+  DirectoryNode,
+  DID,
+  Escrow,
+  FEE_SETTINGS_ID,
+  FeeSettings,
+  FeeSettingsPreAmendmentFields,
+  FeeSettingsPostAmendmentFields,
+  Ledger,
+  LedgerEntryFilter,
+  LedgerEntry,
+  LedgerHashes,
+  Majority,
+  NEGATIVE_UNL_ID,
+  NegativeUNL,
+  NFTokenOffer,
+  NFTokenPage,
+  NFToken,
+  Offer,
+  OfferFlags,
+  PayChannel,
+  RippleState,
+  RippleStateFlags,
+  SignerList,
+  SignerListFlags,
+  Ticket,
+  XChainOwnedClaimID,
+  XChainOwnedCreateAccountClaimID,
+  VoteSlot,
+}

package/src/models/methods/accountChannels.ts

@@ -0,0 +1,93 @@
+import { BaseRequest, BaseResponse, LookupByLedgerRequest } from './baseMethod'
+
+export interface Channel {
+  account: string
+  amount: string
+  balance: string
+  channel_id: string
+  destination_account: string
+  settle_delay: number
+  public_key?: string
+  public_key_hex?: string
+  expiration?: number
+  cancel_after?: number
+  source_tab?: number
+  destination_tag?: number
+}
+
+/**
+ * The account_channels method returns information about an account's Payment
+ * Channels. This includes only channels where the specified account is the
+ * channel's source, not the destination. (A channel's "source" and "owner" are
+ * the same.) All information retrieved is relative to a particular version of
+ * the ledger. Returns an {@link AccountChannelsResponse}.
+ *
+ * @category Requests
+ */
+export interface AccountChannelsRequest
+  extends BaseRequest,
+    LookupByLedgerRequest {
+  command: 'account_channels'
+  /**
+   * The unique identifier of an account, typically the account's address. The
+   * request returns channels where this account is the channel's owner/source.
+   *
+   */
+  account: string
+  /**
+   * The unique identifier of an account, typically the account's address. If
+   * provided, filter results to payment channels whose destination is this
+   * account.
+   */
+  destination_account?: string
+  /**
+   * Limit the number of transactions to retrieve. Cannot be less than 10 or
+   * more than 400. The default is 200.
+   */
+  limit?: number
+  /**
+   * Value from a previous paginated response. Resume retrieving data where
+   * that response left off.
+   */
+  marker?: unknown
+}
+
+/**
+ * The expected response from an {@link AccountChannelsRequest}.
+ *
+ * @category Responses
+ */
+export interface AccountChannelsResponse extends BaseResponse {
+  result: {
+    /**
+     * The address of the source/owner of the payment channels. This
+     * corresponds to the account field of the request.
+     */
+    account: string
+    /** Payment channels owned by this account. */
+    channels: Channel[]
+    /**
+     * The identifying hash of the ledger version used to generate this
+     * response.
+     */
+    ledger_hash: string
+    /** The ledger index of the ledger version used to generate this response. */
+    ledger_index: number
+    /**
+     * If true, the information in this response comes from a validated ledger
+     * version. Otherwise, the information is subject to change.
+     */
+    validated?: boolean
+    /**
+     * The limit to how many channel objects were actually returned by this
+     * request.
+     */
+    limit?: number
+    /**
+     * Server-defined value for pagination. Pass this to the next call to
+     * resume getting results where this call left off. Omitted when there are
+     * no additional pages after this one.
+     */
+    marker?: unknown
+  }
+}

package/src/models/methods/accountCurrencies.ts

@@ -0,0 +1,45 @@
+import { BaseRequest, BaseResponse, LookupByLedgerRequest } from './baseMethod'
+
+/**
+ * The `account_currencies` command retrieves a list of currencies that an
+ * account can send or receive, based on its trust lines. Expects an
+ * {@link AccountCurrenciesResponse}.
+ *
+ * @category Requests
+ */
+export interface AccountCurrenciesRequest
+  extends BaseRequest,
+    LookupByLedgerRequest {
+  command: 'account_currencies'
+  /** A unique identifier for the account, most commonly the account's address. */
+  account: string
+  /**
+   * If true, then the account field only accepts a public key or XRP Ledger
+   * address. Otherwise, account can be a secret or passphrase (not
+   * recommended). The default is false.
+   */
+  strict?: boolean
+}
+
+/**
+ * The expected response from an {@link AccountCurrenciesRequest}.
+ *
+ * @category Responses
+ */
+export interface AccountCurrenciesResponse extends BaseResponse {
+  result: {
+    /**
+     * The identifying hash of the ledger version used to retrieve this data,
+     * as hex.
+     */
+    ledger_hash?: string
+    /** The ledger index of the ledger version used to retrieve this data. */
+    ledger_index: number
+    /** Array of Currency Codes for currencies that this account can receive. */
+    receive_currencies: string[]
+    /** Array of Currency Codes for currencies that this account can send. */
+    send_currencies: string[]
+    /** If true, this data comes from a validated ledger. */
+    validated: boolean
+  }
+}

package/src/models/methods/accountInfo.ts

@@ -0,0 +1,182 @@
+import { AccountRoot, SignerList } from '../ledger'
+
+import { BaseRequest, BaseResponse, LookupByLedgerRequest } from './baseMethod'
+
+/**
+ * The `account_info` command retrieves information about an account, its
+ * activity, and its XRP balance. All information retrieved is relative to a
+ * particular version of the ledger. Returns an {@link AccountInfoResponse}.
+ *
+ * @category Requests
+ */
+export interface AccountInfoRequest extends BaseRequest, LookupByLedgerRequest {
+  command: 'account_info'
+  /** A unique identifier for the account, most commonly the account's address. */
+  account: string
+  /**
+   * Whether to get info about this account's queued transactions. Can only be
+   * used when querying for the data from the current open ledger. Not available
+   * from servers in Reporting Mode.
+   */
+  queue?: boolean
+  /**
+   * Request SignerList objects associated with this account.
+   */
+  signer_lists?: boolean
+  /**
+   * If true, then the account field only accepts a public key or XRP Ledger
+   * address. Otherwise, account can be a secret or passphrase (not
+   * recommended). The default is false.
+   */
+  strict?: boolean
+}
+
+export interface AccountQueueTransaction {
+  /**
+   * Whether this transaction changes this address's ways of authorizing
+   * transactions.
+   */
+  auth_change: boolean
+  /** The Transaction Cost of this transaction, in drops of XRP. */
+  fee: string
+  /**
+   * The transaction cost of this transaction, relative to the minimum cost for
+   * this type of transaction, in fee levels.
+   */
+  fee_level: string
+  /** The maximum amount of XRP, in drops, this transaction could send or destroy. */
+  max_spend_drops: string
+  /** The Sequence Number of this transaction. */
+  seq: number
+}
+
+export interface AccountQueueData {
+  /** Number of queued transactions from this address. */
+  txn_count: number
+  /**
+   * Whether a transaction in the queue changes this address's ways of
+   * authorizing transactions. If true, this address can queue no further
+   * transactions until that transaction has been executed or dropped from the
+   * queue.
+   */
+  auth_change_queued?: boolean
+  /** The lowest Sequence Number among transactions queued by this address. */
+  lowest_sequence?: number
+  /** The highest Sequence Number among transactions queued by this address. */
+  highest_sequence?: number
+  /**
+   * Integer amount of drops of XRP that could be debited from this address if
+   * every transaction in the queue consumes the maximum amount of XRP possible.
+   */
+  max_spend_drops_total?: string
+  /** Information about each queued transaction from this address. */
+  transactions?: AccountQueueTransaction[]
+}
+
+export interface AccountInfoAccountFlags {
+  /**
+   * Enable rippling on this address's trust lines by default. Required for issuing addresses; discouraged for others.
+   */
+  defaultRipple: boolean
+  /**
+   * This account can only receive funds from transactions it sends, and from preauthorized accounts.
+   * (It has DepositAuth enabled.)
+   */
+  depositAuth: boolean
+  /**
+   * Disallows use of the master key to sign transactions for this account.
+   */
+  disableMasterKey: boolean
+  /**
+   * Disallow incoming Checks from other accounts.
+   */
+  disallowIncomingCheck?: boolean
+  /**
+   * Disallow incoming NFTOffers from other accounts. Part of the DisallowIncoming amendment.
+   */
+  disallowIncomingNFTokenOffer?: boolean
+  /**
+   * Disallow incoming PayChannels from other accounts. Part of the DisallowIncoming amendment.
+   */
+  disallowIncomingPayChan?: boolean
+  /**
+   * Disallow incoming Trustlines from other accounts. Part of the DisallowIncoming amendment.
+   */
+  disallowIncomingTrustline?: boolean
+  /**
+   * Client applications should not send XRP to this account. Not enforced by rippled.
+   */
+  disallowIncomingXRP: boolean
+  /**
+   * All assets issued by this address are frozen.
+   */
+  globalFreeze: boolean
+  /**
+   * This address cannot freeze trust lines connected to it. Once enabled, cannot be disabled.
+   */
+  noFreeze: boolean
+  /**
+   * The account has used its free SetRegularKey transaction.
+   */
+  passwordSpent: boolean
+  /**
+   * This account must individually approve other users for those users to hold this account's issued currencies.
+   */
+  requireAuthorization: boolean
+  /**
+   * Requires incoming payments to specify a Destination Tag.
+   */
+  requireDestinationTag: boolean
+  /**
+   * This address can claw back issued IOUs. Once enabled, cannot be disabled.
+   */
+  allowTrustLineClawback: boolean
+}
+
+/**
+ * Response expected from an {@link AccountInfoRequest}.
+ *
+ * @category Responses
+ */
+export interface AccountInfoResponse extends BaseResponse {
+  result: {
+    /**
+     * The AccountRoot ledger object with this account's information, as stored
+     * in the ledger.
+     * If requested, also includes Array of SignerList ledger objects
+     * associated with this account for Multi-Signing. Since an account can own
+     * at most one SignerList, this array must have exactly one member if it is
+     * present.
+     */
+    account_data: AccountRoot & { signer_lists?: SignerList[] }
+
+    /**
+     * A map of account flags parsed out.  This will only be available for rippled nodes 1.11.0 and higher.
+     */
+    account_flags?: AccountInfoAccountFlags
+    /**
+     * The ledger index of the current in-progress ledger, which was used when
+     * retrieving this information.
+     */
+    ledger_current_index?: number
+    /**
+     * The ledger index of the ledger version used when retrieving this
+     * information. The information does not contain any changes from ledger
+     * versions newer than this one.
+     */
+    ledger_index?: number
+    /**
+     * Information about queued transactions sent by this account. This
+     * information describes the state of the local rippled server, which may be
+     * different from other servers in the peer-to-peer XRP Ledger network. Some
+     * fields may be omitted because the values are calculated "lazily" by the
+     * queuing mechanism.
+     */
+    queue_data?: AccountQueueData
+    /**
+     * True if this data is from a validated ledger version; if omitted or set
+     * to false, this data is not final.
+     */
+    validated?: boolean
+  }
+}

package/src/models/methods/accountLines.ts

@@ -0,0 +1,137 @@
+import { BaseRequest, BaseResponse, LookupByLedgerRequest } from './baseMethod'
+
+export interface AccountLinesTrustline {
+  /** The unique Address of the counterparty to this trust line. */
+  account: string
+  /**
+   * Representation of the numeric balance currently held against this line. A
+   * positive balance means that the perspective account holds value; a negative
+   * Balance means that the perspective account owes value.
+   */
+  balance: string
+  /** A Currency Code identifying what currency this trust line can hold. */
+  currency: string
+  /**
+   * The maximum amount of the given currency that this account is willing to
+   * owe the peer account.
+   */
+  limit: string
+  /**
+   * The maximum amount of currency that the issuer account is willing to owe
+   * the perspective account.
+   */
+  limit_peer: string
+  /**
+   * Rate at which the account values incoming balances on this trust line, as
+   * a ratio of this value per 1 billion units. (For example, a value of 500
+   * million represents a 0.5:1 ratio.) As a special case, 0 is treated as a
+   * 1:1 ratio.
+   */
+  quality_in: number
+  /**
+   * Rate at which the account values outgoing balances on this trust line, as
+   * a ratio of this value per 1 billion units. (For example, a value of 500
+   * million represents a 0.5:1 ratio.) As a special case, 0 is treated as a 1:1
+   * ratio.
+   */
+  quality_out: number
+  /**
+   * If true, this account has enabled the No Ripple flag for this trust line.
+   * If present and false, this account has disabled the No Ripple flag, but,
+   * because the account also has the Default Ripple flag enabled, that is not
+   * considered the default state. If omitted, the account has the No Ripple
+   * flag disabled for this trust line and Default Ripple disabled.
+   */
+  no_ripple?: boolean
+  /**
+   * If true, the peer account has enabled the No Ripple flag for this trust
+   * line. If present and false, this account has disabled the No Ripple flag,
+   * but, because the account also has the Default Ripple flag enabled, that is
+   * not considered the default state. If omitted, the account has the No Ripple
+   * flag disabled for this trust line and Default Ripple disabled.
+   */
+  no_ripple_peer?: boolean
+  /** If true, this account has authorized this trust line. The default is false. */
+  authorized?: boolean
+  /** If true, the peer account has authorized this trust line. The default is false. */
+  peer_authorized?: boolean
+  /** If true, this account has frozen this trust line. The default is false. */
+  freeze?: boolean
+  /**
+   * If true, the peer account has frozen this trust line. The default is
+   * false.
+   */
+  freeze_peer?: boolean
+}
+
+/**
+ * The account_lines method returns information about an account's trust lines,
+ *  including balances in all non-XRP currencies and assets. All information
+ * retrieved is relative to a particular version of the ledger. Expects an
+ * {@link AccountLinesResponse}.
+ *
+ * @category Requests
+ */
+export interface AccountLinesRequest
+  extends BaseRequest,
+    LookupByLedgerRequest {
+  command: 'account_lines'
+  /** A unique identifier for the account, most commonly the account's Address. */
+  account: string
+  /**
+   * The Address of a second account. If provided, show only lines of trust
+   * connecting the two accounts.
+   */
+  peer?: string
+  /**
+   * Limit the number of trust lines to retrieve. The server is not required to
+   * honor this value. Must be within the inclusive range 10 to 400.
+   */
+  limit?: number
+  /**
+   * Value from a previous paginated response. Resume retrieving data where
+   * that response left off.
+   */
+  marker?: unknown
+}
+
+/**
+ * Response expected from an {@link AccountLinesRequest}.
+ *
+ * @category Responses
+ */
+export interface AccountLinesResponse extends BaseResponse {
+  result: {
+    /**
+     * Unique Address of the account this request corresponds to. This is the
+     * "perspective account" for purpose of the trust lines.
+     */
+    account: string
+    /**
+     * Array of trust line objects. If the number of trust lines is large, only
+     * returns up to the limit at a time.
+     */
+    lines: AccountLinesTrustline[]
+    /**
+     * The ledger index of the current open ledger, which was used when
+     * retrieving this information.
+     */
+    ledger_current_index?: number
+    /**
+     * The ledger index of the ledger version that was used when retrieving
+     * this data.
+     */
+    ledger_index?: number
+    /**
+     * The identifying hash the ledger version that was used when retrieving
+     * this data.
+     */
+    ledger_hash?: string
+    /**
+     * Server-defined value indicating the response is paginated. Pass this to
+     * the next call to resume where this call left off. Omitted when there are
+     * No additional pages after this one.
+     */
+    marker?: unknown
+  }
+}

package/src/models/methods/accountNFTs.ts

@@ -0,0 +1,72 @@
+import { BaseRequest, BaseResponse, LookupByLedgerRequest } from './baseMethod'
+
+/**
+ * The `account_nfts` method retrieves all of the NFTs currently owned by the
+ * specified account.
+ *
+ * @category Requests
+ */
+export interface AccountNFTsRequest extends BaseRequest, LookupByLedgerRequest {
+  command: 'account_nfts'
+  /**
+   * The unique identifier of an account, typically the account's address. The
+   * request returns NFTs owned by this account.
+   */
+  account: string
+  /**
+   * Limit the number of NFTokens to retrieve.
+   */
+  limit?: number
+  /**
+   * Value from a previous paginated response. Resume retrieving data where
+   * that response left off.
+   */
+  marker?: unknown
+}
+
+/**
+ * One NFToken that might be returned from an {@link AccountNFTsRequest}.
+ *
+ * @category Responses
+ */
+export interface AccountNFToken {
+  Flags: number
+  Issuer: string
+  NFTokenID: string
+  NFTokenTaxon: number
+  URI?: string
+  nft_serial: number
+}
+
+/**
+ * Response expected from an {@link AccountNFTsRequest}.
+ *
+ * @category Responses
+ */
+export interface AccountNFTsResponse extends BaseResponse {
+  result: {
+    /**
+     * The account requested.
+     */
+    account: string
+    /**
+     * A list of NFTs owned by the specified account.
+     */
+    account_nfts: AccountNFToken[]
+    /**
+     * The ledger index of the current open ledger, which was used when
+     * retrieving this information.
+     */
+    ledger_current_index: number
+    /** If true, this data comes from a validated ledger. */
+    validated: boolean
+    /**
+     * Server-defined value indicating the response is paginated. Pass this to
+     * the next call to resume where this call left off. Omitted when there are
+     * No additional pages after this one.
+     */
+    marker?: unknown
+    /** The limit that was used to fulfill this request. */
+    limit?: number
+  }
+}

package/src/models/methods/accountObjects.ts

@@ -0,0 +1,98 @@
+import { Amendments, FeeSettings, LedgerHashes } from '../ledger'
+import { LedgerEntry, LedgerEntryFilter } from '../ledger/LedgerEntry'
+
+import { BaseRequest, BaseResponse, LookupByLedgerRequest } from './baseMethod'
+
+export type AccountObjectType = Exclude<
+  LedgerEntryFilter,
+  'amendments' | 'fee' | 'hashes'
+>
+/**
+ * The account_objects command returns the raw ledger format for all objects
+ * owned by an account. For a higher-level view of an account's trust lines and
+ * balances, see the account_lines method instead. Expects a response in the
+ * form of an {@link AccountObjectsResponse}.
+ *
+ * @category Requests
+ */
+export interface AccountObjectsRequest
+  extends BaseRequest,
+    LookupByLedgerRequest {
+  command: 'account_objects'
+  /** A unique identifier for the account, most commonly the account's address. */
+  account: string
+  /**
+   * If included, filter results to include only this type of ledger object.
+   */
+  type?: AccountObjectType
+  /**
+   * If true, the response only includes objects that would block this account
+   * from being deleted. The default is false.
+   */
+  deletion_blockers_only?: boolean
+  /**
+   * The maximum number of objects to include in the results. Must be within
+   * the inclusive range 10 to 400 on non-admin connections. The default is 200.
+   */
+  limit?: number
+  /**
+   * Value from a previous paginated response. Resume retrieving data where
+   * that response left off.
+   */
+  marker?: unknown
+}
+
+/**
+ * Account Objects can be a Check, a DepositPreauth, an Escrow, an Offer, a
+ * PayChannel, a SignerList, a Ticket, or a RippleState.
+ */
+export type AccountObject = Exclude<
+  LedgerEntry,
+  Amendments | FeeSettings | LedgerHashes
+>
+
+/**
+ * Response expected from an {@link AccountObjectsRequest}.
+ *
+ * @category Responses
+ */
+export interface AccountObjectsResponse extends BaseResponse {
+  result: {
+    /** Unique Address of the account this request corresponds to. */
+    account: string
+    /**
+     * Array of objects owned by this account. Each object is in its raw
+     * ledger format.
+     */
+    account_objects: AccountObject[]
+    /**
+     * The identifying hash of the ledger that was used to generate this
+     * response.
+     */
+    ledger_hash?: string
+    /**
+     * The ledger index of the ledger version that was used to generate this
+     * response.
+     */
+    ledger_index?: number
+    /**
+     * The ledger index of the current in-progress ledger version, which was
+     * used to generate this response.
+     */
+    ledger_current_index?: number
+    /** The limit that was used in this request, if any. */
+    limit?: number
+    /**
+     * Server-defined value indicating the response is paginated. Pass this to
+     * the next call to resume where this call left off. Omitted when there are
+     * no additional pages after this one.
+     */
+    marker?: string
+    /**
+     * If included and set to true, the information in this response comes from
+     * a validated ledger version. Otherwise, the information is subject to
+     * change.
+     */
+    validated?: boolean
+  }
+}