@metamask-previews/ramps-controller 4.1.0-preview-e09bf49f → 5.0.0-preview-9c68b732

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 } from "./RampsService.cjs";
+import type { Country, TokensResponse, Provider, State, RampAction, PaymentMethod, PaymentMethodsResponse, RampsToken } 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 preferred provider.
+     * The user's selected provider.
      * Can be manually set by the user.
      */
-    preferredProvider: Provider | null;
+    selectedProvider: Provider | null;
     /**
      * List of countries available for ramp actions.
      */
@@ -56,6 +56,11 @@ 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.
@@ -176,12 +181,14 @@ export declare class RampsController extends BaseController<typeof controllerNam
      */
     setUserRegion(region: string, options?: ExecuteRequestOptions): Promise<UserRegion>;
     /**
-     * Sets the user's preferred provider.
-     * This allows users to set their preferred ramp provider.
+     * 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.
      *
-     * @param provider - The provider object to set.
+     * @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.
      */
-    setPreferredProvider(provider: Provider | null): void;
+    setSelectedProvider(providerId: string | 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.
@@ -216,6 +223,15 @@ 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..."), or undefined to clear.
+     * @throws If 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.
@@ -240,29 +256,26 @@ 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.
-     * @param options.forceRefresh - Whether to bypass cache.
-     * @param options.ttl - Custom TTL for this request.
      * @returns The payment methods response containing payments array.
      */
-    getPaymentMethods(options: {
-        region?: string;
+    getPaymentMethods(region?: string, options?: ExecuteRequestOptions & {
         fiat?: string;
-        assetId: string;
-        provider: string;
-        forceRefresh?: boolean;
-        ttl?: number;
+        assetId?: string;
+        provider?: string;
     }): Promise<PaymentMethodsResponse>;
     /**
-     * Sets the user's selected payment method.
+     * Sets the user's selected payment method by ID.
+     * Looks up the payment method from the current payment methods in state.
      *
-     * @param paymentMethod - The payment method to select, or null to clear.
+     * @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.
      */
-    setSelectedPaymentMethod(paymentMethod: PaymentMethod | null): void;
+    setSelectedPaymentMethod(paymentMethodId?: string): void;
     /**
      * Triggers setting the user region without throwing.
      *
@@ -299,21 +312,16 @@ 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(options: {
-        region?: string;
+    triggerGetPaymentMethods(region?: string, options?: ExecuteRequestOptions & {
         fiat?: string;
-        assetId: string;
-        provider: string;
-        forceRefresh?: boolean;
-        ttl?: number;
+        assetId?: string;
+        provider?: string;
     }): void;
 }
 export {};

package/dist/RampsController.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"RampsController.d.cts","sourceRoot":"","sources":["../src/RampsController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACxB,0BAA0B,EAE3B,kCAAkC;AACnC,OAAO,EAAE,cAAc,EAAE,kCAAkC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,4BAA4B;AAGrD,OAAO,KAAK,EACV,OAAO,EACP,cAAc,EACd,QAAQ,EACR,KAAK,EACL,UAAU,EACV,aAAa,EACb,sBAAsB,EACvB,2BAAuB;AACxB,OAAO,KAAK,EACV,gCAAgC,EAChC,8BAA8B,EAC9B,2BAA2B,EAC3B,8BAA8B,EAC9B,mCAAmC,EACpC,+CAA2C;AAC5C,OAAO,KAAK,EACV,YAAY,IAAI,gBAAgB,EAChC,YAAY,EACZ,qBAAqB,EAEtB,2BAAuB;AAcxB;;;;GAIG;AACH,eAAO,MAAM,cAAc,oBAAoB,CAAC;AAIhD;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC;;;;;OAKG;IACH,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9B;;;OAGG;IACH,iBAAiB,EAAE,QAAQ,GAAG,IAAI,CAAC;IACnC;;OAEG;IACH,SAAS,EAAE,OAAO,EAAE,CAAC;IACrB;;OAEG;IACH,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB;;;OAGG;IACH,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;IAC9B;;;OAGG;IACH,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC;;;OAGG;IACH,qBAAqB,EAAE,aAAa,GAAG,IAAI,CAAC;IAC5C;;;OAGG;IACH,QAAQ,EAAE,gBAAgB,CAAC;CAC5B,CAAC;AAwDF;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,IAAI,oBAAoB,CAWrE;AAID;;GAEG;AACH,MAAM,MAAM,6BAA6B,GAAG,wBAAwB,CAClE,OAAO,cAAc,EACrB,oBAAoB,CACrB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,6BAA6B,CAAC;AAEnE;;GAEG;AACH,KAAK,cAAc,GACf,gCAAgC,GAChC,8BAA8B,GAC9B,2BAA2B,GAC3B,8BAA8B,GAC9B,mCAAmC,CAAC;AAExC;;GAEG;AACH,MAAM,MAAM,+BAA+B,GAAG,0BAA0B,CACtE,OAAO,cAAc,EACrB,oBAAoB,CACrB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,+BAA+B,CAAC;AAEpE;;GAEG;AACH,KAAK,aAAa,GAAG,KAAK,CAAC;AAE3B;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG,SAAS,CAC9C,OAAO,cAAc,EACrB,sBAAsB,GAAG,cAAc,EACvC,qBAAqB,GAAG,aAAa,CACtC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,gDAAgD;IAChD,SAAS,EAAE,wBAAwB,CAAC;IACpC,kEAAkE;IAClE,KAAK,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACtC,gFAAgF;IAChF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uEAAuE;IACvE,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAoEF;;GAEG;AACH,qBAAa,eAAgB,SAAQ,cAAc,CACjD,OAAO,cAAc,EACrB,oBAAoB,EACpB,wBAAwB,CACzB;;IAiBC;;;;;;;;;OASG;gBACS,EACV,SAAS,EACT,KAAU,EACV,eAA2C,EAC3C,mBAAoD,GACrD,EAAE,sBAAsB;IAiBzB;;;;;;;;;;;OAWG;IACG,cAAc,CAAC,OAAO,EAC1B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,OAAO,CAAC,EAClD,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,OAAO,CAAC;IAmEnB;;;;;OAKG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAqCvC;;;;;OAKG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAyD3D;;;;;;;OAOG;IACG,aAAa,CACjB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,UAAU,CAAC;IAoDtB;;;;;OAKG;IACH,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI;IAMrD;;;;;;;;;OASG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAe1D,YAAY,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,IAAI;IAYnD;;;;;;;OAOG;IACG,YAAY,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAkBvE;;;;;;;;;OASG;IACG,SAAS,CACb,MAAM,CAAC,EAAE,MAAM,EACf,MAAM,GAAE,UAAkB,EAC1B,OAAO,CAAC,EAAE,qBAAqB,GAAG;QAChC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;KAC9B,GACA,OAAO,CAAC,cAAc,CAAC;IA0C1B;;;;;;;;;;;OAWG;IACG,YAAY,CAChB,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,qBAAqB,GAAG;QAChC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QAC7B,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;KAC9B,GACA,OAAO,CAAC;QAAE,SAAS,EAAE,QAAQ,EAAE,CAAA;KAAE,CAAC;IA8CrC;;;;;;;;;;;;OAYG;IACG,iBAAiB,CAAC,OAAO,EAAE;QAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAuDnC;;;;OAIG;IACH,wBAAwB,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI,GAAG,IAAI;IAYnE;;;;;OAKG;IACH,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,IAAI;IAM3E;;;;OAIG;IACH,mBAAmB,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,IAAI;IAM1D;;;;;;OAMG;IACH,gBAAgB,CACd,MAAM,CAAC,EAAE,MAAM,EACf,MAAM,GAAE,KAAK,GAAG,MAAc,EAC9B,OAAO,CAAC,EAAE,qBAAqB,GAC9B,IAAI;IAMP;;;;;OAKG;IACH,mBAAmB,CACjB,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,qBAAqB,GAAG;QAChC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QAC7B,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;KAC9B,GACA,IAAI;IAMP;;;;;;;;;;OAUG;IACH,wBAAwB,CAAC,OAAO,EAAE;QAChC,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,GAAG,IAAI;CAKT"}
+{"version":3,"file":"RampsController.d.cts","sourceRoot":"","sources":["../src/RampsController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACxB,0BAA0B,EAE3B,kCAAkC;AACnC,OAAO,EAAE,cAAc,EAAE,kCAAkC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,4BAA4B;AAGrD,OAAO,KAAK,EACV,OAAO,EACP,cAAc,EACd,QAAQ,EACR,KAAK,EACL,UAAU,EACV,aAAa,EACb,sBAAsB,EACtB,UAAU,EACX,2BAAuB;AACxB,OAAO,KAAK,EACV,gCAAgC,EAChC,8BAA8B,EAC9B,2BAA2B,EAC3B,8BAA8B,EAC9B,mCAAmC,EACpC,+CAA2C;AAC5C,OAAO,KAAK,EACV,YAAY,IAAI,gBAAgB,EAChC,YAAY,EACZ,qBAAqB,EAEtB,2BAAuB;AAcxB;;;;GAIG;AACH,eAAO,MAAM,cAAc,oBAAoB,CAAC;AAIhD;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC;;;;;OAKG;IACH,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9B;;;OAGG;IACH,gBAAgB,EAAE,QAAQ,GAAG,IAAI,CAAC;IAClC;;OAEG;IACH,SAAS,EAAE,OAAO,EAAE,CAAC;IACrB;;OAEG;IACH,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB;;;OAGG;IACH,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;IAC9B;;;OAGG;IACH,aAAa,EAAE,UAAU,GAAG,IAAI,CAAC;IACjC;;;OAGG;IACH,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC;;;OAGG;IACH,qBAAqB,EAAE,aAAa,GAAG,IAAI,CAAC;IAC5C;;;OAGG;IACH,QAAQ,EAAE,gBAAgB,CAAC;CAC5B,CAAC;AA8DF;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,IAAI,oBAAoB,CAYrE;AAID;;GAEG;AACH,MAAM,MAAM,6BAA6B,GAAG,wBAAwB,CAClE,OAAO,cAAc,EACrB,oBAAoB,CACrB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,6BAA6B,CAAC;AAEnE;;GAEG;AACH,KAAK,cAAc,GACf,gCAAgC,GAChC,8BAA8B,GAC9B,2BAA2B,GAC3B,8BAA8B,GAC9B,mCAAmC,CAAC;AAExC;;GAEG;AACH,MAAM,MAAM,+BAA+B,GAAG,0BAA0B,CACtE,OAAO,cAAc,EACrB,oBAAoB,CACrB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,+BAA+B,CAAC;AAEpE;;GAEG;AACH,KAAK,aAAa,GAAG,KAAK,CAAC;AAE3B;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG,SAAS,CAC9C,OAAO,cAAc,EACrB,sBAAsB,GAAG,cAAc,EACvC,qBAAqB,GAAG,aAAa,CACtC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,gDAAgD;IAChD,SAAS,EAAE,wBAAwB,CAAC;IACpC,kEAAkE;IAClE,KAAK,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACtC,gFAAgF;IAChF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uEAAuE;IACvE,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAoEF;;GAEG;AACH,qBAAa,eAAgB,SAAQ,cAAc,CACjD,OAAO,cAAc,EACrB,oBAAoB,EACpB,wBAAwB,CACzB;;IAiBC;;;;;;;;;OASG;gBACS,EACV,SAAS,EACT,KAAU,EACV,eAA2C,EAC3C,mBAAoD,GACrD,EAAE,sBAAsB;IAiBzB;;;;;;;;;;;OAWG;IACG,cAAc,CAAC,OAAO,EAC1B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,OAAO,CAAC,EAClD,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,OAAO,CAAC;IAkEnB;;;;;OAKG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAsCvC;;;;;OAKG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAyD3D;;;;;;;OAOG;IACG,aAAa,CACjB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,UAAU,CAAC;IAqDtB;;;;;;;OAOG;IACH,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IA6CpD;;;;;;;;;OASG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAe1D,YAAY,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,IAAI;IAYnD;;;;;;;OAOG;IACG,YAAY,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAkBvE;;;;;;;;;OASG;IACG,SAAS,CACb,MAAM,CAAC,EAAE,MAAM,EACf,MAAM,GAAE,UAAkB,EAC1B,OAAO,CAAC,EAAE,qBAAqB,GAAG;QAChC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;KAC9B,GACA,OAAO,CAAC,cAAc,CAAC;IA0C1B;;;;;;;OAOG;IACH,gBAAgB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IA6CxC;;;;;;;;;;;OAWG;IACG,YAAY,CAChB,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,qBAAqB,GAAG;QAChC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QAC7B,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;KAC9B,GACA,OAAO,CAAC;QAAE,SAAS,EAAE,QAAQ,EAAE,CAAA;KAAE,CAAC;IA8CrC;;;;;;;;;;OAUG;IACG,iBAAiB,CACrB,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,qBAAqB,GAAG;QAChC,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GACA,OAAO,CAAC,sBAAsB,CAAC;IAqElC;;;;;;OAMG;IACH,wBAAwB,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI;IAmCxD;;;;;OAKG;IACH,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,IAAI;IAM3E;;;;OAIG;IACH,mBAAmB,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,IAAI;IAM1D;;;;;;OAMG;IACH,gBAAgB,CACd,MAAM,CAAC,EAAE,MAAM,EACf,MAAM,GAAE,KAAK,GAAG,MAAc,EAC9B,OAAO,CAAC,EAAE,qBAAqB,GAC9B,IAAI;IAMP;;;;;OAKG;IACH,mBAAmB,CACjB,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,qBAAqB,GAAG;QAChC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QAC7B,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;KAC9B,GACA,IAAI;IAMP;;;;;;;;OAQG;IACH,wBAAwB,CACtB,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,qBAAqB,GAAG;QAChC,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GACA,IAAI;CAKR"}

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 } from "./RampsService.mjs";
+import type { Country, TokensResponse, Provider, State, RampAction, PaymentMethod, PaymentMethodsResponse, RampsToken } 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 preferred provider.
+     * The user's selected provider.
      * Can be manually set by the user.
      */
-    preferredProvider: Provider | null;
+    selectedProvider: Provider | null;
     /**
      * List of countries available for ramp actions.
      */
@@ -56,6 +56,11 @@ 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.
@@ -176,12 +181,14 @@ export declare class RampsController extends BaseController<typeof controllerNam
      */
     setUserRegion(region: string, options?: ExecuteRequestOptions): Promise<UserRegion>;
     /**
-     * Sets the user's preferred provider.
-     * This allows users to set their preferred ramp provider.
+     * 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.
      *
-     * @param provider - The provider object to set.
+     * @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.
      */
-    setPreferredProvider(provider: Provider | null): void;
+    setSelectedProvider(providerId: string | 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.
@@ -216,6 +223,15 @@ 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..."), or undefined to clear.
+     * @throws If 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.
@@ -240,29 +256,26 @@ 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.
-     * @param options.forceRefresh - Whether to bypass cache.
-     * @param options.ttl - Custom TTL for this request.
      * @returns The payment methods response containing payments array.
      */
-    getPaymentMethods(options: {
-        region?: string;
+    getPaymentMethods(region?: string, options?: ExecuteRequestOptions & {
         fiat?: string;
-        assetId: string;
-        provider: string;
-        forceRefresh?: boolean;
-        ttl?: number;
+        assetId?: string;
+        provider?: string;
     }): Promise<PaymentMethodsResponse>;
     /**
-     * Sets the user's selected payment method.
+     * Sets the user's selected payment method by ID.
+     * Looks up the payment method from the current payment methods in state.
      *
-     * @param paymentMethod - The payment method to select, or null to clear.
+     * @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.
      */
-    setSelectedPaymentMethod(paymentMethod: PaymentMethod | null): void;
+    setSelectedPaymentMethod(paymentMethodId?: string): void;
     /**
      * Triggers setting the user region without throwing.
      *
@@ -299,21 +312,16 @@ 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(options: {
-        region?: string;
+    triggerGetPaymentMethods(region?: string, options?: ExecuteRequestOptions & {
         fiat?: string;
-        assetId: string;
-        provider: string;
-        forceRefresh?: boolean;
-        ttl?: number;
+        assetId?: string;
+        provider?: string;
     }): void;
 }
 export {};

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,
     },
-    preferredProvider: {
-        persist: true,
+    selectedProvider: {
+        persist: false,
         includeInDebugSnapshot: true,
         includeInStateLogs: true,
         usedInUi: true,
@@ -53,6 +53,12 @@ const rampsControllerMetadata = {
         includeInStateLogs: true,
         usedInUi: true,
     },
+    selectedToken: {
+        persist: false,
+        includeInDebugSnapshot: true,
+        includeInStateLogs: true,
+        usedInUi: true,
+    },
     paymentMethods: {
         persist: false,
         includeInDebugSnapshot: true,
@@ -83,10 +89,11 @@ const rampsControllerMetadata = {
 export function getDefaultRampsControllerState() {
     return {
         userRegion: null,
-        preferredProvider: null,
+        selectedProvider: null,
         countries: [],
         providers: [],
         tokens: null,
+        selectedToken: null,
         paymentMethods: [],
         selectedPaymentMethod: null,
         requests: {},
@@ -208,7 +215,6 @@ 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)) {
@@ -303,7 +309,8 @@ export class RampsController extends BaseController {
             // Set the new region atomically with cleanup to avoid intermediate null state
             this.update((state) => {
                 if (regionChanged) {
-                    state.preferredProvider = null;
+                    state.selectedProvider = null;
+                    state.selectedToken = null;
                     state.tokens = null;
                     state.providers = [];
                     state.paymentMethods = [];
@@ -326,14 +333,44 @@ export class RampsController extends BaseController {
         }
     }
     /**
-     * Sets the user's preferred provider.
-     * This allows users to set their preferred ramp provider.
+     * 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.
      *
-     * @param provider - The provider object to set.
+     * @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.
      */
-    setPreferredProvider(provider) {
+    setSelectedProvider(providerId) {
+        if (providerId === null) {
+            this.update((state) => {
+                state.selectedProvider = null;
+                state.paymentMethods = [];
+                state.selectedPaymentMethod = 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.`);
+        }
         this.update((state) => {
-            state.preferredProvider = provider;
+            state.selectedProvider = provider;
+            state.paymentMethods = [];
+            state.selectedPaymentMethod = null;
+        });
+        // fetch payment methods for 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,
         });
     }
     /**
@@ -415,6 +452,45 @@ 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..."), or undefined to clear.
+     * @throws If region is not set, tokens are not loaded, or token is not found.
+     */
+    setSelectedToken(assetId) {
+        if (!assetId) {
+            this.update((state) => {
+                state.selectedToken = null;
+                state.paymentMethods = [];
+                state.selectedPaymentMethod = null;
+            });
+            return;
+        }
+        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;
+            state.paymentMethods = [];
+            state.selectedPaymentMethod = null;
+        });
+        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.
@@ -460,57 +536,81 @@ 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.
-     * @param options.forceRefresh - Whether to bypass cache.
-     * @param options.ttl - Custom TTL for this request.
      * @returns The payment methods response containing payments array.
      */
-    async getPaymentMethods(options) {
-        const regionToUse = options.region ?? this.state.userRegion?.regionCode;
-        const fiatToUse = options.fiat ?? this.state.userRegion?.country?.currency;
-        if (!regionToUse) {
+    async getPaymentMethods(region, options) {
+        const regionCode = region ?? this.state.userRegion?.regionCode ?? null;
+        const fiatToUse = options?.fiat ?? this.state.userRegion?.country?.currency ?? null;
+        const assetIdToUse = options?.assetId ?? this.state.selectedToken?.assetId ?? '';
+        const providerToUse = options?.provider ?? this.state.selectedProvider?.id ?? '';
+        if (!regionCode) {
             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 = regionToUse.toLowerCase().trim();
+        const normalizedRegion = regionCode.toLowerCase().trim();
         const normalizedFiat = fiatToUse.toLowerCase().trim();
         const cacheKey = createCacheKey('getPaymentMethods', [
             normalizedRegion,
             normalizedFiat,
-            options.assetId,
-            options.provider,
+            assetIdToUse,
+            providerToUse,
         ]);
         const response = await this.executeRequest(cacheKey, async () => {
             return this.messenger.call('RampsService:getPaymentMethods', {
                 region: normalizedRegion,
                 fiat: normalizedFiat,
-                assetId: options.assetId,
-                provider: options.provider,
+                assetId: assetIdToUse,
+                provider: providerToUse,
             });
-        }, { forceRefresh: options.forceRefresh, ttl: options.ttl });
+        }, options);
         this.update((state) => {
-            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;
+            const currentAssetId = state.selectedToken?.assetId ?? '';
+            const currentProviderId = state.selectedProvider?.id ?? '';
+            const tokenSelectionUnchanged = assetIdToUse === currentAssetId;
+            const providerSelectionUnchanged = providerToUse === currentProviderId;
+            // this is a race condition check to ensure that the selected token and provider in state are the same as the tokens we're requesting for
+            // ex: if the user rapidly changes the token or provider, the in-flight payment methods might not be valid
+            // so this check will ensure that the payment methods are still valid for the token and provider that were requested
+            if (tokenSelectionUnchanged && providerSelectionUnchanged) {
+                state.paymentMethods = response.payments;
+                // this will auto-select the first payment method if the selected payment method is not in the new payment methods
+                const currentSelectionStillValid = response.payments.some((pm) => pm.id === state.selectedPaymentMethod?.id);
+                if (!currentSelectionStillValid) {
+                    state.selectedPaymentMethod = response.payments[0] ?? null;
+                }
             }
         });
         return response;
     }
     /**
-     * Sets the user's selected payment method.
+     * Sets the user's selected payment method by ID.
+     * Looks up the payment method from the current payment methods in state.
      *
-     * @param paymentMethod - The payment method to select, or null to clear.
+     * @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.
      */
-    setSelectedPaymentMethod(paymentMethod) {
+    setSelectedPaymentMethod(paymentMethodId) {
+        if (!paymentMethodId) {
+            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.`);
+        }
         this.update((state) => {
             state.selectedPaymentMethod = paymentMethod;
         });
@@ -567,16 +667,14 @@ 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(options) {
-        this.getPaymentMethods(options).catch(() => {
+    triggerGetPaymentMethods(region, options) {
+        this.getPaymentMethods(region, options).catch(() => {
             // Error stored in state
         });
     }
@@ -589,7 +687,8 @@ _RampsController_requestCacheTTL = new WeakMap(), _RampsController_requestCacheM
 }, _RampsController_cleanupState = function _RampsController_cleanupState() {
     this.update((state) => {
         state.userRegion = null;
-        state.preferredProvider = null;
+        state.selectedProvider = null;
+        state.selectedToken = null;
         state.tokens = null;
         state.providers = [];
         state.paymentMethods = [];