@metamask/snaps-rpc-methods 16.0.0 → 17.1.0

package/dist/endowments/messenger.mjs

@@ -0,0 +1,85 @@
+import { PermissionType, SubjectType } from "@metamask/permission-controller";
+import { rpcErrors } from "@metamask/rpc-errors";
+import { MessengerScopesStruct, SnapCaveatType } from "@metamask/snaps-utils";
+import { assertStruct, hasProperty, isObject } from "@metamask/utils";
+import { createGenericPermissionValidator } from "./caveats/index.mjs";
+import { SnapEndowments } from "./enum.mjs";
+const permissionName = SnapEndowments.Messenger;
+/**
+ * `endowment:messenger` returns nothing; it is intended to be used as a
+ * flag by the Snaps Platform to detect whether a Snap has the capability to
+ * use the messenger API.
+ *
+ * @param _builderOptions - Optional specification builder options.
+ * @returns The specification for the messenger endowment.
+ */
+const specificationBuilder = (_builderOptions) => {
+    return {
+        permissionType: PermissionType.Endowment,
+        targetName: permissionName,
+        allowedCaveats: [SnapCaveatType.MessengerScopes],
+        endowmentGetter: (_getterOptions) => null,
+        validator: createGenericPermissionValidator([
+            { type: SnapCaveatType.MessengerScopes },
+        ]),
+        subjectTypes: [SubjectType.Snap],
+    };
+};
+export const messengerEndowmentBuilder = Object.freeze({
+    targetName: permissionName,
+    specificationBuilder,
+});
+/**
+ * Map a raw value from the `initialPermissions` to a caveat specification.
+ * Note that this function does not do any validation, that's handled by the
+ * PermissionsController when the permission is requested.
+ *
+ * @param value - The raw value from the `initialPermissions`.
+ * @returns The caveat specification.
+ */
+export function getMessengerCaveatMapper(value) {
+    if (!value || !isObject(value) || Object.keys(value).length === 0) {
+        return { caveats: null };
+    }
+    return {
+        caveats: [
+            {
+                type: SnapCaveatType.MessengerScopes,
+                value,
+            },
+        ],
+    };
+}
+/**
+ * Getter function to get the {@link MessengerActions} caveat value from a
+ * permission.
+ *
+ * @param permission - The permission to get the caveat value from.
+ * @returns The caveat value.
+ */
+export function getMessengerCaveatActions(permission) {
+    const caveat = permission?.caveats?.find((permCaveat) => permCaveat.type === SnapCaveatType.MessengerScopes);
+    return caveat?.value.actions ? caveat.value.actions : null;
+}
+/**
+ * Validates the type of the caveat value.
+ *
+ * @param caveat - The caveat to validate.
+ * @throws If the caveat value is invalid.
+ */
+function validateCaveat(caveat) {
+    if (!hasProperty(caveat, 'value') || !isObject(caveat)) {
+        throw rpcErrors.invalidParams({
+            message: 'Expected an object.',
+        });
+    }
+    const { value } = caveat;
+    assertStruct(value, MessengerScopesStruct, 'Invalid messenger scopes specified', rpcErrors.invalidParams);
+}
+export const messengerCaveatSpecifications = {
+    [SnapCaveatType.MessengerScopes]: Object.freeze({
+        type: SnapCaveatType.MessengerScopes,
+        validator: (caveat) => validateCaveat(caveat),
+    }),
+};
+//# sourceMappingURL=messenger.mjs.map

package/dist/endowments/messenger.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"messenger.mjs","sourceRoot":"","sources":["../../src/endowments/messenger.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,wCAAwC;AAC9E,OAAO,EAAE,SAAS,EAAE,6BAA6B;AAEjD,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,8BAA8B;AAG9E,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,wBAAwB;AAEtE,OAAO,EAAE,gCAAgC,EAAE,4BAAkB;AAC7D,OAAO,EAAE,cAAc,EAAE,mBAAe;AAExC,MAAM,cAAc,GAAG,cAAc,CAAC,SAAS,CAAC;AAWhD;;;;;;;GAOG;AACH,MAAM,oBAAoB,GAItB,CAAC,eAAyB,EAAE,EAAE;IAChC,OAAO;QACL,cAAc,EAAE,cAAc,CAAC,SAAS;QACxC,UAAU,EAAE,cAAc;QAC1B,cAAc,EAAE,CAAC,cAAc,CAAC,eAAe,CAAC;QAChD,eAAe,EAAE,CAAC,cAAsC,EAAE,EAAE,CAAC,IAAI;QACjE,SAAS,EAAE,gCAAgC,CAAC;YAC1C,EAAE,IAAI,EAAE,cAAc,CAAC,eAAe,EAAE;SACzC,CAAC;QACF,YAAY,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC;KACjC,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAC,MAAM,CAAC;IACrD,UAAU,EAAE,cAAc;IAC1B,oBAAoB;CACZ,CAAC,CAAC;AAEZ;;;;;;;GAOG;AACH,MAAM,UAAU,wBAAwB,CACtC,KAAW;IAEX,IAAI,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,cAAc,CAAC,eAAe;gBACpC,KAAK;aACN;SACF;KACF,CAAC;AACJ,CAAC;AAID;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CACvC,UAAiC;IAEjC,MAAM,MAAM,GAAG,UAAU,EAAE,OAAO,EAAE,IAAI,CACtC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,KAAK,cAAc,CAAC,eAAe,CACL,CAAC;IAEhE,OAAO,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7D,CAAC;AAED;;;;;GAKG;AACH,SAAS,cAAc,CAAC,MAA2B;IACjD,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACvD,MAAM,SAAS,CAAC,aAAa,CAAC;YAC5B,OAAO,EAAE,qBAAqB;SAC/B,CAAC,CAAC;IACL,CAAC;IAED,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;IACzB,YAAY,CACV,KAAK,EACL,qBAAqB,EACrB,oCAAoC,EACpC,SAAS,CAAC,aAAa,CACxB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,6BAA6B,GAGtC;IACF,CAAC,cAAc,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC;QAC9C,IAAI,EAAE,cAAc,CAAC,eAAe;QACpC,SAAS,EAAE,CAAC,MAA2B,EAAE,EAAE,CAAC,cAAc,CAAC,MAAM,CAAC;KACnE,CAAC;CACH,CAAC","sourcesContent":["import type {\n  Caveat,\n  CaveatSpecificationConstraint,\n  EndowmentGetterParams,\n  PermissionConstraint,\n  PermissionSpecificationBuilder,\n  PermissionValidatorConstraint,\n  ValidPermissionSpecification,\n} from '@metamask/permission-controller';\nimport { PermissionType, SubjectType } from '@metamask/permission-controller';\nimport { rpcErrors } from '@metamask/rpc-errors';\nimport type { MessengerActionsStruct } from '@metamask/snaps-utils';\nimport { MessengerScopesStruct, SnapCaveatType } from '@metamask/snaps-utils';\nimport type { Infer } from '@metamask/superstruct';\nimport type { Json, NonEmptyArray } from '@metamask/utils';\nimport { assertStruct, hasProperty, isObject } from '@metamask/utils';\n\nimport { createGenericPermissionValidator } from './caveats';\nimport { SnapEndowments } from './enum';\n\nconst permissionName = SnapEndowments.Messenger;\n\ntype MessengerEndowmentSpecification = ValidPermissionSpecification<{\n  permissionType: PermissionType.Endowment;\n  targetName: typeof permissionName;\n  endowmentGetter: (_options?: EndowmentGetterParams) => null;\n  allowedCaveats: Readonly<NonEmptyArray<string>> | null;\n  validator: PermissionValidatorConstraint;\n  subjectTypes: readonly SubjectType[];\n}>;\n\n/**\n * `endowment:messenger` returns nothing; it is intended to be used as a\n * flag by the Snaps Platform to detect whether a Snap has the capability to\n * use the messenger API.\n *\n * @param _builderOptions - Optional specification builder options.\n * @returns The specification for the messenger endowment.\n */\nconst specificationBuilder: PermissionSpecificationBuilder<\n  PermissionType.Endowment,\n  any,\n  MessengerEndowmentSpecification\n> = (_builderOptions?: unknown) => {\n  return {\n    permissionType: PermissionType.Endowment,\n    targetName: permissionName,\n    allowedCaveats: [SnapCaveatType.MessengerScopes],\n    endowmentGetter: (_getterOptions?: EndowmentGetterParams) => null,\n    validator: createGenericPermissionValidator([\n      { type: SnapCaveatType.MessengerScopes },\n    ]),\n    subjectTypes: [SubjectType.Snap],\n  };\n};\n\nexport const messengerEndowmentBuilder = Object.freeze({\n  targetName: permissionName,\n  specificationBuilder,\n} as const);\n\n/**\n * Map a raw value from the `initialPermissions` to a caveat specification.\n * Note that this function does not do any validation, that's handled by the\n * PermissionsController when the permission is requested.\n *\n * @param value - The raw value from the `initialPermissions`.\n * @returns The caveat specification.\n */\nexport function getMessengerCaveatMapper(\n  value: Json,\n): Pick<PermissionConstraint, 'caveats'> {\n  if (!value || !isObject(value) || Object.keys(value).length === 0) {\n    return { caveats: null };\n  }\n\n  return {\n    caveats: [\n      {\n        type: SnapCaveatType.MessengerScopes,\n        value,\n      },\n    ],\n  };\n}\n\nexport type MessengerActions = Infer<typeof MessengerActionsStruct>;\n\n/**\n * Getter function to get the {@link MessengerActions} caveat value from a\n * permission.\n *\n * @param permission - The permission to get the caveat value from.\n * @returns The caveat value.\n */\nexport function getMessengerCaveatActions(\n  permission?: PermissionConstraint,\n): MessengerActions | null {\n  const caveat = permission?.caveats?.find(\n    (permCaveat) => permCaveat.type === SnapCaveatType.MessengerScopes,\n  ) as Caveat<string, { actions?: MessengerActions }> | undefined;\n\n  return caveat?.value.actions ? caveat.value.actions : null;\n}\n\n/**\n * Validates the type of the caveat value.\n *\n * @param caveat - The caveat to validate.\n * @throws If the caveat value is invalid.\n */\nfunction validateCaveat(caveat: Caveat<string, any>): void {\n  if (!hasProperty(caveat, 'value') || !isObject(caveat)) {\n    throw rpcErrors.invalidParams({\n      message: 'Expected an object.',\n    });\n  }\n\n  const { value } = caveat;\n  assertStruct(\n    value,\n    MessengerScopesStruct,\n    'Invalid messenger scopes specified',\n    rpcErrors.invalidParams,\n  );\n}\n\nexport const messengerCaveatSpecifications: Record<\n  SnapCaveatType.MessengerScopes,\n  CaveatSpecificationConstraint\n> = {\n  [SnapCaveatType.MessengerScopes]: Object.freeze({\n    type: SnapCaveatType.MessengerScopes,\n    validator: (caveat: Caveat<string, any>) => validateCaveat(caveat),\n  }),\n};\n"]}

