@metamask/ramps-controller 20.3.0 → 22.0.0

package/CHANGELOG.md

@@ -7,6 +7,45 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [22.0.0]
+
+### Added
+
+- Add V2 ramps order syncing with User Storage ([#9474](https://github.com/MetaMask/core/pull/9474))
+  - Synchronize orders across clients for the same SRP using timestamp-based last-write-wins conflict resolution, soft-delete tombstones, and incremental add/update/delete pushes
+  - Feature key: `rampsOrders`; hosts call `RampsController:syncOrdersWithUserStorage` on unlock when Backup & Sync + ramps syncing are enabled
+  - Persist optional `lastUpdatedAt` on local `RampsOrder` entries for LWW (not returned by the V2 API)
+  - Strip `paymentDetails` from remote payloads (PII stays local-only)
+  - Soft deletes use remote tombstones; retention matches contact sync (no remote purge/compaction)
+  - Mid-sync local mutations coalesce into a follow-up full sync pass so uploads are not dropped during `performBatchSetStorage`
+  - Polling via `getOrder` → `addOrder` stamps `lastUpdatedAt` and writes to User Storage only when the syncable payload changed
+  - Normalize ISO and numeric-string `createdAt` values from Portfolio and older clients to epoch milliseconds
+  - Optional `onOrderSyncErroneousSituation` (full sync and incremental push/delete) and `trace` callbacks
+
+### Changed
+
+- **BREAKING:** `RampsControllerMessenger` now requires these actions to be delegated for order syncing ([#9474](https://github.com/MetaMask/core/pull/9474)):
+  - `UserStorageController:getState`
+  - `UserStorageController:performGetStorageAllFeatureEntries`
+  - `UserStorageController:performBatchSetStorage`
+  - `AuthenticationController:isSignedIn`
+- Bump `@metamask/profile-sync-controller` from `^31.0.0` to `^32.0.0` ([#10166](https://github.com/MetaMask/core/pull/10166))
+
+## [21.0.0]
+
+### Changed
+
+- **BREAKING:** Drop CommonJS support ([#9536](https://github.com/MetaMask/core/pull/9536))
+  - This package is now ESM-only, but can still be used in CommonJS projects via `require(esm)` in modern Node.js versions (22+), or dynamic imports in older Node.js versions.
+- **BREAKING:** Bump minimum Node.js version to 22 ([#9976](https://github.com/MetaMask/core/pull/9976))
+- **BREAKING:** Bump TypeScript target to ES2022 ([#10019](https://github.com/MetaMask/core/pull/10019))
+  - This package now ships ES2022 code, requiring a compatible modern environment or bundler configuration to consume.
+- Bump `@metamask/base-controller` from `^9.1.0` to `^10.0.0` ([#10160](https://github.com/MetaMask/core/pull/10160))
+- Bump `@metamask/controller-utils` from `^12.3.0` to `^13.0.0` ([#10160](https://github.com/MetaMask/core/pull/10160))
+- Bump `@metamask/messenger` from `^2.0.0` to `^3.0.0` ([#10160](https://github.com/MetaMask/core/pull/10160))
+- Bump `@metamask/profile-sync-controller` from `^30.0.0` to `^31.0.0` ([#10160](https://github.com/MetaMask/core/pull/10160))
+- Bump `@metamask/remote-feature-flag-controller` from `^6.1.1` to `^7.0.0` ([#10160](https://github.com/MetaMask/core/pull/10160))
+
 ## [20.3.0]
 
 ### Added
@@ -558,7 +597,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@20.3.0...HEAD
+[Unreleased]: https://github.com/MetaMask/core/compare/@metamask/ramps-controller@22.0.0...HEAD
+[22.0.0]: https://github.com/MetaMask/core/compare/@metamask/ramps-controller@21.0.0...@metamask/ramps-controller@22.0.0
+[21.0.0]: https://github.com/MetaMask/core/compare/@metamask/ramps-controller@20.3.0...@metamask/ramps-controller@21.0.0
 [20.3.0]: https://github.com/MetaMask/core/compare/@metamask/ramps-controller@20.2.0...@metamask/ramps-controller@20.3.0
 [20.2.0]: https://github.com/MetaMask/core/compare/@metamask/ramps-controller@20.1.0...@metamask/ramps-controller@20.2.0
 [20.1.0]: https://github.com/MetaMask/core/compare/@metamask/ramps-controller@20.0.0...@metamask/ramps-controller@20.1.0

package/dist/{NeoBankService-method-action-types.d.mts → NeoBankService-method-action-types.d.ts}

@@ -2,7 +2,7 @@
  * This file is auto generated.
  * Do not edit manually.
  */
-import type { NeoBankService } from "./NeoBankService.mjs";
+import type { NeoBankService } from './NeoBankService.js';
 /**
  * Fetches an autoramp account via neobank-proxy
  * `GET /neobank/autoramps/{autoramp_id}` (MoonPay
@@ -123,4 +123,4 @@ export type NeoBankServiceRegisterSelfHostedWalletAction = {
  * Union of all NeoBankService action types.
  */
 export type NeoBankServiceMethodActions = NeoBankServiceGetAutorampAction | NeoBankServiceRegisterPixAddressAction | NeoBankServiceGetAutorampQuoteAction | NeoBankServiceCreateAutorampAction | NeoBankServiceGetAutorampQuoteForAutorampAction | NeoBankServiceAttachAutorampQuoteAction | NeoBankServiceGetCustomerByExternalIdAction | NeoBankServiceGetMoonpayCustomerIdAction | NeoBankServiceGetWalletRegistrationStatusAction | NeoBankServiceRegisterSelfHostedWalletAction;
-//# sourceMappingURL=NeoBankService-method-action-types.d.mts.map
+//# sourceMappingURL=NeoBankService-method-action-types.d.ts.map

package/dist/NeoBankService-method-action-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NeoBankService-method-action-types.d.ts","sourceRoot":"","sources":["../src/NeoBankService-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D;;;;;;;GAOG;AACH,MAAM,MAAM,+BAA+B,GAAG;IAC5C,IAAI,EAAE,4BAA4B,CAAC;IACnC,OAAO,EAAE,cAAc,CAAC,aAAa,CAAC,CAAC;CACxC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,sCAAsC,GAAG;IACnD,IAAI,EAAE,mCAAmC,CAAC;IAC1C,OAAO,EAAE,cAAc,CAAC,oBAAoB,CAAC,CAAC;CAC/C,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,oCAAoC,GAAG;IACjD,IAAI,EAAE,iCAAiC,CAAC;IACxC,OAAO,EAAE,cAAc,CAAC,kBAAkB,CAAC,CAAC;CAC7C,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,kCAAkC,GAAG;IAC/C,IAAI,EAAE,+BAA+B,CAAC;IACtC,OAAO,EAAE,cAAc,CAAC,gBAAgB,CAAC,CAAC;CAC3C,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,+CAA+C,GAAG;IAC5D,IAAI,EAAE,4CAA4C,CAAC;IACnD,OAAO,EAAE,cAAc,CAAC,6BAA6B,CAAC,CAAC;CACxD,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,uCAAuC,GAAG;IACpD,IAAI,EAAE,oCAAoC,CAAC;IAC3C,OAAO,EAAE,cAAc,CAAC,qBAAqB,CAAC,CAAC;CAChD,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,2CAA2C,GAAG;IACxD,IAAI,EAAE,wCAAwC,CAAC;IAC/C,OAAO,EAAE,cAAc,CAAC,yBAAyB,CAAC,CAAC;CACpD,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,wCAAwC,GAAG;IACrD,IAAI,EAAE,qCAAqC,CAAC;IAC5C,OAAO,EAAE,cAAc,CAAC,sBAAsB,CAAC,CAAC;CACjD,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,+CAA+C,GAAG;IAC5D,IAAI,EAAE,4CAA4C,CAAC;IACnD,OAAO,EAAE,cAAc,CAAC,6BAA6B,CAAC,CAAC;CACxD,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,4CAA4C,GAAG;IACzD,IAAI,EAAE,yCAAyC,CAAC;IAChD,OAAO,EAAE,cAAc,CAAC,0BAA0B,CAAC,CAAC;CACrD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,2BAA2B,GACnC,+BAA+B,GAC/B,sCAAsC,GACtC,oCAAoC,GACpC,kCAAkC,GAClC,+CAA+C,GAC/C,uCAAuC,GACvC,2CAA2C,GAC3C,wCAAwC,GACxC,+CAA+C,GAC/C,4CAA4C,CAAC"}

package/dist/{NeoBankService-method-action-types.mjs → NeoBankService-method-action-types.js}

@@ -3,4 +3,4 @@
  * Do not edit manually.
  */
 export {};
-//# sourceMappingURL=NeoBankService-method-action-types.mjs.map
+//# sourceMappingURL=NeoBankService-method-action-types.js.map

package/dist/NeoBankService-method-action-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NeoBankService-method-action-types.js","sourceRoot":"","sources":["../src/NeoBankService-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated.\n * Do not edit manually.\n */\n\nimport type { NeoBankService } from './NeoBankService.js';\n\n/**\n * Fetches an autoramp account via neobank-proxy\n * `GET /neobank/autoramps/{autoramp_id}` (MoonPay\n * `GET /api/autoramps/{autoramp_id}`).\n *\n * @param autorampId - MoonPay / Ramp API autoramp id.\n * @returns Remote snapshot for controller apply/refresh.\n */\nexport type NeoBankServiceGetAutorampAction = {\n  type: `NeoBankService:getAutoramp`;\n  handler: NeoBankService['getAutoramp'];\n};\n\n/**\n * Registers a Pix address via neobank-proxy `POST /neobank/addresses/pix`.\n * Body is forwarded as opaque JSON (MoonPay address schema).\n *\n * @param body - Pix address registration payload.\n * @param options - Optional idempotency key.\n * @returns Parsed proxy JSON response.\n */\nexport type NeoBankServiceRegisterPixAddressAction = {\n  type: `NeoBankService:registerPixAddress`;\n  handler: NeoBankService['registerPixAddress'];\n};\n\n/**\n * Fetches an autoramp quote via neobank-proxy `GET /neobank/autoramps/quote`.\n *\n * @param query - Quote query params (forwarded as-is).\n * @returns Parsed proxy JSON response.\n */\nexport type NeoBankServiceGetAutorampQuoteAction = {\n  type: `NeoBankService:getAutorampQuote`;\n  handler: NeoBankService['getAutorampQuote'];\n};\n\n/**\n * Creates an autoramp from a signed quote via neobank-proxy\n * `POST /neobank/autoramps` (MoonPay `POST /api/autoramps`).\n *\n * @param body - CreateAutoramp / signed-quote payload (forwarded as-is).\n * @param options - Optional idempotency key.\n * @returns Remote snapshot for controller apply/refresh.\n */\nexport type NeoBankServiceCreateAutorampAction = {\n  type: `NeoBankService:createAutoramp`;\n  handler: NeoBankService['createAutoramp'];\n};\n\n/**\n * Fetches a quote for an existing autoramp via neobank-proxy\n * `GET /neobank/autoramps/{autoramp_id}/quote`.\n *\n * @param autorampId - Autoramp id.\n * @param query - Quote query params (forwarded as-is).\n * @returns Parsed proxy JSON response.\n */\nexport type NeoBankServiceGetAutorampQuoteForAutorampAction = {\n  type: `NeoBankService:getAutorampQuoteForAutoramp`;\n  handler: NeoBankService['getAutorampQuoteForAutoramp'];\n};\n\n/**\n * Attaches a signed quote to an autoramp via neobank-proxy\n * `POST /neobank/autoramps/{autoramp_id}/quotes`.\n *\n * @param autorampId - Autoramp id.\n * @param body - Quote attachment payload (forwarded as-is).\n * @param options - Optional idempotency key.\n * @returns Parsed proxy JSON response.\n */\nexport type NeoBankServiceAttachAutorampQuoteAction = {\n  type: `NeoBankService:attachAutorampQuote`;\n  handler: NeoBankService['attachAutorampQuote'];\n};\n\n/**\n * Fetches a customer by partner external id via neobank-proxy\n * `GET /neobank/customers/{external_id}/external`.\n *\n * @param externalId - Partner-assigned external customer id.\n * @returns Parsed proxy JSON response.\n */\nexport type NeoBankServiceGetCustomerByExternalIdAction = {\n  type: `NeoBankService:getCustomerByExternalId`;\n  handler: NeoBankService['getCustomerByExternalId'];\n};\n\n/**\n * Resolves Iron's internal customer id via neobank-proxy customer lookup,\n * using the MetaMask canonical profile id as the partner `external_id`.\n *\n * @returns Iron's internal customer id.\n */\nexport type NeoBankServiceGetMoonpayCustomerIdAction = {\n  type: `NeoBankService:getMoonpayCustomerId`;\n  handler: NeoBankService['getMoonpayCustomerId'];\n};\n\n/**\n * Checks whether a Monad Money Account address is already registered for the\n * given Iron customer.\n *\n * @param params - Customer id and address to check.\n * @param params.customerId - Iron / MoonPay customer UUID.\n * @param params.address - Money Account address.\n * @returns Active, disabled, or absent registration status.\n */\nexport type NeoBankServiceGetWalletRegistrationStatusAction = {\n  type: `NeoBankService:getWalletRegistrationStatus`;\n  handler: NeoBankService['getWalletRegistrationStatus'];\n};\n\n/**\n * Submits a signed Monad Money Account ownership proof via neobank-proxy\n * `POST /neobank/addresses/crypto/selfhosted`.\n *\n * @param params - Signed ownership proof.\n * @returns Registered wallet record.\n */\nexport type NeoBankServiceRegisterSelfHostedWalletAction = {\n  type: `NeoBankService:registerSelfHostedWallet`;\n  handler: NeoBankService['registerSelfHostedWallet'];\n};\n\n/**\n * Union of all NeoBankService action types.\n */\nexport type NeoBankServiceMethodActions =\n  | NeoBankServiceGetAutorampAction\n  | NeoBankServiceRegisterPixAddressAction\n  | NeoBankServiceGetAutorampQuoteAction\n  | NeoBankServiceCreateAutorampAction\n  | NeoBankServiceGetAutorampQuoteForAutorampAction\n  | NeoBankServiceAttachAutorampQuoteAction\n  | NeoBankServiceGetCustomerByExternalIdAction\n  | NeoBankServiceGetMoonpayCustomerIdAction\n  | NeoBankServiceGetWalletRegistrationStatusAction\n  | NeoBankServiceRegisterSelfHostedWalletAction;\n"]}

package/dist/{NeoBankService.d.cts → NeoBankService.d.ts}

@@ -1,10 +1,10 @@
-import type { CreateServicePolicyOptions, ServicePolicy } from "@metamask/controller-utils";
-import type { Messenger } from "@metamask/messenger";
-import type { AuthenticationController } from "@metamask/profile-sync-controller";
-import type { AutorampRemoteSnapshot } from "./autoramp-types.cjs";
-import type { NeoBankServiceMethodActions } from "./NeoBankService-method-action-types.cjs";
-import { RampsEnvironment } from "./RampsService.cjs";
-import type { RegistrationOutcome, RegistrationStatus } from "./wallet-registration-service.cjs";
+import type { CreateServicePolicyOptions, ServicePolicy } from '@metamask/controller-utils';
+import type { Messenger } from '@metamask/messenger';
+import type { AuthenticationController } from '@metamask/profile-sync-controller';
+import type { AutorampRemoteSnapshot } from './autoramp-types.js';
+import type { NeoBankServiceMethodActions } from './NeoBankService-method-action-types.js';
+import { RampsEnvironment } from './RampsService.js';
+import type { RegistrationOutcome, RegistrationStatus } from './wallet-registration-service.js';
 /**
  * Name of the NeoBankService messenger namespace.
  */
@@ -188,4 +188,4 @@ export declare class NeoBankService {
     onDegraded(listener: Parameters<ServicePolicy['onDegraded']>[0]): ReturnType<ServicePolicy['onDegraded']>;
 }
 export {};
-//# sourceMappingURL=NeoBankService.d.cts.map
+//# sourceMappingURL=NeoBankService.d.ts.map

package/dist/NeoBankService.d.ts.map

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

package/dist/NeoBankService.js

@@ -0,0 +1,380 @@
+import { createServicePolicy, handleWhen, HttpError, } from '@metamask/controller-utils';
+import packageJson from '../package.json';
+import { RAMPS_SDK_VERSION, RampsEnvironment } from './RampsService.js';
+import { WalletRegistrationService } from './wallet-registration-service.js';
+/**
+ * Name of the NeoBankService messenger namespace.
+ */
+export const serviceName = 'NeoBankService';
+/**
+ * Determines whether a failed neo-bank request is worth re-issuing.
+ *
+ * 4xx responses describe the request or the account's state (e.g. 403
+ * "Customer is not active", 422 validation), so repeating them only multiplies
+ * the same rejection. 429 stays retryable alongside 5xx and non-HTTP
+ * network/timeout errors.
+ *
+ * @param error - Error thrown while performing the request.
+ * @returns `true` when the error is worth retrying.
+ */
+function isRetryableError(error) {
+    if (error instanceof HttpError) {
+        if (error.httpStatus === 429) {
+            return true;
+        }
+        return error.httpStatus < 400 || error.httpStatus >= 500;
+    }
+    return true;
+}
+const MESSENGER_EXPOSED_METHODS = [
+    'getAutoramp',
+    'registerPixAddress',
+    'getAutorampQuote',
+    'createAutoramp',
+    'getAutorampQuoteForAutoramp',
+    'attachAutorampQuote',
+    'getCustomerByExternalId',
+    'getMoonpayCustomerId',
+    'getWalletRegistrationStatus',
+    'registerSelfHostedWallet',
+];
+/**
+ * Builds a path under the neobank-proxy global prefix.
+ *
+ * Live neobank-proxy (#1124) mounts routes at `/neobank` on the on-ramp.api
+ * host (ALB path routing, no rewrite). Prefer this over `/api/v2/...` so Core
+ * matches the proxy that ships.
+ *
+ * @param path - Path under `/neobank` (no leading slash).
+ * @returns Absolute path segment for URL join against the Ramp API host.
+ */
+function getNeoBankPath(path) {
+    return `neobank/${path.replace(/^\//u, '')}`;
+}
+/**
+ * Resolves the Ramp API host for neo-bank calls (same hosts as {@link RampsService}).
+ *
+ * @param environment - Ramp environment.
+ * @returns Base URL.
+ */
+function getBaseUrl(environment) {
+    switch (environment) {
+        case RampsEnvironment.Production:
+            return 'https://on-ramp.api.cx.metamask.io';
+        case RampsEnvironment.Staging:
+            return 'https://on-ramp.uat-api.cx.metamask.io';
+        case RampsEnvironment.Development:
+            return 'https://on-ramp.dev-api.cx.metamask.io';
+        case RampsEnvironment.Local:
+            return 'http://localhost:3000';
+        default:
+            throw new Error(`Invalid environment: ${String(environment)}`);
+    }
+}
+/**
+ * Maps a Ramp API / MoonPay-shaped autoramp response into the local remote snapshot.
+ *
+ * @param response - Proxy response body.
+ * @returns Snapshot for the controller last-seen cursor.
+ */
+export function mapNeoBankAutorampToRemoteSnapshot(response) {
+    const depositRails = response.deposit_rails;
+    const hasDepositRails = Array.isArray(depositRails) && depositRails.length > 0;
+    const depositRailsSummary = hasDepositRails || response.status === 'Approved'
+        ? {
+            ready: response.status === 'Approved' && hasDepositRails,
+        }
+        : undefined;
+    return {
+        id: response.id,
+        customerId: response.customer_id,
+        walletAddress: response.wallet_address !== undefined &&
+            response.wallet_address.length > 0
+            ? response.wallet_address
+            : response.recipient_account?.address,
+        status: response.status,
+        depositRailsSummary,
+    };
+}
+/**
+ * Client for MetaMask Ramp API neo-bank endpoints (MoonPay Enterprise proxy).
+ *
+ * Lives alongside {@link RampsService} and {@link TransakService}. Authentication
+ * and MoonPay partner headers are handled by the Ramp API; this service only
+ * attaches the MetaMask user bearer token.
+ *
+ * Paths use the neobank-proxy `/neobank` prefix on the on-ramp.api host.
+ */
+export class NeoBankService {
+    name;
+    #messenger;
+    #fetch;
+    #policy;
+    #noRetryPolicy;
+    #environment;
+    #context;
+    #baseUrlOverride;
+    #walletRegistrationService;
+    constructor({ messenger, environment = RampsEnvironment.Staging, context, fetch: fetchFunction, policyOptions = {}, baseUrlOverride, }) {
+        this.name = serviceName;
+        this.#messenger = messenger;
+        this.#fetch = fetchFunction;
+        this.#policy = createServicePolicy({
+            retryFilterPolicy: handleWhen(isRetryableError),
+            ...policyOptions,
+        });
+        this.#noRetryPolicy = createServicePolicy({
+            retryFilterPolicy: handleWhen(isRetryableError),
+            ...policyOptions,
+            maxRetries: 0,
+        });
+        this.#environment = environment;
+        this.#context = context;
+        this.#baseUrlOverride = baseUrlOverride;
+        this.#messenger.registerMethodActionHandlers(this, MESSENGER_EXPOSED_METHODS);
+    }
+    #getBaseUrl() {
+        if (this.#baseUrlOverride) {
+            return this.#baseUrlOverride;
+        }
+        return getBaseUrl(this.#environment);
+    }
+    /**
+     * Lazily builds the wallet registration client. Deferred so constructing the
+     * service never resolves the base URL eagerly (an invalid environment only
+     * throws when a request is made, matching the other neo-bank methods).
+     *
+     * @returns The wallet registration client.
+     */
+    #getWalletRegistrationService() {
+        this.#walletRegistrationService ??= new WalletRegistrationService({
+            fetch: this.#fetch,
+            baseUrl: this.#getBaseUrl(),
+            getAuthToken: async () => this.#messenger.call('AuthenticationController:getBearerToken'),
+            getExternalId: async () => this.#getCanonicalExternalId(),
+        });
+        return this.#walletRegistrationService;
+    }
+    async #getRequestHeaders(options = {}) {
+        const bearerToken = await this.#messenger.call('AuthenticationController:getBearerToken');
+        const headers = {
+            Authorization: `Bearer ${bearerToken}`,
+        };
+        if (options.idempotencyKey) {
+            headers['Idempotency-Key'] = options.idempotencyKey;
+        }
+        return headers;
+    }
+    #buildUrl(path, query) {
+        const url = new URL(getNeoBankPath(path), this.#getBaseUrl());
+        url.searchParams.set('sdk', RAMPS_SDK_VERSION);
+        url.searchParams.set('controller', packageJson.version);
+        url.searchParams.set('context', this.#context);
+        if (query) {
+            for (const [key, value] of Object.entries(query)) {
+                if (value !== undefined && value !== null) {
+                    url.searchParams.set(key, String(value));
+                }
+            }
+        }
+        return url;
+    }
+    /**
+     * Throws an {@link HttpError} that carries the upstream response body.
+     *
+     * The neobank-proxy mirrors MoonPay's status *and* body verbatim, so the
+     * body is usually the only place that explains a 4xx (e.g. which field or
+     * permission was rejected). Dropping it makes failures undiagnosable.
+     *
+     * @param url - Request URL, for context in the message.
+     * @param response - Non-OK fetch response.
+     */
+    async #throwHttpError(url, response) {
+        let detail = '';
+        try {
+            const body = (await response.text()).trim();
+            if (body) {
+                detail = ` - ${body.slice(0, 500)}`;
+            }
+        }
+        catch {
+            // Body already consumed or unreadable; the status alone still helps.
+        }
+        throw new HttpError(response.status, `Fetching '${url.toString()}' failed with status '${response.status}'${detail}`);
+    }
+    async #getJson(path, query) {
+        const url = this.#buildUrl(path, query);
+        return this.#policy.execute(async () => {
+            const headers = await this.#getRequestHeaders();
+            const fetchResponse = await this.#fetch(url, { headers });
+            if (!fetchResponse.ok) {
+                await this.#throwHttpError(url, fetchResponse);
+            }
+            return fetchResponse.json();
+        });
+    }
+    async #postJson(path, body, options) {
+        const url = this.#buildUrl(path);
+        return this.#noRetryPolicy.execute(async () => {
+            const headers = await this.#getRequestHeaders(options);
+            headers['Content-Type'] = 'application/json';
+            const fetchResponse = await this.#fetch(url, {
+                method: 'POST',
+                headers,
+                body: JSON.stringify(body),
+            });
+            if (!fetchResponse.ok) {
+                await this.#throwHttpError(url, fetchResponse);
+            }
+            return fetchResponse.json();
+        });
+    }
+    #mapAutorampResponse(response) {
+        if (!response || typeof response !== 'object' || !response.id) {
+            throw new Error('Malformed response received from neo-bank autoramp API');
+        }
+        return mapNeoBankAutorampToRemoteSnapshot(response);
+    }
+    /**
+     * Fetches an autoramp account via neobank-proxy
+     * `GET /neobank/autoramps/{autoramp_id}` (MoonPay
+     * `GET /api/autoramps/{autoramp_id}`).
+     *
+     * @param autorampId - MoonPay / Ramp API autoramp id.
+     * @returns Remote snapshot for controller apply/refresh.
+     */
+    async getAutoramp(autorampId) {
+        const response = await this.#getJson(`autoramps/${encodeURIComponent(autorampId)}`);
+        return this.#mapAutorampResponse(response);
+    }
+    /**
+     * Registers a Pix address via neobank-proxy `POST /neobank/addresses/pix`.
+     * Body is forwarded as opaque JSON (MoonPay address schema).
+     *
+     * @param body - Pix address registration payload.
+     * @param options - Optional idempotency key.
+     * @returns Parsed proxy JSON response.
+     */
+    async registerPixAddress(body, options = {}) {
+        return this.#postJson('addresses/pix', body, options);
+    }
+    /**
+     * Fetches an autoramp quote via neobank-proxy `GET /neobank/autoramps/quote`.
+     *
+     * @param query - Quote query params (forwarded as-is).
+     * @returns Parsed proxy JSON response.
+     */
+    async getAutorampQuote(query = {}) {
+        return this.#getJson('autoramps/quote', query);
+    }
+    /**
+     * Creates an autoramp from a signed quote via neobank-proxy
+     * `POST /neobank/autoramps` (MoonPay `POST /api/autoramps`).
+     *
+     * @param body - CreateAutoramp / signed-quote payload (forwarded as-is).
+     * @param options - Optional idempotency key.
+     * @returns Remote snapshot for controller apply/refresh.
+     */
+    async createAutoramp(body, options = {}) {
+        const response = await this.#postJson('autoramps', body, options);
+        return this.#mapAutorampResponse(response);
+    }
+    /**
+     * Fetches a quote for an existing autoramp via neobank-proxy
+     * `GET /neobank/autoramps/{autoramp_id}/quote`.
+     *
+     * @param autorampId - Autoramp id.
+     * @param query - Quote query params (forwarded as-is).
+     * @returns Parsed proxy JSON response.
+     */
+    async getAutorampQuoteForAutoramp(autorampId, query = {}) {
+        return this.#getJson(`autoramps/${encodeURIComponent(autorampId)}/quote`, query);
+    }
+    /**
+     * Attaches a signed quote to an autoramp via neobank-proxy
+     * `POST /neobank/autoramps/{autoramp_id}/quotes`.
+     *
+     * @param autorampId - Autoramp id.
+     * @param body - Quote attachment payload (forwarded as-is).
+     * @param options - Optional idempotency key.
+     * @returns Parsed proxy JSON response.
+     */
+    async attachAutorampQuote(autorampId, body, options = {}) {
+        return this.#postJson(`autoramps/${encodeURIComponent(autorampId)}/quotes`, body, options);
+    }
+    /**
+     * Fetches a customer by partner external id via neobank-proxy
+     * `GET /neobank/customers/{external_id}/external`.
+     *
+     * @param externalId - Partner-assigned external customer id.
+     * @returns Parsed proxy JSON response.
+     */
+    async getCustomerByExternalId(externalId) {
+        return this.#getJson(`customers/${encodeURIComponent(externalId)}/external`);
+    }
+    /**
+     * Resolves Iron's internal customer id via neobank-proxy customer lookup,
+     * using the MetaMask canonical profile id as the partner `external_id`.
+     *
+     * @returns Iron's internal customer id.
+     */
+    async getMoonpayCustomerId() {
+        return await this.#getWalletRegistrationService().getMoonpayCustomerId();
+    }
+    /**
+     * Checks whether a Monad Money Account address is already registered for the
+     * given Iron customer.
+     *
+     * @param params - Customer id and address to check.
+     * @param params.customerId - Iron / MoonPay customer UUID.
+     * @param params.address - Money Account address.
+     * @returns Active, disabled, or absent registration status.
+     */
+    async getWalletRegistrationStatus({ customerId, address, }) {
+        return await this.#getWalletRegistrationService().getRegistrationStatus({
+            customerId,
+            address,
+            blockchain: 'Monad',
+        });
+    }
+    /**
+     * Submits a signed Monad Money Account ownership proof via neobank-proxy
+     * `POST /neobank/addresses/crypto/selfhosted`.
+     *
+     * @param params - Signed ownership proof.
+     * @returns Registered wallet record.
+     */
+    async registerSelfHostedWallet(params) {
+        return await this.#getWalletRegistrationService().registerSelfHostedWallet({
+            ...params,
+            blockchain: 'Monad',
+        });
+    }
+    /**
+     * Resolves the MetaMask canonical profile id used as MoonPay's partner
+     * `external_id` for neobank customer lookup.
+     *
+     * @returns Canonical profile id.
+     */
+    async #getCanonicalExternalId() {
+        const profile = await this.#messenger.call('AuthenticationController:getSessionProfile');
+        const canonical = profile?.canonicalProfileId;
+        const externalId = typeof canonical === 'string' && canonical.length > 0
+            ? canonical
+            : profile?.profileId;
+        if (typeof externalId !== 'string' || externalId.length === 0) {
+            throw new Error('Unable to resolve MetaMask canonical profile id for MoonPay customer lookup');
+        }
+        return externalId;
+    }
+    onRetry(listener) {
+        return this.#policy.onRetry(listener);
+    }
+    onBreak(listener) {
+        return this.#policy.onBreak(listener);
+    }
+    onDegraded(listener) {
+        return this.#policy.onDegraded(listener);
+    }
+}
+//# sourceMappingURL=NeoBankService.js.map

