--- NOT PRODUCTION READY. WOULD NEED INTEROPERABILITY TESTS---
Conversion of cryptographic keys in Multikey format to and from WebCrypto and JWK. The conversions are available for the three EC curves that are defined for Verifiable Credentials: ECDSA with P-256 and P-384 and EDDSA.
The package has been written in TypeScript using Deno. It has also been published as an npm package.
For a more detailed documentation, see the more detailed code documentation, generated by Deno. A short set of examples may help.
The interface makes use of the JsonWebKey, CryptoKeyPair, and CryptoKey types, which are global types in Deno or Node.js, defined by WebCrypto. The following types are also exported by the package:
export interface JWKKeyPair {
publicKey: JsonWebKey;
privateKey?: JsonWebKey;
}
export type Multibase = string;
// The field names in `Multikey` reflect the Multikey specification.
export interface Multikey {
publicKeyMultibase: Multibase;
secretKeyMultibase?: Multibase;
}import * as mkc from "multikey-webcrypto";
// Get a JWK pair
const jwk_pair: mkc.JWKKeyPair = {
publicKey: your_jwk_public_key,
privateKey: your_jwk_private_key,
};
const mk_pair: mkc.Multikey = mkc.JWKToMultikey(jwk_pair);
// mk_pair.publicKeyMultibase and mk_pair.secretKeyMultibase provide
// the converted values
// Convert the multikey back to jwk
const gen_jwk_pair: mkc.JWKKeyPair = mkc.multikeyToJWK(mk_pair);In all cases the secret key may be missing or set to undefined, so that only the public key is converted. The same can be achieved if the functions are used with an overloaded signature:
import * as mkc from "multikey-webcrypto";
const mk: mkc.Multibase = mkc.JWKToMultikey(your_jwk_public_key);
// mk the encoded value
// Convert the multikey back to jwk
const gen_jwk_public_key: mkc.JWKKeyPair = mkc.multikeyToJWK(mk);The interface is similar to the JWK case. The only major difference is that functions are asynchronous (the reason is that WebCrypto implementations are asynchronous).
The simplest approach is to use the await constructs in the code:
import * as mkc from "multikey-webcrypto";
// Convert a JWK Pair to a Multikey.
// Note: the `CryptoKeyPair` interface is defined by the WebCrypto
// implementations, not by this package
const crypto_pair: CryptoKeyPair = {
publicKey: your_web_crypto_public_key,
privateKey: your_web_crypto_secret_key,
};
const mk_pair: Multikey = await mkc.cryptoToMultikey(crypto_pair);
// mk_pair.publicKeyMultibase and mk_pair.secretKeyMultibase
// provide the right values
// Convert the multikey back to jwk
const gen_crypto_pair: mkc.JWKKeyPair = await mkc.multikeyToCrypto(mk_pair);Similarly to the JWK case, handling public keys only can be done with the aliased versions of the same functions:
import * as mkc from "multikey-webcrypto";
const mk: Multibase = mkc.cryptoToMultikey(your_web_crypto_public_key);
// mk the encoded value
// Convert the multikey back to jwk
const gen_crypto_key: JWKKeyPair = mkc.multikeyToJWK(mk);
