@metamask/gator-permissions-controller 0.3.0 → 0.5.0

package/dist/GatorPermissionsController.d.cts

@@ -3,8 +3,10 @@ import { BaseController } from "@metamask/base-controller";
 import type { Messenger } from "@metamask/messenger";
 import type { HandleSnapRequest, HasSnap } from "@metamask/snaps-controllers";
 import type { SnapId } from "@metamask/snaps-sdk";
+import type { TransactionControllerTransactionApprovedEvent, TransactionControllerTransactionConfirmedEvent, TransactionControllerTransactionDroppedEvent, TransactionControllerTransactionFailedEvent, TransactionControllerTransactionRejectedEvent } from "@metamask/transaction-controller";
+import type { Hex, Json } from "@metamask/utils";
 import type { DecodedPermission } from "./decodePermission/index.cjs";
-import { type GatorPermissionsMap, type DelegationDetails } from "./types.cjs";
+import { type GatorPermissionsMap, type DelegationDetails, type RevocationParams, type PendingRevocationParams } from "./types.cjs";
 declare const controllerName = "GatorPermissionsController";
 /**
  * Delegation framework version used to select the correct deployed enforcer
@@ -33,6 +35,13 @@ export type GatorPermissionsControllerState = {
      * Default value is `@metamask/gator-permissions-snap`
      */
     gatorPermissionsProviderSnapId: SnapId;
+    /**
+     * List of gator permission pending a revocation transaction
+     */
+    pendingRevocations: {
+        txId: string;
+        permissionContext: Hex;
+    }[];
 };
 /**
  * Constructs the default {@link GatorPermissionsController} state. This allows
@@ -73,11 +82,25 @@ export type GatorPermissionsControllerDecodePermissionFromPermissionContextForOr
     type: `${typeof controllerName}:decodePermissionFromPermissionContextForOrigin`;
     handler: GatorPermissionsController['decodePermissionFromPermissionContextForOrigin'];
 };
+/**
+ * The action which can be used to submit a revocation.
+ */
+export type GatorPermissionsControllerSubmitRevocationAction = {
+    type: `${typeof controllerName}:submitRevocation`;
+    handler: GatorPermissionsController['submitRevocation'];
+};
+/**
+ * The action which can be used to add a pending revocation.
+ */
+export type GatorPermissionsControllerAddPendingRevocationAction = {
+    type: `${typeof controllerName}:addPendingRevocation`;
+    handler: GatorPermissionsController['addPendingRevocation'];
+};
 /**
  * All actions that {@link GatorPermissionsController} registers, to be called
  * externally.
  */
-export type GatorPermissionsControllerActions = GatorPermissionsControllerGetStateAction | GatorPermissionsControllerFetchAndUpdateGatorPermissionsAction | GatorPermissionsControllerEnableGatorPermissionsAction | GatorPermissionsControllerDisableGatorPermissionsAction | GatorPermissionsControllerDecodePermissionFromPermissionContextForOriginAction;
+export type GatorPermissionsControllerActions = GatorPermissionsControllerGetStateAction | GatorPermissionsControllerFetchAndUpdateGatorPermissionsAction | GatorPermissionsControllerEnableGatorPermissionsAction | GatorPermissionsControllerDisableGatorPermissionsAction | GatorPermissionsControllerDecodePermissionFromPermissionContextForOriginAction | GatorPermissionsControllerSubmitRevocationAction | GatorPermissionsControllerAddPendingRevocationAction;
 /**
  * All actions that {@link GatorPermissionsController} calls internally.
  *
@@ -97,7 +120,7 @@ export type GatorPermissionsControllerEvents = GatorPermissionsControllerStateCh
 /**
  * Events that {@link GatorPermissionsController} is allowed to subscribe to internally.
  */
-type AllowedEvents = GatorPermissionsControllerStateChangeEvent;
+type AllowedEvents = GatorPermissionsControllerStateChangeEvent | TransactionControllerTransactionApprovedEvent | TransactionControllerTransactionRejectedEvent | TransactionControllerTransactionConfirmedEvent | TransactionControllerTransactionFailedEvent | TransactionControllerTransactionDroppedEvent;
 /**
  * Messenger type for the GatorPermissionsController.
  */
@@ -138,13 +161,23 @@ export default class GatorPermissionsController extends BaseController<typeof co
      * Clears the gator permissions map and disables the feature.
      */
     disableGatorPermissions(): Promise<void>;
+    /**
+     * Gets the pending revocations list.
+     *
+     * @returns The pending revocations list.
+     */
+    get pendingRevocations(): {
+        txId: string;
+        permissionContext: Hex;
+    }[];
     /**
      * Fetches the gator permissions from profile sync and updates the state.
      *
+     * @param params - Optional parameters to pass to the snap's getGrantedPermissions method.
      * @returns A promise that resolves to the gator permissions map.
      * @throws {GatorPermissionsFetchError} If the gator permissions fetch fails.
      */
-    fetchAndUpdateGatorPermissions(): Promise<GatorPermissionsMap>;
+    fetchAndUpdateGatorPermissions(params?: Json): Promise<GatorPermissionsMap>;
     /**
      * Decodes a permission context into a structured permission for a specific origin.
      *
@@ -174,6 +207,33 @@ export default class GatorPermissionsController extends BaseController<typeof co
         };
         delegation: DelegationDetails;
     }): DecodedPermission;
+    /**
+     * Submits a revocation to the gator permissions provider snap.
+     *
+     * @param revocationParams - The revocation parameters containing the permission context.
+     * @returns A promise that resolves when the revocation is submitted successfully.
+     * @throws {GatorPermissionsNotEnabledError} If the gator permissions are not enabled.
+     * @throws {GatorPermissionsProviderError} If the snap request fails.
+     */
+    submitRevocation(revocationParams: RevocationParams): Promise<void>;
+    /**
+     * Adds a pending revocation that will be submitted once the transaction is confirmed.
+     *
+     * This method sets up listeners for the user's approval/rejection decision and
+     * terminal transaction states (confirmed, failed, dropped). The flow is:
+     * 1. Wait for user to approve or reject the transaction
+     * 2. If approved, add to pending revocations state
+     * 3. If rejected, cleanup without adding to state
+     * 4. If confirmed, submit the revocation
+     * 5. If failed or dropped, cleanup
+     *
+     * Includes a timeout safety net to prevent memory leaks if the transaction never
+     * reaches a terminal state.
+     *
+     * @param params - The pending revocation parameters.
+     * @returns A promise that resolves when the listener is set up.
+     */
+    addPendingRevocation(params: PendingRevocationParams): Promise<void>;
 }
 export {};
 //# sourceMappingURL=GatorPermissionsController.d.cts.map

package/dist/GatorPermissionsController.d.cts.map

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

package/dist/GatorPermissionsController.d.mts

@@ -3,8 +3,10 @@ import { BaseController } from "@metamask/base-controller";
 import type { Messenger } from "@metamask/messenger";
 import type { HandleSnapRequest, HasSnap } from "@metamask/snaps-controllers";
 import type { SnapId } from "@metamask/snaps-sdk";
+import type { TransactionControllerTransactionApprovedEvent, TransactionControllerTransactionConfirmedEvent, TransactionControllerTransactionDroppedEvent, TransactionControllerTransactionFailedEvent, TransactionControllerTransactionRejectedEvent } from "@metamask/transaction-controller";
+import type { Hex, Json } from "@metamask/utils";
 import type { DecodedPermission } from "./decodePermission/index.mjs";
-import { type GatorPermissionsMap, type DelegationDetails } from "./types.mjs";
+import { type GatorPermissionsMap, type DelegationDetails, type RevocationParams, type PendingRevocationParams } from "./types.mjs";
 declare const controllerName = "GatorPermissionsController";
 /**
  * Delegation framework version used to select the correct deployed enforcer
@@ -33,6 +35,13 @@ export type GatorPermissionsControllerState = {
      * Default value is `@metamask/gator-permissions-snap`
      */
     gatorPermissionsProviderSnapId: SnapId;
