@metamask-previews/chomp-api-service 0.0.0-preview-08b3d87

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

@@ -0,0 +1,139 @@
+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 type { Messenger } from "@metamask/messenger";
+import type { AuthenticationControllerGetBearerTokenAction } from "@metamask/profile-sync-controller/auth";
+import type { QueryClientConfig } from "@tanstack/query-core";
+import type { ChompApiServiceMethodActions } from "./chomp-api-service-method-action-types.cjs";
+import type { AssociateAddressRequest, AssociateAddressResponse, CreateUpgradeRequest, UpgradeResponse, CreateWithdrawalRequest, CreateWithdrawalResponse, IntentEntry, SendIntentRequest, SendIntentResponse, VerifyDelegationRequest, VerifyDelegationResponse } from "./types.cjs";
+/**
+ * The name of the {@link ChompApiService}, used to namespace the service's
+ * actions and events.
+ */
+export declare const serviceName = "ChompApiService";
+/**
+ * Invalidates cached queries for {@link ChompApiService}.
+ */
+export type ChompApiServiceInvalidateQueriesAction = DataServiceInvalidateQueriesAction<typeof serviceName>;
+/**
+ * Actions that {@link ChompApiService} exposes to other consumers.
+ */
+export type ChompApiServiceActions = ChompApiServiceMethodActions | ChompApiServiceInvalidateQueriesAction;
+/**
+ * Actions from other messengers that {@link ChompApiService} calls.
+ */
+type AllowedActions = AuthenticationControllerGetBearerTokenAction;
+/**
+ * Published when {@link ChompApiService}'s cache is updated.
+ */
+export type ChompApiServiceCacheUpdatedEvent = DataServiceCacheUpdatedEvent<typeof serviceName>;
+/**
+ * Published when a key within {@link ChompApiService}'s cache is updated.
+ */
+export type ChompApiServiceGranularCacheUpdatedEvent = DataServiceGranularCacheUpdatedEvent<typeof serviceName>;
+/**
+ * Events that {@link ChompApiService} exposes to other consumers.
+ */
+export type ChompApiServiceEvents = ChompApiServiceCacheUpdatedEvent | ChompApiServiceGranularCacheUpdatedEvent;
+/**
+ * Events from other messengers that {@link ChompApiService} subscribes to.
+ */
+type AllowedEvents = never;
+/**
+ * The messenger which is restricted to actions and events accessed by
+ * {@link ChompApiService}.
+ */
+export type ChompApiServiceMessenger = Messenger<typeof serviceName, ChompApiServiceActions | AllowedActions, ChompApiServiceEvents | AllowedEvents>;
+/**
+ * This service is responsible for communicating with the CHOMP API.
+ *
+ * All requests are authenticated via JWT Bearer tokens obtained from the
+ * {@link AuthenticationControllerGetBearerTokenAction} messenger action.
+ */
+export declare class ChompApiService extends BaseDataService<typeof serviceName, ChompApiServiceMessenger> {
+    #private;
+    /**
+     * Constructs a new ChompApiService.
+     *
+     * @param args - The constructor arguments.
+     * @param args.messenger - The messenger suited for this service.
+     * @param args.baseUrl - The base URL of the CHOMP API.
+     * @param args.queryClientConfig - Configuration for the underlying TanStack
+     * Query client.
+     * @param args.policyOptions - Options to pass to `createServicePolicy`.
+     */
+    constructor({ messenger, baseUrl, queryClientConfig, policyOptions, }: {
+        messenger: ChompApiServiceMessenger;
+        baseUrl: string;
+        queryClientConfig?: QueryClientConfig;
+        policyOptions?: CreateServicePolicyOptions;
+    });
+    /**
+     * Associates an address with a CHOMP profile.
+     *
+     * POST /v1/auth/address
+     *
+     * @param request - The association request containing signature, timestamp,
+     * and address.
+     * @returns The profile association result. Returns on both 201 and 409.
+     */
+    associateAddress(request: AssociateAddressRequest): Promise<AssociateAddressResponse>;
+    /**
+     * Creates an account upgrade request.
+     *
+     * POST /v1/account-upgrade
+     *
+     * @param request - The upgrade request containing signature components and
+     * chain details.
+     * @returns The upgrade result.
+     */
+    createUpgrade(request: CreateUpgradeRequest): Promise<UpgradeResponse>;
+    /**
+     * Fetches the upgrade record for a given address.
+     *
+     * GET /v1/account-upgrade/:address
+     *
+     * @param address - The address to look up.
+     * @returns The upgrade record, or null if not found.
+     */
+    getUpgrade(address: string): Promise<UpgradeResponse | null>;
+    /**
+     * Verifies a delegation signature.
+     *
+     * POST /v1/intent/verify-delegation
+     *
+     * @param request - The delegation verification request.
+     * @returns The verification result including validity and optional errors.
+     */
+    verifyDelegation(request: VerifyDelegationRequest): Promise<VerifyDelegationResponse>;
+    /**
+     * Submits one or more intents to the CHOMP API.
+     *
+     * POST /v1/intent
+     *
+     * @param intents - The array of intents to submit.
+     * @returns The array of intent responses.
+     */
+    createIntents(intents: SendIntentRequest[]): Promise<SendIntentResponse[]>;
+    /**
+     * Fetches intents associated with a given address.
+     *
+     * GET /v1/intent/account/:address
+     *
+     * @param address - The address to look up intents for.
+     * @returns The array of intents for the address.
+     */
+    getIntentsByAddress(address: string): Promise<IntentEntry[]>;
+    /**
+     * Creates a withdrawal for card spend flows.
+     *
+     * POST /v1/withdrawal
+     *
+     * @param request - The withdrawal request containing chainId, amount
+     * (decimal or hex string), and account address.
+     * @returns The withdrawal result.
+     */
+    createWithdrawal(request: CreateWithdrawalRequest): Promise<CreateWithdrawalResponse>;
+}
+export {};
+//# sourceMappingURL=chomp-api-service.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chomp-api-service.d.cts","sourceRoot":"","sources":["../src/chomp-api-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,oCAAoC;AAC9D,OAAO,KAAK,EACV,4BAA4B,EAC5B,oCAAoC,EACpC,kCAAkC,EACnC,oCAAoC;AACrC,OAAO,KAAK,EAAE,0BAA0B,EAAE,mCAAmC;AAE7E,OAAO,KAAK,EAAE,SAAS,EAAE,4BAA4B;AACrD,OAAO,KAAK,EAAE,4CAA4C,EAAE,+CAA+C;AAa3G,OAAO,KAAK,EAAE,iBAAiB,EAAE,6BAA6B;AAE9D,OAAO,KAAK,EAAE,4BAA4B,EAAE,oDAAgD;AAC5F,OAAO,KAAK,EACV,uBAAuB,EACvB,wBAAwB,EACxB,oBAAoB,EACpB,eAAe,EACf,uBAAuB,EACvB,wBAAwB,EACxB,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACvB,wBAAwB,EACzB,oBAAgB;AAIjB;;;GAGG;AACH,eAAO,MAAM,WAAW,oBAAoB,CAAC;AAkB7C;;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,4CAA4C,CAAC;AAEnE;;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;AA4DF;;;;;GAKG;AACH,qBAAa,eAAgB,SAAQ,eAAe,CAClD,OAAO,WAAW,EAClB,wBAAwB,CACzB;;IAGC;;;;;;;;;OASG;gBACS,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;IA+BD;;;;;;;;OAQG;IACG,gBAAgB,CACpB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,wBAAwB,CAAC;IA6BpC;;;;;;;;OAQG;IACG,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,eAAe,CAAC;IA6B5E;;;;;;;OAOG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAgClE;;;;;;;OAOG;IACG,gBAAgB,CACpB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,wBAAwB,CAAC;IA6BpC;;;;;;;OAOG;IACG,aAAa,CACjB,OAAO,EAAE,iBAAiB,EAAE,GAC3B,OAAO,CAAC,kBAAkB,EAAE,CAAC;IA6BhC;;;;;;;OAOG;IACG,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAwBlE;;;;;;;;OAQG;IACG,gBAAgB,CACpB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,wBAAwB,CAAC;CAyBrC"}

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

