@metamask/snaps-execution-environments 0.34.1-flask.1 → 0.35.1-flask.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/CHANGELOG.md +17 -1
- package/dist/cjs/common/BaseSnapExecutor.js +415 -0
- package/dist/cjs/common/BaseSnapExecutor.js.map +1 -0
- package/dist/cjs/common/commands.js +65 -0
- package/dist/cjs/common/commands.js.map +1 -0
- package/dist/cjs/common/endowments/commonEndowmentFactory.js +147 -0
- package/dist/cjs/common/endowments/commonEndowmentFactory.js.map +1 -0
- package/dist/cjs/common/endowments/console.js +134 -0
- package/dist/cjs/common/endowments/console.js.map +1 -0
- package/dist/cjs/common/endowments/crypto.js +44 -0
- package/dist/cjs/common/endowments/crypto.js.map +1 -0
- package/dist/cjs/common/endowments/date.js +53 -0
- package/dist/cjs/common/endowments/date.js.map +1 -0
- package/dist/cjs/common/endowments/index.js +91 -0
- package/dist/cjs/common/endowments/index.js.map +1 -0
- package/dist/cjs/common/endowments/interval.js +61 -0
- package/dist/cjs/common/endowments/interval.js.map +1 -0
- package/dist/cjs/common/endowments/math.js +67 -0
- package/dist/cjs/common/endowments/math.js.map +1 -0
- package/dist/cjs/common/endowments/network.js +206 -0
- package/dist/cjs/common/endowments/network.js.map +1 -0
- package/dist/cjs/common/endowments/textDecoder.js +28 -0
- package/dist/cjs/common/endowments/textDecoder.js.map +1 -0
- package/dist/cjs/common/endowments/textEncoder.js +28 -0
- package/dist/cjs/common/endowments/textEncoder.js.map +1 -0
- package/dist/cjs/common/endowments/timeout.js +63 -0
- package/dist/cjs/common/endowments/timeout.js.map +1 -0
- package/dist/cjs/common/globalEvents.js +39 -0
- package/dist/cjs/common/globalEvents.js.map +1 -0
- package/dist/cjs/common/globalObject.js +53 -0
- package/dist/{common → cjs/common}/globalObject.js.map +1 -1
- package/dist/cjs/common/lockdown/lockdown-events.js +74 -0
- package/dist/cjs/common/lockdown/lockdown-events.js.map +1 -0
- package/dist/cjs/common/lockdown/lockdown-more.js +73 -0
- package/dist/cjs/common/lockdown/lockdown-more.js.map +1 -0
- package/dist/cjs/common/lockdown/lockdown.js +30 -0
- package/dist/cjs/common/lockdown/lockdown.js.map +1 -0
- package/dist/cjs/common/sortParams.js +26 -0
- package/dist/cjs/common/sortParams.js.map +1 -0
- package/dist/cjs/common/utils.js +116 -0
- package/dist/cjs/common/utils.js.map +1 -0
- package/dist/cjs/common/validation.js +114 -0
- package/dist/cjs/common/validation.js.map +1 -0
- package/dist/cjs/iframe/IFrameSnapExecutor.js +50 -0
- package/dist/cjs/iframe/IFrameSnapExecutor.js.map +1 -0
- package/dist/cjs/iframe/index.js +13 -0
- package/dist/cjs/iframe/index.js.map +1 -0
- package/dist/cjs/logging.js +15 -0
- package/dist/cjs/logging.js.map +1 -0
- package/dist/cjs/node-process/ChildProcessSnapExecutor.js +39 -0
- package/dist/cjs/node-process/ChildProcessSnapExecutor.js.map +1 -0
- package/dist/cjs/node-process/index.js +11 -0
- package/dist/cjs/node-process/index.js.map +1 -0
- package/dist/cjs/node-thread/ThreadSnapExecutor.js +39 -0
- package/dist/cjs/node-thread/ThreadSnapExecutor.js.map +1 -0
- package/dist/cjs/node-thread/index.js +11 -0
- package/dist/cjs/node-thread/index.js.map +1 -0
- package/dist/cjs/offscreen/OffscreenSnapExecutor.js +173 -0
- package/dist/cjs/offscreen/OffscreenSnapExecutor.js.map +1 -0
- package/dist/cjs/offscreen/index.js +19 -0
- package/dist/cjs/offscreen/index.js.map +1 -0
- package/dist/cjs/webworker/executor/WebWorkerSnapExecutor.js +45 -0
- package/dist/cjs/webworker/executor/WebWorkerSnapExecutor.js.map +1 -0
- package/dist/cjs/webworker/executor/index.js +13 -0
- package/dist/cjs/webworker/executor/index.js.map +1 -0
- package/dist/cjs/webworker/pool/WebWorkerPool.js +248 -0
- package/dist/cjs/webworker/pool/WebWorkerPool.js.map +1 -0
- package/dist/cjs/webworker/pool/index.js +13 -0
- package/dist/cjs/webworker/pool/index.js.map +1 -0
- package/dist/esm/common/BaseSnapExecutor.js +400 -0
- package/dist/esm/common/BaseSnapExecutor.js.map +1 -0
- package/dist/esm/common/commands.js +64 -0
- package/dist/esm/common/commands.js.map +1 -0
- package/dist/esm/common/endowments/commonEndowmentFactory.js +132 -0
- package/dist/esm/common/endowments/commonEndowmentFactory.js.map +1 -0
- package/dist/{common → esm/common}/endowments/console.js +46 -33
- package/dist/esm/common/endowments/console.js.map +1 -0
- package/dist/esm/common/endowments/crypto.js +26 -0
- package/dist/esm/common/endowments/crypto.js.map +1 -0
- package/dist/{common → esm/common}/endowments/date.js +20 -16
- package/dist/esm/common/endowments/date.js.map +1 -0
- package/dist/{common → esm/common}/endowments/index.js +33 -35
- package/dist/esm/common/endowments/index.js.map +1 -0
- package/dist/{common → esm/common}/endowments/interval.js +13 -12
- package/dist/esm/common/endowments/interval.js.map +1 -0
- package/dist/{common → esm/common}/endowments/math.js +19 -16
- package/dist/esm/common/endowments/math.js.map +1 -0
- package/dist/esm/common/endowments/network.js +196 -0
- package/dist/esm/common/endowments/network.js.map +1 -0
- package/dist/esm/common/endowments/textDecoder.js +18 -0
- package/dist/esm/common/endowments/textDecoder.js.map +1 -0
- package/dist/esm/common/endowments/textEncoder.js +18 -0
- package/dist/esm/common/endowments/textEncoder.js.map +1 -0
- package/dist/{common → esm/common}/endowments/timeout.js +14 -13
- package/dist/esm/common/endowments/timeout.js.map +1 -0
- package/dist/esm/common/globalEvents.js +35 -0
- package/dist/esm/common/globalEvents.js.map +1 -0
- package/dist/esm/common/globalObject.js +36 -0
- package/dist/esm/common/globalObject.js.map +1 -0
- package/dist/esm/common/lockdown/lockdown-events.js +66 -0
- package/dist/esm/common/lockdown/lockdown-events.js.map +1 -0
- package/dist/{common → esm/common}/lockdown/lockdown-more.js +15 -22
- package/dist/esm/common/lockdown/lockdown-more.js.map +1 -0
- package/dist/{common → esm/common}/lockdown/lockdown.js +6 -11
- package/dist/esm/common/lockdown/lockdown.js.map +1 -0
- package/dist/{common → esm/common}/sortParams.js +7 -13
- package/dist/esm/common/sortParams.js.map +1 -0
- package/dist/esm/common/utils.js +120 -0
- package/dist/esm/common/utils.js.map +1 -0
- package/dist/esm/common/validation.js +92 -0
- package/dist/esm/common/validation.js.map +1 -0
- package/dist/esm/iframe/IFrameSnapExecutor.js +35 -0
- package/dist/esm/iframe/IFrameSnapExecutor.js.map +1 -0
- package/dist/esm/iframe/index.js +9 -0
- package/dist/esm/iframe/index.js.map +1 -0
- package/dist/esm/logging.js +10 -0
- package/dist/esm/logging.js.map +1 -0
- package/dist/esm/node-process/ChildProcessSnapExecutor.js +24 -0
- package/dist/esm/node-process/ChildProcessSnapExecutor.js.map +1 -0
- package/dist/esm/node-process/index.js +7 -0
- package/dist/esm/node-process/index.js.map +1 -0
- package/dist/esm/node-thread/ThreadSnapExecutor.js +24 -0
- package/dist/esm/node-thread/ThreadSnapExecutor.js.map +1 -0
- package/dist/esm/node-thread/index.js +7 -0
- package/dist/esm/node-thread/index.js.map +1 -0
- package/dist/esm/offscreen/OffscreenSnapExecutor.js +176 -0
- package/dist/esm/offscreen/OffscreenSnapExecutor.js.map +1 -0
- package/dist/esm/offscreen/index.js +15 -0
- package/dist/esm/offscreen/index.js.map +1 -0
- package/dist/esm/webworker/executor/WebWorkerSnapExecutor.js +30 -0
- package/dist/esm/webworker/executor/WebWorkerSnapExecutor.js.map +1 -0
- package/dist/esm/webworker/executor/index.js +9 -0
- package/dist/esm/webworker/executor/index.js.map +1 -0
- package/dist/esm/webworker/pool/WebWorkerPool.js +245 -0
- package/dist/esm/webworker/pool/WebWorkerPool.js.map +1 -0
- package/dist/esm/webworker/pool/index.js +9 -0
- package/dist/esm/webworker/pool/index.js.map +1 -0
- package/package.json +58 -20
- package/dist/browserify/iframe/bundle.js +0 -6421
- package/dist/browserify/iframe/index.html +0 -11660
- package/dist/browserify/node-process/bundle.js +0 -15545
- package/dist/browserify/node-thread/bundle.js +0 -15545
- package/dist/browserify/offscreen/bundle.js +0 -2478
- package/dist/browserify/offscreen/index.html +0 -11660
- package/dist/browserify/worker-executor/bundle.js +0 -18072
- package/dist/browserify/worker-pool/bundle.js +0 -2492
- package/dist/browserify/worker-pool/index.html +0 -11660
- package/dist/common/BaseSnapExecutor.js +0 -370
- package/dist/common/BaseSnapExecutor.js.map +0 -1
- package/dist/common/commands.js +0 -65
- package/dist/common/commands.js.map +0 -1
- package/dist/common/endowments/commonEndowmentFactory.js +0 -76
- package/dist/common/endowments/commonEndowmentFactory.js.map +0 -1
- package/dist/common/endowments/console.js.map +0 -1
- package/dist/common/endowments/crypto.js +0 -30
- package/dist/common/endowments/crypto.js.map +0 -1
- package/dist/common/endowments/date.js.map +0 -1
- package/dist/common/endowments/index.js.map +0 -1
- package/dist/common/endowments/interval.js.map +0 -1
- package/dist/common/endowments/math.js.map +0 -1
- package/dist/common/endowments/network.js +0 -170
- package/dist/common/endowments/network.js.map +0 -1
- package/dist/common/endowments/textDecoder.js +0 -18
- package/dist/common/endowments/textDecoder.js.map +0 -1
- package/dist/common/endowments/textEncoder.js +0 -18
- package/dist/common/endowments/textEncoder.js.map +0 -1
- package/dist/common/endowments/timeout.js.map +0 -1
- package/dist/common/globalEvents.js +0 -47
- package/dist/common/globalEvents.js.map +0 -1
- package/dist/common/globalObject.js +0 -50
- package/dist/common/keyring.d.ts +0 -12
- package/dist/common/keyring.js +0 -42
- package/dist/common/keyring.js.map +0 -1
- package/dist/common/lockdown/lockdown-events.js +0 -60
- package/dist/common/lockdown/lockdown-events.js.map +0 -1
- package/dist/common/lockdown/lockdown-more.js.map +0 -1
- package/dist/common/lockdown/lockdown.js.map +0 -1
- package/dist/common/sortParams.js.map +0 -1
- package/dist/common/utils.js +0 -133
- package/dist/common/utils.js.map +0 -1
- package/dist/common/validation.js +0 -109
- package/dist/common/validation.js.map +0 -1
- package/dist/iframe/IFrameSnapExecutor.js +0 -42
- package/dist/iframe/IFrameSnapExecutor.js.map +0 -1
- package/dist/iframe/index.js +0 -10
- package/dist/iframe/index.js.map +0 -1
- package/dist/logging.js +0 -13
- package/dist/logging.js.map +0 -1
- package/dist/node-process/ChildProcessSnapExecutor.js +0 -30
- package/dist/node-process/ChildProcessSnapExecutor.js.map +0 -1
- package/dist/node-process/index.js +0 -8
- package/dist/node-process/index.js.map +0 -1
- package/dist/node-thread/ThreadSnapExecutor.js +0 -30
- package/dist/node-thread/ThreadSnapExecutor.js.map +0 -1
- package/dist/node-thread/index.js +0 -8
- package/dist/node-thread/index.js.map +0 -1
- package/dist/offscreen/OffscreenSnapExecutor.js +0 -104
- package/dist/offscreen/OffscreenSnapExecutor.js.map +0 -1
- package/dist/offscreen/index.js +0 -16
- package/dist/offscreen/index.js.map +0 -1
- package/dist/openrpc.json +0 -210
- package/dist/webworker/executor/WebWorkerSnapExecutor.js +0 -37
- package/dist/webworker/executor/WebWorkerSnapExecutor.js.map +0 -1
- package/dist/webworker/executor/index.js +0 -10
- package/dist/webworker/executor/index.js.map +0 -1
- package/dist/webworker/pool/WebWorkerPool.js +0 -168
- package/dist/webworker/pool/WebWorkerPool.js.map +0 -1
- package/dist/webworker/pool/index.js +0 -10
- package/dist/webworker/pool/index.js.map +0 -1
- /package/dist/{common → types/common}/BaseSnapExecutor.d.ts +0 -0
- /package/dist/{common → types/common}/commands.d.ts +0 -0
- /package/dist/{common → types/common}/endowments/commonEndowmentFactory.d.ts +0 -0
- /package/dist/{common → types/common}/endowments/console.d.ts +0 -0
- /package/dist/{common → types/common}/endowments/crypto.d.ts +0 -0
- /package/dist/{common → types/common}/endowments/date.d.ts +0 -0
- /package/dist/{common → types/common}/endowments/index.d.ts +0 -0
- /package/dist/{common → types/common}/endowments/interval.d.ts +0 -0
- /package/dist/{common → types/common}/endowments/math.d.ts +0 -0
- /package/dist/{common → types/common}/endowments/network.d.ts +0 -0
- /package/dist/{common → types/common}/endowments/textDecoder.d.ts +0 -0
- /package/dist/{common → types/common}/endowments/textEncoder.d.ts +0 -0
- /package/dist/{common → types/common}/endowments/timeout.d.ts +0 -0
- /package/dist/{common → types/common}/globalEvents.d.ts +0 -0
- /package/dist/{common → types/common}/globalObject.d.ts +0 -0
- /package/dist/{common → types/common}/lockdown/lockdown-events.d.ts +0 -0
- /package/dist/{common → types/common}/lockdown/lockdown-more.d.ts +0 -0
- /package/dist/{common → types/common}/lockdown/lockdown.d.ts +0 -0
- /package/dist/{common → types/common}/sortParams.d.ts +0 -0
- /package/dist/{common → types/common}/utils.d.ts +0 -0
- /package/dist/{common → types/common}/validation.d.ts +0 -0
- /package/dist/{iframe → types/iframe}/IFrameSnapExecutor.d.ts +0 -0
- /package/dist/{iframe → types/iframe}/index.d.ts +0 -0
- /package/dist/{logging.d.ts → types/logging.d.ts} +0 -0
- /package/dist/{node-process → types/node-process}/ChildProcessSnapExecutor.d.ts +0 -0
- /package/dist/{node-process → types/node-process}/index.d.ts +0 -0
- /package/dist/{node-thread → types/node-thread}/ThreadSnapExecutor.d.ts +0 -0
- /package/dist/{node-thread → types/node-thread}/index.d.ts +0 -0
- /package/dist/{offscreen → types/offscreen}/OffscreenSnapExecutor.d.ts +0 -0
- /package/dist/{offscreen → types/offscreen}/index.d.ts +0 -0
- /package/dist/{webworker → types/webworker}/executor/WebWorkerSnapExecutor.d.ts +0 -0
- /package/dist/{webworker → types/webworker}/executor/index.d.ts +0 -0
- /package/dist/{webworker → types/webworker}/pool/WebWorkerPool.d.ts +0 -0
- /package/dist/{webworker → types/webworker}/pool/index.d.ts +0 -0
package/dist/common/utils.js
DELETED
|
@@ -1,133 +0,0 @@
|
|
|
1
|
-
"use strict";
|
|
2
|
-
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
-
exports.assertEthereumOutboundRequest = exports.assertSnapOutboundRequest = exports.proxyStreamProvider = exports.withTeardown = exports.constructError = void 0;
|
|
4
|
-
const utils_1 = require("@metamask/utils");
|
|
5
|
-
const eth_rpc_errors_1 = require("eth-rpc-errors");
|
|
6
|
-
const logging_1 = require("../logging");
|
|
7
|
-
/**
|
|
8
|
-
* Takes an error that was thrown, determines if it is
|
|
9
|
-
* an error object. If it is then it will return that. Otherwise,
|
|
10
|
-
* an error object is created with the original error message.
|
|
11
|
-
*
|
|
12
|
-
* @param originalError - The error that was originally thrown.
|
|
13
|
-
* @returns An error object.
|
|
14
|
-
*/
|
|
15
|
-
function constructError(originalError) {
|
|
16
|
-
let _originalError;
|
|
17
|
-
if (originalError instanceof Error) {
|
|
18
|
-
_originalError = originalError;
|
|
19
|
-
}
|
|
20
|
-
else if (typeof originalError === 'string') {
|
|
21
|
-
_originalError = new Error(originalError);
|
|
22
|
-
// The stack is useless in this case.
|
|
23
|
-
delete _originalError.stack;
|
|
24
|
-
}
|
|
25
|
-
return _originalError;
|
|
26
|
-
}
|
|
27
|
-
exports.constructError = constructError;
|
|
28
|
-
/**
|
|
29
|
-
* Make proxy for Promise and handle the teardown process properly.
|
|
30
|
-
* If the teardown is called in the meanwhile, Promise result will not be
|
|
31
|
-
* exposed to the snap anymore and warning will be logged to the console.
|
|
32
|
-
*
|
|
33
|
-
* @param originalPromise - Original promise.
|
|
34
|
-
* @param teardownRef - Reference containing teardown count.
|
|
35
|
-
* @param teardownRef.lastTeardown - Number of the last teardown.
|
|
36
|
-
* @returns New proxy promise.
|
|
37
|
-
*/
|
|
38
|
-
async function withTeardown(originalPromise, teardownRef) {
|
|
39
|
-
const myTeardown = teardownRef.lastTeardown;
|
|
40
|
-
return new Promise((resolve, reject) => {
|
|
41
|
-
originalPromise
|
|
42
|
-
.then((value) => {
|
|
43
|
-
if (teardownRef.lastTeardown === myTeardown) {
|
|
44
|
-
resolve(value);
|
|
45
|
-
}
|
|
46
|
-
else {
|
|
47
|
-
(0, logging_1.log)('Late promise received after Snap finished execution. Promise will be dropped.');
|
|
48
|
-
}
|
|
49
|
-
})
|
|
50
|
-
.catch((reason) => {
|
|
51
|
-
if (teardownRef.lastTeardown === myTeardown) {
|
|
52
|
-
reject(reason);
|
|
53
|
-
}
|
|
54
|
-
else {
|
|
55
|
-
(0, logging_1.log)('Late promise received after Snap finished execution. Promise will be dropped.');
|
|
56
|
-
}
|
|
57
|
-
});
|
|
58
|
-
});
|
|
59
|
-
}
|
|
60
|
-
exports.withTeardown = withTeardown;
|
|
61
|
-
/**
|
|
62
|
-
* Returns a Proxy that narrows down (attenuates) the fields available on
|
|
63
|
-
* the StreamProvider and replaces the request implementation.
|
|
64
|
-
*
|
|
65
|
-
* @param provider - Instance of a StreamProvider to be limited.
|
|
66
|
-
* @param request - Custom attenuated request object.
|
|
67
|
-
* @returns Proxy to the StreamProvider instance.
|
|
68
|
-
*/
|
|
69
|
-
function proxyStreamProvider(provider, request) {
|
|
70
|
-
// Proxy target is intentionally set to be an empty object, to ensure
|
|
71
|
-
// that access to the prototype chain is not possible.
|
|
72
|
-
const proxy = new Proxy({}, {
|
|
73
|
-
has(_target, prop) {
|
|
74
|
-
return (typeof prop === 'string' &&
|
|
75
|
-
['request', 'on', 'removeListener'].includes(prop));
|
|
76
|
-
},
|
|
77
|
-
get(_target, prop) {
|
|
78
|
-
if (prop === 'request') {
|
|
79
|
-
return request;
|
|
80
|
-
}
|
|
81
|
-
else if (['on', 'removeListener'].includes(prop)) {
|
|
82
|
-
return provider[prop];
|
|
83
|
-
}
|
|
84
|
-
return undefined;
|
|
85
|
-
},
|
|
86
|
-
});
|
|
87
|
-
return proxy;
|
|
88
|
-
}
|
|
89
|
-
exports.proxyStreamProvider = proxyStreamProvider;
|
|
90
|
-
// We're blocking these RPC methods for v1, will revisit later.
|
|
91
|
-
const BLOCKED_RPC_METHODS = Object.freeze([
|
|
92
|
-
'eth_requestAccounts',
|
|
93
|
-
'wallet_requestSnaps',
|
|
94
|
-
'wallet_requestPermissions',
|
|
95
|
-
]);
|
|
96
|
-
/**
|
|
97
|
-
* Asserts the validity of request arguments for a snap outbound request using the `snap.request` API.
|
|
98
|
-
*
|
|
99
|
-
* @param args - The arguments to validate.
|
|
100
|
-
*/
|
|
101
|
-
function assertSnapOutboundRequest(args) {
|
|
102
|
-
// Disallow any non `wallet_` or `snap_` methods for separation of concerns.
|
|
103
|
-
(0, utils_1.assert)(String.prototype.startsWith.call(args.method, 'wallet_') ||
|
|
104
|
-
String.prototype.startsWith.call(args.method, 'snap_'), 'The global Snap API only allows RPC methods starting with `wallet_*` and `snap_*`.');
|
|
105
|
-
(0, utils_1.assert)(!BLOCKED_RPC_METHODS.includes(args.method), eth_rpc_errors_1.ethErrors.rpc.methodNotFound({
|
|
106
|
-
data: {
|
|
107
|
-
method: args.method,
|
|
108
|
-
},
|
|
109
|
-
}));
|
|
110
|
-
(0, utils_1.assertStruct)(args, utils_1.JsonStruct, 'Provided value is not JSON-RPC compatible');
|
|
111
|
-
}
|
|
112
|
-
exports.assertSnapOutboundRequest = assertSnapOutboundRequest;
|
|
113
|
-
/**
|
|
114
|
-
* Asserts the validity of request arguments for an ethereum outbound request using the `ethereum.request` API.
|
|
115
|
-
*
|
|
116
|
-
* @param args - The arguments to validate.
|
|
117
|
-
*/
|
|
118
|
-
function assertEthereumOutboundRequest(args) {
|
|
119
|
-
// Disallow snaps methods for separation of concerns.
|
|
120
|
-
(0, utils_1.assert)(!String.prototype.startsWith.call(args.method, 'snap_'), eth_rpc_errors_1.ethErrors.rpc.methodNotFound({
|
|
121
|
-
data: {
|
|
122
|
-
method: args.method,
|
|
123
|
-
},
|
|
124
|
-
}));
|
|
125
|
-
(0, utils_1.assert)(!BLOCKED_RPC_METHODS.includes(args.method), eth_rpc_errors_1.ethErrors.rpc.methodNotFound({
|
|
126
|
-
data: {
|
|
127
|
-
method: args.method,
|
|
128
|
-
},
|
|
129
|
-
}));
|
|
130
|
-
(0, utils_1.assertStruct)(args, utils_1.JsonStruct, 'Provided value is not JSON-RPC compatible');
|
|
131
|
-
}
|
|
132
|
-
exports.assertEthereumOutboundRequest = assertEthereumOutboundRequest;
|
|
133
|
-
//# sourceMappingURL=utils.js.map
|
package/dist/common/utils.js.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/common/utils.ts"],"names":[],"mappings":"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","sourcesContent":["import { StreamProvider } from '@metamask/providers';\nimport { RequestArguments } from '@metamask/providers/dist/BaseProvider';\nimport { assert, assertStruct, JsonStruct } from '@metamask/utils';\nimport { ethErrors } from 'eth-rpc-errors';\n\nimport { log } from '../logging';\n\n/**\n * Takes an error that was thrown, determines if it is\n * an error object. If it is then it will return that. Otherwise,\n * an error object is created with the original error message.\n *\n * @param originalError - The error that was originally thrown.\n * @returns An error object.\n */\nexport function constructError(originalError: unknown) {\n let _originalError: Error | undefined;\n if (originalError instanceof Error) {\n _originalError = originalError;\n } else if (typeof originalError === 'string') {\n _originalError = new Error(originalError);\n // The stack is useless in this case.\n delete _originalError.stack;\n }\n return _originalError;\n}\n\n/**\n * Make proxy for Promise and handle the teardown process properly.\n * If the teardown is called in the meanwhile, Promise result will not be\n * exposed to the snap anymore and warning will be logged to the console.\n *\n * @param originalPromise - Original promise.\n * @param teardownRef - Reference containing teardown count.\n * @param teardownRef.lastTeardown - Number of the last teardown.\n * @returns New proxy promise.\n */\nexport async function withTeardown<T>(\n originalPromise: Promise<T>,\n teardownRef: { lastTeardown: number },\n): Promise<T> {\n const myTeardown = teardownRef.lastTeardown;\n return new Promise<T>((resolve, reject) => {\n originalPromise\n .then((value) => {\n if (teardownRef.lastTeardown === myTeardown) {\n resolve(value);\n } else {\n log(\n 'Late promise received after Snap finished execution. Promise will be dropped.',\n );\n }\n })\n .catch((reason) => {\n if (teardownRef.lastTeardown === myTeardown) {\n reject(reason);\n } else {\n log(\n 'Late promise received after Snap finished execution. Promise will be dropped.',\n );\n }\n });\n });\n}\n\n/**\n * Returns a Proxy that narrows down (attenuates) the fields available on\n * the StreamProvider and replaces the request implementation.\n *\n * @param provider - Instance of a StreamProvider to be limited.\n * @param request - Custom attenuated request object.\n * @returns Proxy to the StreamProvider instance.\n */\nexport function proxyStreamProvider(\n provider: StreamProvider,\n request: unknown,\n): StreamProvider {\n // Proxy target is intentionally set to be an empty object, to ensure\n // that access to the prototype chain is not possible.\n const proxy = new Proxy(\n {},\n {\n has(_target: object, prop: string | symbol) {\n return (\n typeof prop === 'string' &&\n ['request', 'on', 'removeListener'].includes(prop)\n );\n },\n get(_target, prop: keyof StreamProvider) {\n if (prop === 'request') {\n return request;\n } else if (['on', 'removeListener'].includes(prop)) {\n return provider[prop];\n }\n\n return undefined;\n },\n },\n );\n\n return proxy as StreamProvider;\n}\n\n// We're blocking these RPC methods for v1, will revisit later.\nconst BLOCKED_RPC_METHODS = Object.freeze([\n 'eth_requestAccounts',\n 'wallet_requestSnaps',\n 'wallet_requestPermissions',\n]);\n\n/**\n * Asserts the validity of request arguments for a snap outbound request using the `snap.request` API.\n *\n * @param args - The arguments to validate.\n */\nexport function assertSnapOutboundRequest(args: RequestArguments) {\n // Disallow any non `wallet_` or `snap_` methods for separation of concerns.\n assert(\n String.prototype.startsWith.call(args.method, 'wallet_') ||\n String.prototype.startsWith.call(args.method, 'snap_'),\n 'The global Snap API only allows RPC methods starting with `wallet_*` and `snap_*`.',\n );\n assert(\n !BLOCKED_RPC_METHODS.includes(args.method),\n ethErrors.rpc.methodNotFound({\n data: {\n method: args.method,\n },\n }),\n );\n assertStruct(args, JsonStruct, 'Provided value is not JSON-RPC compatible');\n}\n\n/**\n * Asserts the validity of request arguments for an ethereum outbound request using the `ethereum.request` API.\n *\n * @param args - The arguments to validate.\n */\nexport function assertEthereumOutboundRequest(args: RequestArguments) {\n // Disallow snaps methods for separation of concerns.\n assert(\n !String.prototype.startsWith.call(args.method, 'snap_'),\n ethErrors.rpc.methodNotFound({\n data: {\n method: args.method,\n },\n }),\n );\n assert(\n !BLOCKED_RPC_METHODS.includes(args.method),\n ethErrors.rpc.methodNotFound({\n data: {\n method: args.method,\n },\n }),\n );\n assertStruct(args, JsonStruct, 'Provided value is not JSON-RPC compatible');\n}\n"]}
|
|
@@ -1,109 +0,0 @@
|
|
|
1
|
-
"use strict";
|
|
2
|
-
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
-
exports.assertIsOnTransactionRequestArguments = exports.OnTransactionRequestArgumentsStruct = exports.SnapRpcRequestArgumentsStruct = exports.ExecuteSnapRequestArgumentsStruct = exports.TerminateRequestArgumentsStruct = exports.PingRequestArgumentsStruct = exports.isEndowmentsArray = exports.isEndowment = exports.EndowmentStruct = exports.JsonRpcRequestWithoutIdStruct = exports.validateExport = void 0;
|
|
4
|
-
const snaps_utils_1 = require("@metamask/snaps-utils");
|
|
5
|
-
const utils_1 = require("@metamask/utils");
|
|
6
|
-
const superstruct_1 = require("superstruct");
|
|
7
|
-
const VALIDATION_FUNCTIONS = {
|
|
8
|
-
[snaps_utils_1.HandlerType.OnRpcRequest]: validateFunctionExport,
|
|
9
|
-
[snaps_utils_1.HandlerType.OnTransaction]: validateFunctionExport,
|
|
10
|
-
[snaps_utils_1.HandlerType.SnapKeyring]: validateKeyringExport,
|
|
11
|
-
[snaps_utils_1.HandlerType.OnCronjob]: validateFunctionExport,
|
|
12
|
-
};
|
|
13
|
-
/**
|
|
14
|
-
* Validates a function export.
|
|
15
|
-
*
|
|
16
|
-
* @param snapExport - The export itself.
|
|
17
|
-
* @returns True if the export matches the expected shape, false otherwise.
|
|
18
|
-
*/
|
|
19
|
-
function validateFunctionExport(snapExport) {
|
|
20
|
-
return typeof snapExport === 'function';
|
|
21
|
-
}
|
|
22
|
-
/**
|
|
23
|
-
* Validates a keyring export.
|
|
24
|
-
*
|
|
25
|
-
* @param snapExport - The export itself.
|
|
26
|
-
* @returns True if the export matches the expected shape, false otherwise.
|
|
27
|
-
*/
|
|
28
|
-
function validateKeyringExport(snapExport) {
|
|
29
|
-
// TODO Decide whether we want more validation
|
|
30
|
-
return typeof snapExport === 'object';
|
|
31
|
-
}
|
|
32
|
-
/**
|
|
33
|
-
* Validates a given snap export.
|
|
34
|
-
*
|
|
35
|
-
* @param type - The type of export expected.
|
|
36
|
-
* @param snapExport - The export itself.
|
|
37
|
-
* @returns True if the export matches the expected shape, false otherwise.
|
|
38
|
-
*/
|
|
39
|
-
function validateExport(type, snapExport) {
|
|
40
|
-
const validationFunction = VALIDATION_FUNCTIONS[type];
|
|
41
|
-
return validationFunction?.(snapExport) ?? false;
|
|
42
|
-
}
|
|
43
|
-
exports.validateExport = validateExport;
|
|
44
|
-
exports.JsonRpcRequestWithoutIdStruct = (0, superstruct_1.assign)((0, superstruct_1.omit)(utils_1.JsonRpcRequestStruct, ['id']), (0, superstruct_1.object)({
|
|
45
|
-
id: (0, superstruct_1.optional)(utils_1.JsonRpcIdStruct),
|
|
46
|
-
}));
|
|
47
|
-
exports.EndowmentStruct = (0, superstruct_1.string)();
|
|
48
|
-
/**
|
|
49
|
-
* Check if the given value is an endowment.
|
|
50
|
-
*
|
|
51
|
-
* @param value - The value to check.
|
|
52
|
-
* @returns Whether the value is an endowment.
|
|
53
|
-
*/
|
|
54
|
-
function isEndowment(value) {
|
|
55
|
-
return (0, superstruct_1.is)(value, exports.EndowmentStruct);
|
|
56
|
-
}
|
|
57
|
-
exports.isEndowment = isEndowment;
|
|
58
|
-
/**
|
|
59
|
-
* Check if the given value is an array of endowments.
|
|
60
|
-
*
|
|
61
|
-
* @param value - The value to check.
|
|
62
|
-
* @returns Whether the value is an array of endowments.
|
|
63
|
-
*/
|
|
64
|
-
function isEndowmentsArray(value) {
|
|
65
|
-
return Array.isArray(value) && value.every(isEndowment);
|
|
66
|
-
}
|
|
67
|
-
exports.isEndowmentsArray = isEndowmentsArray;
|
|
68
|
-
const OkStruct = (0, superstruct_1.literal)('OK');
|
|
69
|
-
exports.PingRequestArgumentsStruct = (0, superstruct_1.optional)((0, superstruct_1.union)([(0, superstruct_1.literal)(undefined), (0, superstruct_1.array)()]));
|
|
70
|
-
exports.TerminateRequestArgumentsStruct = (0, superstruct_1.union)([
|
|
71
|
-
(0, superstruct_1.literal)(undefined),
|
|
72
|
-
(0, superstruct_1.array)(),
|
|
73
|
-
]);
|
|
74
|
-
exports.ExecuteSnapRequestArgumentsStruct = (0, superstruct_1.tuple)([
|
|
75
|
-
(0, superstruct_1.string)(),
|
|
76
|
-
(0, superstruct_1.string)(),
|
|
77
|
-
(0, superstruct_1.optional)((0, superstruct_1.array)(exports.EndowmentStruct)),
|
|
78
|
-
]);
|
|
79
|
-
exports.SnapRpcRequestArgumentsStruct = (0, superstruct_1.tuple)([
|
|
80
|
-
(0, superstruct_1.string)(),
|
|
81
|
-
(0, superstruct_1.enums)(Object.values(snaps_utils_1.HandlerType)),
|
|
82
|
-
(0, superstruct_1.string)(),
|
|
83
|
-
(0, superstruct_1.assign)(exports.JsonRpcRequestWithoutIdStruct, (0, superstruct_1.object)({
|
|
84
|
-
params: (0, superstruct_1.optional)((0, superstruct_1.record)((0, superstruct_1.string)(), utils_1.JsonStruct)),
|
|
85
|
-
})),
|
|
86
|
-
]);
|
|
87
|
-
exports.OnTransactionRequestArgumentsStruct = (0, superstruct_1.object)({
|
|
88
|
-
// TODO: Improve `transaction` type.
|
|
89
|
-
transaction: (0, superstruct_1.record)((0, superstruct_1.string)(), utils_1.JsonStruct),
|
|
90
|
-
chainId: snaps_utils_1.ChainIdStruct,
|
|
91
|
-
transactionOrigin: (0, superstruct_1.nullable)((0, superstruct_1.string)()),
|
|
92
|
-
});
|
|
93
|
-
/**
|
|
94
|
-
* Asserts that the given value is a valid {@link OnTransactionRequestArguments}
|
|
95
|
-
* object.
|
|
96
|
-
*
|
|
97
|
-
* @param value - The value to validate.
|
|
98
|
-
* @throws If the value is not a valid {@link OnTransactionRequestArguments}
|
|
99
|
-
* object.
|
|
100
|
-
*/
|
|
101
|
-
function assertIsOnTransactionRequestArguments(value) {
|
|
102
|
-
(0, utils_1.assertStruct)(value, exports.OnTransactionRequestArgumentsStruct, 'Invalid request params');
|
|
103
|
-
}
|
|
104
|
-
exports.assertIsOnTransactionRequestArguments = assertIsOnTransactionRequestArguments;
|
|
105
|
-
const OkResponseStruct = (0, superstruct_1.assign)(utils_1.JsonRpcSuccessStruct, (0, superstruct_1.object)({
|
|
106
|
-
result: OkStruct,
|
|
107
|
-
}));
|
|
108
|
-
const SnapRpcResponse = utils_1.JsonRpcSuccessStruct;
|
|
109
|
-
//# sourceMappingURL=validation.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/common/validation.ts"],"names":[],"mappings":"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","sourcesContent":["import { SnapKeyring, ChainIdStruct, HandlerType } from '@metamask/snaps-utils';\nimport {\n assertStruct,\n Json,\n JsonRpcIdStruct,\n JsonRpcRequestStruct,\n JsonRpcSuccess,\n JsonRpcSuccessStruct,\n JsonStruct,\n} from '@metamask/utils';\nimport {\n array,\n assign,\n enums,\n Infer,\n is,\n literal,\n nullable,\n object,\n omit,\n optional,\n record,\n string,\n tuple,\n union,\n} from 'superstruct';\n\nconst VALIDATION_FUNCTIONS = {\n [HandlerType.OnRpcRequest]: validateFunctionExport,\n [HandlerType.OnTransaction]: validateFunctionExport,\n [HandlerType.SnapKeyring]: validateKeyringExport,\n [HandlerType.OnCronjob]: validateFunctionExport,\n};\n\n/**\n * Validates a function export.\n *\n * @param snapExport - The export itself.\n * @returns True if the export matches the expected shape, false otherwise.\n */\nfunction validateFunctionExport(\n snapExport: unknown,\n): snapExport is (...args: unknown[]) => unknown {\n return typeof snapExport === 'function';\n}\n\n/**\n * Validates a keyring export.\n *\n * @param snapExport - The export itself.\n * @returns True if the export matches the expected shape, false otherwise.\n */\nfunction validateKeyringExport(snapExport: unknown): snapExport is SnapKeyring {\n // TODO Decide whether we want more validation\n return typeof snapExport === 'object';\n}\n\n/**\n * Validates a given snap export.\n *\n * @param type - The type of export expected.\n * @param snapExport - The export itself.\n * @returns True if the export matches the expected shape, false otherwise.\n */\nexport function validateExport(type: HandlerType, snapExport: unknown) {\n const validationFunction = VALIDATION_FUNCTIONS[type];\n return validationFunction?.(snapExport) ?? false;\n}\n\nexport const JsonRpcRequestWithoutIdStruct = assign(\n omit(JsonRpcRequestStruct, ['id']),\n object({\n id: optional(JsonRpcIdStruct),\n }),\n);\n\nexport type JsonRpcRequestWithoutId = Infer<\n typeof JsonRpcRequestWithoutIdStruct\n>;\n\nexport const EndowmentStruct = string();\nexport type Endowment = Infer<typeof EndowmentStruct>;\n\n/**\n * Check if the given value is an endowment.\n *\n * @param value - The value to check.\n * @returns Whether the value is an endowment.\n */\nexport function isEndowment(value: unknown): value is Endowment {\n return is(value, EndowmentStruct);\n}\n\n/**\n * Check if the given value is an array of endowments.\n *\n * @param value - The value to check.\n * @returns Whether the value is an array of endowments.\n */\nexport function isEndowmentsArray(value: unknown): value is Endowment[] {\n return Array.isArray(value) && value.every(isEndowment);\n}\n\nconst OkStruct = literal('OK');\n\nexport const PingRequestArgumentsStruct = optional(\n union([literal(undefined), array()]),\n);\n\nexport const TerminateRequestArgumentsStruct = union([\n literal(undefined),\n array(),\n]);\n\nexport const ExecuteSnapRequestArgumentsStruct = tuple([\n string(),\n string(),\n optional(array(EndowmentStruct)),\n]);\n\nexport const SnapRpcRequestArgumentsStruct = tuple([\n string(),\n enums(Object.values(HandlerType)),\n string(),\n assign(\n JsonRpcRequestWithoutIdStruct,\n object({\n params: optional(record(string(), JsonStruct)),\n }),\n ),\n]);\n\nexport type PingRequestArguments = Infer<typeof PingRequestArgumentsStruct>;\nexport type TerminateRequestArguments = Infer<\n typeof TerminateRequestArgumentsStruct\n>;\n\nexport type ExecuteSnapRequestArguments = Infer<\n typeof ExecuteSnapRequestArgumentsStruct\n>;\n\nexport type SnapRpcRequestArguments = Infer<\n typeof SnapRpcRequestArgumentsStruct\n>;\n\nexport type RequestArguments =\n | PingRequestArguments\n | TerminateRequestArguments\n | ExecuteSnapRequestArguments\n | SnapRpcRequestArguments;\n\nexport const OnTransactionRequestArgumentsStruct = object({\n // TODO: Improve `transaction` type.\n transaction: record(string(), JsonStruct),\n chainId: ChainIdStruct,\n transactionOrigin: nullable(string()),\n});\n\nexport type OnTransactionRequestArguments = Infer<\n typeof OnTransactionRequestArgumentsStruct\n>;\n\n/**\n * Asserts that the given value is a valid {@link OnTransactionRequestArguments}\n * object.\n *\n * @param value - The value to validate.\n * @throws If the value is not a valid {@link OnTransactionRequestArguments}\n * object.\n */\nexport function assertIsOnTransactionRequestArguments(\n value: unknown,\n): asserts value is OnTransactionRequestArguments {\n assertStruct(\n value,\n OnTransactionRequestArgumentsStruct,\n 'Invalid request params',\n );\n}\n\nconst OkResponseStruct = assign(\n JsonRpcSuccessStruct,\n object({\n result: OkStruct,\n }),\n);\n\nconst SnapRpcResponse = JsonRpcSuccessStruct;\n\nexport type OkResponse = Infer<typeof OkResponseStruct>;\nexport type SnapRpcResponse = Infer<typeof SnapRpcResponse>;\n\nexport type Response = OkResponse | SnapRpcResponse;\n\ntype RequestParams<Params extends unknown[] | undefined> =\n Params extends undefined ? [] : Params;\n\ntype RequestFunction<\n Args extends RequestArguments,\n ResponseType extends JsonRpcSuccess<Json>,\n> = (...args: RequestParams<Args>) => Promise<ResponseType['result']>;\n\nexport type Ping = RequestFunction<PingRequestArguments, OkResponse>;\nexport type Terminate = RequestFunction<TerminateRequestArguments, OkResponse>;\nexport type ExecuteSnap = RequestFunction<\n ExecuteSnapRequestArguments,\n OkResponse\n>;\nexport type SnapRpc = RequestFunction<SnapRpcRequestArguments, SnapRpcResponse>;\n"]}
|
|
@@ -1,42 +0,0 @@
|
|
|
1
|
-
"use strict";
|
|
2
|
-
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
3
|
-
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
4
|
-
};
|
|
5
|
-
Object.defineProperty(exports, "__esModule", { value: true });
|
|
6
|
-
exports.IFrameSnapExecutor = void 0;
|
|
7
|
-
const object_multiplex_1 = __importDefault(require("@metamask/object-multiplex"));
|
|
8
|
-
const post_message_stream_1 = require("@metamask/post-message-stream");
|
|
9
|
-
const snaps_utils_1 = require("@metamask/snaps-utils");
|
|
10
|
-
const pump_1 = __importDefault(require("pump"));
|
|
11
|
-
const BaseSnapExecutor_1 = require("../common/BaseSnapExecutor");
|
|
12
|
-
const logging_1 = require("../logging");
|
|
13
|
-
class IFrameSnapExecutor extends BaseSnapExecutor_1.BaseSnapExecutor {
|
|
14
|
-
/**
|
|
15
|
-
* Initialize the IFrameSnapExecutor. This creates a post message stream from
|
|
16
|
-
* and to the parent window, for two-way communication with the iframe.
|
|
17
|
-
*
|
|
18
|
-
* @param stream - The stream to use for communication.
|
|
19
|
-
* @returns An instance of `IFrameSnapExecutor`, with the initialized post
|
|
20
|
-
* message streams.
|
|
21
|
-
*/
|
|
22
|
-
static initialize(stream = new post_message_stream_1.WindowPostMessageStream({
|
|
23
|
-
name: 'child',
|
|
24
|
-
target: 'parent',
|
|
25
|
-
targetWindow: self.parent,
|
|
26
|
-
targetOrigin: '*',
|
|
27
|
-
})) {
|
|
28
|
-
(0, logging_1.log)('Worker: Connecting to parent.');
|
|
29
|
-
const mux = new object_multiplex_1.default();
|
|
30
|
-
(0, pump_1.default)(stream, mux, stream, (error) => {
|
|
31
|
-
if (error) {
|
|
32
|
-
(0, snaps_utils_1.logError)(`Parent stream failure, closing worker.`, error);
|
|
33
|
-
}
|
|
34
|
-
self.close();
|
|
35
|
-
});
|
|
36
|
-
const commandStream = mux.createStream(snaps_utils_1.SNAP_STREAM_NAMES.COMMAND);
|
|
37
|
-
const rpcStream = mux.createStream(snaps_utils_1.SNAP_STREAM_NAMES.JSON_RPC);
|
|
38
|
-
return new IFrameSnapExecutor(commandStream, rpcStream);
|
|
39
|
-
}
|
|
40
|
-
}
|
|
41
|
-
exports.IFrameSnapExecutor = IFrameSnapExecutor;
|
|
42
|
-
//# sourceMappingURL=IFrameSnapExecutor.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"IFrameSnapExecutor.js","sourceRoot":"","sources":["../../src/iframe/IFrameSnapExecutor.ts"],"names":[],"mappings":";;;;;;AAAA,kFAAyD;AACzD,uEAGuC;AACvC,uDAAoE;AACpE,gDAAwB;AAExB,iEAA8D;AAC9D,wCAAiC;AAEjC,MAAa,kBAAmB,SAAQ,mCAAgB;IACtD;;;;;;;OAOG;IACH,MAAM,CAAC,UAAU,CACf,SAAgC,IAAI,6CAAuB,CAAC;QAC1D,IAAI,EAAE,OAAO;QACb,MAAM,EAAE,QAAQ;QAChB,YAAY,EAAE,IAAI,CAAC,MAAM;QACzB,YAAY,EAAE,GAAG;KAClB,CAAC;QAEF,IAAA,aAAG,EAAC,+BAA+B,CAAC,CAAC;QAErC,MAAM,GAAG,GAAG,IAAI,0BAAe,EAAE,CAAC;QAClC,IAAA,cAAI,EAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;YAClC,IAAI,KAAK,EAAE;gBACT,IAAA,sBAAQ,EAAC,wCAAwC,EAAE,KAAK,CAAC,CAAC;aAC3D;YACD,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC,CAAC,CAAC;QAEH,MAAM,aAAa,GAAG,GAAG,CAAC,YAAY,CAAC,+BAAiB,CAAC,OAAO,CAAC,CAAC;QAClE,MAAM,SAAS,GAAG,GAAG,CAAC,YAAY,CAAC,+BAAiB,CAAC,QAAQ,CAAC,CAAC;QAE/D,OAAO,IAAI,kBAAkB,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;IAC1D,CAAC;CACF;AAhCD,gDAgCC","sourcesContent":["import ObjectMultiplex from '@metamask/object-multiplex';\nimport {\n BasePostMessageStream,\n WindowPostMessageStream,\n} from '@metamask/post-message-stream';\nimport { logError, SNAP_STREAM_NAMES } from '@metamask/snaps-utils';\nimport pump from 'pump';\n\nimport { BaseSnapExecutor } from '../common/BaseSnapExecutor';\nimport { log } from '../logging';\n\nexport class IFrameSnapExecutor extends BaseSnapExecutor {\n /**\n * Initialize the IFrameSnapExecutor. This creates a post message stream from\n * and to the parent window, for two-way communication with the iframe.\n *\n * @param stream - The stream to use for communication.\n * @returns An instance of `IFrameSnapExecutor`, with the initialized post\n * message streams.\n */\n static initialize(\n stream: BasePostMessageStream = new WindowPostMessageStream({\n name: 'child',\n target: 'parent',\n targetWindow: self.parent,\n targetOrigin: '*',\n }),\n ) {\n log('Worker: Connecting to parent.');\n\n const mux = new ObjectMultiplex();\n pump(stream, mux, stream, (error) => {\n if (error) {\n logError(`Parent stream failure, closing worker.`, error);\n }\n self.close();\n });\n\n const commandStream = mux.createStream(SNAP_STREAM_NAMES.COMMAND);\n const rpcStream = mux.createStream(SNAP_STREAM_NAMES.JSON_RPC);\n\n return new IFrameSnapExecutor(commandStream, rpcStream);\n }\n}\n"]}
|
package/dist/iframe/index.js
DELETED
|
@@ -1,10 +0,0 @@
|
|
|
1
|
-
"use strict";
|
|
2
|
-
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
-
const lockdown_events_1 = require("../common/lockdown/lockdown-events");
|
|
4
|
-
const lockdown_more_1 = require("../common/lockdown/lockdown-more");
|
|
5
|
-
const IFrameSnapExecutor_1 = require("./IFrameSnapExecutor");
|
|
6
|
-
// Lockdown is already applied in LavaMoat
|
|
7
|
-
(0, lockdown_more_1.executeLockdownMore)();
|
|
8
|
-
(0, lockdown_events_1.executeLockdownEvents)();
|
|
9
|
-
IFrameSnapExecutor_1.IFrameSnapExecutor.initialize();
|
|
10
|
-
//# sourceMappingURL=index.js.map
|
package/dist/iframe/index.js.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/iframe/index.ts"],"names":[],"mappings":";;AAAA,wEAA2E;AAC3E,oEAAuE;AACvE,6DAA0D;AAE1D,0CAA0C;AAC1C,IAAA,mCAAmB,GAAE,CAAC;AACtB,IAAA,uCAAqB,GAAE,CAAC;AAExB,uCAAkB,CAAC,UAAU,EAAE,CAAC","sourcesContent":["import { executeLockdownEvents } from '../common/lockdown/lockdown-events';\nimport { executeLockdownMore } from '../common/lockdown/lockdown-more';\nimport { IFrameSnapExecutor } from './IFrameSnapExecutor';\n\n// Lockdown is already applied in LavaMoat\nexecuteLockdownMore();\nexecuteLockdownEvents();\n\nIFrameSnapExecutor.initialize();\n"]}
|
package/dist/logging.js
DELETED
|
@@ -1,13 +0,0 @@
|
|
|
1
|
-
"use strict";
|
|
2
|
-
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
-
exports.log = void 0;
|
|
4
|
-
const snaps_utils_1 = require("@metamask/snaps-utils");
|
|
5
|
-
const utils_1 = require("@metamask/utils");
|
|
6
|
-
/**
|
|
7
|
-
* A logging function specific to this package. The log messages don't show up
|
|
8
|
-
* by default, but they can be enabled by setting the environment variable:
|
|
9
|
-
* - `DEBUG=metamask:snaps:snaps-execution-environments`, or
|
|
10
|
-
* - `DEBUG=metamask:snaps:*` to enable all logs from `@metamask/snaps-*`.
|
|
11
|
-
*/
|
|
12
|
-
exports.log = (0, utils_1.createModuleLogger)(snaps_utils_1.snapsLogger, 'snaps-execution-environments');
|
|
13
|
-
//# sourceMappingURL=logging.js.map
|
package/dist/logging.js.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"logging.js","sourceRoot":"","sources":["../src/logging.ts"],"names":[],"mappings":";;;AAAA,uDAAoD;AACpD,2CAAqD;AAErD;;;;;GAKG;AACU,QAAA,GAAG,GAAG,IAAA,0BAAkB,EACnC,yBAAW,EACX,8BAA8B,CAC/B,CAAC","sourcesContent":["import { snapsLogger } from '@metamask/snaps-utils';\nimport { createModuleLogger } from '@metamask/utils';\n\n/**\n * A logging function specific to this package. The log messages don't show up\n * by default, but they can be enabled by setting the environment variable:\n * - `DEBUG=metamask:snaps:snaps-execution-environments`, or\n * - `DEBUG=metamask:snaps:*` to enable all logs from `@metamask/snaps-*`.\n */\nexport const log = createModuleLogger(\n snapsLogger,\n 'snaps-execution-environments',\n);\n"]}
|
|
@@ -1,30 +0,0 @@
|
|
|
1
|
-
"use strict";
|
|
2
|
-
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
3
|
-
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
4
|
-
};
|
|
5
|
-
Object.defineProperty(exports, "__esModule", { value: true });
|
|
6
|
-
exports.ChildProcessSnapExecutor = void 0;
|
|
7
|
-
const object_multiplex_1 = __importDefault(require("@metamask/object-multiplex"));
|
|
8
|
-
const post_message_stream_1 = require("@metamask/post-message-stream");
|
|
9
|
-
const snaps_utils_1 = require("@metamask/snaps-utils");
|
|
10
|
-
const pump_1 = __importDefault(require("pump"));
|
|
11
|
-
const BaseSnapExecutor_1 = require("../common/BaseSnapExecutor");
|
|
12
|
-
const logging_1 = require("../logging");
|
|
13
|
-
class ChildProcessSnapExecutor extends BaseSnapExecutor_1.BaseSnapExecutor {
|
|
14
|
-
static initialize() {
|
|
15
|
-
(0, logging_1.log)('Worker: Connecting to parent.');
|
|
16
|
-
const parentStream = new post_message_stream_1.ProcessMessageStream();
|
|
17
|
-
const mux = new object_multiplex_1.default();
|
|
18
|
-
(0, pump_1.default)(parentStream, mux, parentStream, (error) => {
|
|
19
|
-
if (error) {
|
|
20
|
-
(0, snaps_utils_1.logError)(`Parent stream failure, closing worker.`, error);
|
|
21
|
-
}
|
|
22
|
-
self.close();
|
|
23
|
-
});
|
|
24
|
-
const commandStream = mux.createStream(snaps_utils_1.SNAP_STREAM_NAMES.COMMAND);
|
|
25
|
-
const rpcStream = mux.createStream(snaps_utils_1.SNAP_STREAM_NAMES.JSON_RPC);
|
|
26
|
-
return new ChildProcessSnapExecutor(commandStream, rpcStream);
|
|
27
|
-
}
|
|
28
|
-
}
|
|
29
|
-
exports.ChildProcessSnapExecutor = ChildProcessSnapExecutor;
|
|
30
|
-
//# sourceMappingURL=ChildProcessSnapExecutor.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"ChildProcessSnapExecutor.js","sourceRoot":"","sources":["../../src/node-process/ChildProcessSnapExecutor.ts"],"names":[],"mappings":";;;;;;AAAA,kFAAyD;AACzD,uEAAqE;AACrE,uDAAoE;AACpE,gDAAwB;AAExB,iEAA8D;AAC9D,wCAAiC;AAEjC,MAAa,wBAAyB,SAAQ,mCAAgB;IAC5D,MAAM,CAAC,UAAU;QACf,IAAA,aAAG,EAAC,+BAA+B,CAAC,CAAC;QAErC,MAAM,YAAY,GAAG,IAAI,0CAAoB,EAAE,CAAC;QAChD,MAAM,GAAG,GAAG,IAAI,0BAAe,EAAE,CAAC;QAClC,IAAA,cAAI,EAAC,YAAY,EAAE,GAAU,EAAE,YAAY,EAAE,CAAC,KAAK,EAAE,EAAE;YACrD,IAAI,KAAK,EAAE;gBACT,IAAA,sBAAQ,EAAC,wCAAwC,EAAE,KAAK,CAAC,CAAC;aAC3D;YACD,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC,CAAC,CAAC;QAEH,MAAM,aAAa,GAAG,GAAG,CAAC,YAAY,CAAC,+BAAiB,CAAC,OAAO,CAAC,CAAC;QAClE,MAAM,SAAS,GAAG,GAAG,CAAC,YAAY,CAAC,+BAAiB,CAAC,QAAQ,CAAQ,CAAC;QACtE,OAAO,IAAI,wBAAwB,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;IAChE,CAAC;CACF;AAjBD,4DAiBC","sourcesContent":["import ObjectMultiplex from '@metamask/object-multiplex';\nimport { ProcessMessageStream } from '@metamask/post-message-stream';\nimport { logError, SNAP_STREAM_NAMES } from '@metamask/snaps-utils';\nimport pump from 'pump';\n\nimport { BaseSnapExecutor } from '../common/BaseSnapExecutor';\nimport { log } from '../logging';\n\nexport class ChildProcessSnapExecutor extends BaseSnapExecutor {\n static initialize() {\n log('Worker: Connecting to parent.');\n\n const parentStream = new ProcessMessageStream();\n const mux = new ObjectMultiplex();\n pump(parentStream, mux as any, parentStream, (error) => {\n if (error) {\n logError(`Parent stream failure, closing worker.`, error);\n }\n self.close();\n });\n\n const commandStream = mux.createStream(SNAP_STREAM_NAMES.COMMAND);\n const rpcStream = mux.createStream(SNAP_STREAM_NAMES.JSON_RPC) as any;\n return new ChildProcessSnapExecutor(commandStream, rpcStream);\n }\n}\n"]}
|
|
@@ -1,8 +0,0 @@
|
|
|
1
|
-
"use strict";
|
|
2
|
-
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
-
const lockdown_more_1 = require("../common/lockdown/lockdown-more");
|
|
4
|
-
const ChildProcessSnapExecutor_1 = require("./ChildProcessSnapExecutor");
|
|
5
|
-
// Lockdown is already applied in LavaMoat
|
|
6
|
-
(0, lockdown_more_1.executeLockdownMore)();
|
|
7
|
-
ChildProcessSnapExecutor_1.ChildProcessSnapExecutor.initialize();
|
|
8
|
-
//# sourceMappingURL=index.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/node-process/index.ts"],"names":[],"mappings":";;AAAA,oEAAuE;AACvE,yEAAsE;AAEtE,0CAA0C;AAC1C,IAAA,mCAAmB,GAAE,CAAC;AAEtB,mDAAwB,CAAC,UAAU,EAAE,CAAC","sourcesContent":["import { executeLockdownMore } from '../common/lockdown/lockdown-more';\nimport { ChildProcessSnapExecutor } from './ChildProcessSnapExecutor';\n\n// Lockdown is already applied in LavaMoat\nexecuteLockdownMore();\n\nChildProcessSnapExecutor.initialize();\n"]}
|
|
@@ -1,30 +0,0 @@
|
|
|
1
|
-
"use strict";
|
|
2
|
-
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
3
|
-
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
4
|
-
};
|
|
5
|
-
Object.defineProperty(exports, "__esModule", { value: true });
|
|
6
|
-
exports.ThreadSnapExecutor = void 0;
|
|
7
|
-
const object_multiplex_1 = __importDefault(require("@metamask/object-multiplex"));
|
|
8
|
-
const post_message_stream_1 = require("@metamask/post-message-stream");
|
|
9
|
-
const snaps_utils_1 = require("@metamask/snaps-utils");
|
|
10
|
-
const pump_1 = __importDefault(require("pump"));
|
|
11
|
-
const BaseSnapExecutor_1 = require("../common/BaseSnapExecutor");
|
|
12
|
-
const logging_1 = require("../logging");
|
|
13
|
-
class ThreadSnapExecutor extends BaseSnapExecutor_1.BaseSnapExecutor {
|
|
14
|
-
static initialize() {
|
|
15
|
-
(0, logging_1.log)('Worker: Connecting to parent.');
|
|
16
|
-
const parentStream = new post_message_stream_1.ThreadMessageStream();
|
|
17
|
-
const mux = new object_multiplex_1.default();
|
|
18
|
-
(0, pump_1.default)(parentStream, mux, parentStream, (error) => {
|
|
19
|
-
if (error) {
|
|
20
|
-
(0, snaps_utils_1.logError)(`Parent stream failure, closing worker.`, error);
|
|
21
|
-
}
|
|
22
|
-
self.close();
|
|
23
|
-
});
|
|
24
|
-
const commandStream = mux.createStream(snaps_utils_1.SNAP_STREAM_NAMES.COMMAND);
|
|
25
|
-
const rpcStream = mux.createStream(snaps_utils_1.SNAP_STREAM_NAMES.JSON_RPC);
|
|
26
|
-
return new ThreadSnapExecutor(commandStream, rpcStream);
|
|
27
|
-
}
|
|
28
|
-
}
|
|
29
|
-
exports.ThreadSnapExecutor = ThreadSnapExecutor;
|
|
30
|
-
//# sourceMappingURL=ThreadSnapExecutor.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"ThreadSnapExecutor.js","sourceRoot":"","sources":["../../src/node-thread/ThreadSnapExecutor.ts"],"names":[],"mappings":";;;;;;AAAA,kFAAyD;AACzD,uEAAoE;AACpE,uDAAoE;AACpE,gDAAwB;AAExB,iEAA8D;AAC9D,wCAAiC;AAEjC,MAAa,kBAAmB,SAAQ,mCAAgB;IACtD,MAAM,CAAC,UAAU;QACf,IAAA,aAAG,EAAC,+BAA+B,CAAC,CAAC;QAErC,MAAM,YAAY,GAAG,IAAI,yCAAmB,EAAE,CAAC;QAC/C,MAAM,GAAG,GAAG,IAAI,0BAAe,EAAE,CAAC;QAClC,IAAA,cAAI,EAAC,YAAY,EAAE,GAAU,EAAE,YAAY,EAAE,CAAC,KAAK,EAAE,EAAE;YACrD,IAAI,KAAK,EAAE;gBACT,IAAA,sBAAQ,EAAC,wCAAwC,EAAE,KAAK,CAAC,CAAC;aAC3D;YACD,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC,CAAC,CAAC;QAEH,MAAM,aAAa,GAAG,GAAG,CAAC,YAAY,CAAC,+BAAiB,CAAC,OAAO,CAAC,CAAC;QAClE,MAAM,SAAS,GAAG,GAAG,CAAC,YAAY,CAAC,+BAAiB,CAAC,QAAQ,CAAQ,CAAC;QACtE,OAAO,IAAI,kBAAkB,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;IAC1D,CAAC;CACF;AAjBD,gDAiBC","sourcesContent":["import ObjectMultiplex from '@metamask/object-multiplex';\nimport { ThreadMessageStream } from '@metamask/post-message-stream';\nimport { logError, SNAP_STREAM_NAMES } from '@metamask/snaps-utils';\nimport pump from 'pump';\n\nimport { BaseSnapExecutor } from '../common/BaseSnapExecutor';\nimport { log } from '../logging';\n\nexport class ThreadSnapExecutor extends BaseSnapExecutor {\n static initialize() {\n log('Worker: Connecting to parent.');\n\n const parentStream = new ThreadMessageStream();\n const mux = new ObjectMultiplex();\n pump(parentStream, mux as any, parentStream, (error) => {\n if (error) {\n logError(`Parent stream failure, closing worker.`, error);\n }\n self.close();\n });\n\n const commandStream = mux.createStream(SNAP_STREAM_NAMES.COMMAND);\n const rpcStream = mux.createStream(SNAP_STREAM_NAMES.JSON_RPC) as any;\n return new ThreadSnapExecutor(commandStream, rpcStream);\n }\n}\n"]}
|
|
@@ -1,8 +0,0 @@
|
|
|
1
|
-
"use strict";
|
|
2
|
-
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
-
const lockdown_more_1 = require("../common/lockdown/lockdown-more");
|
|
4
|
-
const ThreadSnapExecutor_1 = require("./ThreadSnapExecutor");
|
|
5
|
-
// Lockdown is already applied in LavaMoat
|
|
6
|
-
(0, lockdown_more_1.executeLockdownMore)();
|
|
7
|
-
ThreadSnapExecutor_1.ThreadSnapExecutor.initialize();
|
|
8
|
-
//# sourceMappingURL=index.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/node-thread/index.ts"],"names":[],"mappings":";;AAAA,oEAAuE;AACvE,6DAA0D;AAE1D,0CAA0C;AAC1C,IAAA,mCAAmB,GAAE,CAAC;AAEtB,uCAAkB,CAAC,UAAU,EAAE,CAAC","sourcesContent":["import { executeLockdownMore } from '../common/lockdown/lockdown-more';\nimport { ThreadSnapExecutor } from './ThreadSnapExecutor';\n\n// Lockdown is already applied in LavaMoat\nexecuteLockdownMore();\n\nThreadSnapExecutor.initialize();\n"]}
|
|
@@ -1,104 +0,0 @@
|
|
|
1
|
-
"use strict";
|
|
2
|
-
var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
|
|
3
|
-
if (kind === "m") throw new TypeError("Private method is not writable");
|
|
4
|
-
if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
|
|
5
|
-
if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
|
|
6
|
-
return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
|
|
7
|
-
};
|
|
8
|
-
var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
|
|
9
|
-
if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
|
|
10
|
-
if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
|
|
11
|
-
return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
|
|
12
|
-
};
|
|
13
|
-
var _OffscreenSnapExecutor_instances, _OffscreenSnapExecutor_stream, _OffscreenSnapExecutor_onData, _OffscreenSnapExecutor_initializeJob, _OffscreenSnapExecutor_terminateJob;
|
|
14
|
-
Object.defineProperty(exports, "__esModule", { value: true });
|
|
15
|
-
exports.OffscreenSnapExecutor = void 0;
|
|
16
|
-
const post_message_stream_1 = require("@metamask/post-message-stream");
|
|
17
|
-
const snaps_utils_1 = require("@metamask/snaps-utils");
|
|
18
|
-
const utils_1 = require("@metamask/utils");
|
|
19
|
-
/**
|
|
20
|
-
* A snap executor using the Offscreen Documents API.
|
|
21
|
-
*
|
|
22
|
-
* This is not a traditional snap executor, as it does not execute snaps itself.
|
|
23
|
-
* Instead, it creates an iframe window for each snap execution, and sends the
|
|
24
|
-
* snap execution request to the iframe window. The iframe window is responsible
|
|
25
|
-
* for executing the snap.
|
|
26
|
-
*
|
|
27
|
-
* Extensions can only have a single offscreen document, so this executor is
|
|
28
|
-
* persisted between snap executions. The offscreen snap executor essentially
|
|
29
|
-
* acts as a proxy between the extension and the iframe execution environment.
|
|
30
|
-
*
|
|
31
|
-
* @see https://developer.chrome.com/docs/extensions/reference/offscreen/
|
|
32
|
-
*/
|
|
33
|
-
class OffscreenSnapExecutor {
|
|
34
|
-
constructor(stream) {
|
|
35
|
-
_OffscreenSnapExecutor_instances.add(this);
|
|
36
|
-
_OffscreenSnapExecutor_stream.set(this, void 0);
|
|
37
|
-
this.jobs = {};
|
|
38
|
-
__classPrivateFieldSet(this, _OffscreenSnapExecutor_stream, stream, "f");
|
|
39
|
-
__classPrivateFieldGet(this, _OffscreenSnapExecutor_stream, "f").on('data', __classPrivateFieldGet(this, _OffscreenSnapExecutor_instances, "m", _OffscreenSnapExecutor_onData).bind(this));
|
|
40
|
-
}
|
|
41
|
-
/**
|
|
42
|
-
* Initialize the executor with the given stream. This is a wrapper around the
|
|
43
|
-
* constructor.
|
|
44
|
-
*
|
|
45
|
-
* @param stream - The stream to use for communication.
|
|
46
|
-
* @returns The initialized executor.
|
|
47
|
-
*/
|
|
48
|
-
static initialize(stream) {
|
|
49
|
-
return new OffscreenSnapExecutor(stream);
|
|
50
|
-
}
|
|
51
|
-
}
|
|
52
|
-
exports.OffscreenSnapExecutor = OffscreenSnapExecutor;
|
|
53
|
-
_OffscreenSnapExecutor_stream = new WeakMap(), _OffscreenSnapExecutor_instances = new WeakSet(), _OffscreenSnapExecutor_onData = function _OffscreenSnapExecutor_onData(data) {
|
|
54
|
-
const { jobId, extra: { frameUrl }, data: request, } = data;
|
|
55
|
-
if (!this.jobs[jobId]) {
|
|
56
|
-
// This ensures that a job is initialized before it is used. To avoid
|
|
57
|
-
// code duplication, we call the `#onData` method again, which will
|
|
58
|
-
// run the rest of the logic after initialization.
|
|
59
|
-
__classPrivateFieldGet(this, _OffscreenSnapExecutor_instances, "m", _OffscreenSnapExecutor_initializeJob).call(this, jobId, frameUrl)
|
|
60
|
-
.then(() => {
|
|
61
|
-
__classPrivateFieldGet(this, _OffscreenSnapExecutor_instances, "m", _OffscreenSnapExecutor_onData).call(this, data);
|
|
62
|
-
})
|
|
63
|
-
.catch((error) => {
|
|
64
|
-
(0, snaps_utils_1.logError)('[Worker] Error initializing job:', error);
|
|
65
|
-
});
|
|
66
|
-
return;
|
|
67
|
-
}
|
|
68
|
-
// This is a method specific to the `OffscreenSnapExecutor`, as the service
|
|
69
|
-
// itself does not have access to the iframes directly.
|
|
70
|
-
if (request.method === 'terminateJob') {
|
|
71
|
-
__classPrivateFieldGet(this, _OffscreenSnapExecutor_instances, "m", _OffscreenSnapExecutor_terminateJob).call(this, jobId);
|
|
72
|
-
return;
|
|
73
|
-
}
|
|
74
|
-
this.jobs[jobId].stream.write(request);
|
|
75
|
-
}, _OffscreenSnapExecutor_initializeJob =
|
|
76
|
-
/**
|
|
77
|
-
* Create a new iframe and set up a stream to communicate with it.
|
|
78
|
-
*
|
|
79
|
-
* @param jobId - The job ID.
|
|
80
|
-
* @param frameUrl - The URL to load in the iframe.
|
|
81
|
-
*/
|
|
82
|
-
async function _OffscreenSnapExecutor_initializeJob(jobId, frameUrl) {
|
|
83
|
-
const window = await (0, snaps_utils_1.createWindow)(frameUrl, jobId);
|
|
84
|
-
const jobStream = new post_message_stream_1.WindowPostMessageStream({
|
|
85
|
-
name: 'parent',
|
|
86
|
-
target: 'child',
|
|
87
|
-
targetWindow: window,
|
|
88
|
-
targetOrigin: '*',
|
|
89
|
-
});
|
|
90
|
-
// Write messages from the iframe to the parent, wrapped with the job ID.
|
|
91
|
-
jobStream.on('data', (data) => {
|
|
92
|
-
__classPrivateFieldGet(this, _OffscreenSnapExecutor_stream, "f").write({ data, jobId });
|
|
93
|
-
});
|
|
94
|
-
this.jobs[jobId] = { id: jobId, window, stream: jobStream };
|
|
95
|
-
return this.jobs[jobId];
|
|
96
|
-
}, _OffscreenSnapExecutor_terminateJob = function _OffscreenSnapExecutor_terminateJob(jobId) {
|
|
97
|
-
(0, utils_1.assert)(this.jobs[jobId], `Job "${jobId}" not found.`);
|
|
98
|
-
const iframe = document.getElementById(jobId);
|
|
99
|
-
(0, utils_1.assert)(iframe, `Iframe with ID "${jobId}" not found.`);
|
|
100
|
-
iframe.remove();
|
|
101
|
-
this.jobs[jobId].stream.destroy();
|
|
102
|
-
delete this.jobs[jobId];
|
|
103
|
-
};
|
|
104
|
-
//# sourceMappingURL=OffscreenSnapExecutor.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"OffscreenSnapExecutor.js","sourceRoot":"","sources":["../../src/offscreen/OffscreenSnapExecutor.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n BasePostMessageStream,\n WindowPostMessageStream,\n} from '@metamask/post-message-stream';\nimport { createWindow, logError } from '@metamask/snaps-utils';\nimport { JsonRpcRequest, assert } from '@metamask/utils';\n\ntype ExecutorJob = {\n id: string;\n window: Window;\n stream: WindowPostMessageStream;\n};\n\n/**\n * A snap executor using the Offscreen Documents API.\n *\n * This is not a traditional snap executor, as it does not execute snaps itself.\n * Instead, it creates an iframe window for each snap execution, and sends the\n * snap execution request to the iframe window. The iframe window is responsible\n * for executing the snap.\n *\n * Extensions can only have a single offscreen document, so this executor is\n * persisted between snap executions. The offscreen snap executor essentially\n * acts as a proxy between the extension and the iframe execution environment.\n *\n * @see https://developer.chrome.com/docs/extensions/reference/offscreen/\n */\nexport class OffscreenSnapExecutor {\n readonly #stream: BasePostMessageStream;\n\n readonly jobs: Record<string, ExecutorJob> = {};\n\n /**\n * Initialize the executor with the given stream. This is a wrapper around the\n * constructor.\n *\n * @param stream - The stream to use for communication.\n * @returns The initialized executor.\n */\n static initialize(stream: BasePostMessageStream) {\n return new OffscreenSnapExecutor(stream);\n }\n\n constructor(stream: BasePostMessageStream) {\n this.#stream = stream;\n this.#stream.on('data', this.#onData.bind(this));\n }\n\n /**\n * Handle an incoming message from the `OffscreenExecutionService`. This\n * assumes that the message contains a `jobId` property, and a JSON-RPC\n * request in the `data` property.\n *\n * @param data - The message data.\n * @param data.data - The JSON-RPC request.\n * @param data.jobId - The job ID.\n * @param data.extra - Extra data.\n * @param data.extra.frameUrl - The URL to load in the iframe.\n */\n #onData(data: {\n data: JsonRpcRequest;\n jobId: string;\n extra: { frameUrl: string };\n }) {\n const {\n jobId,\n extra: { frameUrl },\n data: request,\n } = data;\n\n if (!this.jobs[jobId]) {\n // This ensures that a job is initialized before it is used. To avoid\n // code duplication, we call the `#onData` method again, which will\n // run the rest of the logic after initialization.\n this.#initializeJob(jobId, frameUrl)\n .then(() => {\n this.#onData(data);\n })\n .catch((error) => {\n logError('[Worker] Error initializing job:', error);\n });\n\n return;\n }\n\n // This is a method specific to the `OffscreenSnapExecutor`, as the service\n // itself does not have access to the iframes directly.\n if (request.method === 'terminateJob') {\n this.#terminateJob(jobId);\n return;\n }\n\n this.jobs[jobId].stream.write(request);\n }\n\n /**\n * Create a new iframe and set up a stream to communicate with it.\n *\n * @param jobId - The job ID.\n * @param frameUrl - The URL to load in the iframe.\n */\n async #initializeJob(jobId: string, frameUrl: string): Promise<ExecutorJob> {\n const window = await createWindow(frameUrl, jobId);\n const jobStream = new WindowPostMessageStream({\n name: 'parent',\n target: 'child',\n targetWindow: window,\n targetOrigin: '*',\n });\n\n // Write messages from the iframe to the parent, wrapped with the job ID.\n jobStream.on('data', (data) => {\n this.#stream.write({ data, jobId });\n });\n\n this.jobs[jobId] = { id: jobId, window, stream: jobStream };\n return this.jobs[jobId];\n }\n\n /**\n * Terminate the job with the given ID. This will close the iframe and delete\n * the job from the internal job map.\n *\n * @param jobId - The job ID.\n */\n #terminateJob(jobId: string) {\n assert(this.jobs[jobId], `Job \"${jobId}\" not found.`);\n\n const iframe = document.getElementById(jobId);\n assert(iframe, `Iframe with ID \"${jobId}\" not found.`);\n\n iframe.remove();\n this.jobs[jobId].stream.destroy();\n delete this.jobs[jobId];\n }\n}\n"]}
|
package/dist/offscreen/index.js
DELETED
|
@@ -1,16 +0,0 @@
|
|
|
1
|
-
"use strict";
|
|
2
|
-
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
-
const post_message_stream_1 = require("@metamask/post-message-stream");
|
|
4
|
-
const lockdown_events_1 = require("../common/lockdown/lockdown-events");
|
|
5
|
-
const lockdown_more_1 = require("../common/lockdown/lockdown-more");
|
|
6
|
-
const OffscreenSnapExecutor_1 = require("./OffscreenSnapExecutor");
|
|
7
|
-
// Lockdown is already applied in LavaMoat
|
|
8
|
-
(0, lockdown_more_1.executeLockdownMore)();
|
|
9
|
-
(0, lockdown_events_1.executeLockdownEvents)();
|
|
10
|
-
// The stream from the offscreen document to the execution service.
|
|
11
|
-
const parentStream = new post_message_stream_1.BrowserRuntimePostMessageStream({
|
|
12
|
-
name: 'child',
|
|
13
|
-
target: 'parent',
|
|
14
|
-
});
|
|
15
|
-
OffscreenSnapExecutor_1.OffscreenSnapExecutor.initialize(parentStream);
|
|
16
|
-
//# sourceMappingURL=index.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/offscreen/index.ts"],"names":[],"mappings":";;AAAA,uEAAgF;AAEhF,wEAA2E;AAC3E,oEAAuE;AACvE,mEAAgE;AAEhE,0CAA0C;AAC1C,IAAA,mCAAmB,GAAE,CAAC;AACtB,IAAA,uCAAqB,GAAE,CAAC;AAExB,mEAAmE;AACnE,MAAM,YAAY,GAAG,IAAI,qDAA+B,CAAC;IACvD,IAAI,EAAE,OAAO;IACb,MAAM,EAAE,QAAQ;CACjB,CAAC,CAAC;AAEH,6CAAqB,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC","sourcesContent":["import { BrowserRuntimePostMessageStream } from '@metamask/post-message-stream';\n\nimport { executeLockdownEvents } from '../common/lockdown/lockdown-events';\nimport { executeLockdownMore } from '../common/lockdown/lockdown-more';\nimport { OffscreenSnapExecutor } from './OffscreenSnapExecutor';\n\n// Lockdown is already applied in LavaMoat\nexecuteLockdownMore();\nexecuteLockdownEvents();\n\n// The stream from the offscreen document to the execution service.\nconst parentStream = new BrowserRuntimePostMessageStream({\n name: 'child',\n target: 'parent',\n});\n\nOffscreenSnapExecutor.initialize(parentStream);\n"]}
|