Skip to content
JavaScript implementation of the Digiid authentication protocol:
Branch: master
Clone or download
Pull request Compare This branch is 1 commit behind digicontributer:master.
digicontributer digiid
Latest commit 07b32e7 Dec 11, 2017
Type Name Latest commit message Commit time
Failed to load latest commit information.
test digiid Dec 11, 2017
LICENSE.txt first commit May 7, 2014
Makefile first commit May 7, 2014 digiid Dec 11, 2017
index.js digiid Dec 11, 2017
package-lock.json digiid Dec 11, 2017
package.json digiid Dec 11, 2017


This is the javascript implementation of the DigiID authentication protocol. Checkout the original Ruby version at

Basically, what the module does is build a message challenge and verifying the signature.


Add this line to your application's package.json dependencies:

'digiid': 'latest'

Or install it yourself as:

$ npm install digiid



To build a challenge, you need to initialize a DigiID object with a nonce and a callback.

var digiid = new DigiID({nonce:nonce, callback:callback});

nonce is a random string associated with the user's session id. callback is the url without the scheme where the wallet will post the challenge's signature.

One example of callback could be A callback cannot have parameters. By default the POST call will be done using https. If you need to tell the wallet to POST on http then you need to add unsecure:true.

var digiid = new DigiID({nonce:nonce, callback:callback, unsecure:true});

Once the DigiID object is initialized, you have access to the following methods :


This is the uri which will trigger the wallet when clicked (or scanned as QRcode). For instance :


If you added unsecure:true when initializing the object then uri will be like :


To get the uri as QRcode :


This is actualy an URL pointing to the QRcode image.


When getting the callback from the wallet, you must initialize a DigiID object with the received parameters address, uri, signature as well as the excpected callback :

var digiid = new DigiID(address:address, uri:uri, signature:signature, callback:callback);

You can after call the following methods :


Return the nonce, which would get you the user's session.


Returns true if the submitted URI is valid and corresponds to the correct callback url.


If returns true, then you can authenticate the user's session with address (public Bitcoin address used to sign the challenge).

Integration example

JavaScript application using the digiid lib:

Live demonstration:

In the Wild

The following projects use digiid-js.

If you are using digiid-js in a project, app, or module, get on the list below by getting in touch or submitting a pull request with changes to the README.

Startups & Apps


Aaron Caswell


Eric Larchevêque (The creator of the DigiID protocol and the original Ruby gem this code is based on)


  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request
You can’t perform that action at this time.