Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

100% tests coverage for web5/crypto #215

Merged
merged 2 commits into from
Sep 14, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions packages/crypto/src/jose.ts
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
import { sha256 } from '@noble/hashes/sha256';
import { Convert, Multicodec, MulticodecCode, removeUndefinedProperties } from '@web5/common';
import { Convert, Multicodec, MulticodecCode, MulticodecDefinition, removeUndefinedProperties } from '@web5/common';

import type { Web5Crypto } from './types/web5-crypto.js';

Expand Down Expand Up @@ -507,7 +507,7 @@ export class Jose {

public static async joseToMulticodec(options: {
key: JsonWebKey
}): Promise<{ code?: MulticodecCode, name?: string }> {
}): Promise<MulticodecDefinition<MulticodecCode>> {
const jsonWebKey = options.key;

const params: string[] = [];
Expand Down Expand Up @@ -610,7 +610,7 @@ export class Jose {
* const thumbprint = jwkThumbprint(jwk);
* console.log(`JWK thumbprint: ${thumbprint}`);
*
* @see {@link https://datatracker.ietf.org/doc/html/rfc7638|RFC 7638} for
* @see {@link https://datatracker.ietf.org/doc/html/rfc7638 | RFC7638} for
* the specification of JWK thumbprint computation.
*/
public static async jwkThumbprint(options: {
Expand Down Expand Up @@ -863,7 +863,7 @@ export class Jose {
const jose = multicodecToJoseMapping[lookupKey];

if (jose === undefined) {
throw new Error(`Unsupported Multicodec to JOSE conversion: '${options.name ?? options.code}'`);
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this is unreachable;
we can't hit this line with undefined code AND name, as undefined code would throw in getNameFromCode with undefined name

Removed to reach 100% tests coverage, as it's not possible to cover unreachable edge case...

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Appreciate the clarification

throw new Error(`Unsupported Multicodec to JOSE conversion: '${options.name}'`);
}

return { ...jose };
Expand Down
325 changes: 324 additions & 1 deletion packages/crypto/tests/fixtures/test-vectors/jose.ts
Original file line number Diff line number Diff line change
Expand Up @@ -312,6 +312,66 @@ export const joseToWebCryptoTestVectors = [
},
];

export const joseToMulticodecTestVectors = [
{
output : { code: 237, name: 'ed25519-pub' },
input : {
alg : 'EdDSA',
crv : 'Ed25519',
kty : 'OKP',
x : 'cuY-fEu_V1s4b8HbGzy_9VOaNtxiUPzLn6KOATdz0ks',
},
},
{
output : { code: 4864, name: 'ed25519-priv' },
input : {
d : '',
alg : 'EdDSA',
crv : 'Ed25519',
kty : 'OKP',
x : 'c5UR1q2r1lOT_ygDhSkU3paf5Bmukg-jX-1t4kIKJvA',
},
},
{
output : { code: 231, name: 'secp256k1-pub' },
input : {
alg : 'ES256K',
crv : 'secp256k1',
kty : 'EC',
x : '_TihFv5t24hjWsRcdZBeEJa65hQB5aiOYmG6mMu1RZA',
y : 'UfiOGckhJuh9f3-Yi7g-jTILYP6vEWOSF1drwjBHebA',
},
},
{
output : { code: 4865, name: 'secp256k1-priv' },
input : {
d : '',
alg : 'ES256K',
crv : 'secp256k1',
kty : 'EC',
x : '_TihFv5t24hjWsRcdZBeEJa65hQB5aiOYmG6mMu1RZA',
y : 'UfiOGckhJuh9f3-Yi7g-jTILYP6vEWOSF1drwjBHebA',
},
},
{
output : { code: 236, name: 'x25519-pub' },
input : {
crv : 'X25519',
kty : 'OKP',
x : 'cuY-fEu_V1s4b8HbGzy_9VOaNtxiUPzLn6KOATdz0ks',
},
},
{
output : { code: 4866, name: 'x25519-priv' },
input : {
d : '',
crv : 'X25519',
kty : 'OKP',
x : 'MBZd77wAy5932AEP7MHXOevv_MLzzD9OP_fZAOlnIWM',
},
},
];

export const keyToJwkTestVectorsKeyMaterial = '72e63e7c4bbf575b386fc1db1b3cbff5539a36dc6250fccb9fa28e013773d24b';
export const keyToJwkMulticodecTestVectors = [
{
Expand Down Expand Up @@ -372,6 +432,7 @@ export const keyToJwkMulticodecTestVectors = [
}
}
];

export const keyToJwkWebCryptoTestVectors = [
{
input : { namedCurve: 'Ed25519', name: 'EdDSA' },
Expand All @@ -382,6 +443,16 @@ export const keyToJwkWebCryptoTestVectors = [
x : 'cuY-fEu_V1s4b8HbGzy_9VOaNtxiUPzLn6KOATdz0ks'
}
},
{
input : { namedCurve: 'secp256k1', name: 'ECDSA' },
output : {
alg : 'ES256K',
crv : 'secp256k1',
kty : 'EC',
x : '_TihFv5t24hjWsRcdZBeEJa65hQB5aiOYmG6mMu1RZA',
y : 'UfiOGckhJuh9f3-Yi7g-jTILYP6vEWOSF1drwjBHebA',
}
},
{
input : { namedCurve: 'X25519', name: 'ECDH' },
output : {
Expand Down Expand Up @@ -425,4 +496,256 @@ export const keyToJwkWebCryptoTestVectors = [
k : 'cuY-fEu_V1s4b8HbGzy_9VOaNtxiUPzLn6KOATdz0ks'
}
}
];
];

export const keyToJwkWebCryptoWithNullKTYTestVectors = [
{
input : { namedCurve: 'Ed25519', name: 'EdDSA' },
output : {
alg : 'EdDSA',
crv : 'Ed25519',
kty : 'OKP',
x : 'cuY-fEu_V1s4b8HbGzy_9VOaNtxiUPzLn6KOATdz0ks'
}
},
{
input : { namedCurve: 'secp256k1', name: 'ECDSA' },
output : {
alg : 'ES256K',
crv : 'secp256k1',
kty : 'EC',
x : '_TihFv5t24hjWsRcdZBeEJa65hQB5aiOYmG6mMu1RZA',
y : 'UfiOGckhJuh9f3-Yi7g-jTILYP6vEWOSF1drwjBHebA',
}
},
{
input : { namedCurve: 'X25519', name: 'ECDH' },
output : {
crv : 'X25519',
kty : 'OKP',
x : 'cuY-fEu_V1s4b8HbGzy_9VOaNtxiUPzLn6KOATdz0ks'
}
},
{
input : { namedCurve: 'secp256k1', name: 'ECDSA' },
output : {
alg : 'ES256K',
crv : 'secp256k1',
kty : 'EC',
x : '_TihFv5t24hjWsRcdZBeEJa65hQB5aiOYmG6mMu1RZA',
y : 'UfiOGckhJuh9f3-Yi7g-jTILYP6vEWOSF1drwjBHebA'
}
},
{
input : { namedCurve: 'secp256k1', name: 'ECDH' },
output : {
crv : 'secp256k1',
kty : 'EC',
x : '_TihFv5t24hjWsRcdZBeEJa65hQB5aiOYmG6mMu1RZA',
y : 'UfiOGckhJuh9f3-Yi7g-jTILYP6vEWOSF1drwjBHebA'
}
},
{
input : { name: 'AES-CBC', length: 128 },
output : {
alg : 'A128CBC',
kty : null,
}
},
{
input : { name: 'HMAC', hash: { name: 'SHA-256' } },
output : {
alg : 'HS256',
kty : null,
}
}
];

export const jwkToKeyTestVectors = [
{
output: {
keyMaterial : keyToJwkTestVectorsKeyMaterial,
keyType : 'public',
},
input: {
alg : 'EdDSA',
crv : 'Ed25519',
kty : 'OKP',
x : 'cuY-fEu_V1s4b8HbGzy_9VOaNtxiUPzLn6KOATdz0ks'
}
},
{
output: {
keyMaterial : '04fd38a116fe6ddb88635ac45c75905e1096bae61401e5a88e6261ba98cbb5459051f88e19c92126e87d7f7f988bb83e8d320b60feaf11639217576bc2304779b0',
keyType : 'public',
},
input: {
alg : 'ES256K',
crv : 'secp256k1',
kty : 'EC',
x : '_TihFv5t24hjWsRcdZBeEJa65hQB5aiOYmG6mMu1RZA',
y : 'UfiOGckhJuh9f3-Yi7g-jTILYP6vEWOSF1drwjBHebA'
}
},
{
output: {
keyMaterial : keyToJwkTestVectorsKeyMaterial,
keyType : 'private',
},
input: {
alg : 'A128CBC',
kty : 'oct',
k : 'cuY-fEu_V1s4b8HbGzy_9VOaNtxiUPzLn6KOATdz0ks'
}
},
{
output: {
keyMaterial : keyToJwkTestVectorsKeyMaterial,
keyType : 'private',
},
input: {
alg : 'HS256',
kty : 'oct',
k : 'cuY-fEu_V1s4b8HbGzy_9VOaNtxiUPzLn6KOATdz0ks'
}
},
{
output: {
keyMaterial : '',
keyType : 'private',
},
input: {
d : '',
alg : 'EdDSA',
crv : 'Ed25519',
kty : 'OKP',
x : 'c5UR1q2r1lOT_ygDhSkU3paf5Bmukg-jX-1t4kIKJvA',
},
}
];

export const jwkToThumbprintTestVectors = [
{
output : 'NzbLsXh8uDCcd-6MNwXF4W_7noWXFZAfHkxZsRGC9Xs',
input : {
kty : 'RSA',
n : '0vx7agoebGcQSuuPiLJXZptN9nndrQmbXEps2aiAFbWhM78LhWx4cbbfAAtVT86zwu1RK7aPFFxuhDR1L6tSoc_BJECPebWKRXjBZCiFV4n3oknjhMstn64tZ_2W-5JsGY4Hc5n9yBXArwl93lqt7_RN5w6Cf0h4QyQ5v-65YGjQR0_FDW2QvzqY368QQMicAtaSqzs8KJZgnYb9c7d0zgdAZHzu6qMQvRL5hajrn1n91CbOpbISD08qNLyrdkt-bFTWhAI4vMQFh6WeZu0fM4lFd2NcRwr3XPksINHaQ-G_xBniIqbw0Ls1jF44-csFCur-kEgU8awapJzKnqDKgw',
e : 'AQAB',
alg : 'RS256',
kid : '2011-04-29',
},
},
{
output : 'legaImFEtXYAJYZ8_ZGbZnx-bhc_9nN53pxGpOum3Io',
input : {
alg : 'A128CBC',
kty : 'oct',
k : 'cuY-fEu_V1s4b8HbGzy_9VOaNtxiUPzLn6KOATdz0ks',
},
},
{
output : 'dwzDb6KNsqS3QMTqH0jfBHcoHJzYZBc5scB5n5VLe1E',
input : {
alg : 'ES256K',
crv : 'secp256k1',
kty : 'EC',
x : '_TihFv5t24hjWsRcdZBeEJa65hQB5aiOYmG6mMu1RZA',
y : 'UfiOGckhJuh9f3-Yi7g-jTILYP6vEWOSF1drwjBHebA',
},
},
{
output : 'KCfBQ0EA2cWr1Kbt-mnlj8LQ9C2AJfcuEm8mtgOe7wQ',
input : {
crv : 'X25519',
kty : 'OKP',
x : 'cuY-fEu_V1s4b8HbGzy_9VOaNtxiUPzLn6KOATdz0ks',
},
},
{
output : 'TQdUBtR3MvnNE-7p5sotzCGgZNyQC7EgsiKQz1Erzc4',
input : {
d : '',
crv : 'X25519',
kty : 'OKP',
x : 'MBZd77wAy5932AEP7MHXOevv_MLzzD9OP_fZAOlnIWM',
},
},
];

export const jwkToCryptoKeyTestVectors = [
{
cryptoKey: {
algorithm : { name: 'AES-CTR', length: 256 },
extractable : true,
type : 'private',
usages : ['encrypt', 'decrypt'],
},
jsonWebKey: {
'alg' : 'A256CTR',
'ext' : 'true',
'key_ops' : ['encrypt', 'decrypt'],
'k' : 'UQtIAS-rmWB-vgNgG4lPrnTS2tNvwDPKl9rs0L9ICnU', // Base64url
'kty' : 'oct',
}
},
{
cryptoKey: {
algorithm : { name: 'AES-GCM', length: 256 },
extractable : false,
type : 'private',
usages : ['encrypt', 'decrypt'],
},
jsonWebKey: {
'alg' : 'A256GCM',
'ext' : 'false',
'key_ops' : ['encrypt', 'decrypt'],
'k' : '-pGdALDtxmxz78wjJQc__4FzvTCVYXTNULM4H0OKVqw', // Base64url
'kty' : 'oct',
}
},
{
cryptoKey: {
algorithm : { name: 'HMAC', hash: { name: 'SHA-256' } },
extractable : true,
type : 'private',
usages : ['sign', 'verify'],
},
jsonWebKey: {
'alg' : 'HS256',
'ext' : 'true',
'key_ops' : ['sign', 'verify'],
'k' : '3HOae-P_wVKvabxF37Atgc_jE8fLB0xkMUSpwVWI2HRouvoC2iCrf8j3SYkWsYRFm4Sv8nc2vpzI9g5Jyg0Bxw', // Base64url
'kty' : 'oct',
}
},
];

export const jwkToMultibaseIdTestVectors = [
{
output : 'zQ3sheTFzDvGpXAc9AXtwGF3MW1CusKovnwM4pSsUamqKCyLB',
input : {
alg : 'ES256K',
crv : 'secp256k1',
kty : 'EC',
x : '_TihFv5t24hjWsRcdZBeEJa65hQB5aiOYmG6mMu1RZA',
y : 'UfiOGckhJuh9f3-Yi7g-jTILYP6vEWOSF1drwjBHebA',
},
},
{
output : 'z6LSjQhGhqqYgrFsNFoZL9wzuKpS1xQ7YNE6fnLgSyW2hUt2',
input : {
crv : 'X25519',
kty : 'OKP',
x : 'cuY-fEu_V1s4b8HbGzy_9VOaNtxiUPzLn6KOATdz0ks',
},
},
{
output : 'zAuT',
input : {
d : '',
crv : 'X25519',
kty : 'OKP',
x : 'MBZd77wAy5932AEP7MHXOevv_MLzzD9OP_fZAOlnIWM',
},
},
];
Loading
Loading