From a1bfc274d55ce4a7c28027cde7f78663fd5a12ad Mon Sep 17 00:00:00 2001
From: mDuo13 <mduo13@gmail.com>
Date: Wed, 28 Nov 2018 19:35:50 -0800
Subject: [PATCH] Serialization: Add PathSet diagram, fix typos

---
 .../_img-sources/serialization-pathset.uxf    | 323 ++++++++++++++++++
 .../api-conventions/serialization.md          |  29 +-
 img/serialization-pathset.png                 | Bin 0 -> 16722 bytes
 3 files changed, 342 insertions(+), 10 deletions(-)
 create mode 100644 content/_img-sources/serialization-pathset.uxf
 create mode 100644 img/serialization-pathset.png

diff --git a/content/_img-sources/serialization-pathset.uxf b/content/_img-sources/serialization-pathset.uxf
new file mode 100644
index 0000000000..84eb14431a
--- /dev/null
+++ b/content/_img-sources/serialization-pathset.uxf
@@ -0,0 +1,323 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<diagram program="umlet" version="14.2">
+  <zoom_level>10</zoom_level>
+  <element>
+    <id>UMLPackage</id>
+    <coordinates>
+      <x>40</x>
+      <y>40</y>
+      <w>650</w>
+      <h>70</h>
+    </coordinates>
+    <panel_attributes>PathSet</panel_attributes>
+    <additional_attributes/>
+  </element>
+  <element>
+    <id>UMLClass</id>
+    <coordinates>
+      <x>50</x>
+      <y>210</y>
+      <w>40</w>
+      <h>30</h>
+    </coordinates>
+    <panel_attributes>0x30</panel_attributes>
+    <additional_attributes/>
+  </element>
+  <element>
+    <id>UMLClass</id>
+    <coordinates>
+      <x>200</x>
+      <y>70</y>
+      <w>40</w>
+      <h>30</h>
+    </coordinates>
+    <panel_attributes>0xff</panel_attributes>
+    <additional_attributes/>
+  </element>
+  <element>
+    <id>UMLClass</id>
+    <coordinates>
+      <x>50</x>
+      <y>70</y>
+      <w>150</w>
+      <h>30</h>
+    </coordinates>
+    <panel_attributes>First path</panel_attributes>
+    <additional_attributes/>
+  </element>
+  <element>
+    <id>Relation</id>
+    <coordinates>
+      <x>430</x>
+      <y>230</y>
+      <w>60</w>
+      <h>60</h>
+    </coordinates>
+    <panel_attributes>lt=&lt;&lt;-</panel_attributes>
+    <additional_attributes>10.0;10.0;10.0;40.0;40.0;40.0</additional_attributes>
+  </element>
+  <element>
+    <id>Text</id>
+    <coordinates>
+      <x>470</x>
+      <y>260</y>
+      <w>260</w>
+      <h>30</h>
+    </coordinates>
+    <panel_attributes>Path step's type byte</panel_attributes>
+    <additional_attributes/>
+  </element>
+  <element>
+    <id>UMLClass</id>
+    <coordinates>
+      <x>250</x>
+      <y>70</y>
+      <w>150</w>
+      <h>30</h>
+    </coordinates>
+    <panel_attributes>Second path</panel_attributes>
+    <additional_attributes/>
+  </element>
+  <element>
+    <id>UMLClass</id>
+    <coordinates>
+      <x>400</x>
+      <y>70</y>
+      <w>40</w>
+      <h>30</h>
+    </coordinates>
+    <panel_attributes>0xff</panel_attributes>
+    <additional_attributes/>
+  </element>
+  <element>
+    <id>Text</id>
+    <coordinates>
+      <x>450</x>
+      <y>70</y>
+      <w>40</w>
+      <h>30</h>
+    </coordinates>
+    <panel_attributes>...</panel_attributes>
+    <additional_attributes/>
+  </element>
+  <element>
+    <id>UMLClass</id>
+    <coordinates>
+      <x>490</x>
+      <y>70</y>
+      <w>150</w>
+      <h>30</h>
+    </coordinates>
+    <panel_attributes>Last path</panel_attributes>
+    <additional_attributes/>
+  </element>
+  <element>
+    <id>UMLClass</id>
+    <coordinates>
+      <x>640</x>
+      <y>70</y>
+      <w>40</w>
+      <h>30</h>
+    </coordinates>
+    <panel_attributes>0x00</panel_attributes>
+    <additional_attributes/>
+  </element>
+  <element>
+    <id>UMLPackage</id>
+    <coordinates>
+      <x>40</x>
+      <y>180</y>
+      <w>650</w>
+      <h>70</h>
+    </coordinates>
+    <panel_attributes>Path</panel_attributes>
+    <additional_attributes/>
+  </element>
+  <element>
+    <id>Relation</id>
+    <coordinates>
+      <x>30</x>
+      <y>90</y>
+      <w>40</w>
+      <h>110</h>
+    </coordinates>
+    <panel_attributes>lt=..</panel_attributes>
+    <additional_attributes>10.0;90.0;20.0;10.0</additional_attributes>
+  </element>
+  <element>
+    <id>Relation</id>
+    <coordinates>
+      <x>190</x>
+      <y>90</y>
+      <w>520</w>
+      <h>130</h>
+    </coordinates>
+    <panel_attributes>lt=..</panel_attributes>
+    <additional_attributes>500.0;110.0;10.0;10.0</additional_attributes>
+  </element>
+  <element>
+    <id>UMLClass</id>
+    <coordinates>
+      <x>90</x>
+      <y>210</y>
+      <w>160</w>
+      <h>30</h>
+    </coordinates>
+    <panel_attributes>Currency (160 bits)</panel_attributes>
+    <additional_attributes/>
+  </element>
+  <element>
+    <id>UMLClass</id>
+    <coordinates>
+      <x>250</x>
+      <y>210</y>
+      <w>160</w>
+      <h>30</h>
+    </coordinates>
+    <panel_attributes>Issuer (160 bits)</panel_attributes>
+    <additional_attributes/>
+  </element>
+  <element>
+    <id>UMLClass</id>
+    <coordinates>
+      <x>420</x>
+      <y>210</y>
+      <w>40</w>
+      <h>30</h>
+    </coordinates>
+    <panel_attributes>0x01</panel_attributes>
+    <additional_attributes/>
+  </element>
+  <element>
+    <id>UMLClass</id>
+    <coordinates>
+      <x>460</x>
+      <y>210</y>
+      <w>160</w>
+      <h>30</h>
+    </coordinates>
+    <panel_attributes>Account (160 bits)</panel_attributes>
+    <additional_attributes/>
+  </element>
+  <element>
+    <id>Text</id>
+    <coordinates>
+      <x>640</x>
+      <y>210</y>
+      <w>40</w>
+      <h>30</h>
+    </coordinates>
+    <panel_attributes>...</panel_attributes>
+    <additional_attributes/>
+  </element>
+  <element>
+    <id>Relation</id>
+    <coordinates>
+      <x>40</x>
+      <y>250</y>
+      <w>390</w>
+      <h>50</h>
+    </coordinates>
+    <panel_attributes>lt=.</panel_attributes>
+    <additional_attributes>10.0;10.0;10.0;30.0;370.0;30.0;370.0;10.0</additional_attributes>
+  </element>
+  <element>
+    <id>Text</id>
+    <coordinates>
+      <x>80</x>
+      <y>290</y>
+      <w>260</w>
+      <h>30</h>
+    </coordinates>
+    <panel_attributes>Path step</panel_attributes>
+    <additional_attributes/>
+  </element>
+  <element>
+    <id>Relation</id>
+    <coordinates>
+      <x>450</x>
+      <y>90</y>
+      <w>60</w>
+      <h>60</h>
+    </coordinates>
+    <panel_attributes>lt=&lt;&lt;-</panel_attributes>
+    <additional_attributes>10.0;10.0;10.0;40.0;40.0;40.0</additional_attributes>
+  </element>
+  <element>
+    <id>Text</id>
+    <coordinates>
+      <x>490</x>
+      <y>120</y>
+      <w>180</w>
+      <h>30</h>
+    </coordinates>
+    <panel_attributes>More paths</panel_attributes>
+    <additional_attributes/>
+  </element>
+  <element>
+    <id>Text</id>
+    <coordinates>
+      <x>490</x>
+      <y>300</y>
+      <w>130</w>
+      <h>30</h>
+    </coordinates>
+    <panel_attributes>More path steps</panel_attributes>
+    <additional_attributes/>
+  </element>
+  <element>
+    <id>Relation</id>
+    <coordinates>
+      <x>610</x>
+      <y>230</y>
+      <w>60</w>
+      <h>100</h>
+    </coordinates>
+    <panel_attributes>lt=&lt;&lt;-</panel_attributes>
+    <additional_attributes>40.0;10.0;40.0;80.0;10.0;80.0</additional_attributes>
+  </element>
+  <element>
+    <id>Text</id>
+    <coordinates>
+      <x>460</x>
+      <y>20</y>
+      <w>180</w>
+      <h>30</h>
+    </coordinates>
+    <panel_attributes>"Continue" byte</panel_attributes>
+    <additional_attributes/>
+  </element>
+  <element>
+    <id>Relation</id>
+    <coordinates>
+      <x>410</x>
+      <y>20</y>
+      <w>60</w>
+      <h>70</h>
+    </coordinates>
+    <panel_attributes>lt=&lt;&lt;-</panel_attributes>
+    <additional_attributes>10.0;50.0;10.0;10.0;40.0;10.0</additional_attributes>
+  </element>
+  <element>
+    <id>Text</id>
+    <coordinates>
+      <x>640</x>
+      <y>20</y>
+      <w>100</w>
+      <h>30</h>
+    </coordinates>
+    <panel_attributes>"End" byte</panel_attributes>
+    <additional_attributes/>
+  </element>
+  <element>
+    <id>Relation</id>
+    <coordinates>
+      <x>670</x>
+      <y>40</y>
+      <w>60</w>
+      <h>60</h>
+    </coordinates>
+    <panel_attributes>lt=&lt;&lt;-</panel_attributes>
+    <additional_attributes>10.0;40.0;40.0;40.0;40.0;10.0</additional_attributes>
+  </element>
+</diagram>
diff --git a/content/references/rippled-api/api-conventions/serialization.md b/content/references/rippled-api/api-conventions/serialization.md
index 1c58b75068..9fe463a432 100644
--- a/content/references/rippled-api/api-conventions/serialization.md
+++ b/content/references/rippled-api/api-conventions/serialization.md
@@ -136,14 +136,14 @@ Transaction instructions may contain fields of any of the following types:
 
 In addition to all of the above field types, the following types may appear in other contexts, such as [ledger objects](ledger-object-types.html) and [transaction metadata](transaction-metadata.html):
 
