Rippling redux#2856
Conversation
Streamline the Rippling topic for clarity.
tequdev
added
the
needs japanese translation
amarantha-k
requested review from
mDuo13 and
maria-robobug
and removed request for
oeggert
| Rippling can involve several accounts as the XRPL server finds a path to transfer the funds. For example, the funds might flow between two issuer accounts that have a trust line between them. | ||
|
|
||
| For example: | ||
| [](/docs/img/cpt-rippling5.png) |
There was a problem hiding this comment.
There's nothing wrong with this scenario, but I think a more important scenario to illustrate is the one where rippling flows through a holder of both issuers' tokens, as shown in the original diagram #3. Laid out like you have the others, the diagram would be shaped kind of like an "M" (or upside-down-W).
One little detail that the current diagram elides is that Holder A is sending "USD issued by issuer A" and Holder B is receiving "USD issued by issuer B"—technically two different tokens which can have different properties like transfer fees, even though they have the same currency code (rippling can only occur if the currency code is the same). In my experience, this simplification tends to confuse people, who think that all USD issued in the XRPL is the same. So it might be worth adding that detail to the diagram somehow. Conventionally, we've written "USD.issuerA" to represent this type of thing.
Co-authored-by: Rome Reginelli <rome@ripple.com>
Co-authored-by: Rome Reginelli <rome@ripple.com>
Co-authored-by: Rome Reginelli <rome@ripple.com>
Forgot to change the balance for the sender and receiver.
mDuo13
left a comment
mDuo13
left a comment
There was a problem hiding this comment.
Looks good with the changes, with one important note on terminology.
| Tokens might also flow through intermediary gateway accounts to reach a holder. | ||
|
|
||
| [{% inline-svg file="/docs/img/noripple-05.svg" /%}](/docs/img/noripple-05.svg "Charlie --($10)-- Institution A --($1, No Ripple)-- Emily --($100, No Ripple)-- Institution B --($2)-- Daniel") | ||
| [](/docs/img/cpt-rippling6.png) |
There was a problem hiding this comment.
I worry that using the term "gateway" here will confuse people who come across legacy content that uses the term "gateway" differently. From 2013-2016 or so the term "gateway" was widely used in the XRPL community and in Ripple's communications to mean, essentially, "stablecoin issuer."
Perhaps "intermediary" is better here (and in the diagram) to dodge that confusion. The key thing here is that the intermediary is also just an ordinary holder except they allow rippling, not necessarily a special business or anything.
There was a problem hiding this comment.
There's a wider discussion on this - I agree that we need a term for an account that allows rippling but is not an issuer. I want to make it clear that Holders never allow rippling, Exchanges allow rippling, and Issuers allow rippling, then document the basic configurations for each of those accounts. We can pick the term for the intermediary/exchange user after the holidays.
3 participants
Streamline the Rippling topic for clarity.