@metamask/subscription-controller 9.0.1 → 10.0.0

package/dist/subscription-delegation/SubscriptionDelegationService-method-action-types.d.ts

@@ -0,0 +1,49 @@
+/**
+ * This file is auto generated.
+ * Do not edit manually.
+ */
+import type { SubscriptionDelegationService } from './SubscriptionDelegationService.js';
+/**
+ * Checks whether the Money Account holds enough convertible mUSD value to
+ * cover pricing `unitAmount × minBillingCyclesForBalance`.
+ *
+ * @param request - Payer address and pricing amount fields.
+ * @returns Balance comparison in mUSD base units (6 decimals).
+ */
+export type SubscriptionDelegationServiceCheckMoneyAccountBalanceAction = {
+    type: `SubscriptionDelegationService:checkMoneyAccountBalance`;
+    handler: SubscriptionDelegationService['checkMoneyAccountBalance'];
+};
+/**
+ * Prepares a cash-subscription delegation and returns its hash.
+ *
+ * Reuses a stored AUS delegation that matches the semantic fingerprint when
+ * one exists (ensuring a CHOMP intent is active for its hash, unless
+ * `skipChompInteractions` is true). Reuse classifies period `startDate` as
+ * trial-deferred (`> now`) vs immediately redeemable, matching creation.
+ * When several records match, the latest period `startDate` is reused
+ * so a `forceNew` replacement is preferred over an older equivalent
+ * permission.
+ * If there is no match, builds, signs, optionally verifies with CHOMP,
+ * persists, and optionally registers a new delegation.
+ *
+ * When `skipChompInteractions` is true (required for alpha), CHOMP verify
+ * and intent calls are skipped; the returned hash is computed locally. The
+ * default CHOMP-enabled path requires a follow-up chomp-api-service release
+ * that accepts `'cash-subscription'` intent metadata.
+ *
+ * @param request - Authoritative pricing and payer details for the delegation.
+ * @param forceNew - Whether to create a replacement instead of reusing a
+ * matching stored delegation.
+ * @returns The delegation hash (CHOMP-verified unless skipped) and whether it
+ * was created or reused.
+ */
+export type SubscriptionDelegationServicePrepareDelegationAction = {
+    type: `SubscriptionDelegationService:prepareDelegation`;
+    handler: SubscriptionDelegationService['prepareDelegation'];
+};
+/**
+ * Union of all SubscriptionDelegationService action types.
+ */
+export type SubscriptionDelegationServiceMethodActions = SubscriptionDelegationServiceCheckMoneyAccountBalanceAction | SubscriptionDelegationServicePrepareDelegationAction;
+//# sourceMappingURL=SubscriptionDelegationService-method-action-types.d.ts.map

package/dist/subscription-delegation/SubscriptionDelegationService-method-action-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubscriptionDelegationService-method-action-types.d.ts","sourceRoot":"","sources":["../../src/subscription-delegation/SubscriptionDelegationService-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AAExF;;;;;;GAMG;AACH,MAAM,MAAM,2DAA2D,GAAG;IACxE,IAAI,EAAE,wDAAwD,CAAC;IAC/D,OAAO,EAAE,6BAA6B,CAAC,0BAA0B,CAAC,CAAC;CACpE,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,MAAM,oDAAoD,GAAG;IACjE,IAAI,EAAE,iDAAiD,CAAC;IACxD,OAAO,EAAE,6BAA6B,CAAC,mBAAmB,CAAC,CAAC;CAC7D,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,0CAA0C,GAClD,2DAA2D,GAC3D,oDAAoD,CAAC"}

package/dist/subscription-delegation/SubscriptionDelegationService-method-action-types.js

@@ -0,0 +1,6 @@
+/**
+ * This file is auto generated.
+ * Do not edit manually.
+ */
+export {};
+//# sourceMappingURL=SubscriptionDelegationService-method-action-types.js.map

package/dist/subscription-delegation/SubscriptionDelegationService-method-action-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubscriptionDelegationService-method-action-types.js","sourceRoot":"","sources":["../../src/subscription-delegation/SubscriptionDelegationService-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated.\n * Do not edit manually.\n */\n\nimport type { SubscriptionDelegationService } from './SubscriptionDelegationService.js';\n\n/**\n * Checks whether the Money Account holds enough convertible mUSD value to\n * cover pricing `unitAmount × minBillingCyclesForBalance`.\n *\n * @param request - Payer address and pricing amount fields.\n * @returns Balance comparison in mUSD base units (6 decimals).\n */\nexport type SubscriptionDelegationServiceCheckMoneyAccountBalanceAction = {\n  type: `SubscriptionDelegationService:checkMoneyAccountBalance`;\n  handler: SubscriptionDelegationService['checkMoneyAccountBalance'];\n};\n\n/**\n * Prepares a cash-subscription delegation and returns its hash.\n *\n * Reuses a stored AUS delegation that matches the semantic fingerprint when\n * one exists (ensuring a CHOMP intent is active for its hash, unless\n * `skipChompInteractions` is true). Reuse classifies period `startDate` as\n * trial-deferred (`> now`) vs immediately redeemable, matching creation.\n * When several records match, the latest period `startDate` is reused\n * so a `forceNew` replacement is preferred over an older equivalent\n * permission.\n * If there is no match, builds, signs, optionally verifies with CHOMP,\n * persists, and optionally registers a new delegation.\n *\n * When `skipChompInteractions` is true (required for alpha), CHOMP verify\n * and intent calls are skipped; the returned hash is computed locally. The\n * default CHOMP-enabled path requires a follow-up chomp-api-service release\n * that accepts `'cash-subscription'` intent metadata.\n *\n * @param request - Authoritative pricing and payer details for the delegation.\n * @param forceNew - Whether to create a replacement instead of reusing a\n * matching stored delegation.\n * @returns The delegation hash (CHOMP-verified unless skipped) and whether it\n * was created or reused.\n */\nexport type SubscriptionDelegationServicePrepareDelegationAction = {\n  type: `SubscriptionDelegationService:prepareDelegation`;\n  handler: SubscriptionDelegationService['prepareDelegation'];\n};\n\n/**\n * Union of all SubscriptionDelegationService action types.\n */\nexport type SubscriptionDelegationServiceMethodActions =\n  | SubscriptionDelegationServiceCheckMoneyAccountBalanceAction\n  | SubscriptionDelegationServicePrepareDelegationAction;\n"]}

package/dist/subscription-delegation/SubscriptionDelegationService.d.ts

