@metamask-previews/shield-controller 6.0.2-preview-6eff555ee → 7.0.0-preview-97d6b86c0
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/CHANGELOG.md +19 -1
- package/dist/{ShieldController-method-action-types.d.mts → ShieldController-method-action-types.d.ts} +2 -2
- package/dist/ShieldController-method-action-types.d.ts.map +1 -0
- package/dist/{ShieldController-method-action-types.mjs → ShieldController-method-action-types.js} +1 -1
- package/dist/ShieldController-method-action-types.js.map +1 -0
- package/dist/{ShieldController.d.cts → ShieldController.d.ts} +10 -10
- package/dist/ShieldController.d.ts.map +1 -0
- package/dist/ShieldController.js +290 -0
- package/dist/ShieldController.js.map +1 -0
- package/dist/{constants.d.cts → constants.d.ts} +1 -1
- package/dist/constants.d.ts.map +1 -0
- package/dist/{constants.mjs → constants.js} +1 -1
- package/dist/constants.js.map +1 -0
- package/dist/{index.d.cts → index.d.ts} +9 -9
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +4 -0
- package/dist/index.js.map +1 -0
- package/dist/logger.d.ts +4 -0
- package/dist/logger.d.ts.map +1 -0
- package/dist/logger.js +5 -0
- package/dist/logger.js.map +1 -0
- package/dist/{polling-with-policy.d.cts → polling-with-policy.d.ts} +2 -2
- package/dist/polling-with-policy.d.ts.map +1 -0
- package/dist/polling-with-policy.js +62 -0
- package/dist/polling-with-policy.js.map +1 -0
- package/dist/{shield-api-service-method-action-types.d.mts → shield-api-service-method-action-types.d.ts} +2 -2
- package/dist/shield-api-service-method-action-types.d.ts.map +1 -0
- package/dist/{shield-api-service-method-action-types.mjs → shield-api-service-method-action-types.js} +1 -1
- package/dist/shield-api-service-method-action-types.js.map +1 -0
- package/dist/{shield-api-service.d.cts → shield-api-service.d.ts} +14 -14
- package/dist/shield-api-service.d.ts.map +1 -0
- package/dist/{shield-api-service.mjs → shield-api-service.js} +94 -105
- package/dist/shield-api-service.js.map +1 -0
- package/dist/{types.d.cts → types.d.ts} +4 -4
- package/dist/types.d.ts.map +1 -0
- package/dist/{types.mjs → types.js} +1 -1
- package/dist/types.js.map +1 -0
- package/package.json +21 -25
- package/dist/ShieldController-method-action-types.cjs +0 -7
- package/dist/ShieldController-method-action-types.cjs.map +0 -1
- package/dist/ShieldController-method-action-types.d.cts +0 -51
- package/dist/ShieldController-method-action-types.d.cts.map +0 -1
- package/dist/ShieldController-method-action-types.d.mts.map +0 -1
- package/dist/ShieldController-method-action-types.mjs.map +0 -1
- package/dist/ShieldController.cjs +0 -294
- package/dist/ShieldController.cjs.map +0 -1
- package/dist/ShieldController.d.cts.map +0 -1
- package/dist/ShieldController.d.mts +0 -106
- package/dist/ShieldController.d.mts.map +0 -1
- package/dist/ShieldController.mjs +0 -290
- package/dist/ShieldController.mjs.map +0 -1
- package/dist/constants.cjs +0 -51
- package/dist/constants.cjs.map +0 -1
- package/dist/constants.d.cts.map +0 -1
- package/dist/constants.d.mts +0 -35
- package/dist/constants.d.mts.map +0 -1
- package/dist/constants.mjs.map +0 -1
- package/dist/index.cjs +0 -16
- package/dist/index.cjs.map +0 -1
- package/dist/index.d.cts.map +0 -1
- package/dist/index.d.mts +0 -9
- package/dist/index.d.mts.map +0 -1
- package/dist/index.mjs +0 -4
- package/dist/index.mjs.map +0 -1
- package/dist/logger.cjs +0 -8
- package/dist/logger.cjs.map +0 -1
- package/dist/logger.d.cts +0 -5
- package/dist/logger.d.cts.map +0 -1
- package/dist/logger.d.mts +0 -5
- package/dist/logger.d.mts.map +0 -1
- package/dist/logger.mjs +0 -5
- package/dist/logger.mjs.map +0 -1
- package/dist/polling-with-policy.cjs +0 -77
- package/dist/polling-with-policy.cjs.map +0 -1
- package/dist/polling-with-policy.d.cts.map +0 -1
- package/dist/polling-with-policy.d.mts +0 -9
- package/dist/polling-with-policy.d.mts.map +0 -1
- package/dist/polling-with-policy.mjs +0 -73
- package/dist/polling-with-policy.mjs.map +0 -1
- package/dist/shield-api-service-method-action-types.cjs +0 -7
- package/dist/shield-api-service-method-action-types.cjs.map +0 -1
- package/dist/shield-api-service-method-action-types.d.cts +0 -48
- package/dist/shield-api-service-method-action-types.d.cts.map +0 -1
- package/dist/shield-api-service-method-action-types.d.mts.map +0 -1
- package/dist/shield-api-service-method-action-types.mjs.map +0 -1
- package/dist/shield-api-service.cjs +0 -371
- package/dist/shield-api-service.cjs.map +0 -1
- package/dist/shield-api-service.d.cts.map +0 -1
- package/dist/shield-api-service.d.mts +0 -164
- package/dist/shield-api-service.d.mts.map +0 -1
- package/dist/shield-api-service.mjs.map +0 -1
- package/dist/types.cjs +0 -5
- package/dist/types.cjs.map +0 -1
- package/dist/types.d.cts.map +0 -1
- package/dist/types.d.mts +0 -34
- package/dist/types.d.mts.map +0 -1
- package/dist/types.mjs.map +0 -1
package/CHANGELOG.md
CHANGED
|
@@ -7,6 +7,23 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
7
7
|
|
|
8
8
|
## [Unreleased]
|
|
9
9
|
|
|
10
|
+
## [7.0.0]
|
|
11
|
+
|
|
12
|
+
### Changed
|
|
13
|
+
|
|
14
|
+
- **BREAKING:** Drop CommonJS support ([#9536](https://github.com/MetaMask/core/pull/9536))
|
|
15
|
+
- This package is now ESM-only, but can still be used in CommonJS projects via `require(esm)` in modern Node.js versions (22+), or dynamic imports in older Node.js versions.
|
|
16
|
+
- **BREAKING:** Bump minimum Node.js version to 22 ([#9976](https://github.com/MetaMask/core/pull/9976))
|
|
17
|
+
- **BREAKING:** Bump TypeScript target to ES2022 ([#10019](https://github.com/MetaMask/core/pull/10019))
|
|
18
|
+
- This package now ships ES2022 code, requiring a compatible modern environment or bundler configuration to consume.
|
|
19
|
+
- Bump `@metamask/base-controller` from `^9.1.0` to `^10.0.0` ([#10160](https://github.com/MetaMask/core/pull/10160))
|
|
20
|
+
- Bump `@metamask/base-data-service` from `^1.0.0` to `^2.0.0` ([#10160](https://github.com/MetaMask/core/pull/10160))
|
|
21
|
+
- Bump `@metamask/controller-utils` from `^12.3.0` to `^13.0.0` ([#10160](https://github.com/MetaMask/core/pull/10160))
|
|
22
|
+
- Bump `@metamask/messenger` from `^2.0.0` to `^3.0.0` ([#10160](https://github.com/MetaMask/core/pull/10160))
|
|
23
|
+
- Bump `@metamask/profile-sync-controller` from `^30.0.0` to `^31.0.0` ([#10160](https://github.com/MetaMask/core/pull/10160))
|
|
24
|
+
- Bump `@metamask/signature-controller` from `^39.2.10` to `^40.0.0` ([#10160](https://github.com/MetaMask/core/pull/10160))
|
|
25
|
+
- Bump `@metamask/transaction-controller` from `^69.8.1` to `^70.0.0` ([#10160](https://github.com/MetaMask/core/pull/10160))
|
|
26
|
+
|
|
10
27
|
## [6.0.2]
|
|
11
28
|
|
|
12
29
|
### Changed
|
|
@@ -295,7 +312,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
295
312
|
|
|
296
313
|
- Initial release of the shield-controller package ([#6137](https://github.com/MetaMask/core/pull/6137)
|
|
297
314
|
|
|
298
|
-
[Unreleased]: https://github.com/MetaMask/core/compare/@metamask/shield-controller@
|
|
315
|
+
[Unreleased]: https://github.com/MetaMask/core/compare/@metamask/shield-controller@7.0.0...HEAD
|
|
316
|
+
[7.0.0]: https://github.com/MetaMask/core/compare/@metamask/shield-controller@6.0.2...@metamask/shield-controller@7.0.0
|
|
299
317
|
[6.0.2]: https://github.com/MetaMask/core/compare/@metamask/shield-controller@6.0.1...@metamask/shield-controller@6.0.2
|
|
300
318
|
[6.0.1]: https://github.com/MetaMask/core/compare/@metamask/shield-controller@6.0.0...@metamask/shield-controller@6.0.1
|
|
301
319
|
[6.0.0]: https://github.com/MetaMask/core/compare/@metamask/shield-controller@5.1.3...@metamask/shield-controller@6.0.0
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
* This file is auto generated.
|
|
3
3
|
* Do not edit manually.
|
|
4
4
|
*/
|
|
5
|
-
import type { ShieldController } from
|
|
5
|
+
import type { ShieldController } from './ShieldController.js';
|
|
6
6
|
/**
|
|
7
7
|
* Start the ShieldController and subscribe to the transaction and signature controller state changes.
|
|
8
8
|
*/
|
|
@@ -48,4 +48,4 @@ export type ShieldControllerCheckSignatureCoverageAction = {
|
|
|
48
48
|
* Union of all ShieldController action types.
|
|
49
49
|
*/
|
|
50
50
|
export type ShieldControllerMethodActions = ShieldControllerStartAction | ShieldControllerStopAction | ShieldControllerClearStateAction | ShieldControllerCheckCoverageAction | ShieldControllerCheckSignatureCoverageAction;
|
|
51
|
-
//# sourceMappingURL=ShieldController-method-action-types.d.
|
|
51
|
+
//# sourceMappingURL=ShieldController-method-action-types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ShieldController-method-action-types.d.ts","sourceRoot":"","sources":["../src/ShieldController-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC,IAAI,EAAE,wBAAwB,CAAC;IAC/B,OAAO,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC;CACpC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC,IAAI,EAAE,uBAAuB,CAAC;IAC9B,OAAO,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;CACnC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gCAAgC,GAAG;IAC7C,IAAI,EAAE,6BAA6B,CAAC;IACpC,OAAO,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAC;CACzC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,mCAAmC,GAAG;IAChD,IAAI,EAAE,gCAAgC,CAAC;IACvC,OAAO,EAAE,gBAAgB,CAAC,eAAe,CAAC,CAAC;CAC5C,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,4CAA4C,GAAG;IACzD,IAAI,EAAE,yCAAyC,CAAC;IAChD,OAAO,EAAE,gBAAgB,CAAC,wBAAwB,CAAC,CAAC;CACrD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,6BAA6B,GACrC,2BAA2B,GAC3B,0BAA0B,GAC1B,gCAAgC,GAChC,mCAAmC,GACnC,4CAA4C,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ShieldController-method-action-types.js","sourceRoot":"","sources":["../src/ShieldController-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated.\n * Do not edit manually.\n */\n\nimport type { ShieldController } from './ShieldController.js';\n\n/**\n * Start the ShieldController and subscribe to the transaction and signature controller state changes.\n */\nexport type ShieldControllerStartAction = {\n type: `ShieldController:start`;\n handler: ShieldController['start'];\n};\n\n/**\n * Stop the ShieldController and unsubscribe from the transaction and signature controller state changes.\n */\nexport type ShieldControllerStopAction = {\n type: `ShieldController:stop`;\n handler: ShieldController['stop'];\n};\n\n/**\n * Clears the shield state and resets to default values.\n */\nexport type ShieldControllerClearStateAction = {\n type: `ShieldController:clearState`;\n handler: ShieldController['clearState'];\n};\n\n/**\n * Checks the coverage of a transaction.\n *\n * @param txMeta - The transaction to check coverage for.\n * @returns The coverage result.\n */\nexport type ShieldControllerCheckCoverageAction = {\n type: `ShieldController:checkCoverage`;\n handler: ShieldController['checkCoverage'];\n};\n\n/**\n * Checks the coverage of a signature request.\n *\n * @param signatureRequest - The signature request to check coverage for.\n * @returns The coverage result.\n */\nexport type ShieldControllerCheckSignatureCoverageAction = {\n type: `ShieldController:checkSignatureCoverage`;\n handler: ShieldController['checkSignatureCoverage'];\n};\n\n/**\n * Union of all ShieldController action types.\n */\nexport type ShieldControllerMethodActions =\n | ShieldControllerStartAction\n | ShieldControllerStopAction\n | ShieldControllerClearStateAction\n | ShieldControllerCheckCoverageAction\n | ShieldControllerCheckSignatureCoverageAction;\n"]}
|
|
@@ -1,12 +1,12 @@
|
|
|
1
|
-
import { BaseController } from
|
|
2
|
-
import type { ControllerGetStateAction, ControllerStateChangeEvent } from
|
|
3
|
-
import type { Messenger } from
|
|
4
|
-
import type { SignatureRequest, SignatureStateChange } from
|
|
5
|
-
import type { TransactionControllerStateChangeEvent, TransactionMeta } from
|
|
6
|
-
import { controllerName } from
|
|
7
|
-
import type { ShieldApiServiceMethodActions } from
|
|
8
|
-
import type { ShieldControllerMethodActions } from
|
|
9
|
-
import type { CoverageResult, NormalizeSignatureRequestFn } from
|
|
1
|
+
import { BaseController } from '@metamask/base-controller';
|
|
2
|
+
import type { ControllerGetStateAction, ControllerStateChangeEvent } from '@metamask/base-controller';
|
|
3
|
+
import type { Messenger } from '@metamask/messenger';
|
|
4
|
+
import type { SignatureRequest, SignatureStateChange } from '@metamask/signature-controller';
|
|
5
|
+
import type { TransactionControllerStateChangeEvent, TransactionMeta } from '@metamask/transaction-controller';
|
|
6
|
+
import { controllerName } from './constants.js';
|
|
7
|
+
import type { ShieldApiServiceMethodActions } from './shield-api-service-method-action-types.js';
|
|
8
|
+
import type { ShieldControllerMethodActions } from './ShieldController-method-action-types.js';
|
|
9
|
+
import type { CoverageResult, NormalizeSignatureRequestFn } from './types.js';
|
|
10
10
|
export type CoverageResultRecordEntry = {
|
|
11
11
|
/**
|
|
12
12
|
* History of coverage results, latest first.
|
|
@@ -103,4 +103,4 @@ export declare class ShieldController extends BaseController<typeof controllerNa
|
|
|
103
103
|
checkSignatureCoverage(signatureRequest: SignatureRequest): Promise<CoverageResult>;
|
|
104
104
|
}
|
|
105
105
|
export {};
|
|
106
|
-
//# sourceMappingURL=ShieldController.d.
|
|
106
|
+
//# sourceMappingURL=ShieldController.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ShieldController.d.ts","sourceRoot":"","sources":["../src/ShieldController.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,290 @@
|
|
|
1
|
+
import { BaseController } from '@metamask/base-controller';
|
|
2
|
+
import { SignatureRequestStatus } from '@metamask/signature-controller';
|
|
3
|
+
import { TransactionStatus } from '@metamask/transaction-controller';
|
|
4
|
+
import { cloneDeep, isEqual } from 'lodash-es';
|
|
5
|
+
import { controllerName } from './constants.js';
|
|
6
|
+
import { projectLogger, createModuleLogger } from './logger.js';
|
|
7
|
+
const log = createModuleLogger(projectLogger, 'ShieldController');
|
|
8
|
+
const MESSENGER_EXPOSED_METHODS = [
|
|
9
|
+
'start',
|
|
10
|
+
'stop',
|
|
11
|
+
'clearState',
|
|
12
|
+
'checkCoverage',
|
|
13
|
+
'checkSignatureCoverage',
|
|
14
|
+
];
|
|
15
|
+
/**
|
|
16
|
+
* Get the default state for the ShieldController.
|
|
17
|
+
*
|
|
18
|
+
* @returns The default state for the ShieldController.
|
|
19
|
+
*/
|
|
20
|
+
export function getDefaultShieldControllerState() {
|
|
21
|
+
return {
|
|
22
|
+
coverageResults: {},
|
|
23
|
+
orderedTransactionHistory: [],
|
|
24
|
+
};
|
|
25
|
+
}
|
|
26
|
+
/**
|
|
27
|
+
* Metadata for the ShieldController state, describing how to "anonymize"
|
|
28
|
+
* the state and which parts should be persisted.
|
|
29
|
+
*/
|
|
30
|
+
const metadata = {
|
|
31
|
+
coverageResults: {
|
|
32
|
+
includeInStateLogs: true,
|
|
33
|
+
persist: true,
|
|
34
|
+
includeInDebugSnapshot: false,
|
|
35
|
+
usedInUi: true,
|
|
36
|
+
},
|
|
37
|
+
orderedTransactionHistory: {
|
|
38
|
+
includeInStateLogs: true,
|
|
39
|
+
persist: true,
|
|
40
|
+
includeInDebugSnapshot: false,
|
|
41
|
+
usedInUi: false,
|
|
42
|
+
},
|
|
43
|
+
};
|
|
44
|
+
export class ShieldController extends BaseController {
|
|
45
|
+
#coverageHistoryLimit;
|
|
46
|
+
#transactionHistoryLimit;
|
|
47
|
+
#normalizeSignatureRequest;
|
|
48
|
+
#transactionControllerStateChangeHandler;
|
|
49
|
+
#signatureControllerStateChangeHandler;
|
|
50
|
+
#started;
|
|
51
|
+
constructor(options) {
|
|
52
|
+
const { messenger, state, transactionHistoryLimit = 100, coverageHistoryLimit = 10, normalizeSignatureRequest, } = options;
|
|
53
|
+
super({
|
|
54
|
+
name: controllerName,
|
|
55
|
+
metadata,
|
|
56
|
+
messenger,
|
|
57
|
+
state: {
|
|
58
|
+
...getDefaultShieldControllerState(),
|
|
59
|
+
...state,
|
|
60
|
+
},
|
|
61
|
+
});
|
|
62
|
+
this.#coverageHistoryLimit = coverageHistoryLimit;
|
|
63
|
+
this.#transactionHistoryLimit = transactionHistoryLimit;
|
|
64
|
+
this.#transactionControllerStateChangeHandler =
|
|
65
|
+
this.#handleTransactionControllerStateChange.bind(this);
|
|
66
|
+
this.#signatureControllerStateChangeHandler =
|
|
67
|
+
this.#handleSignatureControllerStateChange.bind(this);
|
|
68
|
+
this.#started = false;
|
|
69
|
+
this.#normalizeSignatureRequest = normalizeSignatureRequest;
|
|
70
|
+
this.messenger.registerMethodActionHandlers(this, MESSENGER_EXPOSED_METHODS);
|
|
71
|
+
}
|
|
72
|
+
/**
|
|
73
|
+
* Start the ShieldController and subscribe to the transaction and signature controller state changes.
|
|
74
|
+
*/
|
|
75
|
+
start() {
|
|
76
|
+
if (this.#started) {
|
|
77
|
+
return;
|
|
78
|
+
}
|
|
79
|
+
this.#started = true;
|
|
80
|
+
this.messenger.subscribe('TransactionController:stateChange', this.#transactionControllerStateChangeHandler, (state) => state.transactions);
|
|
81
|
+
this.messenger.subscribe('SignatureController:stateChange', this.#signatureControllerStateChangeHandler, (state) => state.signatureRequests);
|
|
82
|
+
}
|
|
83
|
+
/**
|
|
84
|
+
* Stop the ShieldController and unsubscribe from the transaction and signature controller state changes.
|
|
85
|
+
*/
|
|
86
|
+
stop() {
|
|
87
|
+
if (!this.#started) {
|
|
88
|
+
return;
|
|
89
|
+
}
|
|
90
|
+
this.#started = false;
|
|
91
|
+
this.messenger.unsubscribe('TransactionController:stateChange', this.#transactionControllerStateChangeHandler);
|
|
92
|
+
this.messenger.unsubscribe('SignatureController:stateChange', this.#signatureControllerStateChangeHandler);
|
|
93
|
+
}
|
|
94
|
+
/**
|
|
95
|
+
* Clears the shield state and resets to default values.
|
|
96
|
+
*/
|
|
97
|
+
clearState() {
|
|
98
|
+
this.update(() => {
|
|
99
|
+
return getDefaultShieldControllerState();
|
|
100
|
+
});
|
|
101
|
+
}
|
|
102
|
+
#handleSignatureControllerStateChange(signatureRequests, previousSignatureRequests) {
|
|
103
|
+
const signatureRequestsArray = Object.values(signatureRequests);
|
|
104
|
+
const previousSignatureRequestsArray = Object.values(previousSignatureRequests ?? {});
|
|
105
|
+
const previousSignatureRequestsById = new Map(previousSignatureRequestsArray.map((request) => [request.id, request]));
|
|
106
|
+
for (const signatureRequest of signatureRequestsArray) {
|
|
107
|
+
const previousSignatureRequest = previousSignatureRequestsById.get(signatureRequest.id);
|
|
108
|
+
// Check coverage if the signature request is new.
|
|
109
|
+
if (!previousSignatureRequest) {
|
|
110
|
+
this.checkSignatureCoverage(signatureRequest).catch(
|
|
111
|
+
// istanbul ignore next
|
|
112
|
+
(error) => log('Error checking coverage:', error));
|
|
113
|
+
}
|
|
114
|
+
// Log signature once the signature request has been fulfilled.
|
|
115
|
+
if (signatureRequest.status === SignatureRequestStatus.Signed &&
|
|
116
|
+
signatureRequest.status !== previousSignatureRequest?.status) {
|
|
117
|
+
this.#logSignature(signatureRequest).catch(
|
|
118
|
+
// istanbul ignore next
|
|
119
|
+
(error) => log('Error logging signature:', error));
|
|
120
|
+
}
|
|
121
|
+
}
|
|
122
|
+
}
|
|
123
|
+
#handleTransactionControllerStateChange(transactions, previousTransactions) {
|
|
124
|
+
const previousTransactionsById = new Map(previousTransactions?.map((tx) => [tx.id, tx]) ?? []);
|
|
125
|
+
for (const transaction of transactions) {
|
|
126
|
+
const previousTransaction = previousTransactionsById.get(transaction.id);
|
|
127
|
+
if (
|
|
128
|
+
// We don't need to check coverage for submitted or confirmed transactions.
|
|
129
|
+
transaction.status !== TransactionStatus.submitted &&
|
|
130
|
+
transaction.status !== TransactionStatus.confirmed) {
|
|
131
|
+
// Check if the simulation data has changed.
|
|
132
|
+
const simulationDataChanged =
|
|
133
|
+
// only check if the previous transaction has simulation data and if it has changed
|
|
134
|
+
// this is to avoid checking coverage for the `TWICE` (once when it's added to the state and once when it's simulated for the first time).
|
|
135
|
+
// we only need to update the coverage result when the simulation data has changed.
|
|
136
|
+
previousTransaction?.simulationData &&
|
|
137
|
+
!isEqual(transaction.simulationData, previousTransaction.simulationData);
|
|
138
|
+
// Check coverage if the transaction is new or if the simulation data has
|
|
139
|
+
// changed.
|
|
140
|
+
if (!previousTransaction || simulationDataChanged) {
|
|
141
|
+
this.checkCoverage(transaction).catch(
|
|
142
|
+
// istanbul ignore next
|
|
143
|
+
(error) => log('Error checking coverage:', error));
|
|
144
|
+
}
|
|
145
|
+
}
|
|
146
|
+
// Log transaction once it has been submitted.
|
|
147
|
+
if (transaction.status === TransactionStatus.submitted &&
|
|
148
|
+
transaction.status !== previousTransaction?.status) {
|
|
149
|
+
this.#logTransaction(transaction).catch(
|
|
150
|
+
// istanbul ignore next
|
|
151
|
+
(error) => log('Error logging transaction:', error));
|
|
152
|
+
}
|
|
153
|
+
}
|
|
154
|
+
}
|
|
155
|
+
/**
|
|
156
|
+
* Checks the coverage of a transaction.
|
|
157
|
+
*
|
|
158
|
+
* @param txMeta - The transaction to check coverage for.
|
|
159
|
+
* @returns The coverage result.
|
|
160
|
+
*/
|
|
161
|
+
async checkCoverage(txMeta) {
|
|
162
|
+
// Check coverage
|
|
163
|
+
const coverageId = this.#getLatestCoverageId(txMeta.id);
|
|
164
|
+
const coverageResult = await this.messenger.call('ShieldApiService:checkCoverage', {
|
|
165
|
+
txMeta,
|
|
166
|
+
coverageId,
|
|
167
|
+
});
|
|
168
|
+
// Publish coverage result
|
|
169
|
+
this.messenger.publish(`${controllerName}:coverageResultReceived`, coverageResult);
|
|
170
|
+
// Update state
|
|
171
|
+
this.#addCoverageResult(txMeta.id, coverageResult);
|
|
172
|
+
return coverageResult;
|
|
173
|
+
}
|
|
174
|
+
/**
|
|
175
|
+
* Checks the coverage of a signature request.
|
|
176
|
+
*
|
|
177
|
+
* @param signatureRequest - The signature request to check coverage for.
|
|
178
|
+
* @returns The coverage result.
|
|
179
|
+
*/
|
|
180
|
+
async checkSignatureCoverage(signatureRequest) {
|
|
181
|
+
// Check coverage
|
|
182
|
+
const coverageId = this.#getLatestCoverageId(signatureRequest.id);
|
|
183
|
+
// Normalize the signature request before sending it to the backend.
|
|
184
|
+
// This is to ensure that the signature data is normalized and consistent as the security alerts api calls.
|
|
185
|
+
const clonedSignatureRequest = cloneDeep(signatureRequest);
|
|
186
|
+
const normalizedSignatureRequest = this.#normalizeSignatureRequest?.(clonedSignatureRequest) ??
|
|
187
|
+
clonedSignatureRequest;
|
|
188
|
+
const coverageResult = await this.messenger.call('ShieldApiService:checkSignatureCoverage', {
|
|
189
|
+
signatureRequest: normalizedSignatureRequest,
|
|
190
|
+
coverageId,
|
|
191
|
+
});
|
|
192
|
+
// Publish coverage result
|
|
193
|
+
this.messenger.publish(`${controllerName}:coverageResultReceived`, coverageResult);
|
|
194
|
+
// Update state
|
|
195
|
+
this.#addCoverageResult(signatureRequest.id, coverageResult);
|
|
196
|
+
return coverageResult;
|
|
197
|
+
}
|
|
198
|
+
#addCoverageResult(txId, coverageResult) {
|
|
199
|
+
// Assert the coverageId hasn't changed.
|
|
200
|
+
const latestCoverageId = this.#getLatestCoverageId(txId);
|
|
201
|
+
if (latestCoverageId && coverageResult.coverageId !== latestCoverageId) {
|
|
202
|
+
throw new Error('Coverage ID has changed');
|
|
203
|
+
}
|
|
204
|
+
this.update((draft) => {
|
|
205
|
+
// Fetch coverage result entry.
|
|
206
|
+
let newEntry = false;
|
|
207
|
+
let coverageResultEntry = draft.coverageResults[txId];
|
|
208
|
+
// Create new entry if necessary.
|
|
209
|
+
if (!coverageResultEntry) {
|
|
210
|
+
newEntry = true;
|
|
211
|
+
coverageResultEntry = {
|
|
212
|
+
results: [],
|
|
213
|
+
};
|
|
214
|
+
draft.coverageResults[txId] = coverageResultEntry;
|
|
215
|
+
}
|
|
216
|
+
// Trim coverage history if necessary.
|
|
217
|
+
if (coverageResultEntry.results.length >= this.#coverageHistoryLimit) {
|
|
218
|
+
coverageResultEntry.results.pop();
|
|
219
|
+
}
|
|
220
|
+
// Add new result.
|
|
221
|
+
coverageResultEntry.results.unshift(coverageResult);
|
|
222
|
+
// Add to history if new entry.
|
|
223
|
+
const { orderedTransactionHistory } = draft;
|
|
224
|
+
let removedTxId;
|
|
225
|
+
if (newEntry) {
|
|
226
|
+
// Trim transaction history if necessary.
|
|
227
|
+
if (orderedTransactionHistory.length >= this.#transactionHistoryLimit) {
|
|
228
|
+
removedTxId = orderedTransactionHistory.pop();
|
|
229
|
+
// Delete corresponding coverage result entry.
|
|
230
|
+
if (removedTxId) {
|
|
231
|
+
delete draft.coverageResults[removedTxId];
|
|
232
|
+
}
|
|
233
|
+
}
|
|
234
|
+
// Add to history.
|
|
235
|
+
orderedTransactionHistory.unshift(txId);
|
|
236
|
+
}
|
|
237
|
+
});
|
|
238
|
+
}
|
|
239
|
+
async #logSignature(signatureRequest) {
|
|
240
|
+
const signature = signatureRequest.rawSig;
|
|
241
|
+
if (!signature) {
|
|
242
|
+
throw new Error('Signature not found');
|
|
243
|
+
}
|
|
244
|
+
const { status } = this.#getCoverageShownStatus(signatureRequest.id);
|
|
245
|
+
await this.messenger.call('ShieldApiService:logSignature', {
|
|
246
|
+
signatureRequest,
|
|
247
|
+
signature,
|
|
248
|
+
status,
|
|
249
|
+
});
|
|
250
|
+
}
|
|
251
|
+
async #logTransaction(txMeta) {
|
|
252
|
+
const transactionHash = txMeta.hash;
|
|
253
|
+
if (!transactionHash) {
|
|
254
|
+
throw new Error('Transaction hash not found');
|
|
255
|
+
}
|
|
256
|
+
const rawTransactionHex = txMeta.rawTx;
|
|
257
|
+
if (!rawTransactionHex) {
|
|
258
|
+
throw new Error('Raw transaction hex not found');
|
|
259
|
+
}
|
|
260
|
+
const { status } = this.#getCoverageShownStatus(txMeta.id);
|
|
261
|
+
await this.messenger.call('ShieldApiService:logTransaction', {
|
|
262
|
+
txMeta,
|
|
263
|
+
transactionHash,
|
|
264
|
+
rawTransactionHex,
|
|
265
|
+
status,
|
|
266
|
+
});
|
|
267
|
+
}
|
|
268
|
+
/**
|
|
269
|
+
* Get the coverage shown status for a given item ID.
|
|
270
|
+
*
|
|
271
|
+
* @param itemId - The item ID to get the coverage status for.
|
|
272
|
+
* @returns The coverage status.
|
|
273
|
+
*/
|
|
274
|
+
#getCoverageShownStatus(itemId) {
|
|
275
|
+
// The status is assigned as follows:
|
|
276
|
+
// - 'shown' if we have a result
|
|
277
|
+
// - 'not_shown' if we don't have a result
|
|
278
|
+
const coverageId = this.#getLatestCoverageId(itemId);
|
|
279
|
+
let status = 'shown';
|
|
280
|
+
if (!coverageId) {
|
|
281
|
+
log('Coverage ID not found for', itemId);
|
|
282
|
+
status = 'not_shown';
|
|
283
|
+
}
|
|
284
|
+
return { status };
|
|
285
|
+
}
|
|
286
|
+
#getLatestCoverageId(itemId) {
|
|
287
|
+
return this.state.coverageResults[itemId]?.results[0]?.coverageId;
|
|
288
|
+
}
|
|
289
|
+
}
|
|
290
|
+
//# sourceMappingURL=ShieldController.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ShieldController.js","sourceRoot":"","sources":["../src/ShieldController.ts"],"names":[],"mappings":"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","sourcesContent":["import { BaseController } from '@metamask/base-controller';\nimport type {\n ControllerGetStateAction,\n ControllerStateChangeEvent,\n} from '@metamask/base-controller';\nimport type { Messenger } from '@metamask/messenger';\nimport { SignatureRequestStatus } from '@metamask/signature-controller';\nimport type {\n SignatureRequest,\n SignatureStateChange,\n} from '@metamask/signature-controller';\nimport { TransactionStatus } from '@metamask/transaction-controller';\nimport type {\n TransactionControllerStateChangeEvent,\n TransactionMeta,\n} from '@metamask/transaction-controller';\nimport { cloneDeep, isEqual } from 'lodash-es';\n\nimport { controllerName } from './constants.js';\nimport { projectLogger, createModuleLogger } from './logger.js';\nimport type { ShieldApiServiceMethodActions } from './shield-api-service-method-action-types.js';\nimport type { ShieldControllerMethodActions } from './ShieldController-method-action-types.js';\nimport type { CoverageResult, NormalizeSignatureRequestFn } from './types.js';\n\nconst log = createModuleLogger(projectLogger, 'ShieldController');\n\nconst MESSENGER_EXPOSED_METHODS = [\n 'start',\n 'stop',\n 'clearState',\n 'checkCoverage',\n 'checkSignatureCoverage',\n] as const;\n\nexport type CoverageResultRecordEntry = {\n /**\n * History of coverage results, latest first.\n */\n results: CoverageResult[];\n};\n\nexport type ShieldControllerState = {\n /**\n * Coverage results by transaction ID.\n */\n coverageResults: Record<\n string, // txId\n CoverageResultRecordEntry\n >;\n /**\n * List of txIds ordered by time, latest first.\n */\n orderedTransactionHistory: string[];\n};\n\n/**\n * Get the default state for the ShieldController.\n *\n * @returns The default state for the ShieldController.\n */\nexport function getDefaultShieldControllerState(): ShieldControllerState {\n return {\n coverageResults: {},\n orderedTransactionHistory: [],\n };\n}\n\nexport type ShieldControllerGetStateAction = ControllerGetStateAction<\n typeof controllerName,\n ShieldControllerState\n>;\n\n/**\n * The internal actions available to the ShieldController.\n */\nexport type ShieldControllerActions =\n | ShieldControllerGetStateAction\n | ShieldControllerMethodActions;\n\nexport type ShieldControllerCoverageResultReceivedEvent = {\n type: `${typeof controllerName}:coverageResultReceived`;\n payload: [coverageResult: CoverageResult];\n};\n\nexport type ShieldControllerStateChangeEvent = ControllerStateChangeEvent<\n typeof controllerName,\n ShieldControllerState\n>;\n\n/**\n * The internal events available to the ShieldController.\n */\nexport type ShieldControllerEvents =\n | ShieldControllerCoverageResultReceivedEvent\n | ShieldControllerStateChangeEvent;\n\n/**\n * The external actions available to the ShieldController.\n */\ntype AllowedActions = ShieldApiServiceMethodActions;\n\n/**\n * The external events available to the ShieldController.\n */\ntype AllowedEvents =\n | SignatureStateChange\n | TransactionControllerStateChangeEvent;\n\n/**\n * The messenger of the {@link ShieldController}.\n */\nexport type ShieldControllerMessenger = Messenger<\n typeof controllerName,\n ShieldControllerActions | AllowedActions,\n ShieldControllerEvents | AllowedEvents\n>;\n\n/**\n * Metadata for the ShieldController state, describing how to \"anonymize\"\n * the state and which parts should be persisted.\n */\nconst metadata = {\n coverageResults: {\n includeInStateLogs: true,\n persist: true,\n includeInDebugSnapshot: false,\n usedInUi: true,\n },\n orderedTransactionHistory: {\n includeInStateLogs: true,\n persist: true,\n includeInDebugSnapshot: false,\n usedInUi: false,\n },\n};\n\nexport type ShieldControllerOptions = {\n messenger: ShieldControllerMessenger;\n state?: Partial<ShieldControllerState>;\n transactionHistoryLimit?: number;\n coverageHistoryLimit?: number;\n /**\n * Normalize the signature request before sending it to the backend.\n * Please note that the reason this is not being done internally is to\n * align the request body (data & params) with the security-alerts API.\n * The same normalization function which is used to normalize security-alerts request should be used here.\n *\n * @param signatureRequest - The signature request to normalize.\n * @returns The normalized signature request.\n */\n normalizeSignatureRequest?: NormalizeSignatureRequestFn;\n};\n\nexport class ShieldController extends BaseController<\n typeof controllerName,\n ShieldControllerState,\n ShieldControllerMessenger\n> {\n readonly #coverageHistoryLimit: number;\n\n readonly #transactionHistoryLimit: number;\n\n readonly #normalizeSignatureRequest?: NormalizeSignatureRequestFn;\n\n readonly #transactionControllerStateChangeHandler: (\n transactions: TransactionMeta[],\n previousTransactions: TransactionMeta[] | undefined,\n ) => void;\n\n readonly #signatureControllerStateChangeHandler: (\n signatureRequests: Record<string, SignatureRequest>,\n previousSignatureRequests: Record<string, SignatureRequest> | undefined,\n ) => void;\n\n #started: boolean;\n\n constructor(options: ShieldControllerOptions) {\n const {\n messenger,\n state,\n transactionHistoryLimit = 100,\n coverageHistoryLimit = 10,\n normalizeSignatureRequest,\n } = options;\n super({\n name: controllerName,\n metadata,\n messenger,\n state: {\n ...getDefaultShieldControllerState(),\n ...state,\n },\n });\n\n this.#coverageHistoryLimit = coverageHistoryLimit;\n this.#transactionHistoryLimit = transactionHistoryLimit;\n this.#transactionControllerStateChangeHandler =\n this.#handleTransactionControllerStateChange.bind(this);\n this.#signatureControllerStateChangeHandler =\n this.#handleSignatureControllerStateChange.bind(this);\n this.#started = false;\n this.#normalizeSignatureRequest = normalizeSignatureRequest;\n\n this.messenger.registerMethodActionHandlers(\n this,\n MESSENGER_EXPOSED_METHODS,\n );\n }\n\n /**\n * Start the ShieldController and subscribe to the transaction and signature controller state changes.\n */\n start(): void {\n if (this.#started) {\n return;\n }\n this.#started = true;\n\n this.messenger.subscribe(\n 'TransactionController:stateChange',\n this.#transactionControllerStateChangeHandler,\n (state) => state.transactions,\n );\n\n this.messenger.subscribe(\n 'SignatureController:stateChange',\n this.#signatureControllerStateChangeHandler,\n (state) => state.signatureRequests,\n );\n }\n\n /**\n * Stop the ShieldController and unsubscribe from the transaction and signature controller state changes.\n */\n stop(): void {\n if (!this.#started) {\n return;\n }\n this.#started = false;\n\n this.messenger.unsubscribe(\n 'TransactionController:stateChange',\n this.#transactionControllerStateChangeHandler,\n );\n\n this.messenger.unsubscribe(\n 'SignatureController:stateChange',\n this.#signatureControllerStateChangeHandler,\n );\n }\n\n /**\n * Clears the shield state and resets to default values.\n */\n clearState(): void {\n this.update(() => {\n return getDefaultShieldControllerState();\n });\n }\n\n #handleSignatureControllerStateChange(\n signatureRequests: Record<string, SignatureRequest>,\n previousSignatureRequests: Record<string, SignatureRequest> | undefined,\n ): void {\n const signatureRequestsArray = Object.values(signatureRequests);\n const previousSignatureRequestsArray = Object.values(\n previousSignatureRequests ?? {},\n );\n const previousSignatureRequestsById = new Map<string, SignatureRequest>(\n previousSignatureRequestsArray.map((request) => [request.id, request]),\n );\n for (const signatureRequest of signatureRequestsArray) {\n const previousSignatureRequest = previousSignatureRequestsById.get(\n signatureRequest.id,\n );\n\n // Check coverage if the signature request is new.\n if (!previousSignatureRequest) {\n this.checkSignatureCoverage(signatureRequest).catch(\n // istanbul ignore next\n (error) => log('Error checking coverage:', error),\n );\n }\n\n // Log signature once the signature request has been fulfilled.\n if (\n signatureRequest.status === SignatureRequestStatus.Signed &&\n signatureRequest.status !== previousSignatureRequest?.status\n ) {\n this.#logSignature(signatureRequest).catch(\n // istanbul ignore next\n (error) => log('Error logging signature:', error),\n );\n }\n }\n }\n\n #handleTransactionControllerStateChange(\n transactions: TransactionMeta[],\n previousTransactions: TransactionMeta[] | undefined,\n ): void {\n const previousTransactionsById = new Map<string, TransactionMeta>(\n previousTransactions?.map((tx) => [tx.id, tx]) ?? [],\n );\n for (const transaction of transactions) {\n const previousTransaction = previousTransactionsById.get(transaction.id);\n\n if (\n // We don't need to check coverage for submitted or confirmed transactions.\n transaction.status !== TransactionStatus.submitted &&\n transaction.status !== TransactionStatus.confirmed\n ) {\n // Check if the simulation data has changed.\n const simulationDataChanged =\n // only check if the previous transaction has simulation data and if it has changed\n // this is to avoid checking coverage for the `TWICE` (once when it's added to the state and once when it's simulated for the first time).\n // we only need to update the coverage result when the simulation data has changed.\n previousTransaction?.simulationData &&\n !isEqual(\n transaction.simulationData,\n previousTransaction.simulationData,\n );\n\n // Check coverage if the transaction is new or if the simulation data has\n // changed.\n if (!previousTransaction || simulationDataChanged) {\n this.checkCoverage(transaction).catch(\n // istanbul ignore next\n (error) => log('Error checking coverage:', error),\n );\n }\n }\n\n // Log transaction once it has been submitted.\n if (\n transaction.status === TransactionStatus.submitted &&\n transaction.status !== previousTransaction?.status\n ) {\n this.#logTransaction(transaction).catch(\n // istanbul ignore next\n (error) => log('Error logging transaction:', error),\n );\n }\n }\n }\n\n /**\n * Checks the coverage of a transaction.\n *\n * @param txMeta - The transaction to check coverage for.\n * @returns The coverage result.\n */\n async checkCoverage(txMeta: TransactionMeta): Promise<CoverageResult> {\n // Check coverage\n const coverageId = this.#getLatestCoverageId(txMeta.id);\n const coverageResult = await this.messenger.call(\n 'ShieldApiService:checkCoverage',\n {\n txMeta,\n coverageId,\n },\n );\n\n // Publish coverage result\n this.messenger.publish(\n `${controllerName}:coverageResultReceived`,\n coverageResult,\n );\n\n // Update state\n this.#addCoverageResult(txMeta.id, coverageResult);\n\n return coverageResult;\n }\n\n /**\n * Checks the coverage of a signature request.\n *\n * @param signatureRequest - The signature request to check coverage for.\n * @returns The coverage result.\n */\n async checkSignatureCoverage(\n signatureRequest: SignatureRequest,\n ): Promise<CoverageResult> {\n // Check coverage\n const coverageId = this.#getLatestCoverageId(signatureRequest.id);\n\n // Normalize the signature request before sending it to the backend.\n // This is to ensure that the signature data is normalized and consistent as the security alerts api calls.\n const clonedSignatureRequest = cloneDeep(signatureRequest);\n const normalizedSignatureRequest =\n this.#normalizeSignatureRequest?.(clonedSignatureRequest) ??\n clonedSignatureRequest;\n const coverageResult = await this.messenger.call(\n 'ShieldApiService:checkSignatureCoverage',\n {\n signatureRequest: normalizedSignatureRequest,\n coverageId,\n },\n );\n\n // Publish coverage result\n this.messenger.publish(\n `${controllerName}:coverageResultReceived`,\n coverageResult,\n );\n\n // Update state\n this.#addCoverageResult(signatureRequest.id, coverageResult);\n\n return coverageResult;\n }\n\n #addCoverageResult(txId: string, coverageResult: CoverageResult): void {\n // Assert the coverageId hasn't changed.\n const latestCoverageId = this.#getLatestCoverageId(txId);\n if (latestCoverageId && coverageResult.coverageId !== latestCoverageId) {\n throw new Error('Coverage ID has changed');\n }\n\n this.update((draft) => {\n // Fetch coverage result entry.\n let newEntry = false;\n let coverageResultEntry = draft.coverageResults[txId];\n\n // Create new entry if necessary.\n if (!coverageResultEntry) {\n newEntry = true;\n coverageResultEntry = {\n results: [],\n };\n draft.coverageResults[txId] = coverageResultEntry;\n }\n\n // Trim coverage history if necessary.\n if (coverageResultEntry.results.length >= this.#coverageHistoryLimit) {\n coverageResultEntry.results.pop();\n }\n\n // Add new result.\n coverageResultEntry.results.unshift(coverageResult);\n\n // Add to history if new entry.\n const { orderedTransactionHistory } = draft;\n let removedTxId: string | undefined;\n if (newEntry) {\n // Trim transaction history if necessary.\n if (orderedTransactionHistory.length >= this.#transactionHistoryLimit) {\n removedTxId = orderedTransactionHistory.pop();\n // Delete corresponding coverage result entry.\n if (removedTxId) {\n delete draft.coverageResults[removedTxId];\n }\n }\n // Add to history.\n orderedTransactionHistory.unshift(txId);\n }\n });\n }\n\n async #logSignature(signatureRequest: SignatureRequest): Promise<void> {\n const signature = signatureRequest.rawSig;\n if (!signature) {\n throw new Error('Signature not found');\n }\n\n const { status } = this.#getCoverageShownStatus(signatureRequest.id);\n\n await this.messenger.call('ShieldApiService:logSignature', {\n signatureRequest,\n signature,\n status,\n });\n }\n\n async #logTransaction(txMeta: TransactionMeta): Promise<void> {\n const transactionHash = txMeta.hash;\n if (!transactionHash) {\n throw new Error('Transaction hash not found');\n }\n\n const rawTransactionHex = txMeta.rawTx;\n if (!rawTransactionHex) {\n throw new Error('Raw transaction hex not found');\n }\n\n const { status } = this.#getCoverageShownStatus(txMeta.id);\n\n await this.messenger.call('ShieldApiService:logTransaction', {\n txMeta,\n transactionHash,\n rawTransactionHex,\n status,\n });\n }\n\n /**\n * Get the coverage shown status for a given item ID.\n *\n * @param itemId - The item ID to get the coverage status for.\n * @returns The coverage status.\n */\n #getCoverageShownStatus(itemId: string): { status: string } {\n // The status is assigned as follows:\n // - 'shown' if we have a result\n // - 'not_shown' if we don't have a result\n const coverageId = this.#getLatestCoverageId(itemId);\n let status = 'shown';\n if (!coverageId) {\n log('Coverage ID not found for', itemId);\n status = 'not_shown';\n }\n return { status };\n }\n\n #getLatestCoverageId(itemId: string): string | undefined {\n return this.state.coverageResults[itemId]?.results[0]?.coverageId;\n }\n}\n"]}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,cAAc,qBAAqB,CAAC;AAEjD;;GAEG;AACH,oBAAY,GAAG;IACb,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;CACZ;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,GAAG,EAAE,MAAM,CAIlD,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAMpD;AAED;;;;GAIG;AACH,oBAAY,oBAAoB;IAC9B,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;CACV"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,kBAAkB,CAAC;AAEjD;;GAEG;AACH,MAAM,CAAN,IAAY,GAIX;AAJD,WAAY,GAAG;IACb,kBAAW,CAAA;IACX,kBAAW,CAAA;IACX,kBAAW,CAAA;AACb,CAAC,EAJW,GAAG,KAAH,GAAG,QAId;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAwB;IACrD,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,+CAA+C;IAC1D,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,+CAA+C;IAC1D,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,2CAA2C;CACvD,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAQ;IAC1C,MAAM,OAAO,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACxC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAN,IAAY,oBAIX;AAJD,WAAY,oBAAoB;IAC9B,iCAAS,CAAA;IACT,iCAAS,CAAA;IACT,iCAAS,CAAA;AACX,CAAC,EAJW,oBAAoB,KAApB,oBAAoB,QAI/B","sourcesContent":["/**\n * The name of the {@link ShieldController}.\n */\nexport const controllerName = 'ShieldController';\n\n/**\n * The environment for the shield backend API.\n */\nexport enum Env {\n DEV = 'dev',\n UAT = 'uat',\n PRD = 'prd',\n}\n\n/**\n * The shield backend API URL for each environment.\n */\nexport const SHIELD_API_URL_MAP: Record<Env, string> = {\n [Env.DEV]: 'https://ruleset-engine.dev-api.cx.metamask.io',\n [Env.UAT]: 'https://ruleset-engine.uat-api.cx.metamask.io',\n [Env.PRD]: 'https://ruleset-engine.api.cx.metamask.io',\n};\n\n/**\n * Get the shield backend API URL for the given environment.\n *\n * @param env - The environment.\n * @returns The base URL for the given environment.\n * @throws If the environment is invalid.\n */\nexport function getShieldApiBaseUrl(env: Env): string {\n const baseUrl = SHIELD_API_URL_MAP[env];\n if (!baseUrl) {\n throw new Error('invalid environment configuration');\n }\n return baseUrl;\n}\n\n/**\n * The `signTypedMessage` version\n *\n * @see https://docs.metamask.io/guide/signing-data.html\n */\nexport enum SignTypedDataVersion {\n V1 = 'V1',\n V3 = 'V3',\n V4 = 'V4',\n}\n"]}
|
|
@@ -1,9 +1,9 @@
|
|
|
1
|
-
export type { CoverageStatus, LogSignatureRequest, LogTransactionRequest, NormalizeSignatureRequestFn, CheckCoverageRequest, CheckSignatureCoverageRequest, CoverageResult, } from
|
|
2
|
-
export type { ShieldControllerActions, ShieldControllerEvents, ShieldControllerMessenger, ShieldControllerState, ShieldControllerGetStateAction, ShieldControllerCoverageResultReceivedEvent, ShieldControllerStateChangeEvent, } from
|
|
3
|
-
export type { ShieldControllerStartAction, ShieldControllerStopAction, ShieldControllerClearStateAction, ShieldControllerCheckCoverageAction, ShieldControllerCheckSignatureCoverageAction, } from
|
|
4
|
-
export { ShieldController, getDefaultShieldControllerState, } from
|
|
5
|
-
export { ShieldApiService, serviceName, makeInitCoverageCheckBody, parseSignatureRequestMethod, } from
|
|
6
|
-
export type { ShieldApiServiceMessenger, ShieldApiServiceActions, ShieldApiServiceEvents, ShieldApiServiceInvalidateQueriesAction, ShieldApiServiceCacheUpdatedEvent, ShieldApiServiceGranularCacheUpdatedEvent, } from
|
|
7
|
-
export type { ShieldApiServiceCheckCoverageAction, ShieldApiServiceCheckSignatureCoverageAction, ShieldApiServiceLogSignatureAction, ShieldApiServiceLogTransactionAction, } from
|
|
8
|
-
export { Env, SHIELD_API_URL_MAP, getShieldApiBaseUrl } from
|
|
9
|
-
//# sourceMappingURL=index.d.
|
|
1
|
+
export type { CoverageStatus, LogSignatureRequest, LogTransactionRequest, NormalizeSignatureRequestFn, CheckCoverageRequest, CheckSignatureCoverageRequest, CoverageResult, } from './types.js';
|
|
2
|
+
export type { ShieldControllerActions, ShieldControllerEvents, ShieldControllerMessenger, ShieldControllerState, ShieldControllerGetStateAction, ShieldControllerCoverageResultReceivedEvent, ShieldControllerStateChangeEvent, } from './ShieldController.js';
|
|
3
|
+
export type { ShieldControllerStartAction, ShieldControllerStopAction, ShieldControllerClearStateAction, ShieldControllerCheckCoverageAction, ShieldControllerCheckSignatureCoverageAction, } from './ShieldController-method-action-types.js';
|
|
4
|
+
export { ShieldController, getDefaultShieldControllerState, } from './ShieldController.js';
|
|
5
|
+
export { ShieldApiService, serviceName, makeInitCoverageCheckBody, parseSignatureRequestMethod, } from './shield-api-service.js';
|
|
6
|
+
export type { ShieldApiServiceMessenger, ShieldApiServiceActions, ShieldApiServiceEvents, ShieldApiServiceInvalidateQueriesAction, ShieldApiServiceCacheUpdatedEvent, ShieldApiServiceGranularCacheUpdatedEvent, } from './shield-api-service.js';
|
|
7
|
+
export type { ShieldApiServiceCheckCoverageAction, ShieldApiServiceCheckSignatureCoverageAction, ShieldApiServiceLogSignatureAction, ShieldApiServiceLogTransactionAction, } from './shield-api-service-method-action-types.js';
|
|
8
|
+
export { Env, SHIELD_API_URL_MAP, getShieldApiBaseUrl } from './constants.js';
|
|
9
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EACrB,2BAA2B,EAC3B,oBAAoB,EACpB,6BAA6B,EAC7B,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,uBAAuB,EACvB,sBAAsB,EACtB,yBAAyB,EACzB,qBAAqB,EACrB,8BAA8B,EAC9B,2CAA2C,EAC3C,gCAAgC,GACjC,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,2BAA2B,EAC3B,0BAA0B,EAC1B,gCAAgC,EAChC,mCAAmC,EACnC,4CAA4C,GAC7C,MAAM,2CAA2C,CAAC;AACnD,OAAO,EACL,gBAAgB,EAChB,+BAA+B,GAChC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,yBAAyB,EACzB,uBAAuB,EACvB,sBAAsB,EACtB,uCAAuC,EACvC,iCAAiC,EACjC,yCAAyC,GAC1C,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,mCAAmC,EACnC,4CAA4C,EAC5C,kCAAkC,EAClC,oCAAoC,GACrC,MAAM,6CAA6C,CAAC;AACrD,OAAO,EAAE,GAAG,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC"}
|
package/dist/index.js
ADDED
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
export { ShieldController, getDefaultShieldControllerState, } from './ShieldController.js';
|
|
2
|
+
export { ShieldApiService, serviceName, makeInitCoverageCheckBody, parseSignatureRequestMethod, } from './shield-api-service.js';
|
|
3
|
+
export { Env, SHIELD_API_URL_MAP, getShieldApiBaseUrl } from './constants.js';
|
|
4
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAyBA,OAAO,EACL,gBAAgB,EAChB,+BAA+B,GAChC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,yBAAyB,CAAC;AAejC,OAAO,EAAE,GAAG,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC","sourcesContent":["export type {\n CoverageStatus,\n LogSignatureRequest,\n LogTransactionRequest,\n NormalizeSignatureRequestFn,\n CheckCoverageRequest,\n CheckSignatureCoverageRequest,\n CoverageResult,\n} from './types.js';\nexport type {\n ShieldControllerActions,\n ShieldControllerEvents,\n ShieldControllerMessenger,\n ShieldControllerState,\n ShieldControllerGetStateAction,\n ShieldControllerCoverageResultReceivedEvent,\n ShieldControllerStateChangeEvent,\n} from './ShieldController.js';\nexport type {\n ShieldControllerStartAction,\n ShieldControllerStopAction,\n ShieldControllerClearStateAction,\n ShieldControllerCheckCoverageAction,\n ShieldControllerCheckSignatureCoverageAction,\n} from './ShieldController-method-action-types.js';\nexport {\n ShieldController,\n getDefaultShieldControllerState,\n} from './ShieldController.js';\nexport {\n ShieldApiService,\n serviceName,\n makeInitCoverageCheckBody,\n parseSignatureRequestMethod,\n} from './shield-api-service.js';\nexport type {\n ShieldApiServiceMessenger,\n ShieldApiServiceActions,\n ShieldApiServiceEvents,\n ShieldApiServiceInvalidateQueriesAction,\n ShieldApiServiceCacheUpdatedEvent,\n ShieldApiServiceGranularCacheUpdatedEvent,\n} from './shield-api-service.js';\nexport type {\n ShieldApiServiceCheckCoverageAction,\n ShieldApiServiceCheckSignatureCoverageAction,\n ShieldApiServiceLogSignatureAction,\n ShieldApiServiceLogTransactionAction,\n} from './shield-api-service-method-action-types.js';\nexport { Env, SHIELD_API_URL_MAP, getShieldApiBaseUrl } from './constants.js';\n"]}
|
package/dist/logger.d.ts
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAI1E,eAAO,MAAM,aAAa,0BAAsC,CAAC;AAEjE,OAAO,EAAE,kBAAkB,EAAE,CAAC"}
|
package/dist/logger.js
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1E,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,CAAC,MAAM,aAAa,GAAG,mBAAmB,CAAC,cAAc,CAAC,CAAC;AAEjE,OAAO,EAAE,kBAAkB,EAAE,CAAC","sourcesContent":["import { createProjectLogger, createModuleLogger } from '@metamask/utils';\n\nimport { controllerName } from './constants.js';\n\nexport const projectLogger = createProjectLogger(controllerName);\n\nexport { createModuleLogger };\n"]}
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import type { CreateServicePolicyOptions } from
|
|
1
|
+
import type { CreateServicePolicyOptions } from '@metamask/controller-utils';
|
|
2
2
|
export type RequestFn<ReturnType> = (signal: AbortSignal) => Promise<ReturnType>;
|
|
3
3
|
export declare class PollingWithCockatielPolicy {
|
|
4
4
|
#private;
|
|
@@ -6,4 +6,4 @@ export declare class PollingWithCockatielPolicy {
|
|
|
6
6
|
start<ReturnType>(requestId: string, requestFn: RequestFn<ReturnType>): Promise<ReturnType>;
|
|
7
7
|
abortPendingRequest(requestId: string): void;
|
|
8
8
|
}
|
|
9
|
-
//# sourceMappingURL=polling-with-policy.d.
|
|
9
|
+
//# sourceMappingURL=polling-with-policy.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"polling-with-policy.d.ts","sourceRoot":"","sources":["../src/polling-with-policy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,0BAA0B,EAE3B,MAAM,4BAA4B,CAAC;AAGpC,MAAM,MAAM,SAAS,CAAC,UAAU,IAAI,CAClC,MAAM,EAAE,WAAW,KAChB,OAAO,CAAC,UAAU,CAAC,CAAC;AAEzB,qBAAa,0BAA0B;;IAKrC,YAAY,aAAa,GAAE,0BAA+B,EAOzD;IAEK,KAAK,CAAC,UAAU,EACpB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,SAAS,CAAC,UAAU,CAAC,GAC/B,OAAO,CAAC,UAAU,CAAC,CAqBrB;IAED,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAI3C;CAwBF"}
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
import { createServicePolicy, HttpError } from '@metamask/controller-utils';
|
|
2
|
+
import { handleWhen } from 'cockatiel';
|
|
3
|
+
export class PollingWithCockatielPolicy {
|
|
4
|
+
#policy;
|
|
5
|
+
#requestEntry = new Map();
|
|
6
|
+
constructor(policyOptions = {}) {
|
|
7
|
+
const shouldRetryFunc = this.#shouldRetry.bind(this);
|
|
8
|
+
const retryFilterPolicy = handleWhen(shouldRetryFunc);
|
|
9
|
+
this.#policy = createServicePolicy({
|
|
10
|
+
...policyOptions,
|
|
11
|
+
retryFilterPolicy,
|
|
12
|
+
});
|
|
13
|
+
}
|
|
14
|
+
async start(requestId, requestFn) {
|
|
15
|
+
const abortController = this.#addNewRequestEntry(requestId);
|
|
16
|
+
try {
|
|
17
|
+
const result = await this.#policy.execute(async ({ signal }) => {
|
|
18
|
+
return requestFn(signal);
|
|
19
|
+
}, abortController.signal);
|
|
20
|
+
return result;
|
|
21
|
+
}
|
|
22
|
+
catch (error) {
|
|
23
|
+
if (abortController.signal.aborted) {
|
|
24
|
+
throw new Error('Request cancelled');
|
|
25
|
+
}
|
|
26
|
+
throw error;
|
|
27
|
+
}
|
|
28
|
+
finally {
|
|
29
|
+
// Only cleanup if this abort controller is still active. If a new request with the same
|
|
30
|
+
// requestId started while this one was running, it would have replaced with a new abort controller.
|
|
31
|
+
// We must not delete the new request's controller when this older request finishes.
|
|
32
|
+
if (abortController === this.#requestEntry.get(requestId)) {
|
|
33
|
+
this.#cleanup(requestId);
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
abortPendingRequest(requestId) {
|
|
38
|
+
const abortController = this.#requestEntry.get(requestId);
|
|
39
|
+
abortController?.abort();
|
|
40
|
+
this.#cleanup(requestId);
|
|
41
|
+
}
|
|
42
|
+
#addNewRequestEntry(requestId) {
|
|
43
|
+
// abort the previous request if it exists
|
|
44
|
+
this.abortPendingRequest(requestId);
|
|
45
|
+
// create a new abort controller for the new request
|
|
46
|
+
const abortController = new AbortController();
|
|
47
|
+
this.#requestEntry.set(requestId, abortController);
|
|
48
|
+
return abortController;
|
|
49
|
+
}
|
|
50
|
+
#cleanup(requestId) {
|
|
51
|
+
this.#requestEntry.delete(requestId);
|
|
52
|
+
}
|
|
53
|
+
#shouldRetry(error) {
|
|
54
|
+
if (error instanceof HttpError) {
|
|
55
|
+
// Note: we don't retry on 5xx errors, only on 4xx errors.
|
|
56
|
+
// but we won't retry on 400 coz it means that the request body is invalid.
|
|
57
|
+
return error.httpStatus > 400 && error.httpStatus < 500;
|
|
58
|
+
}
|
|
59
|
+
return false;
|
|
60
|
+
}
|
|
61
|
+
}
|
|
62
|
+
//# sourceMappingURL=polling-with-policy.js.map
|