+    /**
+     * List of gator permission pending a revocation transaction
+     */
+    pendingRevocations: {
+        txId: string;
+        permissionContext: Hex;
+    }[];
 };
 /**
  * Constructs the default {@link GatorPermissionsController} state. This allows
@@ -73,11 +82,25 @@ export type GatorPermissionsControllerDecodePermissionFromPermissionContextForOr
     type: `${typeof controllerName}:decodePermissionFromPermissionContextForOrigin`;
     handler: GatorPermissionsController['decodePermissionFromPermissionContextForOrigin'];
 };
+/**
+ * The action which can be used to submit a revocation.
+ */
+export type GatorPermissionsControllerSubmitRevocationAction = {
+    type: `${typeof controllerName}:submitRevocation`;
+    handler: GatorPermissionsController['submitRevocation'];
+};
+/**
+ * The action which can be used to add a pending revocation.
+ */
+export type GatorPermissionsControllerAddPendingRevocationAction = {
+    type: `${typeof controllerName}:addPendingRevocation`;
+    handler: GatorPermissionsController['addPendingRevocation'];
+};
 /**
  * All actions that {@link GatorPermissionsController} registers, to be called
  * externally.
  */
-export type GatorPermissionsControllerActions = GatorPermissionsControllerGetStateAction | GatorPermissionsControllerFetchAndUpdateGatorPermissionsAction | GatorPermissionsControllerEnableGatorPermissionsAction | GatorPermissionsControllerDisableGatorPermissionsAction | GatorPermissionsControllerDecodePermissionFromPermissionContextForOriginAction;
+export type GatorPermissionsControllerActions = GatorPermissionsControllerGetStateAction | GatorPermissionsControllerFetchAndUpdateGatorPermissionsAction | GatorPermissionsControllerEnableGatorPermissionsAction | GatorPermissionsControllerDisableGatorPermissionsAction | GatorPermissionsControllerDecodePermissionFromPermissionContextForOriginAction | GatorPermissionsControllerSubmitRevocationAction | GatorPermissionsControllerAddPendingRevocationAction;
 /**
  * All actions that {@link GatorPermissionsController} calls internally.
  *
@@ -97,7 +120,7 @@ export type GatorPermissionsControllerEvents = GatorPermissionsControllerStateCh
 /**
  * Events that {@link GatorPermissionsController} is allowed to subscribe to internally.
  */
-type AllowedEvents = GatorPermissionsControllerStateChangeEvent;
+type AllowedEvents = GatorPermissionsControllerStateChangeEvent | TransactionControllerTransactionApprovedEvent | TransactionControllerTransactionRejectedEvent | TransactionControllerTransactionConfirmedEvent | TransactionControllerTransactionFailedEvent | TransactionControllerTransactionDroppedEvent;
 /**
  * Messenger type for the GatorPermissionsController.
  */
@@ -138,13 +161,23 @@ export default class GatorPermissionsController extends BaseController<typeof co
      * Clears the gator permissions map and disables the feature.
      */
     disableGatorPermissions(): Promise<void>;
+    /**
+     * Gets the pending revocations list.
+     *
+     * @returns The pending revocations list.
+     */
+    get pendingRevocations(): {
+        txId: string;
+        permissionContext: Hex;
+    }[];
     /**
      * Fetches the gator permissions from profile sync and updates the state.
      *
+     * @param params - Optional parameters to pass to the snap's getGrantedPermissions method.
      * @returns A promise that resolves to the gator permissions map.
      * @throws {GatorPermissionsFetchError} If the gator permissions fetch fails.
      */
-    fetchAndUpdateGatorPermissions(): Promise<GatorPermissionsMap>;
+    fetchAndUpdateGatorPermissions(params?: Json): Promise<GatorPermissionsMap>;
     /**
      * Decodes a permission context into a structured permission for a specific origin.
      *
@@ -174,6 +207,33 @@ export default class GatorPermissionsController extends BaseController<typeof co
         };
         delegation: DelegationDetails;
     }): DecodedPermission;
+    /**
+     * Submits a revocation to the gator permissions provider snap.
+     *
+     * @param revocationParams - The revocation parameters containing the permission context.
+     * @returns A promise that resolves when the revocation is submitted successfully.
+     * @throws {GatorPermissionsNotEnabledError} If the gator permissions are not enabled.
+     * @throws {GatorPermissionsProviderError} If the snap request fails.
+     */
+    submitRevocation(revocationParams: RevocationParams): Promise<void>;
+    /**
+     * Adds a pending revocation that will be submitted once the transaction is confirmed.
+     *
+     * This method sets up listeners for the user's approval/rejection decision and
+     * terminal transaction states (confirmed, failed, dropped). The flow is:
+     * 1. Wait for user to approve or reject the transaction
+     * 2. If approved, add to pending revocations state
+     * 3. If rejected, cleanup without adding to state
+     * 4. If confirmed, submit the revocation
+     * 5. If failed or dropped, cleanup
+     *
+     * Includes a timeout safety net to prevent memory leaks if the transaction never
+     * reaches a terminal state.
+     *
+     * @param params - The pending revocation parameters.
+     * @returns A promise that resolves when the listener is set up.
+     */
+    addPendingRevocation(params: PendingRevocationParams): Promise<void>;
 }
 export {};
 //# sourceMappingURL=GatorPermissionsController.d.mts.map

