@metamask/ramps-controller 20.2.0 → 21.0.0

package/CHANGELOG.md

@@ -7,6 +7,33 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [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
+
+- Add `NeoBankService` for MetaMask Ramp API neo-bank-proxy endpoints under the `/neobank` prefix on the Ramp API host, including messenger actions for `getAutoramp`, `registerPixAddress`, `getAutorampQuote`, `createAutoramp`, `getAutorampQuoteForAutoramp`, `attachAutorampQuote`, `getCustomerByExternalId`, `getMoonpayCustomerId`, `getWalletRegistrationStatus`, and `registerSelfHostedWallet`. Mutating POSTs do not retry (to avoid duplicate Pix/autoramp creates without a stable `Idempotency-Key`); GETs still retry 429/5xx/network errors. Optional `Idempotency-Key` is forwarded when callers supply one. Also exports `mapNeoBankAutorampToRemoteSnapshot`, `AutorampRemoteSnapshot`, and wallet-registration HTTP types (`WalletRegistrationError`, `RegistrationStatus`, `RegistrationOutcome`). ([#10031](https://github.com/MetaMask/core/pull/10031))
+- Add `RampsController` autoramp last-seen cursor and Money Account wallet registration: persisted `autoramps` state, `createAutoramp` / `refreshAutoramp(s)` / `applyAutorampStatusFromPush`, `registerMoneyAccountWallet`, and `RampsController:autorampStatusChanged`. MoonPay remains the source of truth; hosts should call `refreshAutoramps` on resume to catch webhooks missed while the app was closed. Hosts must delegate `RAMPS_CONTROLLER_REQUIRED_CONTROLLER_ACTIONS` (`AuthenticationController:getSessionProfile`, `KeyringController:signPersonalMessage`, `RemoteFeatureFlagController:getState`) plus the NeoBank actions listed in `RAMPS_CONTROLLER_REQUIRED_SERVICE_ACTIONS`. ([#10032](https://github.com/MetaMask/core/pull/10032))
+
+### Changed
+
+- Bump `@metamask/remote-feature-flag-controller` from `^6.1.0` to `^6.1.1` ([#10129](https://github.com/MetaMask/core/pull/10129))
+- Bump `@metamask/profile-sync-controller` from `^29.0.0` to `^30.0.0` ([#10139](https://github.com/MetaMask/core/pull/10139))
+
 ## [20.2.0]
 
 ### Added
@@ -546,7 +573,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.2.0...HEAD
+[Unreleased]: https://github.com/MetaMask/core/compare/@metamask/ramps-controller@21.0.0...HEAD
+[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
 [20.0.0]: https://github.com/MetaMask/core/compare/@metamask/ramps-controller@19.0.0...@metamask/ramps-controller@20.0.0

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

@@ -0,0 +1,126 @@
+/**
+ * This file is auto generated.
+ * Do not edit manually.
+ */
+import type { NeoBankService } from './NeoBankService.js';
+/**
+ * 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.
+ */
+export type NeoBankServiceGetAutorampAction = {
+    type: `NeoBankService:getAutoramp`;
+    handler: NeoBankService['getAutoramp'];
+};
+/**
+ * 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.
+ */
+export type NeoBankServiceRegisterPixAddressAction = {
+    type: `NeoBankService:registerPixAddress`;
+    handler: NeoBankService['registerPixAddress'];
+};
+/**
+ * Fetches an autoramp quote via neobank-proxy `GET /neobank/autoramps/quote`.
+ *
+ * @param query - Quote query params (forwarded as-is).
+ * @returns Parsed proxy JSON response.
+ */
+export type NeoBankServiceGetAutorampQuoteAction = {
+    type: `NeoBankService:getAutorampQuote`;
+    handler: NeoBankService['getAutorampQuote'];
+};
+/**
+ * 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.
+ */
+export type NeoBankServiceCreateAutorampAction = {
+    type: `NeoBankService:createAutoramp`;
+    handler: NeoBankService['createAutoramp'];
+};
+/**
+ * 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.
+ */
+export type NeoBankServiceGetAutorampQuoteForAutorampAction = {
+    type: `NeoBankService:getAutorampQuoteForAutoramp`;
+    handler: NeoBankService['getAutorampQuoteForAutoramp'];
+};
+/**
+ * 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.
+ */
+export type NeoBankServiceAttachAutorampQuoteAction = {
+    type: `NeoBankService:attachAutorampQuote`;
+    handler: NeoBankService['attachAutorampQuote'];
+};
+/**
+ * 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.
+ */
+export type NeoBankServiceGetCustomerByExternalIdAction = {
+    type: `NeoBankService:getCustomerByExternalId`;
+    handler: NeoBankService['getCustomerByExternalId'];
+};
+/**
+ * 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.
+ */
+export type NeoBankServiceGetMoonpayCustomerIdAction = {
+    type: `NeoBankService:getMoonpayCustomerId`;
+    handler: NeoBankService['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.
+ */
+export type NeoBankServiceGetWalletRegistrationStatusAction = {
+    type: `NeoBankService:getWalletRegistrationStatus`;
+    handler: NeoBankService['getWalletRegistrationStatus'];
+};
+/**
+ * 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.
+ */
+export type NeoBankServiceRegisterSelfHostedWalletAction = {
+    type: `NeoBankService:registerSelfHostedWallet`;
+    handler: NeoBankService['registerSelfHostedWallet'];
+};
+/**
+ * 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.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/{TransakService-method-action-types.mjs → NeoBankService-method-action-types.js}

@@ -3,4 +3,4 @@
  * Do not edit manually.
  */
 export {};
-//# sourceMappingURL=TransakService-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.ts

@@ -0,0 +1,191 @@
+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.
+ */
+export declare const serviceName = "NeoBankService";
+/**
+ * Raw autoramp payload from the MetaMask Ramp API neo-bank proxy.
+ * Shape mirrors MoonPay Enterprise `GET /api/autoramps/{autoramp_id}`.
+ * The Ramp API handles partner auth / headers; the client only sends the
+ * MetaMask bearer token.
+ */
+export type NeoBankAutorampResponse = {
+    id: string;
+    customer_id?: string;
+    status: string;
+    /**
+     * Destination wallet when present on the proxy response.
+     * Field name may evolve with the Ramp API contract.
+     */
+    wallet_address?: string;
+    recipient_account?: {
+        address?: string;
+    };
+    deposit_rails?: unknown[];
+};
+/**
+ * Optional headers for neo-bank mutating requests.
+ */
+export type NeoBankRequestOptions = {
+    /**
+     * Forwarded as `Idempotency-Key` when set (MoonPay requires it on some POSTs;
+     * neobank-proxy generates one when omitted).
+     */
+    idempotencyKey?: string;
+};
+/**
+ * Query string values accepted by neo-bank GET helpers.
+ */
+export type NeoBankQueryParams = Record<string, string | number | boolean | undefined | null>;
+export type GetWalletRegistrationStatusParams = {
+    customerId: string;
+    address: string;
+};
+export type RegisterSelfHostedWalletParams = {
+    customerId: string;
+    address: string;
+    message: string;
+    signature: string;
+    /**
+     * Forwarded as `Idempotency-Key` on the neobank-proxy POST. Prefer a stable
+     * key across retries of the same ownership body.
+     */
+    idempotencyKey?: string;
+};
+/**
+ * Actions that {@link NeoBankService} exposes to other consumers.
+ */
+export type NeoBankServiceActions = NeoBankServiceMethodActions;
+type AllowedActions = AuthenticationController.AuthenticationControllerGetBearerTokenAction | AuthenticationController.AuthenticationControllerGetSessionProfileAction;
+export type NeoBankServiceEvents = never;
+type AllowedEvents = never;
+/**
+ * The messenger restricted to actions and events accessed by
+ * {@link NeoBankService}.
+ */
+export type NeoBankServiceMessenger = Messenger<typeof serviceName, NeoBankServiceActions | AllowedActions, NeoBankServiceEvents | AllowedEvents>;
+/**
+ * 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 declare function mapNeoBankAutorampToRemoteSnapshot(response: NeoBankAutorampResponse): AutorampRemoteSnapshot;
+/**
+ * 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 declare class NeoBankService {
+    #private;
+    readonly name: typeof serviceName;
+    constructor({ messenger, environment, context, fetch: fetchFunction, policyOptions, baseUrlOverride, }: {
+        messenger: NeoBankServiceMessenger;
+        environment?: RampsEnvironment;
+        context: string;
+        fetch: typeof fetch;
+        policyOptions?: CreateServicePolicyOptions;
+        baseUrlOverride?: string;
+    });
+    /**
+     * 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.
+     */
+    getAutoramp(autorampId: string): Promise<AutorampRemoteSnapshot>;
+    /**
+     * 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.
+     */
+    registerPixAddress(body: Record<string, unknown>, options?: NeoBankRequestOptions): Promise<unknown>;
+    /**
+     * Fetches an autoramp quote via neobank-proxy `GET /neobank/autoramps/quote`.
+     *
+     * @param query - Quote query params (forwarded as-is).
+     * @returns Parsed proxy JSON response.
+     */
+    getAutorampQuote(query?: NeoBankQueryParams): Promise<unknown>;
+    /**
+     * 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.
+     */
+    createAutoramp(body: Record<string, unknown>, options?: NeoBankRequestOptions): Promise<AutorampRemoteSnapshot>;
+    /**
+     * 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.
+     */
+    getAutorampQuoteForAutoramp(autorampId: string, query?: NeoBankQueryParams): Promise<unknown>;
+    /**
+     * 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.
+     */
+    attachAutorampQuote(autorampId: string, body: Record<string, unknown>, options?: NeoBankRequestOptions): Promise<unknown>;
+    /**
+     * 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.
+     */
+    getCustomerByExternalId(externalId: string): Promise<unknown>;
+    /**
+     * 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.
+     */
+    getMoonpayCustomerId(): Promise<string>;
+    /**
+     * 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.
+     */
+    getWalletRegistrationStatus({ customerId, address, }: GetWalletRegistrationStatusParams): Promise<RegistrationStatus>;
+    /**
+     * 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.
+     */
+    registerSelfHostedWallet(params: RegisterSelfHostedWalletParams): Promise<RegistrationOutcome>;
+    onRetry(listener: Parameters<ServicePolicy['onRetry']>[0]): ReturnType<ServicePolicy['onRetry']>;
+    onBreak(listener: Parameters<ServicePolicy['onBreak']>[0]): ReturnType<ServicePolicy['onBreak']>;
+    onDegraded(listener: Parameters<ServicePolicy['onDegraded']>[0]): ReturnType<ServicePolicy['onDegraded']>;
+}
+export {};
+//# 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":"AAAA,OAAO,KAAK,EACV,0BAA0B,EAC1B,aAAa,EACd,MAAM,4BAA4B,CAAC;AAMpC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAGlF,OAAO,KAAK,EAEV,sBAAsB,EACvB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yCAAyC,CAAC;AAC3F,OAAO,EAAqB,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAExE,OAAO,KAAK,EACV,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,kCAAkC,CAAC;AAE1C;;GAEG;AACH,eAAO,MAAM,WAAW,mBAAmB,CAAC;AAuB5C;;;;;GAKG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC,EAAE,EAAE,MAAM,CAAC;IAEX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IAEH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,iBAAiB,CAAC,EAAE;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IAEF,aAAa,CAAC,EAAE,OAAO,EAAE,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,CACrC,MAAM,EACN,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,IAAI,CAC7C,CAAC;AAEF,MAAM,MAAM,iCAAiC,GAAG;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAeF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,2BAA2B,CAAC;AAEhE,KAAK,cAAc,GACf,wBAAwB,CAAC,4CAA4C,GACrE,wBAAwB,CAAC,+CAA+C,CAAC;AAE7E,MAAM,MAAM,oBAAoB,GAAG,KAAK,CAAC;AAEzC,KAAK,aAAa,GAAG,KAAK,CAAC;AAE3B;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG,SAAS,CAC7C,OAAO,WAAW,EAClB,qBAAqB,GAAG,cAAc,EACtC,oBAAoB,GAAG,aAAa,CACrC,CAAC;AAqCF;;;;;GAKG;AACH,wBAAgB,kCAAkC,CAChD,QAAQ,EAAE,uBAAuB,GAChC,sBAAsB,CAsBxB;AAED;;;;;;;;GAQG;AACH,qBAAa,cAAc;;IACzB,QAAQ,CAAC,IAAI,EAAE,OAAO,WAAW,CAAC;IAkBlC,YAAY,EACV,SAAS,EACT,WAAsC,EACtC,OAAO,EACP,KAAK,EAAE,aAAa,EACpB,aAAkB,EAClB,eAAe,GAChB,EAAE;QACD,SAAS,EAAE,uBAAuB,CAAC;QACnC,WAAW,CAAC,EAAE,gBAAgB,CAAC;QAC/B,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,OAAO,KAAK,CAAC;QACpB,aAAa,CAAC,EAAE,0BAA0B,CAAC;QAC3C,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,EAqBA;IAiID;;;;;;;OAOG;IACG,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAKrE;IAED;;;;;;;OAOG;IACG,kBAAkB,CACtB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,OAAO,CAAC,CAElB;IAED;;;;;OAKG;IACG,gBAAgB,CAAC,KAAK,GAAE,kBAAuB,GAAG,OAAO,CAAC,OAAO,CAAC,CAEvE;IAED;;;;;;;OAOG;IACG,cAAc,CAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,sBAAsB,CAAC,CAOjC;IAED;;;;;;;OAOG;IACG,2BAA2B,CAC/B,UAAU,EAAE,MAAM,EAClB,KAAK,GAAE,kBAAuB,GAC7B,OAAO,CAAC,OAAO,CAAC,CAKlB;IAED;;;;;;;;OAQG;IACG,mBAAmB,CACvB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,OAAO,CAAC,CAMlB;IAED;;;;;;OAMG;IACG,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAIlE;IAED;;;;;OAKG;IACG,oBAAoB,IAAI,OAAO,CAAC,MAAM,CAAC,CAE5C;IAED;;;;;;;;OAQG;IACG,2BAA2B,CAAC,EAChC,UAAU,EACV,OAAO,GACR,EAAE,iCAAiC,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAMjE;IAED;;;;;;OAMG;IACG,wBAAwB,CAC5B,MAAM,EAAE,8BAA8B,GACrC,OAAO,CAAC,mBAAmB,CAAC,CAK9B;IAyBD,OAAO,CACL,QAAQ,EAAE,UAAU,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,GAChD,UAAU,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAEtC;IAED,OAAO,CACL,QAAQ,EAAE,UAAU,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,GAChD,UAAU,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAEtC;IAED,UAAU,CACR,QAAQ,EAAE,UAAU,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,GACnD,UAAU,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CAEzC;CACF"}