From 1ae928ef541da15c6229b002bad32a337b1917ae Mon Sep 17 00:00:00 2001 From: mDuo13 Date: Wed, 14 Jun 2017 20:01:39 -0700 Subject: [PATCH] rippled v0.70.0 changes: amendments, queue_data Adds 3 new amendments (EnforceInvariants, fix1373, FlowCross) to the Known Amendments table with descriptions for each. (DOC-963) Adds the new queue parameter to the ledger command (DOC-801) and reformats some of the surrounding text. Updates the path specifications page to clarify some rules that relate to the FlowCross amendment. The link to the rippled 0.70.0 release tag is expected to fail until that version is released. --- concept-amendments.html | 81 +++++++++++++++++++++++++ concept-partial-payments.html | 1 + concept-paths.html | 43 ++++++++------ content/concept-amendments.md | 46 +++++++++++++++ content/concept-paths.md | 24 +++++--- content/reference-rippled.md | 35 ++++++++--- content/snippets/rippled_versions.md | 1 + reference-rippled.html | 88 +++++++++++++++++++++++++--- tutorial-listing-xrp.html | 1 + 9 files changed, 278 insertions(+), 42 deletions(-) diff --git a/concept-amendments.html b/concept-amendments.html index d9591cd47a..0fd24c21fc 100644 --- a/concept-amendments.html +++ b/concept-amendments.html @@ -155,10 +155,13 @@
  • Testing Amendments
  • Known Amendments
  • CryptoConditions
    • +
  • EnforceInvariants
  • Escrow
  • FeeEscalation
  • fix1368
    • +
  • fix1373
  • Flow
    • +
  • FlowCross
  • FlowV2
  • MultiSign
  • OwnerPaysFee
    • @@ -253,6 +256,21 @@ TrustSetAuth +FlowCross +v0.70.0 +Planned: TBD + + +EnforceInvariants +v0.70.0 +Expected: 2017-06-29 + + +fix1373 +v0.70.0 +Expected: 2017-06-29 + + SHAMapV2 v0.33.0 Planned: TBD @@ -341,6 +359,31 @@ TrustSetAuth

    Although this amendment is enabled, it has no effect unless the SusPay amendment is also enabled. Ripple does not expect SusPay to become enabled. Instead, Ripple plans to incorporate crypto-conditions in the Escrow amendment.

    +

    EnforceInvariants

    + + + + + + + + + + + + + +
    Amendment IDStatus
    DC9CA96AEA1DCF83E527D1AFC916EFAF5D27388ECA4060A88817C1238CAEE0BFIn voting; expected 2017-06-29
    +

    Adds sanity checks to transaction processing to ensure that certain conditions are always met. This provides an extra layer of protection against bugs in transaction processing that could otherwise cause exploits and vulnerabilities in the Ripple Consensus Ledger. Ripple expects to add more invariant checks in future versions of rippled without additional amendments.

    +

    Introduces two new transaction error codes, tecINVARIANT_FAILED and tefINVARIANT_FAILED. Changes transaction processing to add the new checks. Adds a configuration option to disable invariant-checking.

    +

    Examples of invariant checks:

    +

    Escrow

    @@ -398,6 +441,23 @@ TrustSetAuth

    Fixes a minor bug in transaction processing that causes some payments to fail when they should be valid. Specifically, during payment processing, some payment steps that are expected to produce a certain amount of currency may produce a microscopically different amount, due to a loss of precision related to floating-point number representation. When this occurs, those payments fail because they cannot deliver the exact amount intended. The fix1368 amendment corrects transaction processing so payments can no longer fail in this manner.

    +

    fix1373

    + + + + + + + + + + + + + +
    Amendment IDStatus
    42EEA5E28A97824821D4EF97081FE36A54E9593C6E4F20CBAE098C69D2E072DCIn voting; expected 2017-06-29
    +

    Fixes a minor bug in transaction processing that causes failures when trying to prepare certain payment paths for processing. As a result, payments could not use certain paths that should have been valid but were invalidly prepared. Without this amendment, those payments are forced to use less-preferable paths or may even fail.

    +

    The fix1373 amendment corrects the issue so that the paths are properly prepared and payments can use them. It also disables some inappropriate paths that are currently allowed, including paths whose steps include conflicting fields and paths that loop through the same object more than once.

    Flow

    @@ -415,6 +475,27 @@ TrustSetAuth

    Replaces the payment processing engine with a more robust and efficient rewrite called the Flow engine. The new version of the payment processing engine is intended to follow the same rules as the old one, but occasionally produces different results due to floating point rounding. This Amendment supersedes the FlowV2 amendment.

    The Flow Engine also makes it easier to improve and expand the payment engine with further Amendments.

    +

    FlowCross

    + + + + + + + + + + + + + +
    Amendment IDStatus
    3012E8230864E95A58C60FD61430D7E1B4D3353195F2981DC12B0C7C0950FFACReleased but not enabled
    +

    Streamlines the offer crossing logic in the RCL's decentralized exchange. Uses the updated code from the Flow amendment to power offer crossing, so OfferCreate transactions and Payment transactions share more code. This has subtle differences in how offers are processed:

    +

    FlowV2

    diff --git a/concept-partial-payments.html b/concept-partial-payments.html index 2f4f54775d..9641726d9d 100644 --- a/concept-partial-payments.html +++ b/concept-partial-payments.html @@ -79,6 +79,7 @@
  • RippleAPI Beginners Guide
  • rippled Setup
  • Gateway Guide
    • +
  • Listing XRP as an Exchange
  • diff --git a/concept-paths.html b/concept-paths.html index 159c1e1285..ab94d5f19f 100644 --- a/concept-paths.html +++ b/concept-paths.html @@ -209,39 +209,46 @@
    • - - - + + + - - - + + + - - - + + + - - - + + + - - - + + + - - - + + +
    FieldValueDescriptionFieldValueDescription
    accountString - Address(Optional) If present, this path step represents rippling through the specified address.accountString - Address(Optional) If present, this path step represents rippling through the specified address. MUST NOT be provided if this step specifies the currency or issuer fields.
    currencyString - currency code(Optional) If present, this path step represents changing currencies through an order book. The currency specified indicates the new currency.currencyString - Currency Code(Optional) If present, this path step represents changing currencies through an order book. The currency specified indicates the new currency. MUST NOT be provided if this step specifies the account field.
    issuerString - Address(Optional) If the path step represents changing currencies through an order book, this field indicates the issuer of the new currency. This field is not present when changing to XRP.issuerString - Address(Optional) If the path step represents changing currencies through an order book, this field indicates the issuer of the new currency. If omitted in a step with a non-XRP currency, the previous step of the path defines the issuer. MUST be omitted if the currency is XRP. MUST NOT be provided if this step specifies the account field.
    typeIntegerDEPRECATED (Optional) An indicator of which other fields are present.typeIntegerDEPRECATED (Optional) An indicator of which other fields are present.
    type_hexStringDEPRECATED: (Optional) A hexadecimal representation of the type field.type_hexStringDEPRECATED: (Optional) A hexadecimal representation of the type field.
    +

    In summary, the following combination of fields are valid, optionally with type, type_hex, or both:

    + +

    Any other use of account, currency, and issuer fields in a path step is invalid.

    The type field, used for the binary serialization of a path set, is actually constructed through bitwise operations on a single integer. The bits are defined as follows:

    diff --git a/content/concept-amendments.md b/content/concept-amendments.md index c8ff94964a..42c44cb159 100644 --- a/content/concept-amendments.md +++ b/content/concept-amendments.md @@ -113,6 +113,9 @@ The following is a comprehensive list of all known amendments and their status o | Name | Introduced | Status | |:--------------------------------------|:-----------|:------------------------| +| [FlowCross](#flowcross) | v0.70.0 | [Planned: TBD]( "BADGE_LIGHTGREY") | +| [EnforceInvariants](#enforceinvariants) | v0.70.0 | [Expected: 2017-06-29]( "BADGE_BLUE") | +| [fix1373](#fix1373) | v0.70.0 | [Expected: 2017-06-29]( "BADGE_BLUE") | | [SHAMapV2](#shamapv2) | v0.33.0 | [Planned: TBD]( "BADGE_LIGHTGREY") | | [OwnerPaysFee](#ownerpaysfee) | v0.33.0 | [Planned: TBD]( "BADGE_LIGHTGREY") | | [Tickets](#tickets) | N/A | [Planned: TBD]( "BADGE_LIGHTGREY") | @@ -139,6 +142,25 @@ The following is a comprehensive list of all known amendments and their status o Although this amendment is enabled, it has no effect unless the [SusPay](#suspay) amendment is also enabled. Ripple does not expect SusPay to become enabled. Instead, Ripple plans to incorporate crypto-conditions in the [Escrow](#escrow) amendment. +## EnforceInvariants + +| Amendment ID | Status | +|:-----------------------------------------------------------------|:--------| +| DC9CA96AEA1DCF83E527D1AFC916EFAF5D27388ECA4060A88817C1238CAEE0BF | In voting; expected 2017-06-29 | + +Adds sanity checks to transaction processing to ensure that certain conditions are always met. This provides an extra layer of protection against bugs in transaction processing that could otherwise cause exploits and vulnerabilities in the Ripple Consensus Ledger. Ripple expects to add more invariant checks in future versions of `rippled` without additional amendments. + +Introduces two new transaction error codes, `tecINVARIANT_FAILED` and `tefINVARIANT_FAILED`. Changes transaction processing to add the new checks. Adds a configuration option to disable invariant-checking. + +Examples of invariant checks: + +- The total amount of XRP destroyed by a transaction must match the [transaction cost](concept-transaction-cost.html) exactly. +- XRP cannot be created. +- [`AccountRoot` objects in the ledger](reference-ledger-format.html#accountroot) cannot be deleted. (See also: [Permanence of Accounts](concept-accounts.html#permanence-of-accounts).) +- [An object in the ledger](reference-ledger-format.html#ledger-node-types) cannot change its type. (The `LedgerEntryType` field is immutable.) +- There cannot be a trust line for XRP. + + ## Escrow | Amendment ID | Status | @@ -177,6 +199,17 @@ A transaction remains in the queue until one of the following happens: Fixes a minor bug in transaction processing that causes some payments to fail when they should be valid. Specifically, during payment processing, some payment steps that are expected to produce a certain amount of currency may produce a microscopically different amount, due to a loss of precision related to floating-point number representation. When this occurs, those payments fail because they cannot deliver the exact amount intended. The fix1368 amendment corrects transaction processing so payments can no longer fail in this manner. +## fix1373 + +| Amendment ID | Status | +|:-----------------------------------------------------------------|:----------| +| 42EEA5E28A97824821D4EF97081FE36A54E9593C6E4F20CBAE098C69D2E072DC | In voting; expected 2017-06-29 | + +Fixes a minor bug in transaction processing that causes failures when trying to prepare certain [payment paths](concept-paths.html) for processing. As a result, payments could not use certain paths that should have been valid but were invalidly prepared. Without this amendment, those payments are forced to use less-preferable paths or may even fail. + +The fix1373 amendment corrects the issue so that the paths are properly prepared and payments can use them. It also disables some inappropriate paths that are currently allowed, including paths whose [steps](concept-paths.html#path-specifications) include conflicting fields and paths that loop through the same object more than once. + + ## Flow | Amendment ID | Status | @@ -188,6 +221,19 @@ Replaces the payment processing engine with a more robust and efficient rewrite The Flow Engine also makes it easier to improve and expand the payment engine with further Amendments. +## FlowCross + +| Amendment ID | Status | +|:-----------------------------------------------------------------|:----------| +| 3012E8230864E95A58C60FD61430D7E1B4D3353195F2981DC12B0C7C0950FFAC | Released but not enabled | + +Streamlines the offer crossing logic in the RCL's decentralized exchange. Uses the updated code from the [Flow](#flow) amendment to power offer crossing, so [OfferCreate transactions][] and [Payment transactions][] share more code. This has subtle differences in how offers are processed: + +- Rounding is slightly different in some cases. +- Due to differences in rounding, some combinations of offers may be ranked higher or lower than by the old logic, and taken preferentially. +- The new logic may delete more or fewer offers than the old logic. (This includes cases caused by differences in rounding and offers that were incorrectly removed as unfunded by the old logic.) + + ## FlowV2 | Amendment ID | Status | diff --git a/content/concept-paths.md b/content/concept-paths.md index fd6b6a2f9f..0480382bc5 100644 --- a/content/concept-paths.md +++ b/content/concept-paths.md @@ -68,13 +68,23 @@ You can use the [`tfNoDirectRipple` flag](reference-transaction-format.html#paym A path set is an array. Each member of the path set is another array that represents an individual _path_. Each member of a path is an object that specifies the step. A step has the following fields: -| Field | Value | Description | -|-------|-------|-------------| -| account | String - Address | (Optional) If present, this path step represents rippling through the specified address. | -| currency | String - currency code | (Optional) If present, this path step represents changing currencies through an order book. The currency specified indicates the new currency. | -| issuer | String - Address | (Optional) If the path step represents changing currencies through an order book, this field indicates the issuer of the new currency. This field is not present when changing to XRP. | -| type | Integer | **DEPRECATED** (Optional) An indicator of which other fields are present. | -| type_hex | String | **DEPRECATED**: (Optional) A hexadecimal representation of the `type` field. | +| Field | Value | Description | +|:-----------|:-----------------------|:---------------------------------------| +| `account` | String - Address | _(Optional)_ If present, this path step represents rippling through the specified address. MUST NOT be provided if this step specifies the `currency` or `issuer` fields. | +| `currency` | String - Currency Code | _(Optional)_ If present, this path step represents changing currencies through an order book. The currency specified indicates the new currency. MUST NOT be provided if this step specifies the `account` field. | +| `issuer` | String - Address | _(Optional)_ If the path step represents changing currencies through an order book, this field indicates the issuer of the new currency. If omitted in a step with a non-XRP `currency`, the previous step of the path defines the issuer. MUST be omitted if the `currency` is XRP. MUST NOT be provided if this step specifies the `account` field. | +| `type` | Integer | **DEPRECATED** _(Optional)_ An indicator of which other fields are present. | +| `type_hex` | String | **DEPRECATED**: _(Optional)_ A hexadecimal representation of the `type` field. | + +In summary, the following combination of fields are valid, optionally with `type`, `type_hex`, or both: + +- `account` by itself +- `currency` by itself +- `currency` and `issuer` as long as the `currency` is not XRP + +Any other use of `account`, `currency`, and `issuer` fields in a path step is invalid. + + The `type` field, used for the binary serialization of a path set, is actually constructed through bitwise operations on a single integer. The bits are defined as follows: diff --git a/content/reference-rippled.md b/content/reference-rippled.md index 81c524282a..c292813b1b 100755 --- a/content/reference-rippled.md +++ b/content/reference-rippled.md @@ -3314,7 +3314,7 @@ The key generated by this method can also be used as a regular key for an accoun The globally-shared ledger is the core of the Ripple Network. Each `rippled` server keeps a current version of the ledger, which contains all the accounts, transactions, offers, and other data in the network in an optimized tree format. As transactions and offers are proposed, each server incorporates them into its current copy of the ledger, closes it periodically, and (if configured) participates in advancing the globally-validated version. After the network reaches consensus, that ledger version is validated and becomes permanently immutable. Any transactions that were not included in one ledger become candidates to be included in the next validated version. -## ledger ## +## ledger [[Source]
    ](https://github.com/ripple/rippled/blob/master/src/ripple/rpc/handlers/LedgerHandler.cpp "Source") Retrieve information about the public ledger. @@ -3376,12 +3376,13 @@ The request can contain the following parameters: |:---------------|:---------------------------|:-------------------------------| | `ledger_hash` | String | _(Optional)_ A 20-byte hex string for the ledger version to use. (See [Specifying a Ledger](#specifying-ledgers)). | | `ledger_index` | String or Unsigned Integer | _(Optional)_ The sequence number of the ledger to use, or a shortcut string to choose a ledger automatically. (See [Specifying a Ledger](#specifying-ledgers)) | -| `full` | Boolean | (Optional, defaults to false) **Admin required** If true, return full information on the entire ledger. Ignored if you did not specify a ledger. (Equivalent to enabling `transactions`, `accounts`, and `expand`.) **Caution:** This is a very large amount of data -- on the order of several hundred megabytes! | -| `accounts` | Boolean | (Optional, defaults to false) **Admin required.** If true, return information on accounts in the ledger. Ignored if you did not specify a ledger. **Caution:** This returns a very large amount of data! | -| `transactions` | Boolean | (Optional, defaults to false) If true, return information on transactions in the specified ledger version. Ignored if you did not specify a ledger. | -| `expand` | Boolean | (Optional, defaults to false) Provide full JSON-formatted information for transaction/account information instead of only hashes. Ignored unless you requested transactions, accounts, or both. | -| `owner_funds` | Boolean | (Optional, defaults to false) Include `owner_funds` field in the metadata of OfferCreate transactions in the response. Ignored unless transactions are included and `expand` is true. | -| `binary` | Boolean | (Optional, defaults to false) If `transactions` and `expand` are both true, and this option is also true, return transaction information in binary format instead of JSON format. [New in: rippled 0.28.0][] | +| `full` | Boolean | _(Optional)_ **Admin required** If `true`, return full information on the entire ledger. Ignored if you did not specify a ledger. Defaults to `false`. (Equivalent to enabling `transactions`, `accounts`, and `expand`.) **Caution:** This is a very large amount of data -- on the order of several hundred megabytes! | +| `accounts` | Boolean | _(Optional)_ **Admin required.** If `true`, return information on accounts in the ledger. Ignored if you did not specify a ledger. Defaults to `false`. **Caution:** This returns a very large amount of data! | +| `transactions` | Boolean | _(Optional)_ If `true`, return information on transactions in the specified ledger version. Defaults to `false`. Ignored if you did not specify a ledger. | +| `expand` | Boolean | _(Optional)_ Provide full JSON-formatted information for transaction/account information instead of only hashes. Defaults to `false`. Ignored unless you request transactions, accounts, or both. | +| `owner_funds` | Boolean | _(Optional)_ If `true`, include `owner_funds` field in the metadata of OfferCreate transactions in the response. Defaults to `false`. Ignored unless transactions are included and `expand` is true. | +| `binary` | Boolean | _(Optional)_ If `true`, and `transactions` and `expand` are both also `true`, return transaction information in binary format (hexadecimal string) instead of JSON format. [New in: rippled 0.28.0][] | +| `queue` | Boolean | _(Optional)_ If `true`, and the command is requesting the `current` ledger, includes an array of [queued transactions](concept-transaction-cost.html#queued-transactions) in the results. The `ledger` field is deprecated and may be removed without further notice. @@ -3474,13 +3475,29 @@ The response follows the [standard format](#response-formatting), with a success | `ledger.parent_hash` | String | Unique identifying hash of the ledger that came immediately before this one. | | `ledger.total_coins` | String | Total number of XRP drops in the network, as a quoted integer. (This decreases as transaction costs destroy XRP.) | | `ledger.transaction_hash` | String | Hash of the transaction information included in this ledger, as hex | -| `ledger.transactions` | Array | (Omitted unless requested) Transactions applied in this ledger version. By default, members are the transactions' identifying [Hash][] strings. If expanded, contains full representations of the transactions instead, in either JSON or binary depending on whether the request specified `binary` as true. | +| `ledger.transactions` | Array | (Omitted unless requested) Transactions applied in this ledger version. By default, members are the transactions' identifying [Hash][] strings. If the request specified `expand` as true, members are full representations of the transactions instead, in either JSON or binary depending on whether the request specified `binary` as true. | | `ledger_hash` | String | Unique identifying hash of the entire ledger. | | `ledger_index` | Number | The [Ledger Index][] of this ledger. | +| `queue_data` | Array | (Omitted unless requested with the `queue` parameter) Array of objects describing queued transactions, in the same order as the queue. If the request specified `expand` as true, members contain full representations of the transactions, in either JSON or binary depending on whether the request specified `binary` as true. Requires the [FeeEscalation amendment](concept-amendments.html#known-amendments). [New in: rippled 0.70.0][] | The following fields are deprecated and may be removed without further notice: `accepted`, `hash`, `seqNum`, `totalCoins`. -**Note on `owner_funds`:** If the request specified `"owner_funds": true` and expanded transactions, the response has a field `owner_funds` in the `metaData` object of each [OfferCreate-type transaction](reference-transaction-format.html#offercreate). The purpose of this field is to make it easier to track the [funding status of offers](reference-transaction-format.html#lifecycle-of-an-offer) with each new validated ledger. This field is defined slightly different than the version of this field in [Order Book subscription streams](#order-book-streams): +Each member of the `queue_data` array represents one transaction in the queue. Some fields of this object may be omitted because they have not yet been calculated. The fields of this object are as follows: + +| Field | Value | Description | +|:--------------------|:-----------------|:------------------------------------| +| `account` | String | The [Address][] of the sender for this queued transaction. | +| `tx` | String or Object | By default, this is a String containing the [identifying hash](#hashes) of the transaction. If transactions are expanded in binary format, this is an object whose only field is `tx_blob`, containing the binary form of the transaction as a decimal string. If transactions are expanded in JSON format, this is an object containing the [transaction object](reference-transaction-format.html) including the transaction's identifying hash in the `hash` field. | +| `retries_remaining` | Number | How many times this transaction can be retried before being dropped. | +| `preflight_result` | String | The tentative result from preliminary transaction checking. This is always `tesSUCCESS`. | +| `last_result` | String | _(May be omitted)_ If this transaction was put in the queue after getting a [retriable (`ter`) result](reference-transaction-format.html#result-categories), this is the exact `ter` result code it got. | +| `auth_change` | Boolean | _(May be omitted)_ Whether this transaction changes this address's [ways of authorizing transactions](reference-transaction-format.html#authorizing-transactions). | +| `fee` | String | _(May be omitted)_ The [Transaction Cost](concept-transaction-cost.html) of this transaction, in [drops of XRP](#specifying-currency-amounts). | +| `fee_level` | String | _(May be omitted)_ The transaction cost of this transaction, relative to the minimum cost for this type of transaction, in [fee levels][]. | +| `max_spend_drops` | String | _(May be omitted)_ The maximum amount of XRP, [in drops](#specifying-currency-amounts), this transaction could send or destroy. | +| `seq` | Integer | _(May be omitted)_ The [Sequence Number][] of this transaction. | + +If the request specified `"owner_funds": true` and expanded transactions, the response has a field `owner_funds` in the `metaData` object of each [OfferCreate-type transaction](reference-transaction-format.html#offercreate). The purpose of this field is to make it easier to track the [funding status of offers](reference-transaction-format.html#lifecycle-of-an-offer) with each new validated ledger. This field is defined slightly different than the version of this field in [Order Book subscription streams](#order-book-streams): | `Field` | Value | Description | |:--------------|:-------|:----------------------------------------------------| diff --git a/content/snippets/rippled_versions.md b/content/snippets/rippled_versions.md index 19488fa1b4..3fc1e6dc5f 100644 --- a/content/snippets/rippled_versions.md +++ b/content/snippets/rippled_versions.md @@ -26,3 +26,4 @@ [New in: rippled 0.32.1]: https://github.com/ripple/rippled/releases/tag/0.32.1 "BADGE_BLUE" [New in: rippled 0.33.0]: https://github.com/ripple/rippled/releases/tag/0.33.0 "BADGE_BLUE" [New in: rippled 0.50.0]: https://github.com/ripple/rippled/releases/tag/0.50.0 "BADGE_BLUE" +[New in: rippled 0.70.0]: https://github.com/ripple/rippled/releases/tag/0.70.0 "BADGE_BLUE" diff --git a/reference-rippled.html b/reference-rippled.html index 5d98df883e..00651bfa9c 100644 --- a/reference-rippled.html +++ b/reference-rippled.html @@ -4210,32 +4210,37 @@ rippled ledger current - + - + - + - + - + - + + + + + +
    full Boolean(Optional, defaults to false) Admin required If true, return full information on the entire ledger. Ignored if you did not specify a ledger. (Equivalent to enabling transactions, accounts, and expand.) Caution: This is a very large amount of data -- on the order of several hundred megabytes!(Optional) Admin required If true, return full information on the entire ledger. Ignored if you did not specify a ledger. Defaults to false. (Equivalent to enabling transactions, accounts, and expand.) Caution: This is a very large amount of data -- on the order of several hundred megabytes!
    accounts Boolean(Optional, defaults to false) Admin required. If true, return information on accounts in the ledger. Ignored if you did not specify a ledger. Caution: This returns a very large amount of data!(Optional) Admin required. If true, return information on accounts in the ledger. Ignored if you did not specify a ledger. Defaults to false. Caution: This returns a very large amount of data!
    transactions Boolean(Optional, defaults to false) If true, return information on transactions in the specified ledger version. Ignored if you did not specify a ledger.(Optional) If true, return information on transactions in the specified ledger version. Defaults to false. Ignored if you did not specify a ledger.
    expand Boolean(Optional, defaults to false) Provide full JSON-formatted information for transaction/account information instead of only hashes. Ignored unless you requested transactions, accounts, or both.(Optional) Provide full JSON-formatted information for transaction/account information instead of only hashes. Defaults to false. Ignored unless you request transactions, accounts, or both.
    owner_funds Boolean(Optional, defaults to false) Include owner_funds field in the metadata of OfferCreate transactions in the response. Ignored unless transactions are included and expand is true.(Optional) If true, include owner_funds field in the metadata of OfferCreate transactions in the response. Defaults to false. Ignored unless transactions are included and expand is true.
    binary Boolean(Optional, defaults to false) If transactions and expand are both true, and this option is also true, return transaction information in binary format instead of JSON format. New in: rippled 0.28.0(Optional) If true, and transactions and expand are both also true, return transaction information in binary format (hexadecimal string) instead of JSON format. New in: rippled 0.28.0
    queueBoolean(Optional) If true, and the command is requesting the current ledger, includes an array of queued transactions in the results.
    @@ -4376,7 +4381,7 @@ rippled ledger current ledger.transactions Array -(Omitted unless requested) Transactions applied in this ledger version. By default, members are the transactions' identifying Hash strings. If expanded, contains full representations of the transactions instead, in either JSON or binary depending on whether the request specified binary as true. +(Omitted unless requested) Transactions applied in this ledger version. By default, members are the transactions' identifying Hash strings. If the request specified expand as true, members are full representations of the transactions instead, in either JSON or binary depending on whether the request specified binary as true. ledger_hash @@ -4388,10 +4393,77 @@ rippled ledger current Number The Ledger Index of this ledger. + +queue_data +Array +(Omitted unless requested with the queue parameter) Array of objects describing queued transactions, in the same order as the queue. If the request specified expand as true, members contain full representations of the transactions, in either JSON or binary depending on whether the request specified binary as true. Requires the FeeEscalation amendment. New in: rippled 0.70.0 +

    The following fields are deprecated and may be removed without further notice: accepted, hash, seqNum, totalCoins.

    -

    Note on owner_funds: If the request specified "owner_funds": true and expanded transactions, the response has a field owner_funds in the metaData object of each OfferCreate-type transaction. The purpose of this field is to make it easier to track the funding status of offers with each new validated ledger. This field is defined slightly different than the version of this field in Order Book subscription streams:

    +

    Each member of the queue_data array represents one transaction in the queue. Some fields of this object may be omitted because they have not yet been calculated. The fields of this object are as follows:

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    FieldValueDescription
    accountStringThe Address of the sender for this queued transaction.
    txString or ObjectBy default, this is a String containing the identifying hash of the transaction. If transactions are expanded in binary format, this is an object whose only field is tx_blob, containing the binary form of the transaction as a decimal string. If transactions are expanded in JSON format, this is an object containing the transaction object including the transaction's identifying hash in the hash field.
    retries_remainingNumberHow many times this transaction can be retried before being dropped.
    preflight_resultStringThe tentative result from preliminary transaction checking. This is always tesSUCCESS.
    last_resultString(May be omitted) If this transaction was put in the queue after getting a retriable (ter) result, this is the exact ter result code it got.
    auth_changeBoolean(May be omitted) Whether this transaction changes this address's ways of authorizing transactions.
    feeString(May be omitted) The Transaction Cost of this transaction, in drops of XRP.
    fee_levelString(May be omitted) The transaction cost of this transaction, relative to the minimum cost for this type of transaction, in fee levels.
    max_spend_dropsString(May be omitted) The maximum amount of XRP, in drops, this transaction could send or destroy.
    seqInteger(May be omitted) The Sequence Number of this transaction.
    +

    If the request specified "owner_funds": true and expanded transactions, the response has a field owner_funds in the metaData object of each OfferCreate-type transaction. The purpose of this field is to make it easier to track the funding status of offers with each new validated ledger. This field is defined slightly different than the version of this field in Order Book subscription streams:

    diff --git a/tutorial-listing-xrp.html b/tutorial-listing-xrp.html index a24d54a993..cd362f22c1 100644 --- a/tutorial-listing-xrp.html +++ b/tutorial-listing-xrp.html @@ -90,6 +90,7 @@
  • Fee Voting
  • Fees (Disambiguation)
  • Freeze
    • +
  • Partial Payments
  • Paths
  • Reserves
  • Stand-Alone Mode