@@ -0,0 +1,97 @@
+import type { AuthenticatedUserStorageServiceCreateDelegationAction, AuthenticatedUserStorageServiceListDelegationsAction } from '@metamask/authenticated-user-storage';
+import type { ChompApiServiceCreateIntentsAction, ChompApiServiceGetIntentsByAddressAction, ChompApiServiceVerifyDelegationAction } from '@metamask/chomp-api-service';
+import type { DelegationControllerSignDelegationAction } from '@metamask/delegation-controller';
+import type { Messenger } from '@metamask/messenger';
+import type { MoneyAccountBalanceServiceFetchBalanceWithFallbackAction } from '@metamask/money-account-balance-service';
+import type { RemoteFeatureFlagControllerGetStateAction } from '@metamask/remote-feature-flag-controller';
+import type { SubscriptionControllerGetPricingAction } from '../SubscriptionController-method-action-types.js';
+import type { SubscriptionDelegationServiceMethodActions } from './SubscriptionDelegationService-method-action-types.js';
+import type { MoneyAccountBalanceCheckRequest, MoneyAccountBalanceCheckResult, PrepareSubscriptionDelegationRequest, PreparedSubscriptionDelegation } from './types.js';
+/**
+ * The name of the {@link SubscriptionDelegationService}, used to namespace the
+ * service's actions and events.
+ */
+export declare const serviceName = "SubscriptionDelegationService";
+/**
+ * Actions that {@link SubscriptionDelegationService} exposes to other consumers.
+ */
+export type SubscriptionDelegationServiceActions = SubscriptionDelegationServiceMethodActions;
+/**
+ * Actions from other messengers that {@link SubscriptionDelegationServiceMessenger} calls.
+ */
+type AllowedActions = AuthenticatedUserStorageServiceListDelegationsAction | AuthenticatedUserStorageServiceCreateDelegationAction | ChompApiServiceVerifyDelegationAction | ChompApiServiceCreateIntentsAction | ChompApiServiceGetIntentsByAddressAction | DelegationControllerSignDelegationAction | MoneyAccountBalanceServiceFetchBalanceWithFallbackAction | RemoteFeatureFlagControllerGetStateAction | SubscriptionControllerGetPricingAction;
+/**
+ * Events that {@link SubscriptionDelegationService} exposes to other consumers.
+ */
+export type SubscriptionDelegationServiceEvents = never;
+type AllowedEvents = never;
+/**
+ * The messenger which is restricted to actions and events accessed by
+ * {@link SubscriptionDelegationService}.
+ */
+export type SubscriptionDelegationServiceMessenger = Messenger<typeof serviceName, SubscriptionDelegationServiceActions | AllowedActions, SubscriptionDelegationServiceEvents | AllowedEvents>;
+/**
+ * Options for constructing {@link SubscriptionDelegationService}.
+ */
+export type SubscriptionDelegationServiceOptions = {
+    messenger: SubscriptionDelegationServiceMessenger;
+};
+/**
+ * Stateless orchestrator for cash-subscription delegation setup.
+ *
+ * Owns the workflow: size periodic caveats → sign → CHOMP verify → persist to
+ * Authenticated User Storage → register CHOMP intent. Returns a verified
+ * `delegationHash` for `SubscriptionController.startSubscriptionWithCrypto`.
+ *
+ * Alpha callers must pass `skipChompInteractions: true` until a follow-up
+ * `@metamask/chomp-api-service` release accepts `'cash-subscription'` intent
+ * metadata. The CHOMP-enabled path (`skipChompInteractions` unset/false)
+ * remains dormant and is not production-ready without that package support.
+ *
+ * Each call resolves the Money Account chain from remote feature flags, then
+ * resolves its price, payment token, and delegate from `SubscriptionController`
+ * pricing. The pricing `delegateAddress` is used as the delegation `delegate`.
+ *
+ * Does not own subscription state; `SubscriptionController` does not depend on
+ * this service. Only Money Account Plus is supported.
+ */
+export declare class SubscriptionDelegationService {
+    #private;
+    readonly name: typeof serviceName;
+    constructor(options: SubscriptionDelegationServiceOptions);
+    /**
+     * Checks whether the Money Account holds enough convertible mUSD value to
+     * cover pricing `unitAmount × minBillingCyclesForBalance`.
+     *
+     * @param request - Payer address and pricing amount fields.
+     * @returns Balance comparison in mUSD base units (6 decimals).
+     */
+    checkMoneyAccountBalance(request: MoneyAccountBalanceCheckRequest): Promise<MoneyAccountBalanceCheckResult>;
+    /**
+     * Prepares a cash-subscription delegation and returns its hash.
+     *
+     * Reuses a stored AUS delegation that matches the semantic fingerprint when
+     * one exists (ensuring a CHOMP intent is active for its hash, unless
+     * `skipChompInteractions` is true). Reuse classifies period `startDate` as
+     * trial-deferred (`> now`) vs immediately redeemable, matching creation.
+     * When several records match, the latest period `startDate` is reused
+     * so a `forceNew` replacement is preferred over an older equivalent
+     * permission.
+     * If there is no match, builds, signs, optionally verifies with CHOMP,
+     * persists, and optionally registers a new delegation.
+     *
+     * When `skipChompInteractions` is true (required for alpha), CHOMP verify
+     * and intent calls are skipped; the returned hash is computed locally. The
+     * default CHOMP-enabled path requires a follow-up chomp-api-service release
+     * that accepts `'cash-subscription'` intent metadata.
+     *
+     * @param request - Authoritative pricing and payer details for the delegation.
+     * @param forceNew - Whether to create a replacement instead of reusing a
+     * matching stored delegation.
+     * @returns The delegation hash (CHOMP-verified unless skipped) and whether it
+     * was created or reused.
+     */
+    prepareDelegation(request: PrepareSubscriptionDelegationRequest, forceNew?: boolean): Promise<PreparedSubscriptionDelegation>;
+}
+export {};
+//# sourceMappingURL=SubscriptionDelegationService.d.ts.map

package/dist/subscription-delegation/SubscriptionDelegationService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubscriptionDelegationService.d.ts","sourceRoot":"","sources":["../../src/subscription-delegation/SubscriptionDelegationService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,qDAAqD,EACrD,oDAAoD,EACrD,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EACV,kCAAkC,EAClC,wCAAwC,EACxC,qCAAqC,EACtC,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,wCAAwC,EAAE,MAAM,iCAAiC,CAAC;AAGhG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,wDAAwD,EAAE,MAAM,yCAAyC,CAAC;AAKxH,OAAO,KAAK,EAAE,yCAAyC,EAAE,MAAM,0CAA0C,CAAC;AAK1G,OAAO,KAAK,EAAE,sCAAsC,EAAE,MAAM,kDAAkD,CAAC;AAqB/G,OAAO,KAAK,EAAE,0CAA0C,EAAE,MAAM,wDAAwD,CAAC;AACzH,OAAO,KAAK,EACV,+BAA+B,EAC/B,8BAA8B,EAC9B,oCAAoC,EACpC,8BAA8B,EAE/B,MAAM,YAAY,CAAC;AAGpB;;;GAGG;AACH,eAAO,MAAM,WAAW,kCAAkC,CAAC;AAyB3D;;GAEG;AACH,MAAM,MAAM,oCAAoC,GAC9C,0CAA0C,CAAC;AAE7C;;GAEG;AACH,KAAK,cAAc,GACf,oDAAoD,GACpD,qDAAqD,GACrD,qCAAqC,GACrC,kCAAkC,GAClC,wCAAwC,GACxC,wCAAwC,GACxC,wDAAwD,GACxD,yCAAyC,GACzC,sCAAsC,CAAC;AAE3C;;GAEG;AACH,MAAM,MAAM,mCAAmC,GAAG,KAAK,CAAC;AAExD,KAAK,aAAa,GAAG,KAAK,CAAC;AAE3B;;;GAGG;AACH,MAAM,MAAM,sCAAsC,GAAG,SAAS,CAC5D,OAAO,WAAW,EAClB,oCAAoC,GAAG,cAAc,EACrD,mCAAmC,GAAG,aAAa,CACpD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,oCAAoC,GAAG;IACjD,SAAS,EAAE,sCAAsC,CAAC;CACnD,CAAC;AAmBF;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,6BAA6B;;IACxC,QAAQ,CAAC,IAAI,EAAE,OAAO,WAAW,CAAe;IAIhD,YAAY,OAAO,EAAE,oCAAoC,EAOxD;IAED;;;;;;OAMG;IACG,wBAAwB,CAC5B,OAAO,EAAE,+BAA+B,GACvC,OAAO,CAAC,8BAA8B,CAAC,CAMzC;IA+BD;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,iBAAiB,CACrB,OAAO,EAAE,oCAAoC,EAC7C,QAAQ,UAAQ,GACf,OAAO,CAAC,8BAA8B,CAAC,CA4JzC;CAkJF"}

package/dist/subscription-delegation/SubscriptionDelegationService.js

