datum-fuse v0.0.5

Datum Fuse

A tool to connect DApps with Datum ID

Installation

Install the package with:

npm install datum-fuse --save

Gettting Started

In order to use this package you must have a Datum Identity that you use as DApp Developer. This Datum Identity allows DApp users to encrypt data so that you, as developer, can decrypt the shared data using your Datum Identity. If you don't have a Datum Identity you can create one using the Datum SDK. Please make sure to initialize Datum SDK's Datum object with your keystore and then use the function calls detailed below to get the information required to use Datum Fuse!

You will need the following information to use Datum Fuse:

Once you have the keys above, you can now create a new Fuse object in your project and initialize it with the keys.

import Fuse from 'datum-fuse';

const address = '0xcba9e90b9fd0b9f28a7bf1c56c08bd8ec652ceb1';
const publicKey = '4d2709dd4415eaedadde3ca86242c951faa4dea5640d85cd639e7557e98706c118ca2ed20c67a2e898ddfc6776fcb6d8f8e736cf0016cd35e2812e7e7e571cd0';
const encryptionKey = '2e38e730f131992628f8be5c4443fe5b84733747bec841298281d14d9f0b0f15';

const fuse = new Fuse();

fuse.init(publicKey, encryptionKey, address);

Usage

The following methods you can use to request or set via Fuse. All these tools are used to communicate via Datum ID to get the current user's information. When using Fuse, you will be responded back with a JSON object containing a root key named payload with all the response data within it.Please note that all responses from Fuse returns a promise, so be sure to resolve the promise!

.requestWallet()

This method is used to get the current user's address. To use this method, you can call it like this:

const userAddress = await fuse.requestWallet();

Parameters

Result

.hasConsent()

This method is used to check if the current user has a consent claim made with you (the DApp developer), with the given parameters. To use this method, you can call it like this:

const keynames = ['EMAIL', 'Birthday'];

const consent = await fuse.hasConsent(keynames);

Parameters

*Please note that you can only view data you have been given access. It is highly suggested to only request data you have access to.

Result

.requestData()

This method is used to create consent claims between the user and the DApp developer. On call of this method, Datum ID will create a storage item for the user and a claim attached to the storage item. This claim will be shared with the user and the developer. The developer will also have access to the storage item. To use this method, you can call it like this:

const statement = 'I agree to the terms and conditions of this app';
const dataToUse = ['EMAIL'];
const keyname = ['email_claim'];

const call = await fuse.requestData(statement, dataToUse, keyname);

Parameters

Result

Current we as Datum offer the following data objects for DApp developers to use. If you would like to make use of these data, please feel free to use them by referring them in the keyname parameter (within the array). Please check out the table below to see what kind of data you can use right off the bat:

.get()

This method is used to get whatever storage item you have access to. To call this method, you can call it like this:

const key = 'EMAIL';

const get = await fuse.get(key);

Parameters

Result

.set()

This method is used to set whatever storage item you have access to. Please keep in mind that you are only allowed to set for all items you have access to except for Datum verified items*. To call this method, you can call it like this:

const key = 'COLOR';
const value = 'Green';

const call = await fuse.set(key, value);

Parameters

Result

*Please note that if your key has the same key name as any of the Datum verified keynames, this will cause this method to throw an error.

.signMessage()

This method is used to sign a given key-value pair declared by the Dapp developer. A signed message will return signed by the current user's identity. To use this method, you can call it like this:

const key = 'Age';
const value = '30';

const sign = await fuse.signMessage(key, value); 

Parameters

Result

.newIdentity

This method is used to assign a new account for the current mobile user. This will generate a new set of public/private keys for the user that he/she can use. To use this method, you can call it like this:

const newIdentity = await fuse.newIdentity();

Parameters

Result

.share()

This method is used to open the Share Dialog for both iOS|Android. To use this method, you can call it like this:

const title = 'Share Post';
const message = 'Block that chain';

const share = await fuse.share(title, message);

Parameters

Result

More Information

• Datum SDK
• Getting Started with Datum SDK