Ambisafe-client-javascript NPM

Ambisafe Javascript Lib (ambisafe-lib)

Javascript library used by Ambisafe.co for general purposes.

Installation

npm install -g browserify
npm install -g uglifyjs
npm install -g jshint

npm install

Library Generation

npm run build

Examples

Example 1: create account & save

This supposed to happen after user have filled registration form and clicked submit:

Create an account with the Ambisafe.generateAccount function. The currency value has to be selected from the Ambisafe.currency object (eg: Ambisafe.currency.BITCOIN) The password value is required. * The salt value is not required.
```
	Example: 
	```
	account = Ambisafe.generateAccount(
				currency, 
				password, 
				salt);
	```
```
To convert the account attributes to a JSON string, execute the following line: accountSerialized = account.toString();
The rest is done on server side. We don't need username and other details here.

Example 2: sign in & create transaction

Container with account JSON should be fetched from a server after successful login. The most optimal way to fetch it depends client application and therefore delegated to it.

Decrypting account with private key: account json as it returned by Server + password, entered during authentication. Password should never be transmitted to server. Exception can be thrown here if password is incorrect.
```
	```
	account = new Ambisafe.Account(
				container, 
				password
	);
	```
```
Constructing transaction & validating against business logic rules like with account, creation and validation of transaction is out of scope of this library.

Signing transaction with customer key:

	```
	signedTransaction = Ambisafe.signTransaction(
				transaction, 
				privateKey);
	```

Signed transaction should be submitted to server for co-signing and broadcasting.

Example 3: change password

To change the password of a created account the user has to call to the setNewPassword function:

Based on a created account:

	```
	account = new Ambisafe.Account(
				container, 
				password);
	```

Call the setNewPassword function with the newPassword attribute:
```
	```
	account.setNewPassword(newPassword);
	```
```

Example 4: scan QR Code

To scan a QR code uses the following javascript code.

Ambisafe.QRScanner.scanQR(divId, 
	function(data){
		alert(data);
	},
	function(error){
		console.log(error);
	}
);

The first parameter is a string that indicates the "id" attribute of a created "div" HTML element.
The second parameter is the function called when the QR code is captured.
The third parameter is the function called when an error happens.