feat(ramps-controller): dev-api URLs for Development (#8574)

## Explanation

`RampsEnvironment.Development` previously fell through the same branch
as staging and sent all traffic to the UAT hosts
(`on-ramp*.uat-api.cx.metamask.io`). This PR gives development its own
API hosts on the `dev-api` subdomain, aligned with production/staging
patterns.

Implementation details:

- **Orders (and other non-regions callers)** use
`https://on-ramp.dev-api.cx.metamask.io`.
- **Regions / cache-backed endpoints** use
`https://on-ramp-cache.dev-api.cx.metamask.io` via the same `${cache}`
suffix as other environments (so `getCountries` and related regions
traffic stay on the cache host).

Production, staging, and local base URLs are unchanged.

Draft Mobile PR: MetaMask/metamask-mobile#29526

## References

- PR branch: `feature/enable-dev-ramps`
- Follows the same `on-ramp${cache}.<env>-api.cx.metamask.io` shape as
production and staging.

## Testing

`yarn workspace @metamask/ramps-controller jest
packages/ramps-controller/src/RampsService.test.ts`

## Checklist

- [x] I've updated the test suite for new or updated code as appropriate
- [x] I've updated documentation (JSDoc, Markdown, etc.) for new or
updated code as appropriate
- [x] I've communicated my changes to consumers by [updating changelogs
for packages I've
changed](https://github.com/MetaMask/core/tree/main/docs/processes/updating-changelogs.md)
- [ ] I've introduced [breaking
changes](https://github.com/MetaMask/core/tree/main/docs/processes/breaking-changes.md)
in this PR and have prepared draft pull requests for clients and
consumer packages to resolve them (not applicable — no breaking changes;
`Development` now targets dedicated dev hosts instead of UAT)

## Risk

Low for production/staging users. Consumers that instantiate
`RampsService` (or the controller) with `RampsEnvironment.Development`
will hit new hostnames; confirm dev-api is reachable and
feature-complete for your flows before relying on it.

---------

Co-authored-by: Amitabh Aggarwal <[email protected]>

Author: pkowalski

packages/ramps-controller/CHANGELOG.md

@@ -10,6 +10,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Changed
 
 - Bump `@metamask/messenger` from `^1.1.1` to `^1.2.0` ([#8632](https://github.com/MetaMask/core/pull/8632))
+- `RampsService` routes `RampsEnvironment.Development` to dev-api base URLs; regions requests in development omit the `-cache` hostname segment used in staging and production ([#8574](https://github.com/MetaMask/core/pull/8574))
 
 ## [13.2.0]
 

packages/ramps-controller/src/RampsService.test.ts

@@ -67,8 +67,8 @@ describe('RampsService', () => {
       expect(geolocationResponse).toBe('us-tx');
     });
 
-    it('uses staging URL when environment is Development', async () => {
-      nock('https://on-ramp.uat-api.cx.metamask.io')
+    it('uses development URL when environment is Development', async () => {
+      nock('https://on-ramp.dev-api.cx.metamask.io')
         .get('/geolocation')
         .query({
           sdk: '2.1.6',
@@ -423,8 +423,8 @@ describe('RampsService', () => {
       `);
     });
 
-    it('uses staging cache URL when environment is Development', async () => {
-      nock('https://on-ramp-cache.uat-api.cx.metamask.io')
+    it('uses development regions URL without cache hostname', async () => {
+      nock('https://on-ramp.dev-api.cx.metamask.io')
         .get('/v2/regions/countries')
         .query({
           sdk: '2.1.6',

packages/ramps-controller/src/RampsService.ts

@@ -710,7 +710,8 @@ export type RampsServiceMessenger = Messenger<
 
 /**
  * Gets the base URL for API requests based on the environment and service type.
- * The Regions service uses a cache URL, while other services use the standard URL.
+ * The Regions service uses a cache hostname in production and staging only;
+ * development serves regions from the same `on-ramp.dev-api` host (no `-cache`).
  *
  * @param environment - The environment to use.
  * @param service - The API service type (determines if cache URL is used).
@@ -720,14 +721,19 @@ function getBaseUrl(
   environment: RampsEnvironment,
   service: RampsApiService,
 ): string {
-  const cache = service === RampsApiService.Regions ? '-cache' : '';
+  const cache =
+    service === RampsApiService.Regions &&
+    environment !== RampsEnvironment.Development
+      ? '-cache'
+      : '';
 
   switch (environment) {
     case RampsEnvironment.Production:
       return `https://on-ramp${cache}.api.cx.metamask.io`;
     case RampsEnvironment.Staging:
-    case RampsEnvironment.Development:
       return `https://on-ramp${cache}.uat-api.cx.metamask.io`;
+    case RampsEnvironment.Development:
+      return `https://on-ramp${cache}.dev-api.cx.metamask.io`;
     case RampsEnvironment.Local:
       return 'http://localhost:3000';
     default: