About ◈ Prerequisites ◈ Getting started ◈ Tutorial ◈ Supporting the project ◈ Joining the discussion
This SDK allows building applications with Zebra Devices in combination with the IOTA Distributed Ledger Technology. It is composed of the following modules:
-
Identity Enabler. Provides all the scaffolding structured around reference applications that facilitate the creation of solutions that exploit IOTA Decentralized Identities in different domains (Personal identity and health passports, Organizational Identities and Device Identities in the Global Trade and Supply Chain domain).
-
EPCIS 2.0 Enabler. Adds the capability to record GS1 EPCIS 2.0 events directly from Zebra Devices. Those events can be stored on distributed datastores and anchored immutably to the IOTA Distributed Ledger. As a result, supply chain participants, in combination with the Identity Enabler, can share authenticated, trusted, verifiable and immutable data about business processes. (This enabler will come out in Q2 2022).
The SDK uses Web Technologies for the user interface of the reference applications. In particular, the applications are coded in TypeScript, using the Svelte framework. To package the Web Applications as Android applications, the Capacitor framework is used. That means that you can run these applications in your local browser as Web Applications or in your Android device or emulator.
Specific prerequisites are:
- Node.js and npm.
- Android Studio and related Android development tools such as adb.
- Ideally a Zebra Device with DataWedge such as the TC21.
- DataWedge profiles for the reference applications. You can download and import them from here.
For the Identity Enabler go to the identity-enabler folder and there you will find three different mobile applications:
- Holder Application which allows generating and presenting credentials using data matrix codes.
- Verifier Application which allows verifying credentials.
- Device Onboarding Application which allows to onboard devices and assign decentralized identities.
If you want to run the applications as Android application, for instance the Holder application, you just need to:
cd holder-mobile-app
npm install
npm run android
Afterwards the Web application code will be compiled and generated. Then, if your Android Studio is present and configured on your local machine automatically a new project with the application will be open. You can then compile and run your Android application.
If you want to run the applications as local Web application, for instance the Verifier Application, you just need to:
cd verifier-mobile-app
npm install
npm run build
npm run start:dev
Then open your browser on http://localhost:5001
for the Holder App, http://localhost:5002
for the Verifier App, and http://localhost:5003
for the Device ID App.
The applications are optimized for working with the native scanning capabilities of Zebra devices (Camera Scanner or 2D Barcode Scanner). However you can also use a regular Android's device camera or PC camera provided it has a good resolution.
To gain a better understanding, an in depth tutorial is available on the IOTA Wiki.
If this project has been useful to you and you feel like contributing, consider submitting a bug report, feature request or a pull request.
If you want to get involved in the community, need help with getting set up, have any issues or just want to discuss IOTA, Distributed Ledger Technology (DLT), and Zebra Technologies with other people, feel free to join our Discord.