@@ -0,0 +1,139 @@
+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 type { Messenger } from "@metamask/messenger";
+import type { AuthenticationControllerGetBearerTokenAction } from "@metamask/profile-sync-controller/auth";
+import type { QueryClientConfig } from "@tanstack/query-core";
+import type { ChompApiServiceMethodActions } from "./chomp-api-service-method-action-types.mjs";
+import type { AssociateAddressRequest, AssociateAddressResponse, CreateUpgradeRequest, UpgradeResponse, CreateWithdrawalRequest, CreateWithdrawalResponse, IntentEntry, SendIntentRequest, SendIntentResponse, VerifyDelegationRequest, VerifyDelegationResponse } from "./types.mjs";
+/**
+ * The name of the {@link ChompApiService}, used to namespace the service's
+ * actions and events.
+ */
+export declare const serviceName = "ChompApiService";
+/**
+ * Invalidates cached queries for {@link ChompApiService}.
+ */
+export type ChompApiServiceInvalidateQueriesAction = DataServiceInvalidateQueriesAction<typeof serviceName>;
+/**
+ * Actions that {@link ChompApiService} exposes to other consumers.
+ */
+export type ChompApiServiceActions = ChompApiServiceMethodActions | ChompApiServiceInvalidateQueriesAction;
+/**
+ * Actions from other messengers that {@link ChompApiService} calls.
+ */
+type AllowedActions = AuthenticationControllerGetBearerTokenAction;
+/**
+ * Published when {@link ChompApiService}'s cache is updated.
+ */
+export type ChompApiServiceCacheUpdatedEvent = DataServiceCacheUpdatedEvent<typeof serviceName>;
+/**
+ * Published when a key within {@link ChompApiService}'s cache is updated.
+ */
+export type ChompApiServiceGranularCacheUpdatedEvent = DataServiceGranularCacheUpdatedEvent<typeof serviceName>;
+/**
+ * Events that {@link ChompApiService} exposes to other consumers.
+ */
+export type ChompApiServiceEvents = ChompApiServiceCacheUpdatedEvent | ChompApiServiceGranularCacheUpdatedEvent;
+/**
+ * Events from other messengers that {@link ChompApiService} subscribes to.
+ */
+type AllowedEvents = never;
+/**
+ * The messenger which is restricted to actions and events accessed by
+ * {@link ChompApiService}.
+ */
+export type ChompApiServiceMessenger = Messenger<typeof serviceName, ChompApiServiceActions | AllowedActions, ChompApiServiceEvents | AllowedEvents>;
+/**
+ * This service is responsible for communicating with the CHOMP API.
+ *
+ * All requests are authenticated via JWT Bearer tokens obtained from the
+ * {@link AuthenticationControllerGetBearerTokenAction} messenger action.
+ */
+export declare class ChompApiService extends BaseDataService<typeof serviceName, ChompApiServiceMessenger> {
+    #private;
+    /**
+     * Constructs a new ChompApiService.
+     *
+     * @param args - The constructor arguments.
+     * @param args.messenger - The messenger suited for this service.
+     * @param args.baseUrl - The base URL of the CHOMP API.
+     * @param args.queryClientConfig - Configuration for the underlying TanStack
+     * Query client.
+     * @param args.policyOptions - Options to pass to `createServicePolicy`.
+     */
+    constructor({ messenger, baseUrl, queryClientConfig, policyOptions, }: {
+        messenger: ChompApiServiceMessenger;
+        baseUrl: string;
+        queryClientConfig?: QueryClientConfig;
+        policyOptions?: CreateServicePolicyOptions;
+    });
+    /**
+     * Associates an address with a CHOMP profile.
+     *
+     * POST /v1/auth/address
+     *
+     * @param request - The association request containing signature, timestamp,
+     * and address.
+     * @returns The profile association result. Returns on both 201 and 409.
+     */
+    associateAddress(request: AssociateAddressRequest): Promise<AssociateAddressResponse>;
+    /**
+     * Creates an account upgrade request.
+     *
+     * POST /v1/account-upgrade
+     *
+     * @param request - The upgrade request containing signature components and
+     * chain details.
+     * @returns The upgrade result.
+     */
+    createUpgrade(request: CreateUpgradeRequest): Promise<UpgradeResponse>;
+    /**
+     * Fetches the upgrade record for a given address.
+     *
+     * GET /v1/account-upgrade/:address
+     *
+     * @param address - The address to look up.
+     * @returns The upgrade record, or null if not found.
+     */
+    getUpgrade(address: string): Promise<UpgradeResponse | null>;
+    /**
+     * Verifies a delegation signature.
+     *
+     * POST /v1/intent/verify-delegation
+     *
+     * @param request - The delegation verification request.
+     * @returns The verification result including validity and optional errors.
+     */
+    verifyDelegation(request: VerifyDelegationRequest): Promise<VerifyDelegationResponse>;
+    /**
+     * Submits one or more intents to the CHOMP API.
+     *
+     * POST /v1/intent
+     *
+     * @param intents - The array of intents to submit.
+     * @returns The array of intent responses.
+     */
+    createIntents(intents: SendIntentRequest[]): Promise<SendIntentResponse[]>;
+    /**
+     * Fetches intents associated with a given address.
+     *
+     * GET /v1/intent/account/:address
+     *
+     * @param address - The address to look up intents for.
+     * @returns The array of intents for the address.
+     */
+    getIntentsByAddress(address: string): Promise<IntentEntry[]>;
+    /**
+     * Creates a withdrawal for card spend flows.
+     *
+     * POST /v1/withdrawal
+     *
+     * @param request - The withdrawal request containing chainId, amount
+     * (decimal or hex string), and account address.
+     * @returns The withdrawal result.
+     */
+    createWithdrawal(request: CreateWithdrawalRequest): Promise<CreateWithdrawalResponse>;
+}
+export {};
+//# sourceMappingURL=chomp-api-service.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chomp-api-service.d.mts","sourceRoot":"","sources":["../src/chomp-api-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,oCAAoC;AAC9D,OAAO,KAAK,EACV,4BAA4B,EAC5B,oCAAoC,EACpC,kCAAkC,EACnC,oCAAoC;AACrC,OAAO,KAAK,EAAE,0BAA0B,EAAE,mCAAmC;AAE7E,OAAO,KAAK,EAAE,SAAS,EAAE,4BAA4B;AACrD,OAAO,KAAK,EAAE,4CAA4C,EAAE,+CAA+C;AAa3G,OAAO,KAAK,EAAE,iBAAiB,EAAE,6BAA6B;AAE9D,OAAO,KAAK,EAAE,4BAA4B,EAAE,oDAAgD;AAC5F,OAAO,KAAK,EACV,uBAAuB,EACvB,wBAAwB,EACxB,oBAAoB,EACpB,eAAe,EACf,uBAAuB,EACvB,wBAAwB,EACxB,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACvB,wBAAwB,EACzB,oBAAgB;AAIjB;;;GAGG;AACH,eAAO,MAAM,WAAW,oBAAoB,CAAC;AAkB7C;;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,4CAA4C,CAAC;AAEnE;;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;AA4DF;;;;;GAKG;AACH,qBAAa,eAAgB,SAAQ,eAAe,CAClD,OAAO,WAAW,EAClB,wBAAwB,CACzB;;IAGC;;;;;;;;;OASG;gBACS,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;IA+BD;;;;;;;;OAQG;IACG,gBAAgB,CACpB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,wBAAwB,CAAC;IA6BpC;;;;;;;;OAQG;IACG,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,eAAe,CAAC;IA6B5E;;;;;;;OAOG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAgClE;;;;;;;OAOG;IACG,gBAAgB,CACpB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,wBAAwB,CAAC;IA6BpC;;;;;;;OAOG;IACG,aAAa,CACjB,OAAO,EAAE,iBAAiB,EAAE,GAC3B,OAAO,CAAC,kBAAkB,EAAE,CAAC;IA6BhC;;;;;;;OAOG;IACG,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAwBlE;;;;;;;;OAQG;IACG,gBAAgB,CACpB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,wBAAwB,CAAC;CAyBrC"}

