mirror of
https://github.com/XRPLF/xrpl-dev-portal.git
synced 2025-11-21 04:05:49 +00:00
additional 2.0 doc updates
This commit is contained in:
@@ -581,6 +581,15 @@ Request('fee', {
|
|||||||
}
|
}
|
||||||
})
|
})
|
||||||
|
|
||||||
|
Request('server_definitions', {
|
||||||
|
description: "Returns an SDK-compatible `definitions.json`, generated from the rippled server being queried.",
|
||||||
|
link: "server_definitions.html",
|
||||||
|
body: {
|
||||||
|
"id": 1,
|
||||||
|
"command": "server_definitions"
|
||||||
|
}
|
||||||
|
})
|
||||||
|
|
||||||
Request('server_info', {
|
Request('server_info', {
|
||||||
description: "Reports a human-readable version of various information about the rippled server being queried.",
|
description: "Reports a human-readable version of various information about the rippled server being queried.",
|
||||||
link: "server_info.html",
|
link: "server_info.html",
|
||||||
|
|||||||
@@ -226,6 +226,8 @@
|
|||||||
"fix1578",
|
"fix1578",
|
||||||
"fix1623",
|
"fix1623",
|
||||||
"fixCheckThreading",
|
"fixCheckThreading",
|
||||||
|
"fixDisallowIncomingV1",
|
||||||
|
"fixFillOrKill",
|
||||||
"fixMasterKeyAsRegularKey",
|
"fixMasterKeyAsRegularKey",
|
||||||
"fixNFTokenDirV1",
|
"fixNFTokenDirV1",
|
||||||
"fixNFTokenRemint",
|
"fixNFTokenRemint",
|
||||||
|
|||||||
@@ -0,0 +1,108 @@
|
|||||||
|
---
|
||||||
|
html: server_definitions.html
|
||||||
|
parent: server-info-methods.html
|
||||||
|
blurb: Retrieve an SDK-compatible `definitions.json`, generated from the `rippled` instance currently running.
|
||||||
|
labels:
|
||||||
|
- Core Server
|
||||||
|
---
|
||||||
|
# server_definitions
|
||||||
|
|
||||||
|
[[Source]](https://github.com/XRPLF/rippled/blob/master/src/ripple/rpc/handlers/ServerInfo.cpp#L43 "Source")
|
||||||
|
|
||||||
|
The `server_definitions` command returns an SDK-compatible `definitions.json`, generated from the `rippled` instance currently running. You can use this to query a node in a network, quickly receiving the definitions necessary to serialize/deserialize its binary data.
|
||||||
|
|
||||||
|
|
||||||
|
## Request Format
|
||||||
|
An example of the request format:
|
||||||
|
|
||||||
|
<!-- MULTICODE_BLOCK_START -->
|
||||||
|
|
||||||
|
*WebSocket*
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"id": 2,
|
||||||
|
"command": "server_definitions"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
<!-- MULTICODE_BLOCK_END -->
|
||||||
|
|
||||||
|
[Try it! >](websocket-api-tool.html#server_definitions)
|
||||||
|
|
||||||
|
The request does not take any parameters.
|
||||||
|
|
||||||
|
|
||||||
|
## Response Format
|
||||||
|
|
||||||
|
An example of a successful response:
|
||||||
|
|
||||||
|
<!-- MULTICODE_BLOCK_START -->
|
||||||
|
|
||||||
|
*WebSocket*
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"id": 1,
|
||||||
|
"result": {
|
||||||
|
"FIELDS": [
|
||||||
|
[
|
||||||
|
"Generic",
|
||||||
|
{
|
||||||
|
"isSerialized": false,
|
||||||
|
"isSigningField": false,
|
||||||
|
"isVLEncoded": false,
|
||||||
|
"nth": 0,
|
||||||
|
"type": "Unknown"
|
||||||
|
}
|
||||||
|
],
|
||||||
|
[
|
||||||
|
"Invalid",
|
||||||
|
{
|
||||||
|
"isSerialized": false,
|
||||||
|
"isSigningField": false,
|
||||||
|
"isVLEncoded": false,
|
||||||
|
"nth": -1,
|
||||||
|
"type": "Unknown"
|
||||||
|
}
|
||||||
|
],
|
||||||
|
[
|
||||||
|
"ObjectEndMarker",
|
||||||
|
{
|
||||||
|
"isSerialized": true,
|
||||||
|
"isSigningField": true,
|
||||||
|
"isVLEncoded": false,
|
||||||
|
"nth": 1,
|
||||||
|
"type": "STObject"
|
||||||
|
}
|
||||||
|
],
|
||||||
|
[
|
||||||
|
"ArrayEndMarker",
|
||||||
|
{
|
||||||
|
"isSerialized": true,
|
||||||
|
"isSigningField": true,
|
||||||
|
"isVLEncoded": false,
|
||||||
|
"nth": 1,
|
||||||
|
"type": "STArray"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
...
|
||||||
|
]
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
<!-- MULTICODE_BLOCK_END -->
|
||||||
|
|
||||||
|
To see a full `definitions.json` file and descriptions of the top-level fields, see: [Definitions File](serialization.html#definitions-file).
|
||||||
|
|
||||||
|
|
||||||
|
## Possible Errors
|
||||||
|
|
||||||
|
Any of the [universal error types][].
|
||||||
|
|
||||||
|
|
||||||
|
<!--{# common link defs #}-->
|
||||||
|
{% include '_snippets/rippled-api-links.md' %}
|
||||||
|
{% include '_snippets/tx-type-links.md' %}
|
||||||
|
{% include '_snippets/rippled_versions.md' %}
|
||||||
@@ -16,6 +16,8 @@ The following is a comprehensive list of all known [amendments](amendments.html)
|
|||||||
|
|
||||||
| Name | Introduced | Status |
|
| Name | Introduced | Status |
|
||||||
|:----------------------------------|:-----------|:------------------------------|
|
|:----------------------------------|:-----------|:------------------------------|
|
||||||
|
| [fixDisallowIncomingV1][] | v2.0.0 | [Open for Voting: 2024-01-09](https://xrpl.org/blog/2024/rippled-2.0.0.html "BADGE_80d0e0") |
|
||||||
|
| [fixFillOrKill][] | v2.0.0 | [Open for Voting: 2024-01-09](https://xrpl.org/blog/2024/rippled-2.0.0.html "BADGE_80d0e0") |
|
||||||
| [DID][] | v2.0.0 | [Open for Voting: 2024-01-09](https://xrpl.org/blog/2024/rippled-2.0.0.html "BADGE_80d0e0") |
|
| [DID][] | v2.0.0 | [Open for Voting: 2024-01-09](https://xrpl.org/blog/2024/rippled-2.0.0.html "BADGE_80d0e0") |
|
||||||
| [XChainBridge][] | v2.0.0 | [Open for Voting: 2024-01-09](https://xrpl.org/blog/2024/rippled-2.0.0.html "BADGE_80d0e0") |
|
| [XChainBridge][] | v2.0.0 | [Open for Voting: 2024-01-09](https://xrpl.org/blog/2024/rippled-2.0.0.html "BADGE_80d0e0") |
|
||||||
| [AMM][] | v1.12.0 | [Open for Voting: 2023-09-06](https://xrpl.org/blog/2023/rippled-1.12.0.html "BADGE_80d0e0") |
|
| [AMM][] | v1.12.0 | [Open for Voting: 2023-09-06](https://xrpl.org/blog/2023/rippled-1.12.0.html "BADGE_80d0e0") |
|
||||||
@@ -106,6 +108,47 @@ The following is a list of known [amendments](amendments.html) that have been re
|
|||||||
|
|
||||||
## Details about Known Amendments
|
## Details about Known Amendments
|
||||||
|
|
||||||
|
### fixDisallowIncomingV1
|
||||||
|
[fixDisallowIncomingV1]: #fixDisallowIncomingV1
|
||||||
|
|
||||||
|
| Amendment | fixDisallowIncomingV1 |
|
||||||
|
|:-------------|:--------------|
|
||||||
|
| Amendment ID | 15D61F0C6DB6A2F86BCF96F1E2444FEC54E705923339EC175BD3E517C8B3FF91 |
|
||||||
|
| Status | Open for Voting |
|
||||||
|
| Default Vote (Latest stable release) | No |
|
||||||
|
| Pre-amendment functionality retired? | No |
|
||||||
|
|
||||||
|
This amendment fixes an issue with approving trustlines after a user enables the `lsfDisallowIncomingTrustline` flag on their account.
|
||||||
|
|
||||||
|
To recreate this issue:
|
||||||
|
|
||||||
|
1. An issuer sets `asfRequireAuth` on their account.
|
||||||
|
2. The user sets `asfDisallowIncomingTrustline` on their account.
|
||||||
|
3. The user submits a `SetTrust` transaction to the issuer.
|
||||||
|
4. The issuer is unable to authorize the trustline.
|
||||||
|
|
||||||
|
With this amendment, the issuer can now authorize the trustline.
|
||||||
|
|
||||||
|
This amendment has no effect unless the [DisallowIncoming][] amendment is enabled.
|
||||||
|
|
||||||
|
|
||||||
|
### fixFillOrKill
|
||||||
|
[fixFillOrKill]: #fixFillOrKill
|
||||||
|
|
||||||
|
| Amendment | fixFillOrKill |
|
||||||
|
|:-------------|:--------------|
|
||||||
|
| Amendment ID | 3318EA0CF0755AF15DAC19F2B5C5BCBFF4B78BDD57609ACCAABE2C41309B051A |
|
||||||
|
| Status | Open for Voting |
|
||||||
|
| Default Vote (Latest stable release) | No |
|
||||||
|
| Pre-amendment functionality retired? | No |
|
||||||
|
|
||||||
|
This amendment fixes an issue introduced in the `FlowCross` amendment. Offers with the `tfFillOrKill` flag set and `tfSell` not set will fail if the exchange rate on the offer is better than, but doesn't exactly match, the order book rate.
|
||||||
|
|
||||||
|
This amendment enables the payment engine to properly handle this scenario and allow offers to cross.
|
||||||
|
|
||||||
|
This amendment has no effect unless the [FlowCross][] amendment is enabled.
|
||||||
|
|
||||||
|
|
||||||
### DID
|
### DID
|
||||||
[DID]: #did
|
[DID]: #did
|
||||||
|
|
||||||
|
|||||||
@@ -3593,6 +3593,11 @@ pages:
|
|||||||
targets:
|
targets:
|
||||||
- ja
|
- ja
|
||||||
|
|
||||||
|
- md: references/http-websocket-apis/public-api-methods/server-info-methods/server_definitions.md
|
||||||
|
targets:
|
||||||
|
- en
|
||||||
|
- ja
|
||||||
|
|
||||||
- md: references/http-websocket-apis/public-api-methods/server-info-methods/server_info.md
|
- md: references/http-websocket-apis/public-api-methods/server-info-methods/server_info.md
|
||||||
targets:
|
targets:
|
||||||
- en
|
- en
|
||||||
|
|||||||
Reference in New Issue
Block a user