feat: get scan from cache

packages/phishing-controller/CHANGELOG.md

@@ -7,6 +7,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- Added `getScanResultFromCache` which allows getting scan results from the cache directly. ([#6023](https://github.com/MetaMask/core/pull/6023))
+
 ### Changed
 
 - **BREAKING**`scanUrl` hits the v2 endpoint now. Returns `hostname` instead of `domainName` now. ([#5981](https://github.com/MetaMask/core/pull/5981))

packages/phishing-controller/src/PhishingController.test.ts

@@ -3025,6 +3025,38 @@ describe('PhishingController', () => {
       expect(nock.pendingMocks()).toHaveLength(0);
     });
   });
+
+  describe('getScanResultFromCache', () => {
+    it('returns the cached result for URLs that are in the cache', async () => {
+      const controller = getPhishingController();
+      const result = controller.getScanResultFromCache('https://example.com');
+      expect(result).toBeUndefined();
+      nock(PHISHING_DETECTION_BASE_URL)
+        .get(
+          `/${PHISHING_DETECTION_SCAN_ENDPOINT}?url=${encodeURIComponent('example.com')}`,
+        )
+        .reply(200, {
+          recommendedAction: RecommendedAction.None,
+        });
+
+      await controller.scanUrl('https://example.com');
+
+      const result2 = controller.getScanResultFromCache('https://example.com');
+      expect(result2).toBeDefined();
+    });
+
+    it('returns undefined for invalid URLs', async () => {
+      const controller = getPhishingController();
+      const result = controller.getScanResultFromCache('not-a-url');
+      expect(result).toBeUndefined();
+    });
+
+    it('returns undefined for URLs that are not in the cache', async () => {
+      const controller = getPhishingController();
+      const result = controller.getScanResultFromCache('https://example.com');
+      expect(result).toBeUndefined();
+    });
+  });
 });
 
 describe('URL Scan Cache', () => {

packages/phishing-controller/src/PhishingController.ts

@@ -819,6 +819,22 @@ export class PhishingController extends BaseController<
     return combinedResponse;
   };
 
+  /**
+   * Get a cached result if it exists and is not expired
+   *
+   * @param url - The URL to get the cached result for. You can pass in a full URL or just the hostname.
+   * @returns The cached scan result or undefined if not found or expired
+   */
+  getScanResultFromCache = (
+    url: string,
+  ): PhishingDetectionScanResult | undefined => {
+    const [hostname, ok] = getHostnameFromWebUrl(url);
+    if (!ok) {
+      return undefined;
+    }
+    return this.#urlScanCache.get(hostname);
+  };
+
   /**
    * Process a batch of URLs (up to 50) for phishing detection.
    *