@metamask-previews/ramps-controller 4.1.0-preview-3fd5e61f → 4.1.0-preview-e09bf49f

package/dist/RampsController.d.cts

@@ -1,7 +1,7 @@
 import type { ControllerGetStateAction, ControllerStateChangeEvent } from "@metamask/base-controller";
 import { BaseController } from "@metamask/base-controller";
 import type { Messenger } from "@metamask/messenger";
-import type { Country, TokensResponse, Provider, State, RampAction, PaymentMethod, PaymentMethodsResponse, RampsToken } from "./RampsService.cjs";
+import type { Country, TokensResponse, Provider, State, RampAction, PaymentMethod, PaymentMethodsResponse } from "./RampsService.cjs";
 import type { RampsServiceGetGeolocationAction, RampsServiceGetCountriesAction, RampsServiceGetTokensAction, RampsServiceGetProvidersAction, RampsServiceGetPaymentMethodsAction } from "./RampsService-method-action-types.cjs";
 import type { RequestCache as RequestCacheType, RequestState, ExecuteRequestOptions } from "./RequestCache.cjs";
 /**
@@ -39,10 +39,10 @@ export type RampsControllerState = {
      */
     userRegion: UserRegion | null;
     /**
-     * The user's selected provider.
+     * The user's preferred provider.
      * Can be manually set by the user.
      */
-    selectedProvider: Provider | null;
+    preferredProvider: Provider | null;
     /**
      * List of countries available for ramp actions.
      */