package/dist/permitted/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../src/permitted/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAqFA,mDAA6B","sourcesContent":["import type { CancelBackgroundEventMethodActions } from './cancelBackgroundEvent';\nimport type { ClearStateMethodActions } from './clearState';\nimport type { CloseWebSocketMethodActions } from './closeWebSocket';\nimport type { CreateInterfaceMethodActions } from './createInterface';\nimport type { EndTraceMethodActions, EndTraceMethodHooks } from './endTrace';\nimport type { GetAllSnapsMethodActions } from './getAllSnaps';\nimport type { GetBackgroundEventsMethodActions } from './getBackgroundEvents';\nimport type {\n  GetClientStatusMethodActions,\n  GetClientStatusMethodHooks,\n} from './getClientStatus';\nimport type { GetFileMethodActions } from './getFile';\nimport type { GetInterfaceContextMethodActions } from './getInterfaceContext';\nimport type { GetInterfaceStateMethodActions } from './getInterfaceState';\nimport type { GetSnapsMethodActions } from './getSnaps';\nimport type { GetStateMethodActions, GetStateMethodHooks } from './getState';\nimport type { GetWebSocketsMethodActions } from './getWebSockets';\nimport type {\n  InvokeKeyringMethodActions,\n  InvokeKeyringMethodHooks,\n} from './invokeKeyring';\nimport type { InvokeSnapSugarMethodActions } from './invokeSnapSugar';\nimport type {\n  ListEntropySourcesMethodActions,\n  ListEntropySourcesMethodHooks,\n} from './listEntropySources';\nimport type { OpenWebSocketMethodActions } from './openWebSocket';\nimport type { RequestSnapsMethodActions } from './requestSnaps';\nimport type { ResolveInterfaceMethodActions } from './resolveInterface';\nimport type { ScheduleBackgroundEventMethodActions } from './scheduleBackgroundEvent';\nimport type { SendWebSocketMessageMethodActions } from './sendWebSocketMessage';\nimport type { SetStateMethodActions, SetStateMethodHooks } from './setState';\nimport type {\n  StartTraceMethodActions,\n  StartTraceMethodHooks,\n} from './startTrace';\nimport type {\n  TrackErrorMethodActions,\n  TrackErrorMethodHooks,\n} from './trackError';\nimport type {\n  TrackEventMethodActions,\n  TrackEventMethodHooks,\n} from './trackEvent';\nimport type { UpdateInterfaceMethodActions } from './updateInterface';\n\nexport type PermittedRpcMethodActions =\n  | CancelBackgroundEventMethodActions\n  | ClearStateMethodActions\n  | CloseWebSocketMethodActions\n  | CreateInterfaceMethodActions\n  | EndTraceMethodActions\n  | GetAllSnapsMethodActions\n  | GetBackgroundEventsMethodActions\n  | GetClientStatusMethodActions\n  | GetFileMethodActions\n  | GetInterfaceContextMethodActions\n  | GetInterfaceStateMethodActions\n  | GetSnapsMethodActions\n  | GetStateMethodActions\n  | GetWebSocketsMethodActions\n  | InvokeKeyringMethodActions\n  | InvokeSnapSugarMethodActions\n  | ListEntropySourcesMethodActions\n  | OpenWebSocketMethodActions\n  | RequestSnapsMethodActions\n  | ResolveInterfaceMethodActions\n  | ScheduleBackgroundEventMethodActions\n  | SendWebSocketMessageMethodActions\n  | SetStateMethodActions\n  | StartTraceMethodActions\n  | TrackErrorMethodActions\n  | TrackEventMethodActions\n  | UpdateInterfaceMethodActions;\n\nexport type PermittedRpcMethodHooks = GetClientStatusMethodHooks &\n  GetStateMethodHooks &\n  ListEntropySourcesMethodHooks &\n  SetStateMethodHooks &\n  TrackEventMethodHooks &\n  TrackErrorMethodHooks &\n  StartTraceMethodHooks &\n  EndTraceMethodHooks &\n  InvokeKeyringMethodHooks;\n\nexport * from './middleware';\n"]}
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../src/permitted/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AA2FA,mDAA6B","sourcesContent":["import type { CancelBackgroundEventMethodActions } from './cancelBackgroundEvent';\nimport type { ClearStateMethodActions } from './clearState';\nimport type { CloseWebSocketMethodActions } from './closeWebSocket';\nimport type { CreateInterfaceMethodActions } from './createInterface';\nimport type { EndTraceMethodActions, EndTraceMethodHooks } from './endTrace';\nimport type { GetAllSnapsMethodActions } from './getAllSnaps';\nimport type { GetBackgroundEventsMethodActions } from './getBackgroundEvents';\nimport type {\n  GetClientStatusMethodActions,\n  GetClientStatusMethodHooks,\n} from './getClientStatus';\nimport type { GetFileMethodActions } from './getFile';\nimport type { GetInterfaceContextMethodActions } from './getInterfaceContext';\nimport type { GetInterfaceStateMethodActions } from './getInterfaceState';\nimport type { GetSnapsMethodActions } from './getSnaps';\nimport type { GetStateMethodActions, GetStateMethodHooks } from './getState';\nimport type { GetWebSocketsMethodActions } from './getWebSockets';\nimport type {\n  InvokeKeyringMethodActions,\n  InvokeKeyringMethodHooks,\n} from './invokeKeyring';\nimport type { InvokeSnapSugarMethodActions } from './invokeSnapSugar';\nimport type {\n  ListEntropySourcesMethodActions,\n  ListEntropySourcesMethodHooks,\n} from './listEntropySources';\nimport type {\n  MessengerCallMethodActions,\n  MessengerCallMethodHooks,\n} from './messengerCall';\nimport type { OpenWebSocketMethodActions } from './openWebSocket';\nimport type { RequestSnapsMethodActions } from './requestSnaps';\nimport type { ResolveInterfaceMethodActions } from './resolveInterface';\nimport type { ScheduleBackgroundEventMethodActions } from './scheduleBackgroundEvent';\nimport type { SendWebSocketMessageMethodActions } from './sendWebSocketMessage';\nimport type { SetStateMethodActions, SetStateMethodHooks } from './setState';\nimport type {\n  StartTraceMethodActions,\n  StartTraceMethodHooks,\n} from './startTrace';\nimport type {\n  TrackErrorMethodActions,\n  TrackErrorMethodHooks,\n} from './trackError';\nimport type {\n  TrackEventMethodActions,\n  TrackEventMethodHooks,\n} from './trackEvent';\nimport type { UpdateInterfaceMethodActions } from './updateInterface';\n\nexport type PermittedRpcMethodActions =\n  | CancelBackgroundEventMethodActions\n  | ClearStateMethodActions\n  | CloseWebSocketMethodActions\n  | CreateInterfaceMethodActions\n  | EndTraceMethodActions\n  | GetAllSnapsMethodActions\n  | GetBackgroundEventsMethodActions\n  | GetClientStatusMethodActions\n  | GetFileMethodActions\n  | GetInterfaceContextMethodActions\n  | GetInterfaceStateMethodActions\n  | GetSnapsMethodActions\n  | GetStateMethodActions\n  | GetWebSocketsMethodActions\n  | InvokeKeyringMethodActions\n  | InvokeSnapSugarMethodActions\n  | ListEntropySourcesMethodActions\n  | OpenWebSocketMethodActions\n  | RequestSnapsMethodActions\n  | ResolveInterfaceMethodActions\n  | ScheduleBackgroundEventMethodActions\n  | SendWebSocketMessageMethodActions\n  | SetStateMethodActions\n  | StartTraceMethodActions\n  | TrackErrorMethodActions\n  | TrackEventMethodActions\n  | UpdateInterfaceMethodActions\n  | MessengerCallMethodActions;\n\nexport type PermittedRpcMethodHooks = GetClientStatusMethodHooks &\n  GetStateMethodHooks &\n  ListEntropySourcesMethodHooks &\n  SetStateMethodHooks &\n  TrackEventMethodHooks &\n  TrackErrorMethodHooks &\n  StartTraceMethodHooks &\n  EndTraceMethodHooks &\n  InvokeKeyringMethodHooks &\n  MessengerCallMethodHooks;\n\nexport * from './middleware';\n"]}

package/dist/permitted/index.d.cts

@@ -15,6 +15,7 @@ import type { GetWebSocketsMethodActions } from "./getWebSockets.cjs";
 import type { InvokeKeyringMethodActions, InvokeKeyringMethodHooks } from "./invokeKeyring.cjs";
 import type { InvokeSnapSugarMethodActions } from "./invokeSnapSugar.cjs";
 import type { ListEntropySourcesMethodActions, ListEntropySourcesMethodHooks } from "./listEntropySources.cjs";
+import type { MessengerCallMethodActions, MessengerCallMethodHooks } from "./messengerCall.cjs";
 import type { OpenWebSocketMethodActions } from "./openWebSocket.cjs";
 import type { RequestSnapsMethodActions } from "./requestSnaps.cjs";
 import type { ResolveInterfaceMethodActions } from "./resolveInterface.cjs";
@@ -25,7 +26,7 @@ import type { StartTraceMethodActions, StartTraceMethodHooks } from "./startTrac
 import type { TrackErrorMethodActions, TrackErrorMethodHooks } from "./trackError.cjs";
 import type { TrackEventMethodActions, TrackEventMethodHooks } from "./trackEvent.cjs";
 import type { UpdateInterfaceMethodActions } from "./updateInterface.cjs";
-export type PermittedRpcMethodActions = CancelBackgroundEventMethodActions | ClearStateMethodActions | CloseWebSocketMethodActions | CreateInterfaceMethodActions | EndTraceMethodActions | GetAllSnapsMethodActions | GetBackgroundEventsMethodActions | GetClientStatusMethodActions | GetFileMethodActions | GetInterfaceContextMethodActions | GetInterfaceStateMethodActions | GetSnapsMethodActions | GetStateMethodActions | GetWebSocketsMethodActions | InvokeKeyringMethodActions | InvokeSnapSugarMethodActions | ListEntropySourcesMethodActions | OpenWebSocketMethodActions | RequestSnapsMethodActions | ResolveInterfaceMethodActions | ScheduleBackgroundEventMethodActions | SendWebSocketMessageMethodActions | SetStateMethodActions | StartTraceMethodActions | TrackErrorMethodActions | TrackEventMethodActions | UpdateInterfaceMethodActions;
-export type PermittedRpcMethodHooks = GetClientStatusMethodHooks & GetStateMethodHooks & ListEntropySourcesMethodHooks & SetStateMethodHooks & TrackEventMethodHooks & TrackErrorMethodHooks & StartTraceMethodHooks & EndTraceMethodHooks & InvokeKeyringMethodHooks;
+export type PermittedRpcMethodActions = CancelBackgroundEventMethodActions | ClearStateMethodActions | CloseWebSocketMethodActions | CreateInterfaceMethodActions | EndTraceMethodActions | GetAllSnapsMethodActions | GetBackgroundEventsMethodActions | GetClientStatusMethodActions | GetFileMethodActions | GetInterfaceContextMethodActions | GetInterfaceStateMethodActions | GetSnapsMethodActions | GetStateMethodActions | GetWebSocketsMethodActions | InvokeKeyringMethodActions | InvokeSnapSugarMethodActions | ListEntropySourcesMethodActions | OpenWebSocketMethodActions | RequestSnapsMethodActions | ResolveInterfaceMethodActions | ScheduleBackgroundEventMethodActions | SendWebSocketMessageMethodActions | SetStateMethodActions | StartTraceMethodActions | TrackErrorMethodActions | TrackEventMethodActions | UpdateInterfaceMethodActions | MessengerCallMethodActions;
+export type PermittedRpcMethodHooks = GetClientStatusMethodHooks & GetStateMethodHooks & ListEntropySourcesMethodHooks & SetStateMethodHooks & TrackEventMethodHooks & TrackErrorMethodHooks & StartTraceMethodHooks & EndTraceMethodHooks & InvokeKeyringMethodHooks & MessengerCallMethodHooks;
 export * from "./middleware.cjs";
 //# sourceMappingURL=index.d.cts.map

