@parmana/crypto 0.0.0-stage → 0.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +202 -0
- package/NOTICE +8 -0
- package/README.md +16 -2
- package/dist/.tsbuildinfo +1 -0
- package/dist/ApprovalArtifactCrypto.d.ts +33 -0
- package/dist/ApprovalArtifactCrypto.d.ts.map +1 -0
- package/dist/ApprovalArtifactCrypto.js +54 -0
- package/dist/ApprovalArtifactCrypto.js.map +1 -0
- package/dist/ArtifactSigner.d.ts +22 -0
- package/dist/ArtifactSigner.d.ts.map +1 -0
- package/dist/ArtifactSigner.js +29 -0
- package/dist/ArtifactSigner.js.map +1 -0
- package/dist/AuditEventCrypto.d.ts +39 -0
- package/dist/AuditEventCrypto.d.ts.map +1 -0
- package/dist/AuditEventCrypto.js +57 -0
- package/dist/AuditEventCrypto.js.map +1 -0
- package/dist/AuthorizationSigner.d.ts +56 -0
- package/dist/AuthorizationSigner.d.ts.map +1 -0
- package/dist/AuthorizationSigner.js +103 -0
- package/dist/AuthorizationSigner.js.map +1 -0
- package/dist/AuthorizationVerifier.d.ts +53 -0
- package/dist/AuthorizationVerifier.d.ts.map +1 -0
- package/dist/AuthorizationVerifier.js +66 -0
- package/dist/AuthorizationVerifier.js.map +1 -0
- package/dist/CallerAuditChainVerifier.d.ts +62 -0
- package/dist/CallerAuditChainVerifier.d.ts.map +1 -0
- package/dist/CallerAuditChainVerifier.js +97 -0
- package/dist/CallerAuditChainVerifier.js.map +1 -0
- package/dist/CanonicalSerializer.d.ts +26 -0
- package/dist/CanonicalSerializer.d.ts.map +1 -0
- package/dist/CanonicalSerializer.js +78 -0
- package/dist/CanonicalSerializer.js.map +1 -0
- package/dist/CryptoBootstrap.d.ts +27 -0
- package/dist/CryptoBootstrap.d.ts.map +1 -0
- package/dist/CryptoBootstrap.js +70 -0
- package/dist/CryptoBootstrap.js.map +1 -0
- package/dist/CryptoBuilder.d.ts +27 -0
- package/dist/CryptoBuilder.d.ts.map +1 -0
- package/dist/CryptoBuilder.js +42 -0
- package/dist/CryptoBuilder.js.map +1 -0
- package/dist/ExecutableContentHasher.d.ts +22 -0
- package/dist/ExecutableContentHasher.d.ts.map +1 -0
- package/dist/ExecutableContentHasher.js +25 -0
- package/dist/ExecutableContentHasher.js.map +1 -0
- package/dist/ExecutionChainCrypto.d.ts +78 -0
- package/dist/ExecutionChainCrypto.d.ts.map +1 -0
- package/dist/ExecutionChainCrypto.js +165 -0
- package/dist/ExecutionChainCrypto.js.map +1 -0
- package/dist/ExecutionChainHasher.d.ts +10 -0
- package/dist/ExecutionChainHasher.d.ts.map +1 -0
- package/dist/ExecutionChainHasher.js +13 -0
- package/dist/ExecutionChainHasher.js.map +1 -0
- package/dist/ExecutionIntentCanonicalView.d.ts +28 -0
- package/dist/ExecutionIntentCanonicalView.d.ts.map +1 -0
- package/dist/ExecutionIntentCanonicalView.js +29 -0
- package/dist/ExecutionIntentCanonicalView.js.map +1 -0
- package/dist/ExecutionIntentCrypto.d.ts +21 -0
- package/dist/ExecutionIntentCrypto.d.ts.map +1 -0
- package/dist/ExecutionIntentCrypto.js +47 -0
- package/dist/ExecutionIntentCrypto.js.map +1 -0
- package/dist/ExecutionTrustRecordCanonicalView.d.ts +89 -0
- package/dist/ExecutionTrustRecordCanonicalView.d.ts.map +1 -0
- package/dist/ExecutionTrustRecordCanonicalView.js +106 -0
- package/dist/ExecutionTrustRecordCanonicalView.js.map +1 -0
- package/dist/HybridSignatureProvider.d.ts +48 -0
- package/dist/HybridSignatureProvider.d.ts.map +1 -0
- package/dist/HybridSignatureProvider.js +90 -0
- package/dist/HybridSignatureProvider.js.map +1 -0
- package/dist/KeyBootstrap.d.ts +23 -0
- package/dist/KeyBootstrap.d.ts.map +1 -0
- package/dist/KeyBootstrap.js +37 -0
- package/dist/KeyBootstrap.js.map +1 -0
- package/dist/KeyExpiry.d.ts +34 -0
- package/dist/KeyExpiry.d.ts.map +1 -0
- package/dist/KeyExpiry.js +66 -0
- package/dist/KeyExpiry.js.map +1 -0
- package/dist/KeyPair.d.ts +25 -0
- package/dist/KeyPair.d.ts.map +1 -0
- package/dist/KeyPair.js +37 -0
- package/dist/KeyPair.js.map +1 -0
- package/dist/KeyProvider.d.ts +98 -0
- package/dist/KeyProvider.d.ts.map +1 -0
- package/dist/KeyProvider.js +57 -0
- package/dist/KeyProvider.js.map +1 -0
- package/dist/KeyStore.d.ts +35 -0
- package/dist/KeyStore.d.ts.map +1 -0
- package/dist/KeyStore.js +2 -0
- package/dist/KeyStore.js.map +1 -0
- package/dist/OfflineVerifier.d.ts +80 -0
- package/dist/OfflineVerifier.d.ts.map +1 -0
- package/dist/OfflineVerifier.js +271 -0
- package/dist/OfflineVerifier.js.map +1 -0
- package/dist/PolicyChangeCrypto.d.ts +44 -0
- package/dist/PolicyChangeCrypto.d.ts.map +1 -0
- package/dist/PolicyChangeCrypto.js +79 -0
- package/dist/PolicyChangeCrypto.js.map +1 -0
- package/dist/PolicyChangeStepUpAuthorizationCrypto.d.ts +55 -0
- package/dist/PolicyChangeStepUpAuthorizationCrypto.d.ts.map +1 -0
- package/dist/PolicyChangeStepUpAuthorizationCrypto.js +107 -0
- package/dist/PolicyChangeStepUpAuthorizationCrypto.js.map +1 -0
- package/dist/ReceiptCrypto.d.ts +44 -0
- package/dist/ReceiptCrypto.d.ts.map +1 -0
- package/dist/ReceiptCrypto.js +84 -0
- package/dist/ReceiptCrypto.js.map +1 -0
- package/dist/ReceiptHasher.d.ts +10 -0
- package/dist/ReceiptHasher.d.ts.map +1 -0
- package/dist/ReceiptHasher.js +13 -0
- package/dist/ReceiptHasher.js.map +1 -0
- package/dist/RefusalCrypto.d.ts +35 -0
- package/dist/RefusalCrypto.d.ts.map +1 -0
- package/dist/RefusalCrypto.js +73 -0
- package/dist/RefusalCrypto.js.map +1 -0
- package/dist/SignatureCommitment.d.ts +33 -0
- package/dist/SignatureCommitment.d.ts.map +1 -0
- package/dist/SignatureCommitment.js +42 -0
- package/dist/SignatureCommitment.js.map +1 -0
- package/dist/SignatureVerifier.d.ts +20 -0
- package/dist/SignatureVerifier.d.ts.map +1 -0
- package/dist/SignatureVerifier.js +25 -0
- package/dist/SignatureVerifier.js.map +1 -0
- package/dist/Signer.d.ts +49 -0
- package/dist/Signer.d.ts.map +1 -0
- package/dist/Signer.js +2 -0
- package/dist/Signer.js.map +1 -0
- package/dist/SignerBootstrap.d.ts +37 -0
- package/dist/SignerBootstrap.d.ts.map +1 -0
- package/dist/SignerBootstrap.js +52 -0
- package/dist/SignerBootstrap.js.map +1 -0
- package/dist/TrustRecordHasher.d.ts +18 -0
- package/dist/TrustRecordHasher.d.ts.map +1 -0
- package/dist/TrustRecordHasher.js +23 -0
- package/dist/TrustRecordHasher.js.map +1 -0
- package/dist/VerificationCrypto.d.ts +132 -0
- package/dist/VerificationCrypto.d.ts.map +1 -0
- package/dist/VerificationCrypto.js +229 -0
- package/dist/VerificationCrypto.js.map +1 -0
- package/dist/errors/CryptoError.d.ts +14 -0
- package/dist/errors/CryptoError.d.ts.map +1 -0
- package/dist/errors/CryptoError.js +18 -0
- package/dist/errors/CryptoError.js.map +1 -0
- package/dist/index.d.ts +49 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +73 -0
- package/dist/index.js.map +1 -0
- package/dist/models/HybridCryptoProvider.d.ts +9 -0
- package/dist/models/HybridCryptoProvider.d.ts.map +1 -0
- package/dist/models/HybridCryptoProvider.js +2 -0
- package/dist/models/HybridCryptoProvider.js.map +1 -0
- package/dist/providers/CryptoProvider.d.ts +15 -0
- package/dist/providers/CryptoProvider.d.ts.map +1 -0
- package/dist/providers/CryptoProvider.js +2 -0
- package/dist/providers/CryptoProvider.js.map +1 -0
- package/dist/providers/HashProvider.d.ts +17 -0
- package/dist/providers/HashProvider.d.ts.map +1 -0
- package/dist/providers/HashProvider.js +2 -0
- package/dist/providers/HashProvider.js.map +1 -0
- package/dist/providers/HashRegistry.d.ts +11 -0
- package/dist/providers/HashRegistry.d.ts.map +1 -0
- package/dist/providers/HashRegistry.js +18 -0
- package/dist/providers/HashRegistry.js.map +1 -0
- package/dist/providers/ProviderFactory.d.ts +11 -0
- package/dist/providers/ProviderFactory.d.ts.map +1 -0
- package/dist/providers/ProviderFactory.js +13 -0
- package/dist/providers/ProviderFactory.js.map +1 -0
- package/dist/providers/SignatureProvider.d.ts +25 -0
- package/dist/providers/SignatureProvider.d.ts.map +1 -0
- package/dist/providers/SignatureProvider.js +2 -0
- package/dist/providers/SignatureProvider.js.map +1 -0
- package/dist/providers/SignatureRegistry.d.ts +11 -0
- package/dist/providers/SignatureRegistry.d.ts.map +1 -0
- package/dist/providers/SignatureRegistry.js +18 -0
- package/dist/providers/SignatureRegistry.js.map +1 -0
- package/dist/providers/SignerKeyProviderAdapter.d.ts +50 -0
- package/dist/providers/SignerKeyProviderAdapter.d.ts.map +1 -0
- package/dist/providers/SignerKeyProviderAdapter.js +66 -0
- package/dist/providers/SignerKeyProviderAdapter.js.map +1 -0
- package/dist/providers/hash/SHA256HashProvider.d.ts +10 -0
- package/dist/providers/hash/SHA256HashProvider.d.ts.map +1 -0
- package/dist/providers/hash/SHA256HashProvider.js +12 -0
- package/dist/providers/hash/SHA256HashProvider.js.map +1 -0
- package/dist/providers/key/FileKeyProvider.d.ts +85 -0
- package/dist/providers/key/FileKeyProvider.d.ts.map +1 -0
- package/dist/providers/key/FileKeyProvider.js +163 -0
- package/dist/providers/key/FileKeyProvider.js.map +1 -0
- package/dist/providers/signature/Dilithium3SignatureProvider.d.ts +23 -0
- package/dist/providers/signature/Dilithium3SignatureProvider.d.ts.map +1 -0
- package/dist/providers/signature/Dilithium3SignatureProvider.js +33 -0
- package/dist/providers/signature/Dilithium3SignatureProvider.js.map +1 -0
- package/dist/providers/signature/Ed25519SignatureProvider.d.ts +17 -0
- package/dist/providers/signature/Ed25519SignatureProvider.d.ts.map +1 -0
- package/dist/providers/signature/Ed25519SignatureProvider.js +40 -0
- package/dist/providers/signature/Ed25519SignatureProvider.js.map +1 -0
- package/dist/providers/signature/assertKeyType.d.ts +14 -0
- package/dist/providers/signature/assertKeyType.d.ts.map +1 -0
- package/dist/providers/signature/assertKeyType.js +19 -0
- package/dist/providers/signature/assertKeyType.js.map +1 -0
- package/dist/providers/signer/KmsSigner.d.ts +71 -0
- package/dist/providers/signer/KmsSigner.d.ts.map +1 -0
- package/dist/providers/signer/KmsSigner.js +270 -0
- package/dist/providers/signer/KmsSigner.js.map +1 -0
- package/dist/providers/signer/LocalFileSigner.d.ts +28 -0
- package/dist/providers/signer/LocalFileSigner.d.ts.map +1 -0
- package/dist/providers/signer/LocalFileSigner.js +38 -0
- package/dist/providers/signer/LocalFileSigner.js.map +1 -0
- package/dist/support/MlDsaSupport.d.ts +9 -0
- package/dist/support/MlDsaSupport.d.ts.map +1 -0
- package/dist/support/MlDsaSupport.js +23 -0
- package/dist/support/MlDsaSupport.js.map +1 -0
- package/package.json +45 -4
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Registry of hash providers.
|
|
3
|
+
*/
|
|
4
|
+
export class HashRegistry {
|
|
5
|
+
providers = new Map();
|
|
6
|
+
register(provider) {
|
|
7
|
+
this.providers.set(provider.algorithm, provider);
|
|
8
|
+
return this;
|
|
9
|
+
}
|
|
10
|
+
get(algorithm) {
|
|
11
|
+
const provider = this.providers.get(algorithm);
|
|
12
|
+
if (!provider) {
|
|
13
|
+
throw new Error(`Unknown hash provider: ${algorithm}`);
|
|
14
|
+
}
|
|
15
|
+
return provider;
|
|
16
|
+
}
|
|
17
|
+
}
|
|
18
|
+
//# sourceMappingURL=HashRegistry.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"HashRegistry.js","sourceRoot":"","sources":["../../src/providers/HashRegistry.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,OAAO,YAAY;IACN,SAAS,GAAG,IAAI,GAAG,EAA+B,CAAC;IAEpE,QAAQ,CAAC,QAAsB;QAC7B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAEjD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,GAAG,CAAC,SAAwB;QAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAE/C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,0BAA0B,SAAS,EAAE,CAAC,CAAC;QACzD,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF"}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import type { CryptoProvider } from "./CryptoProvider.js";
|
|
2
|
+
/**
|
|
3
|
+
* Provider Factory.
|
|
4
|
+
*
|
|
5
|
+
* Compatibility wrapper around the
|
|
6
|
+
* canonical CryptoBootstrap.
|
|
7
|
+
*/
|
|
8
|
+
export declare class ProviderFactory {
|
|
9
|
+
static create(): CryptoProvider;
|
|
10
|
+
}
|
|
11
|
+
//# sourceMappingURL=ProviderFactory.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ProviderFactory.d.ts","sourceRoot":"","sources":["../../src/providers/ProviderFactory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAI1D;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B,MAAM,CAAC,MAAM,IAAI,cAAc,CAE9B;CACF"}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import { CryptoBootstrap } from "../CryptoBootstrap.js";
|
|
2
|
+
/**
|
|
3
|
+
* Provider Factory.
|
|
4
|
+
*
|
|
5
|
+
* Compatibility wrapper around the
|
|
6
|
+
* canonical CryptoBootstrap.
|
|
7
|
+
*/
|
|
8
|
+
export class ProviderFactory {
|
|
9
|
+
static create() {
|
|
10
|
+
return CryptoBootstrap.create();
|
|
11
|
+
}
|
|
12
|
+
}
|
|
13
|
+
//# sourceMappingURL=ProviderFactory.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ProviderFactory.js","sourceRoot":"","sources":["../../src/providers/ProviderFactory.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD;;;;;GAKG;AACH,MAAM,OAAO,eAAe;IAC1B,MAAM,CAAC,MAAM;QACX,OAAO,eAAe,CAAC,MAAM,EAAE,CAAC;IAClC,CAAC;CACF"}
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
import type { KeyObject } from "node:crypto";
|
|
2
|
+
import type { SignatureAlgorithm } from "@parmana/shared";
|
|
3
|
+
/**
|
|
4
|
+
* Signature Provider.
|
|
5
|
+
*
|
|
6
|
+
* Performs cryptographic signature operations.
|
|
7
|
+
*
|
|
8
|
+
* Key management is intentionally external to the
|
|
9
|
+
* provider and is handled by a KeyProvider.
|
|
10
|
+
*/
|
|
11
|
+
export interface SignatureProvider {
|
|
12
|
+
/**
|
|
13
|
+
* Canonical signature algorithm.
|
|
14
|
+
*/
|
|
15
|
+
readonly algorithm: SignatureAlgorithm;
|
|
16
|
+
/**
|
|
17
|
+
* Creates a signature using the supplied private key.
|
|
18
|
+
*/
|
|
19
|
+
sign(data: Uint8Array, privateKey: KeyObject): Promise<string>;
|
|
20
|
+
/**
|
|
21
|
+
* Verifies a signature using the supplied public key.
|
|
22
|
+
*/
|
|
23
|
+
verify(data: Uint8Array, signature: string, publicKey: KeyObject): Promise<boolean>;
|
|
24
|
+
}
|
|
25
|
+
//# sourceMappingURL=SignatureProvider.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"SignatureProvider.d.ts","sourceRoot":"","sources":["../../src/providers/SignatureProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IAEvC;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE/D;;OAEG;IACH,MAAM,CACJ,IAAI,EAAE,UAAU,EAChB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,OAAO,CAAC,CAAC;CACrB"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"SignatureProvider.js","sourceRoot":"","sources":["../../src/providers/SignatureProvider.ts"],"names":[],"mappings":""}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import type { SignatureAlgorithm } from "@parmana/shared";
|
|
2
|
+
import type { SignatureProvider } from "./SignatureProvider.js";
|
|
3
|
+
/**
|
|
4
|
+
* Registry of signature providers.
|
|
5
|
+
*/
|
|
6
|
+
export declare class SignatureRegistry {
|
|
7
|
+
private readonly providers;
|
|
8
|
+
register(provider: SignatureProvider): this;
|
|
9
|
+
get(algorithm: SignatureAlgorithm): SignatureProvider;
|
|
10
|
+
}
|
|
11
|
+
//# sourceMappingURL=SignatureRegistry.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"SignatureRegistry.d.ts","sourceRoot":"","sources":["../../src/providers/SignatureRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoD;IAE9E,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAI1C;IAED,GAAG,CAAC,SAAS,EAAE,kBAAkB,GAAG,iBAAiB,CAQpD;CACF"}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Registry of signature providers.
|
|
3
|
+
*/
|
|
4
|
+
export class SignatureRegistry {
|
|
5
|
+
providers = new Map();
|
|
6
|
+
register(provider) {
|
|
7
|
+
this.providers.set(provider.algorithm, provider);
|
|
8
|
+
return this;
|
|
9
|
+
}
|
|
10
|
+
get(algorithm) {
|
|
11
|
+
const provider = this.providers.get(algorithm);
|
|
12
|
+
if (!provider) {
|
|
13
|
+
throw new Error(`Unknown signature provider: ${algorithm}`);
|
|
14
|
+
}
|
|
15
|
+
return provider;
|
|
16
|
+
}
|
|
17
|
+
}
|
|
18
|
+
//# sourceMappingURL=SignatureRegistry.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"SignatureRegistry.js","sourceRoot":"","sources":["../../src/providers/SignatureRegistry.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,OAAO,iBAAiB;IACX,SAAS,GAAG,IAAI,GAAG,EAAyC,CAAC;IAE9E,QAAQ,CAAC,QAA2B;QAClC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAEjD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,GAAG,CAAC,SAA6B;QAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAE/C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,+BAA+B,SAAS,EAAE,CAAC,CAAC;QAC9D,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF"}
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
import type { KeyObject } from "node:crypto";
|
|
2
|
+
import type { KeyMetadata, KeyProvider } from "../KeyProvider.js";
|
|
3
|
+
import type { Signer } from "../Signer.js";
|
|
4
|
+
/**
|
|
5
|
+
* Adapts a Signer (ADR-0009's sign-without-release abstraction) to the
|
|
6
|
+
* read-only surface of KeyProvider, for call sites that were written
|
|
7
|
+
* against KeyProvider before Signer existed and only ever use its read
|
|
8
|
+
* operations (getPublicKey/getMetadata/hasKey/listKeys) -- never
|
|
9
|
+
* getPrivateKey.
|
|
10
|
+
*
|
|
11
|
+
* Root cause this exists to fix (found 2026-09-16, live production
|
|
12
|
+
* traffic): EnvelopeVerifier.resolveKey() uses `keyProvider` -- when
|
|
13
|
+
* supplied at all -- for EVERY authorization it verifies, including
|
|
14
|
+
* ones signed under the plain "default" keyId, not only tenant-scoped
|
|
15
|
+
* ones (contrary to this codebase's own earlier assessment the night
|
|
16
|
+
* before, in createExecutionGateway.ts's "KNOWN GAP" comment, that this
|
|
17
|
+
* path was "currently inert" -- it was not). createExecutionGateway.ts
|
|
18
|
+
* unconditionally passed `new FileKeyProvider()` as that keyProvider
|
|
19
|
+
* regardless of KEY_PROVIDER, so under KEY_PROVIDER=aws-kms, every
|
|
20
|
+
* authorization -- signed by the real KMS key via SignerBootstrap --
|
|
21
|
+
* was verified against whatever STALE local default.public.pem
|
|
22
|
+
* happened to still be materialized from PARMANA_KEY_MATERIAL_JSON's
|
|
23
|
+
* pre-KMS-migration entry. Signing key and verifying key silently
|
|
24
|
+
* diverged, failing signatureVerified (and everything that cascades
|
|
25
|
+
* from it: businessTransactionHashMatches, nonceUnseen) on every real
|
|
26
|
+
* request. Passing a SignerKeyProviderAdapter wrapping the SAME Signer
|
|
27
|
+
* createGatewayPublicKey() already uses closes that divergence: signing
|
|
28
|
+
* and per-authorization verification now resolve through the identical
|
|
29
|
+
* KMS-backed (or local-file-backed, under KEY_PROVIDER=local) source.
|
|
30
|
+
*/
|
|
31
|
+
export declare class SignerKeyProviderAdapter implements KeyProvider {
|
|
32
|
+
private readonly signer;
|
|
33
|
+
constructor(signer: Signer);
|
|
34
|
+
getMetadata(keyId: string): Promise<KeyMetadata>;
|
|
35
|
+
getPublicKey(keyId: string): Promise<KeyObject>;
|
|
36
|
+
/**
|
|
37
|
+
* Always throws: a Signer never releases private key material (that
|
|
38
|
+
* is the entire point of ADR-0009 for KmsSigner specifically), so
|
|
39
|
+
* this cannot be honestly implemented. Loud and immediate, not a
|
|
40
|
+
* silent no-op, so a call site that actually needed private key
|
|
41
|
+
* material (this adapter is for verification-only consumers) fails
|
|
42
|
+
* fast during development rather than misbehaving quietly in
|
|
43
|
+
* production -- the same "fail fast on a missed call site" precedent
|
|
44
|
+
* KmsSigner.sign()'s own design note sets for the reverse direction.
|
|
45
|
+
*/
|
|
46
|
+
getPrivateKey(): Promise<KeyObject>;
|
|
47
|
+
hasKey(keyId: string): Promise<boolean>;
|
|
48
|
+
listKeys(): Promise<string[]>;
|
|
49
|
+
}
|
|
50
|
+
//# sourceMappingURL=SignerKeyProviderAdapter.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"SignerKeyProviderAdapter.d.ts","sourceRoot":"","sources":["../../src/providers/SignerKeyProviderAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAG3C;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,wBAAyB,YAAW,WAAW;IAC9C,OAAO,CAAC,QAAQ,CAAC,MAAM;IAAnC,YAA6B,MAAM,EAAE,MAAM,EAAI;IAEzC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAErD;IAEK,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAEpD;IAED;;;;;;;;;OASG;IACG,aAAa,IAAI,OAAO,CAAC,SAAS,CAAC,CAOxC;IAEK,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE5C;IAEK,QAAQ,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAQlC;CACF"}
|
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
import { CryptoError } from "../errors/CryptoError.js";
|
|
2
|
+
/**
|
|
3
|
+
* Adapts a Signer (ADR-0009's sign-without-release abstraction) to the
|
|
4
|
+
* read-only surface of KeyProvider, for call sites that were written
|
|
5
|
+
* against KeyProvider before Signer existed and only ever use its read
|
|
6
|
+
* operations (getPublicKey/getMetadata/hasKey/listKeys) -- never
|
|
7
|
+
* getPrivateKey.
|
|
8
|
+
*
|
|
9
|
+
* Root cause this exists to fix (found 2026-09-16, live production
|
|
10
|
+
* traffic): EnvelopeVerifier.resolveKey() uses `keyProvider` -- when
|
|
11
|
+
* supplied at all -- for EVERY authorization it verifies, including
|
|
12
|
+
* ones signed under the plain "default" keyId, not only tenant-scoped
|
|
13
|
+
* ones (contrary to this codebase's own earlier assessment the night
|
|
14
|
+
* before, in createExecutionGateway.ts's "KNOWN GAP" comment, that this
|
|
15
|
+
* path was "currently inert" -- it was not). createExecutionGateway.ts
|
|
16
|
+
* unconditionally passed `new FileKeyProvider()` as that keyProvider
|
|
17
|
+
* regardless of KEY_PROVIDER, so under KEY_PROVIDER=aws-kms, every
|
|
18
|
+
* authorization -- signed by the real KMS key via SignerBootstrap --
|
|
19
|
+
* was verified against whatever STALE local default.public.pem
|
|
20
|
+
* happened to still be materialized from PARMANA_KEY_MATERIAL_JSON's
|
|
21
|
+
* pre-KMS-migration entry. Signing key and verifying key silently
|
|
22
|
+
* diverged, failing signatureVerified (and everything that cascades
|
|
23
|
+
* from it: businessTransactionHashMatches, nonceUnseen) on every real
|
|
24
|
+
* request. Passing a SignerKeyProviderAdapter wrapping the SAME Signer
|
|
25
|
+
* createGatewayPublicKey() already uses closes that divergence: signing
|
|
26
|
+
* and per-authorization verification now resolve through the identical
|
|
27
|
+
* KMS-backed (or local-file-backed, under KEY_PROVIDER=local) source.
|
|
28
|
+
*/
|
|
29
|
+
export class SignerKeyProviderAdapter {
|
|
30
|
+
signer;
|
|
31
|
+
constructor(signer) {
|
|
32
|
+
this.signer = signer;
|
|
33
|
+
}
|
|
34
|
+
async getMetadata(keyId) {
|
|
35
|
+
return this.signer.getMetadata(keyId);
|
|
36
|
+
}
|
|
37
|
+
async getPublicKey(keyId) {
|
|
38
|
+
return this.signer.getPublicKey(keyId);
|
|
39
|
+
}
|
|
40
|
+
/**
|
|
41
|
+
* Always throws: a Signer never releases private key material (that
|
|
42
|
+
* is the entire point of ADR-0009 for KmsSigner specifically), so
|
|
43
|
+
* this cannot be honestly implemented. Loud and immediate, not a
|
|
44
|
+
* silent no-op, so a call site that actually needed private key
|
|
45
|
+
* material (this adapter is for verification-only consumers) fails
|
|
46
|
+
* fast during development rather than misbehaving quietly in
|
|
47
|
+
* production -- the same "fail fast on a missed call site" precedent
|
|
48
|
+
* KmsSigner.sign()'s own design note sets for the reverse direction.
|
|
49
|
+
*/
|
|
50
|
+
async getPrivateKey() {
|
|
51
|
+
throw new CryptoError("SignerKeyProviderAdapter does not expose private key material -- " +
|
|
52
|
+
"it wraps a Signer (sign-without-release), which never releases a " +
|
|
53
|
+
"private key by design. A caller that needs to sign should depend " +
|
|
54
|
+
"on Signer directly, not KeyProvider.getPrivateKey().");
|
|
55
|
+
}
|
|
56
|
+
async hasKey(keyId) {
|
|
57
|
+
return this.signer.hasKey(keyId);
|
|
58
|
+
}
|
|
59
|
+
async listKeys() {
|
|
60
|
+
if (!this.signer.listKeys) {
|
|
61
|
+
throw new CryptoError("The underlying Signer does not support listKeys().");
|
|
62
|
+
}
|
|
63
|
+
return this.signer.listKeys();
|
|
64
|
+
}
|
|
65
|
+
}
|
|
66
|
+
//# sourceMappingURL=SignerKeyProviderAdapter.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"SignerKeyProviderAdapter.js","sourceRoot":"","sources":["../../src/providers/SignerKeyProviderAdapter.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,OAAO,wBAAwB;IACN,MAAM;IAAnC,YAA6B,MAAc;sBAAd,MAAM;IAAW,CAAC;IAE/C,KAAK,CAAC,WAAW,CAAC,KAAa;QAC7B,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,KAAa;QAC9B,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,aAAa;QACjB,MAAM,IAAI,WAAW,CACnB,mEAAmE;YACjE,mEAAmE;YACnE,mEAAmE;YACnE,sDAAsD,CACzD,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAa;QACxB,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YAC1B,MAAM,IAAI,WAAW,CACnB,oDAAoD,CACrD,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;IAChC,CAAC;CACF"}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import { type HashAlgorithm } from "@parmana/shared";
|
|
2
|
+
import type { HashProvider } from "../HashProvider.js";
|
|
3
|
+
/**
|
|
4
|
+
* SHA-256 Hash Provider.
|
|
5
|
+
*/
|
|
6
|
+
export declare class SHA256HashProvider implements HashProvider {
|
|
7
|
+
readonly algorithm: HashAlgorithm;
|
|
8
|
+
hash(data: Uint8Array): Promise<string>;
|
|
9
|
+
}
|
|
10
|
+
//# sourceMappingURL=SHA256HashProvider.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"SHA256HashProvider.d.ts","sourceRoot":"","sources":["../../../src/providers/hash/SHA256HashProvider.ts"],"names":[],"mappings":"AAEA,OAAO,EAAkB,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;GAEG;AACH,qBAAa,kBAAmB,YAAW,YAAY;IACrD,SAAgB,SAAS,EAAE,aAAa,CAAyB;IAE3D,IAAI,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAE5C;CACF"}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import { createHash } from "node:crypto";
|
|
2
|
+
import { HashAlgorithms } from "@parmana/shared";
|
|
3
|
+
/**
|
|
4
|
+
* SHA-256 Hash Provider.
|
|
5
|
+
*/
|
|
6
|
+
export class SHA256HashProvider {
|
|
7
|
+
algorithm = HashAlgorithms.SHA256;
|
|
8
|
+
async hash(data) {
|
|
9
|
+
return createHash("sha256").update(data).digest("hex");
|
|
10
|
+
}
|
|
11
|
+
}
|
|
12
|
+
//# sourceMappingURL=SHA256HashProvider.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"SHA256HashProvider.js","sourceRoot":"","sources":["../../../src/providers/hash/SHA256HashProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,cAAc,EAAsB,MAAM,iBAAiB,CAAC;AAIrE;;GAEG;AACH,MAAM,OAAO,kBAAkB;IACb,SAAS,GAAkB,cAAc,CAAC,MAAM,CAAC;IAEjE,KAAK,CAAC,IAAI,CAAC,IAAgB;QACzB,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACzD,CAAC;CACF"}
|
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
import { type KeyObject } from "node:crypto";
|
|
2
|
+
import type { KeyMetadata, KeyProvider } from "../../KeyProvider.js";
|
|
3
|
+
/**
|
|
4
|
+
* File Key Provider.
|
|
5
|
+
*
|
|
6
|
+
* Loads signing keys from the local filesystem.
|
|
7
|
+
*
|
|
8
|
+
* Layout:
|
|
9
|
+
*
|
|
10
|
+
* keys/
|
|
11
|
+
* <keyId>.private.pem
|
|
12
|
+
* <keyId>.public.pem
|
|
13
|
+
*
|
|
14
|
+
* This implementation is intended for development
|
|
15
|
+
* and self-hosted deployments. Production
|
|
16
|
+
* environments can replace it with KMS, HSM, or
|
|
17
|
+
* cloud key vault implementations without changing
|
|
18
|
+
* the crypto layer.
|
|
19
|
+
*/
|
|
20
|
+
export declare class FileKeyProvider implements KeyProvider {
|
|
21
|
+
private readonly config;
|
|
22
|
+
private readonly keyDirectory;
|
|
23
|
+
/**
|
|
24
|
+
* Root directory containing Parmana keys.
|
|
25
|
+
*/
|
|
26
|
+
private getKeyDirectory;
|
|
27
|
+
/**
|
|
28
|
+
* Returns true if the key exists.
|
|
29
|
+
*/
|
|
30
|
+
hasKey(keyId: string): Promise<boolean>;
|
|
31
|
+
/**
|
|
32
|
+
* Returns key metadata.
|
|
33
|
+
*
|
|
34
|
+
* PQC audit RED-2 (docs/VERIFICATION-GAPS.md) fix: algorithm is
|
|
35
|
+
* derived from the actual public key material's own
|
|
36
|
+
* `asymmetricKeyType`, not from `config.crypto.primarySignatureProvider`
|
|
37
|
+
* as this method previously did. That global config value describes
|
|
38
|
+
* only the *current* primary signing algorithm -- it is wrong for
|
|
39
|
+
* every other keyId this provider can load (the `gateway` key, any
|
|
40
|
+
* rotated `verification-*` keyId from
|
|
41
|
+
* scripts/rotate-verification-key.ts, or a `default` key kept
|
|
42
|
+
* verifiable after a rotation moved new signing elsewhere). This
|
|
43
|
+
* previously went unnoticed because getMetadata() was never
|
|
44
|
+
* consulted on the hot sign/verify path (assertKeyType.ts's own doc
|
|
45
|
+
* comment already covers that path's real defense); it is
|
|
46
|
+
* consulted now, by the /keys and /.well-known/jwks.json routes
|
|
47
|
+
* (packages/api/src/routes/keys.ts), which need the truth for every
|
|
48
|
+
* keyId, not only whichever one happens to match today's config.
|
|
49
|
+
*
|
|
50
|
+
* Future implementations may load this from a
|
|
51
|
+
* manifest or key registry.
|
|
52
|
+
*/
|
|
53
|
+
getMetadata(keyId: string): Promise<KeyMetadata>;
|
|
54
|
+
/**
|
|
55
|
+
* Loads the private key.
|
|
56
|
+
*/
|
|
57
|
+
getPrivateKey(keyId: string): Promise<KeyObject>;
|
|
58
|
+
/**
|
|
59
|
+
* Loads the public key.
|
|
60
|
+
*/
|
|
61
|
+
getPublicKey(keyId: string): Promise<KeyObject>;
|
|
62
|
+
/**
|
|
63
|
+
* Lists every keyId with a readable `<keyId>.public.pem` in this
|
|
64
|
+
* provider's key directory (PQC audit RED-2). A keyId with only a
|
|
65
|
+
* private key file (should not occur in practice, since every key
|
|
66
|
+
* this codebase generates writes both halves together) is not
|
|
67
|
+
* listed -- discovery is about what a third party can verify
|
|
68
|
+
* against, which needs the public half specifically.
|
|
69
|
+
*/
|
|
70
|
+
listKeys(): Promise<string[]>;
|
|
71
|
+
/**
|
|
72
|
+
* Resolves the private key path.
|
|
73
|
+
*/
|
|
74
|
+
private privateKeyPath;
|
|
75
|
+
/**
|
|
76
|
+
* Resolves the public key path.
|
|
77
|
+
*/
|
|
78
|
+
private publicKeyPath;
|
|
79
|
+
/**
|
|
80
|
+
* `<keyDirectory>/<keyId>.<kind>.pem`, after assertValidKeyId() and a
|
|
81
|
+
* second check that the resolved path stays inside the key directory.
|
|
82
|
+
*/
|
|
83
|
+
private keyFilePath;
|
|
84
|
+
}
|
|
85
|
+
//# sourceMappingURL=FileKeyProvider.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"FileKeyProvider.d.ts","sourceRoot":"","sources":["../../../src/providers/key/FileKeyProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqC,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAchF,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAyCrE;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,eAAgB,YAAW,WAAW;IACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IAEvC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6C;IAE1E;;OAEG;IACH,OAAO,CAAC,eAAe;IAQvB;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE5C;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAWrD;IAED;;OAEG;IACG,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAQrD;IAED;;OAEG;IACG,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAQpD;IAED;;;;;;;OAOG;IACG,QAAQ,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAQlC;IAED;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACH,OAAO,CAAC,aAAa;IAIrB;;;OAGG;IACH,OAAO,CAAC,WAAW;CAcpB"}
|
|
@@ -0,0 +1,163 @@
|
|
|
1
|
+
import { createPrivateKey, createPublicKey } from "node:crypto";
|
|
2
|
+
import { existsSync, readFileSync } from "node:fs";
|
|
3
|
+
import { readdir } from "node:fs/promises";
|
|
4
|
+
import { resolve, sep } from "node:path";
|
|
5
|
+
import { loadConfig, SignatureAlgorithms, } from "@parmana/shared";
|
|
6
|
+
import { CryptoError } from "../../errors/CryptoError.js";
|
|
7
|
+
/**
|
|
8
|
+
* Maps a node:crypto KeyObject's own `asymmetricKeyType` back to this
|
|
9
|
+
* codebase's SignatureAlgorithm identifiers -- the same "ml-dsa-65"
|
|
10
|
+
* internal-name alias Dilithium3SignatureProvider.ts and
|
|
11
|
+
* scripts/generate-keypair.ts already use. Unrecognized key types
|
|
12
|
+
* (a key file this codebase has no SignatureProvider for) throw
|
|
13
|
+
* rather than silently mislabeling the key's algorithm.
|
|
14
|
+
*/
|
|
15
|
+
function algorithmFromKeyType(keyType) {
|
|
16
|
+
if (keyType === "ed25519") {
|
|
17
|
+
return SignatureAlgorithms.ED25519;
|
|
18
|
+
}
|
|
19
|
+
if (keyType === "ml-dsa-65") {
|
|
20
|
+
return SignatureAlgorithms.DILITHIUM3;
|
|
21
|
+
}
|
|
22
|
+
throw new CryptoError(`Key material has unrecognized asymmetricKeyType: ${JSON.stringify(keyType)}.`);
|
|
23
|
+
}
|
|
24
|
+
/**
|
|
25
|
+
* keyId becomes a path segment (`<keyId>.private.pem`); anything outside
|
|
26
|
+
* this set (path separators, `..`, null bytes, etc.) could otherwise walk
|
|
27
|
+
* out of the configured key directory.
|
|
28
|
+
*/
|
|
29
|
+
const VALID_KEY_ID = /^[A-Za-z0-9._-]+$/;
|
|
30
|
+
function assertValidKeyId(keyId) {
|
|
31
|
+
if (!VALID_KEY_ID.test(keyId)) {
|
|
32
|
+
throw new CryptoError(`Invalid keyId: ${JSON.stringify(keyId)}. Must match ${VALID_KEY_ID}.`);
|
|
33
|
+
}
|
|
34
|
+
}
|
|
35
|
+
/**
|
|
36
|
+
* File Key Provider.
|
|
37
|
+
*
|
|
38
|
+
* Loads signing keys from the local filesystem.
|
|
39
|
+
*
|
|
40
|
+
* Layout:
|
|
41
|
+
*
|
|
42
|
+
* keys/
|
|
43
|
+
* <keyId>.private.pem
|
|
44
|
+
* <keyId>.public.pem
|
|
45
|
+
*
|
|
46
|
+
* This implementation is intended for development
|
|
47
|
+
* and self-hosted deployments. Production
|
|
48
|
+
* environments can replace it with KMS, HSM, or
|
|
49
|
+
* cloud key vault implementations without changing
|
|
50
|
+
* the crypto layer.
|
|
51
|
+
*/
|
|
52
|
+
export class FileKeyProvider {
|
|
53
|
+
config = loadConfig();
|
|
54
|
+
keyDirectory = this.config.keys.keyDirectory ?? "./keys";
|
|
55
|
+
/**
|
|
56
|
+
* Root directory containing Parmana keys.
|
|
57
|
+
*/
|
|
58
|
+
getKeyDirectory() {
|
|
59
|
+
if (!existsSync(this.keyDirectory)) {
|
|
60
|
+
throw new Error(`Key directory does not exist: ${this.keyDirectory}`);
|
|
61
|
+
}
|
|
62
|
+
return this.keyDirectory;
|
|
63
|
+
}
|
|
64
|
+
/**
|
|
65
|
+
* Returns true if the key exists.
|
|
66
|
+
*/
|
|
67
|
+
async hasKey(keyId) {
|
|
68
|
+
return existsSync(this.privateKeyPath(keyId));
|
|
69
|
+
}
|
|
70
|
+
/**
|
|
71
|
+
* Returns key metadata.
|
|
72
|
+
*
|
|
73
|
+
* PQC audit RED-2 (docs/VERIFICATION-GAPS.md) fix: algorithm is
|
|
74
|
+
* derived from the actual public key material's own
|
|
75
|
+
* `asymmetricKeyType`, not from `config.crypto.primarySignatureProvider`
|
|
76
|
+
* as this method previously did. That global config value describes
|
|
77
|
+
* only the *current* primary signing algorithm -- it is wrong for
|
|
78
|
+
* every other keyId this provider can load (the `gateway` key, any
|
|
79
|
+
* rotated `verification-*` keyId from
|
|
80
|
+
* scripts/rotate-verification-key.ts, or a `default` key kept
|
|
81
|
+
* verifiable after a rotation moved new signing elsewhere). This
|
|
82
|
+
* previously went unnoticed because getMetadata() was never
|
|
83
|
+
* consulted on the hot sign/verify path (assertKeyType.ts's own doc
|
|
84
|
+
* comment already covers that path's real defense); it is
|
|
85
|
+
* consulted now, by the /keys and /.well-known/jwks.json routes
|
|
86
|
+
* (packages/api/src/routes/keys.ts), which need the truth for every
|
|
87
|
+
* keyId, not only whichever one happens to match today's config.
|
|
88
|
+
*
|
|
89
|
+
* Future implementations may load this from a
|
|
90
|
+
* manifest or key registry.
|
|
91
|
+
*/
|
|
92
|
+
async getMetadata(keyId) {
|
|
93
|
+
if (!(await this.hasKey(keyId))) {
|
|
94
|
+
throw new Error(`Key not found: ${keyId}`);
|
|
95
|
+
}
|
|
96
|
+
const publicKey = await this.getPublicKey(keyId);
|
|
97
|
+
return {
|
|
98
|
+
keyId,
|
|
99
|
+
algorithm: algorithmFromKeyType(publicKey.asymmetricKeyType),
|
|
100
|
+
};
|
|
101
|
+
}
|
|
102
|
+
/**
|
|
103
|
+
* Loads the private key.
|
|
104
|
+
*/
|
|
105
|
+
async getPrivateKey(keyId) {
|
|
106
|
+
const path = this.privateKeyPath(keyId);
|
|
107
|
+
if (!existsSync(path)) {
|
|
108
|
+
throw new Error(`Private key not found: ${keyId}`);
|
|
109
|
+
}
|
|
110
|
+
return createPrivateKey(readFileSync(path));
|
|
111
|
+
}
|
|
112
|
+
/**
|
|
113
|
+
* Loads the public key.
|
|
114
|
+
*/
|
|
115
|
+
async getPublicKey(keyId) {
|
|
116
|
+
const path = this.publicKeyPath(keyId);
|
|
117
|
+
if (!existsSync(path)) {
|
|
118
|
+
throw new Error(`Public key not found: ${keyId}`);
|
|
119
|
+
}
|
|
120
|
+
return createPublicKey(readFileSync(path));
|
|
121
|
+
}
|
|
122
|
+
/**
|
|
123
|
+
* Lists every keyId with a readable `<keyId>.public.pem` in this
|
|
124
|
+
* provider's key directory (PQC audit RED-2). A keyId with only a
|
|
125
|
+
* private key file (should not occur in practice, since every key
|
|
126
|
+
* this codebase generates writes both halves together) is not
|
|
127
|
+
* listed -- discovery is about what a third party can verify
|
|
128
|
+
* against, which needs the public half specifically.
|
|
129
|
+
*/
|
|
130
|
+
async listKeys() {
|
|
131
|
+
const directory = this.getKeyDirectory();
|
|
132
|
+
const entries = await readdir(directory);
|
|
133
|
+
return entries
|
|
134
|
+
.filter((entry) => entry.endsWith(".public.pem"))
|
|
135
|
+
.map((entry) => entry.slice(0, -".public.pem".length));
|
|
136
|
+
}
|
|
137
|
+
/**
|
|
138
|
+
* Resolves the private key path.
|
|
139
|
+
*/
|
|
140
|
+
privateKeyPath(keyId) {
|
|
141
|
+
return this.keyFilePath(keyId, "private");
|
|
142
|
+
}
|
|
143
|
+
/**
|
|
144
|
+
* Resolves the public key path.
|
|
145
|
+
*/
|
|
146
|
+
publicKeyPath(keyId) {
|
|
147
|
+
return this.keyFilePath(keyId, "public");
|
|
148
|
+
}
|
|
149
|
+
/**
|
|
150
|
+
* `<keyDirectory>/<keyId>.<kind>.pem`, after assertValidKeyId() and a
|
|
151
|
+
* second check that the resolved path stays inside the key directory.
|
|
152
|
+
*/
|
|
153
|
+
keyFilePath(keyId, kind) {
|
|
154
|
+
assertValidKeyId(keyId);
|
|
155
|
+
const directory = resolve(this.getKeyDirectory());
|
|
156
|
+
const file = resolve(directory, `${keyId}.${kind}.pem`);
|
|
157
|
+
if (!file.startsWith(directory + sep)) {
|
|
158
|
+
throw new CryptoError(`Invalid keyId: ${JSON.stringify(keyId)}. Must name a file in the key directory.`);
|
|
159
|
+
}
|
|
160
|
+
return file;
|
|
161
|
+
}
|
|
162
|
+
}
|
|
163
|
+
//# sourceMappingURL=FileKeyProvider.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"FileKeyProvider.js","sourceRoot":"","sources":["../../../src/providers/key/FileKeyProvider.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
import { type KeyObject } from "node:crypto";
|
|
2
|
+
import { type SignatureAlgorithm } from "@parmana/shared";
|
|
3
|
+
import type { SignatureProvider } from "../SignatureProvider.js";
|
|
4
|
+
/**
|
|
5
|
+
* Dilithium3 (ML-DSA-65) Signature Provider.
|
|
6
|
+
*
|
|
7
|
+
* Stateless implementation of ML-DSA-65 signing via
|
|
8
|
+
* node:crypto's native support (Node >=24, OpenSSL >=3.5).
|
|
9
|
+
*
|
|
10
|
+
* Key management is delegated to a KeyProvider exactly like
|
|
11
|
+
* Ed25519SignatureProvider.
|
|
12
|
+
*
|
|
13
|
+
* ML-DSA-65 signatures are randomized: signing the same
|
|
14
|
+
* message twice with the same key produces different
|
|
15
|
+
* (but valid) signatures.
|
|
16
|
+
*/
|
|
17
|
+
export declare class Dilithium3SignatureProvider implements SignatureProvider {
|
|
18
|
+
readonly algorithm: SignatureAlgorithm;
|
|
19
|
+
constructor();
|
|
20
|
+
sign(data: Uint8Array, privateKey: KeyObject): Promise<string>;
|
|
21
|
+
verify(data: Uint8Array, signature: string, publicKey: KeyObject): Promise<boolean>;
|
|
22
|
+
}
|
|
23
|
+
//# sourceMappingURL=Dilithium3SignatureProvider.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"Dilithium3SignatureProvider.d.ts","sourceRoot":"","sources":["../../../src/providers/signature/Dilithium3SignatureProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAE3D,OAAO,EAAuB,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE/E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAKjE;;;;;;;;;;;;GAYG;AACH,qBAAa,2BAA4B,YAAW,iBAAiB;IACnE,SAAgB,SAAS,EAAE,kBAAkB,CACZ;IAEjC,cAEC;IAEK,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAMnE;IAEK,MAAM,CACV,IAAI,EAAE,UAAU,EAChB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,OAAO,CAAC,CASlB;CACF"}
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
import { sign, verify } from "node:crypto";
|
|
2
|
+
import { SignatureAlgorithms } from "@parmana/shared";
|
|
3
|
+
import { assertKeyType } from "./assertKeyType.js";
|
|
4
|
+
const NODE_KEY_TYPE = "ml-dsa-65";
|
|
5
|
+
/**
|
|
6
|
+
* Dilithium3 (ML-DSA-65) Signature Provider.
|
|
7
|
+
*
|
|
8
|
+
* Stateless implementation of ML-DSA-65 signing via
|
|
9
|
+
* node:crypto's native support (Node >=24, OpenSSL >=3.5).
|
|
10
|
+
*
|
|
11
|
+
* Key management is delegated to a KeyProvider exactly like
|
|
12
|
+
* Ed25519SignatureProvider.
|
|
13
|
+
*
|
|
14
|
+
* ML-DSA-65 signatures are randomized: signing the same
|
|
15
|
+
* message twice with the same key produces different
|
|
16
|
+
* (but valid) signatures.
|
|
17
|
+
*/
|
|
18
|
+
export class Dilithium3SignatureProvider {
|
|
19
|
+
algorithm = SignatureAlgorithms.DILITHIUM3;
|
|
20
|
+
constructor() {
|
|
21
|
+
Object.freeze(this);
|
|
22
|
+
}
|
|
23
|
+
async sign(data, privateKey) {
|
|
24
|
+
assertKeyType(privateKey, NODE_KEY_TYPE, "sign");
|
|
25
|
+
const signature = sign(null, Buffer.from(data), privateKey);
|
|
26
|
+
return signature.toString("base64");
|
|
27
|
+
}
|
|
28
|
+
async verify(data, signature, publicKey) {
|
|
29
|
+
assertKeyType(publicKey, NODE_KEY_TYPE, "verify");
|
|
30
|
+
return verify(null, Buffer.from(data), publicKey, Buffer.from(signature, "base64"));
|
|
31
|
+
}
|
|
32
|
+
}
|
|
33
|
+
//# sourceMappingURL=Dilithium3SignatureProvider.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"Dilithium3SignatureProvider.js","sourceRoot":"","sources":["../../../src/providers/signature/Dilithium3SignatureProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAkB,MAAM,aAAa,CAAC;AAE3D,OAAO,EAAE,mBAAmB,EAA2B,MAAM,iBAAiB,CAAC;AAG/E,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,aAAa,GAAG,WAAW,CAAC;AAElC;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,2BAA2B;IACtB,SAAS,GACvB,mBAAmB,CAAC,UAAU,CAAC;IAEjC;QACE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAAgB,EAAE,UAAqB;QAChD,aAAa,CAAC,UAAU,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC;QAEjD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC,CAAC;QAE5D,OAAO,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,MAAM,CACV,IAAgB,EAChB,SAAiB,EACjB,SAAoB;QAEpB,aAAa,CAAC,SAAS,EAAE,aAAa,EAAE,QAAQ,CAAC,CAAC;QAElD,OAAO,MAAM,CACX,IAAI,EACJ,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EACjB,SAAS,EACT,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CACjC,CAAC;IACJ,CAAC;CACF"}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import { type KeyObject } from "node:crypto";
|
|
2
|
+
import { type SignatureAlgorithm } from "@parmana/shared";
|
|
3
|
+
import type { SignatureProvider } from "../SignatureProvider.js";
|
|
4
|
+
/**
|
|
5
|
+
* Ed25519 Signature Provider.
|
|
6
|
+
*
|
|
7
|
+
* Stateless implementation of Ed25519 signing.
|
|
8
|
+
*
|
|
9
|
+
* Key management is delegated to a KeyProvider.
|
|
10
|
+
*/
|
|
11
|
+
export declare class Ed25519SignatureProvider implements SignatureProvider {
|
|
12
|
+
readonly algorithm: SignatureAlgorithm;
|
|
13
|
+
constructor();
|
|
14
|
+
sign(data: Uint8Array, privateKey: KeyObject): Promise<string>;
|
|
15
|
+
verify(data: Uint8Array, signature: string, publicKey: KeyObject): Promise<boolean>;
|
|
16
|
+
}
|
|
17
|
+
//# sourceMappingURL=Ed25519SignatureProvider.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"Ed25519SignatureProvider.d.ts","sourceRoot":"","sources":["../../../src/providers/signature/Ed25519SignatureProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAE3D,OAAO,EAAuB,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE/E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AASjE;;;;;;GAMG;AACH,qBAAa,wBAAyB,YAAW,iBAAiB;IAChE,SAAgB,SAAS,EAAE,kBAAkB,CAA+B;IAE5E,cAEC;IAEK,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAMnE;IAEK,MAAM,CACV,IAAI,EAAE,UAAU,EAChB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,OAAO,CAAC,CAwBlB;CACF"}
|