@interop/wallet-core 0.50.0 → 0.52.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/README.md +7 -11
- package/dist/clientAnnex/credentialAnchoredGenesis.d.ts +17 -8
- package/dist/clientAnnex/credentialAnchoredGenesis.d.ts.map +1 -1
- package/dist/clientAnnex/credentialAnchoredGenesis.js +33 -12
- package/dist/clientAnnex/credentialAnchoredGenesis.js.map +1 -1
- package/dist/clientAnnex/forget.d.ts +18 -6
- package/dist/clientAnnex/forget.d.ts.map +1 -1
- package/dist/clientAnnex/forget.js +19 -6
- package/dist/clientAnnex/forget.js.map +1 -1
- package/dist/clientAnnex/forgetLast.d.ts +65 -28
- package/dist/clientAnnex/forgetLast.d.ts.map +1 -1
- package/dist/clientAnnex/forgetLast.js +78 -18
- package/dist/clientAnnex/forgetLast.js.map +1 -1
- package/dist/clientAnnex/gc.d.ts +3 -3
- package/dist/clientAnnex/gc.d.ts.map +1 -1
- package/dist/clientAnnex/gc.js +2 -2
- package/dist/clientAnnex/gc.js.map +1 -1
- package/dist/clientAnnex/index.d.ts +6 -6
- package/dist/clientAnnex/index.d.ts.map +1 -1
- package/dist/clientAnnex/index.js +5 -5
- package/dist/clientAnnex/index.js.map +1 -1
- package/dist/clientAnnex/ladder.d.ts +19 -11
- package/dist/clientAnnex/ladder.d.ts.map +1 -1
- package/dist/clientAnnex/ladder.js +77 -14
- package/dist/clientAnnex/ladder.js.map +1 -1
- package/dist/clientAnnex/ladderAnchored.d.ts +36 -7
- package/dist/clientAnnex/ladderAnchored.d.ts.map +1 -1
- package/dist/clientAnnex/ladderAnchored.js +80 -18
- package/dist/clientAnnex/ladderAnchored.js.map +1 -1
- package/dist/clientAnnex/log.d.ts +6 -6
- package/dist/clientAnnex/log.d.ts.map +1 -1
- package/dist/clientAnnex/log.js +8 -8
- package/dist/clientAnnex/log.js.map +1 -1
- package/dist/clientAnnex/recoveryLadderAnchored.d.ts +7 -7
- package/dist/clientAnnex/recoveryLadderAnchored.js +9 -9
- package/dist/clientAnnex/recoveryLadderAnchored.js.map +1 -1
- package/dist/clientAnnex/selfEnroll.d.ts +6 -4
- package/dist/clientAnnex/selfEnroll.d.ts.map +1 -1
- package/dist/clientAnnex/selfEnroll.js +19 -7
- package/dist/clientAnnex/selfEnroll.js.map +1 -1
- package/dist/clients/listing.d.ts +1 -1
- package/dist/clients/listing.d.ts.map +1 -1
- package/dist/clients/listing.js +1 -1
- package/dist/clients/listing.js.map +1 -1
- package/dist/clients/revocation.d.ts +1 -1
- package/dist/clients/rosterPolicy.d.ts +1 -1
- package/dist/clients/rosterPolicy.d.ts.map +1 -1
- package/dist/descriptors/acquire.js +1 -1
- package/dist/descriptors/logSource.d.ts +1 -2
- package/dist/descriptors/logSource.d.ts.map +1 -1
- package/dist/descriptors/logSource.js +2 -2
- package/dist/descriptors/logSource.js.map +1 -1
- package/dist/enrollment/enrollment.d.ts +1 -1
- package/dist/enrollment/enrollment.d.ts.map +1 -1
- package/dist/enrollment/enrollment.js +2 -1
- package/dist/enrollment/enrollment.js.map +1 -1
- package/dist/genesis/accountGenesis.d.ts +13 -1
- package/dist/genesis/accountGenesis.d.ts.map +1 -1
- package/dist/genesis/accountGenesis.js +1 -1
- package/dist/genesis/accountGenesis.js.map +1 -1
- package/dist/index.d.ts +1 -3
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1 -3
- package/dist/index.js.map +1 -1
- package/dist/keyring/kdf.d.ts +6 -20
- package/dist/keyring/kdf.d.ts.map +1 -1
- package/dist/keyring/kdf.js +8 -5
- package/dist/keyring/kdf.js.map +1 -1
- package/dist/keyring/unlockSpace.js +1 -1
- package/dist/keys/rosterLogStore.d.ts +16 -14
- package/dist/keys/rosterLogStore.d.ts.map +1 -1
- package/dist/keys/rosterLogStore.js +149 -32
- package/dist/keys/rosterLogStore.js.map +1 -1
- package/dist/keys/rosterStore.d.ts +8 -7
- package/dist/keys/rosterStore.d.ts.map +1 -1
- package/dist/keys/rosterStore.js +6 -6
- package/dist/keys/rosterStore.js.map +1 -1
- package/dist/keys/spaceEpochs.d.ts +1 -1
- package/dist/keys/spaceEpochs.js +1 -1
- package/dist/keys/userKeyRoster.d.ts +3 -3
- package/dist/keys/userKeyRoster.d.ts.map +1 -1
- package/dist/keys/userKeyRoster.js +3 -3
- package/dist/keys/userKeyRoster.js.map +1 -1
- package/dist/recovery/index.d.ts +2 -2
- package/dist/recovery/index.js +2 -2
- package/dist/recovery/recoveryDelegation.js +1 -1
- package/dist/recovery/recoveryDelegation.js.map +1 -1
- package/dist/recovery/recoveryWebvh.d.ts +4 -4
- package/dist/recovery/recoveryWebvh.js +5 -5
- package/dist/request/appKey.d.ts +9 -3
- package/dist/request/appKey.d.ts.map +1 -1
- package/dist/request/appKey.js +13 -8
- package/dist/request/appKey.js.map +1 -1
- package/dist/request/classify.d.ts.map +1 -1
- package/dist/request/classify.js +13 -1
- package/dist/request/classify.js.map +1 -1
- package/dist/request/ephemeralExchange.d.ts +6 -1
- package/dist/request/ephemeralExchange.d.ts.map +1 -1
- package/dist/request/ephemeralExchange.js +6 -1
- package/dist/request/ephemeralExchange.js.map +1 -1
- package/dist/request/exchangeClient.d.ts +0 -23
- package/dist/request/exchangeClient.d.ts.map +1 -1
- package/dist/request/exchangeClient.js +30 -1
- package/dist/request/exchangeClient.js.map +1 -1
- package/dist/request/index.d.ts +4 -1
- package/dist/request/index.d.ts.map +1 -1
- package/dist/request/index.js +4 -1
- package/dist/request/index.js.map +1 -1
- package/dist/request/interactionRequest.d.ts +23 -0
- package/dist/request/interactionRequest.d.ts.map +1 -0
- package/dist/request/interactionRequest.js +46 -0
- package/dist/request/interactionRequest.js.map +1 -0
- package/dist/request/interactionUrl.d.ts +3 -14
- package/dist/request/interactionUrl.d.ts.map +1 -1
- package/dist/request/interactionUrl.js +20 -1
- package/dist/request/interactionUrl.js.map +1 -1
- package/dist/resourceLog/controller.d.ts +48 -49
- package/dist/resourceLog/controller.d.ts.map +1 -1
- package/dist/resourceLog/controller.js +40 -20
- package/dist/resourceLog/controller.js.map +1 -1
- package/dist/resourceLog/errors.d.ts +12 -78
- package/dist/resourceLog/errors.d.ts.map +1 -1
- package/dist/resourceLog/errors.js +12 -79
- package/dist/resourceLog/errors.js.map +1 -1
- package/dist/resourceLog/index.d.ts +17 -22
- package/dist/resourceLog/index.d.ts.map +1 -1
- package/dist/resourceLog/index.js +16 -21
- package/dist/resourceLog/index.js.map +1 -1
- package/dist/resourceLog/license.d.ts +27 -26
- package/dist/resourceLog/license.d.ts.map +1 -1
- package/dist/resourceLog/license.js +31 -30
- package/dist/resourceLog/license.js.map +1 -1
- package/dist/unlock/index.d.ts +6 -6
- package/dist/unlock/index.d.ts.map +1 -1
- package/dist/unlock/index.js +5 -5
- package/dist/unlock/retire.d.ts +29 -28
- package/dist/unlock/retire.d.ts.map +1 -1
- package/dist/unlock/retire.js +25 -16
- package/dist/unlock/retire.js.map +1 -1
- package/dist/unlock/standingClient.d.ts +1 -1
- package/dist/unlock/standingClient.js +3 -3
- package/dist/unlock/standingWebvh.d.ts +28 -10
- package/dist/unlock/standingWebvh.d.ts.map +1 -1
- package/dist/unlock/standingWebvh.js +75 -37
- package/dist/unlock/standingWebvh.js.map +1 -1
- package/dist/unlock/unlockRecord.js +1 -1
- package/dist/webvh/delegatedLogStore.d.ts +2 -2
- package/dist/webvh/delegatedLogStore.js +2 -2
- package/dist/webvh/didWeb.js +1 -1
- package/dist/webvh/didWeb.js.map +1 -1
- package/dist/webvh/didWebvh.d.ts +3 -3
- package/dist/webvh/didWebvh.d.ts.map +1 -1
- package/dist/webvh/didWebvh.js +5 -5
- package/dist/webvh/didWebvh.js.map +1 -1
- package/dist/webvh/listClients.js +1 -1
- package/dist/webvh/listClients.js.map +1 -1
- package/dist/webvh/verifyLog.d.ts +1 -1
- package/dist/webvh/verifyLog.d.ts.map +1 -1
- package/dist/webvh/verifyLog.js +1 -2
- package/dist/webvh/verifyLog.js.map +1 -1
- package/package.json +6 -10
- package/dist/display/alignment.d.ts +0 -55
- package/dist/display/alignment.d.ts.map +0 -1
- package/dist/display/alignment.js +0 -117
- package/dist/display/alignment.js.map +0 -1
- package/dist/display/credentialName.d.ts +0 -42
- package/dist/display/credentialName.d.ts.map +0 -1
- package/dist/display/credentialName.js +0 -106
- package/dist/display/credentialName.js.map +0 -1
- package/dist/display/displayFields.d.ts +0 -59
- package/dist/display/displayFields.d.ts.map +0 -1
- package/dist/display/displayFields.js +0 -136
- package/dist/display/displayFields.js.map +0 -1
- package/dist/display/evidence.d.ts +0 -50
- package/dist/display/evidence.d.ts.map +0 -1
- package/dist/display/evidence.js +0 -67
- package/dist/display/evidence.js.map +0 -1
- package/dist/display/image.d.ts +0 -18
- package/dist/display/image.d.ts.map +0 -1
- package/dist/display/image.js +0 -23
- package/dist/display/image.js.map +0 -1
- package/dist/display/index.d.ts +0 -38
- package/dist/display/index.d.ts.map +0 -1
- package/dist/display/index.js +0 -32
- package/dist/display/index.js.map +0 -1
- package/dist/display/issuer.d.ts +0 -105
- package/dist/display/issuer.d.ts.map +0 -1
- package/dist/display/issuer.js +0 -126
- package/dist/display/issuer.js.map +0 -1
- package/dist/display/obv3.d.ts +0 -82
- package/dist/display/obv3.d.ts.map +0 -1
- package/dist/display/obv3.js +0 -117
- package/dist/display/obv3.js.map +0 -1
- package/dist/display/parse.d.ts +0 -66
- package/dist/display/parse.d.ts.map +0 -1
- package/dist/display/parse.js +0 -104
- package/dist/display/parse.js.map +0 -1
- package/dist/display/subject.d.ts +0 -79
- package/dist/display/subject.d.ts.map +0 -1
- package/dist/display/subject.js +0 -124
- package/dist/display/subject.js.map +0 -1
- package/dist/display/text.d.ts +0 -53
- package/dist/display/text.d.ts.map +0 -1
- package/dist/display/text.js +0 -78
- package/dist/display/text.js.map +0 -1
- package/dist/display/types.d.ts +0 -55
- package/dist/display/types.d.ts.map +0 -1
- package/dist/display/types.js +0 -41
- package/dist/display/types.js.map +0 -1
- package/dist/display/validity.d.ts +0 -51
- package/dist/display/validity.d.ts.map +0 -1
- package/dist/display/validity.js +0 -51
- package/dist/display/validity.js.map +0 -1
- package/dist/display/verificationView.d.ts +0 -115
- package/dist/display/verificationView.d.ts.map +0 -1
- package/dist/display/verificationView.js +0 -199
- package/dist/display/verificationView.js.map +0 -1
- package/dist/resourceLog/append.d.ts +0 -112
- package/dist/resourceLog/append.d.ts.map +0 -1
- package/dist/resourceLog/append.js +0 -197
- package/dist/resourceLog/append.js.map +0 -1
- package/dist/resourceLog/entry.d.ts +0 -68
- package/dist/resourceLog/entry.d.ts.map +0 -1
- package/dist/resourceLog/entry.js +0 -167
- package/dist/resourceLog/entry.js.map +0 -1
- package/dist/resourceLog/pin.d.ts +0 -82
- package/dist/resourceLog/pin.d.ts.map +0 -1
- package/dist/resourceLog/pin.js +0 -57
- package/dist/resourceLog/pin.js.map +0 -1
- package/dist/resourceLog/seal.d.ts +0 -97
- package/dist/resourceLog/seal.d.ts.map +0 -1
- package/dist/resourceLog/seal.js +0 -113
- package/dist/resourceLog/seal.js.map +0 -1
- package/dist/resourceLog/verify.d.ts +0 -96
- package/dist/resourceLog/verify.d.ts.map +0 -1
- package/dist/resourceLog/verify.js +0 -474
- package/dist/resourceLog/verify.js.map +0 -1
- package/dist/resourceLog/vmFragment.d.ts +0 -33
- package/dist/resourceLog/vmFragment.d.ts.map +0 -1
- package/dist/resourceLog/vmFragment.js +0 -39
- package/dist/resourceLog/vmFragment.js.map +0 -1
|
@@ -1,199 +0,0 @@
|
|
|
1
|
-
import { getExpirationInstant } from './validity.js';
|
|
2
|
-
import { typeArray } from '@interop/data-integrity-core/guards';
|
|
3
|
-
const STEP_ID = {
|
|
4
|
-
validSignature: 'valid_signature',
|
|
5
|
-
expiration: 'expiration',
|
|
6
|
-
revocation: 'revocation_status',
|
|
7
|
-
registeredIssuer: 'registered_issuer'
|
|
8
|
-
};
|
|
9
|
-
const SUPPORTED_CREDENTIAL_TYPES = [
|
|
10
|
-
'VerifiableCredential',
|
|
11
|
-
'OpenBadgeCredential'
|
|
12
|
-
];
|
|
13
|
-
function getVerifyLogFromPayload(raw) {
|
|
14
|
-
const results = raw.results;
|
|
15
|
-
const logFromFirstResult = results?.[0]?.log;
|
|
16
|
-
if (Array.isArray(logFromFirstResult)) {
|
|
17
|
-
return logFromFirstResult;
|
|
18
|
-
}
|
|
19
|
-
const topLevelLog = raw.log;
|
|
20
|
-
if (Array.isArray(topLevelLog)) {
|
|
21
|
-
return topLevelLog;
|
|
22
|
-
}
|
|
23
|
-
return [];
|
|
24
|
-
}
|
|
25
|
-
function step(valid, message, severity, error) {
|
|
26
|
-
return {
|
|
27
|
-
valid,
|
|
28
|
-
message,
|
|
29
|
-
status: severity,
|
|
30
|
-
...(error ? { error } : {})
|
|
31
|
-
};
|
|
32
|
-
}
|
|
33
|
-
function logValid(entry) {
|
|
34
|
-
if (!entry) {
|
|
35
|
-
return undefined;
|
|
36
|
-
}
|
|
37
|
-
return entry.valid === true && !entry.error;
|
|
38
|
-
}
|
|
39
|
-
function supportedFormatStep(credential, labels) {
|
|
40
|
-
const hasKnownType = typeArray(credential.type).some(type => SUPPORTED_CREDENTIAL_TYPES.includes(type));
|
|
41
|
-
return step(hasKnownType, hasKnownType ? labels.supportedFormatOk : labels.supportedFormatFail, hasKnownType ? 'positive' : 'negative');
|
|
42
|
-
}
|
|
43
|
-
function signatureStep(entry, labels) {
|
|
44
|
-
const valid = logValid(entry) ?? false;
|
|
45
|
-
return step(valid, valid ? labels.signatureOk : labels.signatureFail, valid ? 'positive' : 'negative', entry?.error?.message);
|
|
46
|
-
}
|
|
47
|
-
function issuerStep(entry, labels) {
|
|
48
|
-
const valid = logValid(entry) ?? false;
|
|
49
|
-
return step(valid, valid ? labels.issuerOk : labels.issuerFail, valid ? 'positive' : 'warning', entry?.error?.message);
|
|
50
|
-
}
|
|
51
|
-
function revocationStep(entry, credential, labels) {
|
|
52
|
-
if (!credential.credentialStatus && !entry) {
|
|
53
|
-
return step(true, labels.revocationOk, 'positive');
|
|
54
|
-
}
|
|
55
|
-
const valid = logValid(entry) ?? true;
|
|
56
|
-
return step(valid, valid ? labels.revocationOk : labels.revocationFail, valid ? 'positive' : 'negative', entry?.error?.message);
|
|
57
|
-
}
|
|
58
|
-
function expirationStep(entry, credential, labels) {
|
|
59
|
-
const exp = getExpirationInstant(credential);
|
|
60
|
-
const hasExpirationDate = exp != null;
|
|
61
|
-
if (!hasExpirationDate && !entry) {
|
|
62
|
-
return step(true, labels.noExpiration, 'positive');
|
|
63
|
-
}
|
|
64
|
-
if (entry) {
|
|
65
|
-
const valid = logValid(entry) ?? false;
|
|
66
|
-
return step(valid, valid ? labels.expirationOk : labels.expirationFail, valid ? 'positive' : 'warning', entry.error?.message);
|
|
67
|
-
}
|
|
68
|
-
const expired = exp.getTime() < Date.now();
|
|
69
|
-
return step(!expired, expired ? labels.expirationFail : labels.expirationOk, expired ? 'warning' : 'positive');
|
|
70
|
-
}
|
|
71
|
-
function withGlobalErr(stepValue, globalErr) {
|
|
72
|
-
if (stepValue.valid || !globalErr) {
|
|
73
|
-
return stepValue;
|
|
74
|
-
}
|
|
75
|
-
return { ...stepValue, error: stepValue.error ?? globalErr };
|
|
76
|
-
}
|
|
77
|
-
function attachLegacyAliases(checklist) {
|
|
78
|
-
return {
|
|
79
|
-
...checklist,
|
|
80
|
-
expiry: checklist.expiration,
|
|
81
|
-
status: checklist.revocation
|
|
82
|
-
};
|
|
83
|
-
}
|
|
84
|
-
/**
|
|
85
|
-
* Builds the five-step verification checklist from a raw `verifyCredential`
|
|
86
|
-
* payload, the credential, and an injected `labels` map.
|
|
87
|
-
*
|
|
88
|
-
* @param raw {Record<string, unknown>} the raw verify result
|
|
89
|
-
* @param credential {IVerifiableCredential}
|
|
90
|
-
* @param labels {Record<ChecklistMsgKey, string>} localized message strings
|
|
91
|
-
* @returns {VerificationChecklist}
|
|
92
|
-
*/
|
|
93
|
-
export function buildVerificationChecklist(raw, credential, labels) {
|
|
94
|
-
const log = getVerifyLogFromPayload(raw);
|
|
95
|
-
const byId = (id) => log.find(line => line.id === id);
|
|
96
|
-
const resultsWithError = raw.results;
|
|
97
|
-
const globalErr = typeof resultsWithError?.[0]?.error?.message === 'string'
|
|
98
|
-
? resultsWithError[0].error.message
|
|
99
|
-
: undefined;
|
|
100
|
-
const checklist = {
|
|
101
|
-
supportedFormat: supportedFormatStep(credential, labels),
|
|
102
|
-
signature: signatureStep(byId(STEP_ID.validSignature), labels),
|
|
103
|
-
issuer: issuerStep(byId(STEP_ID.registeredIssuer), labels),
|
|
104
|
-
revocation: revocationStep(byId(STEP_ID.revocation), credential, labels),
|
|
105
|
-
expiration: expirationStep(byId(STEP_ID.expiration), credential, labels)
|
|
106
|
-
};
|
|
107
|
-
if (!globalErr) {
|
|
108
|
-
return attachLegacyAliases(checklist);
|
|
109
|
-
}
|
|
110
|
-
return attachLegacyAliases({
|
|
111
|
-
supportedFormat: withGlobalErr(checklist.supportedFormat, globalErr),
|
|
112
|
-
signature: withGlobalErr(checklist.signature, globalErr),
|
|
113
|
-
issuer: withGlobalErr(checklist.issuer, globalErr),
|
|
114
|
-
revocation: withGlobalErr(checklist.revocation, globalErr),
|
|
115
|
-
expiration: withGlobalErr(checklist.expiration, globalErr)
|
|
116
|
-
});
|
|
117
|
-
}
|
|
118
|
-
/**
|
|
119
|
-
* Rolls the checklist up to a single status. Hard failures (bad signature /
|
|
120
|
-
* format / revocation) yield `'not_verified'`; a soft issue (unknown issuer or
|
|
121
|
-
* expired) yields `'warning'`; otherwise `'verified'`.
|
|
122
|
-
*
|
|
123
|
-
* @param result {VerificationChecklist | null}
|
|
124
|
-
* @returns {VerificationAggregateStatus | null}
|
|
125
|
-
*/
|
|
126
|
-
export function getVerificationAggregateStatus(result) {
|
|
127
|
-
if (!result) {
|
|
128
|
-
return null;
|
|
129
|
-
}
|
|
130
|
-
const hasFailure = !result.signature.valid ||
|
|
131
|
-
!result.supportedFormat.valid ||
|
|
132
|
-
!result.revocation.valid;
|
|
133
|
-
const hasWarning = !result.issuer.valid || !result.expiration.valid;
|
|
134
|
-
if (hasFailure) {
|
|
135
|
-
return 'not_verified';
|
|
136
|
-
}
|
|
137
|
-
if (hasWarning) {
|
|
138
|
-
return 'warning';
|
|
139
|
-
}
|
|
140
|
-
return 'verified';
|
|
141
|
-
}
|
|
142
|
-
/**
|
|
143
|
-
* Whether every check passed.
|
|
144
|
-
*
|
|
145
|
-
* @param result {VerificationChecklist | null}
|
|
146
|
-
* @returns {boolean}
|
|
147
|
-
*/
|
|
148
|
-
export function isFullyVerified(result) {
|
|
149
|
-
return getVerificationAggregateStatus(result) === 'verified';
|
|
150
|
-
}
|
|
151
|
-
/**
|
|
152
|
-
* Whether the only failing check is expiration (everything else passed).
|
|
153
|
-
*
|
|
154
|
-
* @param result {VerificationChecklist | null}
|
|
155
|
-
* @returns {boolean}
|
|
156
|
-
*/
|
|
157
|
-
export function isExpiredOnly(result) {
|
|
158
|
-
if (!result) {
|
|
159
|
-
return false;
|
|
160
|
-
}
|
|
161
|
-
return (result.signature.valid &&
|
|
162
|
-
result.supportedFormat.valid &&
|
|
163
|
-
result.issuer.valid &&
|
|
164
|
-
result.revocation.valid &&
|
|
165
|
-
!result.expiration.valid);
|
|
166
|
-
}
|
|
167
|
-
/**
|
|
168
|
-
* Whether the aggregate status is a warning.
|
|
169
|
-
*
|
|
170
|
-
* @param result {VerificationChecklist | null}
|
|
171
|
-
* @returns {boolean}
|
|
172
|
-
*/
|
|
173
|
-
export function hasVerificationWarning(result) {
|
|
174
|
-
return getVerificationAggregateStatus(result) === 'warning';
|
|
175
|
-
}
|
|
176
|
-
/**
|
|
177
|
-
* Whether verification confirms a registered issuer: the `registered_issuer`
|
|
178
|
-
* log entry is valid and (when present) its `matchingIssuers` is non-empty.
|
|
179
|
-
* Backs DCW's `shouldDisableUrls` (a one-line app wrapper:
|
|
180
|
-
* `!issuerRecognizedByVerification(log)`).
|
|
181
|
-
*
|
|
182
|
-
* @param log {Array<{ id: string; valid?: boolean; matchingIssuers?: unknown[] }> | undefined}
|
|
183
|
-
* @returns {boolean}
|
|
184
|
-
*/
|
|
185
|
-
export function issuerRecognizedByVerification(log) {
|
|
186
|
-
if (!Array.isArray(log)) {
|
|
187
|
-
return false;
|
|
188
|
-
}
|
|
189
|
-
return log.some(entry => {
|
|
190
|
-
if (entry.id !== 'registered_issuer') {
|
|
191
|
-
return false;
|
|
192
|
-
}
|
|
193
|
-
const { matchingIssuers } = entry;
|
|
194
|
-
return entry.valid && Array.isArray(matchingIssuers)
|
|
195
|
-
? matchingIssuers.length > 0
|
|
196
|
-
: Boolean(entry.valid);
|
|
197
|
-
});
|
|
198
|
-
}
|
|
199
|
-
//# sourceMappingURL=verificationView.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"verificationView.js","sourceRoot":"","sources":["../../src/display/verificationView.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,112 +0,0 @@
|
|
|
1
|
-
import { type ResourceLogEntry, type ResourceLogStore } from '@interop/was-client/log';
|
|
2
|
-
import type { ResourceLogController } from './controller.js';
|
|
3
|
-
import { type ResourceLogSigner } from './entry.js';
|
|
4
|
-
import type { ResourceLogPinStore } from './pin.js';
|
|
5
|
-
import { type VerifiedResourceLog } from './verify.js';
|
|
6
|
-
/**
|
|
7
|
-
* Reads and fully verifies a log through the store seam, advancing the
|
|
8
|
-
* chain-head pin. Resolves `null` when the log resource does not exist yet
|
|
9
|
-
* (the pre-genesis state). The one read entry point every consumer -- a
|
|
10
|
-
* login-time roster read, a pre-append verification, a first-contact
|
|
11
|
-
* bootstrap -- goes through, so the pin rules cannot be bypassed by reading
|
|
12
|
-
* around them.
|
|
13
|
-
*
|
|
14
|
-
* @param options {object}
|
|
15
|
-
* @param options.store {ResourceLogStore} the log's transport seam
|
|
16
|
-
* @param options.controller {ResourceLogController} the verified controller
|
|
17
|
-
* view
|
|
18
|
-
* @param options.expectedMethod {string} the format identifier expected
|
|
19
|
-
* (also confirming any `history` dispatch hint the caller followed)
|
|
20
|
-
* @param options.pinStore {ResourceLogPinStore} this client's pin for this
|
|
21
|
-
* log
|
|
22
|
-
* @param options.logId {string} the pin-slot key for this log, from
|
|
23
|
-
* `resourceLogPinId`
|
|
24
|
-
* @returns {Promise<{ verified: VerifiedResourceLog; etag?: string } | null>}
|
|
25
|
-
*/
|
|
26
|
-
export declare function readResourceLog({ store, controller, expectedMethod, pinStore, logId }: {
|
|
27
|
-
store: ResourceLogStore;
|
|
28
|
-
controller: ResourceLogController;
|
|
29
|
-
expectedMethod: string;
|
|
30
|
-
pinStore: ResourceLogPinStore;
|
|
31
|
-
logId: string;
|
|
32
|
-
}): Promise<{
|
|
33
|
-
verified: VerifiedResourceLog;
|
|
34
|
-
etag?: string;
|
|
35
|
-
} | null>;
|
|
36
|
-
/**
|
|
37
|
-
* Appends one state change: verify, build against the verified head, CAS,
|
|
38
|
-
* rebase-and-retry on conflict, confirm by read-back. `buildState` is the
|
|
39
|
-
* rebase hook -- it is called with the current verified log on every attempt
|
|
40
|
-
* and returns the full next state built on THAT head's state (or `null` to
|
|
41
|
-
* signal the change is already present, making a re-run converge instead of
|
|
42
|
-
* duplicating an entry). Refuses a log whose verified head is a terminal
|
|
43
|
-
* handover entry ({@link ResourceLogClosedError}).
|
|
44
|
-
*
|
|
45
|
-
* @param options {object}
|
|
46
|
-
* @param options.store {ResourceLogStore}
|
|
47
|
-
* @param options.controller {ResourceLogController}
|
|
48
|
-
* @param options.expectedMethod {string}
|
|
49
|
-
* @param options.pinStore {ResourceLogPinStore}
|
|
50
|
-
* @param options.logId {string} the pin-slot key for this log, from
|
|
51
|
-
* `resourceLogPinId`
|
|
52
|
-
* @param options.signer {ResourceLogSigner}
|
|
53
|
-
* @param options.buildState {function} `(verified) => state | null` -- the
|
|
54
|
-
* full next state rebased on the verified head, or `null` when the head
|
|
55
|
-
* already carries the change
|
|
56
|
-
* @param [options.versionTime] {string} RFC3339 UTC; defaults to now
|
|
57
|
-
* @param [options.maxAttempts] {number} CAS attempts before giving up
|
|
58
|
-
* (default 3)
|
|
59
|
-
* @returns {Promise<VerifiedResourceLog>} the read-back, re-verified log
|
|
60
|
-
* (whether or not this call appended)
|
|
61
|
-
*/
|
|
62
|
-
export declare function appendResourceLog({ store, controller, expectedMethod, pinStore, logId, signer, buildState, versionTime, maxAttempts }: {
|
|
63
|
-
store: ResourceLogStore;
|
|
64
|
-
controller: ResourceLogController;
|
|
65
|
-
expectedMethod: string;
|
|
66
|
-
pinStore: ResourceLogPinStore;
|
|
67
|
-
logId: string;
|
|
68
|
-
signer: ResourceLogSigner;
|
|
69
|
-
buildState: (verified: VerifiedResourceLog) => Promise<ResourceLogEntry['state'] | null> | ResourceLogEntry['state'] | null;
|
|
70
|
-
versionTime?: string;
|
|
71
|
-
maxAttempts?: number;
|
|
72
|
-
}): Promise<VerifiedResourceLog>;
|
|
73
|
-
/**
|
|
74
|
-
* Creates a log with its genesis entry, guarded create-if-absent, and
|
|
75
|
-
* confirms by read-back. Losing the create race to a concurrent provisioner
|
|
76
|
-
* adopts the winner's log (the create is CAS, never clobbering): the served
|
|
77
|
-
* log is verified and pinned, and the caller reconciles its intended state
|
|
78
|
-
* through an ordinary {@link appendResourceLog}. First contact is where the
|
|
79
|
-
* pin is established, so the pin store is written either way.
|
|
80
|
-
*
|
|
81
|
-
* @param options {object}
|
|
82
|
-
* @param options.store {ResourceLogStore}
|
|
83
|
-
* @param options.controller {ResourceLogController}
|
|
84
|
-
* @param options.method {string} the format identifier to declare
|
|
85
|
-
* @param options.pinStore {ResourceLogPinStore}
|
|
86
|
-
* @param options.logId {string} the pin-slot key for this log, from
|
|
87
|
-
* `resourceLogPinId`
|
|
88
|
-
* @param options.signer {ResourceLogSigner}
|
|
89
|
-
* @param options.state {ResourceLogEntry['state']} the full initial state
|
|
90
|
-
* @param [options.previousLog] {object} handover successors only
|
|
91
|
-
* @param [options.versionTime] {string} RFC3339 UTC; defaults to now
|
|
92
|
-
* @returns {Promise<{ verified: VerifiedResourceLog; created: boolean }>}
|
|
93
|
-
* the verified log as it now stands, and whether this call created it
|
|
94
|
-
*/
|
|
95
|
-
export declare function createResourceLog({ store, controller, method, pinStore, logId, signer, state, previousLog, versionTime }: {
|
|
96
|
-
store: ResourceLogStore;
|
|
97
|
-
controller: ResourceLogController;
|
|
98
|
-
method: string;
|
|
99
|
-
pinStore: ResourceLogPinStore;
|
|
100
|
-
logId: string;
|
|
101
|
-
signer: ResourceLogSigner;
|
|
102
|
-
state: ResourceLogEntry['state'];
|
|
103
|
-
previousLog?: {
|
|
104
|
-
scid: string;
|
|
105
|
-
head: string;
|
|
106
|
-
};
|
|
107
|
-
versionTime?: string;
|
|
108
|
-
}): Promise<{
|
|
109
|
-
verified: VerifiedResourceLog;
|
|
110
|
-
created: boolean;
|
|
111
|
-
}>;
|
|
112
|
-
//# sourceMappingURL=append.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"append.d.ts","sourceRoot":"","sources":["../../src/resourceLog/append.ts"],"names":[],"mappings":"AAeA,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACtB,MAAM,yBAAyB,CAAA;AAChC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAA;AAE5D,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,YAAY,CAAA;AACnB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAA;AACnD,OAAO,EAAqB,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAEzE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,eAAe,CAAC,EACpC,KAAK,EACL,UAAU,EACV,cAAc,EACd,QAAQ,EACR,KAAK,EACN,EAAE;IACD,KAAK,EAAE,gBAAgB,CAAA;IACvB,UAAU,EAAE,qBAAqB,CAAA;IACjC,cAAc,EAAE,MAAM,CAAA;IACtB,QAAQ,EAAE,mBAAmB,CAAA;IAC7B,KAAK,EAAE,MAAM,CAAA;CACd,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,mBAAmB,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAcnE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,iBAAiB,CAAC,EACtC,KAAK,EACL,UAAU,EACV,cAAc,EACd,QAAQ,EACR,KAAK,EACL,MAAM,EACN,UAAU,EACV,WAAW,EACX,WAAe,EAChB,EAAE;IACD,KAAK,EAAE,gBAAgB,CAAA;IACvB,UAAU,EAAE,qBAAqB,CAAA;IACjC,cAAc,EAAE,MAAM,CAAA;IACtB,QAAQ,EAAE,mBAAmB,CAAA;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,iBAAiB,CAAA;IACzB,UAAU,EAAE,CACV,QAAQ,EAAE,mBAAmB,KAE7B,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,gBAAgB,CAAC,OAAO,CAAC,GAAG,IAAI,CAAA;IAC9E,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAgE/B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,iBAAiB,CAAC,EACtC,KAAK,EACL,UAAU,EACV,MAAM,EACN,QAAQ,EACR,KAAK,EACL,MAAM,EACN,KAAK,EACL,WAAW,EACX,WAAW,EACZ,EAAE;IACD,KAAK,EAAE,gBAAgB,CAAA;IACvB,UAAU,EAAE,qBAAqB,CAAA;IACjC,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,mBAAmB,CAAA;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,iBAAiB,CAAA;IACzB,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;IAChC,WAAW,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,mBAAmB,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAmC/D"}
|
|
@@ -1,197 +0,0 @@
|
|
|
1
|
-
/*!
|
|
2
|
-
* Copyright (c) 2026 Interop Alliance. All rights reserved.
|
|
3
|
-
*/
|
|
4
|
-
/**
|
|
5
|
-
* The append path (App Connect spec `#log-append`): read the full log and
|
|
6
|
-
* verify it (an entry is never built on an unverified head), build the new
|
|
7
|
-
* entry against the verified head anchored at the writer's current verified
|
|
8
|
-
* controller head, write compare-and-swapped on the read's validator, and on
|
|
9
|
-
* conflict re-read, re-verify, rebase, retry. A write acknowledgement is a
|
|
10
|
-
* promise, not a fact: every append is confirmed by reading the log back and
|
|
11
|
-
* re-verifying the extended history before the append -- or any ceremony step
|
|
12
|
-
* gated on it -- is treated as durable. The chain-head pin advances on every
|
|
13
|
-
* successful verification along the way, and only ever forward.
|
|
14
|
-
*/
|
|
15
|
-
import { PreconditionFailedError } from '@interop/was-client';
|
|
16
|
-
import { confirmAppend } from '@interop/was-client/log';
|
|
17
|
-
import { ResourceLogClosedError } from './errors.js';
|
|
18
|
-
import { buildResourceLogEntry, buildResourceLogGenesis } from './entry.js';
|
|
19
|
-
import { verifyResourceLog } from './verify.js';
|
|
20
|
-
/**
|
|
21
|
-
* Reads and fully verifies a log through the store seam, advancing the
|
|
22
|
-
* chain-head pin. Resolves `null` when the log resource does not exist yet
|
|
23
|
-
* (the pre-genesis state). The one read entry point every consumer -- a
|
|
24
|
-
* login-time roster read, a pre-append verification, a first-contact
|
|
25
|
-
* bootstrap -- goes through, so the pin rules cannot be bypassed by reading
|
|
26
|
-
* around them.
|
|
27
|
-
*
|
|
28
|
-
* @param options {object}
|
|
29
|
-
* @param options.store {ResourceLogStore} the log's transport seam
|
|
30
|
-
* @param options.controller {ResourceLogController} the verified controller
|
|
31
|
-
* view
|
|
32
|
-
* @param options.expectedMethod {string} the format identifier expected
|
|
33
|
-
* (also confirming any `history` dispatch hint the caller followed)
|
|
34
|
-
* @param options.pinStore {ResourceLogPinStore} this client's pin for this
|
|
35
|
-
* log
|
|
36
|
-
* @param options.logId {string} the pin-slot key for this log, from
|
|
37
|
-
* `resourceLogPinId`
|
|
38
|
-
* @returns {Promise<{ verified: VerifiedResourceLog; etag?: string } | null>}
|
|
39
|
-
*/
|
|
40
|
-
export async function readResourceLog({ store, controller, expectedMethod, pinStore, logId }) {
|
|
41
|
-
const current = await store.read();
|
|
42
|
-
if (current === null) {
|
|
43
|
-
return null;
|
|
44
|
-
}
|
|
45
|
-
const pin = await pinStore.read({ logId });
|
|
46
|
-
const verified = await verifyResourceLog({
|
|
47
|
-
entries: current.entries,
|
|
48
|
-
controller,
|
|
49
|
-
expectedMethod,
|
|
50
|
-
pin
|
|
51
|
-
});
|
|
52
|
-
await pinStore.write({ logId, pin: verified.pin });
|
|
53
|
-
return { verified, etag: current.etag };
|
|
54
|
-
}
|
|
55
|
-
/**
|
|
56
|
-
* Appends one state change: verify, build against the verified head, CAS,
|
|
57
|
-
* rebase-and-retry on conflict, confirm by read-back. `buildState` is the
|
|
58
|
-
* rebase hook -- it is called with the current verified log on every attempt
|
|
59
|
-
* and returns the full next state built on THAT head's state (or `null` to
|
|
60
|
-
* signal the change is already present, making a re-run converge instead of
|
|
61
|
-
* duplicating an entry). Refuses a log whose verified head is a terminal
|
|
62
|
-
* handover entry ({@link ResourceLogClosedError}).
|
|
63
|
-
*
|
|
64
|
-
* @param options {object}
|
|
65
|
-
* @param options.store {ResourceLogStore}
|
|
66
|
-
* @param options.controller {ResourceLogController}
|
|
67
|
-
* @param options.expectedMethod {string}
|
|
68
|
-
* @param options.pinStore {ResourceLogPinStore}
|
|
69
|
-
* @param options.logId {string} the pin-slot key for this log, from
|
|
70
|
-
* `resourceLogPinId`
|
|
71
|
-
* @param options.signer {ResourceLogSigner}
|
|
72
|
-
* @param options.buildState {function} `(verified) => state | null` -- the
|
|
73
|
-
* full next state rebased on the verified head, or `null` when the head
|
|
74
|
-
* already carries the change
|
|
75
|
-
* @param [options.versionTime] {string} RFC3339 UTC; defaults to now
|
|
76
|
-
* @param [options.maxAttempts] {number} CAS attempts before giving up
|
|
77
|
-
* (default 3)
|
|
78
|
-
* @returns {Promise<VerifiedResourceLog>} the read-back, re-verified log
|
|
79
|
-
* (whether or not this call appended)
|
|
80
|
-
*/
|
|
81
|
-
export async function appendResourceLog({ store, controller, expectedMethod, pinStore, logId, signer, buildState, versionTime, maxAttempts = 3 }) {
|
|
82
|
-
let lastConflict;
|
|
83
|
-
for (let attempt = 0; attempt < maxAttempts; attempt++) {
|
|
84
|
-
const current = await readResourceLog({
|
|
85
|
-
store,
|
|
86
|
-
controller,
|
|
87
|
-
expectedMethod,
|
|
88
|
-
pinStore,
|
|
89
|
-
logId
|
|
90
|
-
});
|
|
91
|
-
if (current === null) {
|
|
92
|
-
throw new Error('Cannot append to the resource log: the log does not exist yet ' +
|
|
93
|
-
'(create it with its genesis entry first).');
|
|
94
|
-
}
|
|
95
|
-
const { verified, etag } = current;
|
|
96
|
-
if (verified.terminal) {
|
|
97
|
-
throw new ResourceLogClosedError({ nextLog: verified.terminal });
|
|
98
|
-
}
|
|
99
|
-
if (etag === undefined) {
|
|
100
|
-
throw new Error('Cannot append to the resource log: the backend returned no ' +
|
|
101
|
-
'validator, and the profile forbids an unconditional write.');
|
|
102
|
-
}
|
|
103
|
-
const state = await buildState(verified);
|
|
104
|
-
if (state === null) {
|
|
105
|
-
// The head already carries the change -- a torn earlier run landed it,
|
|
106
|
-
// or a concurrent writer did. Converged.
|
|
107
|
-
return verified;
|
|
108
|
-
}
|
|
109
|
-
const entry = await buildResourceLogEntry({
|
|
110
|
-
head: verified.head,
|
|
111
|
-
state,
|
|
112
|
-
controller,
|
|
113
|
-
signer,
|
|
114
|
-
versionTime
|
|
115
|
-
});
|
|
116
|
-
try {
|
|
117
|
-
await store.append(entry, { ifMatch: etag });
|
|
118
|
-
}
|
|
119
|
-
catch (err) {
|
|
120
|
-
if (err instanceof PreconditionFailedError) {
|
|
121
|
-
// A concurrent append won the CAS: re-read, re-verify, rebase, retry.
|
|
122
|
-
lastConflict = err;
|
|
123
|
-
continue;
|
|
124
|
-
}
|
|
125
|
-
throw err;
|
|
126
|
-
}
|
|
127
|
-
const readBack = await confirmAppend({ store, entry });
|
|
128
|
-
const confirmed = await verifyResourceLog({
|
|
129
|
-
entries: readBack.entries,
|
|
130
|
-
controller,
|
|
131
|
-
expectedMethod,
|
|
132
|
-
pin: await pinStore.read({ logId })
|
|
133
|
-
});
|
|
134
|
-
await pinStore.write({ logId, pin: confirmed.pin });
|
|
135
|
-
return confirmed;
|
|
136
|
-
}
|
|
137
|
-
throw new Error(`Appending to the resource log lost the compare-and-swap race ` +
|
|
138
|
-
`${maxAttempts} times in a row.`, { cause: lastConflict });
|
|
139
|
-
}
|
|
140
|
-
/**
|
|
141
|
-
* Creates a log with its genesis entry, guarded create-if-absent, and
|
|
142
|
-
* confirms by read-back. Losing the create race to a concurrent provisioner
|
|
143
|
-
* adopts the winner's log (the create is CAS, never clobbering): the served
|
|
144
|
-
* log is verified and pinned, and the caller reconciles its intended state
|
|
145
|
-
* through an ordinary {@link appendResourceLog}. First contact is where the
|
|
146
|
-
* pin is established, so the pin store is written either way.
|
|
147
|
-
*
|
|
148
|
-
* @param options {object}
|
|
149
|
-
* @param options.store {ResourceLogStore}
|
|
150
|
-
* @param options.controller {ResourceLogController}
|
|
151
|
-
* @param options.method {string} the format identifier to declare
|
|
152
|
-
* @param options.pinStore {ResourceLogPinStore}
|
|
153
|
-
* @param options.logId {string} the pin-slot key for this log, from
|
|
154
|
-
* `resourceLogPinId`
|
|
155
|
-
* @param options.signer {ResourceLogSigner}
|
|
156
|
-
* @param options.state {ResourceLogEntry['state']} the full initial state
|
|
157
|
-
* @param [options.previousLog] {object} handover successors only
|
|
158
|
-
* @param [options.versionTime] {string} RFC3339 UTC; defaults to now
|
|
159
|
-
* @returns {Promise<{ verified: VerifiedResourceLog; created: boolean }>}
|
|
160
|
-
* the verified log as it now stands, and whether this call created it
|
|
161
|
-
*/
|
|
162
|
-
export async function createResourceLog({ store, controller, method, pinStore, logId, signer, state, previousLog, versionTime }) {
|
|
163
|
-
const genesis = await buildResourceLogGenesis({
|
|
164
|
-
state,
|
|
165
|
-
method,
|
|
166
|
-
controller,
|
|
167
|
-
signer,
|
|
168
|
-
previousLog,
|
|
169
|
-
versionTime
|
|
170
|
-
});
|
|
171
|
-
let created = true;
|
|
172
|
-
try {
|
|
173
|
-
await store.create(genesis);
|
|
174
|
-
}
|
|
175
|
-
catch (err) {
|
|
176
|
-
if (!(err instanceof PreconditionFailedError)) {
|
|
177
|
-
throw err;
|
|
178
|
-
}
|
|
179
|
-
created = false;
|
|
180
|
-
}
|
|
181
|
-
const current = created
|
|
182
|
-
? await confirmAppend({ store, entry: genesis })
|
|
183
|
-
: await store.read();
|
|
184
|
-
if (current === null) {
|
|
185
|
-
throw new Error('The resource log create lost its guarded-create race, but no log ' +
|
|
186
|
-
'was served on re-read.');
|
|
187
|
-
}
|
|
188
|
-
const verified = await verifyResourceLog({
|
|
189
|
-
entries: current.entries,
|
|
190
|
-
controller,
|
|
191
|
-
expectedMethod: method,
|
|
192
|
-
pin: await pinStore.read({ logId })
|
|
193
|
-
});
|
|
194
|
-
await pinStore.write({ logId, pin: verified.pin });
|
|
195
|
-
return { verified, created };
|
|
196
|
-
}
|
|
197
|
-
//# sourceMappingURL=append.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"append.js","sourceRoot":"","sources":["../../src/resourceLog/append.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,68 +0,0 @@
|
|
|
1
|
-
import type { ResourceLogEntry } from '@interop/was-client/log';
|
|
2
|
-
import type { ResourceLogController } from './controller.js';
|
|
3
|
-
/**
|
|
4
|
-
* The writer's signing seam: its enrolled Ed25519 signing key's multibase
|
|
5
|
-
* (the fragment of its verification method in the controller document) and a
|
|
6
|
-
* raw detached-signature hook over it. The multibase names the key in the
|
|
7
|
-
* proof's `verificationMethod`; membership under `assertionMethod` at the
|
|
8
|
-
* anchored version is what authorizes the append.
|
|
9
|
-
*/
|
|
10
|
-
export interface ResourceLogSigner {
|
|
11
|
-
keyMultibase: string;
|
|
12
|
-
sign(input: {
|
|
13
|
-
data: Uint8Array;
|
|
14
|
-
}): Promise<Uint8Array>;
|
|
15
|
-
}
|
|
16
|
-
/**
|
|
17
|
-
* Builds and signs a genesis entry by the profile's two-pass SCID procedure:
|
|
18
|
-
* the preliminary entry carries the `{SCID}` placeholder as `versionId` and
|
|
19
|
-
* `parameters.scid`, its hash is the SCID, and the final entry substitutes it
|
|
20
|
-
* back in before the ordinary entry hash is computed (`versionId` input
|
|
21
|
-
* value: the SCID).
|
|
22
|
-
*
|
|
23
|
-
* @param options {object}
|
|
24
|
-
* @param options.state {ResourceLogEntry['state']} the full initial state
|
|
25
|
-
* (with its `type`)
|
|
26
|
-
* @param options.method {string} the format identifier
|
|
27
|
-
* (`RESOURCE_LOG_METHOD`)
|
|
28
|
-
* @param options.controller {ResourceLogController} the verified controller
|
|
29
|
-
* view -- the anchor source
|
|
30
|
-
* @param options.signer {ResourceLogSigner}
|
|
31
|
-
* @param [options.previousLog] {object} handover successors only: the prior
|
|
32
|
-
* log's SCID and the `versionId` of its terminal entry's predecessor
|
|
33
|
-
* @param [options.versionTime] {string} RFC3339 UTC; defaults to now
|
|
34
|
-
* @returns {Promise<ResourceLogEntry>}
|
|
35
|
-
*/
|
|
36
|
-
export declare function buildResourceLogGenesis({ state, method, controller, signer, previousLog, versionTime }: {
|
|
37
|
-
state: ResourceLogEntry['state'];
|
|
38
|
-
method: string;
|
|
39
|
-
controller: ResourceLogController;
|
|
40
|
-
signer: ResourceLogSigner;
|
|
41
|
-
previousLog?: {
|
|
42
|
-
scid: string;
|
|
43
|
-
head: string;
|
|
44
|
-
};
|
|
45
|
-
versionTime?: string;
|
|
46
|
-
}): Promise<ResourceLogEntry>;
|
|
47
|
-
/**
|
|
48
|
-
* Builds and signs the next ordinary entry against a verified head: full
|
|
49
|
-
* state, empty `parameters`, hash chained off the head's `versionId`, proof
|
|
50
|
-
* anchored at the controller's verified head. Callers hold a verified head
|
|
51
|
-
* by construction (an entry is never built on an unverified one).
|
|
52
|
-
*
|
|
53
|
-
* @param options {object}
|
|
54
|
-
* @param options.head {ResourceLogEntry} the verified head entry
|
|
55
|
-
* @param options.state {ResourceLogEntry['state']} the full next state
|
|
56
|
-
* @param options.controller {ResourceLogController}
|
|
57
|
-
* @param options.signer {ResourceLogSigner}
|
|
58
|
-
* @param [options.versionTime] {string} RFC3339 UTC; defaults to now
|
|
59
|
-
* @returns {Promise<ResourceLogEntry>}
|
|
60
|
-
*/
|
|
61
|
-
export declare function buildResourceLogEntry({ head, state, controller, signer, versionTime }: {
|
|
62
|
-
head: ResourceLogEntry;
|
|
63
|
-
state: ResourceLogEntry['state'];
|
|
64
|
-
controller: ResourceLogController;
|
|
65
|
-
signer: ResourceLogSigner;
|
|
66
|
-
versionTime?: string;
|
|
67
|
-
}): Promise<ResourceLogEntry>;
|
|
68
|
-
//# sourceMappingURL=entry.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"entry.d.ts","sourceRoot":"","sources":["../../src/resourceLog/entry.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC/D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAA;AAE5D;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,UAAU,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;CACvD;AAqFD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,uBAAuB,CAAC,EAC5C,KAAK,EACL,MAAM,EACN,UAAU,EACV,MAAM,EACN,WAAW,EACX,WAAW,EACZ,EAAE;IACD,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;IAChC,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,qBAAqB,CAAA;IACjC,MAAM,EAAE,iBAAiB,CAAA;IACzB,WAAW,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAmC5B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,qBAAqB,CAAC,EAC1C,IAAI,EACJ,KAAK,EACL,UAAU,EACV,MAAM,EACN,WAAW,EACZ,EAAE;IACD,IAAI,EAAE,gBAAgB,CAAA;IACtB,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;IAChC,UAAU,EAAE,qBAAqB,CAAA;IACjC,MAAM,EAAE,iBAAiB,CAAA;IACzB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA0B5B"}
|