Skip to content

vchain-us/jsvcn

Repository files navigation

jsvcn

CodeNotary - JavaScript Client

Global, de-centralized signing of code and other digital assets.

This package provides an easy to use javascript client for the CodeNotary platform.

Features:

  • authenticate digital assets via Codenotary API or Codenotary Blockchain
  • notarize, untrust and unsupport digital assets via Codenotary API

Demo

Install:

npm install jsvcn

Init

ES6:

import Jsvcn from "jsvcn"

const jsvcn = new Jsvcn();

ES5 (bundled):

<script src="https://unpkg.com/jsvcn@2.1.7/dist/jsvcn.min.js" type="text/javascript"></script>
var jsvcn = new Jsvcn();

Configuration

Configure the client via passing a configuration object to the constructor:

const config = {
	credentials: {
		email: 'test@vchain.us',
		password: 'abc123',
	},
	mode: 'blockchain',
	...
}

const jsvcn = new Jsvcn(config);

List of configuration options

Configuration Descrition
credentials Credentials for notarization
mode Default value: 'api' - Switch between 'api and 'blockchain' mode
checksums Default value: ['sha256'] You can add more hash algorithms to get the hashed file's checksums.
validationOnly Default: false. Blockchain mode only. Set it to true in case you don't want to query asset details from the CodeNotary Asset Server (faster response)
apiUrl Custom CodeNotary API url - overwrite this if you use local vcn api
blockchainUrl CodeNotary Blockchain url - overwrite this if you want to use staging
assetUrl CodeNotary Asset Server url - overwrite this if you want to use staging
blockchainAssetAddress  Custom Contract address - for staging
blockchainOrganizationAddress  Custom Org. Contract address - for staging

Every configuration option is optional.

Authentication

jsvcn.verify(file).then((response) => {
 ...
})

More information about the response format: [#] (CodeNotary API Documentation])

Authentication with Organization

jsvcn.verify(file, progressCb, "myorg.com").then((response) => {
 ...
})

Authentication with SignerIDs

jsvcn.verify(file, null, ['id1','id2',...]).then((response) => {
 ...
})

Notarization

jsvcn.sign(file).then((response) => {
 ...
})

For notarization you need to pass valid CodeNotary user credentials in the config:

const jsvcn = new Jsvcn({
	credentials: {
		email: 'test@vchain.us',
		password: 'abc123',
		// notarizationPassword: 'abc321' - required only when your notarization password is different than your normal user password. 
	},
	...
);

Public Notarization

jsvcn.sign(file, { public: true }).then((response) => {
 ...
})

More information about the response format: [#] (CodeNotary API Documentation])

Untrust / Unsupport

In case you want to unsupport/untrust an asset of yours that you no longer have, you can do that exactly the same way like signing one:

jsvcn.untrust(<file or hash>).then((response) => { ...

FAQ:

Authenticate / notarize sha256 hashes

Verify and sign are able to authenticate / notarize directly the SHA256 hash of an asset:

jsvcn.verify("32c6a50aba0b30f63f124f4b2bb47dc027b9e48f838f71d1debe69d8680ecf70");

Async - await syntax

Verify and sign methods are always returning with a Promise. If you prefer async-await syntax you can use that as well:

async function myAuthenticate(){
 const {status} = await jsvcn.verify(FILE);
 ...
}

Progress callback (for large files)

Since veriy and sign methods are asyncronous calls it's easy to implement progress indicators (eg. just toggle a variable before and after the call.) But for verify and sign commands we are also providing a progress callback as second parameter which periodically returns with the exact percentage of the file hashing progress. This is really handy when you verify large files and want to display (the real) status of the progress.

jsvcn.sign(file, (progress) => console.log(progress + '%'));

Calculate Checksums

CodeNotary.io uses SHA256 algorithm to calculate and compare file hashes, but our library can also provide SHA1, SHA512, MD5 checksums of the file. You can add "checksums" attribute to the config object with an array of checksums you want to get back from the verify method.

const jsvcn = new Jsvcn({checksums: ["sha1", "md5"]});

Authentication directly via the CodeNotary Blockchain with Ethers.js

If you want to directly authenticate assets with CodeNotary Blockchain add this to your html page:

<script src="https://cdn.ethers.io/scripts/ethers-v4.min.js" type="text/javascript"></script>

and set mode: 'blockchain', in your config.

License

This software is released under GPL3.