package/dist/permitted/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../src/permitted/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kCAAkC,EAAE,oCAAgC;AAClF,OAAO,KAAK,EAAE,uBAAuB,EAAE,yBAAqB;AAC5D,OAAO,KAAK,EAAE,2BAA2B,EAAE,6BAAyB;AACpE,OAAO,KAAK,EAAE,4BAA4B,EAAE,8BAA0B;AACtE,OAAO,KAAK,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,uBAAmB;AAC7E,OAAO,KAAK,EAAE,wBAAwB,EAAE,0BAAsB;AAC9D,OAAO,KAAK,EAAE,gCAAgC,EAAE,kCAA8B;AAC9E,OAAO,KAAK,EACV,4BAA4B,EAC5B,0BAA0B,EAC3B,8BAA0B;AAC3B,OAAO,KAAK,EAAE,oBAAoB,EAAE,sBAAkB;AACtD,OAAO,KAAK,EAAE,gCAAgC,EAAE,kCAA8B;AAC9E,OAAO,KAAK,EAAE,8BAA8B,EAAE,gCAA4B;AAC1E,OAAO,KAAK,EAAE,qBAAqB,EAAE,uBAAmB;AACxD,OAAO,KAAK,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,uBAAmB;AAC7E,OAAO,KAAK,EAAE,0BAA0B,EAAE,4BAAwB;AAClE,OAAO,KAAK,EACV,0BAA0B,EAC1B,wBAAwB,EACzB,4BAAwB;AACzB,OAAO,KAAK,EAAE,4BAA4B,EAAE,8BAA0B;AACtE,OAAO,KAAK,EACV,+BAA+B,EAC/B,6BAA6B,EAC9B,iCAA6B;AAC9B,OAAO,KAAK,EAAE,0BAA0B,EAAE,4BAAwB;AAClE,OAAO,KAAK,EAAE,yBAAyB,EAAE,2BAAuB;AAChE,OAAO,KAAK,EAAE,6BAA6B,EAAE,+BAA2B;AACxE,OAAO,KAAK,EAAE,oCAAoC,EAAE,sCAAkC;AACtF,OAAO,KAAK,EAAE,iCAAiC,EAAE,mCAA+B;AAChF,OAAO,KAAK,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,uBAAmB;AAC7E,OAAO,KAAK,EACV,uBAAuB,EACvB,qBAAqB,EACtB,yBAAqB;AACtB,OAAO,KAAK,EACV,uBAAuB,EACvB,qBAAqB,EACtB,yBAAqB;AACtB,OAAO,KAAK,EACV,uBAAuB,EACvB,qBAAqB,EACtB,yBAAqB;AACtB,OAAO,KAAK,EAAE,4BAA4B,EAAE,8BAA0B;AAEtE,MAAM,MAAM,yBAAyB,GACjC,kCAAkC,GAClC,uBAAuB,GACvB,2BAA2B,GAC3B,4BAA4B,GAC5B,qBAAqB,GACrB,wBAAwB,GACxB,gCAAgC,GAChC,4BAA4B,GAC5B,oBAAoB,GACpB,gCAAgC,GAChC,8BAA8B,GAC9B,qBAAqB,GACrB,qBAAqB,GACrB,0BAA0B,GAC1B,0BAA0B,GAC1B,4BAA4B,GAC5B,+BAA+B,GAC/B,0BAA0B,GAC1B,yBAAyB,GACzB,6BAA6B,GAC7B,oCAAoC,GACpC,iCAAiC,GACjC,qBAAqB,GACrB,uBAAuB,GACvB,uBAAuB,GACvB,uBAAuB,GACvB,4BAA4B,CAAC;AAEjC,MAAM,MAAM,uBAAuB,GAAG,0BAA0B,GAC9D,mBAAmB,GACnB,6BAA6B,GAC7B,mBAAmB,GACnB,qBAAqB,GACrB,qBAAqB,GACrB,qBAAqB,GACrB,mBAAmB,GACnB,wBAAwB,CAAC;AAE3B,iCAA6B"}
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../src/permitted/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kCAAkC,EAAE,oCAAgC;AAClF,OAAO,KAAK,EAAE,uBAAuB,EAAE,yBAAqB;AAC5D,OAAO,KAAK,EAAE,2BAA2B,EAAE,6BAAyB;AACpE,OAAO,KAAK,EAAE,4BAA4B,EAAE,8BAA0B;AACtE,OAAO,KAAK,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,uBAAmB;AAC7E,OAAO,KAAK,EAAE,wBAAwB,EAAE,0BAAsB;AAC9D,OAAO,KAAK,EAAE,gCAAgC,EAAE,kCAA8B;AAC9E,OAAO,KAAK,EACV,4BAA4B,EAC5B,0BAA0B,EAC3B,8BAA0B;AAC3B,OAAO,KAAK,EAAE,oBAAoB,EAAE,sBAAkB;AACtD,OAAO,KAAK,EAAE,gCAAgC,EAAE,kCAA8B;AAC9E,OAAO,KAAK,EAAE,8BAA8B,EAAE,gCAA4B;AAC1E,OAAO,KAAK,EAAE,qBAAqB,EAAE,uBAAmB;AACxD,OAAO,KAAK,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,uBAAmB;AAC7E,OAAO,KAAK,EAAE,0BAA0B,EAAE,4BAAwB;AAClE,OAAO,KAAK,EACV,0BAA0B,EAC1B,wBAAwB,EACzB,4BAAwB;AACzB,OAAO,KAAK,EAAE,4BAA4B,EAAE,8BAA0B;AACtE,OAAO,KAAK,EACV,+BAA+B,EAC/B,6BAA6B,EAC9B,iCAA6B;AAC9B,OAAO,KAAK,EACV,0BAA0B,EAC1B,wBAAwB,EACzB,4BAAwB;AACzB,OAAO,KAAK,EAAE,0BAA0B,EAAE,4BAAwB;AAClE,OAAO,KAAK,EAAE,yBAAyB,EAAE,2BAAuB;AAChE,OAAO,KAAK,EAAE,6BAA6B,EAAE,+BAA2B;AACxE,OAAO,KAAK,EAAE,oCAAoC,EAAE,sCAAkC;AACtF,OAAO,KAAK,EAAE,iCAAiC,EAAE,mCAA+B;AAChF,OAAO,KAAK,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,uBAAmB;AAC7E,OAAO,KAAK,EACV,uBAAuB,EACvB,qBAAqB,EACtB,yBAAqB;AACtB,OAAO,KAAK,EACV,uBAAuB,EACvB,qBAAqB,EACtB,yBAAqB;AACtB,OAAO,KAAK,EACV,uBAAuB,EACvB,qBAAqB,EACtB,yBAAqB;AACtB,OAAO,KAAK,EAAE,4BAA4B,EAAE,8BAA0B;AAEtE,MAAM,MAAM,yBAAyB,GACjC,kCAAkC,GAClC,uBAAuB,GACvB,2BAA2B,GAC3B,4BAA4B,GAC5B,qBAAqB,GACrB,wBAAwB,GACxB,gCAAgC,GAChC,4BAA4B,GAC5B,oBAAoB,GACpB,gCAAgC,GAChC,8BAA8B,GAC9B,qBAAqB,GACrB,qBAAqB,GACrB,0BAA0B,GAC1B,0BAA0B,GAC1B,4BAA4B,GAC5B,+BAA+B,GAC/B,0BAA0B,GAC1B,yBAAyB,GACzB,6BAA6B,GAC7B,oCAAoC,GACpC,iCAAiC,GACjC,qBAAqB,GACrB,uBAAuB,GACvB,uBAAuB,GACvB,uBAAuB,GACvB,4BAA4B,GAC5B,0BAA0B,CAAC;AAE/B,MAAM,MAAM,uBAAuB,GAAG,0BAA0B,GAC9D,mBAAmB,GACnB,6BAA6B,GAC7B,mBAAmB,GACnB,qBAAqB,GACrB,qBAAqB,GACrB,qBAAqB,GACrB,mBAAmB,GACnB,wBAAwB,GACxB,wBAAwB,CAAC;AAE3B,iCAA6B"}

package/dist/permitted/index.d.mts

@@ -15,6 +15,7 @@ import type { GetWebSocketsMethodActions } from "./getWebSockets.mjs";
 import type { InvokeKeyringMethodActions, InvokeKeyringMethodHooks } from "./invokeKeyring.mjs";
 import type { InvokeSnapSugarMethodActions } from "./invokeSnapSugar.mjs";
 import type { ListEntropySourcesMethodActions, ListEntropySourcesMethodHooks } from "./listEntropySources.mjs";
+import type { MessengerCallMethodActions, MessengerCallMethodHooks } from "./messengerCall.mjs";
 import type { OpenWebSocketMethodActions } from "./openWebSocket.mjs";
 import type { RequestSnapsMethodActions } from "./requestSnaps.mjs";
 import type { ResolveInterfaceMethodActions } from "./resolveInterface.mjs";
@@ -25,7 +26,7 @@ import type { StartTraceMethodActions, StartTraceMethodHooks } from "./startTrac
 import type { TrackErrorMethodActions, TrackErrorMethodHooks } from "./trackError.mjs";
 import type { TrackEventMethodActions, TrackEventMethodHooks } from "./trackEvent.mjs";
 import type { UpdateInterfaceMethodActions } from "./updateInterface.mjs";
-export type PermittedRpcMethodActions = CancelBackgroundEventMethodActions | ClearStateMethodActions | CloseWebSocketMethodActions | CreateInterfaceMethodActions | EndTraceMethodActions | GetAllSnapsMethodActions | GetBackgroundEventsMethodActions | GetClientStatusMethodActions | GetFileMethodActions | GetInterfaceContextMethodActions | GetInterfaceStateMethodActions | GetSnapsMethodActions | GetStateMethodActions | GetWebSocketsMethodActions | InvokeKeyringMethodActions | InvokeSnapSugarMethodActions | ListEntropySourcesMethodActions | OpenWebSocketMethodActions | RequestSnapsMethodActions | ResolveInterfaceMethodActions | ScheduleBackgroundEventMethodActions | SendWebSocketMessageMethodActions | SetStateMethodActions | StartTraceMethodActions | TrackErrorMethodActions | TrackEventMethodActions | UpdateInterfaceMethodActions;
-export type PermittedRpcMethodHooks = GetClientStatusMethodHooks & GetStateMethodHooks & ListEntropySourcesMethodHooks & SetStateMethodHooks & TrackEventMethodHooks & TrackErrorMethodHooks & StartTraceMethodHooks & EndTraceMethodHooks & InvokeKeyringMethodHooks;
+export type PermittedRpcMethodActions = CancelBackgroundEventMethodActions | ClearStateMethodActions | CloseWebSocketMethodActions | CreateInterfaceMethodActions | EndTraceMethodActions | GetAllSnapsMethodActions | GetBackgroundEventsMethodActions | GetClientStatusMethodActions | GetFileMethodActions | GetInterfaceContextMethodActions | GetInterfaceStateMethodActions | GetSnapsMethodActions | GetStateMethodActions | GetWebSocketsMethodActions | InvokeKeyringMethodActions | InvokeSnapSugarMethodActions | ListEntropySourcesMethodActions | OpenWebSocketMethodActions | RequestSnapsMethodActions | ResolveInterfaceMethodActions | ScheduleBackgroundEventMethodActions | SendWebSocketMessageMethodActions | SetStateMethodActions | StartTraceMethodActions | TrackErrorMethodActions | TrackEventMethodActions | UpdateInterfaceMethodActions | MessengerCallMethodActions;
+export type PermittedRpcMethodHooks = GetClientStatusMethodHooks & GetStateMethodHooks & ListEntropySourcesMethodHooks & SetStateMethodHooks & TrackEventMethodHooks & TrackErrorMethodHooks & StartTraceMethodHooks & EndTraceMethodHooks & InvokeKeyringMethodHooks & MessengerCallMethodHooks;
 export * from "./middleware.mjs";
 //# sourceMappingURL=index.d.mts.map