package/dist/chomp-api-service.mjs

@@ -0,0 +1,311 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _ChompApiService_instances, _ChompApiService_baseUrl, _ChompApiService_authHeaders;
+import { BaseDataService } from "@metamask/base-data-service";
+import { HttpError } from "@metamask/controller-utils";
+import { array, boolean, create, define, enums, literal, optional, string, type } from "@metamask/superstruct";
+import { isStrictHexString } from "@metamask/utils";
+// === GENERAL ===
+/**
+ * The name of the {@link ChompApiService}, used to namespace the service's
+ * actions and events.
+ */
+export const serviceName = 'ChompApiService';
+// === MESSENGER ===
+/**
+ * All of the methods within {@link ChompApiService} that are exposed via the
+ * messenger.
+ */
+const MESSENGER_EXPOSED_METHODS = [
+    'associateAddress',
+    'createUpgrade',
+    'getUpgrade',
+    'verifyDelegation',
+    'createIntents',
+    'getIntentsByAddress',
+    'createWithdrawal',
+];
+// === RESPONSE VALIDATION ===
+const HexStringStruct = define('Hex string', (value) => isStrictHexString(value));
+const AssociateAddressResponseStruct = type({
+    profileId: string(),
+    address: string(),
+    status: string(),
+});
+const UpgradeResponseStruct = type({
+    signerAddress: string(),
+    status: string(),
+    createdAt: string(),
+});
+const VerifyDelegationResponseStruct = type({
+    valid: boolean(),
+    delegationHash: optional(string()),
+    errors: optional(array(string())),
+});
+const SendIntentResponseArrayStruct = array(type({
+    delegationHash: string(),
+    metadata: type({
+        allowance: HexStringStruct,
+        tokenSymbol: string(),
+        tokenAddress: HexStringStruct,
+        type: enums(['cash-deposit', 'cash-withdrawal']),
+    }),
+    createdAt: string(),
+}));
+const IntentEntryArrayStruct = array(type({
+    account: HexStringStruct,
+    delegationHash: HexStringStruct,
+    chainId: HexStringStruct,
+    status: enums(['active', 'revoked']),
+    metadata: type({
+        allowance: HexStringStruct,
+        tokenAddress: HexStringStruct,
+        tokenSymbol: string(),
+        type: enums(['deposit', 'withdraw']),
+    }),
+}));
+const CreateWithdrawalResponseStruct = type({
+    success: literal(true),
+});
+// === SERVICE DEFINITION ===
+/**
+ * This service is responsible for communicating with the CHOMP API.
+ *
+ * All requests are authenticated via JWT Bearer tokens obtained from the
+ * {@link AuthenticationControllerGetBearerTokenAction} messenger action.
+ */
+export class ChompApiService extends BaseDataService {
+    /**
+     * Constructs a new ChompApiService.
+     *
+     * @param args - The constructor arguments.
+     * @param args.messenger - The messenger suited for this service.
+     * @param args.baseUrl - The base URL of the CHOMP API.
+     * @param args.queryClientConfig - Configuration for the underlying TanStack
+     * Query client.
+     * @param args.policyOptions - Options to pass to `createServicePolicy`.
+     */
+    constructor({ messenger, baseUrl, queryClientConfig = {}, policyOptions = {}, }) {
+        super({
+            name: serviceName,
+            messenger,
+            queryClientConfig,
+            policyOptions,
+        });
+        _ChompApiService_instances.add(this);
+        _ChompApiService_baseUrl.set(this, void 0);
+        __classPrivateFieldSet(this, _ChompApiService_baseUrl, baseUrl, "f");
+        this.messenger.registerMethodActionHandlers(this, MESSENGER_EXPOSED_METHODS);
+    }
+    /**
+     * Associates an address with a CHOMP profile.
+     *
+     * POST /v1/auth/address
+     *
+     * @param request - The association request containing signature, timestamp,
+     * and address.
+     * @returns The profile association result. Returns on both 201 and 409.
+     */
+    async associateAddress(request) {
+        const jsonResponse = await this.fetchQuery({
+            queryKey: [`${this.name}:associateAddress`, request],
+            staleTime: 0,
+            queryFn: async () => {
+                const headers = await __classPrivateFieldGet(this, _ChompApiService_instances, "m", _ChompApiService_authHeaders).call(this);
+                const response = await fetch(new URL('/v1/auth/address', __classPrivateFieldGet(this, _ChompApiService_baseUrl, "f")), {
+                    method: 'POST',
+                    headers,
+                    body: JSON.stringify(request),
+                });
+                if (!response.ok && response.status !== 409) {
+                    throw new HttpError(response.status, `POST /v1/auth/address failed with status '${response.status}'`);
+                }
+                return response.json();
+            },
+        });
+        return create(jsonResponse, AssociateAddressResponseStruct);
+    }
+    /**
+     * Creates an account upgrade request.
+     *
+     * POST /v1/account-upgrade
+     *
+     * @param request - The upgrade request containing signature components and
+     * chain details.
+     * @returns The upgrade result.
+     */
+    async createUpgrade(request) {
+        const jsonResponse = await this.fetchQuery({
+            queryKey: [`${this.name}:createUpgrade`, request],
+            staleTime: 0,
+            queryFn: async () => {
+                const headers = await __classPrivateFieldGet(this, _ChompApiService_instances, "m", _ChompApiService_authHeaders).call(this);
+                const response = await fetch(new URL('/v1/account-upgrade', __classPrivateFieldGet(this, _ChompApiService_baseUrl, "f")), {
+                    method: 'POST',
+                    headers,
+                    body: JSON.stringify(request),
+                });
+                if (!response.ok) {
+                    throw new HttpError(response.status, `POST /v1/account-upgrade failed with status '${response.status}'`);
+                }
+                return response.json();
+            },
+        });
+        return create(jsonResponse, UpgradeResponseStruct);
+    }
+    /**
+     * Fetches the upgrade record for a given address.
+     *
+     * GET /v1/account-upgrade/:address
+     *
+     * @param address - The address to look up.
+     * @returns The upgrade record, or null if not found.
+     */
+    async getUpgrade(address) {
+        const jsonResponse = await this.fetchQuery({
+            queryKey: [`${this.name}:getUpgrade`, address],
+            queryFn: async () => {
+                const headers = await __classPrivateFieldGet(this, _ChompApiService_instances, "m", _ChompApiService_authHeaders).call(this);
+                const response = await fetch(new URL(`/v1/account-upgrade/${address}`, __classPrivateFieldGet(this, _ChompApiService_baseUrl, "f")), { headers });
+                if (response.status === 404) {
+                    return null;
+                }
+                if (!response.ok) {
+                    throw new HttpError(response.status, `Get upgrade request failed with status '${response.status}'`);
+                }
+                return response.json();
+            },
+        });
+        if (jsonResponse === null) {
+            return null;
+        }
+        return create(jsonResponse, UpgradeResponseStruct);
+    }
+    /**
+     * Verifies a delegation signature.
+     *
+     * POST /v1/intent/verify-delegation
+     *
+     * @param request - The delegation verification request.
+     * @returns The verification result including validity and optional errors.
+     */
+    async verifyDelegation(request) {
+        const jsonResponse = await this.fetchQuery({
+            queryKey: [`${this.name}:verifyDelegation`, request],
+            staleTime: 0,
+            queryFn: async () => {
+                const headers = await __classPrivateFieldGet(this, _ChompApiService_instances, "m", _ChompApiService_authHeaders).call(this);
+                const response = await fetch(new URL('/v1/intent/verify-delegation', __classPrivateFieldGet(this, _ChompApiService_baseUrl, "f")), {
+                    method: 'POST',
+                    headers,
+                    body: JSON.stringify(request),
+                });
+                if (!response.ok) {
+                    throw new HttpError(response.status, `POST /v1/intent/verify-delegation failed with status '${response.status}'`);
+                }
+                return response.json();
+            },
+        });
+        return create(jsonResponse, VerifyDelegationResponseStruct);
+    }
+    /**
+     * Submits one or more intents to the CHOMP API.
+     *
+     * POST /v1/intent
+     *
+     * @param intents - The array of intents to submit.
+     * @returns The array of intent responses.
+     */
+    async createIntents(intents) {
+        const jsonResponse = await this.fetchQuery({
+            queryKey: [`${this.name}:createIntents`, intents],
+            staleTime: 0,
+            queryFn: async () => {
+                const headers = await __classPrivateFieldGet(this, _ChompApiService_instances, "m", _ChompApiService_authHeaders).call(this);
+                const response = await fetch(new URL('/v1/intent', __classPrivateFieldGet(this, _ChompApiService_baseUrl, "f")), {
+                    method: 'POST',
+                    headers,
+                    body: JSON.stringify(intents),
+                });
+                if (!response.ok) {
+                    throw new HttpError(response.status, `POST /v1/intent failed with status '${response.status}'`);
+                }
+                return response.json();
+            },
+        });
+        return create(jsonResponse, SendIntentResponseArrayStruct);
+    }
+    /**
+     * Fetches intents associated with a given address.
+     *
+     * GET /v1/intent/account/:address
+     *
+     * @param address - The address to look up intents for.
+     * @returns The array of intents for the address.
+     */
+    async getIntentsByAddress(address) {
+        const jsonResponse = await this.fetchQuery({
+            queryKey: [`${this.name}:getIntentsByAddress`, address],
+            queryFn: async () => {
+                const headers = await __classPrivateFieldGet(this, _ChompApiService_instances, "m", _ChompApiService_authHeaders).call(this);
+                const response = await fetch(new URL(`/v1/intent/account/${address}`, __classPrivateFieldGet(this, _ChompApiService_baseUrl, "f")), { headers });
+                if (!response.ok) {
+                    throw new HttpError(response.status, `Get intents request failed with status '${response.status}'`);
+                }
+                return response.json();
+            },
+        });
+        return create(jsonResponse, IntentEntryArrayStruct);
+    }
+    /**
+     * Creates a withdrawal for card spend flows.
+     *
+     * POST /v1/withdrawal
+     *
+     * @param request - The withdrawal request containing chainId, amount
+     * (decimal or hex string), and account address.
+     * @returns The withdrawal result.
+     */
+    async createWithdrawal(request) {
+        const jsonResponse = await this.fetchQuery({
+            queryKey: [`${this.name}:createWithdrawal`, request],
+            staleTime: 0,
+            queryFn: async () => {
+                const headers = await __classPrivateFieldGet(this, _ChompApiService_instances, "m", _ChompApiService_authHeaders).call(this);
+                const response = await fetch(new URL('/v1/withdrawal', __classPrivateFieldGet(this, _ChompApiService_baseUrl, "f")), {
+                    method: 'POST',
+                    headers,
+                    body: JSON.stringify(request),
+                });
+                if (!response.ok) {
+                    throw new HttpError(response.status, `POST /v1/withdrawal failed with status '${response.status}'`);
+                }
+                return response.json();
+            },
+        });
+        return create(jsonResponse, CreateWithdrawalResponseStruct);
+    }
+}
+_ChompApiService_baseUrl = new WeakMap(), _ChompApiService_instances = new WeakSet(), _ChompApiService_authHeaders = 
+/**
+ * Builds the standard headers for an authenticated CHOMP API request.
+ *
+ * @returns Headers including Authorization and Content-Type.
+ */
+async function _ChompApiService_authHeaders() {
+    const token = await this.messenger.call('AuthenticationController:getBearerToken');
+    return {
+        Authorization: `Bearer ${token}`,
+        'Content-Type': 'application/json',
+    };
+};
+//# sourceMappingURL=chomp-api-service.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chomp-api-service.mjs","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 { HttpError } from '@metamask/controller-utils';\nimport type { Messenger } from '@metamask/messenger';\nimport type { AuthenticationControllerGetBearerTokenAction } from '@metamask/profile-sync-controller/auth';\nimport {\n  array,\n  boolean,\n  create,\n  define,\n  enums,\n  literal,\n  optional,\n  string,\n  type,\n} from '@metamask/superstruct';\nimport { isStrictHexString } from '@metamask/utils';\nimport type { QueryClientConfig } from '@tanstack/query-core';\n\nimport type { ChompApiServiceMethodActions } from './chomp-api-service-method-action-types';\nimport type {\n  AssociateAddressRequest,\n  AssociateAddressResponse,\n  CreateUpgradeRequest,\n  UpgradeResponse,\n  CreateWithdrawalRequest,\n  CreateWithdrawalResponse,\n  IntentEntry,\n  SendIntentRequest,\n  SendIntentResponse,\n  VerifyDelegationRequest,\n  VerifyDelegationResponse,\n} from './types';\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  'createUpgrade',\n  'getUpgrade',\n  'verifyDelegation',\n  'createIntents',\n  'getIntentsByAddress',\n  'createWithdrawal',\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 = AuthenticationControllerGetBearerTokenAction;\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 HexStringStruct = define<string>('Hex string', (value) =>\n  isStrictHexString(value),\n);\n\nconst AssociateAddressResponseStruct = type({\n  profileId: string(),\n  address: string(),\n  status: string(),\n});\n\nconst UpgradeResponseStruct = type({\n  signerAddress: string(),\n  status: string(),\n  createdAt: string(),\n});\n\nconst VerifyDelegationResponseStruct = type({\n  valid: boolean(),\n  delegationHash: optional(string()),\n  errors: optional(array(string())),\n});\n\nconst SendIntentResponseArrayStruct = array(\n  type({\n    delegationHash: string(),\n    metadata: type({\n      allowance: HexStringStruct,\n      tokenSymbol: string(),\n      tokenAddress: HexStringStruct,\n      type: enums(['cash-deposit', 'cash-withdrawal']),\n    }),\n    createdAt: string(),\n  }),\n);\n\nconst IntentEntryArrayStruct = array(\n  type({\n    account: HexStringStruct,\n    delegationHash: HexStringStruct,\n    chainId: HexStringStruct,\n    status: enums(['active', 'revoked']),\n    metadata: type({\n      allowance: HexStringStruct,\n      tokenAddress: HexStringStruct,\n      tokenSymbol: string(),\n      type: enums(['deposit', 'withdraw']),\n    }),\n  }),\n);\n\nconst CreateWithdrawalResponseStruct = type({\n  success: literal(true),\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 * {@link AuthenticationControllerGetBearerTokenAction} 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,\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 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 {\n      Authorization: `Bearer ${token}`,\n      'Content-Type': 'application/json',\n    };\n  }\n\n  /**\n   * Associates an address with a CHOMP profile.\n   *\n   * POST /v1/auth/address\n   *\n   * @param request - The association request containing signature, timestamp,\n   * and address.\n   * @returns The profile association result. Returns on both 201 and 409.\n   */\n  async associateAddress(\n    request: AssociateAddressRequest,\n  ): Promise<AssociateAddressResponse> {\n    const jsonResponse = await this.fetchQuery({\n      queryKey: [`${this.name}:associateAddress`, request],\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(request),\n          },\n        );\n\n        if (!response.ok && response.status !== 409) {\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   * Creates an account upgrade request.\n   *\n   * POST /v1/account-upgrade\n   *\n   * @param request - The upgrade request containing signature components and\n   * chain details.\n   * @returns The upgrade result.\n   */\n  async createUpgrade(request: CreateUpgradeRequest): Promise<UpgradeResponse> {\n    const jsonResponse = await this.fetchQuery({\n      queryKey: [`${this.name}:createUpgrade`, request],\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(request),\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, UpgradeResponseStruct);\n  }\n\n  /**\n   * Fetches the upgrade record for a given address.\n   *\n   * GET /v1/account-upgrade/:address\n   *\n   * @param address - The address to look up.\n   * @returns The upgrade record, or null if not found.\n   */\n  async getUpgrade(address: string): Promise<UpgradeResponse | null> {\n    const jsonResponse = await this.fetchQuery({\n      queryKey: [`${this.name}:getUpgrade`, 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.status === 404) {\n          return null;\n        }\n\n        if (!response.ok) {\n          throw new HttpError(\n            response.status,\n            `Get upgrade request failed with status '${response.status}'`,\n          );\n        }\n\n        return response.json();\n      },\n    });\n\n    if (jsonResponse === null) {\n      return null;\n    }\n\n    return create(jsonResponse, UpgradeResponseStruct);\n  }\n\n  /**\n   * Verifies a delegation signature.\n   *\n   * POST /v1/intent/verify-delegation\n   *\n   * @param request - The delegation verification request.\n   * @returns The verification result including validity and optional errors.\n   */\n  async verifyDelegation(\n    request: VerifyDelegationRequest,\n  ): Promise<VerifyDelegationResponse> {\n    const jsonResponse = await this.fetchQuery({\n      queryKey: [`${this.name}:verifyDelegation`, request],\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(request),\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: SendIntentRequest[],\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(\n      jsonResponse,\n      SendIntentResponseArrayStruct,\n    ) as SendIntentResponse[];\n  }\n\n  /**\n   * Fetches intents associated with a given address.\n   *\n   * GET /v1/intent/account/:address\n   *\n   * @param address - The address to look up intents for.\n   * @returns The array of intents for the address.\n   */\n  async getIntentsByAddress(address: string): Promise<IntentEntry[]> {\n    const jsonResponse = await this.fetchQuery({\n      queryKey: [`${this.name}:getIntentsByAddress`, address],\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) as IntentEntry[];\n  }\n\n  /**\n   * Creates a withdrawal for card spend flows.\n   *\n   * POST /v1/withdrawal\n   *\n   * @param request - The withdrawal request containing chainId, amount\n   * (decimal or hex string), and account address.\n   * @returns The withdrawal result.\n   */\n  async createWithdrawal(\n    request: CreateWithdrawalRequest,\n  ): Promise<CreateWithdrawalResponse> {\n    const jsonResponse = await this.fetchQuery({\n      queryKey: [`${this.name}:createWithdrawal`, request],\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(request),\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"]}

