@metamask-previews/chomp-api-service 6.0.1-preview-63902891a → 6.0.1-preview-a0d99e051

package/CHANGELOG.md

@@ -9,8 +9,27 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
+- Add `getDerivedIdentities` method, also expose it through the messenger as `ChompApiService:getDerivedIdentities` ([#10695](https://github.com/MetaMask/core/pull/10695))
+- Add `getDerivedIdentityByAddress` method, and expose it through the messenger as `ChompApiService:getDerivedIdentityByAddress` ([#10695](https://github.com/MetaMask/core/pull/10695))
+- Add `disassociateAddress` method for `DELETE /v1/auth/address`, and expose it through the messenger as `ChompApiService:disassociateAddress` ([#10695](https://github.com/MetaMask/core/pull/10695))
+  - For an address linked as a successor, this cancels the Money Account migration and unfreezes its predecessor, which CHOMP only allows while the migration is not `DONE`.
+- Add `AddressIdentityResponse`, `DerivedIdentitiesResponse`, `DerivedIdentity`, `DerivedIdentityAddressRole`, `DerivedIdentityMigration`, `DerivedIdentityStatus`, `MigrationStep`, `ChompApiServiceDisassociateAddressAction`, `ChompApiServiceGetDerivedIdentitiesAction`, and `ChompApiServiceGetDerivedIdentityByAddressAction` types ([#10695](https://github.com/MetaMask/core/pull/10695))
+- Add `createAddressChallenge` method for `POST /v2/auth/address/challenge`, and expose it through the messenger as `ChompApiService:createAddressChallenge` ([#10687](https://github.com/MetaMask/core/pull/10687))
+  - Returns a single-use SIWE message bound to the profile, chain, purpose and address. The `ASSOCIATE_SUCCESSOR` purpose takes a `predecessorAddress` to link the address as the successor of an existing Money Account.
+- Add `associateAddressV2` method for `POST /v2/auth/address`, and expose it through the messenger as `ChompApiService:associateAddressV2` ([#10687](https://github.com/MetaMask/core/pull/10687))
+  - Submits the signed challenge message to associate the address.
+- Add `ChompApiError`, thrown for non-2xx responses, which exposes the CHOMP error code from the response body as `code` ([#10687](https://github.com/MetaMask/core/pull/10687))
+- Add `AssociationPurpose`, `CreateAddressChallengeParams`, `CreateAddressChallengeResponse`, `AssociateAddressV2Params`, `ChompApiServiceCreateAddressChallengeAction`, and `ChompApiServiceAssociateAddressV2Action` types ([#10687](https://github.com/MetaMask/core/pull/10687))
 - Add support for Node.js 26 ([#10981](https://github.com/MetaMask/core/pull/10981))
 
+### Changed
+
+- **BREAKING:** Widen `ChompIntentType` (used by `SendIntentParams`, intent responses, and service-details `intentTypes`) to include `cash-migration-root` and `cash-migration-transfer` ([#10695](https://github.com/MetaMask/core/pull/10695))
+
+### Removed
+
+- **BREAKING:** Remove the `associateAddress` method and `ChompApiService:associateAddress` messenger action (`POST /v1/auth/address`), along with the `AssociateAddressParams` and `ChompApiServiceAssociateAddressAction` types ([#10687](https://github.com/MetaMask/core/pull/10687))
+
 ## [6.0.1]
 
 ### Changed

package/dist/chomp-api-service-method-action-types.d.ts

@@ -4,20 +4,57 @@
  */
 import type { ChompApiService } from './chomp-api-service.js';
 /**
- * Associates an address with a CHOMP profile.
+ * Requests a single-use challenge for associating an address through the v2
+ * flow. Sign the returned `message` exactly as received, using
+ * `personal_sign` with the address being associated, then submit it with
+ * {@link ChompApiService.associateAddressV2} before `expiresAt`. Requesting
+ * a new challenge for the same address replaces the previous one.
  *
- * POST /v1/auth/address
+ * POST /v2/auth/address/challenge
  *
- * @param params - The association params containing signature, timestamp,
- * and address.
- * @returns The profile association result: `status: 'created'` for a new
- * association, `status: 'active'` when the address was already associated
- * with the authenticated profile. Throws on 409, which indicates the
- * address is associated with a different profile.
+ * Each call issues a new challenge, so the result is never cached.
+ *
+ * @param params - The address to associate and the association purpose.
+ * `ASSOCIATE_SUCCESSOR` also requires the predecessor address.
+ * @returns The challenge ID, the message to sign, and when it expires.
+ */
+export type ChompApiServiceCreateAddressChallengeAction = {
+    type: `ChompApiService:createAddressChallenge`;
+    handler: ChompApiService['createAddressChallenge'];
+};
+/**
+ * Associates an address with a CHOMP profile by submitting the signature of
+ * a challenge from {@link ChompApiService.createAddressChallenge}. The
+ * address, purpose and predecessor come from the challenge. For
+ * `ASSOCIATE_SUCCESSOR`, the association and the link to the predecessor
+ * are written atomically.
+ *
+ * POST /v2/auth/address
+ *
+ * @param params - The challenge ID and its signature.
+ * @returns The profile association result: `status: 'created'` when the
+ * association or link was written, `status: 'active'` when the address was
+ * already associated with the authenticated profile. Throws on 400
+ * `CHALLENGE_INVALID_OR_EXPIRED` (request a new challenge), on 409 when the
+ * address is associated with a different profile, and on link validation
+ * errors.
+ */
+export type ChompApiServiceAssociateAddressV2Action = {
+    type: `ChompApiService:associateAddressV2`;
+    handler: ChompApiService['associateAddressV2'];
+};
+/**
+ * Removes an address association from the authenticated profile. For an
+ * address linked as a successor, this cancels the migration and unfreezes
+ * its predecessor, which is only allowed while the migration is not `DONE`.
+ *
+ * DELETE /v1/auth/address
+ *
+ * @param address - The address to disassociate.
  */
-export type ChompApiServiceAssociateAddressAction = {
-    type: `ChompApiService:associateAddress`;
-    handler: ChompApiService['associateAddress'];
+export type ChompApiServiceDisassociateAddressAction = {
+    type: `ChompApiService:disassociateAddress`;
+    handler: ChompApiService['disassociateAddress'];
 };
 /**
  * Fetches the addresses associated with the authenticated profile.
@@ -99,7 +136,8 @@ export type ChompApiServiceCreateIntentsAction = {
  * is always fetched fresh (`staleTime: 0`).
  *
  * @param address - The address to look up intents for.
- * @returns The array of intents for the address.
+ * @returns The array of intents for the address, omitting any with an
+ * intent type this service does not recognise.
  */
 export type ChompApiServiceGetIntentsByAddressAction = {
     type: `ChompApiService:getIntentsByAddress`;
@@ -132,8 +170,42 @@ export type ChompApiServiceGetServiceDetailsAction = {
     type: `ChompApiService:getServiceDetails`;
     handler: ChompApiService['getServiceDetails'];
 };
+/**
+ * Fetches the Money Account identities of the authenticated profile, with
+ * the status and migration steps CHOMP derives on every read.
+ *
+ * GET /v1/money-account/identities
+ *
+ * Profile-scoped and used to drive migrations, so it is always fetched
+ * fresh and keyed by a digest of the bearer token, like
+ * {@link ChompApiService.getAssociatedAddresses}.
+ *
+ * @returns The identities; empty when the profile has no Money Account.
+ * Addresses are lowercased.
+ */
+export type ChompApiServiceGetDerivedIdentitiesAction = {
+    type: `ChompApiService:getDerivedIdentities`;
+    handler: ChompApiService['getDerivedIdentities'];
+};
+/**
+ * Fetches the identity containing an address, along with where the address
+ * sits in it. The identity's `status` describes the whole chain.
+ *
+ * GET /v1/money-account/identities/address/:address
+ *
+ * Always fetched fresh and keyed by a digest of the bearer token, like
+ * {@link ChompApiService.getDerivedIdentities}.
+ *
+ * @param address - The address to look up.
+ * @returns The identity and address details, or `null` when the address is
+ * not associated with the authenticated profile. Addresses are lowercased.
+ */
+export type ChompApiServiceGetDerivedIdentityByAddressAction = {
+    type: `ChompApiService:getDerivedIdentityByAddress`;
+    handler: ChompApiService['getDerivedIdentityByAddress'];
+};
 /**
  * Union of all ChompApiService action types.
  */
-export type ChompApiServiceMethodActions = ChompApiServiceAssociateAddressAction | ChompApiServiceGetAssociatedAddressesAction | ChompApiServiceCreateUpgradeAction | ChompApiServiceGetUpgradesAction | ChompApiServiceVerifyDelegationAction | ChompApiServiceCreateIntentsAction | ChompApiServiceGetIntentsByAddressAction | ChompApiServiceCreateWithdrawalAction | ChompApiServiceGetServiceDetailsAction;
+export type ChompApiServiceMethodActions = ChompApiServiceCreateAddressChallengeAction | ChompApiServiceAssociateAddressV2Action | ChompApiServiceDisassociateAddressAction | ChompApiServiceGetAssociatedAddressesAction | ChompApiServiceCreateUpgradeAction | ChompApiServiceGetUpgradesAction | ChompApiServiceVerifyDelegationAction | ChompApiServiceCreateIntentsAction | ChompApiServiceGetIntentsByAddressAction | ChompApiServiceCreateWithdrawalAction | ChompApiServiceGetServiceDetailsAction | ChompApiServiceGetDerivedIdentitiesAction | ChompApiServiceGetDerivedIdentityByAddressAction;
 //# sourceMappingURL=chomp-api-service-method-action-types.d.ts.map

package/dist/chomp-api-service-method-action-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chomp-api-service-method-action-types.d.ts","sourceRoot":"","sources":["../src/chomp-api-service-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,qCAAqC,GAAG;IAClD,IAAI,EAAE,kCAAkC,CAAC;IACzC,OAAO,EAAE,eAAe,CAAC,kBAAkB,CAAC,CAAC;CAC9C,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,2CAA2C,GAAG;IACxD,IAAI,EAAE,wCAAwC,CAAC;IAC/C,OAAO,EAAE,eAAe,CAAC,wBAAwB,CAAC,CAAC;CACpD,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,kCAAkC,GAAG;IAC/C,IAAI,EAAE,+BAA+B,CAAC;IACtC,OAAO,EAAE,eAAe,CAAC,eAAe,CAAC,CAAC;CAC3C,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,gCAAgC,GAAG;IAC7C,IAAI,EAAE,6BAA6B,CAAC;IACpC,OAAO,EAAE,eAAe,CAAC,aAAa,CAAC,CAAC;CACzC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,qCAAqC,GAAG;IAClD,IAAI,EAAE,kCAAkC,CAAC;IACzC,OAAO,EAAE,eAAe,CAAC,kBAAkB,CAAC,CAAC;CAC9C,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,kCAAkC,GAAG;IAC/C,IAAI,EAAE,+BAA+B,CAAC;IACtC,OAAO,EAAE,eAAe,CAAC,eAAe,CAAC,CAAC;CAC3C,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,MAAM,wCAAwC,GAAG;IACrD,IAAI,EAAE,qCAAqC,CAAC;IAC5C,OAAO,EAAE,eAAe,CAAC,qBAAqB,CAAC,CAAC;CACjD,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,qCAAqC,GAAG;IAClD,IAAI,EAAE,kCAAkC,CAAC;IACzC,OAAO,EAAE,eAAe,CAAC,kBAAkB,CAAC,CAAC;CAC9C,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,MAAM,sCAAsC,GAAG;IACnD,IAAI,EAAE,mCAAmC,CAAC;IAC1C,OAAO,EAAE,eAAe,CAAC,mBAAmB,CAAC,CAAC;CAC/C,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,4BAA4B,GACpC,qCAAqC,GACrC,2CAA2C,GAC3C,kCAAkC,GAClC,gCAAgC,GAChC,qCAAqC,GACrC,kCAAkC,GAClC,wCAAwC,GACxC,qCAAqC,GACrC,sCAAsC,CAAC"}
+{"version":3,"file":"chomp-api-service-method-action-types.d.ts","sourceRoot":"","sources":["../src/chomp-api-service-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,2CAA2C,GAAG;IACxD,IAAI,EAAE,wCAAwC,CAAC;IAC/C,OAAO,EAAE,eAAe,CAAC,wBAAwB,CAAC,CAAC;CACpD,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,uCAAuC,GAAG;IACpD,IAAI,EAAE,oCAAoC,CAAC;IAC3C,OAAO,EAAE,eAAe,CAAC,oBAAoB,CAAC,CAAC;CAChD,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,wCAAwC,GAAG;IACrD,IAAI,EAAE,qCAAqC,CAAC;IAC5C,OAAO,EAAE,eAAe,CAAC,qBAAqB,CAAC,CAAC;CACjD,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,2CAA2C,GAAG;IACxD,IAAI,EAAE,wCAAwC,CAAC;IAC/C,OAAO,EAAE,eAAe,CAAC,wBAAwB,CAAC,CAAC;CACpD,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,kCAAkC,GAAG;IAC/C,IAAI,EAAE,+BAA+B,CAAC;IACtC,OAAO,EAAE,eAAe,CAAC,eAAe,CAAC,CAAC;CAC3C,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,gCAAgC,GAAG;IAC7C,IAAI,EAAE,6BAA6B,CAAC;IACpC,OAAO,EAAE,eAAe,CAAC,aAAa,CAAC,CAAC;CACzC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,qCAAqC,GAAG;IAClD,IAAI,EAAE,kCAAkC,CAAC;IACzC,OAAO,EAAE,eAAe,CAAC,kBAAkB,CAAC,CAAC;CAC9C,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,kCAAkC,GAAG;IAC/C,IAAI,EAAE,+BAA+B,CAAC;IACtC,OAAO,EAAE,eAAe,CAAC,eAAe,CAAC,CAAC;CAC3C,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,wCAAwC,GAAG;IACrD,IAAI,EAAE,qCAAqC,CAAC;IAC5C,OAAO,EAAE,eAAe,CAAC,qBAAqB,CAAC,CAAC;CACjD,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,qCAAqC,GAAG;IAClD,IAAI,EAAE,kCAAkC,CAAC;IACzC,OAAO,EAAE,eAAe,CAAC,kBAAkB,CAAC,CAAC;CAC9C,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,MAAM,sCAAsC,GAAG;IACnD,IAAI,EAAE,mCAAmC,CAAC;IAC1C,OAAO,EAAE,eAAe,CAAC,mBAAmB,CAAC,CAAC;CAC/C,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,yCAAyC,GAAG;IACtD,IAAI,EAAE,sCAAsC,CAAC;IAC7C,OAAO,EAAE,eAAe,CAAC,sBAAsB,CAAC,CAAC;CAClD,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,gDAAgD,GAAG;IAC7D,IAAI,EAAE,6CAA6C,CAAC;IACpD,OAAO,EAAE,eAAe,CAAC,6BAA6B,CAAC,CAAC;CACzD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,4BAA4B,GACpC,2CAA2C,GAC3C,uCAAuC,GACvC,wCAAwC,GACxC,2CAA2C,GAC3C,kCAAkC,GAClC,gCAAgC,GAChC,qCAAqC,GACrC,kCAAkC,GAClC,wCAAwC,GACxC,qCAAqC,GACrC,sCAAsC,GACtC,yCAAyC,GACzC,gDAAgD,CAAC"}

package/dist/chomp-api-service-method-action-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"chomp-api-service-method-action-types.js","sourceRoot":"","sources":["../src/chomp-api-service-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated.\n * Do not edit manually.\n */\n\nimport type { ChompApiService } from './chomp-api-service.js';\n\n/**\n * Associates an address with a CHOMP profile.\n *\n * POST /v1/auth/address\n *\n * @param params - The association params containing signature, timestamp,\n * and address.\n * @returns The profile association result: `status: 'created'` for a new\n * association, `status: 'active'` when the address was already associated\n * with the authenticated profile. Throws on 409, which indicates the\n * address is associated with a different profile.\n */\nexport type ChompApiServiceAssociateAddressAction = {\n  type: `ChompApiService:associateAddress`;\n  handler: ChompApiService['associateAddress'];\n};\n\n/**\n * Fetches the addresses associated with the authenticated profile.\n *\n * GET /v1/auth/address\n *\n * The result is scoped to the authenticated profile and consumers use it\n * to decide whether an association already exists, so it is always fetched\n * fresh (`staleTime: 0`) and evicted as soon as the call settles\n * (`gcTime: 0`). The query key carries a SHA-256 digest of the bearer\n * token — the same token the request is made with — so concurrent calls\n * only share an in-flight request when they are for the same profile. The\n * digest, not the token, is used because query keys leave the service via\n * the `cacheUpdated` messenger events.\n *\n * @returns The active address associations; empty array if none exist.\n * Addresses are lowercased.\n */\nexport type ChompApiServiceGetAssociatedAddressesAction = {\n  type: `ChompApiService:getAssociatedAddresses`;\n  handler: ChompApiService['getAssociatedAddresses'];\n};\n\n/**\n * Creates an account upgrade request.\n *\n * POST /v1/account-upgrade\n *\n * @param params - The upgrade params containing signature components and\n * chain details.\n * @returns The upgrade result.\n */\nexport type ChompApiServiceCreateUpgradeAction = {\n  type: `ChompApiService:createUpgrade`;\n  handler: ChompApiService['createUpgrade'];\n};\n\n/**\n * Fetches all EIP-7702 upgrade authorizations for a given address (one per\n * chain).\n *\n * GET /v1/account-upgrade/:address\n *\n * @param address - The address to look up.\n * @returns The upgrade entries; empty array if none exist.\n */\nexport type ChompApiServiceGetUpgradesAction = {\n  type: `ChompApiService:getUpgrades`;\n  handler: ChompApiService['getUpgrades'];\n};\n\n/**\n * Verifies a delegation signature.\n *\n * POST /v1/intent/verify-delegation\n *\n * @param params - The delegation verification params.\n * @returns The verification result including validity and optional errors.\n */\nexport type ChompApiServiceVerifyDelegationAction = {\n  type: `ChompApiService:verifyDelegation`;\n  handler: ChompApiService['verifyDelegation'];\n};\n\n/**\n * Submits one or more intents to the CHOMP API.\n *\n * POST /v1/intent\n *\n * @param intents - The array of intents to submit.\n * @returns The array of intent responses.\n */\nexport type ChompApiServiceCreateIntentsAction = {\n  type: `ChompApiService:createIntents`;\n  handler: ChompApiService['createIntents'];\n};\n\n/**\n * Fetches intents associated with a given address.\n *\n * GET /v1/intent/account/:address\n *\n * Callers use the result to decide whether an intent already exists, so it\n * is always fetched fresh (`staleTime: 0`).\n *\n * @param address - The address to look up intents for.\n * @returns The array of intents for the address.\n */\nexport type ChompApiServiceGetIntentsByAddressAction = {\n  type: `ChompApiService:getIntentsByAddress`;\n  handler: ChompApiService['getIntentsByAddress'];\n};\n\n/**\n * Creates a withdrawal for card spend flows.\n *\n * POST /v1/withdrawal\n *\n * @param params - The withdrawal params containing chainId, amount\n * (decimal or hex string), and account address.\n * @returns The withdrawal result.\n */\nexport type ChompApiServiceCreateWithdrawalAction = {\n  type: `ChompApiService:createWithdrawal`;\n  handler: ChompApiService['createWithdrawal'];\n};\n\n/**\n * Retrieves service details including delegation redeemer addresses and DeFi\n * contract details for signing delegations for auto-deposit functionality.\n *\n * GET /v1/chomp\n *\n * @param chainIds - Array of chain IDs (0x-prefixed hex strings) to retrieve\n * details for.\n * @returns The service details for the requested chains.\n */\nexport type ChompApiServiceGetServiceDetailsAction = {\n  type: `ChompApiService:getServiceDetails`;\n  handler: ChompApiService['getServiceDetails'];\n};\n\n/**\n * Union of all ChompApiService action types.\n */\nexport type ChompApiServiceMethodActions =\n  | ChompApiServiceAssociateAddressAction\n  | ChompApiServiceGetAssociatedAddressesAction\n  | ChompApiServiceCreateUpgradeAction\n  | ChompApiServiceGetUpgradesAction\n  | ChompApiServiceVerifyDelegationAction\n  | ChompApiServiceCreateIntentsAction\n  | ChompApiServiceGetIntentsByAddressAction\n  | ChompApiServiceCreateWithdrawalAction\n  | ChompApiServiceGetServiceDetailsAction;\n"]}
+{"version":3,"file":"chomp-api-service-method-action-types.js","sourceRoot":"","sources":["../src/chomp-api-service-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated.\n * Do not edit manually.\n */\n\nimport type { ChompApiService } from './chomp-api-service.js';\n\n/**\n * Requests a single-use challenge for associating an address through the v2\n * flow. Sign the returned `message` exactly as received, using\n * `personal_sign` with the address being associated, then submit it with\n * {@link ChompApiService.associateAddressV2} before `expiresAt`. Requesting\n * a new challenge for the same address replaces the previous one.\n *\n * POST /v2/auth/address/challenge\n *\n * Each call issues a new challenge, so the result is never cached.\n *\n * @param params - The address to associate and the association purpose.\n * `ASSOCIATE_SUCCESSOR` also requires the predecessor address.\n * @returns The challenge ID, the message to sign, and when it expires.\n */\nexport type ChompApiServiceCreateAddressChallengeAction = {\n  type: `ChompApiService:createAddressChallenge`;\n  handler: ChompApiService['createAddressChallenge'];\n};\n\n/**\n * Associates an address with a CHOMP profile by submitting the signature of\n * a challenge from {@link ChompApiService.createAddressChallenge}. The\n * address, purpose and predecessor come from the challenge. For\n * `ASSOCIATE_SUCCESSOR`, the association and the link to the predecessor\n * are written atomically.\n *\n * POST /v2/auth/address\n *\n * @param params - The challenge ID and its signature.\n * @returns The profile association result: `status: 'created'` when the\n * association or link was written, `status: 'active'` when the address was\n * already associated with the authenticated profile. Throws on 400\n * `CHALLENGE_INVALID_OR_EXPIRED` (request a new challenge), on 409 when the\n * address is associated with a different profile, and on link validation\n * errors.\n */\nexport type ChompApiServiceAssociateAddressV2Action = {\n  type: `ChompApiService:associateAddressV2`;\n  handler: ChompApiService['associateAddressV2'];\n};\n\n/**\n * Removes an address association from the authenticated profile. For an\n * address linked as a successor, this cancels the migration and unfreezes\n * its predecessor, which is only allowed while the migration is not `DONE`.\n *\n * DELETE /v1/auth/address\n *\n * @param address - The address to disassociate.\n */\nexport type ChompApiServiceDisassociateAddressAction = {\n  type: `ChompApiService:disassociateAddress`;\n  handler: ChompApiService['disassociateAddress'];\n};\n\n/**\n * Fetches the addresses associated with the authenticated profile.\n *\n * GET /v1/auth/address\n *\n * The result is scoped to the authenticated profile and consumers use it\n * to decide whether an association already exists, so it is always fetched\n * fresh (`staleTime: 0`) and evicted as soon as the call settles\n * (`gcTime: 0`). The query key carries a SHA-256 digest of the bearer\n * token — the same token the request is made with — so concurrent calls\n * only share an in-flight request when they are for the same profile. The\n * digest, not the token, is used because query keys leave the service via\n * the `cacheUpdated` messenger events.\n *\n * @returns The active address associations; empty array if none exist.\n * Addresses are lowercased.\n */\nexport type ChompApiServiceGetAssociatedAddressesAction = {\n  type: `ChompApiService:getAssociatedAddresses`;\n  handler: ChompApiService['getAssociatedAddresses'];\n};\n\n/**\n * Creates an account upgrade request.\n *\n * POST /v1/account-upgrade\n *\n * @param params - The upgrade params containing signature components and\n * chain details.\n * @returns The upgrade result.\n */\nexport type ChompApiServiceCreateUpgradeAction = {\n  type: `ChompApiService:createUpgrade`;\n  handler: ChompApiService['createUpgrade'];\n};\n\n/**\n * Fetches all EIP-7702 upgrade authorizations for a given address (one per\n * chain).\n *\n * GET /v1/account-upgrade/:address\n *\n * @param address - The address to look up.\n * @returns The upgrade entries; empty array if none exist.\n */\nexport type ChompApiServiceGetUpgradesAction = {\n  type: `ChompApiService:getUpgrades`;\n  handler: ChompApiService['getUpgrades'];\n};\n\n/**\n * Verifies a delegation signature.\n *\n * POST /v1/intent/verify-delegation\n *\n * @param params - The delegation verification params.\n * @returns The verification result including validity and optional errors.\n */\nexport type ChompApiServiceVerifyDelegationAction = {\n  type: `ChompApiService:verifyDelegation`;\n  handler: ChompApiService['verifyDelegation'];\n};\n\n/**\n * Submits one or more intents to the CHOMP API.\n *\n * POST /v1/intent\n *\n * @param intents - The array of intents to submit.\n * @returns The array of intent responses.\n */\nexport type ChompApiServiceCreateIntentsAction = {\n  type: `ChompApiService:createIntents`;\n  handler: ChompApiService['createIntents'];\n};\n\n/**\n * Fetches intents associated with a given address.\n *\n * GET /v1/intent/account/:address\n *\n * Callers use the result to decide whether an intent already exists, so it\n * is always fetched fresh (`staleTime: 0`).\n *\n * @param address - The address to look up intents for.\n * @returns The array of intents for the address, omitting any with an\n * intent type this service does not recognise.\n */\nexport type ChompApiServiceGetIntentsByAddressAction = {\n  type: `ChompApiService:getIntentsByAddress`;\n  handler: ChompApiService['getIntentsByAddress'];\n};\n\n/**\n * Creates a withdrawal for card spend flows.\n *\n * POST /v1/withdrawal\n *\n * @param params - The withdrawal params containing chainId, amount\n * (decimal or hex string), and account address.\n * @returns The withdrawal result.\n */\nexport type ChompApiServiceCreateWithdrawalAction = {\n  type: `ChompApiService:createWithdrawal`;\n  handler: ChompApiService['createWithdrawal'];\n};\n\n/**\n * Retrieves service details including delegation redeemer addresses and DeFi\n * contract details for signing delegations for auto-deposit functionality.\n *\n * GET /v1/chomp\n *\n * @param chainIds - Array of chain IDs (0x-prefixed hex strings) to retrieve\n * details for.\n * @returns The service details for the requested chains.\n */\nexport type ChompApiServiceGetServiceDetailsAction = {\n  type: `ChompApiService:getServiceDetails`;\n  handler: ChompApiService['getServiceDetails'];\n};\n\n/**\n * Fetches the Money Account identities of the authenticated profile, with\n * the status and migration steps CHOMP derives on every read.\n *\n * GET /v1/money-account/identities\n *\n * Profile-scoped and used to drive migrations, so it is always fetched\n * fresh and keyed by a digest of the bearer token, like\n * {@link ChompApiService.getAssociatedAddresses}.\n *\n * @returns The identities; empty when the profile has no Money Account.\n * Addresses are lowercased.\n */\nexport type ChompApiServiceGetDerivedIdentitiesAction = {\n  type: `ChompApiService:getDerivedIdentities`;\n  handler: ChompApiService['getDerivedIdentities'];\n};\n\n/**\n * Fetches the identity containing an address, along with where the address\n * sits in it. The identity's `status` describes the whole chain.\n *\n * GET /v1/money-account/identities/address/:address\n *\n * Always fetched fresh and keyed by a digest of the bearer token, like\n * {@link ChompApiService.getDerivedIdentities}.\n *\n * @param address - The address to look up.\n * @returns The identity and address details, or `null` when the address is\n * not associated with the authenticated profile. Addresses are lowercased.\n */\nexport type ChompApiServiceGetDerivedIdentityByAddressAction = {\n  type: `ChompApiService:getDerivedIdentityByAddress`;\n  handler: ChompApiService['getDerivedIdentityByAddress'];\n};\n\n/**\n * Union of all ChompApiService action types.\n */\nexport type ChompApiServiceMethodActions =\n  | ChompApiServiceCreateAddressChallengeAction\n  | ChompApiServiceAssociateAddressV2Action\n  | ChompApiServiceDisassociateAddressAction\n  | ChompApiServiceGetAssociatedAddressesAction\n  | ChompApiServiceCreateUpgradeAction\n  | ChompApiServiceGetUpgradesAction\n  | ChompApiServiceVerifyDelegationAction\n  | ChompApiServiceCreateIntentsAction\n  | ChompApiServiceGetIntentsByAddressAction\n  | ChompApiServiceCreateWithdrawalAction\n  | ChompApiServiceGetServiceDetailsAction\n  | ChompApiServiceGetDerivedIdentitiesAction\n  | ChompApiServiceGetDerivedIdentityByAddressAction;\n"]}

package/dist/chomp-api-service.d.ts

@@ -1,16 +1,35 @@
 import { BaseDataService } from '@metamask/base-data-service';
 import type { DataServiceCacheUpdatedEvent, DataServiceGranularCacheUpdatedEvent, DataServiceInvalidateQueriesAction } from '@metamask/base-data-service';
 import type { CreateServicePolicyOptions } from '@metamask/controller-utils';
+import { HttpError } from '@metamask/controller-utils';
 import type { Messenger } from '@metamask/messenger';
 import type { Hex } from '@metamask/utils';
 import type { QueryClientConfig } from '@tanstack/query-core';
 import type { ChompApiServiceMethodActions } from './chomp-api-service-method-action-types.js';
-import type { AssociateAddressParams, AssociateAddressResponse, ProfileAddressEntry, CreateUpgradeParams, CreateUpgradeResponse, UpgradeEntry, CreateWithdrawalParams, CreateWithdrawalResponse, IntentEntry, SendIntentParams, SendIntentResponse, ServiceDetailsResponse, VerifyDelegationParams, VerifyDelegationResponse } from './types.js';
+import type { AddressIdentityResponse, AssociateAddressResponse, AssociateAddressV2Params, CreateAddressChallengeParams, CreateAddressChallengeResponse, ProfileAddressEntry, CreateUpgradeParams, CreateUpgradeResponse, UpgradeEntry, CreateWithdrawalParams, CreateWithdrawalResponse, DerivedIdentitiesResponse, IntentEntry, SendIntentParams, SendIntentResponse, ServiceDetailsResponse, VerifyDelegationParams, VerifyDelegationResponse } from './types.js';
 /**
  * The name of the {@link ChompApiService}, used to namespace the service's
  * actions and events.
  */
 export declare const serviceName = "ChompApiService";
+/**
+ * Thrown when the CHOMP API responds with a non-2xx status.
+ */
+export declare class ChompApiError extends HttpError {
+    /**
+     * The CHOMP error code from the response body (e.g.
+     * `PREDECESSOR_HAS_OPEN_WITHDRAWALS`), if one was provided.
+     */
+    readonly code: string | undefined;
+    /**
+     * Construct a CHOMP API error.
+     *
+     * @param status - The HTTP response status.
+     * @param message - The error message.
+     * @param code - The CHOMP error code from the response body.
+     */
+    constructor(status: number, message: string, code?: string);
+}
 /**
  * Invalidates cached queries for {@link ChompApiService}.
  */
@@ -72,18 +91,49 @@ export declare class ChompApiService extends BaseDataService<typeof serviceName,
         policyOptions?: CreateServicePolicyOptions;
     });
     /**
-     * Associates an address with a CHOMP profile.
+     * Requests a single-use challenge for associating an address through the v2
+     * flow. Sign the returned `message` exactly as received, using
+     * `personal_sign` with the address being associated, then submit it with
+     * {@link ChompApiService.associateAddressV2} before `expiresAt`. Requesting
+     * a new challenge for the same address replaces the previous one.
      *
-     * POST /v1/auth/address
+     * POST /v2/auth/address/challenge
      *
-     * @param params - The association params containing signature, timestamp,
-     * and address.
-     * @returns The profile association result: `status: 'created'` for a new
-     * association, `status: 'active'` when the address was already associated
-     * with the authenticated profile. Throws on 409, which indicates the
-     * address is associated with a different profile.
+     * Each call issues a new challenge, so the result is never cached.
+     *
+     * @param params - The address to associate and the association purpose.
+     * `ASSOCIATE_SUCCESSOR` also requires the predecessor address.
+     * @returns The challenge ID, the message to sign, and when it expires.
      */
-    associateAddress(params: AssociateAddressParams): Promise<AssociateAddressResponse>;
+    createAddressChallenge(params: CreateAddressChallengeParams): Promise<CreateAddressChallengeResponse>;
+    /**
+     * Associates an address with a CHOMP profile by submitting the signature of
+     * a challenge from {@link ChompApiService.createAddressChallenge}. The
+     * address, purpose and predecessor come from the challenge. For
+     * `ASSOCIATE_SUCCESSOR`, the association and the link to the predecessor
+     * are written atomically.
+     *
+     * POST /v2/auth/address
+     *
+     * @param params - The challenge ID and its signature.
+     * @returns The profile association result: `status: 'created'` when the
+     * association or link was written, `status: 'active'` when the address was
+     * already associated with the authenticated profile. Throws on 400
+     * `CHALLENGE_INVALID_OR_EXPIRED` (request a new challenge), on 409 when the
+     * address is associated with a different profile, and on link validation
+     * errors.
+     */
+    associateAddressV2(params: AssociateAddressV2Params): Promise<AssociateAddressResponse>;
+    /**
+     * Removes an address association from the authenticated profile. For an
+     * address linked as a successor, this cancels the migration and unfreezes
+     * its predecessor, which is only allowed while the migration is not `DONE`.
+     *
+     * DELETE /v1/auth/address
+     *
+     * @param address - The address to disassociate.
+     */
+    disassociateAddress(address: Hex): Promise<void>;
     /**
      * Fetches the addresses associated with the authenticated profile.
      *
@@ -174,6 +224,34 @@ export declare class ChompApiService extends BaseDataService<typeof serviceName,
      * @returns The service details for the requested chains.
      */
     getServiceDetails(chainIds: Hex[]): Promise<ServiceDetailsResponse>;
+    /**
+     * Fetches the Money Account identities of the authenticated profile, with
+     * the status and migration steps CHOMP derives on every read.
+     *
+     * GET /v1/money-account/identities
+     *
+     * Profile-scoped and used to drive migrations, so it is always fetched
+     * fresh and keyed by a digest of the bearer token, like
+     * {@link ChompApiService.getAssociatedAddresses}.
+     *
+     * @returns The identities; empty when the profile has no Money Account.
+     * Addresses are lowercased.
+     */
+    getDerivedIdentities(): Promise<DerivedIdentitiesResponse>;
+    /**
+     * Fetches the identity containing an address, along with where the address
+     * sits in it. The identity's `status` describes the whole chain.
+     *
+     * GET /v1/money-account/identities/address/:address
+     *
+     * Always fetched fresh and keyed by a digest of the bearer token, like
+     * {@link ChompApiService.getDerivedIdentities}.
+     *
+     * @param address - The address to look up.
+     * @returns The identity and address details, or `null` when the address is
+     * not associated with the authenticated profile. Addresses are lowercased.
+     */
+    getDerivedIdentityByAddress(address: Hex): Promise<AddressIdentityResponse | null>;
 }
 export {};
 //# sourceMappingURL=chomp-api-service.d.ts.map

package/dist/chomp-api-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chomp-api-service.d.ts","sourceRoot":"","sources":["../src/chomp-api-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EACV,4BAA4B,EAC5B,oCAAoC,EACpC,kCAAkC,EACnC,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAE7E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAcrD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAO3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,4CAA4C,CAAC;AAC/F,OAAO,KAAK,EACV,sBAAsB,EACtB,wBAAwB,EACxB,mBAAmB,EAEnB,mBAAmB,EACnB,qBAAqB,EACrB,YAAY,EACZ,sBAAsB,EACtB,wBAAwB,EACxB,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAClB,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,EACzB,MAAM,YAAY,CAAC;AAgBpB;;;GAGG;AACH,eAAO,MAAM,WAAW,oBAAoB,CAAC;AAoB7C;;GAEG;AACH,MAAM,MAAM,sCAAsC,GAChD,kCAAkC,CAAC,OAAO,WAAW,CAAC,CAAC;AAEzD;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAC9B,4BAA4B,GAC5B,sCAAsC,CAAC;AAE3C;;GAEG;AACH,KAAK,cAAc,GAAG;IACpB,IAAI,EAAE,yCAAyC,CAAC;IAChD,OAAO,EAAE,CAAC,eAAe,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACxD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gCAAgC,GAAG,4BAA4B,CACzE,OAAO,WAAW,CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,wCAAwC,GAClD,oCAAoC,CAAC,OAAO,WAAW,CAAC,CAAC;AAE3D;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAC7B,gCAAgC,GAChC,wCAAwC,CAAC;AAE7C;;GAEG;AACH,KAAK,aAAa,GAAG,KAAK,CAAC;AAE3B;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG,SAAS,CAC9C,OAAO,WAAW,EAClB,sBAAsB,GAAG,cAAc,EACvC,qBAAqB,GAAG,aAAa,CACtC,CAAC;AA+JF;;;;;GAKG;AACH,qBAAa,eAAgB,SAAQ,eAAe,CAClD,OAAO,WAAW,EAClB,wBAAwB,CACzB;;IAGC;;;;;;;;;OASG;IACH,YAAY,EACV,SAAS,EACT,OAAO,EACP,iBAAsB,EACtB,aAAkB,GACnB,EAAE;QACD,SAAS,EAAE,wBAAwB,CAAC;QACpC,OAAO,EAAE,MAAM,CAAC;QAChB,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;QACtC,aAAa,CAAC,EAAE,0BAA0B,CAAC;KAC5C,EAcA;IA4BD;;;;;;;;;;;OAWG;IACG,gBAAgB,CACpB,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAAC,wBAAwB,CAAC,CA2BnC;IAED;;;;;;;;;;;;;;;;OAgBG;IACG,sBAAsB,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC,CA4B7D;IAED;;;;;;;;OAQG;IACG,aAAa,CACjB,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,qBAAqB,CAAC,CA2BhC;IAED;;;;;;;;OAQG;IACG,WAAW,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAsBvD;IAED;;;;;;;OAOG;IACG,gBAAgB,CACpB,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAAC,wBAAwB,CAAC,CA2BnC;IAED;;;;;;;OAOG;IACG,aAAa,CACjB,OAAO,EAAE,gBAAgB,EAAE,GAC1B,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAwB/B;IAED;;;;;;;;;;;OAWG;IACG,mBAAmB,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CA0B9D;IAED;;;;;;;;OAQG;IACG,gBAAgB,CACpB,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAAC,wBAAwB,CAAC,CAwBnC;IAED;;;;;;;;;OASG;IACG,iBAAiB,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAqBxE;CACF"}
+{"version":3,"file":"chomp-api-service.d.ts","sourceRoot":"","sources":["../src/chomp-api-service.ts"],"names":[],"mappings":"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"}

package/dist/chomp-api-service.js

@@ -1,13 +1,25 @@
 import { BaseDataService } from '@metamask/base-data-service';
 import { handleWhen, HttpError } from '@metamask/controller-utils';
-import { array, boolean, coerce, create, enums, literal, number, optional, record, string, type, } from '@metamask/superstruct';
-import { bytesToHex, sha256, stringToBytes, StrictHexStruct, } from '@metamask/utils';
+import { array, boolean, coerce, create, enums, literal, nullable, number, optional, record, string, type, } from '@metamask/superstruct';
+import { bytesToHex, hasProperty, isObject, sha256, stringToBytes, StrictHexStruct, } from '@metamask/utils';
 const CHOMP_INTENT_TYPES = [
     'cash-deposit',
     'cash-withdrawal',
     'cash-deposit-premium',
     'cash-withdrawal-premium',
     'cash-subscription',
+    'cash-migration-root',
+    'cash-migration-transfer',
+];
+const MIGRATION_STEPS = [
+    'SUCCESSOR_DEPOSIT_INTENT',
+    'SUCCESSOR_WITHDRAWAL_INTENT',
+    'SUCCESSOR_SUBSCRIPTION_INTENT',
+    'SUCCESSOR_MONITORED',
+    'ROOT_DELEGATION',
+    'TRANSFER_INTENT_MUSD',
+    'TRANSFER_INTENT_VMUSD',
+    'TRANSFER_INTENT_PVMUSD',
 ];
 function isChompIntentType(value) {
     return CHOMP_INTENT_TYPES.includes(value);
@@ -18,13 +30,53 @@ function isChompIntentType(value) {
  * actions and events.
  */
 export const serviceName = 'ChompApiService';
+// === ERRORS ===
+/**
+ * Thrown when the CHOMP API responds with a non-2xx status.
+ */
+export class ChompApiError extends HttpError {
+    /**
+     * The CHOMP error code from the response body (e.g.
+     * `PREDECESSOR_HAS_OPEN_WITHDRAWALS`), if one was provided.
+     */
+    code;
+    /**
+     * Construct a CHOMP API error.
+     *
+     * @param status - The HTTP response status.
+     * @param message - The error message.
+     * @param code - The CHOMP error code from the response body.
+     */
+    constructor(status, message, code) {
+        super(status, message);
+        this.name = 'ChompApiError';
+        this.code = code;
+    }
+}
+/**
+ * Builds a {@link ChompApiError} from a non-2xx response, reading the CHOMP
+ * error code from the response body when there is one.
+ *
+ * @param response - The non-2xx response.
+ * @param message - The error message.
+ * @returns The error to throw.
+ */
+async function createChompApiError(response, message) {
+    const body = await response.json().catch(() => undefined);
+    const code = isObject(body) && hasProperty(body, 'code') && typeof body.code === 'string'
+        ? body.code
+        : undefined;
+    return new ChompApiError(response.status, message, code);
+}
 // === MESSENGER ===
 /**
  * All of the methods within {@link ChompApiService} that are exposed via the
  * messenger.
  */
 const MESSENGER_EXPOSED_METHODS = [
-    'associateAddress',
+    'createAddressChallenge',
+    'associateAddressV2',
+    'disassociateAddress',
     'getAssociatedAddresses',
     'createUpgrade',
     'getUpgrades',
@@ -33,6 +85,8 @@ const MESSENGER_EXPOSED_METHODS = [
     'getIntentsByAddress',
     'createWithdrawal',
     'getServiceDetails',
+    'getDerivedIdentities',
+    'getDerivedIdentityByAddress',
 ];
 // === RESPONSE VALIDATION ===
 const AssociateAddressResponseStruct = type({
@@ -40,6 +94,11 @@ const AssociateAddressResponseStruct = type({
     address: StrictHexStruct,
     status: enums(['active', 'created']),
 });
+const CreateAddressChallengeResponseStruct = type({
+    challengeId: string(),
+    message: string(),
+    expiresAt: string(),
+});
 /**
  * Parses addresses into canonical lowercase form. CHOMP stores and returns
  * addresses lowercased, but `StrictHexStruct` alone accepts any casing, so
@@ -52,6 +111,31 @@ const ProfileAddressEntryArrayStruct = array(type({
     address: LowercaseHexAddressStruct,
     status: enums(['active']),
 }));
+const MigrationStepArrayStruct = array(enums(MIGRATION_STEPS));
+const DerivedIdentityStruct = type({
+    currentAddress: LowercaseHexAddressStruct,
+    previousAddresses: array(LowercaseHexAddressStruct),
+    status: enums(['NONE', 'MIGRATING', 'DONE']),
+    migration: nullable(type({
+        from: LowercaseHexAddressStruct,
+        to: LowercaseHexAddressStruct,
+        requiredSteps: MigrationStepArrayStruct,
+        completedSteps: MigrationStepArrayStruct,
+        missingSteps: MigrationStepArrayStruct,
+    })),
+});
+const DerivedIdentitiesResponseStruct = type({
+    identities: array(DerivedIdentityStruct),
+});
+const AddressIdentityResponseStruct = type({
+    identity: DerivedIdentityStruct,
+    address: type({
+        address: LowercaseHexAddressStruct,
+        role: enums(['CURRENT', 'PREVIOUS', 'PENDING_SUCCESSOR']),
+        predecessor: nullable(LowercaseHexAddressStruct),
+        successor: nullable(LowercaseHexAddressStruct),
+    }),
+});
 const AccountUpgradeStatusStruct = enums(['pending', 'upgraded']);
 const AuthorizationDataStruct = type({
     r: StrictHexStruct,
@@ -195,6 +279,21 @@ export class ChompApiService extends BaseDataService {
             'Content-Type': 'application/json',
         };
     }
+    /**
+     * Fetches the bearer token along with a SHA-256 digest of it, for query
+     * keys of profile-scoped requests. The digest, not the token, goes in the
+     * key because query keys leave the service via the `cacheUpdated`
+     * messenger events.
+     *
+     * @returns The bearer token and its digest.
+     */
+    async #getProfileScopedToken() {
+        const token = await this.messenger.call('AuthenticationController:getBearerToken');
+        return {
+            token,
+            profileKey: bytesToHex(await sha256(stringToBytes(token))),
+        };
+    }
     /**
      * Builds the standard headers for an authenticated CHOMP API request.
      *
@@ -205,36 +304,105 @@ export class ChompApiService extends BaseDataService {
         return this.#headersForToken(token);
     }
     /**
-     * Associates an address with a CHOMP profile.
+     * Requests a single-use challenge for associating an address through the v2
+     * flow. Sign the returned `message` exactly as received, using
+     * `personal_sign` with the address being associated, then submit it with
+     * {@link ChompApiService.associateAddressV2} before `expiresAt`. Requesting
+     * a new challenge for the same address replaces the previous one.
      *
-     * POST /v1/auth/address
+     * POST /v2/auth/address/challenge
      *
-     * @param params - The association params containing signature, timestamp,
-     * and address.
-     * @returns The profile association result: `status: 'created'` for a new
-     * association, `status: 'active'` when the address was already associated
-     * with the authenticated profile. Throws on 409, which indicates the
-     * address is associated with a different profile.
+     * Each call issues a new challenge, so the result is never cached.
+     *
+     * @param params - The address to associate and the association purpose.
+     * `ASSOCIATE_SUCCESSOR` also requires the predecessor address.
+     * @returns The challenge ID, the message to sign, and when it expires.
      */
-    async associateAddress(params) {
+    async createAddressChallenge(params) {
         const jsonResponse = await this.fetchQuery({
-            queryKey: [`${this.name}:associateAddress`, params],
+            queryKey: [`${this.name}:createAddressChallenge`, params],
             staleTime: 0,
+            gcTime: 0,
             queryFn: async () => {
                 const headers = await this.#authHeaders();
-                const response = await fetch(new URL('/v1/auth/address', this.#baseUrl), {
+                const response = await fetch(new URL('/v2/auth/address/challenge', this.#baseUrl), {
                     method: 'POST',
                     headers,
                     body: JSON.stringify(params),
                 });
                 if (!response.ok) {
-                    throw new HttpError(response.status, `POST /v1/auth/address failed with status '${response.status}'`);
+                    throw await createChompApiError(response, `POST /v2/auth/address/challenge failed with status '${response.status}'`);
+                }
+                return response.json();
+            },
+        });
+        return create(jsonResponse, CreateAddressChallengeResponseStruct);
+    }
+    /**
+     * Associates an address with a CHOMP profile by submitting the signature of
+     * a challenge from {@link ChompApiService.createAddressChallenge}. The
+     * address, purpose and predecessor come from the challenge. For
+     * `ASSOCIATE_SUCCESSOR`, the association and the link to the predecessor
+     * are written atomically.
+     *
+     * POST /v2/auth/address
+     *
+     * @param params - The challenge ID and its signature.
+     * @returns The profile association result: `status: 'created'` when the
+     * association or link was written, `status: 'active'` when the address was
+     * already associated with the authenticated profile. Throws on 400
+     * `CHALLENGE_INVALID_OR_EXPIRED` (request a new challenge), on 409 when the
+     * address is associated with a different profile, and on link validation
+     * errors.
+     */
+    async associateAddressV2(params) {
+        const jsonResponse = await this.fetchQuery({
+            queryKey: [`${this.name}:associateAddressV2`, params],
+            staleTime: 0,
+            gcTime: 0,
+            queryFn: async () => {
+                const headers = await this.#authHeaders();
+                const response = await fetch(new URL('/v2/auth/address', this.#baseUrl), {
+                    method: 'POST',
+                    headers,
+                    body: JSON.stringify(params),
+                });
+                if (!response.ok) {
+                    throw await createChompApiError(response, `POST /v2/auth/address failed with status '${response.status}'`);
                 }
                 return response.json();
             },
         });
         return create(jsonResponse, AssociateAddressResponseStruct);
     }
+    /**
+     * Removes an address association from the authenticated profile. For an
+     * address linked as a successor, this cancels the migration and unfreezes
+     * its predecessor, which is only allowed while the migration is not `DONE`.
+     *
+     * DELETE /v1/auth/address
+     *
+     * @param address - The address to disassociate.
+     */
+    async disassociateAddress(address) {
+        await this.fetchQuery({
+            queryKey: [`${this.name}:disassociateAddress`, address],
+            staleTime: 0,
+            gcTime: 0,
+            queryFn: async () => {
+                const headers = await this.#authHeaders();
+                const response = await fetch(new URL('/v1/auth/address', this.#baseUrl), {
+                    method: 'DELETE',
+                    headers,
+                    body: JSON.stringify({ address }),
+                });
+                if (!response.ok) {
+                    throw await createChompApiError(response, `DELETE /v1/auth/address failed with status '${response.status}'`);
+                }
+                return null;
+            },
+        });
+    }
     /**
      * Fetches the addresses associated with the authenticated profile.
      *
@@ -253,8 +421,7 @@ export class ChompApiService extends BaseDataService {
      * Addresses are lowercased.
      */
     async getAssociatedAddresses() {
-        const token = await this.messenger.call('AuthenticationController:getBearerToken');
-        const profileKey = bytesToHex(await sha256(stringToBytes(token)));
+        const { token, profileKey } = await this.#getProfileScopedToken();
         const jsonResponse = await this.fetchQuery({
             queryKey: [`${this.name}:getAssociatedAddresses`, profileKey],
             staleTime: 0,
@@ -262,7 +429,7 @@ export class ChompApiService extends BaseDataService {
             queryFn: async () => {
                 const response = await fetch(new URL('/v1/auth/address', this.#baseUrl), { headers: this.#headersForToken(token) });
                 if (!response.ok) {
-                    throw new HttpError(response.status, `GET /v1/auth/address failed with status '${response.status}'`);
+                    throw await createChompApiError(response, `GET /v1/auth/address failed with status '${response.status}'`);
                 }
                 return response.json();
             },
@@ -290,7 +457,7 @@ export class ChompApiService extends BaseDataService {
                     body: JSON.stringify(params),
                 });
                 if (!response.ok) {
-                    throw new HttpError(response.status, `POST /v1/account-upgrade failed with status '${response.status}'`);
+                    throw await createChompApiError(response, `POST /v1/account-upgrade failed with status '${response.status}'`);
                 }
                 return response.json();
             },
@@ -313,7 +480,7 @@ export class ChompApiService extends BaseDataService {
                 const headers = await this.#authHeaders();
                 const response = await fetch(new URL(`/v1/account-upgrade/${address}`, this.#baseUrl), { headers });
                 if (!response.ok) {
-                    throw new HttpError(response.status, `Get upgrades request failed with status '${response.status}'`);
+                    throw await createChompApiError(response, `Get upgrades request failed with status '${response.status}'`);
                 }
                 return response.json();
             },
@@ -340,7 +507,7 @@ export class ChompApiService extends BaseDataService {
                     body: JSON.stringify(params),
                 });
                 if (!response.ok) {
-                    throw new HttpError(response.status, `POST /v1/intent/verify-delegation failed with status '${response.status}'`);
+                    throw await createChompApiError(response, `POST /v1/intent/verify-delegation failed with status '${response.status}'`);
                 }
                 return response.json();
             },
@@ -367,7 +534,7 @@ export class ChompApiService extends BaseDataService {
                     body: JSON.stringify(intents),
                 });
                 if (!response.ok) {
-                    throw new HttpError(response.status, `POST /v1/intent failed with status '${response.status}'`);
+                    throw await createChompApiError(response, `POST /v1/intent failed with status '${response.status}'`);
                 }
                 return response.json();
             },
@@ -394,7 +561,7 @@ export class ChompApiService extends BaseDataService {
                 const headers = await this.#authHeaders();
                 const response = await fetch(new URL(`/v1/intent/account/${address}`, this.#baseUrl), { headers });
                 if (!response.ok) {
-                    throw new HttpError(response.status, `Get intents request failed with status '${response.status}'`);
+                    throw await createChompApiError(response, `Get intents request failed with status '${response.status}'`);
                 }
                 return response.json();
             },
@@ -422,7 +589,7 @@ export class ChompApiService extends BaseDataService {
                     body: JSON.stringify(params),
                 });
                 if (!response.ok) {
-                    throw new HttpError(response.status, `POST /v1/withdrawal failed with status '${response.status}'`);
+                    throw await createChompApiError(response, `POST /v1/withdrawal failed with status '${response.status}'`);
                 }
                 return response.json();
             },
@@ -448,12 +615,79 @@ export class ChompApiService extends BaseDataService {
                 url.searchParams.set('chainId', chainIds.join(','));
                 const response = await fetch(url, { headers });
                 if (!response.ok) {
-                    throw new HttpError(response.status, `GET /v1/chomp failed with status '${response.status}'`);
+                    throw await createChompApiError(response, `GET /v1/chomp failed with status '${response.status}'`);
                 }
                 return response.json();
             },
         });
         return create(jsonResponse, ServiceDetailsResponseStruct);
     }
+    /**
+     * Fetches the Money Account identities of the authenticated profile, with
+     * the status and migration steps CHOMP derives on every read.
+     *
+     * GET /v1/money-account/identities
+     *
+     * Profile-scoped and used to drive migrations, so it is always fetched
+     * fresh and keyed by a digest of the bearer token, like
+     * {@link ChompApiService.getAssociatedAddresses}.
+     *
+     * @returns The identities; empty when the profile has no Money Account.
+     * Addresses are lowercased.
+     */
+    async getDerivedIdentities() {
+        const { token, profileKey } = await this.#getProfileScopedToken();
+        const jsonResponse = await this.fetchQuery({
+            queryKey: [`${this.name}:getDerivedIdentities`, profileKey],
+            staleTime: 0,
+            gcTime: 0,
+            queryFn: async () => {
+                const response = await fetch(new URL('/v1/money-account/identities', this.#baseUrl), { headers: this.#headersForToken(token) });
+                if (!response.ok) {
+                    throw await createChompApiError(response, `GET /v1/money-account/identities failed with status '${response.status}'`);
+                }
+                return response.json();
+            },
+        });
+        return create(jsonResponse, DerivedIdentitiesResponseStruct);
+    }
+    /**
+     * Fetches the identity containing an address, along with where the address
+     * sits in it. The identity's `status` describes the whole chain.
+     *
+     * GET /v1/money-account/identities/address/:address
+     *
+     * Always fetched fresh and keyed by a digest of the bearer token, like
+     * {@link ChompApiService.getDerivedIdentities}.
+     *
+     * @param address - The address to look up.
+     * @returns The identity and address details, or `null` when the address is
+     * not associated with the authenticated profile. Addresses are lowercased.
+     */
+    async getDerivedIdentityByAddress(address) {
+        const { token, profileKey } = await this.#getProfileScopedToken();
+        const jsonResponse = await this.fetchQuery({
+            queryKey: [
+                `${this.name}:getDerivedIdentityByAddress`,
+                profileKey,
+                address,
+            ],
+            staleTime: 0,
+            gcTime: 0,
+            queryFn: async () => {
+                const response = await fetch(new URL(`/v1/money-account/identities/address/${address}`, this.#baseUrl), { headers: this.#headersForToken(token) });
+                if (response.status === 404) {
+                    return null;
+                }
+                if (!response.ok) {
+                    throw await createChompApiError(response, `GET /v1/money-account/identities/address/${address} failed with status '${response.status}'`);
+                }
+                return response.json();
+            },
+        });
+        return jsonResponse === null
+            ? null
+            : create(jsonResponse, AddressIdentityResponseStruct);
+    }
 }
 //# sourceMappingURL=chomp-api-service.js.map

package/dist/chomp-api-service.js.map

@@ -1 +1 @@
-{"version":3,"file":"chomp-api-service.js","sourceRoot":"","sources":["../src/chomp-api-service.ts"],"names":[],"mappings":"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","sourcesContent":["import { BaseDataService } from '@metamask/base-data-service';\nimport type {\n  DataServiceCacheUpdatedEvent,\n  DataServiceGranularCacheUpdatedEvent,\n  DataServiceInvalidateQueriesAction,\n} from '@metamask/base-data-service';\nimport type { CreateServicePolicyOptions } from '@metamask/controller-utils';\nimport { handleWhen, HttpError } from '@metamask/controller-utils';\nimport type { Messenger } from '@metamask/messenger';\nimport {\n  array,\n  boolean,\n  coerce,\n  create,\n  enums,\n  literal,\n  number,\n  optional,\n  record,\n  string,\n  type,\n} from '@metamask/superstruct';\nimport type { Hex } from '@metamask/utils';\nimport {\n  bytesToHex,\n  sha256,\n  stringToBytes,\n  StrictHexStruct,\n} from '@metamask/utils';\nimport type { QueryClientConfig } from '@tanstack/query-core';\n\nimport type { ChompApiServiceMethodActions } from './chomp-api-service-method-action-types.js';\nimport type {\n  AssociateAddressParams,\n  AssociateAddressResponse,\n  ProfileAddressEntry,\n  ChompIntentType,\n  CreateUpgradeParams,\n  CreateUpgradeResponse,\n  UpgradeEntry,\n  CreateWithdrawalParams,\n  CreateWithdrawalResponse,\n  IntentEntry,\n  SendIntentParams,\n  SendIntentResponse,\n  ServiceDetailsResponse,\n  VerifyDelegationParams,\n  VerifyDelegationResponse,\n} from './types.js';\n\nconst CHOMP_INTENT_TYPES: ChompIntentType[] = [\n  'cash-deposit',\n  'cash-withdrawal',\n  'cash-deposit-premium',\n  'cash-withdrawal-premium',\n  'cash-subscription',\n];\n\nfunction isChompIntentType(value: string): value is ChompIntentType {\n  return (CHOMP_INTENT_TYPES as string[]).includes(value);\n}\n\n// === GENERAL ===\n\n/**\n * The name of the {@link ChompApiService}, used to namespace the service's\n * actions and events.\n */\nexport const serviceName = 'ChompApiService';\n\n// === MESSENGER ===\n\n/**\n * All of the methods within {@link ChompApiService} that are exposed via the\n * messenger.\n */\nconst MESSENGER_EXPOSED_METHODS = [\n  'associateAddress',\n  'getAssociatedAddresses',\n  'createUpgrade',\n  'getUpgrades',\n  'verifyDelegation',\n  'createIntents',\n  'getIntentsByAddress',\n  'createWithdrawal',\n  'getServiceDetails',\n] as const;\n\n/**\n * Invalidates cached queries for {@link ChompApiService}.\n */\nexport type ChompApiServiceInvalidateQueriesAction =\n  DataServiceInvalidateQueriesAction<typeof serviceName>;\n\n/**\n * Actions that {@link ChompApiService} exposes to other consumers.\n */\nexport type ChompApiServiceActions =\n  | ChompApiServiceMethodActions\n  | ChompApiServiceInvalidateQueriesAction;\n\n/**\n * Actions from other messengers that {@link ChompApiService} calls.\n */\ntype AllowedActions = {\n  type: 'AuthenticationController:getBearerToken';\n  handler: (entropySourceId?: string) => Promise<string>;\n};\n\n/**\n * Published when {@link ChompApiService}'s cache is updated.\n */\nexport type ChompApiServiceCacheUpdatedEvent = DataServiceCacheUpdatedEvent<\n  typeof serviceName\n>;\n\n/**\n * Published when a key within {@link ChompApiService}'s cache is updated.\n */\nexport type ChompApiServiceGranularCacheUpdatedEvent =\n  DataServiceGranularCacheUpdatedEvent<typeof serviceName>;\n\n/**\n * Events that {@link ChompApiService} exposes to other consumers.\n */\nexport type ChompApiServiceEvents =\n  | ChompApiServiceCacheUpdatedEvent\n  | ChompApiServiceGranularCacheUpdatedEvent;\n\n/**\n * Events from other messengers that {@link ChompApiService} subscribes to.\n */\ntype AllowedEvents = never;\n\n/**\n * The messenger which is restricted to actions and events accessed by\n * {@link ChompApiService}.\n */\nexport type ChompApiServiceMessenger = Messenger<\n  typeof serviceName,\n  ChompApiServiceActions | AllowedActions,\n  ChompApiServiceEvents | AllowedEvents\n>;\n\n// === RESPONSE VALIDATION ===\n\nconst AssociateAddressResponseStruct = type({\n  profileId: optional(string()),\n  address: StrictHexStruct,\n  status: enums(['active', 'created']),\n});\n\n/**\n * Parses addresses into canonical lowercase form. CHOMP stores and returns\n * addresses lowercased, but `StrictHexStruct` alone accepts any casing, so\n * this makes the canonical form a guarantee of the parsed data rather than a\n * convention consumers must each remember.\n */\nconst LowercaseHexAddressStruct = coerce(StrictHexStruct, string(), (value) =>\n  value.toLowerCase(),\n);\n\nconst ProfileAddressEntryArrayStruct = array(\n  type({\n    profileId: string(),\n    address: LowercaseHexAddressStruct,\n    status: enums(['active']),\n  }),\n);\n\nconst AccountUpgradeStatusStruct = enums(['pending', 'upgraded']);\n\nconst AuthorizationDataStruct = type({\n  r: StrictHexStruct,\n  s: StrictHexStruct,\n  v: number(),\n  yParity: number(),\n  address: StrictHexStruct,\n  chainId: StrictHexStruct,\n  nonce: StrictHexStruct,\n});\n\nconst CreateUpgradeResponseStruct = type({\n  signerAddress: StrictHexStruct,\n  address: StrictHexStruct,\n  chainId: StrictHexStruct,\n  nonce: StrictHexStruct,\n  status: AccountUpgradeStatusStruct,\n  createdAt: string(),\n});\n\nconst UpgradeEntryArrayStruct = array(\n  type({\n    signerAddress: StrictHexStruct,\n    chainId: StrictHexStruct,\n    nonce: StrictHexStruct,\n    authorization: AuthorizationDataStruct,\n    status: AccountUpgradeStatusStruct,\n    createdAt: string(),\n  }),\n);\n\nconst VerifyDelegationResponseStruct = type({\n  valid: boolean(),\n  delegationHash: optional(StrictHexStruct),\n  errors: optional(array(string())),\n});\n\nconst SendIntentResponseArrayStruct = array(\n  type({\n    delegationHash: StrictHexStruct,\n    metadata: type({\n      allowance: StrictHexStruct,\n      tokenSymbol: string(),\n      tokenAddress: StrictHexStruct,\n      type: enums(CHOMP_INTENT_TYPES),\n    }),\n    createdAt: string(),\n  }),\n);\n\nconst IntentEntryArrayStruct = array(\n  type({\n    account: StrictHexStruct,\n    delegationHash: StrictHexStruct,\n    chainId: StrictHexStruct,\n    status: enums(['active', 'revoked']),\n    metadata: type({\n      allowance: StrictHexStruct,\n      tokenAddress: StrictHexStruct,\n      tokenSymbol: string(),\n      type: string(),\n    }),\n  }),\n);\n\nconst CreateWithdrawalResponseStruct = type({\n  success: literal(true),\n});\n\nconst ServiceDetailsProtocolStruct = type({\n  supportedTokens: array(\n    type({\n      tokenAddress: StrictHexStruct,\n      tokenDecimals: number(),\n    }),\n  ),\n  adapterAddress: StrictHexStruct,\n  intentTypes: coerce(\n    array(enums(CHOMP_INTENT_TYPES)),\n    array(string()),\n    (intentTypes) => intentTypes.filter(isChompIntentType),\n  ),\n});\n\nconst ServiceDetailsResponseStruct = type({\n  auth: type({\n    message: string(),\n  }),\n  chains: record(\n    StrictHexStruct,\n    type({\n      autoDepositDelegate: StrictHexStruct,\n      protocol: type({\n        vedaProtocol: ServiceDetailsProtocolStruct,\n        vedaPremiumProtocol: optional(ServiceDetailsProtocolStruct),\n      }),\n    }),\n  ),\n});\n\n// === RETRY POLICY ===\n\n/**\n * Determines whether an error from a CHOMP API call is worth retrying.\n *\n * 4xx responses (e.g. 409 \"already exists\", 400 validation, 401/403 auth) are\n * caused by the request itself and will not be resolved by re-issuing the same\n * request, so they bypass the retry loop. 429 is treated as transient and\n * retried alongside 5xx server errors. Non-HTTP errors (network/timeout) fall\n * through to the default \"retry\" behaviour.\n *\n * @param error - The error thrown by the query function.\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\nconst DEFAULT_POLICY_OPTIONS: CreateServicePolicyOptions = {\n  retryFilterPolicy: handleWhen(isRetryableError),\n};\n\n// === SERVICE DEFINITION ===\n\n/**\n * This service is responsible for communicating with the CHOMP API.\n *\n * All requests are authenticated via JWT Bearer tokens obtained from the\n * `AuthenticationController:getBearerToken` messenger action.\n */\nexport class ChompApiService extends BaseDataService<\n  typeof serviceName,\n  ChompApiServiceMessenger\n> {\n  readonly #baseUrl: string;\n\n  /**\n   * Constructs a new ChompApiService.\n   *\n   * @param args - The constructor arguments.\n   * @param args.messenger - The messenger suited for this service.\n   * @param args.baseUrl - The base URL of the CHOMP API.\n   * @param args.queryClientConfig - Configuration for the underlying TanStack\n   * Query client.\n   * @param args.policyOptions - Options to pass to `createServicePolicy`.\n   */\n  constructor({\n    messenger,\n    baseUrl,\n    queryClientConfig = {},\n    policyOptions = {},\n  }: {\n    messenger: ChompApiServiceMessenger;\n    baseUrl: string;\n    queryClientConfig?: QueryClientConfig;\n    policyOptions?: CreateServicePolicyOptions;\n  }) {\n    super({\n      name: serviceName,\n      messenger,\n      queryClientConfig,\n      policyOptions: { ...DEFAULT_POLICY_OPTIONS, ...policyOptions },\n    });\n\n    this.#baseUrl = baseUrl;\n\n    this.messenger.registerMethodActionHandlers(\n      this,\n      MESSENGER_EXPOSED_METHODS,\n    );\n  }\n\n  /**\n   * Builds the standard headers for a CHOMP API request authenticated with\n   * the given bearer token.\n   *\n   * @param token - The bearer token to authenticate with.\n   * @returns Headers including Authorization and Content-Type.\n   */\n  #headersForToken(token: string): Record<string, string> {\n    return {\n      Authorization: `Bearer ${token}`,\n      'Content-Type': 'application/json',\n    };\n  }\n\n  /**\n   * Builds the standard headers for an authenticated CHOMP API request.\n   *\n   * @returns Headers including Authorization and Content-Type.\n   */\n  async #authHeaders(): Promise<Record<string, string>> {\n    const token = await this.messenger.call(\n      'AuthenticationController:getBearerToken',\n    );\n    return this.#headersForToken(token);\n  }\n\n  /**\n   * Associates an address with a CHOMP profile.\n   *\n   * POST /v1/auth/address\n   *\n   * @param params - The association params containing signature, timestamp,\n   * and address.\n   * @returns The profile association result: `status: 'created'` for a new\n   * association, `status: 'active'` when the address was already associated\n   * with the authenticated profile. Throws on 409, which indicates the\n   * address is associated with a different profile.\n   */\n  async associateAddress(\n    params: AssociateAddressParams,\n  ): Promise<AssociateAddressResponse> {\n    const jsonResponse = await this.fetchQuery({\n      queryKey: [`${this.name}:associateAddress`, params],\n      staleTime: 0,\n      queryFn: async () => {\n        const headers = await this.#authHeaders();\n        const response = await fetch(\n          new URL('/v1/auth/address', this.#baseUrl),\n          {\n            method: 'POST',\n            headers,\n            body: JSON.stringify(params),\n          },\n        );\n\n        if (!response.ok) {\n          throw new HttpError(\n            response.status,\n            `POST /v1/auth/address failed with status '${response.status}'`,\n          );\n        }\n\n        return response.json();\n      },\n    });\n\n    return create(jsonResponse, AssociateAddressResponseStruct);\n  }\n\n  /**\n   * Fetches the addresses associated with the authenticated profile.\n   *\n   * GET /v1/auth/address\n   *\n   * The result is scoped to the authenticated profile and consumers use it\n   * to decide whether an association already exists, so it is always fetched\n   * fresh (`staleTime: 0`) and evicted as soon as the call settles\n   * (`gcTime: 0`). The query key carries a SHA-256 digest of the bearer\n   * token — the same token the request is made with — so concurrent calls\n   * only share an in-flight request when they are for the same profile. The\n   * digest, not the token, is used because query keys leave the service via\n   * the `cacheUpdated` messenger events.\n   *\n   * @returns The active address associations; empty array if none exist.\n   * Addresses are lowercased.\n   */\n  async getAssociatedAddresses(): Promise<ProfileAddressEntry[]> {\n    const token = await this.messenger.call(\n      'AuthenticationController:getBearerToken',\n    );\n    const profileKey = bytesToHex(await sha256(stringToBytes(token)));\n\n    const jsonResponse = await this.fetchQuery({\n      queryKey: [`${this.name}:getAssociatedAddresses`, profileKey],\n      staleTime: 0,\n      gcTime: 0,\n      queryFn: async () => {\n        const response = await fetch(\n          new URL('/v1/auth/address', this.#baseUrl),\n          { headers: this.#headersForToken(token) },\n        );\n\n        if (!response.ok) {\n          throw new HttpError(\n            response.status,\n            `GET /v1/auth/address failed with status '${response.status}'`,\n          );\n        }\n\n        return response.json();\n      },\n    });\n\n    return create(jsonResponse, ProfileAddressEntryArrayStruct);\n  }\n\n  /**\n   * Creates an account upgrade request.\n   *\n   * POST /v1/account-upgrade\n   *\n   * @param params - The upgrade params containing signature components and\n   * chain details.\n   * @returns The upgrade result.\n   */\n  async createUpgrade(\n    params: CreateUpgradeParams,\n  ): Promise<CreateUpgradeResponse> {\n    const jsonResponse = await this.fetchQuery({\n      queryKey: [`${this.name}:createUpgrade`, params],\n      staleTime: 0,\n      queryFn: async () => {\n        const headers = await this.#authHeaders();\n        const response = await fetch(\n          new URL('/v1/account-upgrade', this.#baseUrl),\n          {\n            method: 'POST',\n            headers,\n            body: JSON.stringify(params),\n          },\n        );\n\n        if (!response.ok) {\n          throw new HttpError(\n            response.status,\n            `POST /v1/account-upgrade failed with status '${response.status}'`,\n          );\n        }\n\n        return response.json();\n      },\n    });\n\n    return create(jsonResponse, CreateUpgradeResponseStruct);\n  }\n\n  /**\n   * Fetches all EIP-7702 upgrade authorizations for a given address (one per\n   * chain).\n   *\n   * GET /v1/account-upgrade/:address\n   *\n   * @param address - The address to look up.\n   * @returns The upgrade entries; empty array if none exist.\n   */\n  async getUpgrades(address: Hex): Promise<UpgradeEntry[]> {\n    const jsonResponse = await this.fetchQuery({\n      queryKey: [`${this.name}:getUpgrades`, address],\n      queryFn: async () => {\n        const headers = await this.#authHeaders();\n        const response = await fetch(\n          new URL(`/v1/account-upgrade/${address}`, this.#baseUrl),\n          { headers },\n        );\n\n        if (!response.ok) {\n          throw new HttpError(\n            response.status,\n            `Get upgrades request failed with status '${response.status}'`,\n          );\n        }\n\n        return response.json();\n      },\n    });\n\n    return create(jsonResponse, UpgradeEntryArrayStruct);\n  }\n\n  /**\n   * Verifies a delegation signature.\n   *\n   * POST /v1/intent/verify-delegation\n   *\n   * @param params - The delegation verification params.\n   * @returns The verification result including validity and optional errors.\n   */\n  async verifyDelegation(\n    params: VerifyDelegationParams,\n  ): Promise<VerifyDelegationResponse> {\n    const jsonResponse = await this.fetchQuery({\n      queryKey: [`${this.name}:verifyDelegation`, params],\n      staleTime: 0,\n      queryFn: async () => {\n        const headers = await this.#authHeaders();\n        const response = await fetch(\n          new URL('/v1/intent/verify-delegation', this.#baseUrl),\n          {\n            method: 'POST',\n            headers,\n            body: JSON.stringify(params),\n          },\n        );\n\n        if (!response.ok) {\n          throw new HttpError(\n            response.status,\n            `POST /v1/intent/verify-delegation failed with status '${response.status}'`,\n          );\n        }\n\n        return response.json();\n      },\n    });\n\n    return create(jsonResponse, VerifyDelegationResponseStruct);\n  }\n\n  /**\n   * Submits one or more intents to the CHOMP API.\n   *\n   * POST /v1/intent\n   *\n   * @param intents - The array of intents to submit.\n   * @returns The array of intent responses.\n   */\n  async createIntents(\n    intents: SendIntentParams[],\n  ): Promise<SendIntentResponse[]> {\n    const jsonResponse = await this.fetchQuery({\n      queryKey: [`${this.name}:createIntents`, intents],\n      staleTime: 0,\n      queryFn: async () => {\n        const headers = await this.#authHeaders();\n        const response = await fetch(new URL('/v1/intent', this.#baseUrl), {\n          method: 'POST',\n          headers,\n          body: JSON.stringify(intents),\n        });\n\n        if (!response.ok) {\n          throw new HttpError(\n            response.status,\n            `POST /v1/intent failed with status '${response.status}'`,\n          );\n        }\n\n        return response.json();\n      },\n    });\n\n    return create(jsonResponse, SendIntentResponseArrayStruct);\n  }\n\n  /**\n   * Fetches intents associated with a given address.\n   *\n   * GET /v1/intent/account/:address\n   *\n   * Callers use the result to decide whether an intent already exists, so it\n   * is always fetched fresh (`staleTime: 0`).\n   *\n   * @param address - The address to look up intents for.\n   * @returns The array of intents for the address, omitting any with an\n   * intent type this service does not recognise.\n   */\n  async getIntentsByAddress(address: Hex): Promise<IntentEntry[]> {\n    const jsonResponse = await this.fetchQuery({\n      queryKey: [`${this.name}:getIntentsByAddress`, address],\n      staleTime: 0,\n      queryFn: async () => {\n        const headers = await this.#authHeaders();\n        const response = await fetch(\n          new URL(`/v1/intent/account/${address}`, this.#baseUrl),\n          { headers },\n        );\n\n        if (!response.ok) {\n          throw new HttpError(\n            response.status,\n            `Get intents request failed with status '${response.status}'`,\n          );\n        }\n\n        return response.json();\n      },\n    });\n\n    return create(jsonResponse, IntentEntryArrayStruct).filter(\n      (intent): intent is IntentEntry =>\n        isChompIntentType(intent.metadata.type),\n    );\n  }\n\n  /**\n   * Creates a withdrawal for card spend flows.\n   *\n   * POST /v1/withdrawal\n   *\n   * @param params - The withdrawal params containing chainId, amount\n   * (decimal or hex string), and account address.\n   * @returns The withdrawal result.\n   */\n  async createWithdrawal(\n    params: CreateWithdrawalParams,\n  ): Promise<CreateWithdrawalResponse> {\n    const jsonResponse = await this.fetchQuery({\n      queryKey: [`${this.name}:createWithdrawal`, params],\n      staleTime: 0,\n      queryFn: async () => {\n        const headers = await this.#authHeaders();\n        const response = await fetch(new URL('/v1/withdrawal', this.#baseUrl), {\n          method: 'POST',\n          headers,\n          body: JSON.stringify(params),\n        });\n\n        if (!response.ok) {\n          throw new HttpError(\n            response.status,\n            `POST /v1/withdrawal failed with status '${response.status}'`,\n          );\n        }\n\n        return response.json();\n      },\n    });\n\n    return create(jsonResponse, CreateWithdrawalResponseStruct);\n  }\n\n  /**\n   * Retrieves service details including delegation redeemer addresses and DeFi\n   * contract details for signing delegations for auto-deposit functionality.\n   *\n   * GET /v1/chomp\n   *\n   * @param chainIds - Array of chain IDs (0x-prefixed hex strings) to retrieve\n   * details for.\n   * @returns The service details for the requested chains.\n   */\n  async getServiceDetails(chainIds: Hex[]): Promise<ServiceDetailsResponse> {\n    const jsonResponse = await this.fetchQuery({\n      queryKey: [`${this.name}:getServiceDetails`, chainIds],\n      queryFn: async () => {\n        const headers = await this.#authHeaders();\n        const url = new URL('/v1/chomp', this.#baseUrl);\n        url.searchParams.set('chainId', chainIds.join(','));\n        const response = await fetch(url, { headers });\n\n        if (!response.ok) {\n          throw new HttpError(\n            response.status,\n            `GET /v1/chomp failed with status '${response.status}'`,\n          );\n        }\n\n        return response.json();\n      },\n    });\n\n    return create(jsonResponse, ServiceDetailsResponseStruct);\n  }\n}\n"]}
+{"version":3,"file":"chomp-api-service.js","sourceRoot":"","sources":["../src/chomp-api-service.ts"],"names":[],"mappings":"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","sourcesContent":["import { BaseDataService } from '@metamask/base-data-service';\nimport type {\n  DataServiceCacheUpdatedEvent,\n  DataServiceGranularCacheUpdatedEvent,\n  DataServiceInvalidateQueriesAction,\n} from '@metamask/base-data-service';\nimport type { CreateServicePolicyOptions } from '@metamask/controller-utils';\nimport { handleWhen, HttpError } from '@metamask/controller-utils';\nimport type { Messenger } from '@metamask/messenger';\nimport {\n  array,\n  boolean,\n  coerce,\n  create,\n  enums,\n  literal,\n  nullable,\n  number,\n  optional,\n  record,\n  string,\n  type,\n} from '@metamask/superstruct';\nimport type { Hex } from '@metamask/utils';\nimport {\n  bytesToHex,\n  hasProperty,\n  isObject,\n  sha256,\n  stringToBytes,\n  StrictHexStruct,\n} from '@metamask/utils';\nimport type { QueryClientConfig } from '@tanstack/query-core';\n\nimport type { ChompApiServiceMethodActions } from './chomp-api-service-method-action-types.js';\nimport type {\n  AddressIdentityResponse,\n  AssociateAddressResponse,\n  AssociateAddressV2Params,\n  CreateAddressChallengeParams,\n  CreateAddressChallengeResponse,\n  ProfileAddressEntry,\n  ChompIntentType,\n  CreateUpgradeParams,\n  CreateUpgradeResponse,\n  UpgradeEntry,\n  CreateWithdrawalParams,\n  CreateWithdrawalResponse,\n  DerivedIdentitiesResponse,\n  IntentEntry,\n  MigrationStep,\n  SendIntentParams,\n  SendIntentResponse,\n  ServiceDetailsResponse,\n  VerifyDelegationParams,\n  VerifyDelegationResponse,\n} from './types.js';\n\nconst CHOMP_INTENT_TYPES: ChompIntentType[] = [\n  'cash-deposit',\n  'cash-withdrawal',\n  'cash-deposit-premium',\n  'cash-withdrawal-premium',\n  'cash-subscription',\n  'cash-migration-root',\n  'cash-migration-transfer',\n];\n\nconst MIGRATION_STEPS: MigrationStep[] = [\n  'SUCCESSOR_DEPOSIT_INTENT',\n  'SUCCESSOR_WITHDRAWAL_INTENT',\n  'SUCCESSOR_SUBSCRIPTION_INTENT',\n  'SUCCESSOR_MONITORED',\n  'ROOT_DELEGATION',\n  'TRANSFER_INTENT_MUSD',\n  'TRANSFER_INTENT_VMUSD',\n  'TRANSFER_INTENT_PVMUSD',\n];\n\nfunction isChompIntentType(value: string): value is ChompIntentType {\n  return (CHOMP_INTENT_TYPES as string[]).includes(value);\n}\n\n// === GENERAL ===\n\n/**\n * The name of the {@link ChompApiService}, used to namespace the service's\n * actions and events.\n */\nexport const serviceName = 'ChompApiService';\n\n// === ERRORS ===\n\n/**\n * Thrown when the CHOMP API responds with a non-2xx status.\n */\nexport class ChompApiError extends HttpError {\n  /**\n   * The CHOMP error code from the response body (e.g.\n   * `PREDECESSOR_HAS_OPEN_WITHDRAWALS`), if one was provided.\n   */\n  readonly code: string | undefined;\n\n  /**\n   * Construct a CHOMP API error.\n   *\n   * @param status - The HTTP response status.\n   * @param message - The error message.\n   * @param code - The CHOMP error code from the response body.\n   */\n  constructor(status: number, message: string, code?: string) {\n    super(status, message);\n    this.name = 'ChompApiError';\n    this.code = code;\n  }\n}\n\n/**\n * Builds a {@link ChompApiError} from a non-2xx response, reading the CHOMP\n * error code from the response body when there is one.\n *\n * @param response - The non-2xx response.\n * @param message - The error message.\n * @returns The error to throw.\n */\nasync function createChompApiError(\n  response: Response,\n  message: string,\n): Promise<ChompApiError> {\n  const body: unknown = await response.json().catch(() => undefined);\n  const code =\n    isObject(body) && hasProperty(body, 'code') && typeof body.code === 'string'\n      ? body.code\n      : undefined;\n  return new ChompApiError(response.status, message, code);\n}\n\n// === MESSENGER ===\n\n/**\n * All of the methods within {@link ChompApiService} that are exposed via the\n * messenger.\n */\nconst MESSENGER_EXPOSED_METHODS = [\n  'createAddressChallenge',\n  'associateAddressV2',\n  'disassociateAddress',\n  'getAssociatedAddresses',\n  'createUpgrade',\n  'getUpgrades',\n  'verifyDelegation',\n  'createIntents',\n  'getIntentsByAddress',\n  'createWithdrawal',\n  'getServiceDetails',\n  'getDerivedIdentities',\n  'getDerivedIdentityByAddress',\n] as const;\n\n/**\n * Invalidates cached queries for {@link ChompApiService}.\n */\nexport type ChompApiServiceInvalidateQueriesAction =\n  DataServiceInvalidateQueriesAction<typeof serviceName>;\n\n/**\n * Actions that {@link ChompApiService} exposes to other consumers.\n */\nexport type ChompApiServiceActions =\n  | ChompApiServiceMethodActions\n  | ChompApiServiceInvalidateQueriesAction;\n\n/**\n * Actions from other messengers that {@link ChompApiService} calls.\n */\ntype AllowedActions = {\n  type: 'AuthenticationController:getBearerToken';\n  handler: (entropySourceId?: string) => Promise<string>;\n};\n\n/**\n * Published when {@link ChompApiService}'s cache is updated.\n */\nexport type ChompApiServiceCacheUpdatedEvent = DataServiceCacheUpdatedEvent<\n  typeof serviceName\n>;\n\n/**\n * Published when a key within {@link ChompApiService}'s cache is updated.\n */\nexport type ChompApiServiceGranularCacheUpdatedEvent =\n  DataServiceGranularCacheUpdatedEvent<typeof serviceName>;\n\n/**\n * Events that {@link ChompApiService} exposes to other consumers.\n */\nexport type ChompApiServiceEvents =\n  | ChompApiServiceCacheUpdatedEvent\n  | ChompApiServiceGranularCacheUpdatedEvent;\n\n/**\n * Events from other messengers that {@link ChompApiService} subscribes to.\n */\ntype AllowedEvents = never;\n\n/**\n * The messenger which is restricted to actions and events accessed by\n * {@link ChompApiService}.\n */\nexport type ChompApiServiceMessenger = Messenger<\n  typeof serviceName,\n  ChompApiServiceActions | AllowedActions,\n  ChompApiServiceEvents | AllowedEvents\n>;\n\n// === RESPONSE VALIDATION ===\n\nconst AssociateAddressResponseStruct = type({\n  profileId: optional(string()),\n  address: StrictHexStruct,\n  status: enums(['active', 'created']),\n});\n\nconst CreateAddressChallengeResponseStruct = type({\n  challengeId: string(),\n  message: string(),\n  expiresAt: string(),\n});\n\n/**\n * Parses addresses into canonical lowercase form. CHOMP stores and returns\n * addresses lowercased, but `StrictHexStruct` alone accepts any casing, so\n * this makes the canonical form a guarantee of the parsed data rather than a\n * convention consumers must each remember.\n */\nconst LowercaseHexAddressStruct = coerce(StrictHexStruct, string(), (value) =>\n  value.toLowerCase(),\n);\n\nconst ProfileAddressEntryArrayStruct = array(\n  type({\n    profileId: string(),\n    address: LowercaseHexAddressStruct,\n    status: enums(['active']),\n  }),\n);\n\nconst MigrationStepArrayStruct = array(enums(MIGRATION_STEPS));\n\nconst DerivedIdentityStruct = type({\n  currentAddress: LowercaseHexAddressStruct,\n  previousAddresses: array(LowercaseHexAddressStruct),\n  status: enums(['NONE', 'MIGRATING', 'DONE']),\n  migration: nullable(\n    type({\n      from: LowercaseHexAddressStruct,\n      to: LowercaseHexAddressStruct,\n      requiredSteps: MigrationStepArrayStruct,\n      completedSteps: MigrationStepArrayStruct,\n      missingSteps: MigrationStepArrayStruct,\n    }),\n  ),\n});\n\nconst DerivedIdentitiesResponseStruct = type({\n  identities: array(DerivedIdentityStruct),\n});\n\nconst AddressIdentityResponseStruct = type({\n  identity: DerivedIdentityStruct,\n  address: type({\n    address: LowercaseHexAddressStruct,\n    role: enums(['CURRENT', 'PREVIOUS', 'PENDING_SUCCESSOR']),\n    predecessor: nullable(LowercaseHexAddressStruct),\n    successor: nullable(LowercaseHexAddressStruct),\n  }),\n});\n\nconst AccountUpgradeStatusStruct = enums(['pending', 'upgraded']);\n\nconst AuthorizationDataStruct = type({\n  r: StrictHexStruct,\n  s: StrictHexStruct,\n  v: number(),\n  yParity: number(),\n  address: StrictHexStruct,\n  chainId: StrictHexStruct,\n  nonce: StrictHexStruct,\n});\n\nconst CreateUpgradeResponseStruct = type({\n  signerAddress: StrictHexStruct,\n  address: StrictHexStruct,\n  chainId: StrictHexStruct,\n  nonce: StrictHexStruct,\n  status: AccountUpgradeStatusStruct,\n  createdAt: string(),\n});\n\nconst UpgradeEntryArrayStruct = array(\n  type({\n    signerAddress: StrictHexStruct,\n    chainId: StrictHexStruct,\n    nonce: StrictHexStruct,\n    authorization: AuthorizationDataStruct,\n    status: AccountUpgradeStatusStruct,\n    createdAt: string(),\n  }),\n);\n\nconst VerifyDelegationResponseStruct = type({\n  valid: boolean(),\n  delegationHash: optional(StrictHexStruct),\n  errors: optional(array(string())),\n});\n\nconst SendIntentResponseArrayStruct = array(\n  type({\n    delegationHash: StrictHexStruct,\n    metadata: type({\n      allowance: StrictHexStruct,\n      tokenSymbol: string(),\n      tokenAddress: StrictHexStruct,\n      type: enums(CHOMP_INTENT_TYPES),\n    }),\n    createdAt: string(),\n  }),\n);\n\nconst IntentEntryArrayStruct = array(\n  type({\n    account: StrictHexStruct,\n    delegationHash: StrictHexStruct,\n    chainId: StrictHexStruct,\n    status: enums(['active', 'revoked']),\n    metadata: type({\n      allowance: StrictHexStruct,\n      tokenAddress: StrictHexStruct,\n      tokenSymbol: string(),\n      type: string(),\n    }),\n  }),\n);\n\nconst CreateWithdrawalResponseStruct = type({\n  success: literal(true),\n});\n\nconst ServiceDetailsProtocolStruct = type({\n  supportedTokens: array(\n    type({\n      tokenAddress: StrictHexStruct,\n      tokenDecimals: number(),\n    }),\n  ),\n  adapterAddress: StrictHexStruct,\n  intentTypes: coerce(\n    array(enums(CHOMP_INTENT_TYPES)),\n    array(string()),\n    (intentTypes) => intentTypes.filter(isChompIntentType),\n  ),\n});\n\nconst ServiceDetailsResponseStruct = type({\n  auth: type({\n    message: string(),\n  }),\n  chains: record(\n    StrictHexStruct,\n    type({\n      autoDepositDelegate: StrictHexStruct,\n      protocol: type({\n        vedaProtocol: ServiceDetailsProtocolStruct,\n        vedaPremiumProtocol: optional(ServiceDetailsProtocolStruct),\n      }),\n    }),\n  ),\n});\n\n// === RETRY POLICY ===\n\n/**\n * Determines whether an error from a CHOMP API call is worth retrying.\n *\n * 4xx responses (e.g. 409 \"already exists\", 400 validation, 401/403 auth) are\n * caused by the request itself and will not be resolved by re-issuing the same\n * request, so they bypass the retry loop. 429 is treated as transient and\n * retried alongside 5xx server errors. Non-HTTP errors (network/timeout) fall\n * through to the default \"retry\" behaviour.\n *\n * @param error - The error thrown by the query function.\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\nconst DEFAULT_POLICY_OPTIONS: CreateServicePolicyOptions = {\n  retryFilterPolicy: handleWhen(isRetryableError),\n};\n\n// === SERVICE DEFINITION ===\n\n/**\n * This service is responsible for communicating with the CHOMP API.\n *\n * All requests are authenticated via JWT Bearer tokens obtained from the\n * `AuthenticationController:getBearerToken` messenger action.\n */\nexport class ChompApiService extends BaseDataService<\n  typeof serviceName,\n  ChompApiServiceMessenger\n> {\n  readonly #baseUrl: string;\n\n  /**\n   * Constructs a new ChompApiService.\n   *\n   * @param args - The constructor arguments.\n   * @param args.messenger - The messenger suited for this service.\n   * @param args.baseUrl - The base URL of the CHOMP API.\n   * @param args.queryClientConfig - Configuration for the underlying TanStack\n   * Query client.\n   * @param args.policyOptions - Options to pass to `createServicePolicy`.\n   */\n  constructor({\n    messenger,\n    baseUrl,\n    queryClientConfig = {},\n    policyOptions = {},\n  }: {\n    messenger: ChompApiServiceMessenger;\n    baseUrl: string;\n    queryClientConfig?: QueryClientConfig;\n    policyOptions?: CreateServicePolicyOptions;\n  }) {\n    super({\n      name: serviceName,\n      messenger,\n      queryClientConfig,\n      policyOptions: { ...DEFAULT_POLICY_OPTIONS, ...policyOptions },\n    });\n\n    this.#baseUrl = baseUrl;\n\n    this.messenger.registerMethodActionHandlers(\n      this,\n      MESSENGER_EXPOSED_METHODS,\n    );\n  }\n\n  /**\n   * Builds the standard headers for a CHOMP API request authenticated with\n   * the given bearer token.\n   *\n   * @param token - The bearer token to authenticate with.\n   * @returns Headers including Authorization and Content-Type.\n   */\n  #headersForToken(token: string): Record<string, string> {\n    return {\n      Authorization: `Bearer ${token}`,\n      'Content-Type': 'application/json',\n    };\n  }\n\n  /**\n   * Fetches the bearer token along with a SHA-256 digest of it, for query\n   * keys of profile-scoped requests. The digest, not the token, goes in the\n   * key because query keys leave the service via the `cacheUpdated`\n   * messenger events.\n   *\n   * @returns The bearer token and its digest.\n   */\n  async #getProfileScopedToken(): Promise<{\n    token: string;\n    profileKey: Hex;\n  }> {\n    const token = await this.messenger.call(\n      'AuthenticationController:getBearerToken',\n    );\n    return {\n      token,\n      profileKey: bytesToHex(await sha256(stringToBytes(token))),\n    };\n  }\n\n  /**\n   * Builds the standard headers for an authenticated CHOMP API request.\n   *\n   * @returns Headers including Authorization and Content-Type.\n   */\n  async #authHeaders(): Promise<Record<string, string>> {\n    const token = await this.messenger.call(\n      'AuthenticationController:getBearerToken',\n    );\n    return this.#headersForToken(token);\n  }\n\n  /**\n   * Requests a single-use challenge for associating an address through the v2\n   * flow. Sign the returned `message` exactly as received, using\n   * `personal_sign` with the address being associated, then submit it with\n   * {@link ChompApiService.associateAddressV2} before `expiresAt`. Requesting\n   * a new challenge for the same address replaces the previous one.\n   *\n   * POST /v2/auth/address/challenge\n   *\n   * Each call issues a new challenge, so the result is never cached.\n   *\n   * @param params - The address to associate and the association purpose.\n   * `ASSOCIATE_SUCCESSOR` also requires the predecessor address.\n   * @returns The challenge ID, the message to sign, and when it expires.\n   */\n  async createAddressChallenge(\n    params: CreateAddressChallengeParams,\n  ): Promise<CreateAddressChallengeResponse> {\n    const jsonResponse = await this.fetchQuery({\n      queryKey: [`${this.name}:createAddressChallenge`, params],\n      staleTime: 0,\n      gcTime: 0,\n      queryFn: async () => {\n        const headers = await this.#authHeaders();\n        const response = await fetch(\n          new URL('/v2/auth/address/challenge', this.#baseUrl),\n          {\n            method: 'POST',\n            headers,\n            body: JSON.stringify(params),\n          },\n        );\n\n        if (!response.ok) {\n          throw await createChompApiError(\n            response,\n            `POST /v2/auth/address/challenge failed with status '${response.status}'`,\n          );\n        }\n\n        return response.json();\n      },\n    });\n\n    return create(jsonResponse, CreateAddressChallengeResponseStruct);\n  }\n\n  /**\n   * Associates an address with a CHOMP profile by submitting the signature of\n   * a challenge from {@link ChompApiService.createAddressChallenge}. The\n   * address, purpose and predecessor come from the challenge. For\n   * `ASSOCIATE_SUCCESSOR`, the association and the link to the predecessor\n   * are written atomically.\n   *\n   * POST /v2/auth/address\n   *\n   * @param params - The challenge ID and its signature.\n   * @returns The profile association result: `status: 'created'` when the\n   * association or link was written, `status: 'active'` when the address was\n   * already associated with the authenticated profile. Throws on 400\n   * `CHALLENGE_INVALID_OR_EXPIRED` (request a new challenge), on 409 when the\n   * address is associated with a different profile, and on link validation\n   * errors.\n   */\n  async associateAddressV2(\n    params: AssociateAddressV2Params,\n  ): Promise<AssociateAddressResponse> {\n    const jsonResponse = await this.fetchQuery({\n      queryKey: [`${this.name}:associateAddressV2`, params],\n      staleTime: 0,\n      gcTime: 0,\n      queryFn: async () => {\n        const headers = await this.#authHeaders();\n        const response = await fetch(\n          new URL('/v2/auth/address', this.#baseUrl),\n          {\n            method: 'POST',\n            headers,\n            body: JSON.stringify(params),\n          },\n        );\n\n        if (!response.ok) {\n          throw await createChompApiError(\n            response,\n            `POST /v2/auth/address failed with status '${response.status}'`,\n          );\n        }\n\n        return response.json();\n      },\n    });\n\n    return create(jsonResponse, AssociateAddressResponseStruct);\n  }\n\n  /**\n   * Removes an address association from the authenticated profile. For an\n   * address linked as a successor, this cancels the migration and unfreezes\n   * its predecessor, which is only allowed while the migration is not `DONE`.\n   *\n   * DELETE /v1/auth/address\n   *\n   * @param address - The address to disassociate.\n   */\n  async disassociateAddress(address: Hex): Promise<void> {\n    await this.fetchQuery({\n      queryKey: [`${this.name}:disassociateAddress`, address],\n      staleTime: 0,\n      gcTime: 0,\n      queryFn: async () => {\n        const headers = await this.#authHeaders();\n        const response = await fetch(\n          new URL('/v1/auth/address', this.#baseUrl),\n          {\n            method: 'DELETE',\n            headers,\n            body: JSON.stringify({ address }),\n          },\n        );\n\n        if (!response.ok) {\n          throw await createChompApiError(\n            response,\n            `DELETE /v1/auth/address failed with status '${response.status}'`,\n          );\n        }\n\n        return null;\n      },\n    });\n  }\n\n  /**\n   * Fetches the addresses associated with the authenticated profile.\n   *\n   * GET /v1/auth/address\n   *\n   * The result is scoped to the authenticated profile and consumers use it\n   * to decide whether an association already exists, so it is always fetched\n   * fresh (`staleTime: 0`) and evicted as soon as the call settles\n   * (`gcTime: 0`). The query key carries a SHA-256 digest of the bearer\n   * token — the same token the request is made with — so concurrent calls\n   * only share an in-flight request when they are for the same profile. The\n   * digest, not the token, is used because query keys leave the service via\n   * the `cacheUpdated` messenger events.\n   *\n   * @returns The active address associations; empty array if none exist.\n   * Addresses are lowercased.\n   */\n  async getAssociatedAddresses(): Promise<ProfileAddressEntry[]> {\n    const { token, profileKey } = await this.#getProfileScopedToken();\n\n    const jsonResponse = await this.fetchQuery({\n      queryKey: [`${this.name}:getAssociatedAddresses`, profileKey],\n      staleTime: 0,\n      gcTime: 0,\n      queryFn: async () => {\n        const response = await fetch(\n          new URL('/v1/auth/address', this.#baseUrl),\n          { headers: this.#headersForToken(token) },\n        );\n\n        if (!response.ok) {\n          throw await createChompApiError(\n            response,\n            `GET /v1/auth/address failed with status '${response.status}'`,\n          );\n        }\n\n        return response.json();\n      },\n    });\n\n    return create(jsonResponse, ProfileAddressEntryArrayStruct);\n  }\n\n  /**\n   * Creates an account upgrade request.\n   *\n   * POST /v1/account-upgrade\n   *\n   * @param params - The upgrade params containing signature components and\n   * chain details.\n   * @returns The upgrade result.\n   */\n  async createUpgrade(\n    params: CreateUpgradeParams,\n  ): Promise<CreateUpgradeResponse> {\n    const jsonResponse = await this.fetchQuery({\n      queryKey: [`${this.name}:createUpgrade`, params],\n      staleTime: 0,\n      queryFn: async () => {\n        const headers = await this.#authHeaders();\n        const response = await fetch(\n          new URL('/v1/account-upgrade', this.#baseUrl),\n          {\n            method: 'POST',\n            headers,\n            body: JSON.stringify(params),\n          },\n        );\n\n        if (!response.ok) {\n          throw await createChompApiError(\n            response,\n            `POST /v1/account-upgrade failed with status '${response.status}'`,\n          );\n        }\n\n        return response.json();\n      },\n    });\n\n    return create(jsonResponse, CreateUpgradeResponseStruct);\n  }\n\n  /**\n   * Fetches all EIP-7702 upgrade authorizations for a given address (one per\n   * chain).\n   *\n   * GET /v1/account-upgrade/:address\n   *\n   * @param address - The address to look up.\n   * @returns The upgrade entries; empty array if none exist.\n   */\n  async getUpgrades(address: Hex): Promise<UpgradeEntry[]> {\n    const jsonResponse = await this.fetchQuery({\n      queryKey: [`${this.name}:getUpgrades`, address],\n      queryFn: async () => {\n        const headers = await this.#authHeaders();\n        const response = await fetch(\n          new URL(`/v1/account-upgrade/${address}`, this.#baseUrl),\n          { headers },\n        );\n\n        if (!response.ok) {\n          throw await createChompApiError(\n            response,\n            `Get upgrades request failed with status '${response.status}'`,\n          );\n        }\n\n        return response.json();\n      },\n    });\n\n    return create(jsonResponse, UpgradeEntryArrayStruct);\n  }\n\n  /**\n   * Verifies a delegation signature.\n   *\n   * POST /v1/intent/verify-delegation\n   *\n   * @param params - The delegation verification params.\n   * @returns The verification result including validity and optional errors.\n   */\n  async verifyDelegation(\n    params: VerifyDelegationParams,\n  ): Promise<VerifyDelegationResponse> {\n    const jsonResponse = await this.fetchQuery({\n      queryKey: [`${this.name}:verifyDelegation`, params],\n      staleTime: 0,\n      queryFn: async () => {\n        const headers = await this.#authHeaders();\n        const response = await fetch(\n          new URL('/v1/intent/verify-delegation', this.#baseUrl),\n          {\n            method: 'POST',\n            headers,\n            body: JSON.stringify(params),\n          },\n        );\n\n        if (!response.ok) {\n          throw await createChompApiError(\n            response,\n            `POST /v1/intent/verify-delegation failed with status '${response.status}'`,\n          );\n        }\n\n        return response.json();\n      },\n    });\n\n    return create(jsonResponse, VerifyDelegationResponseStruct);\n  }\n\n  /**\n   * Submits one or more intents to the CHOMP API.\n   *\n   * POST /v1/intent\n   *\n   * @param intents - The array of intents to submit.\n   * @returns The array of intent responses.\n   */\n  async createIntents(\n    intents: SendIntentParams[],\n  ): Promise<SendIntentResponse[]> {\n    const jsonResponse = await this.fetchQuery({\n      queryKey: [`${this.name}:createIntents`, intents],\n      staleTime: 0,\n      queryFn: async () => {\n        const headers = await this.#authHeaders();\n        const response = await fetch(new URL('/v1/intent', this.#baseUrl), {\n          method: 'POST',\n          headers,\n          body: JSON.stringify(intents),\n        });\n\n        if (!response.ok) {\n          throw await createChompApiError(\n            response,\n            `POST /v1/intent failed with status '${response.status}'`,\n          );\n        }\n\n        return response.json();\n      },\n    });\n\n    return create(jsonResponse, SendIntentResponseArrayStruct);\n  }\n\n  /**\n   * Fetches intents associated with a given address.\n   *\n   * GET /v1/intent/account/:address\n   *\n   * Callers use the result to decide whether an intent already exists, so it\n   * is always fetched fresh (`staleTime: 0`).\n   *\n   * @param address - The address to look up intents for.\n   * @returns The array of intents for the address, omitting any with an\n   * intent type this service does not recognise.\n   */\n  async getIntentsByAddress(address: Hex): Promise<IntentEntry[]> {\n    const jsonResponse = await this.fetchQuery({\n      queryKey: [`${this.name}:getIntentsByAddress`, address],\n      staleTime: 0,\n      queryFn: async () => {\n        const headers = await this.#authHeaders();\n        const response = await fetch(\n          new URL(`/v1/intent/account/${address}`, this.#baseUrl),\n          { headers },\n        );\n\n        if (!response.ok) {\n          throw await createChompApiError(\n            response,\n            `Get intents request failed with status '${response.status}'`,\n          );\n        }\n\n        return response.json();\n      },\n    });\n\n    return create(jsonResponse, IntentEntryArrayStruct).filter(\n      (intent): intent is IntentEntry =>\n        isChompIntentType(intent.metadata.type),\n    );\n  }\n\n  /**\n   * Creates a withdrawal for card spend flows.\n   *\n   * POST /v1/withdrawal\n   *\n   * @param params - The withdrawal params containing chainId, amount\n   * (decimal or hex string), and account address.\n   * @returns The withdrawal result.\n   */\n  async createWithdrawal(\n    params: CreateWithdrawalParams,\n  ): Promise<CreateWithdrawalResponse> {\n    const jsonResponse = await this.fetchQuery({\n      queryKey: [`${this.name}:createWithdrawal`, params],\n      staleTime: 0,\n      queryFn: async () => {\n        const headers = await this.#authHeaders();\n        const response = await fetch(new URL('/v1/withdrawal', this.#baseUrl), {\n          method: 'POST',\n          headers,\n          body: JSON.stringify(params),\n        });\n\n        if (!response.ok) {\n          throw await createChompApiError(\n            response,\n            `POST /v1/withdrawal failed with status '${response.status}'`,\n          );\n        }\n\n        return response.json();\n      },\n    });\n\n    return create(jsonResponse, CreateWithdrawalResponseStruct);\n  }\n\n  /**\n   * Retrieves service details including delegation redeemer addresses and DeFi\n   * contract details for signing delegations for auto-deposit functionality.\n   *\n   * GET /v1/chomp\n   *\n   * @param chainIds - Array of chain IDs (0x-prefixed hex strings) to retrieve\n   * details for.\n   * @returns The service details for the requested chains.\n   */\n  async getServiceDetails(chainIds: Hex[]): Promise<ServiceDetailsResponse> {\n    const jsonResponse = await this.fetchQuery({\n      queryKey: [`${this.name}:getServiceDetails`, chainIds],\n      queryFn: async () => {\n        const headers = await this.#authHeaders();\n        const url = new URL('/v1/chomp', this.#baseUrl);\n        url.searchParams.set('chainId', chainIds.join(','));\n        const response = await fetch(url, { headers });\n\n        if (!response.ok) {\n          throw await createChompApiError(\n            response,\n            `GET /v1/chomp failed with status '${response.status}'`,\n          );\n        }\n\n        return response.json();\n      },\n    });\n\n    return create(jsonResponse, ServiceDetailsResponseStruct);\n  }\n\n  /**\n   * Fetches the Money Account identities of the authenticated profile, with\n   * the status and migration steps CHOMP derives on every read.\n   *\n   * GET /v1/money-account/identities\n   *\n   * Profile-scoped and used to drive migrations, so it is always fetched\n   * fresh and keyed by a digest of the bearer token, like\n   * {@link ChompApiService.getAssociatedAddresses}.\n   *\n   * @returns The identities; empty when the profile has no Money Account.\n   * Addresses are lowercased.\n   */\n  async getDerivedIdentities(): Promise<DerivedIdentitiesResponse> {\n    const { token, profileKey } = await this.#getProfileScopedToken();\n\n    const jsonResponse = await this.fetchQuery({\n      queryKey: [`${this.name}:getDerivedIdentities`, profileKey],\n      staleTime: 0,\n      gcTime: 0,\n      queryFn: async () => {\n        const response = await fetch(\n          new URL('/v1/money-account/identities', this.#baseUrl),\n          { headers: this.#headersForToken(token) },\n        );\n\n        if (!response.ok) {\n          throw await createChompApiError(\n            response,\n            `GET /v1/money-account/identities failed with status '${response.status}'`,\n          );\n        }\n\n        return response.json();\n      },\n    });\n\n    return create(jsonResponse, DerivedIdentitiesResponseStruct);\n  }\n\n  /**\n   * Fetches the identity containing an address, along with where the address\n   * sits in it. The identity's `status` describes the whole chain.\n   *\n   * GET /v1/money-account/identities/address/:address\n   *\n   * Always fetched fresh and keyed by a digest of the bearer token, like\n   * {@link ChompApiService.getDerivedIdentities}.\n   *\n   * @param address - The address to look up.\n   * @returns The identity and address details, or `null` when the address is\n   * not associated with the authenticated profile. Addresses are lowercased.\n   */\n  async getDerivedIdentityByAddress(\n    address: Hex,\n  ): Promise<AddressIdentityResponse | null> {\n    const { token, profileKey } = await this.#getProfileScopedToken();\n\n    const jsonResponse = await this.fetchQuery({\n      queryKey: [\n        `${this.name}:getDerivedIdentityByAddress`,\n        profileKey,\n        address,\n      ],\n      staleTime: 0,\n      gcTime: 0,\n      queryFn: async () => {\n        const response = await fetch(\n          new URL(\n            `/v1/money-account/identities/address/${address}`,\n            this.#baseUrl,\n          ),\n          { headers: this.#headersForToken(token) },\n        );\n\n        if (response.status === 404) {\n          return null;\n        }\n\n        if (!response.ok) {\n          throw await createChompApiError(\n            response,\n            `GET /v1/money-account/identities/address/${address} failed with status '${response.status}'`,\n          );\n        }\n\n        return response.json();\n      },\n    });\n\n    return jsonResponse === null\n      ? null\n      : create(jsonResponse, AddressIdentityResponseStruct);\n  }\n}\n"]}

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-export { ChompApiService } from './chomp-api-service.js';
+export { ChompApiError, ChompApiService } from './chomp-api-service.js';
 export type { ChompApiServiceMessenger, ChompApiServiceActions, ChompApiServiceEvents, ChompApiServiceInvalidateQueriesAction, ChompApiServiceCacheUpdatedEvent, ChompApiServiceGranularCacheUpdatedEvent, } from './chomp-api-service.js';
-export type { ChompApiServiceAssociateAddressAction, ChompApiServiceGetAssociatedAddressesAction, ChompApiServiceCreateUpgradeAction, ChompApiServiceGetUpgradesAction, ChompApiServiceVerifyDelegationAction, ChompApiServiceCreateIntentsAction, ChompApiServiceGetIntentsByAddressAction, ChompApiServiceCreateWithdrawalAction, ChompApiServiceGetServiceDetailsAction, } from './chomp-api-service-method-action-types.js';
-export type { AccountUpgradeStatus, AssociateAddressParams, AssociateAddressResponse, AuthorizationData, ChompIntentType, CreateUpgradeParams, CreateUpgradeResponse, CreateWithdrawalParams, CreateWithdrawalResponse, DelegationCaveat, UpgradeEntry, IntentEntry, IntentMetadataParams, IntentMetadataResponse, ProfileAddressEntry, SendIntentParams, SendIntentResponse, ServiceDetailsChain, ServiceDetailsProtocol, ServiceDetailsResponse, ServiceDetailsSupportedToken, SignedDelegation, VerifyDelegationParams, VerifyDelegationResponse, } from './types.js';
+export type { ChompApiServiceAssociateAddressV2Action, ChompApiServiceCreateAddressChallengeAction, ChompApiServiceDisassociateAddressAction, ChompApiServiceGetAssociatedAddressesAction, ChompApiServiceCreateUpgradeAction, ChompApiServiceGetUpgradesAction, ChompApiServiceVerifyDelegationAction, ChompApiServiceCreateIntentsAction, ChompApiServiceGetIntentsByAddressAction, ChompApiServiceCreateWithdrawalAction, ChompApiServiceGetServiceDetailsAction, ChompApiServiceGetDerivedIdentitiesAction, ChompApiServiceGetDerivedIdentityByAddressAction, } from './chomp-api-service-method-action-types.js';
+export type { AccountUpgradeStatus, AddressIdentityResponse, AssociateAddressResponse, AssociateAddressV2Params, AssociationPurpose, AuthorizationData, ChompIntentType, CreateAddressChallengeParams, CreateAddressChallengeResponse, CreateUpgradeParams, CreateUpgradeResponse, CreateWithdrawalParams, CreateWithdrawalResponse, DelegationCaveat, DerivedIdentitiesResponse, DerivedIdentity, DerivedIdentityAddressRole, DerivedIdentityMigration, DerivedIdentityStatus, UpgradeEntry, IntentEntry, IntentMetadataParams, IntentMetadataResponse, MigrationStep, ProfileAddressEntry, SendIntentParams, SendIntentResponse, ServiceDetailsChain, ServiceDetailsProtocol, ServiceDetailsResponse, ServiceDetailsSupportedToken, SignedDelegation, VerifyDelegationParams, VerifyDelegationResponse, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,YAAY,EACV,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,sCAAsC,EACtC,gCAAgC,EAChC,wCAAwC,GACzC,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,qCAAqC,EACrC,2CAA2C,EAC3C,kCAAkC,EAClC,gCAAgC,EAChC,qCAAqC,EACrC,kCAAkC,EAClC,wCAAwC,EACxC,qCAAqC,EACrC,sCAAsC,GACvC,MAAM,4CAA4C,CAAC;AACpD,YAAY,EACV,oBAAoB,EACpB,sBAAsB,EACtB,wBAAwB,EACxB,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACtB,4BAA4B,EAC5B,gBAAgB,EAChB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACxE,YAAY,EACV,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,sCAAsC,EACtC,gCAAgC,EAChC,wCAAwC,GACzC,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,uCAAuC,EACvC,2CAA2C,EAC3C,wCAAwC,EACxC,2CAA2C,EAC3C,kCAAkC,EAClC,gCAAgC,EAChC,qCAAqC,EACrC,kCAAkC,EAClC,wCAAwC,EACxC,qCAAqC,EACrC,sCAAsC,EACtC,yCAAyC,EACzC,gDAAgD,GACjD,MAAM,4CAA4C,CAAC;AACpD,YAAY,EACV,oBAAoB,EACpB,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,EACxB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,4BAA4B,EAC5B,8BAA8B,EAC9B,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,gBAAgB,EAChB,yBAAyB,EACzB,eAAe,EACf,0BAA0B,EAC1B,wBAAwB,EACxB,qBAAqB,EACrB,YAAY,EACZ,WAAW,EACX,oBAAoB,EACpB,sBAAsB,EACtB,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACtB,4BAA4B,EAC5B,gBAAgB,EAChB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,2 +1,2 @@
-export { ChompApiService } from './chomp-api-service.js';
+export { ChompApiError, ChompApiService } from './chomp-api-service.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC","sourcesContent":["export { ChompApiService } from './chomp-api-service.js';\nexport type {\n  ChompApiServiceMessenger,\n  ChompApiServiceActions,\n  ChompApiServiceEvents,\n  ChompApiServiceInvalidateQueriesAction,\n  ChompApiServiceCacheUpdatedEvent,\n  ChompApiServiceGranularCacheUpdatedEvent,\n} from './chomp-api-service.js';\nexport type {\n  ChompApiServiceAssociateAddressAction,\n  ChompApiServiceGetAssociatedAddressesAction,\n  ChompApiServiceCreateUpgradeAction,\n  ChompApiServiceGetUpgradesAction,\n  ChompApiServiceVerifyDelegationAction,\n  ChompApiServiceCreateIntentsAction,\n  ChompApiServiceGetIntentsByAddressAction,\n  ChompApiServiceCreateWithdrawalAction,\n  ChompApiServiceGetServiceDetailsAction,\n} from './chomp-api-service-method-action-types.js';\nexport type {\n  AccountUpgradeStatus,\n  AssociateAddressParams,\n  AssociateAddressResponse,\n  AuthorizationData,\n  ChompIntentType,\n  CreateUpgradeParams,\n  CreateUpgradeResponse,\n  CreateWithdrawalParams,\n  CreateWithdrawalResponse,\n  DelegationCaveat,\n  UpgradeEntry,\n  IntentEntry,\n  IntentMetadataParams,\n  IntentMetadataResponse,\n  ProfileAddressEntry,\n  SendIntentParams,\n  SendIntentResponse,\n  ServiceDetailsChain,\n  ServiceDetailsProtocol,\n  ServiceDetailsResponse,\n  ServiceDetailsSupportedToken,\n  SignedDelegation,\n  VerifyDelegationParams,\n  VerifyDelegationResponse,\n} from './types.js';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC","sourcesContent":["export { ChompApiError, ChompApiService } from './chomp-api-service.js';\nexport type {\n  ChompApiServiceMessenger,\n  ChompApiServiceActions,\n  ChompApiServiceEvents,\n  ChompApiServiceInvalidateQueriesAction,\n  ChompApiServiceCacheUpdatedEvent,\n  ChompApiServiceGranularCacheUpdatedEvent,\n} from './chomp-api-service.js';\nexport type {\n  ChompApiServiceAssociateAddressV2Action,\n  ChompApiServiceCreateAddressChallengeAction,\n  ChompApiServiceDisassociateAddressAction,\n  ChompApiServiceGetAssociatedAddressesAction,\n  ChompApiServiceCreateUpgradeAction,\n  ChompApiServiceGetUpgradesAction,\n  ChompApiServiceVerifyDelegationAction,\n  ChompApiServiceCreateIntentsAction,\n  ChompApiServiceGetIntentsByAddressAction,\n  ChompApiServiceCreateWithdrawalAction,\n  ChompApiServiceGetServiceDetailsAction,\n  ChompApiServiceGetDerivedIdentitiesAction,\n  ChompApiServiceGetDerivedIdentityByAddressAction,\n} from './chomp-api-service-method-action-types.js';\nexport type {\n  AccountUpgradeStatus,\n  AddressIdentityResponse,\n  AssociateAddressResponse,\n  AssociateAddressV2Params,\n  AssociationPurpose,\n  AuthorizationData,\n  ChompIntentType,\n  CreateAddressChallengeParams,\n  CreateAddressChallengeResponse,\n  CreateUpgradeParams,\n  CreateUpgradeResponse,\n  CreateWithdrawalParams,\n  CreateWithdrawalResponse,\n  DelegationCaveat,\n  DerivedIdentitiesResponse,\n  DerivedIdentity,\n  DerivedIdentityAddressRole,\n  DerivedIdentityMigration,\n  DerivedIdentityStatus,\n  UpgradeEntry,\n  IntentEntry,\n  IntentMetadataParams,\n  IntentMetadataResponse,\n  MigrationStep,\n  ProfileAddressEntry,\n  SendIntentParams,\n  SendIntentResponse,\n  ServiceDetailsChain,\n  ServiceDetailsProtocol,\n  ServiceDetailsResponse,\n  ServiceDetailsSupportedToken,\n  SignedDelegation,\n  VerifyDelegationParams,\n  VerifyDelegationResponse,\n} from './types.js';\n"]}

package/dist/types.d.ts

@@ -2,10 +2,11 @@ import type { Hex } from '@metamask/utils';
 /**
  * The CHOMP intent metadata `type` discriminator, covering the base vault
  * (`cash-deposit`, `cash-withdrawal`), the premium vault
- * (`cash-deposit-premium`, `cash-withdrawal-premium`), and the recurring
- * subscription payment (`cash-subscription`).
+ * (`cash-deposit-premium`, `cash-withdrawal-premium`), the recurring
+ * subscription payment (`cash-subscription`), and Money Account migration
+ * (`cash-migration-root`, `cash-migration-transfer`).
  */
-export type ChompIntentType = 'cash-deposit' | 'cash-withdrawal' | 'cash-deposit-premium' | 'cash-withdrawal-premium' | 'cash-subscription';
+export type ChompIntentType = 'cash-deposit' | 'cash-withdrawal' | 'cash-deposit-premium' | 'cash-withdrawal-premium' | 'cash-subscription' | 'cash-migration-root' | 'cash-migration-transfer';
 export type DelegationCaveat = {
     enforcer: Hex;
     terms: Hex;
@@ -19,10 +20,31 @@ export type SignedDelegation = {
     salt: Hex;
     signature: Hex;
 };
-export type AssociateAddressParams = {
-    signature: Hex;
-    timestamp: number;
+/**
+ * Why an address is being associated through the v2 flow. `ASSOCIATE` creates
+ * a normal association, while `ASSOCIATE_SUCCESSOR` also links the address to
+ * its predecessor as the next address in the Money Account identity chain.
+ */
+export type AssociationPurpose = 'ASSOCIATE' | 'ASSOCIATE_SUCCESSOR';
+export type CreateAddressChallengeParams = {
+    address: Hex;
+    purpose: 'ASSOCIATE';
+} | {
     address: Hex;
+    purpose: 'ASSOCIATE_SUCCESSOR';
+    /**
+     * The current address of the Money Account that `address` succeeds.
+     * Must be set before any intents exist on `address`.
+     */
+    predecessorAddress: Hex;
+};
+export type AssociateAddressV2Params = {
+    challengeId: string;
+    /**
+     * The `personal_sign` signature of the challenge `message`, signed exactly
+     * as returned by CHOMP with the address being associated.
+     */
+    signature: Hex;
 };
 export type CreateUpgradeParams = {
     r: Hex;
@@ -56,19 +78,34 @@ export type CreateWithdrawalParams = {
     account: Hex;
 };
 /**
- * Returned by POST /v1/auth/address.
+ * Returned by POST /v2/auth/address.
  *
  * `profileId` is only included when the address was newly associated
  * (`status: 'created'`). When the address was already associated with the
  * authenticated profile (`status: 'active'`), only `address` is returned.
- * Both cases respond with 201; an address associated with a different
- * profile responds with 409, which is surfaced as an error.
+ * An address associated with a different profile responds with 409, which is
+ * surfaced as an error.
  */
 export type AssociateAddressResponse = {
     profileId?: string;
     address: Hex;
     status: 'active' | 'created';
 };
+/**
+ * Returned by POST /v2/auth/address/challenge.
+ */
+export type CreateAddressChallengeResponse = {
+    challengeId: string;
+    /**
+     * The EIP-4361 (Sign-In with Ethereum) message to sign, bound to the
+     * profile, chain, purpose, address and predecessor.
+     */
+    message: string;
+    /**
+     * When the challenge expires, as an ISO 8601 timestamp.
+     */
+    expiresAt: string;
+};
 /**
  * One entry returned by GET /v1/auth/address. The endpoint returns an array
  * of these — the active address associations of the authenticated profile
@@ -147,6 +184,59 @@ export type IntentEntry = {
 export type CreateWithdrawalResponse = {
     success: true;
 };
+/**
+ * A step that must exist before a migration link counts as complete.
+ * `SUCCESSOR_SUBSCRIPTION_INTENT` and `TRANSFER_INTENT_PVMUSD` are only
+ * required for premium subscribers.
+ */
+export type MigrationStep = 'SUCCESSOR_DEPOSIT_INTENT' | 'SUCCESSOR_WITHDRAWAL_INTENT' | 'SUCCESSOR_SUBSCRIPTION_INTENT' | 'SUCCESSOR_MONITORED' | 'ROOT_DELEGATION' | 'TRANSFER_INTENT_MUSD' | 'TRANSFER_INTENT_VMUSD' | 'TRANSFER_INTENT_PVMUSD';
+/**
+ * The settlement status of a Money Account identity chain. `NONE` is never
+ * returned as an entry: a profile with no Money Account has no identities.
+ */
+export type DerivedIdentityStatus = 'NONE' | 'MIGRATING' | 'DONE';
+/**
+ * The latest link of an identity chain while it is migrating.
+ */
+export type DerivedIdentityMigration = {
+    from: Hex;
+    to: Hex;
+    requiredSteps: MigrationStep[];
+    completedSteps: MigrationStep[];
+    missingSteps: MigrationStep[];
+};
+/**
+ * One Money Account over time: a chain of addresses joined by links.
+ * Addresses are lowercased.
+ */
+export type DerivedIdentity = {
+    /** The tip of the chain. Stays on the old address while migrating. */
+    currentAddress: Hex;
+    /** Earlier addresses, from the immediate predecessor backwards. */
+    previousAddresses: Hex[];
+    status: DerivedIdentityStatus;
+    migration: DerivedIdentityMigration | null;
+};
+/**
+ * Returned by GET /v1/money-account/identities.
+ */
+export type DerivedIdentitiesResponse = {
+    identities: DerivedIdentity[];
+};
+export type DerivedIdentityAddressRole = 'CURRENT' | 'PREVIOUS' | 'PENDING_SUCCESSOR';
+/**
+ * Returned by GET /v1/money-account/identities/address/:address. Addresses
+ * are lowercased.
+ */
+export type AddressIdentityResponse = {
+    identity: DerivedIdentity;
+    address: {
+        address: Hex;
+        role: DerivedIdentityAddressRole;
+        predecessor: Hex | null;
+        successor: Hex | null;
+    };
+};
 export type ServiceDetailsSupportedToken = {
     tokenAddress: Hex;
     tokenDecimals: number;

package/dist/types.d.ts.map

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

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Hex } from '@metamask/utils';\n\n// === COMMON TYPES ===\n\n/**\n * The CHOMP intent metadata `type` discriminator, covering the base vault\n * (`cash-deposit`, `cash-withdrawal`), the premium vault\n * (`cash-deposit-premium`, `cash-withdrawal-premium`), and the recurring\n * subscription payment (`cash-subscription`).\n */\nexport type ChompIntentType =\n  | 'cash-deposit'\n  | 'cash-withdrawal'\n  | 'cash-deposit-premium'\n  | 'cash-withdrawal-premium'\n  | 'cash-subscription';\n\nexport type DelegationCaveat = {\n  enforcer: Hex;\n  terms: Hex;\n  args: Hex;\n};\n\nexport type SignedDelegation = {\n  delegate: Hex;\n  delegator: Hex;\n  authority: Hex;\n  caveats: DelegationCaveat[];\n  salt: Hex;\n  signature: Hex;\n};\n\n// === PARAMS TYPES ===\n\nexport type AssociateAddressParams = {\n  signature: Hex;\n  timestamp: number;\n  address: Hex;\n};\n\nexport type CreateUpgradeParams = {\n  r: Hex;\n  s: Hex;\n  v: number;\n  yParity: number;\n  address: Hex;\n  chainId: string;\n  nonce: string;\n};\n\nexport type VerifyDelegationParams = {\n  signedDelegation: SignedDelegation;\n  chainId: Hex;\n};\n\nexport type IntentMetadataParams = {\n  allowance: Hex;\n  tokenSymbol: string;\n  tokenAddress: Hex;\n  type: ChompIntentType;\n};\n\nexport type SendIntentParams = {\n  account: Hex;\n  delegationHash: Hex;\n  chainId: Hex;\n  metadata: IntentMetadataParams;\n};\n\nexport type CreateWithdrawalParams = {\n  chainId: Hex;\n  /** Decimal integer or 0x-prefixed hex string representing the amount. */\n  amount: string;\n  account: Hex;\n};\n\n// === RESPONSE TYPES ===\n\n/**\n * Returned by POST /v1/auth/address.\n *\n * `profileId` is only included when the address was newly associated\n * (`status: 'created'`). When the address was already associated with the\n * authenticated profile (`status: 'active'`), only `address` is returned.\n * Both cases respond with 201; an address associated with a different\n * profile responds with 409, which is surfaced as an error.\n */\nexport type AssociateAddressResponse = {\n  profileId?: string;\n  address: Hex;\n  status: 'active' | 'created';\n};\n\n/**\n * One entry returned by GET /v1/auth/address. The endpoint returns an array\n * of these — the active address associations of the authenticated profile\n * (the API filters out soft-deleted associations, so `status` is always\n * `'active'`). Addresses are lowercased.\n */\nexport type ProfileAddressEntry = {\n  profileId: string;\n  address: Hex;\n  status: 'active';\n};\n\nexport type AccountUpgradeStatus = 'pending' | 'upgraded';\n\nexport type AuthorizationData = {\n  r: Hex;\n  s: Hex;\n  v: number;\n  yParity: number;\n  address: Hex;\n  chainId: Hex;\n  nonce: Hex;\n};\n\n/**\n * Returned by POST /v1/account-upgrade.\n */\nexport type CreateUpgradeResponse = {\n  signerAddress: Hex;\n  address: Hex;\n  chainId: Hex;\n  nonce: Hex;\n  status: AccountUpgradeStatus;\n  createdAt: string;\n};\n\n/**\n * One entry returned by GET /v1/account-upgrade/:address. The endpoint returns\n * an array of these (one per chain).\n */\nexport type UpgradeEntry = {\n  signerAddress: Hex;\n  chainId: Hex;\n  nonce: Hex;\n  authorization: AuthorizationData;\n  status: AccountUpgradeStatus;\n  createdAt: string;\n};\n\nexport type VerifyDelegationResponse = {\n  valid: boolean;\n  delegationHash?: Hex;\n  errors?: string[];\n};\n\nexport type IntentMetadataResponse = {\n  allowance: Hex;\n  tokenSymbol: string;\n  tokenAddress: Hex;\n  type: ChompIntentType;\n};\n\nexport type SendIntentResponse = {\n  delegationHash: Hex;\n  metadata: IntentMetadataResponse;\n  createdAt: string;\n};\n\n/**\n * The shape returned by GET /v1/intent/account/:address for each intent.\n */\nexport type IntentEntry = {\n  account: Hex;\n  delegationHash: Hex;\n  chainId: Hex;\n  status: 'active' | 'revoked';\n  metadata: {\n    allowance: Hex;\n    tokenAddress: Hex;\n    tokenSymbol: string;\n    type: ChompIntentType;\n  };\n};\n\nexport type CreateWithdrawalResponse = {\n  success: true;\n};\n\n// === SERVICE DETAILS TYPES ===\n\nexport type ServiceDetailsSupportedToken = {\n  tokenAddress: Hex;\n  tokenDecimals: number;\n};\n\nexport type ServiceDetailsProtocol = {\n  supportedTokens: ServiceDetailsSupportedToken[];\n  adapterAddress: Hex;\n  intentTypes: ChompIntentType[];\n};\n\nexport type ServiceDetailsChain = {\n  autoDepositDelegate: Hex;\n  protocol: {\n    vedaProtocol: ServiceDetailsProtocol;\n    vedaPremiumProtocol?: ServiceDetailsProtocol;\n  };\n};\n\nexport type ServiceDetailsResponse = {\n  auth: {\n    message: string;\n  };\n  chains: Record<Hex, ServiceDetailsChain>;\n};\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Hex } from '@metamask/utils';\n\n// === COMMON TYPES ===\n\n/**\n * The CHOMP intent metadata `type` discriminator, covering the base vault\n * (`cash-deposit`, `cash-withdrawal`), the premium vault\n * (`cash-deposit-premium`, `cash-withdrawal-premium`), the recurring\n * subscription payment (`cash-subscription`), and Money Account migration\n * (`cash-migration-root`, `cash-migration-transfer`).\n */\nexport type ChompIntentType =\n  | 'cash-deposit'\n  | 'cash-withdrawal'\n  | 'cash-deposit-premium'\n  | 'cash-withdrawal-premium'\n  | 'cash-subscription'\n  | 'cash-migration-root'\n  | 'cash-migration-transfer';\n\nexport type DelegationCaveat = {\n  enforcer: Hex;\n  terms: Hex;\n  args: Hex;\n};\n\nexport type SignedDelegation = {\n  delegate: Hex;\n  delegator: Hex;\n  authority: Hex;\n  caveats: DelegationCaveat[];\n  salt: Hex;\n  signature: Hex;\n};\n\n// === PARAMS TYPES ===\n\n/**\n * Why an address is being associated through the v2 flow. `ASSOCIATE` creates\n * a normal association, while `ASSOCIATE_SUCCESSOR` also links the address to\n * its predecessor as the next address in the Money Account identity chain.\n */\nexport type AssociationPurpose = 'ASSOCIATE' | 'ASSOCIATE_SUCCESSOR';\n\nexport type CreateAddressChallengeParams =\n  | {\n      address: Hex;\n      purpose: 'ASSOCIATE';\n    }\n  | {\n      address: Hex;\n      purpose: 'ASSOCIATE_SUCCESSOR';\n      /**\n       * The current address of the Money Account that `address` succeeds.\n       * Must be set before any intents exist on `address`.\n       */\n      predecessorAddress: Hex;\n    };\n\nexport type AssociateAddressV2Params = {\n  challengeId: string;\n  /**\n   * The `personal_sign` signature of the challenge `message`, signed exactly\n   * as returned by CHOMP with the address being associated.\n   */\n  signature: Hex;\n};\n\nexport type CreateUpgradeParams = {\n  r: Hex;\n  s: Hex;\n  v: number;\n  yParity: number;\n  address: Hex;\n  chainId: string;\n  nonce: string;\n};\n\nexport type VerifyDelegationParams = {\n  signedDelegation: SignedDelegation;\n  chainId: Hex;\n};\n\nexport type IntentMetadataParams = {\n  allowance: Hex;\n  tokenSymbol: string;\n  tokenAddress: Hex;\n  type: ChompIntentType;\n};\n\nexport type SendIntentParams = {\n  account: Hex;\n  delegationHash: Hex;\n  chainId: Hex;\n  metadata: IntentMetadataParams;\n};\n\nexport type CreateWithdrawalParams = {\n  chainId: Hex;\n  /** Decimal integer or 0x-prefixed hex string representing the amount. */\n  amount: string;\n  account: Hex;\n};\n\n// === RESPONSE TYPES ===\n\n/**\n * Returned by POST /v2/auth/address.\n *\n * `profileId` is only included when the address was newly associated\n * (`status: 'created'`). When the address was already associated with the\n * authenticated profile (`status: 'active'`), only `address` is returned.\n * An address associated with a different profile responds with 409, which is\n * surfaced as an error.\n */\nexport type AssociateAddressResponse = {\n  profileId?: string;\n  address: Hex;\n  status: 'active' | 'created';\n};\n\n/**\n * Returned by POST /v2/auth/address/challenge.\n */\nexport type CreateAddressChallengeResponse = {\n  challengeId: string;\n  /**\n   * The EIP-4361 (Sign-In with Ethereum) message to sign, bound to the\n   * profile, chain, purpose, address and predecessor.\n   */\n  message: string;\n  /**\n   * When the challenge expires, as an ISO 8601 timestamp.\n   */\n  expiresAt: string;\n};\n\n/**\n * One entry returned by GET /v1/auth/address. The endpoint returns an array\n * of these — the active address associations of the authenticated profile\n * (the API filters out soft-deleted associations, so `status` is always\n * `'active'`). Addresses are lowercased.\n */\nexport type ProfileAddressEntry = {\n  profileId: string;\n  address: Hex;\n  status: 'active';\n};\n\nexport type AccountUpgradeStatus = 'pending' | 'upgraded';\n\nexport type AuthorizationData = {\n  r: Hex;\n  s: Hex;\n  v: number;\n  yParity: number;\n  address: Hex;\n  chainId: Hex;\n  nonce: Hex;\n};\n\n/**\n * Returned by POST /v1/account-upgrade.\n */\nexport type CreateUpgradeResponse = {\n  signerAddress: Hex;\n  address: Hex;\n  chainId: Hex;\n  nonce: Hex;\n  status: AccountUpgradeStatus;\n  createdAt: string;\n};\n\n/**\n * One entry returned by GET /v1/account-upgrade/:address. The endpoint returns\n * an array of these (one per chain).\n */\nexport type UpgradeEntry = {\n  signerAddress: Hex;\n  chainId: Hex;\n  nonce: Hex;\n  authorization: AuthorizationData;\n  status: AccountUpgradeStatus;\n  createdAt: string;\n};\n\nexport type VerifyDelegationResponse = {\n  valid: boolean;\n  delegationHash?: Hex;\n  errors?: string[];\n};\n\nexport type IntentMetadataResponse = {\n  allowance: Hex;\n  tokenSymbol: string;\n  tokenAddress: Hex;\n  type: ChompIntentType;\n};\n\nexport type SendIntentResponse = {\n  delegationHash: Hex;\n  metadata: IntentMetadataResponse;\n  createdAt: string;\n};\n\n/**\n * The shape returned by GET /v1/intent/account/:address for each intent.\n */\nexport type IntentEntry = {\n  account: Hex;\n  delegationHash: Hex;\n  chainId: Hex;\n  status: 'active' | 'revoked';\n  metadata: {\n    allowance: Hex;\n    tokenAddress: Hex;\n    tokenSymbol: string;\n    type: ChompIntentType;\n  };\n};\n\nexport type CreateWithdrawalResponse = {\n  success: true;\n};\n\n// === DERIVED IDENTITY TYPES ===\n\n/**\n * A step that must exist before a migration link counts as complete.\n * `SUCCESSOR_SUBSCRIPTION_INTENT` and `TRANSFER_INTENT_PVMUSD` are only\n * required for premium subscribers.\n */\nexport type MigrationStep =\n  | 'SUCCESSOR_DEPOSIT_INTENT'\n  | 'SUCCESSOR_WITHDRAWAL_INTENT'\n  | 'SUCCESSOR_SUBSCRIPTION_INTENT'\n  | 'SUCCESSOR_MONITORED'\n  | 'ROOT_DELEGATION'\n  | 'TRANSFER_INTENT_MUSD'\n  | 'TRANSFER_INTENT_VMUSD'\n  | 'TRANSFER_INTENT_PVMUSD';\n\n/**\n * The settlement status of a Money Account identity chain. `NONE` is never\n * returned as an entry: a profile with no Money Account has no identities.\n */\nexport type DerivedIdentityStatus = 'NONE' | 'MIGRATING' | 'DONE';\n\n/**\n * The latest link of an identity chain while it is migrating.\n */\nexport type DerivedIdentityMigration = {\n  from: Hex;\n  to: Hex;\n  requiredSteps: MigrationStep[];\n  completedSteps: MigrationStep[];\n  missingSteps: MigrationStep[];\n};\n\n/**\n * One Money Account over time: a chain of addresses joined by links.\n * Addresses are lowercased.\n */\nexport type DerivedIdentity = {\n  /** The tip of the chain. Stays on the old address while migrating. */\n  currentAddress: Hex;\n  /** Earlier addresses, from the immediate predecessor backwards. */\n  previousAddresses: Hex[];\n  status: DerivedIdentityStatus;\n  migration: DerivedIdentityMigration | null;\n};\n\n/**\n * Returned by GET /v1/money-account/identities.\n */\nexport type DerivedIdentitiesResponse = {\n  identities: DerivedIdentity[];\n};\n\nexport type DerivedIdentityAddressRole =\n  | 'CURRENT'\n  | 'PREVIOUS'\n  | 'PENDING_SUCCESSOR';\n\n/**\n * Returned by GET /v1/money-account/identities/address/:address. Addresses\n * are lowercased.\n */\nexport type AddressIdentityResponse = {\n  identity: DerivedIdentity;\n  address: {\n    address: Hex;\n    role: DerivedIdentityAddressRole;\n    predecessor: Hex | null;\n    successor: Hex | null;\n  };\n};\n\n// === SERVICE DETAILS TYPES ===\n\nexport type ServiceDetailsSupportedToken = {\n  tokenAddress: Hex;\n  tokenDecimals: number;\n};\n\nexport type ServiceDetailsProtocol = {\n  supportedTokens: ServiceDetailsSupportedToken[];\n  adapterAddress: Hex;\n  intentTypes: ChompIntentType[];\n};\n\nexport type ServiceDetailsChain = {\n  autoDepositDelegate: Hex;\n  protocol: {\n    vedaProtocol: ServiceDetailsProtocol;\n    vedaPremiumProtocol?: ServiceDetailsProtocol;\n  };\n};\n\nexport type ServiceDetailsResponse = {\n  auth: {\n    message: string;\n  };\n  chains: Record<Hex, ServiceDetailsChain>;\n};\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamask-previews/chomp-api-service",
-  "version": "6.0.1-preview-63902891a",
+  "version": "6.0.1-preview-a0d99e051",
   "description": "Data service for the Chomp API",
   "keywords": [
     "Ethereum",