-| Type Name     | Type Code | Variable-Length? | Description                   |
-|:--------------|:----------|:-----------------|:------------------------------|
-| Transaction   | 10001     | No               | A "high-level" type containing an entire [transaction](transaction-formats.html). |
-| LedgerEntry   | 10002     | No               | A "high-level" type containing an entire [ledger object](ledger-object-types.html). |
-| Validation    | 10003     | No               | A "high-level" type used in peer-to-peer communications to represent a validation vote in the [consensus process](consensus.html). |
-| Metadata      | 10004     | No               | A "high-level" type containing [metadata for one transaction](transaction-metadata.html). |
-| [UInt64][]    | 3         | No               | A 64-bit unsigned integer. This type does not appear in transaction instructions, but several  use fields of this type. |
-| [Vector256][] | 19        | Yes              | This type does not appear in transaction instructions, but the [Amendments ledger object](amendments-object.html)'s `Amendments` field uses this to represent which [amendments](amendments.html) are currently enabled. |
+| Type Name   | Type Code | Variable-Length? | Description                     |
+|:------------|:----------|:-----------------|:--------------------------------|
+| Transaction | 10001     | No               | A "high-level" type containing an entire [transaction](transaction-formats.html). |
+| LedgerEntry | 10002     | No               | A "high-level" type containing an entire [ledger object](ledger-object-types.html). |
+| Validation  | 10003     | No               | A "high-level" type used in peer-to-peer communications to represent a validation vote in the [consensus process](consensus.html). |
+| Metadata    | 10004     | No               | A "high-level" type containing [metadata for one transaction](transaction-metadata.html). |
+| [UInt64][]  | 3         | No               | A 64-bit unsigned integer. This type does not appear in transaction instructions, but several ledger objects use fields of this type. |
+| Vector256   | 19        | Yes              | This type does not appear in transaction instructions, but the [Amendments ledger object](amendments-object.html)'s `Amendments` field uses this to represent which [amendments](amendments.html) are currently enabled. |
 
 
 ### AccountID Fields