package/dist/GatorPermissionsController.d.mts.map

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

package/dist/GatorPermissionsController.mjs

@@ -3,7 +3,7 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
-var _GatorPermissionsController_instances, _GatorPermissionsController_setIsFetchingGatorPermissions, _GatorPermissionsController_setIsGatorPermissionsEnabled, _GatorPermissionsController_registerMessageHandlers, _GatorPermissionsController_assertGatorPermissionsEnabled, _GatorPermissionsController_handleSnapRequestToGatorPermissionsProvider, _GatorPermissionsController_sanitizeStoredGatorPermission, _GatorPermissionsController_categorizePermissionsDataByTypeAndChainId;
+var _GatorPermissionsController_instances, _GatorPermissionsController_setIsFetchingGatorPermissions, _GatorPermissionsController_setIsGatorPermissionsEnabled, _GatorPermissionsController_addPendingRevocationToState, _GatorPermissionsController_removePendingRevocationFromStateByTxId, _GatorPermissionsController_removePendingRevocationFromStateByPermissionContext, _GatorPermissionsController_registerMessageHandlers, _GatorPermissionsController_assertGatorPermissionsEnabled, _GatorPermissionsController_handleSnapRequestToGatorPermissionsProvider, _GatorPermissionsController_sanitizeStoredGatorPermission, _GatorPermissionsController_categorizePermissionsDataByTypeAndChainId;
 import { BaseController } from "@metamask/base-controller";
 import { DELEGATOR_CONTRACTS } from "@metamask/delegation-deployments";
 import { HandlerType } from "@metamask/snaps-utils";
