@metamask/ramps-controller 8.1.0 → 9.0.0

package/CHANGELOG.md

@@ -7,6 +7,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [9.0.0]
+
+### Added
+
+- Add `getOrder` and `getOrderFromCallback` methods to `RampsService` and `RampsController` for V2 unified order polling, along with new `RampsOrder`, `RampsOrderFiatCurrency`, `RampsOrderCryptoCurrency`, `RampsOrderPaymentMethod`, and `RampsOrderStatus` types ([#7934](https://github.com/MetaMask/core/pull/7934))
+
+### Changed
+
+- **BREAKING:** Use concrete types in `RampsOrder` instead of `string | Object` unions for `provider`, `cryptoCurrency`, `fiatCurrency`, `paymentMethod`, and `network` fields ([#8000](https://github.com/MetaMask/core/pull/8000))
+- Bump `@metamask/controller-utils` from `^11.18.0` to `^11.19.0` ([#7995](https://github.com/MetaMask/core/pull/7995))
+
 ## [8.1.0]
 
 ### Added
@@ -153,7 +164,8 @@ 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@8.1.0...HEAD
+[Unreleased]: https://github.com/MetaMask/core/compare/@metamask/ramps-controller@9.0.0...HEAD
+[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
 [7.1.0]: https://github.com/MetaMask/core/compare/@metamask/ramps-controller@7.0.0...@metamask/ramps-controller@7.1.0

package/dist/RampsController.cjs

@@ -35,6 +35,8 @@ exports.RAMPS_CONTROLLER_REQUIRED_SERVICE_ACTIONS = [
     'RampsService:getPaymentMethods',
     'RampsService:getQuotes',
     'RampsService:getBuyWidgetUrl',
+    'RampsService:getOrder',
+    'RampsService:getOrderFromCallback',
     'TransakService:setApiKey',
     'TransakService:setAccessToken',
     'TransakService:clearAccessToken',
@@ -1031,6 +1033,32 @@ class RampsController extends base_controller_1.BaseController {
             return null;
         }
     }
+    /**
+     * Fetches an order from the unified V2 API endpoint.
+     * Returns a normalized RampsOrder for all provider types (aggregator and native).
+     *
+     * @param providerCode - The provider code (e.g., "transak", "transak-native", "moonpay").
+     * @param orderCode - The order identifier.
+     * @param wallet - The wallet address associated with the order.
+     * @returns The unified order data.
+     */
+    async getOrder(providerCode, orderCode, wallet) {
+        return await this.messenger.call('RampsService:getOrder', providerCode, orderCode, wallet);
+    }
+    /**
+     * Extracts an order from a provider callback URL.
+     * Sends the callback URL to the V2 backend for provider-specific parsing,
+     * then fetches the full order. This is the V2 equivalent of the aggregator
+     * SDK's `getOrderFromCallback`.
+     *
+     * @param providerCode - The provider code (e.g., "transak", "moonpay").
+     * @param callbackUrl - The full callback URL the provider redirected to.
+     * @param wallet - The wallet address associated with the order.
+     * @returns The unified order data.
+     */
+    async getOrderFromCallback(providerCode, callbackUrl, wallet) {
+        return await this.messenger.call('RampsService:getOrderFromCallback', providerCode, callbackUrl, wallet);
+    }
     /**
      * Sets the Transak API key used for all Transak API requests.
      *