One Core React Native SDK

A React Native library for decentralized digital identities and credentials.
Use it to hold or verify credentials via a multitude of technologies and protocols.

The SDK's SSI functionality is powered by the [Procivis One Core][core], a complete
solution capable of powering every element of the digital identity credential lifecycle.
See the [key features][key] and complete solution [architecture][archi].

Table of Contents

- How to use the One Core SDK
- Getting started
- Background
- eIDAS 2.0
- Interoperability and conformance
- Supported standards
- Support
- License

How to use the One Core React Native SDK

- Use this SDK to embed wallet capabilities into an existing app
- Use the [Procivis One Wallet][pow] for a free-standing solution that can be white-labeled
- Use the [One Core React Components][comp] library for UI elements for your digital wallet app

Getting started

$3

The fastest way to get started with the _Procivis One Wallet_ is to download the app
from the iOS or Android app stores and [join our Trial Environment][trial].
In the trial environment, you are given control of an organization on our server
solution, the _Procivis One Desk_, and can quickly begin issuing and verifying credentials.

$3

See our documentation:

- [SDK Reference][sdkref]
- [Docs home][docs]

$3

$ yarn add react-native-one-core

Add following to your app android/build.gradle:

``
...
allprojects {
repositories {
...

flatDir { dirs "$rootDir/../node_modules/react-native-one-core/android/libs" }
}
}
`

Usage

`typescript
import { initializeCore } from "react-native-one-core";
...
const ONE = await initializeCore();
await ONE.getVersion();
``

Background

Decentralized digital identities and credentials is an approach to identity that relocates
digital credentials from the possession and control of centralized authorities to the
digital wallet of the credentials holder. This architecture eliminates the need for the
user to "phone home" to use their credentials as well as the verifier to communicate to
the issuer via back-channels, keeping the wallet holder's interactions private between only
those parties directly involved in each interaction. This model of digital identity is
often referred to as Self-Sovereign Identity, or SSI.

eIDAS 2.0

If you want to provide an EUDI Wallet, _Procivis One_ provides production grade open
source components to get certified and connect your organization to the eIDAS 2.0 ecosystem.

!Procivis One in the eIDAS ARF

For an EUDI Wallet, use the [One Core React Native SDK][rncore] for embedding into
an existing app, or use the [Procivis One Wallet][pow] with adaptations to fit your
needs.

If you want to issue into an EUDI Wallet or offer services to an EUDI Wallet holder,
use the [Procivis One Core][core].

Interoperability and conformance

_Procivis One_ is built using open standards and tested to ensure
interoperability with different software vendors and across different international
regulatory ecosystems.

- W3C standards
- The W3C offers several test suites for standards conformance. See
the latest test results for _Procivis One_ at [canivc.com][canivc].
- ISO/IEC 18013-5 mDL
- _Procivis One_'s implementation of the ISO mDL standard is compatible with the
OpenWallet Foundation's verifier: _Procivis One_ can successfully issue mDL
credentials to a _Procivis One Wallet_, and these credentials can successfully
be verified by the OpenWallet Foundation's verifier. See the [OpenWallet Foundation libraries][owf].
- eIDAS 2.0; EUDI Wallet
- The EU Digital Wallet is developing [issuer][eudiwi] and [verifier][eudiwv] testing for
interoperability in mdoc and SD-JWT formats using OID4VC protocols. We follow the ongoing
development of the testing platform and regularly test against it.

We continue to look for more opportunities for interoperability testing as the standards
and regulations mature and harden.

Supported standards

$3

#### W3C VC

- [W3C Verifiable Credentials Data Model 2.0][vcdm] in the following variations:

| Securing mechanism | Supported representations | Supported proof/signature types |
| -------------------------------------------- | --------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [W3C Data Integrity Proofs][vcdi] (embedded) | [JSON-LD][jld] in Compacted Document Form |

• [W3C Data Integrity ECDSA Cryptosuites v1.0][ecd] / [ecdsa-rdfc-2019][ecd2019]
• [W3C Data Integrity EdDSA Cryptosuites v1.0][edd] / [eddsa-rdfc-2022][edd2022]
• [W3C Data Integrity BBS Cryptosuites v1.0][bbs] / [bbs-2023][bbs2023]

|
| [W3C VC-JOSE-COSE][jose] (enveloping) |

• [SD-JWT][sdjwt]
• [JWT][jw]

|

• JOSE / ECDSA [ES256][es2]
• JOSE / EdDSA [Ed25519][ed255]
• JOSE / CRYSTALS-DILITHIUM 3 [CRYDI3][crydi3]\* |

  \* CRYSTALS-DILITHIUM is a post-quantum resistant signature scheme, selected by NIST for [Post-Quantum Cryptography Standardization][pqc].
  Support for the recently published [FIPS-204][fips] is planned for the near future.

  #### ISO mdoc

  - [ISO/IEC 18013-5:2021][iso5] standard for mdoc credentials.
  - [COSE][cose] proofs
  - ECDSA [ES256][es2]
  - EdDSA [Ed25519][ed255]

  #### IETF SD-JWT VC

  - [IETF SD-JWT-based Verifiable Credentials][sdjwtvc]:

  | Standard | Supported representations | Supported proof/signature types |
  | -------------- | ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
  | IETF SD-JWT VC | SD-JWT |

  • JOSE / ECDSA [ES256][es2]
  • JOSE / EdDSA [Ed25519][ed255]
  • JOSE / CRYSTALS-DILITHIUM 3 [CRYDI3][crydi3]\*
  |

  \* CRYSTALS-DILITHIUM is a post-quantum resistant signature scheme, selected by NIST for [Post-Quantum Cryptography Standardization][pqc].
  Support for the recently published [FIPS-204][fips] is planned for the near future.

  $3

  - OpenID4VCI (Issuance)
  - [v1.0][vci1]
  - [ID-1][vci]
  - OpenID4VP (Verification)
  - [v1.0][vp1.0]
  - [Draft 25][vp25]
  - [Draft 20][vp20]
  - [OID4VP over BLE][ble]; optimized version of Draft 00
  - OID4VP over MQTT; proprietary adaptation of "OID4VP over BLE" via MQTT channel
  - ISO/IEC 18013
  - [18013-5][iso5]: Device engagement using either NFC or QR Code, data retrieval using BLE
  - [18013-7][iso7]: Online data retrieval via OID4VP

  $3

  - Secure Enclave (iOS) and Android Keystore (TEE or Strongbox)
  - Internal encrypted database

  $3

  - [Bitstring Status List v1.0][sl]
  - [Linked Validity Verifiable Credentials (LVVC)][lvvc]
  - [Token Status List - Draft 03][tsl]

  Support

  Need support or have feedback? Contact us.

  License

  Some rights reserved. This library is published under the Apache License
  Version 2.0.

  
  
  
  
  

  © Procivis AG, https://www.procivis.ch.

  [archi]: https://github.com/procivis#architecture
  [bbs]: https://www.w3.org/TR/vc-di-bbs/
  [bbs2023]: https://www.w3.org/TR/vc-di-bbs/#bbs-2023
  [ble]: https://openid.net/specs/openid-4-verifiable-presentations-over-ble-1_0.html
  [canivc]: https://canivc.com/implementations/procivis-one-core/
  [comp]: https://github.com/procivis/one-react-native-components
  [core]: https://github.com/procivis/one-core
  [cose]: https://www.rfc-editor.org/rfc/rfc9052
  [crydi3]: https://datatracker.ietf.org/doc/html/draft-ietf-cose-dilithium-01
  [docs]: https://docs.procivis.ch/
  [ecd]: https://www.w3.org/TR/vc-di-ecdsa/
  [ecd2019]: https://www.w3.org/TR/vc-di-ecdsa/#ecdsa-rdfc-2019
  [edd]: https://www.w3.org/TR/vc-di-eddsa/
  [edd2022]: https://www.w3.org/TR/vc-di-eddsa/#eddsa-rdfc-2022
  [ed255]: https://datatracker.ietf.org/doc/html/rfc8037
  [es2]: https://datatracker.ietf.org/doc/html/rfc7518
  [eudiwi]: https://issuer.eudiw.dev/
  [eudiwv]: https://verifier.eudiw.dev/home
  [fips]: https://csrc.nist.gov/pubs/fips/204/final
  [iso5]: https://www.iso.org/standard/69084.html
  [iso7]: https://www.iso.org/standard/82772.html
  [jld]: https://www.w3.org/TR/json-ld11/
  [jose]: https://w3c.github.io/vc-jose-cose/
  [jw]: https://datatracker.ietf.org/doc/html/rfc7519
  [key]: https://github.com/procivis#key-features
  [lvvc]: https://eprint.iacr.org/2022/1658.pdf
  [owf]: https://github.com/openwallet-foundation-labs/identity-credential
  [pow]: https://github.com/procivis/one-wallet
  [pqc]: https://csrc.nist.gov/pqc-standardization
  [rncore]: https://github.com/procivis/react-native-one-core
  [sdjwt]: https://www.ietf.org/archive/id/draft-ietf-oauth-selective-disclosure-jwt-12.html
  [sdjwtvc]: https://www.ietf.org/archive/id/draft-ietf-oauth-sd-jwt-vc-05.html
  [sdkref]: https://docs.procivis.ch/sdk
  [sl]: https://www.w3.org/TR/vc-bitstring-status-list/
  [trial]: https://docs.procivis.ch/trial
  [tsl]: https://datatracker.ietf.org/doc/html/draft-ietf-oauth-status-list-03
  [vcdi]: https://www.w3.org/TR/vc-data-integrity/
  [vcdm]: https://www.w3.org/TR/vc-data-model-2.0/
  [vci]: https://openid.net/specs/openid-4-verifiable-credential-issuance-1_0-ID1.html
  [vci1]: https://openid.net/specs/openid-4-verifiable-credential-issuance-1_0.html
  [vp1.0]: https://openid.net/specs/openid-4-verifiable-presentations-1_0-final.html
  [vp20]: https://openid.net/specs/openid-4-verifiable-presentations-1_0-20.html
  [vp25]: https://openid.net/specs/openid-4-verifiable-presentations-1_0-25.html