Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/hyperledger/indy-sdk

indy-sdk
https://github.com/hyperledger/indy-sdk

aries hacktoberfest hyperledger-indy ssi zkp

Last synced: 3 months ago
JSON representation

indy-sdk

Awesome Lists containing this project

README 

        
# Indy SDK - Deprecated

![logo](https://raw.githubusercontent.com/hyperledger/indy-node/master/collateral/logos/indy-logo.png)



## :warning: Deprecation Notice :warning:

The Indy SDK has been deprecated in favor of the Indy and Aries shared libraries.  Please use the following libraries and projects to replace your use of the Indy SDK.



### [indy-vdr](https://github.com/hyperledger/indy-vdr)

A module for interacting with the [Indy Node](https://github.com/hyperledger/indy-node) ledger.



### [aries-askar](https://github.com/hyperledger/aries-askar)

A secure (encrypted at rest) storage and a key management service suitable for use with [Hyperledger Aries] agents and possibly other digital trust agents.  Askar is a replacement implementation (with lessons learned!) of the [indy-wallet] part of the [Hyperledger Indy SDK]. Askar has been demonstrated to be more performant and stable than the Indy SDK when under comparable load.



### [anoncreds-rs](https://github.com/hyperledger/anoncreds-rs)

Rust library and reference implementation of the [Anoncreds V1.0 specification](https://hyperledger.github.io/anoncreds-spec/).  Supporting ledger agnostic anoncreds.



### [indy-cli-rs](https://github.com/hyperledger/indy-cli-rs)

The a feature parity replacement for the `indy-cli` from the `indy-sdk`.



[Hyperledger Aries]: https://www.hyperledger.org/projects/aries

[indy-wallet]: https://github.com/hyperledger/indy-sdk/tree/main/libindy/indy-wallet

[Hyperledger Indy SDK]: https://github.com/hyperledger/indy-sdk



## About the Indy SDK

This is the official SDK for [Hyperledger Indy](https://www.hyperledger.org/projects),

which provides a distributed-ledger-based foundation for [self-sovereign identity](https://sovrin.org). Indy provides a software ecosystem for private, secure, and powerful identity, and the Indy SDK enables clients for it.

The major artifact of the SDK is a C-callable

library; there are also convenience wrappers for various programming languages and Indy CLI tool.



All bugs, stories, and backlog for this project are managed through [Hyperledger's Jira](https://jira.hyperledger.org/secure/RapidBoard.jspa)

in project IS (note that regular Indy tickets are in the INDY project instead...). Also, make sure to join

us on [Hyperledger's Rocket.Chat](https://chat.hyperledger.org/) at #indy-sdk to discuss. You will need a Linux Foundation login to get access to these channels



## Understanding Hyperledger Indy



If you have just started learning about self-sovereign identity, here are some resources to increase your understanding:



* This extended tutorial introduces Indy, explains how the whole ecosystem works, and how the

functions in the SDK can be used to construct rich clients: [Indy-SDK Getting-Started Guide](docs/getting-started/indy-walkthrough.md)



    * **Please take note** that this tutorial doesn't cover how sides set up a connection and exchange messages.

    How this communication channel can be built you can find at [Aries](https://github.com/hyperledger/aries) project which describes it in great details.



* Hyperledger Indy Working Group calls happen every Thursday at 8amPT, 9amMT, 11amET, 4pmBST. Add to your calendar and join from any device: https://zoom.us/j/232861185



* A recent webinar explaining self-sovereign identity using Hyperledger Indy and Sovrin: [SSI Meetup Webinar](https://youtu.be/RllH91rcFdE?t=4m30s)



* Visit the main resource for all things "Indy" to get acquainted with the code base, helpful resources, and up-to-date information: [Hyperledger Wiki-Indy](https://wiki.hyperledger.org/display/indy/).



* You may also want to look at the [older guide](https://github.com/hyperledger/indy-node/blob/stable/getting-started.md)

that explored the ecosystem via command line. That material is being

rewritten but still contains some useful ideas.



## Items included in this SDK



### libindy



The major artifact of the SDK is a C-callable library that provides the basic building blocks for

the creation of applications on the top of [Hyperledger Indy](https://www.hyperledger.org/projects/hyperledger-indy).

It is available for most popular desktop, mobile and server platforms.



### Libindy wrappers



A set of libindy wrappers for developing Indy-based applications in your favorite programming language.

Indy SDK provides libindy wrappers for the following programming languages and platforms:



* [Java](wrappers/java/README.md)

* [Python](wrappers/python/README.md)

* [iOS](wrappers/ios/README.md)

* [NodeJS](wrappers/nodejs/README.md)

* [.Net](wrappers/dotnet/README.md)

* [Rust](wrappers/rust/README.md)



### Indy CLI



[Indy CLI](cli/README.md) is the official command line interface that helps Indy developers and administrators.



### Libnullpay



[Libnullpay](/libnullpay/README.md) is a libindy plugin that can be used for development of applications that use the Payments API of Indy SDK.



### Libvcx

[Libvcx](/vcx/README.md) is a c-callable library built on top of libindy that provides a high-level

credential exchange protocol. It simplifies creation of agent applications and provides

better agent-2-agent interoperability for [Hyperledger Indy](https://www.hyperledger.org/projects/hyperledger-indy)

infrastructure.



This library is currently in an **experimental** state and is not part of official releases.



### Libvcx wrappers



A set of libvcx wrappers for developing vcx-based applications in your favorite programming language.



Indy SDK provides libvcx wrappers for the following programming languages and platforms:



* [Java](/vcx/wrappers/java/README.md)

* [Python](/vcx/wrappers/python3/README.md)

* [iOS](vcx/wrappers/ios/README.md)

* [NodeJS](/vcx/wrappers/node/README.md)



These wrappers are currently in **experimental** state and it is not part of official releases.



##### Example use

- For the main workflow example check [VCX Python demo](https://github.com/hyperledger/indy-sdk/tree/master/vcx/wrappers/python3/demo).

- Another libvcx example is available as [VCX NodeJS demo](https://github.com/hyperledger/indy-sdk/tree/master/vcx/wrappers/node#run-demo).

- For mobile see [iOS Demo project](https://github.com/sktston/vcx-demo-ios)



### LibVCX Agency

LibVCX can be used with

[mediator agency](https://github.com/hyperledger/aries-rfcs/blob/master/concepts/0046-mediators-and-relays/README.md)

which enables asynchronous communication between 2 parties.

- [Dummy Cloud Agent](/vcx/dummy-cloud-agent/README.md) is simple implementation of VCX compatible Cloud Agent.

The main purpose of this implementation is VCX testing, demos and documentation of VCX protocol.

- [NodeVCXAgency](https://github.com/AbsaOSS/vcxagencynode) is alternative implementation in NodeJS.



## How-To Tutorials

Short, simple tutorials that demonstrate how to accomplish common tasks

are also available. See the [docs/how-tos](docs/how-tos) folder.



1. [Write a DID and Query Its Verkey](docs/how-tos/write-did-and-query-verkey/README.md)

2. [Rotate a Key](docs/how-tos/rotate-key/README.md)

3. [Save a Schema and Cred Def](docs/how-tos/save-schema-and-cred-def/README.md)

4. [Issue a Credential](docs/how-tos/issue-credential/README.md)

5. [Negotiate a Proof](docs/how-tos/negotiate-proof/README.md)

6. [Send a Secure Message](docs/how-tos/send-secure-msg/README.md)



## Installing the SDK

### Release channels

The Indy SDK release process defines the following release channels:



* `master` - development builds for each push to master branch.

* `rc` - release candidates.

* `stable` - stable releases.



Please refer to our [release workflow](docs/contributors/release-workflow.md) for more details.



### Ubuntu based distributions (Ubuntu 16.04 and 18.04)

It is recommended to install the SDK packages with APT:



    sudo apt-get install ca-certificates -y

    sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys CE7709D068DB5E88

    sudo add-apt-repository "deb https://repo.sovrin.org/sdk/deb (xenial|bionic) {release channel}"

    sudo apt-get update

    sudo apt-get install -y {library}



* {library} must be replaced with libindy, libnullpay, libvcx or indy-cli.

* (xenial|bionic) xenial for 16.04 Ubuntu and bionic for 18.04 Ubuntu.

* {release channel} must be replaced with master, rc or stable to define corresponded release channel.

Please See the section "Release channels" above for more details.



### Windows



1. Go to `https://repo.sovrin.org/windows/{library}/{release-channel}.`

2. Download last version of library.

3. Unzip archives to the directory where you want to save working library.

4. After unzip you will get next structure of files:



* `Your working directory for libindy`

    * `include`

        * `...`

    * `lib`

        * `indy.dll`

        * `libeay32md.dll`

        * `libsodium.dll`

        * `libzmq.dll`

        * `ssleay32md.dll`



`include` contains c-header files which contains all necessary declarations

that may be need for your applications.



`lib` contains all necessary binaries which contains libindy and all it's dependencies.

 `You must add to PATH environment variable path to lib`. It's necessary for dynamic linkage

 your application with libindy.



{release channel} must be replaced with master, rc or stable to define corresponded release channel.

See section "Release channels" for more details.



{library} must be replaced with libindy, libnullpay, libvcx or indy-cli.



### iOS



See [wrapper iOS install documentation](wrappers/ios/README.md "How to install").



### Android



1. Go to `https://repo.sovrin.org/android/{library}/{release-channel}`.

2. 3 architecture are supported as of now arm,arm64 and x86.

3. Download latest version of library.

4. Unzip archives to the directory where you want to save the `.so` files.

5. After unzip you will get next structure of files:



* `Your working directory for libindy`

    * `include`

        * `...`

    * `lib`

        * `libindy.so`

        * `libindy_shared.so`

        * `libindy.a`



`include` contains c-header files which contains all necessary declarations

that may be need for your applications.



`lib` contains three types of binaries.

 * `libindy.so` - This is a shared library which is statically linked with all the depenedencies.

 You dont need to sidelaod other dependencies like zmq, sodium and openssl to android app if you use this.



 * `libindy_shared.so` - This is pure shared library. It is not dynamically linked to its dependencies.

 You need to sideload the binaries with its dependencies. You can download the needed pre-built dependencies from [here](https://github.com/evernym/indy-android-dependencies/tree/v1.0.2)

    * Rename this library to `libindy.so` before loading it into the app. This will help you in having the compatibility with existing wrappers.



 * `libindy.a` - This is a static library, which is compiled with NDK.



{library} must be replaced with libindy, libnullpay or libvcx.



 [How to use instructions.](https://github.com/hyperledger/indy-sdk/blob/master/docs/build-guides/android-build.md#usage)



{release channel} must be replaced with rc or stable to define corresponded release channel.

See section "Release channels" for more details.



 **Note** :



 - [WARNING] This library should be considered as experimental as currently unit tests are *not* executed in the CI phase.



### Centos



1. Go to `https://repo.sovrin.org/rpm/{library}/{release-channel}`.

2. Download and unzip the last version of library.

3. Install with `rpm -i library-version.rpm`.



{library} must be replaced with libindy, libnullpay, libvcx, indy-cli to define corresponded library.



{release channel} must be replaced with master, rc or stable to define corresponded release channel.

See section "Release channels" for more details.



### MacOS



1. Go to `https://repo.sovrin.org/macos/{library}/{release-channel}`.

2. Download the latest version of library.

3. Unzip archives to the directory where you want to save working library.

4. After unzip you will get next structure of files:



* `Your working directory`

    * `include` - contains c-header files which contains all necessary declarations that may be need for your applications.

        * `...`

    * `lib` - contains library binaries (static and dynamic).

        * `library.a`

        * `library.dylib`



5. Install dependent libraries: libsodium, zeromq, openssl. The dependent libraries should match the version with what you can find from ``otool -L libindy.dylib``.



You need add the path to lib folder to LIBRARY_PATH environment variable.



{library} must be replaced with libindy, libnullpay, libvcx or indy-cli to define corresponded library.



{release channel} must be replaced with master, rc or stable to define corresponded release channel.



## How to build Indy SDK from source



* [Ubuntu based distributions (Ubuntu 16.04)](docs/build-guides/ubuntu-build.md)

* [RHEL based distributions (Centos)](docs/build-guides/rhel-build.md)

* [Windows](docs/build-guides/windows-build.md)

* [MacOS](docs/build-guides/mac-build.md)

* [Android](docs/build-guides/android-build.md)



**Note:**

By default `cargo build` produce debug artifacts with a large amount of run-time checks.

It's good for development, but this build can be in 100+ times slower for some math calculation.

If you would like to analyse CPU performance of libindy for your use case, you have to use release artifacts (`cargo build --release`).



## How to start local nodes pool with docker

To test the SDK codebase with a virtual Indy node network, you can start a pool of local nodes using docker:



**Note: If you are getting a PoolLedgerTimeout error it's because the IP addresses in

cli/docker_pool_transactions_genesis and the pool configuration don't match.

Use method 3 to configure the IPs of the docker containers to match the pool.**



### 1) Starting the test pool on localhost

Start the pool of local nodes on `127.0.0.1:9701-9708` with Docker by running:



```

docker build -f ci/indy-pool.dockerfile -t indy_pool .

docker run -itd -p 9701-9708:9701-9708 indy_pool

```



### 2) Starting the test pool on a specific IP address

 Dockerfile `ci/indy-pool.dockerfile` supports an optional pool_ip param that allows

 changing ip of pool nodes in generated pool configuration.



 You can start the pool with e.g. with the IP address of your development machine's WIFI interface

 so that mobile apps in the same network can reach the pool.



 ```

 # replace 192.168.179.90 with your wifi IP address

 docker build --build-arg pool_ip=192.168.179.90 -f ci/indy-pool.dockerfile -t indy_pool .

 docker run -itd -p 192.168.179.90:9701-9708:9701-9708 indy_pool

 ```

 To connect to the pool the IP addresses in /var/lib/indy/sandbox/pool_transactions_genesis (in docker) and

 the pool configuration you use in your mobile app must match.



### 3) Starting the test pool on a docker network

 The following commands allow to start local nodes pool in custom docker network and access this pool

 by custom ip in docker network:



 ```

 docker network create --subnet 10.0.0.0/8 indy_pool_network

 docker build --build-arg pool_ip=10.0.0.2 -f ci/indy-pool.dockerfile -t indy_pool .

 docker run -d --ip="10.0.0.2" --net=indy_pool_network indy_pool

 ```

 Note that for Windows and MacOS this approach has some issues. Docker for these OS run in

 their virtual environment. First command creates network for container and host can't

 get access to that network because container placed on virtual machine. You must appropriate set up

 networking on your virtual environment. See the instructions for MacOS below.



### Docker port mapping on MacOS



If you use some Docker distribution based on Virtual Box you can use Virtual Box's

port forwarding future to map 9701-9709 container ports to local 9701-9709 ports.



If you use VMWare Fusion to run Docker locally, follow the instructions from

[this article](https://medium.com/@tuweizhong/how-to-setup-port-forward-at-vmware-fusion-8-for-os-x-742ad6ca1344)

and add the following lines to _/Library/Preferences/VMware Fusion/vmnet8/nat.conf_:



```

# Use these with care - anyone can enter into your VM through these...

# The format and example are as follows:

# = :

#8080 = 172.16.3.128:80

9701 = :9701

9702 = :9702

9703 = :9703

9704 = :9704

9705 = :9705

9706 = :9706

9707 = :9707

9708 = :9708

9709 = :9709

```

where  is your Docker host IP.



Docker machine needs to be rebooted after these changes.



## Wrappers documentation



The following [wrappers](docs/architecture/language-bindings.md) are tested and complete.



There is also active work on a wrapper for Go; visit

[#indy-sdk on Rocket.Chat](https://chat.hyperledger.org/channel/indy-sdk) for

details.



## Indy CLI documentation

* An explanation of how to install the official command line interface for that provides commands to manage wallets and interactions with the ledger: [Indy CLI](cli/README.md)



## How to migrate

The documents that provide necessary information for Libindy migrations.



* [v1.3.0 → v1.4.0](docs/migration-guides/migration-guide-1.3.0-1.4.0.md)

* [v1.4.0 → v1.5.0](docs/migration-guides/migration-guide-1.4.0-1.5.0.md)

* [v1.5.0 → v1.6.x](docs/migration-guides/migration-guide-1.5.0-1.6.0.md)

* [v1.6.0 → v1.7.x](docs/migration-guides/migration-guide-1.6.0-1.7.0.md)

* [v1.7.0 → v1.8.x](docs/migration-guides/migration-guide-1.7.0-1.8.0.md)

* [v1.8.0 → v1.9.x](docs/migration-guides/migration-guide-1.8.0-1.9.0.md)

* [v1.9.0 → v1.10.x](docs/migration-guides/migration-guide-1.9.0-1.10.0.md)

* [v1.10.0 → v1.11.x](docs/migration-guides/migration-guide-1.10.0-1.11.0.md)

* [v1.11.0 → v1.12.x](docs/migration-guides/migration-guide-1.11.0-1.12.0.md)

* [v1.12.0 → v1.13.x](docs/migration-guides/migration-guide-1.12.0-1.13.0.md)

* [v1.13.0 → v1.14.x](docs/migration-guides/migration-guide-1.13.0-1.14.0.md)

* [v1.14.0 → v1.15.x](docs/migration-guides/migration-guide-1.14.0-1.15.0.md)

* [v1.15.0 → v1.16.x](docs/migration-guides/migration-guide-1.15.0-1.16.0.md)



## How to Contribute

* We'd love your help; see these [HL Indy Wiki](https://wiki.hyperledger.org/display/indy/How+to+Contribute) and [slides on how to contribute](http://bit.ly/2ugd0bq).

* If you need to add a new call, read this [instruction](docs/how-tos/how-to-add-a-new-API-call.md).

* You may also want to read this info about [maintainers](MAINTAINERS.md) and our process.

* We use developer certificate of origin (DCO) in all hyperledger repositories,

  so to get your pull requests accepted, you must certify your commits by signing off on each commit.

  More information can be found in [Signing Commits](docs/contributors/signing-commits.md) article.



#### Notes

* Libindy implements multithreading approach based on **mpsc channels**.

If your application needs to use Libindy from multiple processes you should keep in mind the following restrictions:

    * Fork - duplicates only the main thread. So, child threads will not be duplicated.

      If any out-of-process requirements are possible, the caller must fork first **before any calls to Libindy**

      (otherwise the command from a child thread will hang). Fork is only available on Unix.

    * Popen - spawns a new OS level process which will create its own child threads. Popen is cross-platform.