@@ -219,12 +219,12 @@ The following example shows the serialization format for an object (a single `Me
 
 The `Paths` field of a cross-currency [Payment transaction][] is a "PathSet", represented in JSON as an array of arrays. For more information on what paths are used for, see [Paths](paths.html).
 
-A PathSet is serialized as each individual path in sequence. Each complete path is followed by a byte that indicates what comes next:
+A PathSet is serialized as **one or more** individual paths in sequence. Each complete path is followed by a byte that indicates what comes next:
 
 - `0xff` indicates another path follows
 - `0x00` indicates the end of the PathSet
 
-Each path consists of a set of path steps in order. Each step starts with a **type** byte, followed by one or more fields describing the path step. The type indicates which fields are present in that path step through bitwise flags. (For example, the value `0x11` indicates changing both currency and issuer.) If more than one field is present, the fields are always placed in a specific order.
+Each path consists of **one or more** path steps in order. Each step starts with a **type** byte, followed by one or more fields describing the path step. The type indicates which fields are present in that path step through bitwise flags. (For example, the value `0x30` indicates changing both currency and issuer.) If more than one field is present, the fields are always placed in a specific order.
 
 The following table describes the possible fields and the bitwise flags to set in the type byte to indicate them:
 
@@ -242,6 +242,10 @@ The AccountIDs in the `account` and `issuer` fields are presented _without_ a va
 
 Each step is followed directly by the next step of the path. As described above, last step of a path is followed by either `0xff` (if another path follows) or `0x00` (if this ends the last path).
 
+The following example shows the serialization format for a PathSet:
+
+![PathSet is several paths each followed by a continue or end byte; each path is several path steps consisting of a type byte and one or more 160-bit fields based on the type byte](img/serialization-pathset.png)
+
 
 ### UInt Fields
 [UInt8]: #uint-fields
@@ -254,3 +258,8 @@ The XRP Ledger has several unsigned integer types: UInt8, UInt16, UInt32, and UI
 When representing these fields in JSON objects, most are represented as JSON numbers by default. One exception is UInt64, which is represented as a string because some JSON decoders may try to represent these integers as 64-bit "double precision" floating point numbers, which cannot represent all distinct UInt64 values with full precision.
 
 Another special case is the `TransactionType` field. In JSON, this field is conventionally represented as a string with the name of the transaction type, but in binary, this field is a UInt16. The `TRANSACTION_TYPES` object in the [definitions file](#definitions-file) maps these strings to specific numeric values.
+
+<!--{# common link defs #}-->
+{% include '_snippets/rippled-api-links.md' %}			
+{% include '_snippets/tx-type-links.md' %}			
+{% include '_snippets/rippled_versions.md' %}
diff --git a/img/serialization-pathset.png b/img/serialization-pathset.png
new file mode 100644
index 0000000000000000000000000000000000000000..2f1d528f0f4c2a8ed2c9b386444e37c0ef939b10
GIT binary patch
literal 16722
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
Sn>fO4%1SEUD!gI*=>Gtg;~<Iv

literal 0
HcmV?d00001