File List
Not logged in

The union of all files from all check-ins in directory wiki_references/2017/software/banking/Interledger/src_from_GitHub/the_repository_clones/java-ilp-ledger-adaptor-rest-spring   [history]

Interledger REST Ledger Adaptor (Java) CircleCI

Interledger ledger adaptor for ledgers using a REST API.

Currently adheres to the API of the Five Bells Ledger with a view to support for the Common REST API when it is released.



The project is setup to find project dependencies in the same directory so the easiest way to work on the code is to fetch the dependencies as-is from GitHub.

    $ git checkout
    $ git checkout
    $ git checkout


The project supports both Gradle and Maven build tools. A special Gradle task is defined which will generate a POM file for Maven.

    $ gradle writePom


The project uses Checkstyle for consitency in code style. We use the Google defined Java rules which can be configured for common IDE's by downloading configuration files from the GitHub repo.


The library adheres to the interfaces in the Interledger Protocol Core library. The REST adaptor is instantiated with a RestTemplateBuilder and the base URL of the ledger.

    //TODO Code sample

The authentication details of the user can be set directly on the RestTemplateBuilder or passed in via setAccountAuthToken(UsernamePasswordAuthenticationToken).

When connect() is called the adaptor will fetch the ledger meta-data and then use the data collected to establish a Websocket connection with the ledger.

TODO list

[x] Fix Checkstyle issues [x] Add tests [ ] Investigate async HTTP requests [ ] Ensure Websocket reconnects and re-establishes subscriptions


Any contribution is very much appreciated! [![gitter][gitter-image]][gitter-url]


This code is released under the Apache 2.0 License. Please see LICENSE for the full text.