unova-sdk v0.0.1-beta-1

Unova SDK

Library for simple interaction with Unova API.

Contribution

Please refer to project's code style guidelines and guidelines for submitting patches and additions. In general, we follow the "fork-and-pull" Git workflow.

1. Fork the repo on GitHub
2. Clone the project to your own machine
3. Commit changes to your own branch
4. Push your work back up to your fork
5. Submit a Pull request so that we can review your changes

NOTE: Be sure to merge the latest from "upstream" before making a pull request!

It is mandatory to follow our code of conduct described in CONTRIBUTING.md.

Overview

• Prerequisite
• Setup
• Usage
• Response from Unova SDK methods
• SDK Events
• Unova SDK methods
  • Get asset
  • Get assets
  • Create asset
  • Get event
  • Get events
  • Create event
• Examples

Prerequisite

In order to use Unova SDK, first you need to have a developers account.\ You can apply for one here.

Unova team will send you an email with your account address and secret key.

Important note: PLEASE DO NOT SHARE YOUR SECRET WITH ANYONE. \ We do not store your secret for security reasons, so please save it somewhere safe, in order to use it in SDK.

To use Unova SDK, you will need your address and secret key.\ Now we can go to setup.

Setup

npm

$ npm install unova-javascript-sdk --save

Import the SDK in your javascript file

const UnovaSDK = require('unova-javascript-sdk');

Download

Directly download the library and host it locally.\ You can download library here.

If your project structure is for example:

project-name/js/unova.min.js
project-name/index.html

You would include it in your index.html where you use Unova SDK like:

<script async src="/js/unova.min.js"></script>

Usage

Initialize the Unova library.\

In order to use the web3.js library to support client side data signing while creating assets or events or token, we will need to import the web3.js library.\

For node.js\ Simply npm install web3 and import in your .js file like - const Web3 = require('web3');

For a client side HTML\ Import web3 using the script tag. like - <script async src="/path/to/js/web3.min.js"></script>

In the script on your page where you use Unova SDK, put this code in the beginning of the script:

var unova = new UnovaSDK({
  // Provide env variables
  secret: '0x6823520c03ad7b17bc1a7144fbbd2d24bfa2ce933d715ace209d658e03fdd388',
  Web3: Web3
});

Each state-modifying call needs to have the secret and address values. If you wish to use the SDK only to request or query the data, You can initialise the SDK like -

var unova = new UnovaSDK({
  apiEndpoint: 'https://gateway-test.unova.com'
});

Response from Unova SDK methods

Every Unova SDK method (examples below), will return the response with this structure:

Response type: object

{
  "status": 404,
  "data": null,
  "message": "Entity not found: No event with id = null found"
}

Listen to SDK Events

Library supports internal events.

unova.on('asset:created', function() {
  // your method here
});

Public SDK Methods

The SDK also exports utility methods which can be used without initializing the SDK. Example to access the public utility methods

const parseEvents = UnovaSDK.utils.parseEvents(eventsArray);
// Parse events object

Examples

See examples/ for working examples of how the SDK can be used.