package/dist/permitted/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/permitted/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kCAAkC,EAAE,oCAAgC;AAClF,OAAO,KAAK,EAAE,uBAAuB,EAAE,yBAAqB;AAC5D,OAAO,KAAK,EAAE,2BAA2B,EAAE,6BAAyB;AACpE,OAAO,KAAK,EAAE,4BAA4B,EAAE,8BAA0B;AACtE,OAAO,KAAK,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,uBAAmB;AAC7E,OAAO,KAAK,EAAE,wBAAwB,EAAE,0BAAsB;AAC9D,OAAO,KAAK,EAAE,gCAAgC,EAAE,kCAA8B;AAC9E,OAAO,KAAK,EACV,4BAA4B,EAC5B,0BAA0B,EAC3B,8BAA0B;AAC3B,OAAO,KAAK,EAAE,oBAAoB,EAAE,sBAAkB;AACtD,OAAO,KAAK,EAAE,gCAAgC,EAAE,kCAA8B;AAC9E,OAAO,KAAK,EAAE,8BAA8B,EAAE,gCAA4B;AAC1E,OAAO,KAAK,EAAE,qBAAqB,EAAE,uBAAmB;AACxD,OAAO,KAAK,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,uBAAmB;AAC7E,OAAO,KAAK,EAAE,0BAA0B,EAAE,4BAAwB;AAClE,OAAO,KAAK,EACV,0BAA0B,EAC1B,wBAAwB,EACzB,4BAAwB;AACzB,OAAO,KAAK,EAAE,4BAA4B,EAAE,8BAA0B;AACtE,OAAO,KAAK,EACV,+BAA+B,EAC/B,6BAA6B,EAC9B,iCAA6B;AAC9B,OAAO,KAAK,EAAE,0BAA0B,EAAE,4BAAwB;AAClE,OAAO,KAAK,EAAE,yBAAyB,EAAE,2BAAuB;AAChE,OAAO,KAAK,EAAE,6BAA6B,EAAE,+BAA2B;AACxE,OAAO,KAAK,EAAE,oCAAoC,EAAE,sCAAkC;AACtF,OAAO,KAAK,EAAE,iCAAiC,EAAE,mCAA+B;AAChF,OAAO,KAAK,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,uBAAmB;AAC7E,OAAO,KAAK,EACV,uBAAuB,EACvB,qBAAqB,EACtB,yBAAqB;AACtB,OAAO,KAAK,EACV,uBAAuB,EACvB,qBAAqB,EACtB,yBAAqB;AACtB,OAAO,KAAK,EACV,uBAAuB,EACvB,qBAAqB,EACtB,yBAAqB;AACtB,OAAO,KAAK,EAAE,4BAA4B,EAAE,8BAA0B;AAEtE,MAAM,MAAM,yBAAyB,GACjC,kCAAkC,GAClC,uBAAuB,GACvB,2BAA2B,GAC3B,4BAA4B,GAC5B,qBAAqB,GACrB,wBAAwB,GACxB,gCAAgC,GAChC,4BAA4B,GAC5B,oBAAoB,GACpB,gCAAgC,GAChC,8BAA8B,GAC9B,qBAAqB,GACrB,qBAAqB,GACrB,0BAA0B,GAC1B,0BAA0B,GAC1B,4BAA4B,GAC5B,+BAA+B,GAC/B,0BAA0B,GAC1B,yBAAyB,GACzB,6BAA6B,GAC7B,oCAAoC,GACpC,iCAAiC,GACjC,qBAAqB,GACrB,uBAAuB,GACvB,uBAAuB,GACvB,uBAAuB,GACvB,4BAA4B,CAAC;AAEjC,MAAM,MAAM,uBAAuB,GAAG,0BAA0B,GAC9D,mBAAmB,GACnB,6BAA6B,GAC7B,mBAAmB,GACnB,qBAAqB,GACrB,qBAAqB,GACrB,qBAAqB,GACrB,mBAAmB,GACnB,wBAAwB,CAAC;AAE3B,iCAA6B"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/permitted/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kCAAkC,EAAE,oCAAgC;AAClF,OAAO,KAAK,EAAE,uBAAuB,EAAE,yBAAqB;AAC5D,OAAO,KAAK,EAAE,2BAA2B,EAAE,6BAAyB;AACpE,OAAO,KAAK,EAAE,4BAA4B,EAAE,8BAA0B;AACtE,OAAO,KAAK,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,uBAAmB;AAC7E,OAAO,KAAK,EAAE,wBAAwB,EAAE,0BAAsB;AAC9D,OAAO,KAAK,EAAE,gCAAgC,EAAE,kCAA8B;AAC9E,OAAO,KAAK,EACV,4BAA4B,EAC5B,0BAA0B,EAC3B,8BAA0B;AAC3B,OAAO,KAAK,EAAE,oBAAoB,EAAE,sBAAkB;AACtD,OAAO,KAAK,EAAE,gCAAgC,EAAE,kCAA8B;AAC9E,OAAO,KAAK,EAAE,8BAA8B,EAAE,gCAA4B;AAC1E,OAAO,KAAK,EAAE,qBAAqB,EAAE,uBAAmB;AACxD,OAAO,KAAK,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,uBAAmB;AAC7E,OAAO,KAAK,EAAE,0BAA0B,EAAE,4BAAwB;AAClE,OAAO,KAAK,EACV,0BAA0B,EAC1B,wBAAwB,EACzB,4BAAwB;AACzB,OAAO,KAAK,EAAE,4BAA4B,EAAE,8BAA0B;AACtE,OAAO,KAAK,EACV,+BAA+B,EAC/B,6BAA6B,EAC9B,iCAA6B;AAC9B,OAAO,KAAK,EACV,0BAA0B,EAC1B,wBAAwB,EACzB,4BAAwB;AACzB,OAAO,KAAK,EAAE,0BAA0B,EAAE,4BAAwB;AAClE,OAAO,KAAK,EAAE,yBAAyB,EAAE,2BAAuB;AAChE,OAAO,KAAK,EAAE,6BAA6B,EAAE,+BAA2B;AACxE,OAAO,KAAK,EAAE,oCAAoC,EAAE,sCAAkC;AACtF,OAAO,KAAK,EAAE,iCAAiC,EAAE,mCAA+B;AAChF,OAAO,KAAK,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,uBAAmB;AAC7E,OAAO,KAAK,EACV,uBAAuB,EACvB,qBAAqB,EACtB,yBAAqB;AACtB,OAAO,KAAK,EACV,uBAAuB,EACvB,qBAAqB,EACtB,yBAAqB;AACtB,OAAO,KAAK,EACV,uBAAuB,EACvB,qBAAqB,EACtB,yBAAqB;AACtB,OAAO,KAAK,EAAE,4BAA4B,EAAE,8BAA0B;AAEtE,MAAM,MAAM,yBAAyB,GACjC,kCAAkC,GAClC,uBAAuB,GACvB,2BAA2B,GAC3B,4BAA4B,GAC5B,qBAAqB,GACrB,wBAAwB,GACxB,gCAAgC,GAChC,4BAA4B,GAC5B,oBAAoB,GACpB,gCAAgC,GAChC,8BAA8B,GAC9B,qBAAqB,GACrB,qBAAqB,GACrB,0BAA0B,GAC1B,0BAA0B,GAC1B,4BAA4B,GAC5B,+BAA+B,GAC/B,0BAA0B,GAC1B,yBAAyB,GACzB,6BAA6B,GAC7B,oCAAoC,GACpC,iCAAiC,GACjC,qBAAqB,GACrB,uBAAuB,GACvB,uBAAuB,GACvB,uBAAuB,GACvB,4BAA4B,GAC5B,0BAA0B,CAAC;AAE/B,MAAM,MAAM,uBAAuB,GAAG,0BAA0B,GAC9D,mBAAmB,GACnB,6BAA6B,GAC7B,mBAAmB,GACnB,qBAAqB,GACrB,qBAAqB,GACrB,qBAAqB,GACrB,mBAAmB,GACnB,wBAAwB,GACxB,wBAAwB,CAAC;AAE3B,iCAA6B"}

package/dist/permitted/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/permitted/index.ts"],"names":[],"mappings":"AAqFA,iCAA6B","sourcesContent":["import type { CancelBackgroundEventMethodActions } from './cancelBackgroundEvent';\nimport type { ClearStateMethodActions } from './clearState';\nimport type { CloseWebSocketMethodActions } from './closeWebSocket';\nimport type { CreateInterfaceMethodActions } from './createInterface';\nimport type { EndTraceMethodActions, EndTraceMethodHooks } from './endTrace';\nimport type { GetAllSnapsMethodActions } from './getAllSnaps';\nimport type { GetBackgroundEventsMethodActions } from './getBackgroundEvents';\nimport type {\n  GetClientStatusMethodActions,\n  GetClientStatusMethodHooks,\n} from './getClientStatus';\nimport type { GetFileMethodActions } from './getFile';\nimport type { GetInterfaceContextMethodActions } from './getInterfaceContext';\nimport type { GetInterfaceStateMethodActions } from './getInterfaceState';\nimport type { GetSnapsMethodActions } from './getSnaps';\nimport type { GetStateMethodActions, GetStateMethodHooks } from './getState';\nimport type { GetWebSocketsMethodActions } from './getWebSockets';\nimport type {\n  InvokeKeyringMethodActions,\n  InvokeKeyringMethodHooks,\n} from './invokeKeyring';\nimport type { InvokeSnapSugarMethodActions } from './invokeSnapSugar';\nimport type {\n  ListEntropySourcesMethodActions,\n  ListEntropySourcesMethodHooks,\n} from './listEntropySources';\nimport type { OpenWebSocketMethodActions } from './openWebSocket';\nimport type { RequestSnapsMethodActions } from './requestSnaps';\nimport type { ResolveInterfaceMethodActions } from './resolveInterface';\nimport type { ScheduleBackgroundEventMethodActions } from './scheduleBackgroundEvent';\nimport type { SendWebSocketMessageMethodActions } from './sendWebSocketMessage';\nimport type { SetStateMethodActions, SetStateMethodHooks } from './setState';\nimport type {\n  StartTraceMethodActions,\n  StartTraceMethodHooks,\n} from './startTrace';\nimport type {\n  TrackErrorMethodActions,\n  TrackErrorMethodHooks,\n} from './trackError';\nimport type {\n  TrackEventMethodActions,\n  TrackEventMethodHooks,\n} from './trackEvent';\nimport type { UpdateInterfaceMethodActions } from './updateInterface';\n\nexport type PermittedRpcMethodActions =\n  | CancelBackgroundEventMethodActions\n  | ClearStateMethodActions\n  | CloseWebSocketMethodActions\n  | CreateInterfaceMethodActions\n  | EndTraceMethodActions\n  | GetAllSnapsMethodActions\n  | GetBackgroundEventsMethodActions\n  | GetClientStatusMethodActions\n  | GetFileMethodActions\n  | GetInterfaceContextMethodActions\n  | GetInterfaceStateMethodActions\n  | GetSnapsMethodActions\n  | GetStateMethodActions\n  | GetWebSocketsMethodActions\n  | InvokeKeyringMethodActions\n  | InvokeSnapSugarMethodActions\n  | ListEntropySourcesMethodActions\n  | OpenWebSocketMethodActions\n  | RequestSnapsMethodActions\n  | ResolveInterfaceMethodActions\n  | ScheduleBackgroundEventMethodActions\n  | SendWebSocketMessageMethodActions\n  | SetStateMethodActions\n  | StartTraceMethodActions\n  | TrackErrorMethodActions\n  | TrackEventMethodActions\n  | UpdateInterfaceMethodActions;\n\nexport type PermittedRpcMethodHooks = GetClientStatusMethodHooks &\n  GetStateMethodHooks &\n  ListEntropySourcesMethodHooks &\n  SetStateMethodHooks &\n  TrackEventMethodHooks &\n  TrackErrorMethodHooks &\n  StartTraceMethodHooks &\n  EndTraceMethodHooks &\n  InvokeKeyringMethodHooks;\n\nexport * from './middleware';\n"]}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/permitted/index.ts"],"names":[],"mappings":"AA2FA,iCAA6B","sourcesContent":["import type { CancelBackgroundEventMethodActions } from './cancelBackgroundEvent';\nimport type { ClearStateMethodActions } from './clearState';\nimport type { CloseWebSocketMethodActions } from './closeWebSocket';\nimport type { CreateInterfaceMethodActions } from './createInterface';\nimport type { EndTraceMethodActions, EndTraceMethodHooks } from './endTrace';\nimport type { GetAllSnapsMethodActions } from './getAllSnaps';\nimport type { GetBackgroundEventsMethodActions } from './getBackgroundEvents';\nimport type {\n  GetClientStatusMethodActions,\n  GetClientStatusMethodHooks,\n} from './getClientStatus';\nimport type { GetFileMethodActions } from './getFile';\nimport type { GetInterfaceContextMethodActions } from './getInterfaceContext';\nimport type { GetInterfaceStateMethodActions } from './getInterfaceState';\nimport type { GetSnapsMethodActions } from './getSnaps';\nimport type { GetStateMethodActions, GetStateMethodHooks } from './getState';\nimport type { GetWebSocketsMethodActions } from './getWebSockets';\nimport type {\n  InvokeKeyringMethodActions,\n  InvokeKeyringMethodHooks,\n} from './invokeKeyring';\nimport type { InvokeSnapSugarMethodActions } from './invokeSnapSugar';\nimport type {\n  ListEntropySourcesMethodActions,\n  ListEntropySourcesMethodHooks,\n} from './listEntropySources';\nimport type {\n  MessengerCallMethodActions,\n  MessengerCallMethodHooks,\n} from './messengerCall';\nimport type { OpenWebSocketMethodActions } from './openWebSocket';\nimport type { RequestSnapsMethodActions } from './requestSnaps';\nimport type { ResolveInterfaceMethodActions } from './resolveInterface';\nimport type { ScheduleBackgroundEventMethodActions } from './scheduleBackgroundEvent';\nimport type { SendWebSocketMessageMethodActions } from './sendWebSocketMessage';\nimport type { SetStateMethodActions, SetStateMethodHooks } from './setState';\nimport type {\n  StartTraceMethodActions,\n  StartTraceMethodHooks,\n} from './startTrace';\nimport type {\n  TrackErrorMethodActions,\n  TrackErrorMethodHooks,\n} from './trackError';\nimport type {\n  TrackEventMethodActions,\n  TrackEventMethodHooks,\n} from './trackEvent';\nimport type { UpdateInterfaceMethodActions } from './updateInterface';\n\nexport type PermittedRpcMethodActions =\n  | CancelBackgroundEventMethodActions\n  | ClearStateMethodActions\n  | CloseWebSocketMethodActions\n  | CreateInterfaceMethodActions\n  | EndTraceMethodActions\n  | GetAllSnapsMethodActions\n  | GetBackgroundEventsMethodActions\n  | GetClientStatusMethodActions\n  | GetFileMethodActions\n  | GetInterfaceContextMethodActions\n  | GetInterfaceStateMethodActions\n  | GetSnapsMethodActions\n  | GetStateMethodActions\n  | GetWebSocketsMethodActions\n  | InvokeKeyringMethodActions\n  | InvokeSnapSugarMethodActions\n  | ListEntropySourcesMethodActions\n  | OpenWebSocketMethodActions\n  | RequestSnapsMethodActions\n  | ResolveInterfaceMethodActions\n  | ScheduleBackgroundEventMethodActions\n  | SendWebSocketMessageMethodActions\n  | SetStateMethodActions\n  | StartTraceMethodActions\n  | TrackErrorMethodActions\n  | TrackEventMethodActions\n  | UpdateInterfaceMethodActions\n  | MessengerCallMethodActions;\n\nexport type PermittedRpcMethodHooks = GetClientStatusMethodHooks &\n  GetStateMethodHooks &\n  ListEntropySourcesMethodHooks &\n  SetStateMethodHooks &\n  TrackEventMethodHooks &\n  TrackErrorMethodHooks &\n  StartTraceMethodHooks &\n  EndTraceMethodHooks &\n  InvokeKeyringMethodHooks &\n  MessengerCallMethodHooks;\n\nexport * from './middleware';\n"]}

