mirror of
https://github.com/XRPLF/xrpl-dev-portal.git
synced 2025-12-02 17:45:54 +00:00
update and reflink sha512half
This commit is contained in:
@@ -11,6 +11,7 @@
|
||||
[result code]: transaction-results.html
|
||||
[seconds since the Ripple Epoch]: basic-data-types.html#specifying-time
|
||||
[Sequence Number]: basic-data-types.html#account-sequence
|
||||
[SHA-512Half]: ledger-data-formats.html#sha512half
|
||||
[Specifying Ledgers]: basic-data-types.html#specifying-ledgers
|
||||
[Specifying Time]: basic-data-types.html#specifying-time
|
||||
[standard format]: response-formatting.html
|
||||
|
||||
@@ -6,13 +6,13 @@ Every ledger version has a unique header that describes the contents. You can lo
|
||||
| Field | JSON Type | [Internal Type][] | Description |
|
||||
|-----------------|-----------|-------------------|-------------|
|
||||
| [`ledger_index`](#ledger-index) | String | UInt32 | The sequence number of the ledger. Some API methods display this as a quoted integer; some display it as a native JSON number. |
|
||||
| `ledger_hash` | String | Hash256 | The [SHA-512Half](#sha512half) of the ledger header, excluding the `ledger_hash` itself. This serves as a unique identifier for this ledger and all its contents. |
|
||||
| `account_hash` | String | Hash256 | The [SHA-512Half](#sha512half) of this ledger's state tree information. |
|
||||
| `ledger_hash` | String | Hash256 | The [SHA-512Half][] of the ledger header, excluding the `ledger_hash` itself. This serves as a unique identifier for this ledger and all its contents. |
|
||||
| `account_hash` | String | Hash256 | The [SHA-512Half][] of this ledger's state tree information. |
|
||||
| `close_time` | Number | UInt32 | The approximate time this ledger closed, as the number of seconds since the Ripple Epoch of 2000-01-01 00:00:00. This value is rounded based on the `close_time_resolution`, so later ledgers can have the same value. |
|
||||
| `closed` | Boolean | bool | If true, this ledger version is no longer accepting new transactions. (However, unless this ledger version is validated, it might be replaced by a different ledger version with a different set of transactions.) |
|
||||
| `parent_hash` | String | Hash256 | The `ledger_hash` value of the previous ledger that was used to build this one. If there are different versions of the previous ledger index, this indicates from which one the ledger was derived. |
|
||||
| `total_coins` | String | UInt64 | The total number of [drops of XRP][XRP, in drops] owned by accounts in the ledger. This omits XRP that has been destroyed by transaction fees. The actual amount of XRP in circulation is lower because some accounts are "black holes" whose keys are not known by anyone. |
|
||||
| `transaction_hash` | String | Hash256 | The [SHA-512Half](#sha512half) of the transactions included in this ledger. |
|
||||
| `transaction_hash` | String | Hash256 | The [SHA-512Half][] of the transactions included in this ledger. |
|
||||
| `close_time_resolution` | Number | Uint8 | An integer in the range \[2,120\] indicating the maximum number of seconds by which the `close_time` could be rounded. |
|
||||
| [`closeFlags`](#close-flags) | (Omitted) | UInt8 | A bit-map of flags relating to the closing of this ledger. |
|
||||
|
||||
|
||||
@@ -68,7 +68,7 @@ AccountRoot objects can have the following flag values:
|
||||
|
||||
## AccountRoot ID Format
|
||||
|
||||
The ID of an AccountRoot object is the [SHA-512Half](#sha512half) of the following values, concatenated in order:
|
||||
The ID of an AccountRoot object is the [SHA-512Half][] of the following values, concatenated in order:
|
||||
|
||||
* The Account space key (`0x0061`)
|
||||
* The AccountID of the account
|
||||
|
||||
@@ -51,7 +51,7 @@ A `Check` object has the following fields:
|
||||
## Check ID Format
|
||||
[[Source]<br>](https://github.com/ripple/rippled/blob/master/src/ripple/protocol/impl/Indexes.cpp#L193-L200 "Source")
|
||||
|
||||
The ID of a `Check` object is the [SHA-512Half](#sha512half) of the following values, concatenated in order:
|
||||
The ID of a `Check` object is the [SHA-512Half][] of the following values, concatenated in order:
|
||||
|
||||
* The Check space key (`0x0043`)
|
||||
* The AccountID of the sender of the [CheckCreate transaction][] that created the `Check` object
|
||||
|
||||
@@ -74,12 +74,12 @@ There are three different formulas for creating the ID of a DirectoryNode, depen
|
||||
* The first page of an Offer Directory
|
||||
* Later pages of either type
|
||||
|
||||
**The first page of an Owner Directory** has an ID that is the [SHA-512Half](#sha512half) of the following values, concatenated in order:
|
||||
**The first page of an Owner Directory** has an ID that is the [SHA-512Half][] of the following values, concatenated in order:
|
||||
|
||||
* The Owner Directory space key (`0x004F`)
|
||||
* The AccountID from the `Owner` field.
|
||||
|
||||
**The first page of an Offer Directory** has a special ID: the higher 192 bits define the order book, and the remaining 64 bits define the exchange rate of the offers in that directory. (The ID is big-endian, so the book is in the more significant bits, which come first, and the quality is in the less significant bits which come last.) This provides a way to iterate through an order book from best offers to worst. Specifically: the first 192 bits are the first 192 bits of the [SHA-512Half](#sha512half) of the following values, concatenated in order:
|
||||
**The first page of an Offer Directory** has a special ID: the higher 192 bits define the order book, and the remaining 64 bits define the exchange rate of the offers in that directory. (The ID is big-endian, so the book is in the more significant bits, which come first, and the quality is in the less significant bits which come last.) This provides a way to iterate through an order book from best offers to worst. Specifically: the first 192 bits are the first 192 bits of the [SHA-512Half][] of the following values, concatenated in order:
|
||||
|
||||
* The Book Directory space key (`0x0042`)
|
||||
* The 160-bit currency code from the `TakerPaysCurrency`
|
||||
@@ -89,7 +89,7 @@ There are three different formulas for creating the ID of a DirectoryNode, depen
|
||||
|
||||
The lower 64 bits of an Offer Directory's ID represent the TakerPays amount divided by TakerGets amount from the offer(s) in that directory as a 64-bit number in the XRP Ledger's internal amount format.
|
||||
|
||||
**If the DirectoryNode is not the first page in the Directory** (regardless of whether it is an Owner Directory or an Offer Directory), then it has an ID that is the [SHA-512Half](#sha512half) of the following values, concatenated in order:
|
||||
**If the DirectoryNode is not the first page in the Directory** (regardless of whether it is an Owner Directory or an Offer Directory), then it has an ID that is the [SHA-512Half][] of the following values, concatenated in order:
|
||||
|
||||
* The DirectoryNode space key (`0x0064`)
|
||||
* The ID of the root DirectoryNode
|
||||
|
||||
@@ -56,7 +56,7 @@ An `Escrow` object has the following fields:
|
||||
|
||||
## Escrow ID Format
|
||||
|
||||
The ID of an `Escrow` object is the [SHA-512Half](#sha512half) of the following values, concatenated in order:
|
||||
The ID of an `Escrow` object is the [SHA-512Half][] of the following values, concatenated in order:
|
||||
|
||||
* The Escrow space key (`0x0075`)
|
||||
* The AccountID of the sender of the [EscrowCreate transaction][] that created the `Escrow` object
|
||||
|
||||
@@ -61,9 +61,9 @@ The "previous history" `LedgerHashes` objects act as a [skip list](https://en.wi
|
||||
|
||||
There are two formats for `LedgerHashes` object IDs, depending on whether the object is a "recent history" sub-type or a "previous history" sub-type.
|
||||
|
||||
The **"recent history"** `LedgerHashes` object has an ID that is the [SHA-512Half](#sha512half) of the `LedgerHashes` space key (`0x0073`). In other words, the "recent history" always has the ID `B4979A36CDC7F3D3D5C31A4EAE2AC7D7209DDA877588B9AFC66799692AB0D66B`.
|
||||
The **"recent history"** `LedgerHashes` object has an ID that is the [SHA-512Half][] of the `LedgerHashes` space key (`0x0073`). In other words, the "recent history" always has the ID `B4979A36CDC7F3D3D5C31A4EAE2AC7D7209DDA877588B9AFC66799692AB0D66B`.
|
||||
|
||||
The **"previous history"** `LedgerHashes` objects have an ID that is the [SHA-512Half](#sha512half) of the following values, concatenated in order:
|
||||
The **"previous history"** `LedgerHashes` objects have an ID that is the [SHA-512Half][] of the following values, concatenated in order:
|
||||
|
||||
- The `LedgerHashes` space key (`0x0073`)
|
||||
- The 32-bit [ledger index](#ledger-index) of a flag ledger in the object's `Hashes` array, divided by 65536.
|
||||
|
||||
@@ -60,7 +60,7 @@ There are several options which can be either enabled or disabled when an [Offer
|
||||
|
||||
## Offer ID Format
|
||||
|
||||
The ID of an `Offer` object is the [SHA-512Half](#sha512half) of the following values, concatenated in order:
|
||||
The ID of an `Offer` object is the [SHA-512Half][] of the following values, concatenated in order:
|
||||
|
||||
* The Offer space key (`0x006F`)
|
||||
* The AccountID of the account placing the offer
|
||||
|
||||
@@ -88,7 +88,7 @@ If any other address attempts to set an `Expiration` field, the transaction fail
|
||||
|
||||
## PayChannel ID Format
|
||||
|
||||
The ID of a `PayChannel` object is the [SHA-512Half](#sha512half) of the following values, concatenated in order:
|
||||
The ID of a `PayChannel` object is the [SHA-512Half][] of the following values, concatenated in order:
|
||||
|
||||
* The PayChannel space key (`0x0078`)
|
||||
* The AccountID of the source account
|
||||
|
||||
@@ -96,7 +96,7 @@ Fortunately, `rippled` uses lazy evaluation to calculate the owner reserve. This
|
||||
|
||||
## RippleState ID Format
|
||||
|
||||
The ID of a RippleState object is the [SHA-512Half](#sha512half) of the following values, concatenated in order:
|
||||
The ID of a RippleState object is the [SHA-512Half][] of the following values, concatenated in order:
|
||||
|
||||
* The RippleState space key (`0x0072`)
|
||||
* The AccountID of the low account
|
||||
|
||||
Reference in New Issue
Block a user