@@ -0,0 +1,306 @@
+import { hashDelegation } from '@metamask/delegation-core';
+import { DELEGATOR_CONTRACTS } from '@metamask/delegation-deployments';
+import { getMoneyAccountVaultConfig, MUSD_DECIMALS, } from '@metamask/money-account-utils';
+import { add0x, hexToNumber } from '@metamask/utils';
+import { SubscriptionDelegationServiceErrorMessage } from '../constants.js';
+import { CRYPTO_AUTH_METHODS, PAYMENT_TYPES, PRODUCT_TYPES } from '../types.js';
+import { assertPositiveInteger, calculatePeriodAmount, getDelegationStartDate, getPeriodDuration, } from './amount.js';
+import { buildUnsignedSubscriptionDelegation } from './caveats.js';
+import { equalsIgnoreCase, makeMatchesSubscriptionDelegation, pickLatestMatchingSubscriptionDelegation, } from './fingerprint.js';
+import { CASH_SUBSCRIPTION_DELEGATION_TYPE } from './types.js';
+/**
+ * The name of the {@link SubscriptionDelegationService}, used to namespace the
+ * service's actions and events.
+ */
+export const serviceName = 'SubscriptionDelegationService';
+const MESSENGER_EXPOSED_METHODS = [
+    'prepareDelegation',
+    'checkMoneyAccountBalance',
+];
+const DELEGATION_FRAMEWORK_VERSION = '1.3.0';
+function resolveEnforcers(chainId) {
+    const contracts = DELEGATOR_CONTRACTS[DELEGATION_FRAMEWORK_VERSION]?.[hexToNumber(chainId)];
+    if (!contracts?.ValueLteEnforcer || !contracts.ERC20PeriodTransferEnforcer) {
+        throw new Error(`${SubscriptionDelegationServiceErrorMessage.DelegationContractsNotFound}: ${chainId}`);
+    }
+    return {
+        valueLte: contracts.ValueLteEnforcer,
+        erc20TokenPeriodTransfer: contracts.ERC20PeriodTransferEnforcer,
+    };
+}
+/**
+ * Stateless orchestrator for cash-subscription delegation setup.
+ *
+ * Owns the workflow: size periodic caveats → sign → CHOMP verify → persist to
+ * Authenticated User Storage → register CHOMP intent. Returns a verified
+ * `delegationHash` for `SubscriptionController.startSubscriptionWithCrypto`.
+ *
+ * Alpha callers must pass `skipChompInteractions: true` until a follow-up
+ * `@metamask/chomp-api-service` release accepts `'cash-subscription'` intent
+ * metadata. The CHOMP-enabled path (`skipChompInteractions` unset/false)
+ * remains dormant and is not production-ready without that package support.
+ *
+ * Each call resolves the Money Account chain from remote feature flags, then
+ * resolves its price, payment token, and delegate from `SubscriptionController`
+ * pricing. The pricing `delegateAddress` is used as the delegation `delegate`.
+ *
+ * Does not own subscription state; `SubscriptionController` does not depend on
+ * this service. Only Money Account Plus is supported.
+ */
+export class SubscriptionDelegationService {
+    name = serviceName;
+    #messenger;
+    constructor(options) {
+        this.#messenger = options.messenger;
+        this.#messenger.registerMethodActionHandlers(this, MESSENGER_EXPOSED_METHODS);
+    }
+    /**
+     * Checks whether the Money Account holds enough convertible mUSD value to
+     * cover pricing `unitAmount × minBillingCyclesForBalance`.
+     *
+     * @param request - Payer address and pricing amount fields.
+     * @returns Balance comparison in mUSD base units (6 decimals).
+     */
+    async checkMoneyAccountBalance(request) {
+        const { price } = await this.#resolveConfiguration(request.product, request.recurringInterval);
+        return this.#compareMoneyAccountBalance(request.payerAddress, price);
+    }
+    async #compareMoneyAccountBalance(payerAddress, price) {
+        assertPositiveInteger(price.minBillingCyclesForBalance, SubscriptionDelegationServiceErrorMessage.InvalidMinimumFundingCycles);
+        const periodAmount = calculatePeriodAmount({
+            unitAmount: price.unitAmount,
+            unitDecimals: price.unitDecimals,
+            tokenDecimals: MUSD_DECIMALS,
+        });
+        const requiredBalance = periodAmount * BigInt(price.minBillingCyclesForBalance);
+        const { totalBalance } = await this.#messenger.call('MoneyAccountBalanceService:fetchBalanceWithFallback', payerAddress);
+        return {
+            hasSufficientBalance: BigInt(totalBalance) >= requiredBalance,
+            balance: totalBalance,
+            requiredBalance: requiredBalance.toString(),
+        };
+    }
+    /**
+     * Prepares a cash-subscription delegation and returns its hash.
+     *
+     * Reuses a stored AUS delegation that matches the semantic fingerprint when
+     * one exists (ensuring a CHOMP intent is active for its hash, unless
+     * `skipChompInteractions` is true). Reuse classifies period `startDate` as
+     * trial-deferred (`> now`) vs immediately redeemable, matching creation.
+     * When several records match, the latest period `startDate` is reused
+     * so a `forceNew` replacement is preferred over an older equivalent
+     * permission.
+     * If there is no match, builds, signs, optionally verifies with CHOMP,
+     * persists, and optionally registers a new delegation.
+     *
+     * When `skipChompInteractions` is true (required for alpha), CHOMP verify
+     * and intent calls are skipped; the returned hash is computed locally. The
+     * default CHOMP-enabled path requires a follow-up chomp-api-service release
+     * that accepts `'cash-subscription'` intent metadata.
+     *
+     * @param request - Authoritative pricing and payer details for the delegation.
+     * @param forceNew - Whether to create a replacement instead of reusing a
+     * matching stored delegation.
+     * @returns The delegation hash (CHOMP-verified unless skipped) and whether it
+     * was created or reused.
+     */
+    async prepareDelegation(request, forceNew = false) {
+        if (request.product !== PRODUCT_TYPES.MONEY_ACCOUNT_PLUS) {
+            throw new Error(SubscriptionDelegationServiceErrorMessage.UnsupportedProduct);
+        }
+        const skipChomp = Boolean(request.skipChompInteractions);
+        const { chainId, delegateAddress, enforcers, price, token } = await this.#resolveConfiguration(request.product, request.recurringInterval);
+        if (request.checkBalance) {
+            const { hasSufficientBalance } = await this.#compareMoneyAccountBalance(request.payerAddress, price);
+            if (!hasSufficientBalance) {
+                throw new Error(SubscriptionDelegationServiceErrorMessage.InsufficientBalance);
+            }
+        }
+        const periodAmount = calculatePeriodAmount({
+            unitAmount: price.unitAmount,
+            unitDecimals: price.unitDecimals,
+            tokenDecimals: token.decimals,
+        });
+        const periodDuration = getPeriodDuration(request.recurringInterval);
+        const nowSeconds = Math.floor(Date.now() / 1000);
+        const startDate = getDelegationStartDate({
+            nowSeconds,
+            trialPeriodDays: request.isTrialRequested
+                ? price.trialPeriodDays
+                : undefined,
+        });
+        const isTrialDeferred = startDate > nowSeconds;
+        const reusable = forceNew
+            ? undefined
+            : await this.#findReusableDelegation({
+                request,
+                chainId,
+                delegateAddress,
+                tokenAddress: token.address,
+                periodAmount,
+                periodDuration,
+                nowSeconds,
+                isTrialDeferred,
+                enforcers,
+            });
+        if (reusable) {
+            if (!skipChomp) {
+                await this.#ensureIntent({
+                    account: request.payerAddress,
+                    chainId,
+                    delegationHash: reusable.metadata.delegationHash,
+                    allowance: reusable.metadata.allowance,
+                    tokenSymbol: reusable.metadata.tokenSymbol,
+                    tokenAddress: reusable.metadata.tokenAddress,
+                });
+            }
+            return {
+                delegationHash: reusable.metadata.delegationHash,
+                disposition: 'reused',
+            };
+        }
+        const unsigned = buildUnsignedSubscriptionDelegation({
+            delegateAddress,
+            delegatorAddress: request.payerAddress,
+            enforcers,
+            tokenAddress: token.address,
+            periodAmount,
+            periodDuration,
+            startDate,
+        });
+        const signature = (await this.#messenger.call('DelegationController:signDelegation', { delegation: unsigned, chainId }));
+        const signedDelegation = { ...unsigned, signature };
+        const delegationHash = hashDelegation({
+            ...unsigned,
+            salt: BigInt(unsigned.salt),
+            signature,
+        });
+        if (!skipChomp) {
+            const verifyResult = await this.#messenger.call('ChompApiService:verifyDelegation', {
+                signedDelegation,
+                chainId,
+            });
+            if (!verifyResult.valid) {
+                throw new Error(`${SubscriptionDelegationServiceErrorMessage.ChompRejectedDelegation}: ${verifyResult.errors?.join(', ') ?? 'unknown error'}`);
+            }
+            if (!verifyResult.delegationHash) {
+                throw new Error(SubscriptionDelegationServiceErrorMessage.ChompMissingDelegationHash);
+            }
+            if (!equalsIgnoreCase(verifyResult.delegationHash, delegationHash)) {
+                throw new Error(SubscriptionDelegationServiceErrorMessage.ChompDelegationHashMismatch);
+            }
+        }
+        const allowance = add0x(periodAmount.toString(16));
+        await this.#messenger.call('AuthenticatedUserStorageService:createDelegation', {
+            signedDelegation,
+            metadata: {
+                delegationHash,
+                chainIdHex: chainId,
+                allowance,
+                tokenSymbol: token.symbol,
+                tokenAddress: token.address,
+                type: CASH_SUBSCRIPTION_DELEGATION_TYPE,
+            },
+        });
+        if (!skipChomp) {
+            await this.#createIntent({
+                account: request.payerAddress,
+                chainId,
+                delegationHash,
+                allowance,
+                tokenSymbol: token.symbol,
+                tokenAddress: token.address,
+            });
+        }
+        return {
+            delegationHash,
+            disposition: 'created',
+        };
+    }
+    async #findReusableDelegation({ request, chainId, delegateAddress, tokenAddress, periodAmount, periodDuration, nowSeconds, isTrialDeferred, enforcers, }) {
+        const matches = makeMatchesSubscriptionDelegation({
+            delegatorAddress: request.payerAddress,
+            delegateAddress,
+            chainId,
+            tokenAddress,
+            periodAmount,
+            periodDuration,
+            nowSeconds,
+            isTrialDeferred,
+            enforcers,
+        });
+        const existingDelegations = await this.#messenger.call('AuthenticatedUserStorageService:listDelegations');
+        return pickLatestMatchingSubscriptionDelegation(existingDelegations.filter(matches), enforcers);
+    }
+    async #resolveConfiguration(product, recurringInterval) {
+        const { remoteFeatureFlags } = this.#messenger.call('RemoteFeatureFlagController:getState');
+        const vaultConfig = getMoneyAccountVaultConfig(remoteFeatureFlags);
+        if (!vaultConfig) {
+            throw new Error(SubscriptionDelegationServiceErrorMessage.MissingMoneyAccountVaultConfig);
+        }
+        const { chainId } = vaultConfig;
+        const enforcers = resolveEnforcers(chainId);
+        const pricing = await this.#messenger.call('SubscriptionController:getPricing');
+        const price = pricing.products
+            .find((entry) => entry.name === product)
+            ?.prices?.find((entry) => entry.interval === recurringInterval);
+        const paymentMethod = pricing.paymentMethods.find((entry) => entry.type === PAYMENT_TYPES.byCrypto &&
+            entry.cryptoAuthMethod === CRYPTO_AUTH_METHODS.DELEGATION &&
+            entry.products?.includes(product) === true);
+        const chain = paymentMethod?.chains?.find((entry) => entry.chainId === chainId);
+        const token = chain?.tokens[0];
+        if (!price || !chain?.delegateAddress || !token) {
+            throw new Error(SubscriptionDelegationServiceErrorMessage.PricingConfigurationNotFound);
+        }
+        return {
+            chainId,
+            delegateAddress: chain.delegateAddress,
+            enforcers,
+            price,
+            token,
+        };
+    }
+    /**
+     * Ensures an active CHOMP intent exists for the given delegation hash,
+     * registering one when missing or revoked.
+     *
+     * @param params - Intent identity and metadata.
+     * @param params.account - Delegator / payer address.
+     * @param params.chainId - Chain ID of the delegation.
+     * @param params.delegationHash - Hash of the stored delegation.
+     * @param params.allowance - Period allowance stored with the delegation.
+     * @param params.tokenSymbol - Payment token symbol.
+     * @param params.tokenAddress - Payment token address.
+     */
+    async #ensureIntent(params) {
+        const existingIntents = await this.#messenger.call('ChompApiService:getIntentsByAddress', params.account);
+        const hasActiveIntent = existingIntents.some((intent) => equalsIgnoreCase(intent.delegationHash, params.delegationHash) &&
+            intent.status === 'active');
+        if (hasActiveIntent) {
+            return;
+        }
+        await this.#createIntent(params);
+    }
+    async #createIntent(params) {
+        // Published `@metamask/chomp-api-service` only types intent metadata as
+        // `'cash-deposit' | 'cash-withdrawal'`. The dormant production path still
+        // passes `'cash-subscription'`; a follow-up chomp-api-service release must
+        // accept that discriminator before this path is production-ready. Alpha
+        // callers must use `skipChompInteractions: true` so this method is not
+        // reached.
+        await this.#messenger.call('ChompApiService:createIntents', [
+            {
+                account: params.account,
+                delegationHash: params.delegationHash,
+                chainId: params.chainId,
+                metadata: {
+                    allowance: params.allowance,
+                    tokenSymbol: params.tokenSymbol,
+                    tokenAddress: params.tokenAddress,
+                    type: CASH_SUBSCRIPTION_DELEGATION_TYPE,
+                },
+            },
+        ]);
+    }
+}
+//# sourceMappingURL=SubscriptionDelegationService.js.map

