@metamask/ramps-controller 9.0.0 → 10.1.0

package/CHANGELOG.md

@@ -7,6 +7,34 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [10.1.0]
+
+### Added
+
+- Added `orders: RampsOrder[]` to controller state with persistence, along with crud methods([#8045](https://github.com/MetaMask/core/pull/8045))
+- Added `apiMessage` property to `TransakApiError` to surface human-readable error messages from the Transak API (e.g. OTP rate-limit cooldown) ([#8072](https://github.com/MetaMask/core/pull/8072))
+- Added `RampsController:orderStatusChanged` event, published when a polled order's status transitions ([#8045](https://github.com/MetaMask/core/pull/8045))
+- Add messenger actions for `RampsController:setSelectedToken`, `RampsController:getQuotes`, and `RampsController:getOrder`, register their handlers in `RampsController`, and export the action types from the package index ([#8081](https://github.com/MetaMask/core/pull/8081))
+
+## [10.0.0]
+
+### Changed
+
+- **BREAKING:** Remove `state.quotes` and `state.widgetUrl` from RampsController state. Quote and widget URL data are now managed by consuming components ([#8013](https://github.com/MetaMask/core/pull/8013))
+- **BREAKING:** Remove `fetchQuotesForSelection()` and `setSelectedQuote()`. Components call `getQuotes()` directly and manage selection locally ([#8013](https://github.com/MetaMask/core/pull/8013))
+- Simplify `getWidgetUrl()` to a pure fetch-and-return API; it no longer reads or writes controller state ([#8013](https://github.com/MetaMask/core/pull/8013))
+- Improve `TransakService` error handling ([#8010](https://github.com/MetaMask/core/pull/8010))
+- **BREAKING:** Replace `startQuotePolling()`/`stopQuotePolling()` with `fetchQuotesForSelection()` — quotes are now fetched once per call instead of polling on a 15-second interval ([#7999](https://github.com/MetaMask/core/pull/7999))
+
+### Removed
+
+- Remove `stopQuotePolling()` method (no interval to stop) ([#7999](https://github.com/MetaMask/core/pull/7999))
+- Remove internal polling restart logic (`#restartPollingIfActive`) from `setSelectedProvider`, `setSelectedToken`, and `setSelectedPaymentMethod` ([#7999](https://github.com/MetaMask/core/pull/7999))
+
+### Fixed
+
+- Fix RampsController flaky test ([#8018](https://github.com/MetaMask/core/pull/8018))
+
 ## [9.0.0]
 
 ### Added
@@ -164,7 +192,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Add `OnRampService` for interacting with the OnRamp API
   - Add geolocation detection via IP address lookup
 
-[Unreleased]: https://github.com/MetaMask/core/compare/@metamask/ramps-controller@9.0.0...HEAD
+[Unreleased]: https://github.com/MetaMask/core/compare/@metamask/ramps-controller@10.1.0...HEAD
+[10.1.0]: https://github.com/MetaMask/core/compare/@metamask/ramps-controller@10.0.0...@metamask/ramps-controller@10.1.0
+[10.0.0]: https://github.com/MetaMask/core/compare/@metamask/ramps-controller@9.0.0...@metamask/ramps-controller@10.0.0
 [9.0.0]: https://github.com/MetaMask/core/compare/@metamask/ramps-controller@8.1.0...@metamask/ramps-controller@9.0.0
 [8.1.0]: https://github.com/MetaMask/core/compare/@metamask/ramps-controller@8.0.0...@metamask/ramps-controller@8.1.0
 [8.0.0]: https://github.com/MetaMask/core/compare/@metamask/ramps-controller@7.1.0...@metamask/ramps-controller@8.0.0

package/dist/RampsController.cjs

@@ -10,10 +10,11 @@ var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
     return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
 };
-var _RampsController_instances, _RampsController_requestCacheTTL, _RampsController_requestCacheMaxSize, _RampsController_pendingRequests, _RampsController_pendingResourceCount, _RampsController_quotePollingInterval, _RampsController_quotePollingOptions, _RampsController_clearPendingResourceCountForDependentResources, _RampsController_abortDependentRequests, _RampsController_mutateRequests, _RampsController_removeRequestState, _RampsController_cleanupState, _RampsController_fireAndForget, _RampsController_restartPollingIfActive, _RampsController_requireRegion, _RampsController_isRegionCurrent, _RampsController_isTokenCurrent, _RampsController_isProviderCurrent, _RampsController_updateResourceField, _RampsController_setResourceLoading, _RampsController_setResourceError, _RampsController_updateRequestState, _RampsController_syncWidgetUrl, _RampsController_syncTransakAuthOnError;
+var _RampsController_instances, _RampsController_requestCacheTTL, _RampsController_requestCacheMaxSize, _RampsController_pendingRequests, _RampsController_pendingResourceCount, _RampsController_orderPollingMeta, _RampsController_orderPollingTimer, _RampsController_isPolling, _RampsController_clearPendingResourceCountForDependentResources, _RampsController_abortDependentRequests, _RampsController_registerActionHandlers, _RampsController_mutateRequests, _RampsController_removeRequestState, _RampsController_cleanupState, _RampsController_fireAndForget, _RampsController_requireRegion, _RampsController_isRegionCurrent, _RampsController_isTokenCurrent, _RampsController_isProviderCurrent, _RampsController_updateResourceField, _RampsController_setResourceLoading, _RampsController_setResourceError, _RampsController_updateRequestState, _RampsController_refreshOrder, _RampsController_pollPendingOrders, _RampsController_syncTransakAuthOnError;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RampsController = exports.getDefaultRampsControllerState = exports.RAMPS_CONTROLLER_REQUIRED_SERVICE_ACTIONS = exports.controllerName = void 0;
 const base_controller_1 = require("@metamask/base-controller");
+const RampsService_1 = require("./RampsService.cjs");
 const RequestCache_1 = require("./RequestCache.cjs");
 // === GENERAL ===
 /**
@@ -101,28 +102,22 @@ const rampsControllerMetadata = {
         includeInStateLogs: true,
         usedInUi: true,
     },
-    quotes: {
-        persist: false,
-        includeInDebugSnapshot: true,
-        includeInStateLogs: false,
-        usedInUi: true,
-    },
-    widgetUrl: {
+    requests: {
         persist: false,
         includeInDebugSnapshot: true,
         includeInStateLogs: false,
         usedInUi: true,
     },
-    requests: {
+    nativeProviders: {
         persist: false,
         includeInDebugSnapshot: true,
         includeInStateLogs: false,
         usedInUi: true,
     },
-    nativeProviders: {
-        persist: false,
+    orders: {
+        persist: true,
         includeInDebugSnapshot: true,
-        includeInStateLogs: false,
+        includeInStateLogs: true,
         usedInUi: true,
     },
 };
@@ -158,8 +153,6 @@ function getDefaultRampsControllerState() {
         providers: createDefaultResourceState([], null),
         tokens: createDefaultResourceState(null, null),
         paymentMethods: createDefaultResourceState([], null),
-        quotes: createDefaultResourceState(null, null),
-        widgetUrl: createDefaultResourceState(null),
         requests: {},
         nativeProviders: {
             transak: {
@@ -169,6 +162,7 @@ function getDefaultRampsControllerState() {
                 kycRequirement: createDefaultResourceState(null),
             },
         },
+        orders: [],
     };
 }
 exports.getDefaultRampsControllerState = getDefaultRampsControllerState;
@@ -176,7 +170,6 @@ const DEPENDENT_RESOURCE_KEYS = [
     'providers',
     'tokens',
     'paymentMethods',
-    'quotes',
 ];
 const DEPENDENT_RESOURCE_KEYS_SET = new Set(DEPENDENT_RESOURCE_KEYS);
 function resetResource(state, resourceType, defaultResource) {
@@ -188,20 +181,7 @@ function resetResource(state, resourceType, defaultResource) {
     resource.error = def.error;
 }
 /**
- * Resets the widgetUrl resource to its default state.
- * Mutates state in place; use from within controller update() for atomic updates.
- *
- * @param state - The state object to mutate.
- */
-function resetWidgetUrl(state) {
-    const def = getDefaultRampsControllerState().widgetUrl;
-    state.widgetUrl.data = def.data;
-    state.widgetUrl.selected = def.selected;
-    state.widgetUrl.isLoading = def.isLoading;
-    state.widgetUrl.error = def.error;
-}
-/**
- * Resets region-dependent resources (userRegion, providers, tokens, paymentMethods, quotes).
+ * Resets region-dependent resources (userRegion, providers, tokens, paymentMethods).
  * Mutates state in place; use from within controller update() for atomic updates.
  *
  * @param state - The state object to mutate.
@@ -216,7 +196,6 @@ function resetDependentResources(state, options) {
     for (const key of DEPENDENT_RESOURCE_KEYS) {
         resetResource(state, key, defaultState[key]);
     }
-    resetWidgetUrl(state);
 }
 // === HELPER FUNCTIONS ===
 /**
@@ -271,6 +250,21 @@ function findRegionFromCode(regionCode, countries) {
         regionCode: normalizedCode,
     };
 }
+// === ORDER POLLING CONSTANTS ===
+const TERMINAL_ORDER_STATUSES = new Set([
+    RampsService_1.RampsOrderStatus.Completed,
+    RampsService_1.RampsOrderStatus.Failed,
+    RampsService_1.RampsOrderStatus.Cancelled,
+    RampsService_1.RampsOrderStatus.IdExpired,
+]);
+const PENDING_ORDER_STATUSES = new Set([
+    RampsService_1.RampsOrderStatus.Pending,
+    RampsService_1.RampsOrderStatus.Created,
+    RampsService_1.RampsOrderStatus.Unknown,
+    RampsService_1.RampsOrderStatus.Precreated,
+]);
+const DEFAULT_POLLING_INTERVAL_MS = 30000;
+const MAX_ERROR_COUNT = 5;
 // === CONTROLLER DEFINITION ===
 /**
  * Manages cryptocurrency on/off ramps functionality.
@@ -326,18 +320,12 @@ class RampsController extends base_controller_1.BaseController {
          * Used so isLoading is only cleared when the last request for that resource finishes.
          */
         _RampsController_pendingResourceCount.set(this, new Map());
-        /**
-         * Interval ID for automatic quote polling.
-         * Set when startQuotePolling() is called, cleared when stopQuotePolling() is called.
-         */
-        _RampsController_quotePollingInterval.set(this, null);
-        /**
-         * Options used for quote polling (walletAddress, amount, redirectUrl).
-         * Stored so polling can be restarted when dependencies change.
-         */
-        _RampsController_quotePollingOptions.set(this, null);
+        _RampsController_orderPollingMeta.set(this, new Map());
+        _RampsController_orderPollingTimer.set(this, null);
+        _RampsController_isPolling.set(this, false);
         __classPrivateFieldSet(this, _RampsController_requestCacheTTL, requestCacheTTL, "f");
         __classPrivateFieldSet(this, _RampsController_requestCacheMaxSize, requestCacheMaxSize, "f");
+        __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_registerActionHandlers).call(this);
     }
     /**
      * Executes a request with caching, deduplication, and at most one in-flight
@@ -506,7 +494,6 @@ class RampsController extends base_controller_1.BaseController {
             if (regionChanged) {
                 __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_abortDependentRequests).call(this);
                 __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_clearPendingResourceCountForDependentResources).call(this);
-                this.stopQuotePolling();
             }
             this.update((state) => {
                 if (regionChanged) {
@@ -543,7 +530,6 @@ class RampsController extends base_controller_1.BaseController {
      */
     setSelectedProvider(providerId) {
         if (providerId === null) {
-            this.stopQuotePolling();
             this.update((state) => {
                 state.providers.selected = null;
                 resetResource(state, 'paymentMethods');
@@ -562,14 +548,8 @@ class RampsController extends base_controller_1.BaseController {
         this.update((state) => {
             state.providers.selected = provider;
             resetResource(state, 'paymentMethods');
-            state.quotes.selected = null;
-            resetWidgetUrl(state);
         });
-        __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_fireAndForget).call(this, this.getPaymentMethods(regionCode, { provider: provider.id }).then(() => {
-            // Restart quote polling after payment methods are fetched
-            __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_restartPollingIfActive).call(this);
-            return undefined;
-        }));
+        __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_fireAndForget).call(this, this.getPaymentMethods(regionCode, { provider: provider.id }));
     }
     /**
      * Initializes the controller by fetching the user's region from geolocation.
@@ -658,7 +638,6 @@ class RampsController extends base_controller_1.BaseController {
      */
     setSelectedToken(assetId) {
         if (!assetId) {
-            this.stopQuotePolling();
             this.update((state) => {
                 state.tokens.selected = null;
                 resetResource(state, 'paymentMethods');
@@ -678,13 +657,8 @@ class RampsController extends base_controller_1.BaseController {
         this.update((state) => {
             state.tokens.selected = token;
             resetResource(state, 'paymentMethods');
-            state.quotes.selected = null;
-            resetWidgetUrl(state);
         });
-        __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_fireAndForget).call(this, this.getPaymentMethods(regionCode, { assetId: token.assetId }).then(() => {
-            __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_restartPollingIfActive).call(this);
-            return undefined;
-        }));
+        __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_fireAndForget).call(this, this.getPaymentMethods(regionCode, { assetId: token.assetId }));
     }
     /**
      * Fetches the list of providers for a given region.
@@ -816,12 +790,10 @@ class RampsController extends base_controller_1.BaseController {
         this.update((state) => {
             state.paymentMethods.selected = paymentMethod;
         });
-        // Restart quote polling if active
-        __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_restartPollingIfActive).call(this);
     }
     /**
      * Fetches quotes from all providers for a given set of parameters.
-     * The quotes are saved in the controller state once fetched.
+     * Uses the controller's request cache; callers manage the response in local state.
      *
      * @param options - The parameters for fetching quotes.
      * @param options.region - User's region code. If not provided, uses userRegion from state.
@@ -890,135 +862,85 @@ class RampsController extends base_controller_1.BaseController {
             redirectUrl: options.redirectUrl,
             action,
         };
-        const response = await this.executeRequest(cacheKey, async () => {
+        return this.executeRequest(cacheKey, async () => {
             return this.messenger.call('RampsService:getQuotes', params);
         }, {
             forceRefresh: options.forceRefresh,
             ttl: options.ttl ?? DEFAULT_QUOTES_TTL,
-            resourceType: 'quotes',
-            isResultCurrent: () => __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_isRegionCurrent).call(this, normalizedRegion),
         });
+    }
+    // === ORDER MANAGEMENT ===
+    /**
+     * Adds or updates a V2 order in controller state.
+     * If an order with the same providerOrderId already exists, the incoming
+     * fields are merged on top of the existing order so that fields not present
+     * in the update (e.g. paymentDetails from the Transak API) are preserved.
+     *
+     * @param order - The RampsOrder to add or update.
+     */
+    addOrder(order) {
         this.update((state) => {
-            const userRegionCode = state.userRegion?.regionCode;
-            if (userRegionCode === undefined || userRegionCode === normalizedRegion) {
-                state.quotes.data = response;
+            const idx = state.orders.findIndex((existing) => existing.providerOrderId === order.providerOrderId);
+            if (idx === -1) {
+                state.orders.push(order);
+            }
+            else {
+                state.orders[idx] = {
+                    ...state.orders[idx],
+                    ...order,
+                };
             }
         });
-        return response;
     }
     /**
-     * Starts automatic quote polling with a 15-second refresh interval.
-     * Fetches quotes immediately and then every 15 seconds.
-     * If the response contains exactly one quote, it is auto-selected.
-     * If multiple quotes are returned, the existing selection is preserved if still valid.
-     *
-     * Returns early (no-op) if the selected payment method is not yet set,
-     * allowing callers to invoke this before payment-method selection is finalized.
+     * Removes a V2 order from controller state by providerOrderId.
      *
-     * @param options - Parameters for fetching quotes.
-     * @param options.walletAddress - The destination wallet address.
-     * @param options.amount - The amount (in fiat for buy, crypto for sell).
-     * @param options.redirectUrl - Optional redirect URL after order completion.
-     * @throws If required dependencies (region, token, provider) are not set.
+     * @param providerOrderId - The provider order ID to remove.
      */
-    startQuotePolling(options) {
-        __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_requireRegion).call(this);
-        const token = this.state.tokens.selected;
-        const provider = this.state.providers.selected;
-        const paymentMethod = this.state.paymentMethods.selected;
-        if (!token) {
-            throw new Error('Token is required. Cannot start quote polling without a selected token.');
-        }
-        if (!provider) {
-            throw new Error('Provider is required. Cannot start quote polling without a selected provider.');
-        }
-        if (!paymentMethod) {
-            return;
-        }
-        // Stop any existing polling first
-        this.stopQuotePolling();
-        // Store options for restarts (must be after stop to avoid being cleared)
-        __classPrivateFieldSet(this, _RampsController_quotePollingOptions, options, "f");
-        // Define the fetch function
-        const fetchQuotes = () => {
-            __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_fireAndForget).call(this, this.getQuotes({
-                assetId: token.assetId,
-                amount: options.amount,
-                walletAddress: options.walletAddress,
-                redirectUrl: options.redirectUrl,
-                paymentMethods: [paymentMethod.id],
-                providers: [provider.id],
-                forceRefresh: true,
-            }).then((response) => {
-                let newSelectedQuote = null;
-                // Auto-select logic: only when exactly one quote is returned
-                this.update((state) => {
-                    if (response.success.length === 1) {
-                        newSelectedQuote = response.success[0];
-                        state.quotes.selected = newSelectedQuote;
-                    }
-                    else {
-                        // Keep existing selection if still valid, but update with fresh data
-                        const currentSelection = state.quotes.selected;
-                        if (currentSelection) {
-                            const freshQuote = response.success.find((quote) => quote.provider === currentSelection.provider &&
-                                quote.quote.paymentMethod ===
-                                    currentSelection.quote.paymentMethod);
-                            newSelectedQuote = freshQuote ?? null;
-                            state.quotes.selected = newSelectedQuote;
-                        }
-                    }
-                });
-                __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_syncWidgetUrl).call(this, newSelectedQuote);
-                return undefined;
-            }));
-        };
-        // Fetch immediately
-        fetchQuotes();
-        // Set up 15-second polling
-        __classPrivateFieldSet(this, _RampsController_quotePollingInterval, setInterval(fetchQuotes, 15000), "f");
+    removeOrder(providerOrderId) {
+        this.update((state) => {
+            state.orders = state.orders.filter((order) => order.providerOrderId !== providerOrderId);
+        });
+        __classPrivateFieldGet(this, _RampsController_orderPollingMeta, "f").delete(providerOrderId);
     }
     /**
-     * Stops automatic quote polling.
-     * Does not clear quotes data or selection, only stops the interval.
+     * Starts polling all pending V2 orders at a fixed interval.
+     * Each poll cycle iterates orders with non-terminal statuses,
+     * respects pollingSecondsMinimum and backoff from error count.
      */
-    stopQuotePolling() {
-        if (__classPrivateFieldGet(this, _RampsController_quotePollingInterval, "f") !== null) {
-            clearInterval(__classPrivateFieldGet(this, _RampsController_quotePollingInterval, "f"));
-            __classPrivateFieldSet(this, _RampsController_quotePollingInterval, null, "f");
+    startOrderPolling() {
+        if (__classPrivateFieldGet(this, _RampsController_orderPollingTimer, "f")) {
+            return;
         }
-        __classPrivateFieldSet(this, _RampsController_quotePollingOptions, null, "f");
+        __classPrivateFieldSet(this, _RampsController_orderPollingTimer, setInterval(() => {
+            __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_pollPendingOrders).call(this).catch(() => undefined);
+        }, DEFAULT_POLLING_INTERVAL_MS), "f");
+        __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_pollPendingOrders).call(this).catch(() => undefined);
     }
     /**
-     * Manually sets the selected quote.
-     * Automatically triggers a widget URL fetch for the new quote.
-     *
-     * @param quote - The quote to select, or null to clear the selection.
+     * Stops order polling and clears the interval.
      */
-    setSelectedQuote(quote) {
-        this.update((state) => {
-            state.quotes.selected = quote;
-        });
-        __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_syncWidgetUrl).call(this, quote);
+    stopOrderPolling() {
+        if (__classPrivateFieldGet(this, _RampsController_orderPollingTimer, "f")) {
+            clearInterval(__classPrivateFieldGet(this, _RampsController_orderPollingTimer, "f"));
+            __classPrivateFieldSet(this, _RampsController_orderPollingTimer, null, "f");
+        }
     }
     /**
      * Cleans up controller resources.
-     * Stops any active quote polling to prevent memory leaks.
      * Should be called when the controller is no longer needed.
      */
     destroy() {
-        this.stopQuotePolling();
+        this.stopOrderPolling();
         super.destroy();
     }
     /**
      * Fetches the widget URL from a quote for redirect providers.
      * Makes a request to the buyURL endpoint via the RampsService to get the
-     * actual provider widget URL, using the injected fetch and retry policy.
+     * actual provider widget URL.
      *
      * @param quote - The quote to fetch the widget URL from.
      * @returns Promise resolving to the widget URL string, or null if not available.
-     * @deprecated Read `state.widgetUrl` instead. The widget URL is now automatically
-     * fetched and stored in state whenever the selected quote changes.
      */
     async getWidgetUrl(quote) {
         const buyUrl = quote.quote?.buyURL;
@@ -1043,7 +965,17 @@ class RampsController extends base_controller_1.BaseController {
      * @returns The unified order data.
      */
     async getOrder(providerCode, orderCode, wallet) {
-        return await this.messenger.call('RampsService:getOrder', providerCode, orderCode, wallet);
+        const order = await this.messenger.call('RampsService:getOrder', providerCode, orderCode, wallet);
+        this.update((state) => {
+            const idx = state.orders.findIndex((existing) => existing.providerOrderId === orderCode);
+            if (idx !== -1) {
+                state.orders[idx] = {
+                    ...state.orders[idx],
+                    ...order,
+                };
+            }
+        });
+        return order;
     }
     /**
      * Extracts an order from a provider callback URL.
@@ -1455,7 +1387,7 @@ class RampsController extends base_controller_1.BaseController {
     }
 }
 exports.RampsController = RampsController;
-_RampsController_requestCacheTTL = new WeakMap(), _RampsController_requestCacheMaxSize = new WeakMap(), _RampsController_pendingRequests = new WeakMap(), _RampsController_pendingResourceCount = new WeakMap(), _RampsController_quotePollingInterval = new WeakMap(), _RampsController_quotePollingOptions = new WeakMap(), _RampsController_instances = new WeakSet(), _RampsController_clearPendingResourceCountForDependentResources = function _RampsController_clearPendingResourceCountForDependentResources() {
+_RampsController_requestCacheTTL = new WeakMap(), _RampsController_requestCacheMaxSize = new WeakMap(), _RampsController_pendingRequests = new WeakMap(), _RampsController_pendingResourceCount = new WeakMap(), _RampsController_orderPollingMeta = new WeakMap(), _RampsController_orderPollingTimer = new WeakMap(), _RampsController_isPolling = new WeakMap(), _RampsController_instances = new WeakSet(), _RampsController_clearPendingResourceCountForDependentResources = function _RampsController_clearPendingResourceCountForDependentResources() {
     for (const resourceType of DEPENDENT_RESOURCE_KEYS) {
         __classPrivateFieldGet(this, _RampsController_pendingResourceCount, "f").delete(resourceType);
     }
@@ -1468,6 +1400,10 @@ _RampsController_requestCacheTTL = new WeakMap(), _RampsController_requestCacheM
             __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_removeRequestState).call(this, cacheKey);
         }
     }
+}, _RampsController_registerActionHandlers = function _RampsController_registerActionHandlers() {
+    this.messenger.registerActionHandler('RampsController:getOrder', this.getOrder.bind(this));
+    this.messenger.registerActionHandler('RampsController:getQuotes', this.getQuotes.bind(this));
+    this.messenger.registerActionHandler('RampsController:setSelectedToken', this.setSelectedToken.bind(this));
 }, _RampsController_mutateRequests = function _RampsController_mutateRequests(fn) {
     this.update((state) => {
         const requests = state.requests;
@@ -1478,24 +1414,11 @@ _RampsController_requestCacheTTL = new WeakMap(), _RampsController_requestCacheM
         delete requests[cacheKey];
     });
 }, _RampsController_cleanupState = function _RampsController_cleanupState() {
-    this.stopQuotePolling();
     __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_abortDependentRequests).call(this);
     __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_clearPendingResourceCountForDependentResources).call(this);
     this.update((state) => resetDependentResources(state, { clearUserRegionData: true }));
 }, _RampsController_fireAndForget = function _RampsController_fireAndForget(promise) {
     promise.catch((_error) => undefined);
-}, _RampsController_restartPollingIfActive = function _RampsController_restartPollingIfActive() {
-    if (__classPrivateFieldGet(this, _RampsController_quotePollingInterval, "f") !== null && __classPrivateFieldGet(this, _RampsController_quotePollingOptions, "f")) {
-        const options = __classPrivateFieldGet(this, _RampsController_quotePollingOptions, "f");
-        this.stopQuotePolling();
-        try {
-            this.startQuotePolling(options);
-        }
-        catch {
-            // Dependencies not met yet, polling will need to be manually restarted
-            // when dependencies are available
-        }
-    }
 }, _RampsController_requireRegion = function _RampsController_requireRegion() {
     const regionCode = this.state.userRegion?.regionCode;
     if (!regionCode) {
@@ -1551,39 +1474,81 @@ _RampsController_requestCacheTTL = new WeakMap(), _RampsController_requestCacheM
             }
         }
     });
-}, _RampsController_syncWidgetUrl = function _RampsController_syncWidgetUrl(quote) {
-    const buyUrl = quote?.quote?.buyURL;
-    if (!buyUrl) {
-        this.update((state) => {
-            resetWidgetUrl(state);
-        });
+}, _RampsController_refreshOrder = 
+/**
+ * Refreshes a single order via the V2 API and updates it in state.
+ * Publishes orderStatusChanged if the status transitioned.
+ *
+ * @param order - The order to refresh (needs provider and providerOrderId).
+ */
+async function _RampsController_refreshOrder(order) {
+    const providerCode = order.provider?.id ?? '';
+    if (!providerCode || !order.providerOrderId || !order.walletAddress) {
         return;
     }
-    if (this.state.widgetUrl.data === null) {
-        this.update((state) => {
-            state.widgetUrl.isLoading = true;
-            state.widgetUrl.error = null;
-        });
+    const providerCodeSegment = providerCode.replace('/providers/', '');
+    const previousStatus = order.status;
+    try {
+        const updatedOrder = await this.getOrder(providerCodeSegment, order.providerOrderId, order.walletAddress);
+        const meta = __classPrivateFieldGet(this, _RampsController_orderPollingMeta, "f").get(order.providerOrderId) ?? {
+            lastTimeFetched: 0,
+            errorCount: 0,
+        };
+        if (updatedOrder.status === RampsService_1.RampsOrderStatus.Unknown) {
+            meta.errorCount = Math.min(meta.errorCount + 1, MAX_ERROR_COUNT);
+        }
+        else {
+            meta.errorCount = 0;
+        }
+        meta.lastTimeFetched = Date.now();
+        __classPrivateFieldGet(this, _RampsController_orderPollingMeta, "f").set(order.providerOrderId, meta);
+        if (previousStatus !== updatedOrder.status &&
+            previousStatus !== undefined) {
+            this.messenger.publish('RampsController:orderStatusChanged', {
+                order: updatedOrder,
+                previousStatus,
+            });
+        }
+        if (TERMINAL_ORDER_STATUSES.has(updatedOrder.status)) {
+            __classPrivateFieldGet(this, _RampsController_orderPollingMeta, "f").delete(order.providerOrderId);
+        }
+    }
+    catch {
+        const meta = __classPrivateFieldGet(this, _RampsController_orderPollingMeta, "f").get(order.providerOrderId) ?? {
+            lastTimeFetched: 0,
+            errorCount: 0,
+        };
+        meta.errorCount = Math.min(meta.errorCount + 1, MAX_ERROR_COUNT);
+        meta.lastTimeFetched = Date.now();
+        __classPrivateFieldGet(this, _RampsController_orderPollingMeta, "f").set(order.providerOrderId, meta);
+    }
+}, _RampsController_pollPendingOrders = async function _RampsController_pollPendingOrders() {
+    if (__classPrivateFieldGet(this, _RampsController_isPolling, "f")) {
+        return;
+    }
+    __classPrivateFieldSet(this, _RampsController_isPolling, true, "f");
+    try {
+        const pendingOrders = this.state.orders.filter((order) => PENDING_ORDER_STATUSES.has(order.status));
+        const now = Date.now();
+        await Promise.allSettled(pendingOrders.map(async (order) => {
+            const meta = __classPrivateFieldGet(this, _RampsController_orderPollingMeta, "f").get(order.providerOrderId);
+            if (meta) {
+                const backoffMs = meta.errorCount > 0
+                    ? Math.min(DEFAULT_POLLING_INTERVAL_MS *
+                        Math.pow(2, meta.errorCount - 1), 5 * 60 * 1000)
+                    : 0;
+                const pollingMinMs = (order.pollingSecondsMinimum ?? 0) * 1000;
+                const minWait = Math.max(backoffMs, pollingMinMs);
+                if (now - meta.lastTimeFetched < minWait) {
+                    return;
+                }
+            }
+            await __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_refreshOrder).call(this, order);
+        }));
+    }
+    finally {
+        __classPrivateFieldSet(this, _RampsController_isPolling, false, "f");
     }
-    __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_fireAndForget).call(this, this.messenger
-        .call('RampsService:getBuyWidgetUrl', buyUrl)
-        .then((buyWidget) => {
-        this.update((state) => {
-            state.widgetUrl.data = buyWidget;
-            state.widgetUrl.isLoading = false;
-            state.widgetUrl.error = null;
-        });
-        return undefined;
-    })
-        .catch((error) => {
-        this.update((state) => {
-            state.widgetUrl.isLoading = false;
-            state.widgetUrl.error =
-                error instanceof Error
-                    ? error.message
-                    : 'Failed to fetch widget URL';
-        });
-    }));
 }, _RampsController_syncTransakAuthOnError = function _RampsController_syncTransakAuthOnError(error) {
     if (error instanceof Error &&
         'httpStatus' in error &&