package/dist/permitted/messengerCall.cjs

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.messengerCallHandler = void 0;
+const rpc_errors_1 = require("@metamask/rpc-errors");
+const superstruct_1 = require("@metamask/superstruct");
+const utils_1 = require("@metamask/utils");
+const endowments_1 = require("../endowments/index.cjs");
+const messenger_1 = require("../endowments/messenger.cjs");
+const hookNames = {
+    getMessenger: true,
+};
+const BLOCKED_MESSENGER_CLIENTS = [
+    'ApprovalController',
+    'KeyringController',
+    'PermissionController',
+    'SnapController',
+    'WebSocketService',
+    'CronjobController',
+    'SnapInsightsController',
+    'SnapInterfaceController',
+    'MultichainRoutingService',
+    'ExecutionService',
+    'SnapRegistryController',
+];
+const MessengerCallParametersStruct = (0, superstruct_1.object)({
+    action: (0, utils_1.definePattern)('MessengerAction', /^.+:.+$/u),
+    params: (0, superstruct_1.array)(utils_1.JsonStruct),
+});
+/**
+ * Handler for the `snap_messengerCall` method.
+ *
+ * @internal
+ */
+exports.messengerCallHandler = {
+    implementation: getMessengerCallImplementation,
+    hookNames,
+    actionNames: ['SnapController:getSnap', 'PermissionController:getPermission'],
+};
+/**
+ * The `snap_messengerCall` method implementation. This method is used to dispatch
+ * an action via the messenger. It is only available to preinstalled Snaps.
+ *
+ * @param request - The JSON-RPC request object.
+ * @param response - The JSON-RPC response object.
+ * @param _next - The `json-rpc-engine` "next" callback. Not used by this
+ * function.
+ * @param end - The `json-rpc-engine` "end" callback.
+ * @param hooks - The RPC method hooks.
+ * @param hooks.getMessenger - The hook function to create a custom messenger for the Snap.
+ * @param messenger - The messenger used to call controller actions.
+ * @returns Nothing.
+ */
+async function getMessengerCallImplementation(request, response, _next, end, { getMessenger }, messenger) {
+    const snap = messenger.call('SnapController:getSnap', request.origin);
+    const permission = messenger.call('PermissionController:getPermission', request.origin, endowments_1.SnapEndowments.Messenger);
+    if (!snap?.preinstalled || !permission) {
+        return end(rpc_errors_1.rpcErrors.methodNotFound());
+    }
+    const actions = (0, messenger_1.getMessengerCaveatActions)(permission);
+    const snapMessenger = getMessenger({ actions });
+    const { params } = request;
+    try {
+        const { action, params: actionParams } = getValidatedParams(params);
+        if (BLOCKED_MESSENGER_CLIENTS.some((namespace) => action.startsWith(namespace))) {
+            return end(rpc_errors_1.rpcErrors.invalidParams({
+                message: `Access to the following messenger clients are disallowed in Snaps: ${BLOCKED_MESSENGER_CLIENTS.join(', ')}.`,
+            }));
+        }
+        response.result = await snapMessenger.call(action, ...actionParams);
+    }
+    catch (error) {
+        return end(error);
+    }
+    return end();
+}
+/**
+ * Validate the parameters for the `snap_messengerCall` method.
+ *
+ * @param params - Parameters to validate.
+ * @returns Validated parameters.
+ * @throws Throws RPC error if validation fails.
+ */
+function getValidatedParams(params) {
+    try {
+        return (0, superstruct_1.create)(params, MessengerCallParametersStruct);
+    }
+    catch (error) {
+        if (error instanceof superstruct_1.StructError) {
+            throw rpc_errors_1.rpcErrors.invalidParams({
+                message: `Invalid params: ${error.message}.`,
+            });
+        }
+        /* istanbul ignore next */
+        throw rpc_errors_1.rpcErrors.internal();
+    }
+}
+//# sourceMappingURL=messengerCall.cjs.map

package/dist/permitted/messengerCall.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"messengerCall.cjs","sourceRoot":"","sources":["../../src/permitted/messengerCall.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  JsonRpcEngineEndCallback,\n  MethodHandler,\n} from '@metamask/json-rpc-engine';\nimport type { Messenger, NamespacedName } from '@metamask/messenger';\nimport type { PermissionControllerGetPermissionAction } from '@metamask/permission-controller';\nimport { rpcErrors } from '@metamask/rpc-errors';\nimport type {\n  MessengerCallParams,\n  MessengerCallResult,\n} from '@metamask/snaps-sdk';\nimport type { InferMatching } from '@metamask/snaps-utils';\nimport { create, object, StructError, array } from '@metamask/superstruct';\nimport type { Json, PendingJsonRpcResponse } from '@metamask/utils';\nimport { definePattern, JsonStruct } from '@metamask/utils';\n\nimport { SnapEndowments } from '../endowments';\nimport { getMessengerCaveatActions } from '../endowments/messenger';\nimport type {\n  JsonRpcRequestWithOrigin,\n  SnapControllerGetSnapAction,\n} from '../types';\nimport type { MethodHooksObject } from '../utils';\n\nconst hookNames: MethodHooksObject<MessengerCallMethodHooks> = {\n  getMessenger: true,\n};\n\ntype GenericMessengerAction = {\n  type: NamespacedName;\n  handler: (...args: Json[]) => Promise<Json>;\n};\n\nexport type MessengerCallMethodHooks = {\n  getMessenger: (args: {\n    actions?: string[] | null;\n    events?: string[] | null;\n  }) => Messenger<string, GenericMessengerAction>;\n};\n\nexport type MessengerCallMethodActions =\n  | SnapControllerGetSnapAction\n  | PermissionControllerGetPermissionAction;\n\nconst BLOCKED_MESSENGER_CLIENTS = [\n  'ApprovalController',\n  'KeyringController',\n  'PermissionController',\n  'SnapController',\n  'WebSocketService',\n  'CronjobController',\n  'SnapInsightsController',\n  'SnapInterfaceController',\n  'MultichainRoutingService',\n  'ExecutionService',\n  'SnapRegistryController',\n];\n\nconst MessengerCallParametersStruct = object({\n  action: definePattern<`${string}:${string}`>('MessengerAction', /^.+:.+$/u),\n  params: array(JsonStruct),\n});\n\nexport type MessengerCallParameters = InferMatching<\n  typeof MessengerCallParametersStruct,\n  MessengerCallParams\n>;\n\n/**\n * Handler for the `snap_messengerCall` method.\n *\n * @internal\n */\nexport const messengerCallHandler = {\n  implementation: getMessengerCallImplementation,\n  hookNames,\n  actionNames: ['SnapController:getSnap', 'PermissionController:getPermission'],\n} satisfies MethodHandler<\n  MessengerCallMethodHooks,\n  MessengerCallMethodActions,\n  MessengerCallParameters,\n  MessengerCallResult,\n  { origin: string }\n>;\n\n/**\n * The `snap_messengerCall` method implementation. This method is used to dispatch\n * an action via the messenger. It is only available to preinstalled Snaps.\n *\n * @param request - The JSON-RPC request object.\n * @param response - The JSON-RPC response object.\n * @param _next - The `json-rpc-engine` \"next\" callback. Not used by this\n * function.\n * @param end - The `json-rpc-engine` \"end\" callback.\n * @param hooks - The RPC method hooks.\n * @param hooks.getMessenger - The hook function to create a custom messenger for the Snap.\n * @param messenger - The messenger used to call controller actions.\n * @returns Nothing.\n */\nasync function getMessengerCallImplementation(\n  request: JsonRpcRequestWithOrigin<MessengerCallParams>,\n  response: PendingJsonRpcResponse,\n  _next: unknown,\n  end: JsonRpcEngineEndCallback,\n  { getMessenger }: MessengerCallMethodHooks,\n  messenger: Messenger<string, MessengerCallMethodActions>,\n): Promise<void> {\n  const snap = messenger.call('SnapController:getSnap', request.origin);\n  const permission = messenger.call(\n    'PermissionController:getPermission',\n    request.origin,\n    SnapEndowments.Messenger,\n  );\n\n  if (!snap?.preinstalled || !permission) {\n    return end(rpcErrors.methodNotFound());\n  }\n\n  const actions = getMessengerCaveatActions(permission);\n\n  const snapMessenger = getMessenger({ actions });\n\n  const { params } = request;\n\n  try {\n    const { action, params: actionParams } = getValidatedParams(params);\n\n    if (\n      BLOCKED_MESSENGER_CLIENTS.some((namespace) =>\n        action.startsWith(namespace),\n      )\n    ) {\n      return end(\n        rpcErrors.invalidParams({\n          message: `Access to the following messenger clients are disallowed in Snaps: ${BLOCKED_MESSENGER_CLIENTS.join(', ')}.`,\n        }),\n      );\n    }\n\n    response.result = await snapMessenger.call(action, ...actionParams);\n  } catch (error) {\n    return end(error);\n  }\n\n  return end();\n}\n\n/**\n * Validate the parameters for the `snap_messengerCall` method.\n *\n * @param params - Parameters to validate.\n * @returns Validated parameters.\n * @throws Throws RPC error if validation fails.\n */\nfunction getValidatedParams(params: unknown): MessengerCallParameters {\n  try {\n    return create(params, MessengerCallParametersStruct);\n  } catch (error) {\n    if (error instanceof StructError) {\n      throw rpcErrors.invalidParams({\n        message: `Invalid params: ${error.message}.`,\n      });\n    }\n\n    /* istanbul ignore next */\n    throw rpcErrors.internal();\n  }\n}\n"]}

package/dist/permitted/messengerCall.d.cts