package/dist/subscription-delegation/SubscriptionDelegationService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubscriptionDelegationService.js","sourceRoot":"","sources":["../../src/subscription-delegation/SubscriptionDelegationService.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAGvE,OAAO,EACL,0BAA0B,EAC1B,aAAa,GACd,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGrD,OAAO,EAAE,yCAAyC,EAAE,MAAM,iBAAiB,CAAC;AAE5E,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAQhF,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,mCAAmC,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EACL,gBAAgB,EAChB,iCAAiC,EACjC,wCAAwC,GACzC,MAAM,kBAAkB,CAAC;AAS1B,OAAO,EAAE,iCAAiC,EAAE,MAAM,YAAY,CAAC;AAE/D;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,+BAA+B,CAAC;AAE3D,MAAM,yBAAyB,GAAG;IAChC,mBAAmB;IACnB,0BAA0B;CAClB,CAAC;AAEX,MAAM,4BAA4B,GAAG,OAAO,CAAC;AAE7C,SAAS,gBAAgB,CAAC,OAAY;IACpC,MAAM,SAAS,GACb,mBAAmB,CAAC,4BAA4B,CAAC,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;IAE5E,IAAI,CAAC,SAAS,EAAE,gBAAgB,IAAI,CAAC,SAAS,CAAC,2BAA2B,EAAE,CAAC;QAC3E,MAAM,IAAI,KAAK,CACb,GAAG,yCAAyC,CAAC,2BAA2B,KAAK,OAAO,EAAE,CACvF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,SAAS,CAAC,gBAAgB;QACpC,wBAAwB,EAAE,SAAS,CAAC,2BAA2B;KAChE,CAAC;AACJ,CAAC;AA+DD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,6BAA6B;IAC/B,IAAI,GAAuB,WAAW,CAAC;IAEvC,UAAU,CAAyC;IAE5D,YAAY,OAA6C;QACvD,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;QAEpC,IAAI,CAAC,UAAU,CAAC,4BAA4B,CAC1C,IAAI,EACJ,yBAAyB,CAC1B,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,wBAAwB,CAC5B,OAAwC;QAExC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAChD,OAAO,CAAC,OAAO,EACf,OAAO,CAAC,iBAAiB,CAC1B,CAAC;QACF,OAAO,IAAI,CAAC,2BAA2B,CAAC,OAAO,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IACvE,CAAC;IAED,KAAK,CAAC,2BAA2B,CAC/B,YAAiB,EACjB,KAAmB;QAEnB,qBAAqB,CACnB,KAAK,CAAC,0BAA0B,EAChC,yCAAyC,CAAC,2BAA2B,CACtE,CAAC;QAEF,MAAM,YAAY,GAAG,qBAAqB,CAAC;YACzC,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,aAAa,EAAE,aAAa;SAC7B,CAAC,CAAC;QACH,MAAM,eAAe,GACnB,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAE1D,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CACjD,qDAAqD,EACrD,YAAY,CACb,CAAC;QAEF,OAAO;YACL,oBAAoB,EAAE,MAAM,CAAC,YAAY,CAAC,IAAI,eAAe;YAC7D,OAAO,EAAE,YAAY;YACrB,eAAe,EAAE,eAAe,CAAC,QAAQ,EAAE;SAC5C,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,KAAK,CAAC,iBAAiB,CACrB,OAA6C,EAC7C,QAAQ,GAAG,KAAK;QAEhB,IAAI,OAAO,CAAC,OAAO,KAAK,aAAa,CAAC,kBAAkB,EAAE,CAAC;YACzD,MAAM,IAAI,KAAK,CACb,yCAAyC,CAAC,kBAAkB,CAC7D,CAAC;QACJ,CAAC;QAED,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;QAEzD,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,GACzD,MAAM,IAAI,CAAC,qBAAqB,CAC9B,OAAO,CAAC,OAAO,EACf,OAAO,CAAC,iBAAiB,CAC1B,CAAC;QAEJ,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;YACzB,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,IAAI,CAAC,2BAA2B,CACrE,OAAO,CAAC,YAAY,EACpB,KAAK,CACN,CAAC;YACF,IAAI,CAAC,oBAAoB,EAAE,CAAC;gBAC1B,MAAM,IAAI,KAAK,CACb,yCAAyC,CAAC,mBAAmB,CAC9D,CAAC;YACJ,CAAC;QACH,CAAC;QAED,MAAM,YAAY,GAAG,qBAAqB,CAAC;YACzC,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,aAAa,EAAE,KAAK,CAAC,QAAQ;SAC9B,CAAC,CAAC;QACH,MAAM,cAAc,GAAG,iBAAiB,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;QACpE,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;QACjD,MAAM,SAAS,GAAG,sBAAsB,CAAC;YACvC,UAAU;YACV,eAAe,EAAE,OAAO,CAAC,gBAAgB;gBACvC,CAAC,CAAC,KAAK,CAAC,eAAe;gBACvB,CAAC,CAAC,SAAS;SACd,CAAC,CAAC;QACH,MAAM,eAAe,GAAG,SAAS,GAAG,UAAU,CAAC;QAE/C,MAAM,QAAQ,GAAG,QAAQ;YACvB,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,MAAM,IAAI,CAAC,uBAAuB,CAAC;gBACjC,OAAO;gBACP,OAAO;gBACP,eAAe;gBACf,YAAY,EAAE,KAAK,CAAC,OAAO;gBAC3B,YAAY;gBACZ,cAAc;gBACd,UAAU;gBACV,eAAe;gBACf,SAAS;aACV,CAAC,CAAC;QACP,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,MAAM,IAAI,CAAC,aAAa,CAAC;oBACvB,OAAO,EAAE,OAAO,CAAC,YAAY;oBAC7B,OAAO;oBACP,cAAc,EAAE,QAAQ,CAAC,QAAQ,CAAC,cAAc;oBAChD,SAAS,EAAE,QAAQ,CAAC,QAAQ,CAAC,SAAS;oBACtC,WAAW,EAAE,QAAQ,CAAC,QAAQ,CAAC,WAAW;oBAC1C,YAAY,EAAE,QAAQ,CAAC,QAAQ,CAAC,YAAY;iBAC7C,CAAC,CAAC;YACL,CAAC;YACD,OAAO;gBACL,cAAc,EAAE,QAAQ,CAAC,QAAQ,CAAC,cAAc;gBAChD,WAAW,EAAE,QAAQ;aACtB,CAAC;QACJ,CAAC;QAED,MAAM,QAAQ,GAAG,mCAAmC,CAAC;YACnD,eAAe;YACf,gBAAgB,EAAE,OAAO,CAAC,YAAY;YACtC,SAAS;YACT,YAAY,EAAE,KAAK,CAAC,OAAO;YAC3B,YAAY;YACZ,cAAc;YACd,SAAS;SACV,CAAC,CAAC;QAEH,MAAM,SAAS,GAAG,CAAC,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAC3C,qCAAqC,EACrC,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,CAClC,CAAQ,CAAC;QAEV,MAAM,gBAAgB,GAAG,EAAE,GAAG,QAAQ,EAAE,SAAS,EAAE,CAAC;QAEpD,MAAM,cAAc,GAAG,cAAc,CAAC;YACpC,GAAG,QAAQ;YACX,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;YAC3B,SAAS;SACV,CAAC,CAAC;QAEH,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAC7C,kCAAkC,EAClC;gBACE,gBAAgB;gBAChB,OAAO;aACR,CACF,CAAC;YAEF,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;gBACxB,MAAM,IAAI,KAAK,CACb,GAAG,yCAAyC,CAAC,uBAAuB,KAClE,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,eACrC,EAAE,CACH,CAAC;YACJ,CAAC;YAED,IAAI,CAAC,YAAY,CAAC,cAAc,EAAE,CAAC;gBACjC,MAAM,IAAI,KAAK,CACb,yCAAyC,CAAC,0BAA0B,CACrE,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,gBAAgB,CAAC,YAAY,CAAC,cAAc,EAAE,cAAc,CAAC,EAAE,CAAC;gBACnE,MAAM,IAAI,KAAK,CACb,yCAAyC,CAAC,2BAA2B,CACtE,CAAC;YACJ,CAAC;QACH,CAAC;QAED,MAAM,SAAS,GAAQ,KAAK,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;QAExD,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CACxB,kDAAkD,EAClD;YACE,gBAAgB;YAChB,QAAQ,EAAE;gBACR,cAAc;gBACd,UAAU,EAAE,OAAO;gBACnB,SAAS;gBACT,WAAW,EAAE,KAAK,CAAC,MAAM;gBACzB,YAAY,EAAE,KAAK,CAAC,OAAO;gBAC3B,IAAI,EAAE,iCAAiC;aACxC;SACF,CACF,CAAC;QAEF,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,CAAC,aAAa,CAAC;gBACvB,OAAO,EAAE,OAAO,CAAC,YAAY;gBAC7B,OAAO;gBACP,cAAc;gBACd,SAAS;gBACT,WAAW,EAAE,KAAK,CAAC,MAAM;gBACzB,YAAY,EAAE,KAAK,CAAC,OAAO;aAC5B,CAAC,CAAC;QACL,CAAC;QAED,OAAO;YACL,cAAc;YACd,WAAW,EAAE,SAAS;SACvB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,uBAAuB,CAAC,EAC5B,OAAO,EACP,OAAO,EACP,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,UAAU,EACV,eAAe,EACf,SAAS,GAWV;QACC,MAAM,OAAO,GAAG,iCAAiC,CAAC;YAChD,gBAAgB,EAAE,OAAO,CAAC,YAAY;YACtC,eAAe;YACf,OAAO;YACP,YAAY;YACZ,YAAY;YACZ,cAAc;YACd,UAAU;YACV,eAAe;YACf,SAAS;SACV,CAAC,CAAC;QAEH,MAAM,mBAAmB,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CACpD,iDAAiD,CAClD,CAAC;QAEF,OAAO,wCAAwC,CAC7C,mBAAmB,CAAC,MAAM,CAAC,OAAO,CAAC,EACnC,SAAS,CACV,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,qBAAqB,CACzB,OAAoB,EACpB,iBAAoC;QAEpC,MAAM,EAAE,kBAAkB,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CACjD,sCAAsC,CACvC,CAAC;QACF,MAAM,WAAW,GAAG,0BAA0B,CAAC,kBAAkB,CAAC,CAAC;QACnE,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CACb,yCAAyC,CAAC,8BAA8B,CACzE,CAAC;QACJ,CAAC;QAED,MAAM,EAAE,OAAO,EAAE,GAAG,WAAW,CAAC;QAChC,MAAM,SAAS,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAC5C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CACxC,mCAAmC,CACpC,CAAC;QACF,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ;aAC3B,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC;YACxC,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,iBAAiB,CAAC,CAAC;QAClE,MAAM,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,IAAI,CAC/C,CAAC,KAAK,EAAuC,EAAE,CAC7C,KAAK,CAAC,IAAI,KAAK,aAAa,CAAC,QAAQ;YACrC,KAAK,CAAC,gBAAgB,KAAK,mBAAmB,CAAC,UAAU;YACzD,KAAK,CAAC,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,KAAK,IAAI,CAC7C,CAAC;QACF,MAAM,KAAK,GAAG,aAAa,EAAE,MAAM,EAAE,IAAI,CACvC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,KAAK,OAAO,CACrC,CAAC;QACF,MAAM,KAAK,GAAG,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;QAC/B,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,EAAE,eAAe,IAAI,CAAC,KAAK,EAAE,CAAC;YAChD,MAAM,IAAI,KAAK,CACb,yCAAyC,CAAC,4BAA4B,CACvE,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO;YACP,eAAe,EAAE,KAAK,CAAC,eAAe;YACtC,SAAS;YACT,KAAK;YACL,KAAK;SACN,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,aAAa,CAAC,MAAgC;QAClD,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAChD,qCAAqC,EACrC,MAAM,CAAC,OAAO,CACf,CAAC;QAEF,MAAM,eAAe,GAAG,eAAe,CAAC,IAAI,CAC1C,CAAC,MAAM,EAAE,EAAE,CACT,gBAAgB,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,cAAc,CAAC;YAC9D,MAAM,CAAC,MAAM,KAAK,QAAQ,CAC7B,CAAC;QAEF,IAAI,eAAe,EAAE,CAAC;YACpB,OAAO;QACT,CAAC;QAED,MAAM,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,MAAgC;QAClD,wEAAwE;QACxE,0EAA0E;QAC1E,2EAA2E;QAC3E,wEAAwE;QACxE,uEAAuE;QACvE,WAAW;QACX,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,+BAA+B,EAAE;YAC1D;gBACE,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,cAAc,EAAE,MAAM,CAAC,cAAc;gBACrC,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,QAAQ,EAAE;oBACR,SAAS,EAAE,MAAM,CAAC,SAAS;oBAC3B,WAAW,EAAE,MAAM,CAAC,WAAW;oBAC/B,YAAY,EAAE,MAAM,CAAC,YAAY;oBACjC,IAAI,EAAE,iCAEe;iBACtB;aACF;SACF,CAAC,CAAC;IACL,CAAC;CACF","sourcesContent":["import type {\n  DelegationResponse,\n  AuthenticatedUserStorageServiceCreateDelegationAction,\n  AuthenticatedUserStorageServiceListDelegationsAction,\n} from '@metamask/authenticated-user-storage';\nimport type {\n  ChompApiServiceCreateIntentsAction,\n  ChompApiServiceGetIntentsByAddressAction,\n  ChompApiServiceVerifyDelegationAction,\n} from '@metamask/chomp-api-service';\nimport type { DelegationControllerSignDelegationAction } from '@metamask/delegation-controller';\nimport { hashDelegation } from '@metamask/delegation-core';\nimport { DELEGATOR_CONTRACTS } from '@metamask/delegation-deployments';\nimport type { Messenger } from '@metamask/messenger';\nimport type { MoneyAccountBalanceServiceFetchBalanceWithFallbackAction } from '@metamask/money-account-balance-service';\nimport {\n  getMoneyAccountVaultConfig,\n  MUSD_DECIMALS,\n} from '@metamask/money-account-utils';\nimport type { RemoteFeatureFlagControllerGetStateAction } from '@metamask/remote-feature-flag-controller';\nimport { add0x, hexToNumber } from '@metamask/utils';\nimport type { Hex } from '@metamask/utils';\n\nimport { SubscriptionDelegationServiceErrorMessage } from '../constants.js';\nimport type { SubscriptionControllerGetPricingAction } from '../SubscriptionController-method-action-types.js';\nimport { CRYPTO_AUTH_METHODS, PAYMENT_TYPES, PRODUCT_TYPES } from '../types.js';\nimport type {\n  ProductPrice,\n  ProductType,\n  PricingCryptoPaymentMethod,\n  RecurringInterval,\n  TokenPaymentInfo,\n} from '../types.js';\nimport {\n  assertPositiveInteger,\n  calculatePeriodAmount,\n  getDelegationStartDate,\n  getPeriodDuration,\n} from './amount.js';\nimport { buildUnsignedSubscriptionDelegation } from './caveats.js';\nimport {\n  equalsIgnoreCase,\n  makeMatchesSubscriptionDelegation,\n  pickLatestMatchingSubscriptionDelegation,\n} from './fingerprint.js';\nimport type { SubscriptionDelegationServiceMethodActions } from './SubscriptionDelegationService-method-action-types.js';\nimport type {\n  MoneyAccountBalanceCheckRequest,\n  MoneyAccountBalanceCheckResult,\n  PrepareSubscriptionDelegationRequest,\n  PreparedSubscriptionDelegation,\n  SubscriptionDelegationEnforcers,\n} from './types.js';\nimport { CASH_SUBSCRIPTION_DELEGATION_TYPE } from './types.js';\n\n/**\n * The name of the {@link SubscriptionDelegationService}, used to namespace the\n * service's actions and events.\n */\nexport const serviceName = 'SubscriptionDelegationService';\n\nconst MESSENGER_EXPOSED_METHODS = [\n  'prepareDelegation',\n  'checkMoneyAccountBalance',\n] as const;\n\nconst DELEGATION_FRAMEWORK_VERSION = '1.3.0';\n\nfunction resolveEnforcers(chainId: Hex): SubscriptionDelegationEnforcers {\n  const contracts =\n    DELEGATOR_CONTRACTS[DELEGATION_FRAMEWORK_VERSION]?.[hexToNumber(chainId)];\n\n  if (!contracts?.ValueLteEnforcer || !contracts.ERC20PeriodTransferEnforcer) {\n    throw new Error(\n      `${SubscriptionDelegationServiceErrorMessage.DelegationContractsNotFound}: ${chainId}`,\n    );\n  }\n\n  return {\n    valueLte: contracts.ValueLteEnforcer,\n    erc20TokenPeriodTransfer: contracts.ERC20PeriodTransferEnforcer,\n  };\n}\n\n/**\n * Actions that {@link SubscriptionDelegationService} exposes to other consumers.\n */\nexport type SubscriptionDelegationServiceActions =\n  SubscriptionDelegationServiceMethodActions;\n\n/**\n * Actions from other messengers that {@link SubscriptionDelegationServiceMessenger} calls.\n */\ntype AllowedActions =\n  | AuthenticatedUserStorageServiceListDelegationsAction\n  | AuthenticatedUserStorageServiceCreateDelegationAction\n  | ChompApiServiceVerifyDelegationAction\n  | ChompApiServiceCreateIntentsAction\n  | ChompApiServiceGetIntentsByAddressAction\n  | DelegationControllerSignDelegationAction\n  | MoneyAccountBalanceServiceFetchBalanceWithFallbackAction\n  | RemoteFeatureFlagControllerGetStateAction\n  | SubscriptionControllerGetPricingAction;\n\n/**\n * Events that {@link SubscriptionDelegationService} exposes to other consumers.\n */\nexport type SubscriptionDelegationServiceEvents = never;\n\ntype AllowedEvents = never;\n\n/**\n * The messenger which is restricted to actions and events accessed by\n * {@link SubscriptionDelegationService}.\n */\nexport type SubscriptionDelegationServiceMessenger = Messenger<\n  typeof serviceName,\n  SubscriptionDelegationServiceActions | AllowedActions,\n  SubscriptionDelegationServiceEvents | AllowedEvents\n>;\n\n/**\n * Options for constructing {@link SubscriptionDelegationService}.\n */\nexport type SubscriptionDelegationServiceOptions = {\n  messenger: SubscriptionDelegationServiceMessenger;\n};\n\ntype SubscriptionIntentParams = {\n  account: Hex;\n  chainId: Hex;\n  delegationHash: Hex;\n  allowance: Hex;\n  tokenSymbol: string;\n  tokenAddress: Hex;\n};\n\ntype ResolvedSubscriptionDelegationConfig = {\n  chainId: Hex;\n  delegateAddress: Hex;\n  enforcers: SubscriptionDelegationEnforcers;\n  price: ProductPrice;\n  token: TokenPaymentInfo;\n};\n\n/**\n * Stateless orchestrator for cash-subscription delegation setup.\n *\n * Owns the workflow: size periodic caveats → sign → CHOMP verify → persist to\n * Authenticated User Storage → register CHOMP intent. Returns a verified\n * `delegationHash` for `SubscriptionController.startSubscriptionWithCrypto`.\n *\n * Alpha callers must pass `skipChompInteractions: true` until a follow-up\n * `@metamask/chomp-api-service` release accepts `'cash-subscription'` intent\n * metadata. The CHOMP-enabled path (`skipChompInteractions` unset/false)\n * remains dormant and is not production-ready without that package support.\n *\n * Each call resolves the Money Account chain from remote feature flags, then\n * resolves its price, payment token, and delegate from `SubscriptionController`\n * pricing. The pricing `delegateAddress` is used as the delegation `delegate`.\n *\n * Does not own subscription state; `SubscriptionController` does not depend on\n * this service. Only Money Account Plus is supported.\n */\nexport class SubscriptionDelegationService {\n  readonly name: typeof serviceName = serviceName;\n\n  readonly #messenger: SubscriptionDelegationServiceMessenger;\n\n  constructor(options: SubscriptionDelegationServiceOptions) {\n    this.#messenger = options.messenger;\n\n    this.#messenger.registerMethodActionHandlers(\n      this,\n      MESSENGER_EXPOSED_METHODS,\n    );\n  }\n\n  /**\n   * Checks whether the Money Account holds enough convertible mUSD value to\n   * cover pricing `unitAmount × minBillingCyclesForBalance`.\n   *\n   * @param request - Payer address and pricing amount fields.\n   * @returns Balance comparison in mUSD base units (6 decimals).\n   */\n  async checkMoneyAccountBalance(\n    request: MoneyAccountBalanceCheckRequest,\n  ): Promise<MoneyAccountBalanceCheckResult> {\n    const { price } = await this.#resolveConfiguration(\n      request.product,\n      request.recurringInterval,\n    );\n    return this.#compareMoneyAccountBalance(request.payerAddress, price);\n  }\n\n  async #compareMoneyAccountBalance(\n    payerAddress: Hex,\n    price: ProductPrice,\n  ): Promise<MoneyAccountBalanceCheckResult> {\n    assertPositiveInteger(\n      price.minBillingCyclesForBalance,\n      SubscriptionDelegationServiceErrorMessage.InvalidMinimumFundingCycles,\n    );\n\n    const periodAmount = calculatePeriodAmount({\n      unitAmount: price.unitAmount,\n      unitDecimals: price.unitDecimals,\n      tokenDecimals: MUSD_DECIMALS,\n    });\n    const requiredBalance =\n      periodAmount * BigInt(price.minBillingCyclesForBalance);\n\n    const { totalBalance } = await this.#messenger.call(\n      'MoneyAccountBalanceService:fetchBalanceWithFallback',\n      payerAddress,\n    );\n\n    return {\n      hasSufficientBalance: BigInt(totalBalance) >= requiredBalance,\n      balance: totalBalance,\n      requiredBalance: requiredBalance.toString(),\n    };\n  }\n\n  /**\n   * Prepares a cash-subscription delegation and returns its hash.\n   *\n   * Reuses a stored AUS delegation that matches the semantic fingerprint when\n   * one exists (ensuring a CHOMP intent is active for its hash, unless\n   * `skipChompInteractions` is true). Reuse classifies period `startDate` as\n   * trial-deferred (`> now`) vs immediately redeemable, matching creation.\n   * When several records match, the latest period `startDate` is reused\n   * so a `forceNew` replacement is preferred over an older equivalent\n   * permission.\n   * If there is no match, builds, signs, optionally verifies with CHOMP,\n   * persists, and optionally registers a new delegation.\n   *\n   * When `skipChompInteractions` is true (required for alpha), CHOMP verify\n   * and intent calls are skipped; the returned hash is computed locally. The\n   * default CHOMP-enabled path requires a follow-up chomp-api-service release\n   * that accepts `'cash-subscription'` intent metadata.\n   *\n   * @param request - Authoritative pricing and payer details for the delegation.\n   * @param forceNew - Whether to create a replacement instead of reusing a\n   * matching stored delegation.\n   * @returns The delegation hash (CHOMP-verified unless skipped) and whether it\n   * was created or reused.\n   */\n  async prepareDelegation(\n    request: PrepareSubscriptionDelegationRequest,\n    forceNew = false,\n  ): Promise<PreparedSubscriptionDelegation> {\n    if (request.product !== PRODUCT_TYPES.MONEY_ACCOUNT_PLUS) {\n      throw new Error(\n        SubscriptionDelegationServiceErrorMessage.UnsupportedProduct,\n      );\n    }\n\n    const skipChomp = Boolean(request.skipChompInteractions);\n\n    const { chainId, delegateAddress, enforcers, price, token } =\n      await this.#resolveConfiguration(\n        request.product,\n        request.recurringInterval,\n      );\n\n    if (request.checkBalance) {\n      const { hasSufficientBalance } = await this.#compareMoneyAccountBalance(\n        request.payerAddress,\n        price,\n      );\n      if (!hasSufficientBalance) {\n        throw new Error(\n          SubscriptionDelegationServiceErrorMessage.InsufficientBalance,\n        );\n      }\n    }\n\n    const periodAmount = calculatePeriodAmount({\n      unitAmount: price.unitAmount,\n      unitDecimals: price.unitDecimals,\n      tokenDecimals: token.decimals,\n    });\n    const periodDuration = getPeriodDuration(request.recurringInterval);\n    const nowSeconds = Math.floor(Date.now() / 1000);\n    const startDate = getDelegationStartDate({\n      nowSeconds,\n      trialPeriodDays: request.isTrialRequested\n        ? price.trialPeriodDays\n        : undefined,\n    });\n    const isTrialDeferred = startDate > nowSeconds;\n\n    const reusable = forceNew\n      ? undefined\n      : await this.#findReusableDelegation({\n          request,\n          chainId,\n          delegateAddress,\n          tokenAddress: token.address,\n          periodAmount,\n          periodDuration,\n          nowSeconds,\n          isTrialDeferred,\n          enforcers,\n        });\n    if (reusable) {\n      if (!skipChomp) {\n        await this.#ensureIntent({\n          account: request.payerAddress,\n          chainId,\n          delegationHash: reusable.metadata.delegationHash,\n          allowance: reusable.metadata.allowance,\n          tokenSymbol: reusable.metadata.tokenSymbol,\n          tokenAddress: reusable.metadata.tokenAddress,\n        });\n      }\n      return {\n        delegationHash: reusable.metadata.delegationHash,\n        disposition: 'reused',\n      };\n    }\n\n    const unsigned = buildUnsignedSubscriptionDelegation({\n      delegateAddress,\n      delegatorAddress: request.payerAddress,\n      enforcers,\n      tokenAddress: token.address,\n      periodAmount,\n      periodDuration,\n      startDate,\n    });\n\n    const signature = (await this.#messenger.call(\n      'DelegationController:signDelegation',\n      { delegation: unsigned, chainId },\n    )) as Hex;\n\n    const signedDelegation = { ...unsigned, signature };\n\n    const delegationHash = hashDelegation({\n      ...unsigned,\n      salt: BigInt(unsigned.salt),\n      signature,\n    });\n\n    if (!skipChomp) {\n      const verifyResult = await this.#messenger.call(\n        'ChompApiService:verifyDelegation',\n        {\n          signedDelegation,\n          chainId,\n        },\n      );\n\n      if (!verifyResult.valid) {\n        throw new Error(\n          `${SubscriptionDelegationServiceErrorMessage.ChompRejectedDelegation}: ${\n            verifyResult.errors?.join(', ') ?? 'unknown error'\n          }`,\n        );\n      }\n\n      if (!verifyResult.delegationHash) {\n        throw new Error(\n          SubscriptionDelegationServiceErrorMessage.ChompMissingDelegationHash,\n        );\n      }\n      if (!equalsIgnoreCase(verifyResult.delegationHash, delegationHash)) {\n        throw new Error(\n          SubscriptionDelegationServiceErrorMessage.ChompDelegationHashMismatch,\n        );\n      }\n    }\n\n    const allowance: Hex = add0x(periodAmount.toString(16));\n\n    await this.#messenger.call(\n      'AuthenticatedUserStorageService:createDelegation',\n      {\n        signedDelegation,\n        metadata: {\n          delegationHash,\n          chainIdHex: chainId,\n          allowance,\n          tokenSymbol: token.symbol,\n          tokenAddress: token.address,\n          type: CASH_SUBSCRIPTION_DELEGATION_TYPE,\n        },\n      },\n    );\n\n    if (!skipChomp) {\n      await this.#createIntent({\n        account: request.payerAddress,\n        chainId,\n        delegationHash,\n        allowance,\n        tokenSymbol: token.symbol,\n        tokenAddress: token.address,\n      });\n    }\n\n    return {\n      delegationHash,\n      disposition: 'created',\n    };\n  }\n\n  async #findReusableDelegation({\n    request,\n    chainId,\n    delegateAddress,\n    tokenAddress,\n    periodAmount,\n    periodDuration,\n    nowSeconds,\n    isTrialDeferred,\n    enforcers,\n  }: {\n    request: PrepareSubscriptionDelegationRequest;\n    chainId: Hex;\n    delegateAddress: Hex;\n    tokenAddress: Hex;\n    periodAmount: bigint;\n    periodDuration: number;\n    nowSeconds: number;\n    isTrialDeferred: boolean;\n    enforcers: SubscriptionDelegationEnforcers;\n  }): Promise<DelegationResponse | undefined> {\n    const matches = makeMatchesSubscriptionDelegation({\n      delegatorAddress: request.payerAddress,\n      delegateAddress,\n      chainId,\n      tokenAddress,\n      periodAmount,\n      periodDuration,\n      nowSeconds,\n      isTrialDeferred,\n      enforcers,\n    });\n\n    const existingDelegations = await this.#messenger.call(\n      'AuthenticatedUserStorageService:listDelegations',\n    );\n\n    return pickLatestMatchingSubscriptionDelegation(\n      existingDelegations.filter(matches),\n      enforcers,\n    );\n  }\n\n  async #resolveConfiguration(\n    product: ProductType,\n    recurringInterval: RecurringInterval,\n  ): Promise<ResolvedSubscriptionDelegationConfig> {\n    const { remoteFeatureFlags } = this.#messenger.call(\n      'RemoteFeatureFlagController:getState',\n    );\n    const vaultConfig = getMoneyAccountVaultConfig(remoteFeatureFlags);\n    if (!vaultConfig) {\n      throw new Error(\n        SubscriptionDelegationServiceErrorMessage.MissingMoneyAccountVaultConfig,\n      );\n    }\n\n    const { chainId } = vaultConfig;\n    const enforcers = resolveEnforcers(chainId);\n    const pricing = await this.#messenger.call(\n      'SubscriptionController:getPricing',\n    );\n    const price = pricing.products\n      .find((entry) => entry.name === product)\n      ?.prices?.find((entry) => entry.interval === recurringInterval);\n    const paymentMethod = pricing.paymentMethods.find(\n      (entry): entry is PricingCryptoPaymentMethod =>\n        entry.type === PAYMENT_TYPES.byCrypto &&\n        entry.cryptoAuthMethod === CRYPTO_AUTH_METHODS.DELEGATION &&\n        entry.products?.includes(product) === true,\n    );\n    const chain = paymentMethod?.chains?.find(\n      (entry) => entry.chainId === chainId,\n    );\n    const token = chain?.tokens[0];\n    if (!price || !chain?.delegateAddress || !token) {\n      throw new Error(\n        SubscriptionDelegationServiceErrorMessage.PricingConfigurationNotFound,\n      );\n    }\n\n    return {\n      chainId,\n      delegateAddress: chain.delegateAddress,\n      enforcers,\n      price,\n      token,\n    };\n  }\n\n  /**\n   * Ensures an active CHOMP intent exists for the given delegation hash,\n   * registering one when missing or revoked.\n   *\n   * @param params - Intent identity and metadata.\n   * @param params.account - Delegator / payer address.\n   * @param params.chainId - Chain ID of the delegation.\n   * @param params.delegationHash - Hash of the stored delegation.\n   * @param params.allowance - Period allowance stored with the delegation.\n   * @param params.tokenSymbol - Payment token symbol.\n   * @param params.tokenAddress - Payment token address.\n   */\n  async #ensureIntent(params: SubscriptionIntentParams): Promise<void> {\n    const existingIntents = await this.#messenger.call(\n      'ChompApiService:getIntentsByAddress',\n      params.account,\n    );\n\n    const hasActiveIntent = existingIntents.some(\n      (intent) =>\n        equalsIgnoreCase(intent.delegationHash, params.delegationHash) &&\n        intent.status === 'active',\n    );\n\n    if (hasActiveIntent) {\n      return;\n    }\n\n    await this.#createIntent(params);\n  }\n\n  async #createIntent(params: SubscriptionIntentParams): Promise<void> {\n    // Published `@metamask/chomp-api-service` only types intent metadata as\n    // `'cash-deposit' | 'cash-withdrawal'`. The dormant production path still\n    // passes `'cash-subscription'`; a follow-up chomp-api-service release must\n    // accept that discriminator before this path is production-ready. Alpha\n    // callers must use `skipChompInteractions: true` so this method is not\n    // reached.\n    await this.#messenger.call('ChompApiService:createIntents', [\n      {\n        account: params.account,\n        delegationHash: params.delegationHash,\n        chainId: params.chainId,\n        metadata: {\n          allowance: params.allowance,\n          tokenSymbol: params.tokenSymbol,\n          tokenAddress: params.tokenAddress,\n          type: CASH_SUBSCRIPTION_DELEGATION_TYPE as\n            | 'cash-deposit'\n            | 'cash-withdrawal',\n        },\n      },\n    ]);\n  }\n}\n"]}

package/dist/subscription-delegation/amount.d.ts

@@ -0,0 +1,49 @@
+import type { RecurringInterval } from '../types.js';
+/**
+ * Rescales a plan fee from pricing `unitDecimals` into token base units.
+ *
+ * Uses a 1:1 numeric mapping (ADR 0057): the period amount is one billing
+ * interval's fee, not `fee × minimumFundingCycles`.
+ *
+ * @param params - Amount and decimal inputs.
+ * @param params.unitAmount - Fee in pricing minor units (non-negative integer).
+ * @param params.unitDecimals - Decimals of `unitAmount`.
+ * @param params.tokenDecimals - Decimals of the payment token.
+ * @returns The period amount in token base units.
+ * @throws If inputs are not non-negative integers, or downscaling would lose precision.
+ */
+export declare function calculatePeriodAmount({ unitAmount, unitDecimals, tokenDecimals, }: {
+    unitAmount: number;
+    unitDecimals: number;
+    tokenDecimals: number;
+}): bigint;
+/**
+ * Plan-scoped ERC-20 period duration in seconds (ADR 0057).
+ *
+ * - Monthly: 28 days (minimum Stripe monthly invoice gap).
+ * - Yearly: 365 days.
+ *
+ * @param recurringInterval - Subscription billing interval.
+ * @returns Period duration in seconds.
+ */
+export declare function getPeriodDuration(recurringInterval: RecurringInterval): number;
+/**
+ * Computes the ERC20TokenPeriodTransfer `startDate` for a subscription
+ * delegation, optionally deferred by a pricing trial.
+ *
+ * @param params - Clock and optional trial length.
+ * @param params.nowSeconds - Current unix timestamp in seconds.
+ * @param params.trialPeriodDays - Optional non-negative trial length in days.
+ * Defaults to `0` (no offset) when omitted.
+ * @returns Unix timestamp when the first period transfer may begin.
+ */
+export declare function getDelegationStartDate({ nowSeconds, trialPeriodDays, }: {
+    nowSeconds: number;
+    trialPeriodDays?: number;
+}): number;
+/**
+ * @param value - Candidate number.
+ * @param message - Error message when invalid.
+ */
+export declare function assertPositiveInteger(value: number, message: string): void;
+//# sourceMappingURL=amount.d.ts.map

package/dist/subscription-delegation/amount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"amount.d.ts","sourceRoot":"","sources":["../../src/subscription-delegation/amount.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAIrD;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,UAAU,EACV,YAAY,EACZ,aAAa,GACd,EAAE;IACD,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,MAAM,CA6BT;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,iBAAiB,EAAE,iBAAiB,GACnC,MAAM,CAUR;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,UAAU,EACV,eAAmB,GACpB,EAAE;IACD,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,GAAG,MAAM,CAMT;AAYD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAI1E"}