iso-signatures

Isomorphic signatures tooling

Install

pnpm install iso-signatures
Copy

Usage

import { EdDSASigner } from 'iso-signatures/signers/eddsa'
import * as EdDSA from 'iso-signatures/verifiers/eddsa'
import { Resolver } from 'iso-signatures/verifiers/resolver'

const message = new TextEncoder().encode('hello world')
const resolver = new Resolver({
  ...EdDSA.verifier,
})
const signer = await EdDSASigner.generate()
const signature = await signer.sign(message)
const verified = await resolver.verify({
  signature,
  message,
  ...signer,
})
Copy

import { EdDSASigner } from 'iso-signatures/signers/eddsa'
import * as EdDSA from 'iso-signatures/verifiers/eddsa'
import * as ECDSA from 'iso-signatures/verifiers/ecdsa'
import * as RSA from 'iso-signatures/verifiers/rsa'
import { Resolver } from 'iso-signatures/verifiers/resolver'

const message = new TextEncoder().encode('hello world')
const resolver = new Resolver(
  {
    ...ECDSA.verifier,
    ...EdDSA.verifier,
  },
  { cache: true }
)
const signer = await EdDSASigner.generate()
const signature = await signer.sign(message)
const verified = await resolver.verify({
  signature,
  message,
  ...signer.did, // Signer and DID both have `alg` property that the resolver uses to find the correct verifier
})
Copy

Strict verification

ECDSASigner always emits low S signatures (s <= n/2). Verifiers accept both low and high S by default, since other implementations produce high S signatures. If you control all your signers, enable strict to only accept the canonical encoding: ECDSA (P-256/384/521) and EIP-191 signatures with high S are rejected, and EIP-191 signatures must use 27/28 as the recovery byte.

import * as ECDSA from 'iso-signatures/verifiers/ecdsa'
import * as EIP191 from 'iso-signatures/verifiers/eip191'
import { Resolver } from 'iso-signatures/verifiers/resolver'

const resolver = new Resolver(
  {
    ...ECDSA.verifier,
    ...EIP191.verifier,
  },
  { strict: true }
)

// or per call
await ECDSA.verify('ES256', { signature, message, did, strict: true })
Copy

Docs

Check https://hugomrdias.github.io/iso-repo/modules/iso_signatures.html

License

MIT © Hugo Dias