@@ -0,0 +1,54 @@
+import type { JsonRpcEngineEndCallback } from "@metamask/json-rpc-engine";
+import type { Messenger, NamespacedName } from "@metamask/messenger";
+import type { PermissionControllerGetPermissionAction } from "@metamask/permission-controller";
+import type { MessengerCallParams } from "@metamask/snaps-sdk";
+import type { InferMatching } from "@metamask/snaps-utils";
+import type { Json, PendingJsonRpcResponse } from "@metamask/utils";
+import type { JsonRpcRequestWithOrigin, SnapControllerGetSnapAction } from "../types.cjs";
+import type { MethodHooksObject } from "../utils.cjs";
+type GenericMessengerAction = {
+    type: NamespacedName;
+    handler: (...args: Json[]) => Promise<Json>;
+};
+export type MessengerCallMethodHooks = {
+    getMessenger: (args: {
+        actions?: string[] | null;
+        events?: string[] | null;
+    }) => Messenger<string, GenericMessengerAction>;
+};
+export type MessengerCallMethodActions = SnapControllerGetSnapAction | PermissionControllerGetPermissionAction;
+declare const MessengerCallParametersStruct: import("@metamask/superstruct").Struct<{
+    params: Json[];
+    action: `${string}:${string}`;
+}, {
+    action: import("@metamask/superstruct").Struct<`${string}:${string}`, null>;
+    params: import("@metamask/superstruct").Struct<Json[], import("@metamask/superstruct").Struct<Json, unknown>>;
+}>;
+export type MessengerCallParameters = InferMatching<typeof MessengerCallParametersStruct, MessengerCallParams>;
+/**
+ * Handler for the `snap_messengerCall` method.
+ *
+ * @internal
+ */
+export declare const messengerCallHandler: {
+    implementation: typeof getMessengerCallImplementation;
+    hookNames: MethodHooksObject<MessengerCallMethodHooks>;
+    actionNames: ("SnapController:getSnap" | "PermissionController:getPermission")[];
+};
+/**
+ * The `snap_messengerCall` method implementation. This method is used to dispatch
+ * an action via the messenger. It is only available to preinstalled Snaps.
+ *
+ * @param request - The JSON-RPC request object.
+ * @param response - The JSON-RPC response object.
+ * @param _next - The `json-rpc-engine` "next" callback. Not used by this
+ * function.
+ * @param end - The `json-rpc-engine` "end" callback.
+ * @param hooks - The RPC method hooks.
+ * @param hooks.getMessenger - The hook function to create a custom messenger for the Snap.
+ * @param messenger - The messenger used to call controller actions.
+ * @returns Nothing.
+ */
+declare function getMessengerCallImplementation(request: JsonRpcRequestWithOrigin<MessengerCallParams>, response: PendingJsonRpcResponse, _next: unknown, end: JsonRpcEngineEndCallback, { getMessenger }: MessengerCallMethodHooks, messenger: Messenger<string, MessengerCallMethodActions>): Promise<void>;
+export {};
+//# sourceMappingURL=messengerCall.d.cts.map

package/dist/permitted/messengerCall.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messengerCall.d.cts","sourceRoot":"","sources":["../../src/permitted/messengerCall.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EAEzB,kCAAkC;AACnC,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,4BAA4B;AACrE,OAAO,KAAK,EAAE,uCAAuC,EAAE,wCAAwC;AAE/F,OAAO,KAAK,EACV,mBAAmB,EAEpB,4BAA4B;AAC7B,OAAO,KAAK,EAAE,aAAa,EAAE,8BAA8B;AAE3D,OAAO,KAAK,EAAE,IAAI,EAAE,sBAAsB,EAAE,wBAAwB;AAKpE,OAAO,KAAK,EACV,wBAAwB,EACxB,2BAA2B,EAC5B,qBAAiB;AAClB,OAAO,KAAK,EAAE,iBAAiB,EAAE,qBAAiB;AAMlD,KAAK,sBAAsB,GAAG;IAC5B,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,YAAY,EAAE,CAAC,IAAI,EAAE;QACnB,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAC1B,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;KAC1B,KAAK,SAAS,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;CACjD,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAClC,2BAA2B,GAC3B,uCAAuC,CAAC;AAgB5C,QAAA,MAAM,6BAA6B;;;;;;EAGjC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,aAAa,CACjD,OAAO,6BAA6B,EACpC,mBAAmB,CACpB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;;;CAUhC,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,iBAAe,8BAA8B,CAC3C,OAAO,EAAE,wBAAwB,CAAC,mBAAmB,CAAC,EACtD,QAAQ,EAAE,sBAAsB,EAChC,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,wBAAwB,EAC7B,EAAE,YAAY,EAAE,EAAE,wBAAwB,EAC1C,SAAS,EAAE,SAAS,CAAC,MAAM,EAAE,0BAA0B,CAAC,GACvD,OAAO,CAAC,IAAI,CAAC,CAuCf"}

package/dist/permitted/messengerCall.d.mts

@@ -0,0 +1,54 @@
+import type { JsonRpcEngineEndCallback } from "@metamask/json-rpc-engine";
+import type { Messenger, NamespacedName } from "@metamask/messenger";
+import type { PermissionControllerGetPermissionAction } from "@metamask/permission-controller";
+import type { MessengerCallParams } from "@metamask/snaps-sdk";
+import type { InferMatching } from "@metamask/snaps-utils";
+import type { Json, PendingJsonRpcResponse } from "@metamask/utils";
+import type { JsonRpcRequestWithOrigin, SnapControllerGetSnapAction } from "../types.mjs";
+import type { MethodHooksObject } from "../utils.mjs";
+type GenericMessengerAction = {
+    type: NamespacedName;
+    handler: (...args: Json[]) => Promise<Json>;
+};
+export type MessengerCallMethodHooks = {
+    getMessenger: (args: {
+        actions?: string[] | null;
+        events?: string[] | null;
+    }) => Messenger<string, GenericMessengerAction>;
+};
+export type MessengerCallMethodActions = SnapControllerGetSnapAction | PermissionControllerGetPermissionAction;
+declare const MessengerCallParametersStruct: import("@metamask/superstruct").Struct<{
+    params: Json[];
+    action: `${string}:${string}`;
+}, {
+    action: import("@metamask/superstruct").Struct<`${string}:${string}`, null>;
+    params: import("@metamask/superstruct").Struct<Json[], import("@metamask/superstruct").Struct<Json, unknown>>;
+}>;
+export type MessengerCallParameters = InferMatching<typeof MessengerCallParametersStruct, MessengerCallParams>;
+/**
+ * Handler for the `snap_messengerCall` method.
+ *
+ * @internal
+ */
+export declare const messengerCallHandler: {
+    implementation: typeof getMessengerCallImplementation;
+    hookNames: MethodHooksObject<MessengerCallMethodHooks>;
+    actionNames: ("SnapController:getSnap" | "PermissionController:getPermission")[];
+};
+/**
+ * The `snap_messengerCall` method implementation. This method is used to dispatch
+ * an action via the messenger. It is only available to preinstalled Snaps.
+ *
+ * @param request - The JSON-RPC request object.
+ * @param response - The JSON-RPC response object.
+ * @param _next - The `json-rpc-engine` "next" callback. Not used by this
+ * function.
+ * @param end - The `json-rpc-engine` "end" callback.
+ * @param hooks - The RPC method hooks.
+ * @param hooks.getMessenger - The hook function to create a custom messenger for the Snap.
+ * @param messenger - The messenger used to call controller actions.
+ * @returns Nothing.
+ */
+declare function getMessengerCallImplementation(request: JsonRpcRequestWithOrigin<MessengerCallParams>, response: PendingJsonRpcResponse, _next: unknown, end: JsonRpcEngineEndCallback, { getMessenger }: MessengerCallMethodHooks, messenger: Messenger<string, MessengerCallMethodActions>): Promise<void>;
+export {};
+//# sourceMappingURL=messengerCall.d.mts.map

package/dist/permitted/messengerCall.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messengerCall.d.mts","sourceRoot":"","sources":["../../src/permitted/messengerCall.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EAEzB,kCAAkC;AACnC,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,4BAA4B;AACrE,OAAO,KAAK,EAAE,uCAAuC,EAAE,wCAAwC;AAE/F,OAAO,KAAK,EACV,mBAAmB,EAEpB,4BAA4B;AAC7B,OAAO,KAAK,EAAE,aAAa,EAAE,8BAA8B;AAE3D,OAAO,KAAK,EAAE,IAAI,EAAE,sBAAsB,EAAE,wBAAwB;AAKpE,OAAO,KAAK,EACV,wBAAwB,EACxB,2BAA2B,EAC5B,qBAAiB;AAClB,OAAO,KAAK,EAAE,iBAAiB,EAAE,qBAAiB;AAMlD,KAAK,sBAAsB,GAAG;IAC5B,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,YAAY,EAAE,CAAC,IAAI,EAAE;QACnB,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAC1B,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;KAC1B,KAAK,SAAS,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;CACjD,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAClC,2BAA2B,GAC3B,uCAAuC,CAAC;AAgB5C,QAAA,MAAM,6BAA6B;;;;;;EAGjC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,aAAa,CACjD,OAAO,6BAA6B,EACpC,mBAAmB,CACpB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;;;CAUhC,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,iBAAe,8BAA8B,CAC3C,OAAO,EAAE,wBAAwB,CAAC,mBAAmB,CAAC,EACtD,QAAQ,EAAE,sBAAsB,EAChC,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,wBAAwB,EAC7B,EAAE,YAAY,EAAE,EAAE,wBAAwB,EAC1C,SAAS,EAAE,SAAS,CAAC,MAAM,EAAE,0BAA0B,CAAC,GACvD,OAAO,CAAC,IAAI,CAAC,CAuCf"}

package/dist/permitted/messengerCall.mjs

@@ -0,0 +1,94 @@
+import { rpcErrors } from "@metamask/rpc-errors";
+import { create, object, StructError, array } from "@metamask/superstruct";
+import { definePattern, JsonStruct } from "@metamask/utils";
+import { SnapEndowments } from "../endowments/index.mjs";
+import { getMessengerCaveatActions } from "../endowments/messenger.mjs";
+const hookNames = {
+    getMessenger: true,
+};
+const BLOCKED_MESSENGER_CLIENTS = [
+    'ApprovalController',
+    'KeyringController',
+    'PermissionController',
+    'SnapController',
+    'WebSocketService',
+    'CronjobController',
+    'SnapInsightsController',
+    'SnapInterfaceController',
+    'MultichainRoutingService',
+    'ExecutionService',
+    'SnapRegistryController',
+];
+const MessengerCallParametersStruct = object({
+    action: definePattern('MessengerAction', /^.+:.+$/u),
+    params: array(JsonStruct),
+});
+/**
+ * Handler for the `snap_messengerCall` method.
+ *
+ * @internal
+ */
+export const messengerCallHandler = {
+    implementation: getMessengerCallImplementation,
+    hookNames,
+    actionNames: ['SnapController:getSnap', 'PermissionController:getPermission'],
+};
+/**
+ * The `snap_messengerCall` method implementation. This method is used to dispatch
+ * an action via the messenger. It is only available to preinstalled Snaps.
+ *
+ * @param request - The JSON-RPC request object.
+ * @param response - The JSON-RPC response object.
+ * @param _next - The `json-rpc-engine` "next" callback. Not used by this
+ * function.
+ * @param end - The `json-rpc-engine` "end" callback.
+ * @param hooks - The RPC method hooks.
+ * @param hooks.getMessenger - The hook function to create a custom messenger for the Snap.
+ * @param messenger - The messenger used to call controller actions.
+ * @returns Nothing.
+ */
+async function getMessengerCallImplementation(request, response, _next, end, { getMessenger }, messenger) {
+    const snap = messenger.call('SnapController:getSnap', request.origin);
+    const permission = messenger.call('PermissionController:getPermission', request.origin, SnapEndowments.Messenger);
+    if (!snap?.preinstalled || !permission) {
+        return end(rpcErrors.methodNotFound());
+    }
+    const actions = getMessengerCaveatActions(permission);
+    const snapMessenger = getMessenger({ actions });
+    const { params } = request;
+    try {
+        const { action, params: actionParams } = getValidatedParams(params);
+        if (BLOCKED_MESSENGER_CLIENTS.some((namespace) => action.startsWith(namespace))) {
+            return end(rpcErrors.invalidParams({
+                message: `Access to the following messenger clients are disallowed in Snaps: ${BLOCKED_MESSENGER_CLIENTS.join(', ')}.`,
+            }));
+        }
+        response.result = await snapMessenger.call(action, ...actionParams);
+    }
+    catch (error) {
+        return end(error);
+    }
+    return end();
+}
+/**
+ * Validate the parameters for the `snap_messengerCall` method.
+ *
+ * @param params - Parameters to validate.
+ * @returns Validated parameters.
+ * @throws Throws RPC error if validation fails.
+ */
+function getValidatedParams(params) {
+    try {
+        return create(params, MessengerCallParametersStruct);
+    }
+    catch (error) {
+        if (error instanceof StructError) {
+            throw rpcErrors.invalidParams({
+                message: `Invalid params: ${error.message}.`,
+            });
+        }
+        /* istanbul ignore next */
+        throw rpcErrors.internal();
+    }
+}
+//# sourceMappingURL=messengerCall.mjs.map

