@metamask/snaps-controllers 9.5.0 → 9.7.0

package/dist/snaps/SnapController.d.mts

@@ -0,0 +1,668 @@
+import type { AddApprovalRequest, UpdateRequestState } from "@metamask/approval-controller";
+import type { RestrictedControllerMessenger, ControllerGetStateAction, ControllerStateChangeEvent } from "@metamask/base-controller";
+import { BaseController } from "@metamask/base-controller";
+import type { GetEndowments, GetPermissions, GetSubjectMetadata, AddSubjectMetadata, GetSubjects, GrantPermissions, HasPermission, HasPermissions, RevokeAllPermissions, RevokePermissionForAllSubjects, RevokePermissions, UpdateCaveat } from "@metamask/permission-controller";
+import type { BlockReason } from "@metamask/snaps-registry";
+import type { RequestSnapsParams, RequestSnapsResult, SnapId } from "@metamask/snaps-sdk";
+import { AuxiliaryFileEncoding } from "@metamask/snaps-sdk";
+import type { PersistedSnap, Snap, SnapManifest, SnapRpcHookArgs, StatusContext, StatusEvents, StatusStates, TruncatedSnap } from "@metamask/snaps-utils";
+import { SnapStatusEvents } from "@metamask/snaps-utils";
+import type { Json, NonEmptyArray } from "@metamask/utils";
+import type { StateMachine } from "@xstate/fsm";
+import type { Patch } from "immer";
+import type { CreateInterface, GetInterface } from "../interface/index.mjs";
+import type { ExecuteSnapAction, ExecutionServiceEvents, HandleRpcRequestAction, SnapErrorJson, TerminateAllSnapsAction, TerminateSnapAction } from "../services/index.mjs";
+import { type ExportableKeyEncryptor } from "../types/index.mjs";
+import type { SnapLocation } from "./location/index.mjs";
+import { detectSnapLocation } from "./location/index.mjs";
+import type { GetMetadata, GetResult, ResolveVersion, SnapsRegistryMetadata, Update } from "./registry/index.mjs";
+import { Timer } from "./Timer.mjs";
+export declare const controllerName = "SnapController";
+export declare const SNAP_APPROVAL_INSTALL = "wallet_installSnap";
+export declare const SNAP_APPROVAL_UPDATE = "wallet_updateSnap";
+export declare const SNAP_APPROVAL_RESULT = "wallet_installSnapResult";
+export type PendingRequest = {
+    requestId: unknown;
+    timer: Timer;
+};
+export interface PreinstalledSnapFile {
+    path: string;
+    value: string | Uint8Array;
+}
+export interface PreinstalledSnap {
+    snapId: SnapId;
+    manifest: SnapManifest;
+    files: PreinstalledSnapFile[];
+    removable?: boolean;
+    hidden?: boolean;
+    hideSnapBranding?: boolean;
+}
+type SnapRpcHandler = (options: SnapRpcHookArgs & {
+    timeout: number;
+}) => Promise<unknown>;
+/**
+ * A wrapper type for any data stored during runtime of Snaps.
+ * It is not persisted in state as it contains non-serializable data and is only relevant for the
+ * current session.
+ */
+export interface SnapRuntimeData {
+    /**
+     * A promise that resolves when the Snap has finished installing
+     */
+    installPromise: null | Promise<PersistedSnap>;
+    /**
+     * A Unix timestamp for the last time the Snap received an RPC request
+     */
+    lastRequest: null | number;
+    /**
+     * The current number of active references where this Snap is being used
+     */
+    activeReferences: number;
+    /**
+     * The current pending inbound requests, meaning requests that are processed by snaps.
+     */
+    pendingInboundRequests: PendingRequest[];
+    /**
+     * The current pending outbound requests, meaning requests made from snaps towards the MetaMask
+     * extension.
+     */
+    pendingOutboundRequests: number;
+    /**
+     * RPC handler designated for the Snap
+     */
+    rpcHandler: null | SnapRpcHandler;
+    /**
+     * The finite state machine interpreter for possible states that the Snap can be in such as
+     * stopped, running, blocked
+     *
+     * @see {@link SnapController:constructor}
+     */
+    interpreter: StateMachine.Service<StatusContext, StatusEvents, StatusStates>;
+    /**
+     * Cached encryption key used for state encryption.
+     */
+    encryptionKey: string | null;
+    /**
+     * Cached encryption salt used for state encryption.
+     */
+    encryptionSalt: string | null;
+    /**
+     * A boolean flag to determine whether the Snap is currently being stopped.
+     */
+    stopping: boolean;
+}
+export type SnapError = {
+    message: string;
+    code: number;
+    data?: Json;
+};
+type CloseAllConnectionsFunction = (origin: string) => void;
+type StoredSnaps = Record<SnapId, Snap>;
+export type SnapControllerState = {
+    snaps: StoredSnaps;
+    snapStates: Record<SnapId, string | null>;
+    unencryptedSnapStates: Record<SnapId, string | null>;
+};
+export type PersistedSnapControllerState = SnapControllerState & {
+    snaps: Record<SnapId, PersistedSnap>;
+    snapStates: Record<SnapId, string>;
+};
+/**
+ * Gets the specified Snap from state.
+ */
+export type GetSnap = {
+    type: `${typeof controllerName}:get`;
+    handler: SnapController['get'];
+};
+/**
+ * Handles sending an inbound request to a snap and returns its result.
+ */
+export type HandleSnapRequest = {
+    type: `${typeof controllerName}:handleRequest`;
+    handler: SnapController['handleRequest'];
+};
+/**
+ * Gets the specified Snap's persisted state.
+ */
+export type GetSnapState = {
+    type: `${typeof controllerName}:getSnapState`;
+    handler: SnapController['getSnapState'];
+};
+/**
+ * Checks if the specified snap exists in state.
+ */
+export type HasSnap = {
+    type: `${typeof controllerName}:has`;
+    handler: SnapController['has'];
+};
+/**
+ * Updates the specified Snap's persisted state.
+ */
+export type UpdateSnapState = {
+    type: `${typeof controllerName}:updateSnapState`;
+    handler: SnapController['updateSnapState'];
+};
+/**
+ * Clears the specified Snap's persisted state.
+ */
+export type ClearSnapState = {
+    type: `${typeof controllerName}:clearSnapState`;
+    handler: SnapController['clearSnapState'];
+};
+/**
+ * Checks all installed snaps against the blocklist.
+ */
+export type UpdateBlockedSnaps = {
+    type: `${typeof controllerName}:updateBlockedSnaps`;
+    handler: SnapController['updateBlockedSnaps'];
+};
+export type EnableSnap = {
+    type: `${typeof controllerName}:enable`;
+    handler: SnapController['enableSnap'];
+};
+export type DisableSnap = {
+    type: `${typeof controllerName}:disable`;
+    handler: SnapController['disableSnap'];
+};
+export type RemoveSnap = {
+    type: `${typeof controllerName}:remove`;
+    handler: SnapController['removeSnap'];
+};
+export type GetPermittedSnaps = {
+    type: `${typeof controllerName}:getPermitted`;
+    handler: SnapController['getPermittedSnaps'];
+};
+export type GetAllSnaps = {
+    type: `${typeof controllerName}:getAll`;
+    handler: SnapController['getAllSnaps'];
+};
+export type StopAllSnaps = {
+    type: `${typeof controllerName}:stopAllSnaps`;
+    handler: SnapController['stopAllSnaps'];
+};
+export type IncrementActiveReferences = {
+    type: `${typeof controllerName}:incrementActiveReferences`;
+    handler: SnapController['incrementActiveReferences'];
+};
+export type DecrementActiveReferences = {
+    type: `${typeof controllerName}:decrementActiveReferences`;
+    handler: SnapController['decrementActiveReferences'];
+};
+export type InstallSnaps = {
+    type: `${typeof controllerName}:install`;
+    handler: SnapController['installSnaps'];
+};
+export type GetRegistryMetadata = {
+    type: `${typeof controllerName}:getRegistryMetadata`;
+    handler: SnapController['getRegistryMetadata'];
+};
+export type DisconnectOrigin = {
+    type: `${typeof controllerName}:disconnectOrigin`;
+    handler: SnapController['removeSnapFromSubject'];
+};
+export type RevokeDynamicPermissions = {
+    type: `${typeof controllerName}:revokeDynamicPermissions`;
+    handler: SnapController['revokeDynamicSnapPermissions'];
+};
+export type GetSnapFile = {
+    type: `${typeof controllerName}:getFile`;
+    handler: SnapController['getSnapFile'];
+};
+export type SnapControllerGetStateAction = ControllerGetStateAction<typeof controllerName, SnapControllerState>;
+export type SnapControllerActions = ClearSnapState | GetSnap | GetSnapState | HandleSnapRequest | HasSnap | UpdateBlockedSnaps | UpdateSnapState | EnableSnap | DisableSnap | RemoveSnap | GetPermittedSnaps | InstallSnaps | GetAllSnaps | IncrementActiveReferences | DecrementActiveReferences | GetRegistryMetadata | DisconnectOrigin | RevokeDynamicPermissions | GetSnapFile | SnapControllerGetStateAction | StopAllSnaps;
+export type SnapStateChange = {
+    type: `${typeof controllerName}:stateChange`;
+    payload: [SnapControllerState, Patch[]];
+};
+/**
+ * Emitted when an installed snap has been blocked.
+ */
+export type SnapBlocked = {
+    type: `${typeof controllerName}:snapBlocked`;
+    payload: [snapId: string, blockedSnapInfo?: BlockReason];
+};
+/**
+ * Emitted when a snap installation or update is started.
+ */
+export type SnapInstallStarted = {
+    type: `${typeof controllerName}:snapInstallStarted`;
+    payload: [snapId: SnapId, origin: string, isUpdate: boolean];
+};
+/**
+ * Emitted when a snap installation or update failed.
+ */
+export type SnapInstallFailed = {
+    type: `${typeof controllerName}:snapInstallFailed`;
+    payload: [snapId: SnapId, origin: string, isUpdate: boolean, error: string];
+};
+/**
+ * Emitted when a snap has been started after being added and authorized during
+ * installation.
+ */
+export type SnapInstalled = {
+    type: `${typeof controllerName}:snapInstalled`;
+    payload: [snap: TruncatedSnap, origin: string];
+};
+/**
+ * Emitted when a snap that has previously been fully installed, is uninstalled.
+ */
+export type SnapUninstalled = {
+    type: `${typeof controllerName}:snapUninstalled`;
+    payload: [snap: TruncatedSnap];
+};
+/**
+ * Emitted when an installed snap has been unblocked.
+ */
+export type SnapUnblocked = {
+    type: `${typeof controllerName}:snapUnblocked`;
+    payload: [snapId: string];
+};
+/**
+ * Emitted when a snap is updated.
+ */
+export type SnapUpdated = {
+    type: `${typeof controllerName}:snapUpdated`;
+    payload: [snap: TruncatedSnap, oldVersion: string, origin: string];
+};
+/**
+ * Emitted when a snap is rolled back.
+ */
+export type SnapRolledback = {
+    type: `${typeof controllerName}:snapRolledback`;
+    payload: [snap: TruncatedSnap, failedVersion: string];
+};
+/**
+ * Emitted when a Snap is terminated. This is different from the snap being
+ * stopped as it can also be triggered when a snap fails initialization.
+ */
+export type SnapTerminated = {
+    type: `${typeof controllerName}:snapTerminated`;
+    payload: [snap: TruncatedSnap];
+};
+/**
+ * Emitted when a Snap is enabled by a user.
+ * This is not emitted by default when installing a snap.
+ */
+export type SnapEnabled = {
+    type: `${typeof controllerName}:snapEnabled`;
+    payload: [snap: TruncatedSnap];
+};
+/**
+ * Emitted when a Snap is disabled by a user.
+ */
+export type SnapDisabled = {
+    type: `${typeof controllerName}:snapDisabled`;
+    payload: [snap: TruncatedSnap];
+};
+/**
+ * Emitted when there is a state change.
+ */
+export type SnapControllerStateChangeEvent = ControllerStateChangeEvent<typeof controllerName, SnapControllerState>;
+export type SnapControllerEvents = SnapBlocked | SnapInstalled | SnapUninstalled | SnapInstallStarted | SnapInstallFailed | SnapStateChange | SnapUnblocked | SnapUpdated | SnapRolledback | SnapTerminated | SnapEnabled | SnapDisabled | SnapControllerStateChangeEvent;
+export type AllowedActions = GetEndowments | GetPermissions | GetSubjects | GetSubjectMetadata | AddSubjectMetadata | HasPermission | HasPermissions | RevokePermissions | RevokeAllPermissions | RevokePermissionForAllSubjects | GrantPermissions | AddApprovalRequest | HandleRpcRequestAction | ExecuteSnapAction | TerminateAllSnapsAction | TerminateSnapAction | UpdateCaveat | UpdateRequestState | GetResult | GetMetadata | Update | ResolveVersion | CreateInterface | GetInterface;
+export type AllowedEvents = ExecutionServiceEvents | SnapInstalled | SnapUpdated;
+type SnapControllerMessenger = RestrictedControllerMessenger<typeof controllerName, SnapControllerActions | AllowedActions, SnapControllerEvents | AllowedEvents, AllowedActions['type'], AllowedEvents['type']>;
+type FeatureFlags = {
+    requireAllowlist?: boolean;
+    allowLocalSnaps?: boolean;
+    disableSnapInstallation?: boolean;
+};
+type DynamicFeatureFlags = {
+    disableSnaps?: boolean;
+};
+type SnapControllerArgs = {
+    /**
+     * A teardown function that allows the host to clean up its instrumentation
+     * for a running snap.
+     */
+    closeAllConnections?: CloseAllConnectionsFunction;
+    /**
+     * A list of permissions that are allowed to be dynamic, meaning they can be revoked from the snap whenever.
+     */
+    dynamicPermissions?: string[];
+    /**
+     * The names of endowment permissions whose values are the names of JavaScript
+     * APIs that will be added to the snap execution environment at runtime.
+     */
+    environmentEndowmentPermissions?: string[];
+    /**
+     * Excluded permissions with its associated error message used to forbid certain permssions.
+     */
+    excludedPermissions?: Record<string, string>;
+    /**
+     * The function that will be used by the controller fo make network requests.
+     * Should be compatible with {@link fetch}.
+     */
+    fetchFunction?: typeof fetch;
+    /**
+     * Flags that enable or disable features in the controller.
+     * See {@link FeatureFlags}.
+     */
+    featureFlags: FeatureFlags;
+    /**
+     * How frequently to check whether a snap is idle.
+     */
+    idleTimeCheckInterval?: number;
+    /**
+     * The maximum amount of time that a snap may be idle.
+     */
+    maxIdleTime?: number;
+    /**
+     * The controller messenger.
+     */
+    messenger: SnapControllerMessenger;
+    /**
+     * The maximum amount of time a snap may take to process an RPC request,
+     * unless it is permitted to take longer.
+     */
+    maxRequestTime?: number;
+    /**
+     * The npm registry URL that will be used to fetch published snaps.
+     */
+    npmRegistryUrl?: string;
+    /**
+     * Persisted state that will be used for rehydration.
+     */
+    state?: PersistedSnapControllerState;
+    /**
+     * A function that takes Snap Id and converts it into a class that fetches files.
+     *
+     * Used for test overrides.
+     */
+    detectSnapLocation?: typeof detectSnapLocation;
+    /**
+     * A list of snaps to be preinstalled into the SnapController state on initialization.
+     */
+    preinstalledSnaps?: PreinstalledSnap[] | null;
+    /**
+     * A utility object containing functions required for state encryption.
+     */
+    encryptor: ExportableKeyEncryptor;
+    /**
+     * A hook to access the mnemonic of the user's primary keyring.
+     *
+     * @returns The mnemonic as bytes.
+     */
+    getMnemonic: () => Promise<Uint8Array>;
+    /**
+     * A hook to get dynamic feature flags at runtime.
+     *
+     * @returns The feature flags.
+     */
+    getFeatureFlags: () => DynamicFeatureFlags;
+};
+export declare class SnapController extends BaseController<string, SnapControllerState, SnapControllerMessenger> {
+    #private;
+    private readonly maxRequestTime;
+    constructor({ closeAllConnections, messenger, state, dynamicPermissions, environmentEndowmentPermissions, excludedPermissions, idleTimeCheckInterval, maxIdleTime, maxRequestTime, fetchFunction, featureFlags, detectSnapLocation: detectSnapLocationFunction, preinstalledSnaps, encryptor, getMnemonic, getFeatureFlags, }: SnapControllerArgs);
+    /**
+     * Checks all installed snaps against the block list and
+     * blocks/unblocks snaps as appropriate. See {@link SnapController.blockSnap}
+     * for more information.
+     */
+    updateBlockedSnaps(): Promise<void>;
+    _onUnhandledSnapError(snapId: string, _error: SnapErrorJson): void;
+    _onOutboundRequest(snapId: string): void;
+    _onOutboundResponse(snapId: string): void;
+    /**
+     * Starts the given snap. Throws an error if no such snap exists
+     * or if it is already running.
+     *
+     * @param snapId - The id of the Snap to start.
+     */
+    startSnap(snapId: SnapId): Promise<void>;
+    /**
+     * Enables the given snap. A snap can only be started if it is enabled. A snap
+     * can only be enabled if it isn't blocked.
+     *
+     * @param snapId - The id of the Snap to enable.
+     */
+    enableSnap(snapId: SnapId): void;
+    /**
+     * Disables the given snap. A snap can only be started if it is enabled.
+     *
+     * @param snapId - The id of the Snap to disable.
+     * @returns A promise that resolves once the snap has been disabled.
+     */
+    disableSnap(snapId: SnapId): Promise<void>;
+    /**
+     * Stops the given snap, removes all hooks, closes all connections, and
+     * terminates its worker.
+     *
+     * @param snapId - The id of the Snap to stop.
+     * @param statusEvent - The Snap status event that caused the snap to be
+     * stopped.
+     */
+    stopSnap(snapId: SnapId, statusEvent?: SnapStatusEvents.Stop | SnapStatusEvents.Crash): Promise<void>;
+    /**
+     * Stops all running snaps, removes all hooks, closes all connections, and
+     * terminates their workers.
+     *
+     * @param statusEvent - The Snap status event that caused the snap to be
+     * stopped.
+     */
+    stopAllSnaps(statusEvent?: SnapStatusEvents.Stop | SnapStatusEvents.Crash): Promise<void>;
+    /**
+     * Returns whether the given snap is running.
+     * Throws an error if the snap doesn't exist.
+     *
+     * @param snapId - The id of the Snap to check.
+     * @returns `true` if the snap is running, otherwise `false`.
+     */
+    isRunning(snapId: SnapId): boolean;
+    /**
+     * Returns whether the given snap has been added to state.
+     *
+     * @param snapId - The id of the Snap to check for.
+     * @returns `true` if the snap exists in the controller state, otherwise `false`.
+     */
+    has(snapId: SnapId): boolean;
+    /**
+     * Gets the snap with the given id if it exists, including all data.
+     * This should not be used if the snap is to be serializable, as e.g.
+     * the snap sourceCode may be quite large.
+     *
+     * @param snapId - The id of the Snap to get.
+     * @returns The entire snap object from the controller state.
+     */
+    get(snapId: string): Snap | undefined;
+    /**
+     * Gets the snap with the given id, throws if doesn't.
+     * This should not be used if the snap is to be serializable, as e.g.
+     * the snap sourceCode may be quite large.
+     *
+     * @see {@link SnapController.get}
+     * @throws {@link Error}. If the snap doesn't exist
+     * @param snapId - The id of the snap to get.
+     * @returns The entire snap object.
+     */
+    getExpect(snapId: SnapId): Snap;
+    /**
+     * Gets the snap with the given id if it exists, excluding any
+     * non-serializable or expensive-to-serialize data.
+     *
+     * @param snapId - The id of the Snap to get.
+     * @returns A truncated version of the snap state, that is less expensive to serialize.
+     */
+    getTruncated(snapId: SnapId): TruncatedSnap | null;
+    /**
+     * Gets the snap with the given id, throw if it doesn't exist.
+     *
+     * @throws {@link Error}. If snap doesn't exist
+     * @param snapId - The id of the snap to get.
+     * @returns A truncated version of the snap state, that is less expensive to serialize.
+     */
+    getTruncatedExpect(snapId: SnapId): TruncatedSnap;
+    /**
+     * Updates the own state of the snap with the given id.
+     * This is distinct from the state MetaMask uses to manage snaps.
+     *
+     * @param snapId - The id of the Snap whose state should be updated.
+     * @param newSnapState - The new state of the snap.
+     * @param encrypted - A flag to indicate whether to use encrypted storage or not.
+     */
+    updateSnapState(snapId: SnapId, newSnapState: Record<string, Json>, encrypted: boolean): Promise<void>;
+    /**
+     * Clears the state of the snap with the given id.
+     * This is distinct from the state MetaMask uses to manage snaps.
+     *
+     * @param snapId - The id of the Snap whose state should be cleared.
+     * @param encrypted - A flag to indicate whether to use encrypted storage or not.
+     */
+    clearSnapState(snapId: SnapId, encrypted: boolean): void;
+    /**
+     * Gets the own state of the snap with the given id.
+     * This is distinct from the state MetaMask uses to manage snaps.
+     *
+     * @param snapId - The id of the Snap whose state to get.
+     * @param encrypted - A flag to indicate whether to use encrypted storage or not.
+     * @returns The requested snap state or null if no state exists.
+     */
+    getSnapState(snapId: SnapId, encrypted: boolean): Promise<Json>;
+    /**
+     * Gets a static auxiliary snap file in a chosen file encoding.
+     *
+     * @param snapId - The id of the Snap whose state to get.
+     * @param path - The path to the requested file.
+     * @param encoding - An optional requested file encoding.
+     * @returns The file requested in the chosen file encoding or null if the file is not found.
+     */
+    getSnapFile(snapId: SnapId, path: string, encoding?: AuxiliaryFileEncoding): Promise<string | null>;
+    /**
+     * Completely clear the controller's state: delete all associated data,
+     * handlers, event listeners, and permissions; tear down all snap providers.
+     */
+    clearState(): Promise<void>;
+    /**
+     * Removes the given snap from state, and clears all associated handlers
+     * and listeners.
+     *
+     * @param snapId - The id of the Snap.
+     * @returns A promise that resolves once the snap has been removed.
+     */
+    removeSnap(snapId: SnapId): Promise<void>;
+    /**
+     * Stops the given snaps, removes them from state, and clears all associated
+     * permissions, handlers, and listeners.
+     *
+     * @param snapIds - The ids of the Snaps.
+     */
+    removeSnaps(snapIds: SnapId[]): Promise<void>;
+    /**
+     * Removes a snap's permission (caveat) from the specified subject.
+     *
+     * @param origin - The origin from which to remove the snap.
+     * @param snapId - The id of the snap to remove.
+     */
+    removeSnapFromSubject(origin: string, snapId: SnapId): void;
+    /**
+     * Checks if a list of permissions are dynamic and allowed to be revoked, if they are they will all be revoked.
+     *
+     * @param snapId - The snap ID.
+     * @param permissionNames - The names of the permissions.
+     * @throws If non-dynamic permissions are passed.
+     */
+    revokeDynamicSnapPermissions(snapId: string, permissionNames: NonEmptyArray<string>): void;
+    /**
+     * Handles incrementing the activeReferences counter.
+     *
+     * @param snapId - The snap id of the snap that was referenced.
+     */
+    incrementActiveReferences(snapId: SnapId): void;
+    /**
+     * Handles decrement the activeReferences counter.
+     *
+     * @param snapId - The snap id of the snap that was referenced..
+     */
+    decrementActiveReferences(snapId: SnapId): void;
+    /**
+     * Gets all snaps in their truncated format.
+     *
+     * @returns All installed snaps in their truncated format.
+     */
+    getAllSnaps(): TruncatedSnap[];
+    /**
+     * Gets the serialized permitted snaps of the given origin, if any.
+     *
+     * @param origin - The origin whose permitted snaps to retrieve.
+     * @returns The serialized permitted snaps for the origin.
+     */
+    getPermittedSnaps(origin: string): RequestSnapsResult;
+    /**
+     * Installs the snaps requested by the given origin, returning the snap
+     * object if the origin is permitted to install it, and an authorization error
+     * otherwise.
+     *
+     * @param origin - The origin that requested to install the snaps.
+     * @param requestedSnaps - The snaps to install.
+     * @returns An object of snap ids and snap objects, or errors if a
+     * snap couldn't be installed.
+     */
+    installSnaps(origin: string, requestedSnaps: RequestSnapsParams): Promise<RequestSnapsResult>;
+    /**
+     * Adds, authorizes, and runs the given snap with a snap provider.
+     * Results from this method should be efficiently serializable.
+     *
+     * @param origin - The origin requesting the snap.
+     * @param snapId - The id of the snap.
+     * @param location - The location implementation of the snap.
+     * @param versionRange - The semver range of the snap to install.
+     * @returns The resulting snap object, or an error if something went wrong.
+     */
+    private processRequestedSnap;
+    /**
+     * Updates an installed snap. The flow is similar to
+     * {@link SnapController.installSnaps}. The user will be asked if they want
+     * to update, then approve any permission changes, and finally the snap will
+     * be restarted.
+     *
+     * The update will fail if the user rejects any prompt or if the new version
+     * of the snap is blocked.
+     *
+     * If the original version of the snap was blocked and the update succeeded,
+     * the snap will be unblocked and enabled before it is restarted.
+     *
+     * @param origin - The origin requesting the snap update.
+     * @param snapId - The id of the Snap to be updated.
+     * @param location - The location implementation of the snap.
+     * @param newVersionRange - A semver version range in which the maximum version will be chosen.
+     * @param emitEvent - An optional boolean flag to indicate whether this update should emit an event.
+     * @returns The snap metadata if updated, `null` otherwise.
+     */
+    updateSnap(origin: string, snapId: SnapId, location: SnapLocation, newVersionRange?: string, emitEvent?: boolean): Promise<TruncatedSnap>;
+    /**
+     * Get metadata for the given snap ID.
+     *
+     * @param snapId - The ID of the snap to get metadata for.
+     * @returns The metadata for the given snap ID, or `null` if the snap is not
+     * verified.
+     */
+    getRegistryMetadata(snapId: SnapId): Promise<SnapsRegistryMetadata | null>;
+    /**
+     * Initiates a request for the given snap's initial permissions.
+     * Must be called in order. See processRequestedSnap.
+     *
+     * This function is not hash private yet because of tests.
+     *
+     * @param snapId - The id of the Snap.
+     * @param pendingApproval - Pending approval to update.
+     * @returns The snap's approvedPermissions.
+     */
+    private authorize;
+    destroy(): void;
+    /**
+     * Passes a JSON-RPC request object to the RPC handler function of a snap.
+     *
+     * @param options - A bag of options.
+     * @param options.snapId - The ID of the recipient snap.
+     * @param options.origin - The origin of the RPC request.
+     * @param options.handler - The handler to trigger on the snap for the request.
+     * @param options.request - The JSON-RPC request object.
+     * @returns The result of the JSON-RPC request.
+     */
+    handleRequest({ snapId, origin, handler: handlerType, request: rawRequest, }: SnapRpcHookArgs & {
+        snapId: SnapId;
+    }): Promise<unknown>;
+}
+export {};
+//# sourceMappingURL=SnapController.d.mts.map

package/dist/snaps/SnapController.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SnapController.d.mts","sourceRoot":"","sources":["../../src/snaps/SnapController.ts"],"names":[],"mappings":"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"}