README.md

March 16, 2020 ยท View on GitHub

Indy SDK for Java

This Java wrapper currently requires Java 8 (e.g. the openjdk-8-jdk package in Debian/Ubuntu).

Pull requests welcome!

How to install

In your maven project add to pom.xml file next content:

  1. Inside repositories tag block add:

    sovrin https://repo.sovrin.org/repository/maven-public

  2. Inside dependencies tag block add:

    org.hyperledger indy 1.14.2

Note that before you can use java wrapper you must install c-callable SDK. See the section "Installing the SDK" in the Indy SDK documentation

How to build

First, build the native "indy" library at https://github.com/hyperledger/indy-sdk:

cargo build

Then copy the resulting libindy.so to ./lib/.

Then run

mvn clean install

Example use

For the main workflow examples check test folder: https://github.com/hyperledger/indy-sdk/tree/master/wrappers/java/src/test/java/org/hyperledger/indy/sdk

Logging

The Java wrapper uses slf4j as a facade for various logging frameworks, such as java.util.logging, logback and log4j.

Troubleshooting

If your application that uses libindy crashes with a Null Pointer Exception then probably the libindy shared library could not be loaded properly. If you have build libindy from source then either put the resulting shared library where your operating system searches for shared libraries or set appropriate environment variables to help the OS's loader to find them.

On Ubuntu either copy libindy.so to /usr/local/lib or set LD_LIBRARY_PATH to the directory that contains libindy.so.

export LD_LIBRARY_PATH=<path to libindy.so>