@parmana/crypto 0.0.0-stage → 0.1.0
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 +74 -0
- package/dist/OfflineVerifier.d.ts.map +1 -0
- package/dist/OfflineVerifier.js +263 -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,90 @@
|
|
|
1
|
+
import { ArtifactSigner } from "./ArtifactSigner.js";
|
|
2
|
+
import { CanonicalSerializer } from "./CanonicalSerializer.js";
|
|
3
|
+
import { SignatureVerifier } from "./SignatureVerifier.js";
|
|
4
|
+
/**
|
|
5
|
+
* Signs and verifies an artifact with two independent signature
|
|
6
|
+
* algorithms at once (Hybrid Signature Support milestone, Phase A):
|
|
7
|
+
* "harvest now, decrypt/forge later" defense for the classical-to-
|
|
8
|
+
* post-quantum transition -- if a future quantum computer breaks the
|
|
9
|
+
* primary (classical) algorithm, the secondary (post-quantum)
|
|
10
|
+
* signature alone still holds, and vice versa if any weakness is ever
|
|
11
|
+
* found in the newer PQ scheme.
|
|
12
|
+
*
|
|
13
|
+
* Not a SignatureProvider implementer: that interface signs/verifies
|
|
14
|
+
* with exactly one key in, one signature out. Hybrid fundamentally
|
|
15
|
+
* needs two keys and produces two independent signatures, so this is
|
|
16
|
+
* a purpose-built composition on top of two SignatureProviders
|
|
17
|
+
* (via HybridCryptoProvider) and a KeyProvider, mirroring how
|
|
18
|
+
* VerificationCrypto/ReceiptCrypto already resolve keys by id rather
|
|
19
|
+
* than requiring callers to pre-fetch raw KeyObjects.
|
|
20
|
+
*/
|
|
21
|
+
export class HybridSignatureProvider {
|
|
22
|
+
crypto;
|
|
23
|
+
keys;
|
|
24
|
+
serializer;
|
|
25
|
+
constructor(crypto, keys, serializer = new CanonicalSerializer()) {
|
|
26
|
+
this.crypto = crypto;
|
|
27
|
+
this.keys = keys;
|
|
28
|
+
this.serializer = serializer;
|
|
29
|
+
}
|
|
30
|
+
/**
|
|
31
|
+
* Signs the artifact with both configured algorithms, returning
|
|
32
|
+
* both entries in fixed [primary, secondary] order.
|
|
33
|
+
*/
|
|
34
|
+
async sign(artifact, primaryKeyId, secondaryKeyId) {
|
|
35
|
+
const primarySigner = new ArtifactSigner(this.crypto.primary, this.serializer);
|
|
36
|
+
const secondarySigner = new ArtifactSigner(this.crypto.secondary, this.serializer);
|
|
37
|
+
const primaryPrivateKey = await this.keys.getPrivateKey(primaryKeyId);
|
|
38
|
+
const secondaryPrivateKey = await this.keys.getPrivateKey(secondaryKeyId);
|
|
39
|
+
const [primarySignature, secondarySignature] = await Promise.all([
|
|
40
|
+
primarySigner.sign(artifact, primaryPrivateKey),
|
|
41
|
+
secondarySigner.sign(artifact, secondaryPrivateKey),
|
|
42
|
+
]);
|
|
43
|
+
return [
|
|
44
|
+
{
|
|
45
|
+
algorithm: this.crypto.primary.signature.algorithm,
|
|
46
|
+
keyId: primaryKeyId,
|
|
47
|
+
signature: primarySignature,
|
|
48
|
+
},
|
|
49
|
+
{
|
|
50
|
+
algorithm: this.crypto.secondary.signature.algorithm,
|
|
51
|
+
keyId: secondaryKeyId,
|
|
52
|
+
signature: secondarySignature,
|
|
53
|
+
},
|
|
54
|
+
];
|
|
55
|
+
}
|
|
56
|
+
/**
|
|
57
|
+
* Verifies every entry in `signatures`. Fail-closed: requires
|
|
58
|
+
* exactly one entry for the primary algorithm and one for the
|
|
59
|
+
* secondary algorithm -- a missing, extra, duplicated, or
|
|
60
|
+
* mismatched-algorithm entry is a rejection, never a partial pass.
|
|
61
|
+
* Both entries must independently verify against their own
|
|
62
|
+
* algorithm's public key (resolved by the entry's own keyId).
|
|
63
|
+
*
|
|
64
|
+
* Key lookup failures (missing/mismatched key material) are not
|
|
65
|
+
* caught here and propagate as thrown errors, mirroring
|
|
66
|
+
* VerificationCrypto.verifySignature()'s existing precedent: a
|
|
67
|
+
* malformed *signature* is a verification failure (returns false);
|
|
68
|
+
* missing *key infrastructure* is an operational error (throws).
|
|
69
|
+
*/
|
|
70
|
+
async verify(artifact, signatures) {
|
|
71
|
+
if (signatures.length !== 2) {
|
|
72
|
+
return false;
|
|
73
|
+
}
|
|
74
|
+
const primaryEntry = signatures.find((entry) => entry.algorithm === this.crypto.primary.signature.algorithm);
|
|
75
|
+
const secondaryEntry = signatures.find((entry) => entry.algorithm === this.crypto.secondary.signature.algorithm);
|
|
76
|
+
if (!primaryEntry || !secondaryEntry || primaryEntry === secondaryEntry) {
|
|
77
|
+
return false;
|
|
78
|
+
}
|
|
79
|
+
const primaryVerifier = new SignatureVerifier(this.crypto.primary, this.serializer);
|
|
80
|
+
const secondaryVerifier = new SignatureVerifier(this.crypto.secondary, this.serializer);
|
|
81
|
+
const primaryPublicKey = await this.keys.getPublicKey(primaryEntry.keyId);
|
|
82
|
+
const secondaryPublicKey = await this.keys.getPublicKey(secondaryEntry.keyId);
|
|
83
|
+
const [primaryVerified, secondaryVerified] = await Promise.all([
|
|
84
|
+
primaryVerifier.verify(artifact, primaryEntry.signature, primaryPublicKey),
|
|
85
|
+
secondaryVerifier.verify(artifact, secondaryEntry.signature, secondaryPublicKey),
|
|
86
|
+
]);
|
|
87
|
+
return primaryVerified && secondaryVerified;
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
//# sourceMappingURL=HybridSignatureProvider.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"HybridSignatureProvider.js","sourceRoot":"","sources":["../src/HybridSignatureProvider.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
import type { KeyProvider } from "./KeyProvider.js";
|
|
2
|
+
/**
|
|
3
|
+
* Key Bootstrap.
|
|
4
|
+
*
|
|
5
|
+
* Composition root for key management.
|
|
6
|
+
*
|
|
7
|
+
* KEY_PROVIDER accepts "local", "aws-kms", "azure-key-vault",
|
|
8
|
+
* "gcp-kms", and "hsm" (see packages/shared/src/config/KeyProviders.ts)
|
|
9
|
+
* for forward-compatible configuration, but only FileKeyProvider
|
|
10
|
+
* ("local") is actually implemented. Before this check existed, setting
|
|
11
|
+
* KEY_PROVIDER=aws-kms (or any other non-local value) parsed and
|
|
12
|
+
* validated cleanly, then silently constructed a FileKeyProvider anyway
|
|
13
|
+
* — an operator who configured real KMS custody got private-key-on-disk
|
|
14
|
+
* instead, with no error. Failing loudly here, at startup, turns that
|
|
15
|
+
* silent misconfiguration into an immediate, actionable error instead
|
|
16
|
+
* of a false sense of custody. Remove this check only once a real
|
|
17
|
+
* provider class exists for the value being unblocked.
|
|
18
|
+
*/
|
|
19
|
+
export declare class KeyBootstrap {
|
|
20
|
+
private static provider;
|
|
21
|
+
static create(): KeyProvider;
|
|
22
|
+
}
|
|
23
|
+
//# sourceMappingURL=KeyBootstrap.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"KeyBootstrap.d.ts","sourceRoot":"","sources":["../src/KeyBootstrap.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAIpD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAc;IAErC,MAAM,CAAC,MAAM,IAAI,WAAW,CAkB3B;CACF"}
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
import { KeyProviders, loadConfig } from "@parmana/shared";
|
|
2
|
+
import { FileKeyProvider } from "./providers/key/FileKeyProvider.js";
|
|
3
|
+
/**
|
|
4
|
+
* Key Bootstrap.
|
|
5
|
+
*
|
|
6
|
+
* Composition root for key management.
|
|
7
|
+
*
|
|
8
|
+
* KEY_PROVIDER accepts "local", "aws-kms", "azure-key-vault",
|
|
9
|
+
* "gcp-kms", and "hsm" (see packages/shared/src/config/KeyProviders.ts)
|
|
10
|
+
* for forward-compatible configuration, but only FileKeyProvider
|
|
11
|
+
* ("local") is actually implemented. Before this check existed, setting
|
|
12
|
+
* KEY_PROVIDER=aws-kms (or any other non-local value) parsed and
|
|
13
|
+
* validated cleanly, then silently constructed a FileKeyProvider anyway
|
|
14
|
+
* — an operator who configured real KMS custody got private-key-on-disk
|
|
15
|
+
* instead, with no error. Failing loudly here, at startup, turns that
|
|
16
|
+
* silent misconfiguration into an immediate, actionable error instead
|
|
17
|
+
* of a false sense of custody. Remove this check only once a real
|
|
18
|
+
* provider class exists for the value being unblocked.
|
|
19
|
+
*/
|
|
20
|
+
export class KeyBootstrap {
|
|
21
|
+
static provider;
|
|
22
|
+
static create() {
|
|
23
|
+
if (!this.provider) {
|
|
24
|
+
const configuredProvider = loadConfig().keys.provider;
|
|
25
|
+
if (configuredProvider !== KeyProviders.LOCAL) {
|
|
26
|
+
throw new Error(`KEY_PROVIDER=${configuredProvider} is not implemented. Only "${KeyProviders.LOCAL}" ` +
|
|
27
|
+
"(FileKeyProvider, keys read from PARMANA_KEY_DIR on local disk) has a real " +
|
|
28
|
+
"implementation today. Refusing to start with a configured key custody model " +
|
|
29
|
+
"(aws-kms, azure-key-vault, gcp-kms, hsm) that would silently fall back to " +
|
|
30
|
+
"file-based keys instead of the KMS/HSM custody the configuration requested.");
|
|
31
|
+
}
|
|
32
|
+
this.provider = new FileKeyProvider();
|
|
33
|
+
}
|
|
34
|
+
return this.provider;
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
//# sourceMappingURL=KeyBootstrap.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"KeyBootstrap.js","sourceRoot":"","sources":["../src/KeyBootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAI3D,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAErE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,YAAY;IACf,MAAM,CAAC,QAAQ,CAAc;IAErC,MAAM,CAAC,MAAM;QACX,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,MAAM,kBAAkB,GAAG,UAAU,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC;YAEtD,IAAI,kBAAkB,KAAK,YAAY,CAAC,KAAK,EAAE,CAAC;gBAC9C,MAAM,IAAI,KAAK,CACb,gBAAgB,kBAAkB,8BAA8B,YAAY,CAAC,KAAK,IAAI;oBACpF,6EAA6E;oBAC7E,8EAA8E;oBAC9E,4EAA4E;oBAC5E,6EAA6E,CAChF,CAAC;YACJ,CAAC;YAED,IAAI,CAAC,QAAQ,GAAG,IAAI,eAAe,EAAE,CAAC;QACxC,CAAC;QAED,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;CACF"}
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* One key's expiry/revocation metadata.
|
|
3
|
+
*/
|
|
4
|
+
export interface KeyExpiryEntry {
|
|
5
|
+
readonly expiresAt?: Date;
|
|
6
|
+
readonly revoked?: boolean;
|
|
7
|
+
}
|
|
8
|
+
/**
|
|
9
|
+
* Looks up expiry/revocation metadata for a keyId.
|
|
10
|
+
*/
|
|
11
|
+
export interface KeyExpiryStore {
|
|
12
|
+
get(keyId: string): Promise<KeyExpiryEntry | undefined>;
|
|
13
|
+
}
|
|
14
|
+
/**
|
|
15
|
+
* File Key Expiry Store.
|
|
16
|
+
*
|
|
17
|
+
* Reads one small sidecar JSON file beside the PEM key files
|
|
18
|
+
* FileKeyProvider already reads from the same configured key
|
|
19
|
+
* directory: `<keyDirectory>/key-expiry.json`, shape
|
|
20
|
+
* `{ "<keyId>": { "expiresAt"?: ISO string, "revoked"?: boolean } }`.
|
|
21
|
+
*
|
|
22
|
+
* A keyId absent from the file, or the file itself being absent,
|
|
23
|
+
* means "no expiry, always valid" -- the safe default that keeps
|
|
24
|
+
* every deployment that doesn't opt into key expiry behaving exactly
|
|
25
|
+
* as it does today. Consistent with FileKeyProvider's own documented
|
|
26
|
+
* scope: intended for development and self-hosted deployments: no
|
|
27
|
+
* external KMS/vault dependency, no env-var-encoded key material.
|
|
28
|
+
*/
|
|
29
|
+
export declare class FileKeyExpiryStore implements KeyExpiryStore {
|
|
30
|
+
private readonly config;
|
|
31
|
+
private readonly keyDirectory;
|
|
32
|
+
get(keyId: string): Promise<KeyExpiryEntry | undefined>;
|
|
33
|
+
}
|
|
34
|
+
//# sourceMappingURL=KeyExpiry.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"KeyExpiry.d.ts","sourceRoot":"","sources":["../src/KeyExpiry.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;CACzD;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,kBAAmB,YAAW,cAAc;IACvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IAEvC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6C;IAEpE,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CA8D5D;CACF"}
|
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
import { existsSync, readFileSync } from "node:fs";
|
|
2
|
+
import { join } from "node:path";
|
|
3
|
+
import { loadConfig } from "@parmana/shared";
|
|
4
|
+
/**
|
|
5
|
+
* File Key Expiry Store.
|
|
6
|
+
*
|
|
7
|
+
* Reads one small sidecar JSON file beside the PEM key files
|
|
8
|
+
* FileKeyProvider already reads from the same configured key
|
|
9
|
+
* directory: `<keyDirectory>/key-expiry.json`, shape
|
|
10
|
+
* `{ "<keyId>": { "expiresAt"?: ISO string, "revoked"?: boolean } }`.
|
|
11
|
+
*
|
|
12
|
+
* A keyId absent from the file, or the file itself being absent,
|
|
13
|
+
* means "no expiry, always valid" -- the safe default that keeps
|
|
14
|
+
* every deployment that doesn't opt into key expiry behaving exactly
|
|
15
|
+
* as it does today. Consistent with FileKeyProvider's own documented
|
|
16
|
+
* scope: intended for development and self-hosted deployments: no
|
|
17
|
+
* external KMS/vault dependency, no env-var-encoded key material.
|
|
18
|
+
*/
|
|
19
|
+
export class FileKeyExpiryStore {
|
|
20
|
+
config = loadConfig();
|
|
21
|
+
keyDirectory = this.config.keys.keyDirectory ?? "./keys";
|
|
22
|
+
async get(keyId) {
|
|
23
|
+
const path = join(this.keyDirectory, "key-expiry.json");
|
|
24
|
+
if (!existsSync(path)) {
|
|
25
|
+
return undefined;
|
|
26
|
+
}
|
|
27
|
+
const raw = readFileSync(path, "utf8");
|
|
28
|
+
let parsed;
|
|
29
|
+
try {
|
|
30
|
+
parsed = JSON.parse(raw);
|
|
31
|
+
}
|
|
32
|
+
catch {
|
|
33
|
+
throw new Error(`${path} is not valid JSON.`);
|
|
34
|
+
}
|
|
35
|
+
if (typeof parsed !== "object" ||
|
|
36
|
+
parsed === null ||
|
|
37
|
+
Array.isArray(parsed)) {
|
|
38
|
+
throw new Error(`${path} must be a JSON object keyed by keyId.`);
|
|
39
|
+
}
|
|
40
|
+
const entry = parsed[keyId];
|
|
41
|
+
if (entry === undefined) {
|
|
42
|
+
return undefined;
|
|
43
|
+
}
|
|
44
|
+
const { expiresAt, revoked } = entry;
|
|
45
|
+
if (expiresAt !== undefined &&
|
|
46
|
+
(typeof expiresAt !== "string" || Number.isNaN(Date.parse(expiresAt)))) {
|
|
47
|
+
//
|
|
48
|
+
// An unparseable date became an Invalid Date, and EnvelopeVerifier's
|
|
49
|
+
// `expiresAt <= now` is false for it, so a typo silently left the
|
|
50
|
+
// key valid forever. Refused instead, like every other malformed
|
|
51
|
+
// entry in this file.
|
|
52
|
+
//
|
|
53
|
+
throw new Error(`${path}["${keyId}"].expiresAt must be an ISO 8601 date string.`);
|
|
54
|
+
}
|
|
55
|
+
if (revoked !== undefined && typeof revoked !== "boolean") {
|
|
56
|
+
throw new Error(`${path}["${keyId}"].revoked must be a boolean.`);
|
|
57
|
+
}
|
|
58
|
+
return {
|
|
59
|
+
...(expiresAt !== undefined && {
|
|
60
|
+
expiresAt: new Date(expiresAt),
|
|
61
|
+
}),
|
|
62
|
+
...(revoked !== undefined && { revoked }),
|
|
63
|
+
};
|
|
64
|
+
}
|
|
65
|
+
}
|
|
66
|
+
//# sourceMappingURL=KeyExpiry.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"KeyExpiry.js","sourceRoot":"","sources":["../src/KeyExpiry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAiB7C;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,kBAAkB;IACZ,MAAM,GAAG,UAAU,EAAE,CAAC;IAEtB,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,IAAI,QAAQ,CAAC;IAE1E,KAAK,CAAC,GAAG,CAAC,KAAa;QACrB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAAC;QAExD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACtB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAEvC,IAAI,MAAe,CAAC;QAEpB,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,qBAAqB,CAAC,CAAC;QAChD,CAAC;QAED,IACE,OAAO,MAAM,KAAK,QAAQ;YAC1B,MAAM,KAAK,IAAI;YACf,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EACrB,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,wCAAwC,CAAC,CAAC;QACnE,CAAC;QAED,MAAM,KAAK,GAAI,MAAkC,CAAC,KAAK,CAAC,CAAC;QAEzD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,KAG9B,CAAC;QAEF,IACE,SAAS,KAAK,SAAS;YACvB,CAAC,OAAO,SAAS,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EACtE,CAAC;YACD,EAAE;YACF,qEAAqE;YACrE,kEAAkE;YAClE,iEAAiE;YACjE,sBAAsB;YACtB,EAAE;YACF,MAAM,IAAI,KAAK,CACb,GAAG,IAAI,KAAK,KAAK,+CAA+C,CACjE,CAAC;QACJ,CAAC;QAED,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1D,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,KAAK,KAAK,+BAA+B,CAAC,CAAC;QACpE,CAAC;QAED,OAAO;YACL,GAAG,CAAC,SAAS,KAAK,SAAS,IAAI;gBAC7B,SAAS,EAAE,IAAI,IAAI,CAAC,SAAS,CAAC;aAC/B,CAAC;YAEF,GAAG,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,OAAO,EAAE,CAAC;SAC1C,CAAC;IACJ,CAAC;CACF"}
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Represents a cryptographic key pair used for signing and verification.
|
|
3
|
+
*
|
|
4
|
+
* This is a simple immutable container for public and private key material.
|
|
5
|
+
*/
|
|
6
|
+
export declare class KeyPair {
|
|
7
|
+
/**
|
|
8
|
+
* Public key (used for verification).
|
|
9
|
+
*/
|
|
10
|
+
readonly publicKey: Uint8Array;
|
|
11
|
+
/**
|
|
12
|
+
* Private key (used for signing).
|
|
13
|
+
*/
|
|
14
|
+
readonly privateKey: Uint8Array;
|
|
15
|
+
constructor(publicKey: Uint8Array, privateKey: Uint8Array);
|
|
16
|
+
/**
|
|
17
|
+
* Returns a JSON-safe representation.
|
|
18
|
+
* WARNING: does not expose private key in raw form.
|
|
19
|
+
*/
|
|
20
|
+
toJSON(): {
|
|
21
|
+
publicKey: string;
|
|
22
|
+
privateKey: string;
|
|
23
|
+
};
|
|
24
|
+
}
|
|
25
|
+
//# sourceMappingURL=KeyPair.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"KeyPair.d.ts","sourceRoot":"","sources":["../src/KeyPair.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,OAAO;IAClB;;OAEG;IACH,SAAgB,SAAS,EAAE,UAAU,CAAC;IAEtC;;OAEG;IACH,SAAgB,UAAU,EAAE,UAAU,CAAC;IAEvC,YAAY,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAaxD;IAED;;;OAGG;IACI,MAAM;QAET,SAAS;QACT,UAAU;MAEb;CACF"}
|
package/dist/KeyPair.js
ADDED
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Represents a cryptographic key pair used for signing and verification.
|
|
3
|
+
*
|
|
4
|
+
* This is a simple immutable container for public and private key material.
|
|
5
|
+
*/
|
|
6
|
+
export class KeyPair {
|
|
7
|
+
/**
|
|
8
|
+
* Public key (used for verification).
|
|
9
|
+
*/
|
|
10
|
+
publicKey;
|
|
11
|
+
/**
|
|
12
|
+
* Private key (used for signing).
|
|
13
|
+
*/
|
|
14
|
+
privateKey;
|
|
15
|
+
constructor(publicKey, privateKey) {
|
|
16
|
+
if (!publicKey || publicKey.length === 0) {
|
|
17
|
+
throw new Error("Public key cannot be empty.");
|
|
18
|
+
}
|
|
19
|
+
if (!privateKey || privateKey.length === 0) {
|
|
20
|
+
throw new Error("Private key cannot be empty.");
|
|
21
|
+
}
|
|
22
|
+
this.publicKey = new Uint8Array(publicKey);
|
|
23
|
+
this.privateKey = new Uint8Array(privateKey);
|
|
24
|
+
Object.freeze(this);
|
|
25
|
+
}
|
|
26
|
+
/**
|
|
27
|
+
* Returns a JSON-safe representation.
|
|
28
|
+
* WARNING: does not expose private key in raw form.
|
|
29
|
+
*/
|
|
30
|
+
toJSON() {
|
|
31
|
+
return {
|
|
32
|
+
publicKey: Buffer.from(this.publicKey).toString("base64"),
|
|
33
|
+
privateKey: "***REDACTED***",
|
|
34
|
+
};
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
//# sourceMappingURL=KeyPair.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"KeyPair.js","sourceRoot":"","sources":["../src/KeyPair.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,OAAO,OAAO;IAClB;;OAEG;IACa,SAAS,CAAa;IAEtC;;OAEG;IACa,UAAU,CAAa;IAEvC,YAAY,SAAqB,EAAE,UAAsB;QACvD,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QACjD,CAAC;QAED,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAClD,CAAC;QAED,IAAI,CAAC,SAAS,GAAG,IAAI,UAAU,CAAC,SAAS,CAAC,CAAC;QAC3C,IAAI,CAAC,UAAU,GAAG,IAAI,UAAU,CAAC,UAAU,CAAC,CAAC;QAE7C,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;IAED;;;OAGG;IACI,MAAM;QACX,OAAO;YACL,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;YACzD,UAAU,EAAE,gBAAgB;SAC7B,CAAC;IACJ,CAAC;CACF"}
|
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
import type { KeyObject } from "node:crypto";
|
|
2
|
+
import type { SignatureAlgorithm } from "@parmana/shared";
|
|
3
|
+
/**
|
|
4
|
+
* Canonical key identifier used when no other keyId is
|
|
5
|
+
* specified. Every Parmana process that signs or verifies
|
|
6
|
+
* with the default key uses this identifier, so key material
|
|
7
|
+
* generated by scripts/generate-keypair.ts is found
|
|
8
|
+
* consistently across the crypto and runtime packages.
|
|
9
|
+
*/
|
|
10
|
+
export declare const DEFAULT_KEY_ID = "default";
|
|
11
|
+
/**
|
|
12
|
+
* Keyid for the secondary (hybrid-mode) signing key, living alongside
|
|
13
|
+
* DEFAULT_KEY_ID under the same PARMANA_KEY_DIR (Hybrid Signature
|
|
14
|
+
* Support milestone, Phase A). Only read when CRYPTO_MODE=hybrid;
|
|
15
|
+
* generate it with `npm run generate:hybrid-secondary-key`. Deliberately
|
|
16
|
+
* a distinct keyId rather than reusing DEFAULT_KEY_ID -- FileKeyProvider
|
|
17
|
+
* resolves keys purely by keyId (`<keyId>.private.pem`), and one keyId
|
|
18
|
+
* can only ever hold one algorithm's key material at a time.
|
|
19
|
+
*/
|
|
20
|
+
export declare const DEFAULT_SECONDARY_KEY_ID = "default-secondary";
|
|
21
|
+
/**
|
|
22
|
+
* Resolves the keyId that VerificationCrypto/RefusalCrypto/
|
|
23
|
+
* AuditEventCrypto -- the durable-evidence signers (Trust Records,
|
|
24
|
+
* Refusal Records, Audit Events) -- use for NEW signatures (PQC audit
|
|
25
|
+
* RED-3, docs/VERIFICATION-GAPS.md). Every one of these three signers
|
|
26
|
+
* previously hardcoded DEFAULT_KEY_ID directly, so the only way to
|
|
27
|
+
* "rotate" was to overwrite default.private.pem/default.public.pem in
|
|
28
|
+
* place -- which silently invalidates every record ever signed under
|
|
29
|
+
* that keyId, since verification always resolves the public key by
|
|
30
|
+
* the *stored* record's own keyId (already true, and unaffected by
|
|
31
|
+
* this function).
|
|
32
|
+
*
|
|
33
|
+
* Read fresh on every call (mirrors
|
|
34
|
+
* packages/api/src/bootstrap/createGatewayKeyPair.ts's own
|
|
35
|
+
* PARMANA_GATEWAY_KEY_ID pattern), not cached, so a rotation takes
|
|
36
|
+
* effect on redeploy without any other code change: generate a new
|
|
37
|
+
* keyId's key pair (scripts/generate-keypair.ts already supports an
|
|
38
|
+
* arbitrary --key-id and refuses to overwrite an existing one without
|
|
39
|
+
* --force), point PARMANA_VERIFICATION_KEY_ID at it, and every
|
|
40
|
+
* already-issued record -- still referencing the old keyId -- keeps
|
|
41
|
+
* verifying as long as its key file is not deleted. Unset (the
|
|
42
|
+
* default) behaves exactly as before this function existed.
|
|
43
|
+
*
|
|
44
|
+
* FileKeyProvider's own assertValidKeyId() rejects an unsafe value
|
|
45
|
+
* the moment this is used to look up a key file, so no separate
|
|
46
|
+
* validation is duplicated here.
|
|
47
|
+
*/
|
|
48
|
+
export declare function currentVerificationKeyId(): string;
|
|
49
|
+
/**
|
|
50
|
+
* Same rotation mechanism as currentVerificationKeyId(), for the
|
|
51
|
+
* hybrid-mode secondary signing key.
|
|
52
|
+
*/
|
|
53
|
+
export declare function currentVerificationSecondaryKeyId(): string;
|
|
54
|
+
/**
|
|
55
|
+
* Signing key metadata.
|
|
56
|
+
*/
|
|
57
|
+
export interface KeyMetadata {
|
|
58
|
+
readonly keyId: string;
|
|
59
|
+
readonly algorithm: SignatureAlgorithm;
|
|
60
|
+
}
|
|
61
|
+
/**
|
|
62
|
+
* Key management abstraction.
|
|
63
|
+
*/
|
|
64
|
+
export interface KeyProvider {
|
|
65
|
+
/**
|
|
66
|
+
* Returns metadata for the specified key.
|
|
67
|
+
*/
|
|
68
|
+
getMetadata(keyId: string): Promise<KeyMetadata>;
|
|
69
|
+
/**
|
|
70
|
+
* Returns the private key.
|
|
71
|
+
*/
|
|
72
|
+
getPrivateKey(keyId: string): Promise<KeyObject>;
|
|
73
|
+
/**
|
|
74
|
+
* Returns the public key.
|
|
75
|
+
*/
|
|
76
|
+
getPublicKey(keyId: string): Promise<KeyObject>;
|
|
77
|
+
/**
|
|
78
|
+
* Returns true if the key exists.
|
|
79
|
+
*/
|
|
80
|
+
hasKey(keyId: string): Promise<boolean>;
|
|
81
|
+
/**
|
|
82
|
+
* Lists every keyId this provider can currently load a public key
|
|
83
|
+
* for (PQC audit RED-2, docs/VERIFICATION-GAPS.md) -- used by the
|
|
84
|
+
* key-discovery endpoints (packages/api/src/routes/keys.ts) to
|
|
85
|
+
* enumerate every key an auditor might need, not only whichever one
|
|
86
|
+
* happens to be "current."
|
|
87
|
+
*
|
|
88
|
+
* Optional: every pre-existing test fake implementing this
|
|
89
|
+
* interface (several across packages/crypto, packages/envelope-
|
|
90
|
+
* verifier, packages/runtime, packages/connector-hubspot) keeps
|
|
91
|
+
* compiling unchanged without adding it, the same "add capability
|
|
92
|
+
* without breaking existing implementers" precedent
|
|
93
|
+
* ExecutionTrustRecordRepository.sumSuccessfulExecutionAmounts?
|
|
94
|
+
* already set.
|
|
95
|
+
*/
|
|
96
|
+
listKeys?(): Promise<string[]>;
|
|
97
|
+
}
|
|
98
|
+
//# sourceMappingURL=KeyProvider.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"KeyProvider.d.ts","sourceRoot":"","sources":["../src/KeyProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,YAAY,CAAC;AAExC;;;;;;;;GAQG;AACH,eAAO,MAAM,wBAAwB,sBAAsB,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAEjD;AAED;;;GAGG;AACH,wBAAgB,iCAAiC,IAAI,MAAM,CAK1D;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEjD;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAEjD;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhD;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAExC;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAChC"}
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Canonical key identifier used when no other keyId is
|
|
3
|
+
* specified. Every Parmana process that signs or verifies
|
|
4
|
+
* with the default key uses this identifier, so key material
|
|
5
|
+
* generated by scripts/generate-keypair.ts is found
|
|
6
|
+
* consistently across the crypto and runtime packages.
|
|
7
|
+
*/
|
|
8
|
+
export const DEFAULT_KEY_ID = "default";
|
|
9
|
+
/**
|
|
10
|
+
* Keyid for the secondary (hybrid-mode) signing key, living alongside
|
|
11
|
+
* DEFAULT_KEY_ID under the same PARMANA_KEY_DIR (Hybrid Signature
|
|
12
|
+
* Support milestone, Phase A). Only read when CRYPTO_MODE=hybrid;
|
|
13
|
+
* generate it with `npm run generate:hybrid-secondary-key`. Deliberately
|
|
14
|
+
* a distinct keyId rather than reusing DEFAULT_KEY_ID -- FileKeyProvider
|
|
15
|
+
* resolves keys purely by keyId (`<keyId>.private.pem`), and one keyId
|
|
16
|
+
* can only ever hold one algorithm's key material at a time.
|
|
17
|
+
*/
|
|
18
|
+
export const DEFAULT_SECONDARY_KEY_ID = "default-secondary";
|
|
19
|
+
/**
|
|
20
|
+
* Resolves the keyId that VerificationCrypto/RefusalCrypto/
|
|
21
|
+
* AuditEventCrypto -- the durable-evidence signers (Trust Records,
|
|
22
|
+
* Refusal Records, Audit Events) -- use for NEW signatures (PQC audit
|
|
23
|
+
* RED-3, docs/VERIFICATION-GAPS.md). Every one of these three signers
|
|
24
|
+
* previously hardcoded DEFAULT_KEY_ID directly, so the only way to
|
|
25
|
+
* "rotate" was to overwrite default.private.pem/default.public.pem in
|
|
26
|
+
* place -- which silently invalidates every record ever signed under
|
|
27
|
+
* that keyId, since verification always resolves the public key by
|
|
28
|
+
* the *stored* record's own keyId (already true, and unaffected by
|
|
29
|
+
* this function).
|
|
30
|
+
*
|
|
31
|
+
* Read fresh on every call (mirrors
|
|
32
|
+
* packages/api/src/bootstrap/createGatewayKeyPair.ts's own
|
|
33
|
+
* PARMANA_GATEWAY_KEY_ID pattern), not cached, so a rotation takes
|
|
34
|
+
* effect on redeploy without any other code change: generate a new
|
|
35
|
+
* keyId's key pair (scripts/generate-keypair.ts already supports an
|
|
36
|
+
* arbitrary --key-id and refuses to overwrite an existing one without
|
|
37
|
+
* --force), point PARMANA_VERIFICATION_KEY_ID at it, and every
|
|
38
|
+
* already-issued record -- still referencing the old keyId -- keeps
|
|
39
|
+
* verifying as long as its key file is not deleted. Unset (the
|
|
40
|
+
* default) behaves exactly as before this function existed.
|
|
41
|
+
*
|
|
42
|
+
* FileKeyProvider's own assertValidKeyId() rejects an unsafe value
|
|
43
|
+
* the moment this is used to look up a key file, so no separate
|
|
44
|
+
* validation is duplicated here.
|
|
45
|
+
*/
|
|
46
|
+
export function currentVerificationKeyId() {
|
|
47
|
+
return process.env.PARMANA_VERIFICATION_KEY_ID ?? DEFAULT_KEY_ID;
|
|
48
|
+
}
|
|
49
|
+
/**
|
|
50
|
+
* Same rotation mechanism as currentVerificationKeyId(), for the
|
|
51
|
+
* hybrid-mode secondary signing key.
|
|
52
|
+
*/
|
|
53
|
+
export function currentVerificationSecondaryKeyId() {
|
|
54
|
+
return (process.env.PARMANA_VERIFICATION_SECONDARY_KEY_ID ??
|
|
55
|
+
DEFAULT_SECONDARY_KEY_ID);
|
|
56
|
+
}
|
|
57
|
+
//# sourceMappingURL=KeyProvider.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"KeyProvider.js","sourceRoot":"","sources":["../src/KeyProvider.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,SAAS,CAAC;AAExC;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,mBAAmB,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,wBAAwB;IACtC,OAAO,OAAO,CAAC,GAAG,CAAC,2BAA2B,IAAI,cAAc,CAAC;AACnE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iCAAiC;IAC/C,OAAO,CACL,OAAO,CAAC,GAAG,CAAC,qCAAqC;QACjD,wBAAwB,CACzB,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
import type { KeyPair } from "./KeyPair.js";
|
|
2
|
+
/**
|
|
3
|
+
* Abstract key storage interface.
|
|
4
|
+
*
|
|
5
|
+
* KeyStore is responsible for persisting and retrieving cryptographic
|
|
6
|
+
* key pairs. Implementations may be in-memory, file-based, or external
|
|
7
|
+
* secure vaults (HSM, KMS, etc.).
|
|
8
|
+
*/
|
|
9
|
+
export interface KeyStore {
|
|
10
|
+
/**
|
|
11
|
+
* Stores a key pair under a given identifier.
|
|
12
|
+
*
|
|
13
|
+
* @param id Unique key identifier.
|
|
14
|
+
* @param keyPair Cryptographic key pair.
|
|
15
|
+
*/
|
|
16
|
+
set(id: string, keyPair: KeyPair): Promise<void>;
|
|
17
|
+
/**
|
|
18
|
+
* Retrieves a key pair by identifier.
|
|
19
|
+
*
|
|
20
|
+
* @param id Key identifier.
|
|
21
|
+
* @returns Key pair or null if not found.
|
|
22
|
+
*/
|
|
23
|
+
get(id: string): Promise<KeyPair | null>;
|
|
24
|
+
/**
|
|
25
|
+
* Deletes a key pair by identifier.
|
|
26
|
+
*
|
|
27
|
+
* @param id Key identifier.
|
|
28
|
+
*/
|
|
29
|
+
delete(id: string): Promise<void>;
|
|
30
|
+
/**
|
|
31
|
+
* Lists all stored key identifiers.
|
|
32
|
+
*/
|
|
33
|
+
list(): Promise<string[]>;
|
|
34
|
+
}
|
|
35
|
+
//# sourceMappingURL=KeyStore.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"KeyStore.d.ts","sourceRoot":"","sources":["../src/KeyStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB;;;;;OAKG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjD;;;;;OAKG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAEzC;;;;OAIG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElC;;OAEG;IACH,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAC3B"}
|
package/dist/KeyStore.js
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"KeyStore.js","sourceRoot":"","sources":["../src/KeyStore.ts"],"names":[],"mappings":""}
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
import type { ExecutionIntent, ExecutionTrustRecord } from "@parmana/shared";
|
|
2
|
+
export interface OfflineVerificationResult {
|
|
3
|
+
/**
|
|
4
|
+
* Overall result: hash matches, the legacy signature verifies, and
|
|
5
|
+
* -- only when the record carries a `signatures` array at all --
|
|
6
|
+
* every entry in it also verifies. `false` on any error (missing
|
|
7
|
+
* key, unsupported algorithm, malformed input) as well as any
|
|
8
|
+
* cryptographic failure; see `errors` for which.
|
|
9
|
+
*/
|
|
10
|
+
readonly valid: boolean;
|
|
11
|
+
/**
|
|
12
|
+
* Whether the record's own `trustRecordHash` matches a fresh hash
|
|
13
|
+
* of its canonical content. Recomputed using SHA-256 -- the only
|
|
14
|
+
* hash algorithm this codebase actually implements today (sha3-512/
|
|
15
|
+
* blake3 are declared config values with no real provider); a
|
|
16
|
+
* record hashed under a different algorithm cannot be distinguished
|
|
17
|
+
* from a tampered one by this check alone, since the algorithm used
|
|
18
|
+
* is not itself recorded on the artifact.
|
|
19
|
+
*/
|
|
20
|
+
readonly hashValid: boolean;
|
|
21
|
+
/**
|
|
22
|
+
* Whether the always-present legacy `signature` field verifies.
|
|
23
|
+
*/
|
|
24
|
+
readonly legacySignatureValid: boolean;
|
|
25
|
+
/**
|
|
26
|
+
* Whether the hybrid `signatures` array verifies -- present only
|
|
27
|
+
* when the record actually carries one. `undefined` means "this
|
|
28
|
+
* record has no `signatures` array to check," not "it failed."
|
|
29
|
+
* Mirrors VerificationCrypto.verifySignature()'s own "absent means
|
|
30
|
+
* not covered" semantics, deliberately: this function reports facts
|
|
31
|
+
* about what is present, it does not enforce a policy about what
|
|
32
|
+
* *should* be present (the equivalent of the online verifier's
|
|
33
|
+
* HYBRID_SIGNATURE_REQUIRED flag is a decision for the caller to
|
|
34
|
+
* make from this result, not something an offline, stateless
|
|
35
|
+
* function can decide on the record's own say-so).
|
|
36
|
+
*/
|
|
37
|
+
readonly hybridSignaturesValid?: boolean;
|
|
38
|
+
/**
|
|
39
|
+
* Every algorithm identifier this call actually attempted to
|
|
40
|
+
* verify, legacy and hybrid combined, in the order checked.
|
|
41
|
+
*/
|
|
42
|
+
readonly algorithmsChecked: readonly string[];
|
|
43
|
+
/**
|
|
44
|
+
* Human-readable reasons for any check that failed or could not be
|
|
45
|
+
* attempted (missing key material for a keyId, an unsupported
|
|
46
|
+
* algorithm, a malformed `signatures` array). Empty when `valid` is
|
|
47
|
+
* true.
|
|
48
|
+
*/
|
|
49
|
+
readonly errors: readonly string[];
|
|
50
|
+
}
|
|
51
|
+
/**
|
|
52
|
+
* `publicKeys` maps keyId -> PEM-encoded public key (SPKI). Supply an
|
|
53
|
+
* entry for every keyId the record's `signature.keyId` and (if
|
|
54
|
+
* present) each `signatures[].keyId` reference -- typically fetched
|
|
55
|
+
* once from a key-discovery endpoint (see the `/keys` and
|
|
56
|
+
* `/.well-known/jwks.json` routes) and cached by the caller, not
|
|
57
|
+
* re-fetched per verification.
|
|
58
|
+
*/
|
|
59
|
+
export declare function verifyExecutionTrustRecordOffline(trustRecord: ExecutionTrustRecord, publicKeys: Readonly<Record<string, string>>, options?: {
|
|
60
|
+
readonly hybridRequiredFrom?: string;
|
|
61
|
+
}): Promise<OfflineVerificationResult>;
|
|
62
|
+
/**
|
|
63
|
+
* Verifies an Execution Intent (ADR-0012) with no network call, no database and
|
|
64
|
+
* no key directory: only the intent and the public key(s) are needed. Checks
|
|
65
|
+
* that the recorded hash matches the canonical intent and that the signature
|
|
66
|
+
* verifies against the public key for the intent's keyId.
|
|
67
|
+
*
|
|
68
|
+
* A valid result proves the intent was signed by the holder of that key and has
|
|
69
|
+
* not been altered. It does not prove the action was released, or what the
|
|
70
|
+
* result was: an intent is written BEFORE release. Whether a signed Execution
|
|
71
|
+
* Trust Record exists for the same businessTransactionId is a separate check.
|
|
72
|
+
*/
|
|
73
|
+
export declare function verifyExecutionIntentOffline(intent: ExecutionIntent, publicKeys: Readonly<Record<string, string>>): Promise<OfflineVerificationResult>;
|
|
74
|
+
//# sourceMappingURL=OfflineVerifier.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"OfflineVerifier.d.ts","sourceRoot":"","sources":["../src/OfflineVerifier.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EAErB,MAAM,iBAAiB,CAAC;AA+DzB,MAAM,WAAW,yBAAyB;IACxC;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IAExB;;;;;;;;OAQG;IACH,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC;IAEvC;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAEzC;;;OAGG;IACH,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IAE9C;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED;;;;;;;GAOG;AACH,wBAAsB,iCAAiC,CACrD,WAAW,EAAE,oBAAoB,EACjC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAC5C,OAAO,GAAE;IAAE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAAO,GACrD,OAAO,CAAC,yBAAyB,CAAC,CAwJpC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,4BAA4B,CAChD,MAAM,EAAE,eAAe,EACvB,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAC3C,OAAO,CAAC,yBAAyB,CAAC,CA8CpC"}
|