IOP SDK

This package contains Dart tools needed to interact with IOP SSI (project Morpheus) and DNS (project Coeus) and create awesome decentralized apps. For more info please visit the IOP Developer Portal.

This SDK is a work in progress and its convenience improves over time.

Table of Contents <!-- omit in toc -->

Prerequisites

  • Dart 2.12.0+
  • Linux / MacOS

Install

Add this to your package's pubspec.yaml file:

dependencies:
  iop_sdk: ^5.0.0

Architecture

Dynamic Libraries and OS Support

Most of the codebase is implemented in Rust and this Dart library uses Dart FFI to communicate with a shared dynamic library generated from Rust using its C bindings. The native library binary is loaded dynamically on demand.

Currently, we support only Linux, MacOS and Android, but we are also preparing iOS and Windows support as well.

Memory Management

As Dart finalizers are not ready yet, only manual memory management is available. Consequently, some classes of this package are extended from Disposable and you have to manually dispose their instances when not using those objects anymore. This is common for Android developers, but might not be that evident for others.

Modules

Crypto

Cryptographic primitives mostly for creating a vault and generating a large set of purpose-specified private keys for Hydra addresses, SSI DIDs, etc. It also contains tools to sign and validate signatures based on DIDs with a managable keyset and easily handle JWT tokens.

Entities

Authority

All interfaces and types that are needed to communicate with an Authority endpoint. Authorities have a public and a private API as described below.

See more about the Authorities API here

Public API

The Public API is available without authentication, mostly used by clients of the given authority's services.

Private API

The Private API is available with authentication only and used mostly by internal entities (e.g. clerks) of an authority.

Inspector

All interfaces and types needed to communicate with an Inspector endpoint. See more about the Inspector API here.

Verifier

All interfaces and types needed to communicate with a Verifier endpoint. See more about the Verifier API here.

Layer1

SSI's API consists of two main parts. Layer-1 and layer-2. Layer-1 performs write operations that change the blockchain's state, while layer-2 executes queries (i.e. read operations without touching the state).

This module contains all Dart classes and utils needed to interact with the SSI Layer-1 API.

For more detailed examples please visit our tutorial center.

Layer2

This module contains all Dart classes and utils needed to interact with the Layer-2 API.

For more detailed examples please visit our tutorial center.

SSI

Contains all interfaces needed to use the SSI (project Morpheus) protocol including all entities defined in the specification.

Development

# Build json converters
$ pub run build_runner build --delete-conflicting-outputs
# Run tests
$ pub run test --concurrency=1 # note: the test must run on a single thread becaus of nonce generation
# Run Analyzer
$ dartanalyzer .

Contributing

Feel free to open issues and pull requests in this repository. By contributing you agree to transfer all intellectual property from your changes to the Decentralized Society Foundation, Panama, copyright owner of this code. To avoid losing precious time you spend on coding, you could open an issue first and discuss what you are up to before forking and sending us a PR.

Small note: If editing the README, please conform to the standard-readme specification.

License

LGPL-3.0 or later © 2020 Decentralized Society Foundation, PA

Libraries

authority
crypto
entities
inspector
layer1
layer2
network
scalar_box
ssi
utils
verifier