Norse Power Metal


    2.2.3 • Public • Published


    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.


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



    npm install jsvcn



    import Jsvcn from "jsvcn"
    const jsvcn = new Jsvcn();

    ES5 (bundled):

    <script src="" type="text/javascript"></script>
    var jsvcn = new Jsvcn();


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

    const config = {
    	credentials: {
    		email: '',
    		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.


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

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

    Authentication with Organization

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

    Authentication with SignerIDs

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


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

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

    const jsvcn = new Jsvcn({
    	credentials: {
    		email: '',
    		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) => { ...


    Authenticate / notarize sha256 hashes

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


    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 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="" type="text/javascript"></script>

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


    This software is released under GPL3.


    npm i jsvcn

    DownloadsWeekly Downloads






    Unpacked Size

    6.39 MB

    Total Files


    Last publish


    • vchain