package/dist/permitted/messengerCall.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"messengerCall.mjs","sourceRoot":"","sources":["../../src/permitted/messengerCall.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  JsonRpcEngineEndCallback,\n  MethodHandler,\n} from '@metamask/json-rpc-engine';\nimport type { Messenger, NamespacedName } from '@metamask/messenger';\nimport type { PermissionControllerGetPermissionAction } from '@metamask/permission-controller';\nimport { rpcErrors } from '@metamask/rpc-errors';\nimport type {\n  MessengerCallParams,\n  MessengerCallResult,\n} from '@metamask/snaps-sdk';\nimport type { InferMatching } from '@metamask/snaps-utils';\nimport { create, object, StructError, array } from '@metamask/superstruct';\nimport type { Json, PendingJsonRpcResponse } from '@metamask/utils';\nimport { definePattern, JsonStruct } from '@metamask/utils';\n\nimport { SnapEndowments } from '../endowments';\nimport { getMessengerCaveatActions } from '../endowments/messenger';\nimport type {\n  JsonRpcRequestWithOrigin,\n  SnapControllerGetSnapAction,\n} from '../types';\nimport type { MethodHooksObject } from '../utils';\n\nconst hookNames: MethodHooksObject<MessengerCallMethodHooks> = {\n  getMessenger: true,\n};\n\ntype GenericMessengerAction = {\n  type: NamespacedName;\n  handler: (...args: Json[]) => Promise<Json>;\n};\n\nexport type MessengerCallMethodHooks = {\n  getMessenger: (args: {\n    actions?: string[] | null;\n    events?: string[] | null;\n  }) => Messenger<string, GenericMessengerAction>;\n};\n\nexport type MessengerCallMethodActions =\n  | SnapControllerGetSnapAction\n  | PermissionControllerGetPermissionAction;\n\nconst BLOCKED_MESSENGER_CLIENTS = [\n  'ApprovalController',\n  'KeyringController',\n  'PermissionController',\n  'SnapController',\n  'WebSocketService',\n  'CronjobController',\n  'SnapInsightsController',\n  'SnapInterfaceController',\n  'MultichainRoutingService',\n  'ExecutionService',\n  'SnapRegistryController',\n];\n\nconst MessengerCallParametersStruct = object({\n  action: definePattern<`${string}:${string}`>('MessengerAction', /^.+:.+$/u),\n  params: array(JsonStruct),\n});\n\nexport type MessengerCallParameters = InferMatching<\n  typeof MessengerCallParametersStruct,\n  MessengerCallParams\n>;\n\n/**\n * Handler for the `snap_messengerCall` method.\n *\n * @internal\n */\nexport const messengerCallHandler = {\n  implementation: getMessengerCallImplementation,\n  hookNames,\n  actionNames: ['SnapController:getSnap', 'PermissionController:getPermission'],\n} satisfies MethodHandler<\n  MessengerCallMethodHooks,\n  MessengerCallMethodActions,\n  MessengerCallParameters,\n  MessengerCallResult,\n  { origin: string }\n>;\n\n/**\n * The `snap_messengerCall` method implementation. This method is used to dispatch\n * an action via the messenger. It is only available to preinstalled Snaps.\n *\n * @param request - The JSON-RPC request object.\n * @param response - The JSON-RPC response object.\n * @param _next - The `json-rpc-engine` \"next\" callback. Not used by this\n * function.\n * @param end - The `json-rpc-engine` \"end\" callback.\n * @param hooks - The RPC method hooks.\n * @param hooks.getMessenger - The hook function to create a custom messenger for the Snap.\n * @param messenger - The messenger used to call controller actions.\n * @returns Nothing.\n */\nasync function getMessengerCallImplementation(\n  request: JsonRpcRequestWithOrigin<MessengerCallParams>,\n  response: PendingJsonRpcResponse,\n  _next: unknown,\n  end: JsonRpcEngineEndCallback,\n  { getMessenger }: MessengerCallMethodHooks,\n  messenger: Messenger<string, MessengerCallMethodActions>,\n): Promise<void> {\n  const snap = messenger.call('SnapController:getSnap', request.origin);\n  const permission = messenger.call(\n    'PermissionController:getPermission',\n    request.origin,\n    SnapEndowments.Messenger,\n  );\n\n  if (!snap?.preinstalled || !permission) {\n    return end(rpcErrors.methodNotFound());\n  }\n\n  const actions = getMessengerCaveatActions(permission);\n\n  const snapMessenger = getMessenger({ actions });\n\n  const { params } = request;\n\n  try {\n    const { action, params: actionParams } = getValidatedParams(params);\n\n    if (\n      BLOCKED_MESSENGER_CLIENTS.some((namespace) =>\n        action.startsWith(namespace),\n      )\n    ) {\n      return end(\n        rpcErrors.invalidParams({\n          message: `Access to the following messenger clients are disallowed in Snaps: ${BLOCKED_MESSENGER_CLIENTS.join(', ')}.`,\n        }),\n      );\n    }\n\n    response.result = await snapMessenger.call(action, ...actionParams);\n  } catch (error) {\n    return end(error);\n  }\n\n  return end();\n}\n\n/**\n * Validate the parameters for the `snap_messengerCall` method.\n *\n * @param params - Parameters to validate.\n * @returns Validated parameters.\n * @throws Throws RPC error if validation fails.\n */\nfunction getValidatedParams(params: unknown): MessengerCallParameters {\n  try {\n    return create(params, MessengerCallParametersStruct);\n  } catch (error) {\n    if (error instanceof StructError) {\n      throw rpcErrors.invalidParams({\n        message: `Invalid params: ${error.message}.`,\n      });\n    }\n\n    /* istanbul ignore next */\n    throw rpcErrors.internal();\n  }\n}\n"]}

package/dist/permitted/middleware.cjs

@@ -21,6 +21,7 @@ const getWebSockets_1 = require("./getWebSockets.cjs");
 const invokeKeyring_1 = require("./invokeKeyring.cjs");
 const invokeSnapSugar_1 = require("./invokeSnapSugar.cjs");
 const listEntropySources_1 = require("./listEntropySources.cjs");
+const messengerCall_1 = require("./messengerCall.cjs");
 const openWebSocket_1 = require("./openWebSocket.cjs");
 const requestSnaps_1 = require("./requestSnaps.cjs");
 const resolveInterface_1 = require("./resolveInterface.cjs");
@@ -60,6 +61,7 @@ const methodHandlers = {
     snap_getWebSockets: getWebSockets_1.getWebSocketsHandler,
     snap_startTrace: startTrace_1.startTraceHandler,
     snap_endTrace: endTrace_1.endTraceHandler,
+    snap_messengerCall: messengerCall_1.messengerCallHandler,
 };
 /* eslint-enable @typescript-eslint/naming-convention */
 /**

package/dist/permitted/middleware.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"middleware.cjs","sourceRoot":"","sources":["../../src/permitted/middleware.ts"],"names":[],"mappings":";;;AAAA,+DAGmC;AAEnC,qDAAiD;AACjD,uDAAiD;AAIjD,uEAAuE;AACvE,iDAAiD;AACjD,yDAAyD;AACzD,2DAA2D;AAC3D,6CAA6C;AAC7C,mDAAmD;AACnD,mEAAmE;AACnE,2DAA2D;AAC3D,2CAA2C;AAC3C,mEAAmE;AACnE,+DAA+D;AAC/D,6CAA6C;AAC7C,6CAA6C;AAC7C,uDAAuD;AACvD,uDAAuD;AACvD,2DAA2D;AAC3D,iEAAiE;AACjE,uDAAuD;AACvD,qDAAqD;AACrD,6DAA6D;AAC7D,2EAA2E;AAC3E,qEAAqE;AACrE,6CAA6C;AAC7C,iDAAiD;AACjD,iDAAiD;AACjD,iDAAiD;AACjD,2DAA2D;AAE3D,yDAAyD;AACzD,MAAM,cAAc,GAAG;IACrB,kBAAkB,EAAE,gCAAkB;IACtC,eAAe,EAAE,0BAAe;IAChC,mBAAmB,EAAE,kCAAmB;IACxC,iBAAiB,EAAE,wCAAsB;IACzC,oBAAoB,EAAE,oCAAoB;IAC1C,eAAe,EAAE,8BAAiB;IAClC,oBAAoB,EAAE,wCAAsB;IAC5C,YAAY,EAAE,wBAAc;IAC5B,aAAa,EAAE,0BAAe;IAC9B,oBAAoB,EAAE,wCAAsB;IAC5C,oBAAoB,EAAE,wCAAsB;IAC5C,sBAAsB,EAAE,4CAAwB;IAChD,wBAAwB,EAAE,gDAA0B;IACpD,uBAAuB,EAAE,8CAAyB;IAClD,qBAAqB,EAAE,0CAAuB;IAC9C,4BAA4B,EAAE,wDAA8B;IAC5D,0BAA0B,EAAE,oDAA4B;IACxD,wBAAwB,EAAE,gDAA0B;IACpD,aAAa,EAAE,0BAAe;IAC9B,eAAe,EAAE,8BAAiB;IAClC,eAAe,EAAE,8BAAiB;IAClC,kBAAkB,EAAE,oCAAoB;IACxC,mBAAmB,EAAE,sCAAqB;IAC1C,yBAAyB,EAAE,kDAA2B;IACtD,kBAAkB,EAAE,oCAAoB;IACxC,eAAe,EAAE,8BAAiB;IAClC,aAAa,EAAE,0BAAe;CAC/B,CAAC;AACF,wDAAwD;AAExD;;;;;;;GAOG;AACH,SAAgB,2BAA2B,CACzC,MAAe,EACf,KAA8B,EAC9B,SAAuD;IAEvD,MAAM,gBAAgB,GAAG,IAAA,wCAAsB,EAAC;QAC9C,QAAQ,EAAE,cAAc;QACxB,KAAK;QACL,SAAS;QACT,OAAO,EAAE,sBAAQ;KAClB,CAAC,CAAC;IAEH,iEAAiE;IACjE,kEAAkE;IAClE,OAAO,KAAK,UAAU,gBAAgB,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG;QACjE,IAAI,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACzE,OAAO,GAAG,CAAC,sBAAS,CAAC,cAAc,EAAE,CAAC,CAAC;QACzC,CAAC;QAED,OAAO,gBAAgB,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;IACxD,CAAC,CAAC;AACJ,CAAC;AArBD,kEAqBC","sourcesContent":["import {\n  createMethodMiddleware,\n  type JsonRpcMiddleware,\n} from '@metamask/json-rpc-engine';\nimport type { Messenger } from '@metamask/messenger';\nimport { rpcErrors } from '@metamask/rpc-errors';\nimport { logError } from '@metamask/snaps-utils';\nimport type { Json, JsonRpcParams } from '@metamask/utils';\n\nimport type { PermittedRpcMethodActions, PermittedRpcMethodHooks } from '.';\nimport { cancelBackgroundEventHandler } from './cancelBackgroundEvent';\nimport { clearStateHandler } from './clearState';\nimport { closeWebSocketHandler } from './closeWebSocket';\nimport { createInterfaceHandler } from './createInterface';\nimport { endTraceHandler } from './endTrace';\nimport { getAllSnapsHandler } from './getAllSnaps';\nimport { getBackgroundEventsHandler } from './getBackgroundEvents';\nimport { getClientStatusHandler } from './getClientStatus';\nimport { getFileHandler } from './getFile';\nimport { getInterfaceContextHandler } from './getInterfaceContext';\nimport { getInterfaceStateHandler } from './getInterfaceState';\nimport { getSnapsHandler } from './getSnaps';\nimport { getStateHandler } from './getState';\nimport { getWebSocketsHandler } from './getWebSockets';\nimport { invokeKeyringHandler } from './invokeKeyring';\nimport { invokeSnapSugarHandler } from './invokeSnapSugar';\nimport { listEntropySourcesHandler } from './listEntropySources';\nimport { openWebSocketHandler } from './openWebSocket';\nimport { requestSnapsHandler } from './requestSnaps';\nimport { resolveInterfaceHandler } from './resolveInterface';\nimport { scheduleBackgroundEventHandler } from './scheduleBackgroundEvent';\nimport { sendWebSocketMessageHandler } from './sendWebSocketMessage';\nimport { setStateHandler } from './setState';\nimport { startTraceHandler } from './startTrace';\nimport { trackErrorHandler } from './trackError';\nimport { trackEventHandler } from './trackEvent';\nimport { updateInterfaceHandler } from './updateInterface';\n\n/* eslint-disable @typescript-eslint/naming-convention */\nconst methodHandlers = {\n  wallet_getAllSnaps: getAllSnapsHandler,\n  wallet_getSnaps: getSnapsHandler,\n  wallet_requestSnaps: requestSnapsHandler,\n  wallet_invokeSnap: invokeSnapSugarHandler,\n  wallet_invokeKeyring: invokeKeyringHandler,\n  snap_clearState: clearStateHandler,\n  snap_getClientStatus: getClientStatusHandler,\n  snap_getFile: getFileHandler,\n  snap_getState: getStateHandler,\n  snap_createInterface: createInterfaceHandler,\n  snap_updateInterface: updateInterfaceHandler,\n  snap_getInterfaceState: getInterfaceStateHandler,\n  snap_getInterfaceContext: getInterfaceContextHandler,\n  snap_listEntropySources: listEntropySourcesHandler,\n  snap_resolveInterface: resolveInterfaceHandler,\n  snap_scheduleBackgroundEvent: scheduleBackgroundEventHandler,\n  snap_cancelBackgroundEvent: cancelBackgroundEventHandler,\n  snap_getBackgroundEvents: getBackgroundEventsHandler,\n  snap_setState: setStateHandler,\n  snap_trackError: trackErrorHandler,\n  snap_trackEvent: trackEventHandler,\n  snap_openWebSocket: openWebSocketHandler,\n  snap_closeWebSocket: closeWebSocketHandler,\n  snap_sendWebSocketMessage: sendWebSocketMessageHandler,\n  snap_getWebSockets: getWebSocketsHandler,\n  snap_startTrace: startTraceHandler,\n  snap_endTrace: endTraceHandler,\n};\n/* eslint-enable @typescript-eslint/naming-convention */\n\n/**\n * Creates a middleware that handles permitted snap RPC methods.\n *\n * @param isSnap - A flag that should indicate whether the requesting origin is a snap or not.\n * @param hooks - An object containing the hooks made available to the permitted RPC methods.\n * @param messenger - The messenger.\n * @returns The middleware.\n */\nexport function createSnapsMethodMiddleware(\n  isSnap: boolean,\n  hooks: PermittedRpcMethodHooks,\n  messenger: Messenger<string, PermittedRpcMethodActions>,\n): JsonRpcMiddleware<JsonRpcParams, Json> {\n  const nestedMiddleware = createMethodMiddleware({\n    handlers: methodHandlers,\n    hooks,\n    messenger,\n    onError: logError,\n  });\n\n  // This is not actually a misused promise, the type is just wrong\n  // eslint-disable-next-line @typescript-eslint/no-misused-promises\n  return async function methodMiddleware(request, response, next, end) {\n    if (String.prototype.startsWith.call(request.method, 'snap_') && !isSnap) {\n      return end(rpcErrors.methodNotFound());\n    }\n\n    return nestedMiddleware(request, response, next, end);\n  };\n}\n"]}
+{"version":3,"file":"middleware.cjs","sourceRoot":"","sources":["../../src/permitted/middleware.ts"],"names":[],"mappings":";;;AAAA,+DAGmC;AAEnC,qDAAiD;AACjD,uDAAiD;AAIjD,uEAAuE;AACvE,iDAAiD;AACjD,yDAAyD;AACzD,2DAA2D;AAC3D,6CAA6C;AAC7C,mDAAmD;AACnD,mEAAmE;AACnE,2DAA2D;AAC3D,2CAA2C;AAC3C,mEAAmE;AACnE,+DAA+D;AAC/D,6CAA6C;AAC7C,6CAA6C;AAC7C,uDAAuD;AACvD,uDAAuD;AACvD,2DAA2D;AAC3D,iEAAiE;AACjE,uDAAuD;AACvD,uDAAuD;AACvD,qDAAqD;AACrD,6DAA6D;AAC7D,2EAA2E;AAC3E,qEAAqE;AACrE,6CAA6C;AAC7C,iDAAiD;AACjD,iDAAiD;AACjD,iDAAiD;AACjD,2DAA2D;AAE3D,yDAAyD;AACzD,MAAM,cAAc,GAAG;IACrB,kBAAkB,EAAE,gCAAkB;IACtC,eAAe,EAAE,0BAAe;IAChC,mBAAmB,EAAE,kCAAmB;IACxC,iBAAiB,EAAE,wCAAsB;IACzC,oBAAoB,EAAE,oCAAoB;IAC1C,eAAe,EAAE,8BAAiB;IAClC,oBAAoB,EAAE,wCAAsB;IAC5C,YAAY,EAAE,wBAAc;IAC5B,aAAa,EAAE,0BAAe;IAC9B,oBAAoB,EAAE,wCAAsB;IAC5C,oBAAoB,EAAE,wCAAsB;IAC5C,sBAAsB,EAAE,4CAAwB;IAChD,wBAAwB,EAAE,gDAA0B;IACpD,uBAAuB,EAAE,8CAAyB;IAClD,qBAAqB,EAAE,0CAAuB;IAC9C,4BAA4B,EAAE,wDAA8B;IAC5D,0BAA0B,EAAE,oDAA4B;IACxD,wBAAwB,EAAE,gDAA0B;IACpD,aAAa,EAAE,0BAAe;IAC9B,eAAe,EAAE,8BAAiB;IAClC,eAAe,EAAE,8BAAiB;IAClC,kBAAkB,EAAE,oCAAoB;IACxC,mBAAmB,EAAE,sCAAqB;IAC1C,yBAAyB,EAAE,kDAA2B;IACtD,kBAAkB,EAAE,oCAAoB;IACxC,eAAe,EAAE,8BAAiB;IAClC,aAAa,EAAE,0BAAe;IAC9B,kBAAkB,EAAE,oCAAoB;CACzC,CAAC;AACF,wDAAwD;AAExD;;;;;;;GAOG;AACH,SAAgB,2BAA2B,CACzC,MAAe,EACf,KAA8B,EAC9B,SAAuD;IAEvD,MAAM,gBAAgB,GAAG,IAAA,wCAAsB,EAAC;QAC9C,QAAQ,EAAE,cAAc;QACxB,KAAK;QACL,SAAS;QACT,OAAO,EAAE,sBAAQ;KAClB,CAAC,CAAC;IAEH,iEAAiE;IACjE,kEAAkE;IAClE,OAAO,KAAK,UAAU,gBAAgB,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG;QACjE,IAAI,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACzE,OAAO,GAAG,CAAC,sBAAS,CAAC,cAAc,EAAE,CAAC,CAAC;QACzC,CAAC;QAED,OAAO,gBAAgB,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;IACxD,CAAC,CAAC;AACJ,CAAC;AArBD,kEAqBC","sourcesContent":["import {\n  createMethodMiddleware,\n  type JsonRpcMiddleware,\n} from '@metamask/json-rpc-engine';\nimport type { Messenger } from '@metamask/messenger';\nimport { rpcErrors } from '@metamask/rpc-errors';\nimport { logError } from '@metamask/snaps-utils';\nimport type { Json, JsonRpcParams } from '@metamask/utils';\n\nimport type { PermittedRpcMethodActions, PermittedRpcMethodHooks } from '.';\nimport { cancelBackgroundEventHandler } from './cancelBackgroundEvent';\nimport { clearStateHandler } from './clearState';\nimport { closeWebSocketHandler } from './closeWebSocket';\nimport { createInterfaceHandler } from './createInterface';\nimport { endTraceHandler } from './endTrace';\nimport { getAllSnapsHandler } from './getAllSnaps';\nimport { getBackgroundEventsHandler } from './getBackgroundEvents';\nimport { getClientStatusHandler } from './getClientStatus';\nimport { getFileHandler } from './getFile';\nimport { getInterfaceContextHandler } from './getInterfaceContext';\nimport { getInterfaceStateHandler } from './getInterfaceState';\nimport { getSnapsHandler } from './getSnaps';\nimport { getStateHandler } from './getState';\nimport { getWebSocketsHandler } from './getWebSockets';\nimport { invokeKeyringHandler } from './invokeKeyring';\nimport { invokeSnapSugarHandler } from './invokeSnapSugar';\nimport { listEntropySourcesHandler } from './listEntropySources';\nimport { messengerCallHandler } from './messengerCall';\nimport { openWebSocketHandler } from './openWebSocket';\nimport { requestSnapsHandler } from './requestSnaps';\nimport { resolveInterfaceHandler } from './resolveInterface';\nimport { scheduleBackgroundEventHandler } from './scheduleBackgroundEvent';\nimport { sendWebSocketMessageHandler } from './sendWebSocketMessage';\nimport { setStateHandler } from './setState';\nimport { startTraceHandler } from './startTrace';\nimport { trackErrorHandler } from './trackError';\nimport { trackEventHandler } from './trackEvent';\nimport { updateInterfaceHandler } from './updateInterface';\n\n/* eslint-disable @typescript-eslint/naming-convention */\nconst methodHandlers = {\n  wallet_getAllSnaps: getAllSnapsHandler,\n  wallet_getSnaps: getSnapsHandler,\n  wallet_requestSnaps: requestSnapsHandler,\n  wallet_invokeSnap: invokeSnapSugarHandler,\n  wallet_invokeKeyring: invokeKeyringHandler,\n  snap_clearState: clearStateHandler,\n  snap_getClientStatus: getClientStatusHandler,\n  snap_getFile: getFileHandler,\n  snap_getState: getStateHandler,\n  snap_createInterface: createInterfaceHandler,\n  snap_updateInterface: updateInterfaceHandler,\n  snap_getInterfaceState: getInterfaceStateHandler,\n  snap_getInterfaceContext: getInterfaceContextHandler,\n  snap_listEntropySources: listEntropySourcesHandler,\n  snap_resolveInterface: resolveInterfaceHandler,\n  snap_scheduleBackgroundEvent: scheduleBackgroundEventHandler,\n  snap_cancelBackgroundEvent: cancelBackgroundEventHandler,\n  snap_getBackgroundEvents: getBackgroundEventsHandler,\n  snap_setState: setStateHandler,\n  snap_trackError: trackErrorHandler,\n  snap_trackEvent: trackEventHandler,\n  snap_openWebSocket: openWebSocketHandler,\n  snap_closeWebSocket: closeWebSocketHandler,\n  snap_sendWebSocketMessage: sendWebSocketMessageHandler,\n  snap_getWebSockets: getWebSocketsHandler,\n  snap_startTrace: startTraceHandler,\n  snap_endTrace: endTraceHandler,\n  snap_messengerCall: messengerCallHandler,\n};\n/* eslint-enable @typescript-eslint/naming-convention */\n\n/**\n * Creates a middleware that handles permitted snap RPC methods.\n *\n * @param isSnap - A flag that should indicate whether the requesting origin is a snap or not.\n * @param hooks - An object containing the hooks made available to the permitted RPC methods.\n * @param messenger - The messenger.\n * @returns The middleware.\n */\nexport function createSnapsMethodMiddleware(\n  isSnap: boolean,\n  hooks: PermittedRpcMethodHooks,\n  messenger: Messenger<string, PermittedRpcMethodActions>,\n): JsonRpcMiddleware<JsonRpcParams, Json> {\n  const nestedMiddleware = createMethodMiddleware({\n    handlers: methodHandlers,\n    hooks,\n    messenger,\n    onError: logError,\n  });\n\n  // This is not actually a misused promise, the type is just wrong\n  // eslint-disable-next-line @typescript-eslint/no-misused-promises\n  return async function methodMiddleware(request, response, next, end) {\n    if (String.prototype.startsWith.call(request.method, 'snap_') && !isSnap) {\n      return end(rpcErrors.methodNotFound());\n    }\n\n    return nestedMiddleware(request, response, next, end);\n  };\n}\n"]}

package/dist/permitted/middleware.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"middleware.d.cts","sourceRoot":"","sources":["../../src/permitted/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,iBAAiB,EACvB,kCAAkC;AACnC,OAAO,KAAK,EAAE,SAAS,EAAE,4BAA4B;AAGrD,OAAO,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,wBAAwB;AAE3D,OAAO,KAAK,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,oBAAU;AA6D5E;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,uBAAuB,EAC9B,SAAS,EAAE,SAAS,CAAC,MAAM,EAAE,yBAAyB,CAAC,GACtD,iBAAiB,CAAC,aAAa,EAAE,IAAI,CAAC,CAiBxC"}
+{"version":3,"file":"middleware.d.cts","sourceRoot":"","sources":["../../src/permitted/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,iBAAiB,EACvB,kCAAkC;AACnC,OAAO,KAAK,EAAE,SAAS,EAAE,4BAA4B;AAGrD,OAAO,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,wBAAwB;AAE3D,OAAO,KAAK,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,oBAAU;AA+D5E;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,uBAAuB,EAC9B,SAAS,EAAE,SAAS,CAAC,MAAM,EAAE,yBAAyB,CAAC,GACtD,iBAAiB,CAAC,aAAa,EAAE,IAAI,CAAC,CAiBxC"}