From 509dfd94dcb9910ddfff081eaa8beb078b4eb7c6 Mon Sep 17 00:00:00 2001 From: mDuo13 Date: Tue, 27 Jun 2023 14:14:34 -0700 Subject: [PATCH] API: remove more mentions of the removed 'strict' parameter & clean up nearby --- assets/js/apitool-methods-ws.js | 3 -- .../account-methods/account_channels.md | 16 +++++------ .../account-methods/account_currencies.md | 21 ++++++-------- .../account-methods/account_info.md | 28 +++++++++---------- .../account-methods/account_lines.md | 16 +++++------ .../account-methods/account_offers.md | 21 +++++++------- .../account-methods/gateway_balances.md | 2 ++ 7 files changed, 50 insertions(+), 57 deletions(-) diff --git a/assets/js/apitool-methods-ws.js b/assets/js/apitool-methods-ws.js index 09bb194876..e83ab66e6e 100644 --- a/assets/js/apitool-methods-ws.js +++ b/assets/js/apitool-methods-ws.js @@ -22,7 +22,6 @@ Request('account_currencies', { body: { "command": "account_currencies", "account": DEFAULT_ADDRESS_1, - "strict": true, "ledger_index": "validated" } }) @@ -34,7 +33,6 @@ Request('account_info', { "id": 2, "command": "account_info", "account": DEFAULT_ADDRESS_1, - "strict": true, "ledger_index": "current", "queue": true } @@ -106,7 +104,6 @@ Request('gateway_balances', { "id": "example_gateway_balances_1", "command": "gateway_balances", "account": "rMwjYedjc7qqtKYVLiAccJSmCwih4LnE2q", // btc2ripple - "strict": true, "hotwallet": [ "rKm4uWpg9tfwbVSeATv4KxDe6mpE9yPkgJ", "ra7JkEzrgeKHdzKgo4EUUVBnxggY4z37kt" diff --git a/content/references/http-websocket-apis/public-api-methods/account-methods/account_channels.md b/content/references/http-websocket-apis/public-api-methods/account-methods/account_channels.md index a3a44c5e0f..2a16a35621 100644 --- a/content/references/http-websocket-apis/public-api-methods/account-methods/account_channels.md +++ b/content/references/http-websocket-apis/public-api-methods/account-methods/account_channels.md @@ -55,14 +55,14 @@ rippled account_channels rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn ra5nK24KXen9AHvsdFTK The request includes the following parameters: -| Field | Type | Description | -|:----------------------|:---------------------------|:------------------------| -| `account` | String | The unique identifier of an account, typically the account's [Address][]. The request returns channels where this account is the channel's owner/source. | -| `destination_account` | String | _(Optional)_ The unique identifier of an account, typically the account's [Address][]. If provided, filter results to payment channels whose destination is this account. | -| `ledger_hash` | String | _(Optional)_ A 20-byte hex string for the ledger version to use. (See [Specifying Ledgers][]) | -| `ledger_index` | String or Unsigned Integer | _(Optional)_ The [ledger index][] of the ledger to use, or a shortcut string to choose a ledger automatically. (See [Specifying Ledgers][]) | -| `limit` | Integer | _(Optional)_ Limit the number of transactions to retrieve. Cannot be less than 10 or more than 400. The default is 200. | -| `marker` | [Marker][] | _(Optional)_ Value from a previous paginated response. Resume retrieving data where that response left off. [Updated in: rippled 1.5.0][] | +| Field | Type | Required? | Description | +|:----------------------|:---------------------|:----------|-------------| +| `account` | String - [Address][] | Yes | Look up channels where this account is the channel's owner/source. | +| `destination_account` | String - [Address][] | No | A second account; if provided, filter results to payment channels whose destination is this account. | +| `ledger_hash` | String | No | A 20-byte hex string for the ledger version to use. (See [Specifying Ledgers][]) | +| `ledger_index` | Number or String | No | The [ledger index][] of the ledger to use, or a shortcut string to choose a ledger automatically. (See [Specifying Ledgers][]) | +| `limit` | Number | No | Limit the number of transactions to retrieve. Cannot be less than 10 or more than 400. The default is 200. | +| `marker` | [Marker][] | No | Value from a previous paginated response. Resume retrieving data where that response left off. | ## Response Format diff --git a/content/references/http-websocket-apis/public-api-methods/account-methods/account_currencies.md b/content/references/http-websocket-apis/public-api-methods/account-methods/account_currencies.md index 4b45fc314b..d9fc0f766b 100644 --- a/content/references/http-websocket-apis/public-api-methods/account-methods/account_currencies.md +++ b/content/references/http-websocket-apis/public-api-methods/account-methods/account_currencies.md @@ -21,7 +21,6 @@ An example of the request format: { "command": "account_currencies", "account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59", - "strict": true, "ledger_index": "validated" } ``` @@ -35,8 +34,7 @@ An example of the request format: { "account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59", "account_index": 0, - "ledger_index": "validated", - "strict": true + "ledger_index": "validated" } ] } @@ -45,8 +43,8 @@ An example of the request format: *Commandline* ```sh -#Syntax: account_currencies account [ledger_index|ledger_hash] [strict] -rippled account_currencies rG1QQv2nh2gr7RCZ1P8YYcBUKCCN633jCn validated strict +#Syntax: account_currencies account [ledger_index|ledger_hash] +rippled account_currencies rG1QQv2nh2gr7RCZ1P8YYcBUKCCN633jCn validated ``` @@ -55,14 +53,13 @@ rippled account_currencies rG1QQv2nh2gr7RCZ1P8YYcBUKCCN633jCn validated strict The request includes the following parameters: -| `Field` | Type | Description | -|:---------------|:---------------------------|:-------------------------------| -| `account` | String | A unique identifier for the account, most commonly the account's [Address][]. | -| `ledger_hash` | String | _(Optional)_ A 20-byte hex string for the ledger version to use. (See [Specifying Ledgers][]) | -| `ledger_index` | String or Unsigned Integer | _(Optional)_ The [ledger index][] of the ledger to use, or a shortcut string to choose a ledger automatically. (See [Specifying Ledgers][]) | -| `strict` | Boolean | _(Optional)_ 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`. | +| `Field` | Type | Required? | Description | +|:---------------|:---------------------|:----------|-------------| +| `account` | String - [Address][] | Yes | Look up currencies this account can send or receive. [Updated in: rippled 1.11.0][] | +| `ledger_hash` | String | No | A 20-byte hex string for the ledger version to use. (See [Specifying Ledgers][]) | +| `ledger_index` | Number or String | No | The [ledger index][] of the ledger to use, or a shortcut string to choose a ledger automatically. (See [Specifying Ledgers][]) | -The following field is deprecated and should not be provided: `account_index`. +The following fields are deprecated and should not be provided: `account_index`, `strict`. ## Response Format diff --git a/content/references/http-websocket-apis/public-api-methods/account-methods/account_info.md b/content/references/http-websocket-apis/public-api-methods/account-methods/account_info.md index 40d64939fe..e678200b57 100644 --- a/content/references/http-websocket-apis/public-api-methods/account-methods/account_info.md +++ b/content/references/http-websocket-apis/public-api-methods/account-methods/account_info.md @@ -24,7 +24,6 @@ An example of an account_info request: "id": 2, "command": "account_info", "account": "rG1QQv2nh2gr7RCZ1P8YYcBUKCCN633jCn", - "strict": true, "ledger_index": "current", "queue": true } @@ -38,7 +37,6 @@ An example of an account_info request: "params": [ { "account": "rG1QQv2nh2gr7RCZ1P8YYcBUKCCN633jCn", - "strict": true, "ledger_index": "current", "queue": true } @@ -49,8 +47,8 @@ An example of an account_info request: *Commandline* ```sh -#Syntax: account_info account [ledger_index|ledger_hash] [strict] -rippled account_info rG1QQv2nh2gr7RCZ1P8YYcBUKCCN633jCn validated strict +#Syntax: account_info account [ledger_index|ledger_hash] +rippled account_info rG1QQv2nh2gr7RCZ1P8YYcBUKCCN633jCn validated ``` @@ -59,13 +57,13 @@ rippled account_info rG1QQv2nh2gr7RCZ1P8YYcBUKCCN633jCn validated strict The request contains the following parameters: -| `Field` | Type | Description | -|:---------------|:---------------------------|:-------------------------------| -| `account` | String - [Address][] | The account to look up. [Updated in: rippled 1.11.0][] | -| `ledger_hash` | String | _(Optional)_ A 20-byte hex string for the ledger version to use. (See [Specifying Ledgers][]) | -| `ledger_index` | String or Unsigned Integer | _(Optional)_ The [ledger index][] of the ledger to use, or a shortcut string to choose a ledger automatically. (See [Specifying Ledgers][]) | -| `queue` | Boolean | _(Optional)_ If `true`, return stats about [queued transactions](transaction-queue.html) sent by this account. Can only be used when querying for the data from the current open ledger. Not available from servers in [Reporting Mode][]. | -| `signer_lists` | Boolean | _(Optional)_ If `true`, return any [SignerList objects](signerlist.html) associated with this account. [New in: rippled 0.31.0][] | +| `Field` | Type | Required? | Description | +|:---------------|:---------------------|:----------|-------------| +| `account` | String - [Address][] | Yes | The account to look up. [Updated in: rippled 1.11.0][] | +| `ledger_hash` | String | No | A 20-byte hex string for the ledger version to use. (See [Specifying Ledgers][]) | +| `ledger_index` | Number or String | No | The [ledger index][] of the ledger to use, or a shortcut string to choose a ledger automatically. (See [Specifying Ledgers][]) | +| `queue` | Boolean | No | If `true`, return stats about [queued transactions](transaction-queue.html) sent by this account. Can only be used when querying for the data from the current open ledger. Not available from servers in [Reporting Mode][]. | +| `signer_lists` | Boolean | No | If `true`, return any [SignerList objects](signerlist.html) associated with this account. | The following fields are deprecated and should not be provided: `ident`, `ledger`, `strict`. @@ -219,10 +217,10 @@ The `account_flags` field contains the following nested fields: | `defaultRipple` | Boolean | If `true`, the account allows [rippling](rippling.html) on its trust lines by default. | | `depositAuth` | Boolean | If `true`, the account is using [Deposit Authorization](depositauth.html) and does not accept any payments from unknown parties. | | `disableMasterKey` | Boolean | If `true`, the account's [master key pair](cryptographic-keys.html) is disabled. | -| `disallowIncomingCheck` | Boolean | If `true`, the account does not allow others to send [Checks](checks.html) to it. | -| `disallowIncomingNFTokenOffer` | Boolean | If `true`, the account does not allow others to make [NFT buy or sell offers](non-fungible-token-transfers.html) to it. | -| `disallowIncomingPayChan` | Boolean | If `true`, the account does not allow others to make [Payment Channels](payment-channels.html) to it. | -| `disallowIncomingTrustline` | Boolean | If `true`, the account does not allow others to make [trust lines](trust-lines-and-issuing.html) to it. | +| `disallowIncomingCheck` | Boolean | If `true`, the account does not allow others to send [Checks](checks.html) to it. _(Requires the [DisallowIncoming amendment][])_ | +| `disallowIncomingNFTokenOffer` | Boolean | If `true`, the account does not allow others to make [NFT buy or sell offers](non-fungible-token-transfers.html) to it. _(Requires the [DisallowIncoming amendment][])_ | +| `disallowIncomingPayChan` | Boolean | If `true`, the account does not allow others to make [Payment Channels](payment-channels.html) to it. _(Requires the [DisallowIncoming amendment][])_ | +| `disallowIncomingTrustline` | Boolean | If `true`, the account does not allow others to make [trust lines](trust-lines-and-issuing.html) to it. _(Requires the [DisallowIncoming amendment][])_ | | `disallowIncomingXRP` | Boolean | If `true`, the account does not want to receive XRP from others. (This is advisory, and not enforced at a protocol level.) | | `globalFreeze` | Boolean | If `true`, all tokens issued by the account are currently frozen. | | `noFreeze` | Boolean | If `true`, the account has permanently given up the abilities to freeze individual trust lines or end a global freeze. See [No Freeze](freezes.html#no-freeze) for details. | diff --git a/content/references/http-websocket-apis/public-api-methods/account-methods/account_lines.md b/content/references/http-websocket-apis/public-api-methods/account-methods/account_lines.md index 2de2adefd0..281ad9467b 100644 --- a/content/references/http-websocket-apis/public-api-methods/account-methods/account_lines.md +++ b/content/references/http-websocket-apis/public-api-methods/account-methods/account_lines.md @@ -52,14 +52,14 @@ rippled account_lines r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59 The request accepts the following parameters: -| `Field` | Type | Description | -|:---------------|:-------------------------------------------|:---------------| -| `account` | String | A unique identifier for the account, most commonly the account's [Address][]. | -| `ledger_hash` | String | _(Optional)_ A 20-byte hex string for the ledger version to use. (See [Specifying Ledgers][]) | -| `ledger_index` | String or Unsigned Integer | _(Optional)_ The [ledger index][] of the ledger to use, or a shortcut string to choose a ledger automatically. (See [Specifying Ledgers][]) | -| `peer` | String | _(Optional)_ The [Address][] of a second account. If provided, show only lines of trust connecting the two accounts. | -| `limit` | Integer | (Optional, default varies) 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. [New in: rippled 0.26.4][] | -| `marker` | [Marker][] | _(Optional)_ Value from a previous paginated response. Resume retrieving data where that response left off. [New in: rippled 0.26.4][] | +| `Field` | Type | Description | +|:---------------|:---------------------|:---------------| +| `account` | String - [Address][] | Look up trust lines connected to this account. | +| `ledger_hash` | String | _(Optional)_ A 20-byte hex string for the ledger version to use. (See [Specifying Ledgers][]) | +| `ledger_index` | Number or String | _(Optional)_ The [ledger index][] of the ledger to use, or a shortcut string to choose a ledger automatically. (See [Specifying Ledgers][]) | +| `peer` | String - [Address][] | _(Optional)_ A second account; if provided, filter results to trust lines connecting the two accounts. | +| `limit` | Number | _(Optional)_ Limit the number of trust lines to retrieve. The server may return less than the specified limit, even if there are more pages of results. Must be within the inclusive range 10 to 400. The default is 200. | +| `marker` | [Marker][] | _(Optional)_ Value from a previous paginated response. Resume retrieving data where that response left off. | The following parameters are deprecated and may be removed without further notice: `ledger` and `peer_index`. diff --git a/content/references/http-websocket-apis/public-api-methods/account-methods/account_offers.md b/content/references/http-websocket-apis/public-api-methods/account-methods/account_offers.md index 34c0d1909f..7e8bf61107 100644 --- a/content/references/http-websocket-apis/public-api-methods/account-methods/account_offers.md +++ b/content/references/http-websocket-apis/public-api-methods/account-methods/account_offers.md @@ -42,8 +42,8 @@ An example of the request format: *Commandline* ```sh -#Syntax: account_offers account [ledger_index] [strict] -rippled account_offers rpP2JgiMyTF5jR5hLG3xHCPi1knBb1v9cM current strict +#Syntax: account_offers account [ledger_index] +rippled account_offers rpP2JgiMyTF5jR5hLG3xHCPi1knBb1v9cM current ``` @@ -52,16 +52,15 @@ rippled account_offers rpP2JgiMyTF5jR5hLG3xHCPi1knBb1v9cM current strict A request can include the following parameters: -| `Field` | Type | Description | -|:---------------|:----------------------------|:------------------------------| -| `account` | String | A unique identifier for the account, most commonly the account's [Address][]. | -| `ledger_hash` | String - [Hash][] | _(Optional)_ A 20-byte hex string identifying the ledger version to use. | -| `ledger_index` | Number - [Ledger Index][] | _(Optional)_ The [ledger index][] of the ledger to use, or a shortcut string to choose a ledger automatically. (See [Specifying Ledgers][]) | -| `limit` | Integer | _(Optional)_ Limit the number of Offers to retrieve. The server may return fewer than this number of results. Must be within the inclusive range 10 to 400. The default is 200. [New in: rippled 0.26.4][] | -| `marker` | [Marker][] | _(Optional)_ Value from a previous paginated response. Resume retrieving data where that response left off. [New in: rippled 0.26.4][] | -| `strict` | Boolean | _(Optional)_ 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`. | +| Field | Type | Required? | Description | +|:---------------|:---------------------|:----------|-------------| +| `account` | String - [Address][] | Yes | Look up Offers placed by this account. | +| `ledger_hash` | String | No | A 20-byte hex string for the ledger version to use. (See [Specifying Ledgers][]) | +| `ledger_index` | Number or String | No | The [ledger index][] of the ledger to use, or a shortcut string to choose a ledger automatically. (See [Specifying Ledgers][]) | +| `limit` | Number | No | Limit the number of Offers to retrieve. The server may return fewer than this number of results. Must be within the inclusive range 10 to 400. The default is 200. | +| `marker` | [Marker][] | No | Value from a previous paginated response. Resume retrieving data where that response left off. | -The following parameter is deprecated and may be removed without further notice: `ledger`. +The following parameters are deprecated should not be provided: `ledger`, `strict`. ## Response Format diff --git a/content/references/http-websocket-apis/public-api-methods/account-methods/gateway_balances.md b/content/references/http-websocket-apis/public-api-methods/account-methods/gateway_balances.md index 8e86e3a3ef..896eba5535 100644 --- a/content/references/http-websocket-apis/public-api-methods/account-methods/gateway_balances.md +++ b/content/references/http-websocket-apis/public-api-methods/account-methods/gateway_balances.md @@ -11,6 +11,8 @@ labels: The `gateway_balances` command calculates the total balances issued by a given account, optionally excluding amounts held by [operational addresses](issuing-and-operational-addresses.html). [New in: rippled 0.28.2][] +**Caution:** Some public servers disable this API method because it can require a large amount of processing. + ## Request Format An example of the request format: