Installing the SDK

The Oraculi SDK is a Java native application that can be embedded into any mobile development framework that can instantiate Java within a mobile app. For the purpose of this documentation, it would be assumed to be a React Native application.

Note

The Java SDK is available on GitHub on a private repo. To get access, please contact [e-mail]. The installation instructions are on the repo README.

Android Permissions

The SDK requires the READ_SMS and RECEIVE_SMS permissions which must be explicitly defined within your application Android Manifest.

These two permissions are classified as dangerous permissions by Google and as such, beyond just declaring them in your application, there are certain guidelines for getting them approved by Google.

Definitions

It’s important to understand the taxonomy of the Oraculi SDK.

Entities

When the Oraculi SDK collects data from an Android phone, it creates unique identifiers for the user and the phone. However, because the developer has been required to provide an identifier for the user upon the instantiation of the SDK, it would allow the identification of such users irrespective of the different devices they may use.

However, at the root of the entity identity are the unique identifiers (UUID) for that mobile device and the session that created the data.

Institutions

Institutions define the companies, banks, or other unique stakeholders that have sent SMS or other information to an entity (or a user).

Transactions

Transactions are the records of the activity of a user or an entity with an institution. It could be an SMS alert representing a financial transaction or a balance alert from a telco. For both a bank institution, a credit/debit statement is a measure of funds moving in and out of an account.