@@ -29,6 +29,11 @@ const defaultGatorPermissionsMap = {
  * contract addresses from `@metamask/delegation-deployments`.
  */
 export const DELEGATION_FRAMEWORK_VERSION = '1.3.0';
+/**
+ * Timeout duration for pending revocations (2 hours in milliseconds).
+ * After this time, event listeners will be cleaned up to prevent memory leaks.
+ */
+const PENDING_REVOCATION_TIMEOUT = 2 * 60 * 60 * 1000;
 const contractsByChainId = DELEGATOR_CONTRACTS[DELEGATION_FRAMEWORK_VERSION];
 const gatorPermissionsControllerMetadata = {
     isGatorPermissionsEnabled: {
@@ -55,6 +60,12 @@ const gatorPermissionsControllerMetadata = {
         includeInDebugSnapshot: false,
         usedInUi: false,
     },
+    pendingRevocations: {
+        includeInStateLogs: true,
+        persist: false,
+        includeInDebugSnapshot: false,
+        usedInUi: true,
+    },
 };
 /**
  * Constructs the default {@link GatorPermissionsController} state. This allows
@@ -70,6 +81,7 @@ export function getDefaultGatorPermissionsControllerState() {
         gatorPermissionsMapSerialized: serializeGatorPermissionsMap(defaultGatorPermissionsMap),
         isFetchingGatorPermissions: false,
         gatorPermissionsProviderSnapId: defaultGatorPermissionsProviderSnapId,
+        pendingRevocations: [],
     };
 }
 /**
@@ -128,18 +140,28 @@ class GatorPermissionsController extends BaseController {
             state.gatorPermissionsMapSerialized = serializeGatorPermissionsMap(defaultGatorPermissionsMap);
         });
     }
+    /**
+     * Gets the pending revocations list.
+     *
+     * @returns The pending revocations list.
+     */
+    get pendingRevocations() {
+        return this.state.pendingRevocations;
+    }
     /**
      * Fetches the gator permissions from profile sync and updates the state.
      *
+     * @param params - Optional parameters to pass to the snap's getGrantedPermissions method.
      * @returns A promise that resolves to the gator permissions map.
      * @throws {GatorPermissionsFetchError} If the gator permissions fetch fails.
      */
-    async fetchAndUpdateGatorPermissions() {
+    async fetchAndUpdateGatorPermissions(params) {
         try {
             __classPrivateFieldGet(this, _GatorPermissionsController_instances, "m", _GatorPermissionsController_setIsFetchingGatorPermissions).call(this, true);
             __classPrivateFieldGet(this, _GatorPermissionsController_instances, "m", _GatorPermissionsController_assertGatorPermissionsEnabled).call(this);
             const permissionsData = await __classPrivateFieldGet(this, _GatorPermissionsController_instances, "m", _GatorPermissionsController_handleSnapRequestToGatorPermissionsProvider).call(this, {
                 snapId: this.state.gatorPermissionsProviderSnapId,
+                params,
             });
             const gatorPermissionsMap = __classPrivateFieldGet(this, _GatorPermissionsController_instances, "m", _GatorPermissionsController_categorizePermissionsDataByTypeAndChainId).call(this, permissionsData);
             this.update((state) => {
@@ -217,6 +239,189 @@ class GatorPermissionsController extends BaseController {
             });
         }
     }
+    /**
+     * Submits a revocation to the gator permissions provider snap.
+     *
+     * @param revocationParams - The revocation parameters containing the permission context.
+     * @returns A promise that resolves when the revocation is submitted successfully.
+     * @throws {GatorPermissionsNotEnabledError} If the gator permissions are not enabled.
+     * @throws {GatorPermissionsProviderError} If the snap request fails.
+     */
+    async submitRevocation(revocationParams) {
+        controllerLog('submitRevocation method called', {
+            permissionContext: revocationParams.permissionContext,
+        });
+        __classPrivateFieldGet(this, _GatorPermissionsController_instances, "m", _GatorPermissionsController_assertGatorPermissionsEnabled).call(this);
+        try {
+            const snapRequest = {
+                snapId: this.state.gatorPermissionsProviderSnapId,
+                origin: 'metamask',
+                handler: HandlerType.OnRpcRequest,
+                request: {
+                    jsonrpc: '2.0',
+                    method: GatorPermissionsSnapRpcMethod.PermissionProviderSubmitRevocation,
+                    params: revocationParams,
+                },
+            };
+            const result = await this.messenger.call('SnapController:handleRequest', snapRequest);
+            __classPrivateFieldGet(this, _GatorPermissionsController_instances, "m", _GatorPermissionsController_removePendingRevocationFromStateByPermissionContext).call(this, revocationParams.permissionContext);
+            controllerLog('Successfully submitted revocation', {
+                permissionContext: revocationParams.permissionContext,
+                result,
+            });
+        }
+        catch (error) {
+            controllerLog('Failed to submit revocation', {
+                error,
+                permissionContext: revocationParams.permissionContext,
+            });
+            throw new GatorPermissionsProviderError({
+                method: GatorPermissionsSnapRpcMethod.PermissionProviderSubmitRevocation,
+                cause: error,
+            });
+        }
+    }
+    /**
+     * Adds a pending revocation that will be submitted once the transaction is confirmed.
+     *
+     * This method sets up listeners for the user's approval/rejection decision and
+     * terminal transaction states (confirmed, failed, dropped). The flow is:
+     * 1. Wait for user to approve or reject the transaction
+     * 2. If approved, add to pending revocations state
+     * 3. If rejected, cleanup without adding to state
+     * 4. If confirmed, submit the revocation
+     * 5. If failed or dropped, cleanup
+     *
+     * Includes a timeout safety net to prevent memory leaks if the transaction never
+     * reaches a terminal state.
+     *
+     * @param params - The pending revocation parameters.
+     * @returns A promise that resolves when the listener is set up.
+     */
+    async addPendingRevocation(params) {
+        const { txId, permissionContext } = params;
+        controllerLog('addPendingRevocation method called', {
+            txId,
+            permissionContext,
+        });
+        __classPrivateFieldGet(this, _GatorPermissionsController_instances, "m", _GatorPermissionsController_assertGatorPermissionsEnabled).call(this);
+        // Track handlers and timeout for cleanup
+        const handlers = {
+            approved: undefined,
+            rejected: undefined,
+            confirmed: undefined,
+            failed: undefined,
+            dropped: undefined,
+            timeoutId: undefined,
+        };
+        // Helper to unsubscribe from approval/rejection events after decision is made
+        const cleanupApprovalHandlers = () => {
+            if (handlers.approved) {
+                this.messenger.unsubscribe('TransactionController:transactionApproved', handlers.approved);
+                handlers.approved = undefined;
+            }
+            if (handlers.rejected) {
+                this.messenger.unsubscribe('TransactionController:transactionRejected', handlers.rejected);
+                handlers.rejected = undefined;
+            }
+        };
+        // Cleanup function to unsubscribe from all events and clear timeout
+        const cleanup = (txIdToRemove, removeFromState = true) => {
+            cleanupApprovalHandlers();
+            if (handlers.confirmed) {
+                this.messenger.unsubscribe('TransactionController:transactionConfirmed', handlers.confirmed);
+            }
+            if (handlers.failed) {
+                this.messenger.unsubscribe('TransactionController:transactionFailed', handlers.failed);
+            }
+            if (handlers.dropped) {
+                this.messenger.unsubscribe('TransactionController:transactionDropped', handlers.dropped);
+            }
+            if (handlers.timeoutId !== undefined) {
+                clearTimeout(handlers.timeoutId);
+            }
+            // Remove the pending revocation from the state (only if it was added)
+            if (removeFromState) {
+                __classPrivateFieldGet(this, _GatorPermissionsController_instances, "m", _GatorPermissionsController_removePendingRevocationFromStateByTxId).call(this, txIdToRemove);
+            }
+        };
+        // Handle approved transaction - add to pending revocations state
+        handlers.approved = (payload) => {
+            if (payload.transactionMeta.id === txId) {
+                controllerLog('Transaction approved by user, adding to pending revocations', {
+                    txId,
+                    permissionContext,
+                });
+                __classPrivateFieldGet(this, _GatorPermissionsController_instances, "m", _GatorPermissionsController_addPendingRevocationToState).call(this, txId, permissionContext);
+                // Unsubscribe from approval/rejection events since decision is made
+                cleanupApprovalHandlers();
+            }
+        };
+        // Handle rejected transaction - cleanup without adding to state
+        handlers.rejected = (payload) => {
+            if (payload.transactionMeta.id === txId) {
+                controllerLog('Transaction rejected by user, cleaning up listeners', {
+                    txId,
+                    permissionContext,
+                });
+                // Don't remove from state since it was never added
+                cleanup(payload.transactionMeta.id, false);
+            }
+        };
+        // Handle confirmed transaction - submit revocation
+        handlers.confirmed = (transactionMeta) => {
+            if (transactionMeta.id === txId) {
+                controllerLog('Transaction confirmed, submitting revocation', {
+                    txId,
+                    permissionContext,
+                });
+                this.submitRevocation({ permissionContext }).catch((error) => {
+                    controllerLog('Failed to submit revocation after transaction confirmed', {
+                        txId,
+                        permissionContext,
+                        error,
+                    });
+                });
+                cleanup(transactionMeta.id);
+            }
+        };
+        // Handle failed transaction - cleanup without submitting revocation
+        handlers.failed = (payload) => {
+            if (payload.transactionMeta.id === txId) {
+                controllerLog('Transaction failed, cleaning up revocation listener', {
+                    txId,
+                    permissionContext,
+                    error: payload.error,
+                });
+                cleanup(payload.transactionMeta.id);
+            }
+        };
+        // Handle dropped transaction - cleanup without submitting revocation
+        handlers.dropped = (payload) => {
+            if (payload.transactionMeta.id === txId) {
+                controllerLog('Transaction dropped, cleaning up revocation listener', {
+                    txId,
+                    permissionContext,
+                });
+                cleanup(payload.transactionMeta.id);
+            }
+        };
+        // Subscribe to user approval/rejection events
+        this.messenger.subscribe('TransactionController:transactionApproved', handlers.approved);
+        this.messenger.subscribe('TransactionController:transactionRejected', handlers.rejected);
+        // Subscribe to terminal transaction events
+        this.messenger.subscribe('TransactionController:transactionConfirmed', handlers.confirmed);
+        this.messenger.subscribe('TransactionController:transactionFailed', handlers.failed);
+        this.messenger.subscribe('TransactionController:transactionDropped', handlers.dropped);
+        // Set timeout as safety net to prevent memory leaks
+        handlers.timeoutId = setTimeout(() => {
+            controllerLog('Pending revocation timed out, cleaning up listeners', {
+                txId,
+                permissionContext,
+            });
+            cleanup(txId);
+        }, PENDING_REVOCATION_TIMEOUT);
+    }
 }
 _GatorPermissionsController_instances = new WeakSet(), _GatorPermissionsController_setIsFetchingGatorPermissions = function _GatorPermissionsController_setIsFetchingGatorPermissions(isFetchingGatorPermissions) {
     this.update((state) => {
@@ -226,11 +431,29 @@ _GatorPermissionsController_instances = new WeakSet(), _GatorPermissionsControll
     this.update((state) => {
         state.isGatorPermissionsEnabled = isGatorPermissionsEnabled;
     });
+}, _GatorPermissionsController_addPendingRevocationToState = function _GatorPermissionsController_addPendingRevocationToState(txId, permissionContext) {
+    this.update((state) => {
+        state.pendingRevocations = [
+            ...state.pendingRevocations,
+            { txId, permissionContext },
+        ];
+    });
+}, _GatorPermissionsController_removePendingRevocationFromStateByTxId = function _GatorPermissionsController_removePendingRevocationFromStateByTxId(txId) {
+    this.update((state) => {
+        state.pendingRevocations = state.pendingRevocations.filter((pendingRevocations) => pendingRevocations.txId !== txId);
+    });
+}, _GatorPermissionsController_removePendingRevocationFromStateByPermissionContext = function _GatorPermissionsController_removePendingRevocationFromStateByPermissionContext(permissionContext) {
+    this.update((state) => {
+        state.pendingRevocations = state.pendingRevocations.filter((pendingRevocations) => pendingRevocations.permissionContext !== permissionContext);
+    });
 }, _GatorPermissionsController_registerMessageHandlers = function _GatorPermissionsController_registerMessageHandlers() {
     this.messenger.registerActionHandler(`${controllerName}:fetchAndUpdateGatorPermissions`, this.fetchAndUpdateGatorPermissions.bind(this));
     this.messenger.registerActionHandler(`${controllerName}:enableGatorPermissions`, this.enableGatorPermissions.bind(this));
     this.messenger.registerActionHandler(`${controllerName}:disableGatorPermissions`, this.disableGatorPermissions.bind(this));
     this.messenger.registerActionHandler(`${controllerName}:decodePermissionFromPermissionContextForOrigin`, this.decodePermissionFromPermissionContextForOrigin.bind(this));
+    const submitRevocationAction = `${controllerName}:submitRevocation`;
+    this.messenger.registerActionHandler(submitRevocationAction, this.submitRevocation.bind(this));
+    this.messenger.registerActionHandler(`${controllerName}:addPendingRevocation`, this.addPendingRevocation.bind(this));
 }, _GatorPermissionsController_assertGatorPermissionsEnabled = function _GatorPermissionsController_assertGatorPermissionsEnabled() {
     if (!this.state.isGatorPermissionsEnabled) {
         throw new GatorPermissionsNotEnabledError();
@@ -241,9 +464,10 @@ _GatorPermissionsController_instances = new WeakSet(), _GatorPermissionsControll
  *
  * @param args - The request parameters.
  * @param args.snapId - The ID of the Snap of the gator permissions provider snap.
+ * @param args.params - Optional parameters to pass to the snap method.
  * @returns A promise that resolves with the gator permissions.
  */
-async function _GatorPermissionsController_handleSnapRequestToGatorPermissionsProvider({ snapId, }) {
+async function _GatorPermissionsController_handleSnapRequestToGatorPermissionsProvider({ snapId, params, }) {
     try {
         const response = (await this.messenger.call('SnapController:handleRequest', {
             snapId,
@@ -252,6 +476,7 @@ async function _GatorPermissionsController_handleSnapRequestToGatorPermissionsPr
             request: {
                 jsonrpc: '2.0',
                 method: GatorPermissionsSnapRpcMethod.PermissionProviderGetGrantedPermissions,
+                ...(params !== undefined && { params }),
             },
         }));
         return response;