Deep dive into Interledger: Understanding the Interledger ecosystem

Lucian Trestioreanu, Cyril Cassagnes, Radu StatearXiv 2022 · OpenReview

Abstract

At the technical level, the goal of Interledger is to provide an architecture and a minimal set of protocols to enable interoperability between any value transfer systems. The Interledger protocol is a protocol for inter-blockchain payments which can also accommodate FIAT currencies. To understand how it is possible to achieve this goal, several aspects of the technology require a deeper analysis. For this reason, in our journey to become knowledgeable and active contributors we decided to create our own test-bed on our premises. By doing so, we noticed that some aspects are well documented but we found that others might need more attention and clarification. Despite a large community effort, the task to keep information on a fast evolving software ecosystem up-to-date is tedious and not always the main priority for such a project. The purpose of this tutorial is to guide, through several examples and hands-on activities, community members who want to engage at different levels. The tutorial consolidates all the relevant information from generating a simple payment to ultimately creating a test-bed with the Interledger protocol suite between Ripple and other distributed ledger technologies.

Introduction

While the promise of "the Internet of Value" is compelling, the technical reality of connecting disparate blockchains and FIAT systems is fraught with complexity. A significant "documentation gap" exists: information on the Interledger Protocol (ILP) is often sparse, disseminated across various forums and GitHub repositories, and becomes outdated quickly due to the ecosystem's rapid evolution. For developers and researchers, this makes the barrier to entry for creating test-beds or contributing to the protocol prohibitively high. This paper tackles that challenge by providing a panoramic understanding of how connectors, ledgers, and customer applications interconnect.

Architectural Mapping and Protocol Stack

A core contribution of this work is the alignment of the Interledger protocol suite with the traditional Internet architecture (OSI model). This mapping provides a conceptual framework for understanding how value moves across disparate networks.

The Interledger protocol stack across sender, connector, and receiver nodes.

As illustrated in the architecture above, the stack is organized into distinct layers:

  • Application Layer: Utilizes the Simple Payment Setup Protocol (SPSP) to exchange payment details.
  • Transport Layer: Employs protocols like STREAM (or its predecessor PSK) to manage the end-to-end delivery of money and data, handling packetization and retransmission.
  • Interledger Layer: The ILP layer acts as the network layer, responsible for routing packets across multiple hops.
  • Ledger Layer: Uses plugins (like BTP) to interface with underlying ledgers (L1, L2, LN), facilitating the actual movement of funds on specific blockchains or payment networks.

System Construction and Methodology

The authors built a private, independent network to validate these architectural concepts. This environment utilized the XRP Ledger (via rippled servers) and the Ethereum Ledger (via Ganache). The implementation focused on several key components:

  • Connectors: These act as the "market makers" of the ecosystem. By holding wallets on two different networks (e.g., XRP and ETH), a connector can accept one currency and pay out another, charging a small fee for the service.
  • Customer Apps: Tools like Moneyd function as a "home router" for ILP. Just as a home router provides local devices access to the Internet, Moneyd provides local applications access to the Interledger by connecting to an upstream Interledger Service Provider (ILSP).
  • Hashed Time Lock Agreements (HTLA): ILP v4 uses a chaining of HTLAs to ensure that the sender only loses money if the receiver actually gets paid, minimizing risk across the chain.

Key Insights

  • ILP is Not a Blockchain: ILP is a routing protocol, not a ledger or a token. It doesn't move money directly; it coordinates a chain of bilateral transfers between peers who trust each other.
  • Bilateral Balances and Settlement: Value transfer happens off-ledger through adjustments to bilateral balances. On-ledger "settlement" only occurs when these balances hit a certain threshold, making the system highly scalable and reducing transaction costs.
  • Currency Agnosticism: The protocol is designed to be indifferent to the underlying asset, allowing for seamless cross-currency flows.

Results and Future Work

The research successfully demonstrated a "STREAM" payment where value originated on the XRP ledger and was received on the Ethereum ledger. By providing a "golden path" for configuration—including specific rippled.cfg settings and Moneyd advanced configurations—this guide lowers the barrier for future developers.

However, the study also noted that the app ecosystem maturity varies, and the project is currently moving away from plugin-based architectures toward a new "Settlement Engine" model. Future research will focus on @Coil/Rafiki, a newer, more modular connector architecture, and addressing technical challenges like time synchronization between machines in private networks to prevent packet rejection.

Summary updated

Abstract

At the technical level, the goal of Interledger is to provide an architecture and a minimal set of protocols to enable interoperability between any value transfer systems. The Interledger protocol is a protocol for inter-blockchain payments which can also accommodate FIAT currencies. To understand how it is possible to achieve this goal, several aspects of the technology require a deeper analysis. For this reason, in our journey to become knowledgeable and active contributors we decided to create our own test-bed on our premises. By doing so, we noticed that some aspects are well documented but we found that others might need more attention and clarification. Despite a large community effort, the task to keep information on a fast evolving software ecosystem up-to-date is tedious and not always the main priority for such a project. The purpose of this tutorial is to guide, through several examples and hands-on activities, community members who want to engage at different levels. The tutorial consolidates all the relevant information from generating a simple payment to ultimately creating a test-bed with the Interledger protocol suite between Ripple and other distributed ledger technologies.
BibTeX
@misc{trestioreanu2022deep,
  author = {Lucian Trestioreanu and Cyril Cassagnes and Radu State},
  title = {{Deep dive into Interledger: Understanding the Interledger ecosystem}},
  year = {2022},
  eprint = {2206.10446},
  archivePrefix = {arXiv},
  url = {https://arxiv.org/abs/2206.10446},
}
Figure