@@ -56,11 +56,6 @@ export type RampsControllerState = {
      * Contains topTokens and allTokens arrays.
      */
     tokens: TokensResponse | null;
-    /**
-     * The user's selected token.
-     * When set, automatically fetches and sets payment methods for that token.
-     */
-    selectedToken: RampsToken | null;
     /**
      * Payment methods available for the current context.
      * Filtered by region, fiat, asset, and provider.
@@ -181,14 +176,12 @@ export declare class RampsController extends BaseController<typeof controllerNam
      */
     setUserRegion(region: string, options?: ExecuteRequestOptions): Promise<UserRegion>;
     /**
-     * Sets the user's selected provider by ID, or clears the selection.
-     * Looks up the provider from the current providers in state and automatically
-     * fetches payment methods for that provider.
+     * Sets the user's preferred provider.
+     * This allows users to set their preferred ramp provider.
      *
-     * @param providerId - The provider ID (e.g., "/providers/moonpay"), or null to clear.
-     * @throws If region is not set, providers are not loaded, or provider is not found.
+     * @param provider - The provider object to set.
      */
-    setSelectedProvider(providerId: string | null): void;
+    setPreferredProvider(provider: Provider | null): void;
     /**
      * Initializes the controller by fetching the user's region from geolocation.
      * This should be called once at app startup to set up the initial region.
@@ -223,15 +216,6 @@ export declare class RampsController extends BaseController<typeof controllerNam
     getTokens(region?: string, action?: RampAction, options?: ExecuteRequestOptions & {
         provider?: string | string[];
     }): Promise<TokensResponse>;
-    /**
-     * Sets the user's selected token by asset ID.
-     * Looks up the token from the current tokens in state and automatically
-     * fetches payment methods for that token.
-     *
-     * @param assetId - The asset identifier in CAIP-19 format (e.g., "eip155:1/erc20:0x...").
-     * @throws If assetId is not provided, region is not set, tokens are not loaded, or token is not found.
-     */
-    setSelectedToken(assetId: string): void;
     /**
      * Fetches the list of providers for a given region.
      * The providers are saved in the controller state once fetched.
@@ -256,8 +240,8 @@ export declare class RampsController extends BaseController<typeof controllerNam
      * Fetches the list of payment methods for a given context.
      * The payment methods are saved in the controller state once fetched.
      *
-     * @param region - User's region code (e.g. "fr", "us-ny").
      * @param options - Query parameters for filtering payment methods.
+     * @param options.region - User's region code. If not provided, uses the user's region from controller state.
      * @param options.fiat - Fiat currency code (e.g., "usd"). If not provided, uses the user's region currency.
      * @param options.assetId - CAIP-19 cryptocurrency identifier.
      * @param options.provider - Provider ID path.
@@ -265,21 +249,20 @@ export declare class RampsController extends BaseController<typeof controllerNam
      * @param options.ttl - Custom TTL for this request.
      * @returns The payment methods response containing payments array.
      */
-    getPaymentMethods(region?: string, options?: {
+    getPaymentMethods(options: {
+        region?: string;
         fiat?: string;
-        assetId?: string;
-        provider?: string;
+        assetId: string;
+        provider: string;
         forceRefresh?: boolean;
         ttl?: number;
     }): Promise<PaymentMethodsResponse>;
     /**
-     * Sets the user's selected payment method by ID.
-     * Looks up the payment method from the current payment methods in state.
+     * Sets the user's selected payment method.
      *
-     * @param paymentMethodId - The payment method ID (e.g., "/payments/debit-credit-card"), or null to clear.
-     * @throws If payment methods are not loaded or payment method is not found.
+     * @param paymentMethod - The payment method to select, or null to clear.
      */
-    setSelectedPaymentMethod(paymentMethodId: string | null): void;
+    setSelectedPaymentMethod(paymentMethod: PaymentMethod | null): void;
     /**
      * Triggers setting the user region without throwing.
      *
@@ -316,18 +299,19 @@ export declare class RampsController extends BaseController<typeof controllerNam
     /**
      * Triggers fetching payment methods without throwing.
      *
-     * @param region - User's region code (e.g., "us", "fr", "us-ny").
      * @param options - Query parameters for filtering payment methods.
+     * @param options.region - User's region code. If not provided, uses userRegion from state.
      * @param options.fiat - Fiat currency code. If not provided, uses userRegion currency.
      * @param options.assetId - CAIP-19 cryptocurrency identifier.
      * @param options.provider - Provider ID path.
      * @param options.forceRefresh - Whether to bypass cache.
      * @param options.ttl - Custom TTL for this request.
      */
-    triggerGetPaymentMethods(region?: string, options?: {
+    triggerGetPaymentMethods(options: {
+        region?: string;
         fiat?: string;
-        assetId?: string;
-        provider?: string;
+        assetId: string;
+        provider: string;
         forceRefresh?: boolean;
         ttl?: number;
     }): void;

package/dist/RampsController.d.cts.map

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

package/dist/RampsController.d.mts

@@ -1,7 +1,7 @@
 import type { ControllerGetStateAction, ControllerStateChangeEvent } from "@metamask/base-controller";
 import { BaseController } from "@metamask/base-controller";
 import type { Messenger } from "@metamask/messenger";
-import type { Country, TokensResponse, Provider, State, RampAction, PaymentMethod, PaymentMethodsResponse, RampsToken } from "./RampsService.mjs";
+import type { Country, TokensResponse, Provider, State, RampAction, PaymentMethod, PaymentMethodsResponse } from "./RampsService.mjs";
 import type { RampsServiceGetGeolocationAction, RampsServiceGetCountriesAction, RampsServiceGetTokensAction, RampsServiceGetProvidersAction, RampsServiceGetPaymentMethodsAction } from "./RampsService-method-action-types.mjs";
 import type { RequestCache as RequestCacheType, RequestState, ExecuteRequestOptions } from "./RequestCache.mjs";
 /**
@@ -39,10 +39,10 @@ export type RampsControllerState = {
      */
     userRegion: UserRegion | null;
     /**
-     * The user's selected provider.
+     * The user's preferred provider.
      * Can be manually set by the user.
      */
-    selectedProvider: Provider | null;
+    preferredProvider: Provider | null;
     /**
      * List of countries available for ramp actions.
      */
@@ -56,11 +56,6 @@ export type RampsControllerState = {
      * Contains topTokens and allTokens arrays.
      */
     tokens: TokensResponse | null;
-    /**
-     * The user's selected token.
-     * When set, automatically fetches and sets payment methods for that token.
-     */
-    selectedToken: RampsToken | null;
     /**
      * Payment methods available for the current context.
      * Filtered by region, fiat, asset, and provider.
@@ -181,14 +176,12 @@ export declare class RampsController extends BaseController<typeof controllerNam
      */
     setUserRegion(region: string, options?: ExecuteRequestOptions): Promise<UserRegion>;
     /**
-     * Sets the user's selected provider by ID, or clears the selection.
-     * Looks up the provider from the current providers in state and automatically
-     * fetches payment methods for that provider.
+     * Sets the user's preferred provider.
+     * This allows users to set their preferred ramp provider.
      *
-     * @param providerId - The provider ID (e.g., "/providers/moonpay"), or null to clear.
-     * @throws If region is not set, providers are not loaded, or provider is not found.
+     * @param provider - The provider object to set.
      */
-    setSelectedProvider(providerId: string | null): void;
+    setPreferredProvider(provider: Provider | null): void;
     /**
      * Initializes the controller by fetching the user's region from geolocation.
      * This should be called once at app startup to set up the initial region.
@@ -223,15 +216,6 @@ export declare class RampsController extends BaseController<typeof controllerNam
     getTokens(region?: string, action?: RampAction, options?: ExecuteRequestOptions & {
         provider?: string | string[];
     }): Promise<TokensResponse>;
-    /**
-     * Sets the user's selected token by asset ID.
-     * Looks up the token from the current tokens in state and automatically
-     * fetches payment methods for that token.
-     *
-     * @param assetId - The asset identifier in CAIP-19 format (e.g., "eip155:1/erc20:0x...").
-     * @throws If assetId is not provided, region is not set, tokens are not loaded, or token is not found.
-     */
-    setSelectedToken(assetId: string): void;
     /**
      * Fetches the list of providers for a given region.
      * The providers are saved in the controller state once fetched.
@@ -256,8 +240,8 @@ export declare class RampsController extends BaseController<typeof controllerNam
      * Fetches the list of payment methods for a given context.
      * The payment methods are saved in the controller state once fetched.
      *
-     * @param region - User's region code (e.g. "fr", "us-ny").
      * @param options - Query parameters for filtering payment methods.
+     * @param options.region - User's region code. If not provided, uses the user's region from controller state.
      * @param options.fiat - Fiat currency code (e.g., "usd"). If not provided, uses the user's region currency.
      * @param options.assetId - CAIP-19 cryptocurrency identifier.
      * @param options.provider - Provider ID path.
@@ -265,21 +249,20 @@ export declare class RampsController extends BaseController<typeof controllerNam
      * @param options.ttl - Custom TTL for this request.
      * @returns The payment methods response containing payments array.
      */
-    getPaymentMethods(region?: string, options?: {
+    getPaymentMethods(options: {
+        region?: string;
         fiat?: string;
-        assetId?: string;
-        provider?: string;
+        assetId: string;
+        provider: string;
         forceRefresh?: boolean;
         ttl?: number;
     }): Promise<PaymentMethodsResponse>;
     /**
-     * Sets the user's selected payment method by ID.
-     * Looks up the payment method from the current payment methods in state.
+     * Sets the user's selected payment method.
      *
-     * @param paymentMethodId - The payment method ID (e.g., "/payments/debit-credit-card"), or null to clear.
-     * @throws If payment methods are not loaded or payment method is not found.
+     * @param paymentMethod - The payment method to select, or null to clear.
      */
-    setSelectedPaymentMethod(paymentMethodId: string | null): void;
+    setSelectedPaymentMethod(paymentMethod: PaymentMethod | null): void;
     /**
      * Triggers setting the user region without throwing.
      *
@@ -316,18 +299,19 @@ export declare class RampsController extends BaseController<typeof controllerNam
     /**
      * Triggers fetching payment methods without throwing.
      *
-     * @param region - User's region code (e.g., "us", "fr", "us-ny").
      * @param options - Query parameters for filtering payment methods.
+     * @param options.region - User's region code. If not provided, uses userRegion from state.
      * @param options.fiat - Fiat currency code. If not provided, uses userRegion currency.
      * @param options.assetId - CAIP-19 cryptocurrency identifier.
      * @param options.provider - Provider ID path.
      * @param options.forceRefresh - Whether to bypass cache.
      * @param options.ttl - Custom TTL for this request.
      */
-    triggerGetPaymentMethods(region?: string, options?: {
+    triggerGetPaymentMethods(options: {
+        region?: string;
         fiat?: string;
-        assetId?: string;
-        provider?: string;
+        assetId: string;
+        provider: string;
         forceRefresh?: boolean;
         ttl?: number;
     }): void;

package/dist/RampsController.d.mts.map

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

package/dist/RampsController.mjs

@@ -29,8 +29,8 @@ const rampsControllerMetadata = {
         includeInStateLogs: true,
         usedInUi: true,
     },
-    selectedProvider: {
-        persist: false,
+    preferredProvider: {
+        persist: true,
         includeInDebugSnapshot: true,
         includeInStateLogs: true,
         usedInUi: true,
@@ -53,12 +53,6 @@ const rampsControllerMetadata = {
         includeInStateLogs: true,
         usedInUi: true,
     },
-    selectedToken: {
-        persist: false,
-        includeInDebugSnapshot: true,
-        includeInStateLogs: true,
-        usedInUi: true,
-    },
     paymentMethods: {
         persist: false,
         includeInDebugSnapshot: true,
@@ -89,11 +83,10 @@ const rampsControllerMetadata = {
 export function getDefaultRampsControllerState() {
     return {
         userRegion: null,
-        selectedProvider: null,
+        preferredProvider: null,
         countries: [],
         providers: [],
         tokens: null,
-        selectedToken: null,
         paymentMethods: [],
         selectedPaymentMethod: null,
         requests: {},
@@ -215,6 +208,7 @@ export class RampsController extends BaseController {
         if (pending) {
             return pending.promise;
         }
+        // Check cache validity (unless force refresh)
         if (!options?.forceRefresh) {
             const cached = this.state.requests[cacheKey];
             if (cached && !isCacheExpired(cached, ttl)) {
@@ -309,8 +303,7 @@ export class RampsController extends BaseController {
             // Set the new region atomically with cleanup to avoid intermediate null state
             this.update((state) => {
                 if (regionChanged) {
-                    state.selectedProvider = null;
-                    state.selectedToken = null;
+                    state.preferredProvider = null;
                     state.tokens = null;
                     state.providers = [];
                     state.paymentMethods = [];
@@ -333,40 +326,14 @@ export class RampsController extends BaseController {
         }
     }
     /**
-     * Sets the user's selected provider by ID, or clears the selection.
-     * Looks up the provider from the current providers in state and automatically
-     * fetches payment methods for that provider.
+     * Sets the user's preferred provider.
+     * This allows users to set their preferred ramp provider.
      *
-     * @param providerId - The provider ID (e.g., "/providers/moonpay"), or null to clear.
-     * @throws If region is not set, providers are not loaded, or provider is not found.
+     * @param provider - The provider object to set.
      */
-    setSelectedProvider(providerId) {
-        if (providerId === null) {
-            this.update((state) => {
-                state.selectedProvider = null;
-            });
-            return;
-        }
-        const regionCode = this.state.userRegion?.regionCode;
-        if (!regionCode) {
-            throw new Error('Region is required. Cannot set selected provider without valid region information.');
-        }
-        const { providers } = this.state;
-        if (!providers || providers.length === 0) {
-            throw new Error('Providers not loaded. Cannot set selected provider before providers are fetched.');
-        }
-        const provider = providers.find((prov) => prov.id === providerId);
-        if (!provider) {
-            throw new Error(`Provider with ID "${providerId}" not found in available providers.`);
-        }
+    setPreferredProvider(provider) {
         this.update((state) => {
-            state.selectedProvider = provider;
-        });
-        // fetch payment methods for the the new provider
-        // this is needed because you can change providers without changing the token
-        // (getPaymentMethods will use state as its default)
-        this.triggerGetPaymentMethods(regionCode, {
-            provider: provider.id,
+            state.preferredProvider = provider;
         });
     }
     /**
@@ -408,7 +375,7 @@ export class RampsController extends BaseController {
         const cacheKey = createCacheKey('getCountries', []);
         const countries = await this.executeRequest(cacheKey, async () => {
             return this.messenger.call('RampsService:getCountries');
-        }, { ttl: 24 * 60 * 60 * 1000, ...options });
+        }, options);
         this.update((state) => {
             state.countries = countries;
         });
@@ -439,7 +406,7 @@ export class RampsController extends BaseController {
             return this.messenger.call('RampsService:getTokens', normalizedRegion, action, {
                 provider: options?.provider,
             });
-        }, { forceRefresh: true, ...options });
+        }, options);
         this.update((state) => {
             const userRegionCode = state.userRegion?.regionCode;
             if (userRegionCode === undefined || userRegionCode === normalizedRegion) {
@@ -448,38 +415,6 @@ export class RampsController extends BaseController {
         });
         return tokens;
     }
-    /**
-     * Sets the user's selected token by asset ID.
-     * Looks up the token from the current tokens in state and automatically
-     * fetches payment methods for that token.
-     *
-     * @param assetId - The asset identifier in CAIP-19 format (e.g., "eip155:1/erc20:0x...").
-     * @throws If assetId is not provided, region is not set, tokens are not loaded, or token is not found.
-     */
-    setSelectedToken(assetId) {
-        if (!assetId) {
-            throw new Error('Asset ID is required.');
-        }
-        const regionCode = this.state.userRegion?.regionCode;
-        if (!regionCode) {
-            throw new Error('Region is required. Cannot set selected token without valid region information.');
-        }
-        const { tokens } = this.state;
-        if (!tokens) {
-            throw new Error('Tokens not loaded. Cannot set selected token before tokens are fetched.');
-        }
-        const token = tokens.allTokens.find((tok) => tok.assetId === assetId) ??
-            tokens.topTokens.find((tok) => tok.assetId === assetId);
-        if (!token) {
-            throw new Error(`Token with asset ID "${assetId}" not found in available tokens.`);
-        }
-        this.update((state) => {
-            state.selectedToken = token;
-        });
-        this.triggerGetPaymentMethods(regionCode, {
-            assetId: token.assetId,
-        });
-    }
     /**
      * Fetches the list of providers for a given region.
      * The providers are saved in the controller state once fetched.
@@ -512,7 +447,7 @@ export class RampsController extends BaseController {
                 fiat: options?.fiat,
                 payments: options?.payments,
             });
-        }, { forceRefresh: true, ...options });
+        }, options);
         this.update((state) => {
             const userRegionCode = state.userRegion?.regionCode;
             if (userRegionCode === undefined || userRegionCode === normalizedRegion) {
@@ -525,8 +460,8 @@ export class RampsController extends BaseController {
      * Fetches the list of payment methods for a given context.
      * The payment methods are saved in the controller state once fetched.
      *
-     * @param region - User's region code (e.g. "fr", "us-ny").
      * @param options - Query parameters for filtering payment methods.
+     * @param options.region - User's region code. If not provided, uses the user's region from controller state.
      * @param options.fiat - Fiat currency code (e.g., "usd"). If not provided, uses the user's region currency.
      * @param options.assetId - CAIP-19 cryptocurrency identifier.
      * @param options.provider - Provider ID path.
@@ -534,72 +469,48 @@ export class RampsController extends BaseController {
      * @param options.ttl - Custom TTL for this request.
      * @returns The payment methods response containing payments array.
      */
-    async getPaymentMethods(region, options) {
-        const regionCode = region ?? this.state.userRegion?.regionCode ?? null;
-        const fiatToUse = options?.fiat ?? this.state.userRegion?.country?.currency ?? null;
-        const selectedTokenAtStart = this.state.selectedToken?.assetId ?? '';
-        const selectedProviderAtStart = this.state.selectedProvider?.id ?? '';
-        const assetIdToUse = options?.assetId ?? selectedTokenAtStart;
-        const providerToUse = options?.provider ?? selectedProviderAtStart;
-        if (!regionCode) {
+    async getPaymentMethods(options) {
+        const regionToUse = options.region ?? this.state.userRegion?.regionCode;
+        const fiatToUse = options.fiat ?? this.state.userRegion?.country?.currency;
+        if (!regionToUse) {
             throw new Error('Region is required. Either provide a region parameter or ensure userRegion is set in controller state.');
         }
         if (!fiatToUse) {
             throw new Error('Fiat currency is required. Either provide a fiat parameter or ensure userRegion is set in controller state.');
         }
-        const normalizedRegion = regionCode.toLowerCase().trim();
+        const normalizedRegion = regionToUse.toLowerCase().trim();
         const normalizedFiat = fiatToUse.toLowerCase().trim();
         const cacheKey = createCacheKey('getPaymentMethods', [
             normalizedRegion,
             normalizedFiat,
-            assetIdToUse,
-            providerToUse,
+            options.assetId,
+            options.provider,
         ]);
         const response = await this.executeRequest(cacheKey, async () => {
             return this.messenger.call('RampsService:getPaymentMethods', {
                 region: normalizedRegion,
                 fiat: normalizedFiat,
-                assetId: assetIdToUse,
-                provider: providerToUse,
+                assetId: options.assetId,
+                provider: options.provider,
             });
-        }, { forceRefresh: options?.forceRefresh, ttl: options?.ttl });
+        }, { forceRefresh: options.forceRefresh, ttl: options.ttl });
         this.update((state) => {
-            const currentAssetId = state.selectedToken?.assetId ?? '';
-            const currentProviderId = state.selectedProvider?.id ?? '';
-            const tokenSelectionUnchanged = assetIdToUse === currentAssetId;
-            const providerSelectionUnchanged = providerToUse === currentProviderId;
-            if (tokenSelectionUnchanged && providerSelectionUnchanged) {
-                state.paymentMethods = response.payments;
-                const currentSelectionStillValid = response.payments.some((pm) => pm.id === state.selectedPaymentMethod?.id);
-                if (!currentSelectionStillValid) {
-                    state.selectedPaymentMethod = response.payments[0] ?? null;
-                }
+            state.paymentMethods = response.payments;
+            // Only clear selected payment method if it's no longer in the new list
+            // This preserves the selection when cached data is returned (same context)
+            if (state.selectedPaymentMethod &&
+                !response.payments.some((pm) => pm.id === state.selectedPaymentMethod?.id)) {
+                state.selectedPaymentMethod = null;
             }
         });
         return response;
     }
     /**
-     * Sets the user's selected payment method by ID.
-     * Looks up the payment method from the current payment methods in state.
+     * Sets the user's selected payment method.
      *
-     * @param paymentMethodId - The payment method ID (e.g., "/payments/debit-credit-card"), or null to clear.
-     * @throws If payment methods are not loaded or payment method is not found.
+     * @param paymentMethod - The payment method to select, or null to clear.
      */
-    setSelectedPaymentMethod(paymentMethodId) {
-        if (paymentMethodId === null) {
-            this.update((state) => {
-                state.selectedPaymentMethod = null;
-            });
-            return;
-        }
-        const { paymentMethods } = this.state;
-        if (!paymentMethods || paymentMethods.length === 0) {
-            throw new Error('Payment methods not loaded. Cannot set selected payment method before payment methods are fetched.');
-        }
-        const paymentMethod = paymentMethods.find((pm) => pm.id === paymentMethodId);
-        if (!paymentMethod) {
-            throw new Error(`Payment method with ID "${paymentMethodId}" not found in available payment methods.`);
-        }
+    setSelectedPaymentMethod(paymentMethod) {
         this.update((state) => {
             state.selectedPaymentMethod = paymentMethod;
         });
@@ -656,16 +567,16 @@ export class RampsController extends BaseController {
     /**
      * Triggers fetching payment methods without throwing.
      *
-     * @param region - User's region code (e.g., "us", "fr", "us-ny").
      * @param options - Query parameters for filtering payment methods.
+     * @param options.region - User's region code. If not provided, uses userRegion from state.
      * @param options.fiat - Fiat currency code. If not provided, uses userRegion currency.
      * @param options.assetId - CAIP-19 cryptocurrency identifier.
      * @param options.provider - Provider ID path.
      * @param options.forceRefresh - Whether to bypass cache.
      * @param options.ttl - Custom TTL for this request.
      */
-    triggerGetPaymentMethods(region, options) {
-        this.getPaymentMethods(region, options).catch(() => {
+    triggerGetPaymentMethods(options) {
+        this.getPaymentMethods(options).catch(() => {
             // Error stored in state
         });
     }
@@ -678,8 +589,7 @@ _RampsController_requestCacheTTL = new WeakMap(), _RampsController_requestCacheM
 }, _RampsController_cleanupState = function _RampsController_cleanupState() {
     this.update((state) => {
         state.userRegion = null;
-        state.selectedProvider = null;
-        state.selectedToken = null;
+        state.preferredProvider = null;
         state.tokens = null;
         state.providers = [];
         state.paymentMethods = [];