package/dist/index.cjs

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChompApiService = void 0;
+var chomp_api_service_1 = require("./chomp-api-service.cjs");
+Object.defineProperty(exports, "ChompApiService", { enumerable: true, get: function () { return chomp_api_service_1.ChompApiService; } });
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,6DAAsD;AAA7C,oHAAA,eAAe,OAAA","sourcesContent":["export { ChompApiService } from './chomp-api-service';\nexport type {\n  ChompApiServiceMessenger,\n  ChompApiServiceActions,\n  ChompApiServiceEvents,\n  ChompApiServiceInvalidateQueriesAction,\n  ChompApiServiceCacheUpdatedEvent,\n  ChompApiServiceGranularCacheUpdatedEvent,\n} from './chomp-api-service';\nexport type {\n  ChompApiServiceAssociateAddressAction,\n  ChompApiServiceCreateUpgradeAction,\n  ChompApiServiceGetUpgradeAction,\n  ChompApiServiceVerifyDelegationAction,\n  ChompApiServiceCreateIntentsAction,\n  ChompApiServiceGetIntentsByAddressAction,\n  ChompApiServiceCreateWithdrawalAction,\n} from './chomp-api-service-method-action-types';\nexport type {\n  AssociateAddressRequest,\n  AssociateAddressResponse,\n  CreateUpgradeRequest,\n  CreateWithdrawalRequest,\n  CreateWithdrawalResponse,\n  DelegationCaveat,\n  UpgradeResponse,\n  IntentEntry,\n  IntentMetadataRequest,\n  IntentMetadataResponse,\n  SendIntentRequest,\n  SendIntentResponse,\n  SignedDelegation,\n  VerifyDelegationRequest,\n  VerifyDelegationResponse,\n} from './types';\n"]}