package/dist/NeoBankService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NeoBankService.js","sourceRoot":"","sources":["../src/NeoBankService.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  CreateServicePolicyOptions,\n  ServicePolicy,\n} from '@metamask/controller-utils';\nimport {\n  createServicePolicy,\n  handleWhen,\n  HttpError,\n} from '@metamask/controller-utils';\nimport type { Messenger } from '@metamask/messenger';\nimport type { AuthenticationController } from '@metamask/profile-sync-controller';\n\nimport packageJson from '../package.json';\nimport type {\n  AutorampDepositRailsSummary,\n  AutorampRemoteSnapshot,\n} from './autoramp-types.js';\nimport type { NeoBankServiceMethodActions } from './NeoBankService-method-action-types.js';\nimport { RAMPS_SDK_VERSION, RampsEnvironment } from './RampsService.js';\nimport { WalletRegistrationService } from './wallet-registration-service.js';\nimport type {\n  RegistrationOutcome,\n  RegistrationStatus,\n} from './wallet-registration-service.js';\n\n/**\n * Name of the NeoBankService messenger namespace.\n */\nexport const serviceName = 'NeoBankService';\n\n/**\n * Determines whether a failed neo-bank request is worth re-issuing.\n *\n * 4xx responses describe the request or the account's state (e.g. 403\n * \"Customer is not active\", 422 validation), so repeating them only multiplies\n * the same rejection. 429 stays retryable alongside 5xx and non-HTTP\n * network/timeout errors.\n *\n * @param error - Error thrown while performing the request.\n * @returns `true` when the error is worth retrying.\n */\nfunction isRetryableError(error: unknown): boolean {\n  if (error instanceof HttpError) {\n    if (error.httpStatus === 429) {\n      return true;\n    }\n    return error.httpStatus < 400 || error.httpStatus >= 500;\n  }\n  return true;\n}\n\n/**\n * Raw autoramp payload from the MetaMask Ramp API neo-bank proxy.\n * Shape mirrors MoonPay Enterprise `GET /api/autoramps/{autoramp_id}`.\n * The Ramp API handles partner auth / headers; the client only sends the\n * MetaMask bearer token.\n */\nexport type NeoBankAutorampResponse = {\n  id: string;\n  // eslint-disable-next-line @typescript-eslint/naming-convention -- MoonPay API field\n  customer_id?: string;\n  status: string;\n  /**\n   * Destination wallet when present on the proxy response.\n   * Field name may evolve with the Ramp API contract.\n   */\n  // eslint-disable-next-line @typescript-eslint/naming-convention -- MoonPay API field\n  wallet_address?: string;\n  // eslint-disable-next-line @typescript-eslint/naming-convention -- MoonPay API field\n  recipient_account?: {\n    address?: string;\n  };\n  // eslint-disable-next-line @typescript-eslint/naming-convention -- MoonPay API field\n  deposit_rails?: unknown[];\n};\n\n/**\n * Optional headers for neo-bank mutating requests.\n */\nexport type NeoBankRequestOptions = {\n  /**\n   * Forwarded as `Idempotency-Key` when set (MoonPay requires it on some POSTs;\n   * neobank-proxy generates one when omitted).\n   */\n  idempotencyKey?: string;\n};\n\n/**\n * Query string values accepted by neo-bank GET helpers.\n */\nexport type NeoBankQueryParams = Record<\n  string,\n  string | number | boolean | undefined | null\n>;\n\nexport type GetWalletRegistrationStatusParams = {\n  customerId: string;\n  address: string;\n};\n\nexport type RegisterSelfHostedWalletParams = {\n  customerId: string;\n  address: string;\n  message: string;\n  signature: string;\n  /**\n   * Forwarded as `Idempotency-Key` on the neobank-proxy POST. Prefer a stable\n   * key across retries of the same ownership body.\n   */\n  idempotencyKey?: string;\n};\n\nconst MESSENGER_EXPOSED_METHODS = [\n  'getAutoramp',\n  'registerPixAddress',\n  'getAutorampQuote',\n  'createAutoramp',\n  'getAutorampQuoteForAutoramp',\n  'attachAutorampQuote',\n  'getCustomerByExternalId',\n  'getMoonpayCustomerId',\n  'getWalletRegistrationStatus',\n  'registerSelfHostedWallet',\n] as const;\n\n/**\n * Actions that {@link NeoBankService} exposes to other consumers.\n */\nexport type NeoBankServiceActions = NeoBankServiceMethodActions;\n\ntype AllowedActions =\n  | AuthenticationController.AuthenticationControllerGetBearerTokenAction\n  | AuthenticationController.AuthenticationControllerGetSessionProfileAction;\n\nexport type NeoBankServiceEvents = never;\n\ntype AllowedEvents = never;\n\n/**\n * The messenger restricted to actions and events accessed by\n * {@link NeoBankService}.\n */\nexport type NeoBankServiceMessenger = Messenger<\n  typeof serviceName,\n  NeoBankServiceActions | AllowedActions,\n  NeoBankServiceEvents | AllowedEvents\n>;\n\n/**\n * Builds a path under the neobank-proxy global prefix.\n *\n * Live neobank-proxy (#1124) mounts routes at `/neobank` on the on-ramp.api\n * host (ALB path routing, no rewrite). Prefer this over `/api/v2/...` so Core\n * matches the proxy that ships.\n *\n * @param path - Path under `/neobank` (no leading slash).\n * @returns Absolute path segment for URL join against the Ramp API host.\n */\nfunction getNeoBankPath(path: string): string {\n  return `neobank/${path.replace(/^\\//u, '')}`;\n}\n\n/**\n * Resolves the Ramp API host for neo-bank calls (same hosts as {@link RampsService}).\n *\n * @param environment - Ramp environment.\n * @returns Base URL.\n */\nfunction getBaseUrl(environment: RampsEnvironment): string {\n  switch (environment) {\n    case RampsEnvironment.Production:\n      return 'https://on-ramp.api.cx.metamask.io';\n    case RampsEnvironment.Staging:\n      return 'https://on-ramp.uat-api.cx.metamask.io';\n    case RampsEnvironment.Development:\n      return 'https://on-ramp.dev-api.cx.metamask.io';\n    case RampsEnvironment.Local:\n      return 'http://localhost:3000';\n    default:\n      throw new Error(`Invalid environment: ${String(environment)}`);\n  }\n}\n\n/**\n * Maps a Ramp API / MoonPay-shaped autoramp response into the local remote snapshot.\n *\n * @param response - Proxy response body.\n * @returns Snapshot for the controller last-seen cursor.\n */\nexport function mapNeoBankAutorampToRemoteSnapshot(\n  response: NeoBankAutorampResponse,\n): AutorampRemoteSnapshot {\n  const depositRails = response.deposit_rails;\n  const hasDepositRails =\n    Array.isArray(depositRails) && depositRails.length > 0;\n  const depositRailsSummary: AutorampDepositRailsSummary | undefined =\n    hasDepositRails || response.status === 'Approved'\n      ? {\n          ready: response.status === 'Approved' && hasDepositRails,\n        }\n      : undefined;\n\n  return {\n    id: response.id,\n    customerId: response.customer_id,\n    walletAddress:\n      response.wallet_address !== undefined &&\n      response.wallet_address.length > 0\n        ? response.wallet_address\n        : response.recipient_account?.address,\n    status: response.status,\n    depositRailsSummary,\n  };\n}\n\n/**\n * Client for MetaMask Ramp API neo-bank endpoints (MoonPay Enterprise proxy).\n *\n * Lives alongside {@link RampsService} and {@link TransakService}. Authentication\n * and MoonPay partner headers are handled by the Ramp API; this service only\n * attaches the MetaMask user bearer token.\n *\n * Paths use the neobank-proxy `/neobank` prefix on the on-ramp.api host.\n */\nexport class NeoBankService {\n  readonly name: typeof serviceName;\n\n  readonly #messenger: NeoBankServiceMessenger;\n\n  readonly #fetch: typeof fetch;\n\n  readonly #policy: ServicePolicy;\n\n  readonly #noRetryPolicy: ServicePolicy;\n\n  readonly #environment: RampsEnvironment;\n\n  readonly #context: string;\n\n  readonly #baseUrlOverride?: string;\n\n  #walletRegistrationService: WalletRegistrationService | undefined;\n\n  constructor({\n    messenger,\n    environment = RampsEnvironment.Staging,\n    context,\n    fetch: fetchFunction,\n    policyOptions = {},\n    baseUrlOverride,\n  }: {\n    messenger: NeoBankServiceMessenger;\n    environment?: RampsEnvironment;\n    context: string;\n    fetch: typeof fetch;\n    policyOptions?: CreateServicePolicyOptions;\n    baseUrlOverride?: string;\n  }) {\n    this.name = serviceName;\n    this.#messenger = messenger;\n    this.#fetch = fetchFunction;\n    this.#policy = createServicePolicy({\n      retryFilterPolicy: handleWhen(isRetryableError),\n      ...policyOptions,\n    });\n    this.#noRetryPolicy = createServicePolicy({\n      retryFilterPolicy: handleWhen(isRetryableError),\n      ...policyOptions,\n      maxRetries: 0,\n    });\n    this.#environment = environment;\n    this.#context = context;\n    this.#baseUrlOverride = baseUrlOverride;\n\n    this.#messenger.registerMethodActionHandlers(\n      this,\n      MESSENGER_EXPOSED_METHODS,\n    );\n  }\n\n  #getBaseUrl(): string {\n    if (this.#baseUrlOverride) {\n      return this.#baseUrlOverride;\n    }\n    return getBaseUrl(this.#environment);\n  }\n\n  /**\n   * Lazily builds the wallet registration client. Deferred so constructing the\n   * service never resolves the base URL eagerly (an invalid environment only\n   * throws when a request is made, matching the other neo-bank methods).\n   *\n   * @returns The wallet registration client.\n   */\n  #getWalletRegistrationService(): WalletRegistrationService {\n    this.#walletRegistrationService ??= new WalletRegistrationService({\n      fetch: this.#fetch,\n      baseUrl: this.#getBaseUrl(),\n      getAuthToken: async (): Promise<string> =>\n        this.#messenger.call('AuthenticationController:getBearerToken'),\n      getExternalId: async (): Promise<string> =>\n        this.#getCanonicalExternalId(),\n    });\n    return this.#walletRegistrationService;\n  }\n\n  async #getRequestHeaders(\n    options: NeoBankRequestOptions = {},\n  ): Promise<Record<string, string>> {\n    const bearerToken = await this.#messenger.call(\n      'AuthenticationController:getBearerToken',\n    );\n    const headers: Record<string, string> = {\n      Authorization: `Bearer ${bearerToken}`,\n    };\n    if (options.idempotencyKey) {\n      headers['Idempotency-Key'] = options.idempotencyKey;\n    }\n    return headers;\n  }\n\n  #buildUrl(path: string, query?: NeoBankQueryParams): URL {\n    const url = new URL(getNeoBankPath(path), this.#getBaseUrl());\n    url.searchParams.set('sdk', RAMPS_SDK_VERSION);\n    url.searchParams.set('controller', packageJson.version);\n    url.searchParams.set('context', this.#context);\n    if (query) {\n      for (const [key, value] of Object.entries(query)) {\n        if (value !== undefined && value !== null) {\n          url.searchParams.set(key, String(value));\n        }\n      }\n    }\n    return url;\n  }\n\n  /**\n   * Throws an {@link HttpError} that carries the upstream response body.\n   *\n   * The neobank-proxy mirrors MoonPay's status *and* body verbatim, so the\n   * body is usually the only place that explains a 4xx (e.g. which field or\n   * permission was rejected). Dropping it makes failures undiagnosable.\n   *\n   * @param url - Request URL, for context in the message.\n   * @param response - Non-OK fetch response.\n   */\n  async #throwHttpError(url: URL, response: Response): Promise<never> {\n    let detail = '';\n    try {\n      const body = (await response.text()).trim();\n      if (body) {\n        detail = ` - ${body.slice(0, 500)}`;\n      }\n    } catch {\n      // Body already consumed or unreadable; the status alone still helps.\n    }\n    throw new HttpError(\n      response.status,\n      `Fetching '${url.toString()}' failed with status '${response.status}'${detail}`,\n    );\n  }\n\n  async #getJson<ResponseBody>(\n    path: string,\n    query?: NeoBankQueryParams,\n  ): Promise<ResponseBody> {\n    const url = this.#buildUrl(path, query);\n    return this.#policy.execute(async () => {\n      const headers = await this.#getRequestHeaders();\n      const fetchResponse = await this.#fetch(url, { headers });\n      if (!fetchResponse.ok) {\n        await this.#throwHttpError(url, fetchResponse);\n      }\n      return fetchResponse.json() as Promise<ResponseBody>;\n    });\n  }\n\n  async #postJson<ResponseBody>(\n    path: string,\n    body: Record<string, unknown>,\n    options: NeoBankRequestOptions,\n  ): Promise<ResponseBody> {\n    const url = this.#buildUrl(path);\n    return this.#noRetryPolicy.execute(async () => {\n      const headers = await this.#getRequestHeaders(options);\n      headers['Content-Type'] = 'application/json';\n      const fetchResponse = await this.#fetch(url, {\n        method: 'POST',\n        headers,\n        body: JSON.stringify(body),\n      });\n      if (!fetchResponse.ok) {\n        await this.#throwHttpError(url, fetchResponse);\n      }\n      return fetchResponse.json() as Promise<ResponseBody>;\n    });\n  }\n\n  #mapAutorampResponse(\n    response: NeoBankAutorampResponse,\n  ): AutorampRemoteSnapshot {\n    if (!response || typeof response !== 'object' || !response.id) {\n      throw new Error('Malformed response received from neo-bank autoramp API');\n    }\n    return mapNeoBankAutorampToRemoteSnapshot(response);\n  }\n\n  /**\n   * Fetches an autoramp account via neobank-proxy\n   * `GET /neobank/autoramps/{autoramp_id}` (MoonPay\n   * `GET /api/autoramps/{autoramp_id}`).\n   *\n   * @param autorampId - MoonPay / Ramp API autoramp id.\n   * @returns Remote snapshot for controller apply/refresh.\n   */\n  async getAutoramp(autorampId: string): Promise<AutorampRemoteSnapshot> {\n    const response = await this.#getJson<NeoBankAutorampResponse>(\n      `autoramps/${encodeURIComponent(autorampId)}`,\n    );\n    return this.#mapAutorampResponse(response);\n  }\n\n  /**\n   * Registers a Pix address via neobank-proxy `POST /neobank/addresses/pix`.\n   * Body is forwarded as opaque JSON (MoonPay address schema).\n   *\n   * @param body - Pix address registration payload.\n   * @param options - Optional idempotency key.\n   * @returns Parsed proxy JSON response.\n   */\n  async registerPixAddress(\n    body: Record<string, unknown>,\n    options: NeoBankRequestOptions = {},\n  ): Promise<unknown> {\n    return this.#postJson('addresses/pix', body, options);\n  }\n\n  /**\n   * Fetches an autoramp quote via neobank-proxy `GET /neobank/autoramps/quote`.\n   *\n   * @param query - Quote query params (forwarded as-is).\n   * @returns Parsed proxy JSON response.\n   */\n  async getAutorampQuote(query: NeoBankQueryParams = {}): Promise<unknown> {\n    return this.#getJson('autoramps/quote', query);\n  }\n\n  /**\n   * Creates an autoramp from a signed quote via neobank-proxy\n   * `POST /neobank/autoramps` (MoonPay `POST /api/autoramps`).\n   *\n   * @param body - CreateAutoramp / signed-quote payload (forwarded as-is).\n   * @param options - Optional idempotency key.\n   * @returns Remote snapshot for controller apply/refresh.\n   */\n  async createAutoramp(\n    body: Record<string, unknown>,\n    options: NeoBankRequestOptions = {},\n  ): Promise<AutorampRemoteSnapshot> {\n    const response = await this.#postJson<NeoBankAutorampResponse>(\n      'autoramps',\n      body,\n      options,\n    );\n    return this.#mapAutorampResponse(response);\n  }\n\n  /**\n   * Fetches a quote for an existing autoramp via neobank-proxy\n   * `GET /neobank/autoramps/{autoramp_id}/quote`.\n   *\n   * @param autorampId - Autoramp id.\n   * @param query - Quote query params (forwarded as-is).\n   * @returns Parsed proxy JSON response.\n   */\n  async getAutorampQuoteForAutoramp(\n    autorampId: string,\n    query: NeoBankQueryParams = {},\n  ): Promise<unknown> {\n    return this.#getJson(\n      `autoramps/${encodeURIComponent(autorampId)}/quote`,\n      query,\n    );\n  }\n\n  /**\n   * Attaches a signed quote to an autoramp via neobank-proxy\n   * `POST /neobank/autoramps/{autoramp_id}/quotes`.\n   *\n   * @param autorampId - Autoramp id.\n   * @param body - Quote attachment payload (forwarded as-is).\n   * @param options - Optional idempotency key.\n   * @returns Parsed proxy JSON response.\n   */\n  async attachAutorampQuote(\n    autorampId: string,\n    body: Record<string, unknown>,\n    options: NeoBankRequestOptions = {},\n  ): Promise<unknown> {\n    return this.#postJson(\n      `autoramps/${encodeURIComponent(autorampId)}/quotes`,\n      body,\n      options,\n    );\n  }\n\n  /**\n   * Fetches a customer by partner external id via neobank-proxy\n   * `GET /neobank/customers/{external_id}/external`.\n   *\n   * @param externalId - Partner-assigned external customer id.\n   * @returns Parsed proxy JSON response.\n   */\n  async getCustomerByExternalId(externalId: string): Promise<unknown> {\n    return this.#getJson(\n      `customers/${encodeURIComponent(externalId)}/external`,\n    );\n  }\n\n  /**\n   * Resolves Iron's internal customer id via neobank-proxy customer lookup,\n   * using the MetaMask canonical profile id as the partner `external_id`.\n   *\n   * @returns Iron's internal customer id.\n   */\n  async getMoonpayCustomerId(): Promise<string> {\n    return await this.#getWalletRegistrationService().getMoonpayCustomerId();\n  }\n\n  /**\n   * Checks whether a Monad Money Account address is already registered for the\n   * given Iron customer.\n   *\n   * @param params - Customer id and address to check.\n   * @param params.customerId - Iron / MoonPay customer UUID.\n   * @param params.address - Money Account address.\n   * @returns Active, disabled, or absent registration status.\n   */\n  async getWalletRegistrationStatus({\n    customerId,\n    address,\n  }: GetWalletRegistrationStatusParams): Promise<RegistrationStatus> {\n    return await this.#getWalletRegistrationService().getRegistrationStatus({\n      customerId,\n      address,\n      blockchain: 'Monad',\n    });\n  }\n\n  /**\n   * Submits a signed Monad Money Account ownership proof via neobank-proxy\n   * `POST /neobank/addresses/crypto/selfhosted`.\n   *\n   * @param params - Signed ownership proof.\n   * @returns Registered wallet record.\n   */\n  async registerSelfHostedWallet(\n    params: RegisterSelfHostedWalletParams,\n  ): Promise<RegistrationOutcome> {\n    return await this.#getWalletRegistrationService().registerSelfHostedWallet({\n      ...params,\n      blockchain: 'Monad',\n    });\n  }\n\n  /**\n   * Resolves the MetaMask canonical profile id used as MoonPay's partner\n   * `external_id` for neobank customer lookup.\n   *\n   * @returns Canonical profile id.\n   */\n  async #getCanonicalExternalId(): Promise<string> {\n    const profile = await this.#messenger.call(\n      'AuthenticationController:getSessionProfile',\n    );\n    const canonical = profile?.canonicalProfileId;\n    const externalId =\n      typeof canonical === 'string' && canonical.length > 0\n        ? canonical\n        : profile?.profileId;\n    if (typeof externalId !== 'string' || externalId.length === 0) {\n      throw new Error(\n        'Unable to resolve MetaMask canonical profile id for MoonPay customer lookup',\n      );\n    }\n    return externalId;\n  }\n\n  onRetry(\n    listener: Parameters<ServicePolicy['onRetry']>[0],\n  ): ReturnType<ServicePolicy['onRetry']> {\n    return this.#policy.onRetry(listener);\n  }\n\n  onBreak(\n    listener: Parameters<ServicePolicy['onBreak']>[0],\n  ): ReturnType<ServicePolicy['onBreak']> {\n    return this.#policy.onBreak(listener);\n  }\n\n  onDegraded(\n    listener: Parameters<ServicePolicy['onDegraded']>[0],\n  ): ReturnType<ServicePolicy['onDegraded']> {\n    return this.#policy.onDegraded(listener);\n  }\n}\n"]}

package/dist/{RampsController-method-action-types.d.mts → RampsController-method-action-types.d.ts}

@@ -2,7 +2,7 @@
  * This file is auto generated.
  * Do not edit manually.
  */
-import type { RampsController } from "./RampsController.mjs";
+import type { RampsController } from './RampsController.js';
 /**
  * Executes a request with caching, deduplication, and at most one in-flight
  * request per resource type.
@@ -289,6 +289,8 @@ export type RampsControllerGetQuotesAction = {
  * If an order with the same internal order code 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.
+ * Unchanged syncable payloads (including unchanged poll results) are ignored
+ * so `lastUpdatedAt` is not bumped and User Storage is not rewritten.
  *
  * @param order - The RampsOrder to add or update.
  */
@@ -305,6 +307,19 @@ export type RampsControllerRemoveOrderAction = {
     type: `RampsController:removeOrder`;
     handler: RampsController['removeOrder'];
 };
+/**
+ * Bidirectionally syncs V2 ramps orders with User Storage.
+ * Hosts should call this on unlock / when ramps syncing is enabled.
+ *
+ * Overlapping calls are coalesced into the in-flight worker. After the worker
+ * settles, this method loops when `#orderSyncQueued` is still set so a
+ * request that arrived between the worker's last loop check and promise
+ * resolution is not dropped.
+ */
+export type RampsControllerSyncOrdersWithUserStorageAction = {
+    type: `RampsController:syncOrdersWithUserStorage`;
+    handler: RampsController['syncOrdersWithUserStorage'];
+};
 /**
  * Adds or updates a local autoramp last-seen cursor (e.g. after create).
  *
@@ -754,5 +769,5 @@ export type RampsControllerTransakGetActiveOrdersAction = {
 /**
  * Union of all RampsController action types.
  */
-export type RampsControllerMethodActions = RampsControllerExecuteRequestAction | RampsControllerAbortRequestAction | RampsControllerGetRequestStateAction | RampsControllerSetUserRegionAction | RampsControllerSetSelectedProviderAction | RampsControllerSetSelectedProviderForAssetAction | RampsControllerInitAction | RampsControllerGetCountriesAction | RampsControllerGetTokensAction | RampsControllerSetSelectedTokenAction | RampsControllerGetProvidersAction | RampsControllerGetPaymentMethodsAction | RampsControllerGetPaymentMethodsForContextAction | RampsControllerSetSelectedPaymentMethodAction | RampsControllerGetQuotesAction | RampsControllerAddOrderAction | RampsControllerRemoveOrderAction | RampsControllerAddAutorampAction | RampsControllerCreateAutorampAction | RampsControllerRegisterMoneyAccountWalletAction | RampsControllerRemoveAutorampAction | RampsControllerMarkAutorampAsNotifiedAction | RampsControllerApplyAutorampStatusFromPushAction | RampsControllerRefreshAutorampAction | RampsControllerRefreshAutorampsAction | RampsControllerStartOrderPollingAction | RampsControllerStopOrderPollingAction | RampsControllerGetBuyWidgetDataAction | RampsControllerAddPrecreatedOrderAction | RampsControllerGetOrderAction | RampsControllerGetOrderFromCallbackAction | RampsControllerTransakSetApiKeyAction | RampsControllerTransakSetAccessTokenAction | RampsControllerTransakClearAccessTokenAction | RampsControllerTransakSetAuthenticatedAction | RampsControllerTransakResetStateAction | RampsControllerTransakSendUserOtpAction | RampsControllerTransakVerifyUserOtpAction | RampsControllerTransakLogoutAction | RampsControllerTransakGetUserDetailsAction | RampsControllerTransakGetBuyQuoteAction | RampsControllerTransakGetKycRequirementAction | RampsControllerTransakGetAdditionalRequirementsAction | RampsControllerTransakCreateOrderAction | RampsControllerTransakGetOrderAction | RampsControllerTransakGetUserLimitsAction | RampsControllerTransakRequestOttAction | RampsControllerTransakGeneratePaymentWidgetUrlAction | RampsControllerTransakCreateWidgetUrlAction | RampsControllerTransakSubmitPurposeOfUsageFormAction | RampsControllerTransakPatchUserAction | RampsControllerTransakSubmitSsnDetailsAction | RampsControllerTransakConfirmPaymentAction | RampsControllerTransakGetTranslationAction | RampsControllerTransakGetIdProofStatusAction | RampsControllerTransakCancelOrderAction | RampsControllerTransakCancelAllActiveOrdersAction | RampsControllerTransakGetActiveOrdersAction;
-//# sourceMappingURL=RampsController-method-action-types.d.mts.map
+export type RampsControllerMethodActions = RampsControllerExecuteRequestAction | RampsControllerAbortRequestAction | RampsControllerGetRequestStateAction | RampsControllerSetUserRegionAction | RampsControllerSetSelectedProviderAction | RampsControllerSetSelectedProviderForAssetAction | RampsControllerInitAction | RampsControllerGetCountriesAction | RampsControllerGetTokensAction | RampsControllerSetSelectedTokenAction | RampsControllerGetProvidersAction | RampsControllerGetPaymentMethodsAction | RampsControllerGetPaymentMethodsForContextAction | RampsControllerSetSelectedPaymentMethodAction | RampsControllerGetQuotesAction | RampsControllerAddOrderAction | RampsControllerRemoveOrderAction | RampsControllerSyncOrdersWithUserStorageAction | RampsControllerAddAutorampAction | RampsControllerCreateAutorampAction | RampsControllerRegisterMoneyAccountWalletAction | RampsControllerRemoveAutorampAction | RampsControllerMarkAutorampAsNotifiedAction | RampsControllerApplyAutorampStatusFromPushAction | RampsControllerRefreshAutorampAction | RampsControllerRefreshAutorampsAction | RampsControllerStartOrderPollingAction | RampsControllerStopOrderPollingAction | RampsControllerGetBuyWidgetDataAction | RampsControllerAddPrecreatedOrderAction | RampsControllerGetOrderAction | RampsControllerGetOrderFromCallbackAction | RampsControllerTransakSetApiKeyAction | RampsControllerTransakSetAccessTokenAction | RampsControllerTransakClearAccessTokenAction | RampsControllerTransakSetAuthenticatedAction | RampsControllerTransakResetStateAction | RampsControllerTransakSendUserOtpAction | RampsControllerTransakVerifyUserOtpAction | RampsControllerTransakLogoutAction | RampsControllerTransakGetUserDetailsAction | RampsControllerTransakGetBuyQuoteAction | RampsControllerTransakGetKycRequirementAction | RampsControllerTransakGetAdditionalRequirementsAction | RampsControllerTransakCreateOrderAction | RampsControllerTransakGetOrderAction | RampsControllerTransakGetUserLimitsAction | RampsControllerTransakRequestOttAction | RampsControllerTransakGeneratePaymentWidgetUrlAction | RampsControllerTransakCreateWidgetUrlAction | RampsControllerTransakSubmitPurposeOfUsageFormAction | RampsControllerTransakPatchUserAction | RampsControllerTransakSubmitSsnDetailsAction | RampsControllerTransakConfirmPaymentAction | RampsControllerTransakGetTranslationAction | RampsControllerTransakGetIdProofStatusAction | RampsControllerTransakCancelOrderAction | RampsControllerTransakCancelAllActiveOrdersAction | RampsControllerTransakGetActiveOrdersAction;
+//# sourceMappingURL=RampsController-method-action-types.d.ts.map