Verifiable addresses

[nhartner]

High Level Overview of Change

adds functions and types to sign a PayID address using identity or server key and generate JWS. A complete usage looks like this.

Build utils. Launch node repl:

npm install
npm run build
node --experimental-repl-await

Run the following code inside the repl:

jose = require('jose')
payidUtils = require('./dist')

var jwk = await jose.JWK.generate('EC', 'secp256k1')
var alg = 'ES256K'

var payId = 'nhartner$payid.ml'
var address = { paymentNetwork: 'XRPL', environment: 'MAINNET', addressDetailsType: 'CryptoAddressDetails', addressDetails: { address: 'rP3t3JStqWPYd8H88WfBYh3v84qqYzbHQ6' }}

var jws = payidUtils.sign(payId, address, { key: jwk, alg })
console.log(JSON.stringify(jws, null, 2))

payidUtils.verifySignedAddress(payId, jws)

Context of Change

new functions in new files

Type of Change

• Bug fix (non-breaking change which fixes an issue)
• [ X ] New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Refactor (non-breaking change that only restructures code)
• Tests (You added tests for code that already exists, or your new feature included in this PR)
• Documentation Updates
• Release

Before / After

Test Plan

Generate and sign payIDs using various combinations of key and algorithms.

[dino-rodriguez]

This is great Neil. This will be super useful for validating JWS and in general testing out the full-fledged usage of the server implementation.

[dino-rodriguez]

Just curious as I haven't seen this before : why are these also import statements instead of constants / variables?

[dino-rodriguez]

This is super clean and simple.

[dino-rodriguez]

Nice helper abstractions!

[dino-rodriguez]

For tests we've usually been doing GIVEN WHEN THIS comments, not sure if you wanted to continue this pattern here, but imo it makes tests easily human readable.

[dino-rodriguez]

Helpful comment, nice.