Home

Awesome

supercop.wasm Travis CI

orlp/ed25519 compiled to WebAssembly using Emscripten and optimized for small size

Based on supercop.js. Works exactly the same way with the same API as supercop.js (except using Uint8Array instead of Buffer for lower overhead in browser build), but multiple times smaller, uses WebAssembly and works in (modern) browsers (UMD-compatible).

How to install

npm install supercop.wasm

How to use

Node.js:

var supercop = require('supercop.wasm')

supercop.ready(function () {
    var seed = supercop.createSeed()
    var keys = supercop.createKeyPair(seed)
    var msg = Buffer.from('hello there')
    var sig = supercop.sign(msg, keys.publicKey, keys.secretKey)
    console.log(supercop.verify(sig, msg, keys.publicKey)) // true
});

Browser:

requirejs(['supercop.wasm'], function (supercop) {
    supercop.ready(function () {
        var seed = supercop.createSeed()
        var keys = supercop.createKeyPair(seed)
        var msg = (new TextEncoder("utf-8")).encode("hello there")
        var sig = supercop.sign(msg, keys.publicKey, keys.secretKey)
        console.log(supercop.verify(sig, msg, keys.publicKey)) // true
    });
})

API

supercop.ready(callback)

var seed = supercop.createSeed()

Generates a cryptographically-secure 32-byte seed (Uint8Array)

var keys = supercop.createKeyPair(seed)

Generates a keypair from the provided 32-byte seed (Uint8Array) with the following properties:

var sig = supercop.sign(msg, publicKey, secretKey)

Signs a given message of any length.

var valid = supercop.verify(sig, msg, publicKey)

Verifies a given signature goes with the message and key.

Contribution

Feel free to create issues and send pull requests (for big changes create an issue first and link it from the PR), they are highly appreciated!

License

Free Public License 1.0.0 / Zero Clause BSD License

https://opensource.org/licenses/FPL-1.0.0

https://tldrlegal.com/license/bsd-0-clause-license