@metamask-previews/subscription-controller 9.0.1-preview-2b92c5a1c → 9.0.1-preview-e8a256c39

package/dist/subscription-delegation/SubscriptionDelegationService.js

@@ -0,0 +1,290 @@
+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, } 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 ||
+        !contracts.RedeemerEnforcer) {
+        throw new Error(`${SubscriptionDelegationServiceErrorMessage.DelegationContractsNotFound}: ${chainId}`);
+    }
+    return {
+        valueLte: contracts.ValueLteEnforcer,
+        erc20TokenPeriodTransfer: contracts.ERC20PeriodTransferEnforcer,
+        redeemer: contracts.RedeemerEnforcer,
+    };
+}
+/**
+ * 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 both the delegation
+ * `delegate` and the RedeemerEnforcer redeemer.
+ *
+ * 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.
+     * 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.
+     * @returns The delegation hash (CHOMP-verified unless skipped) and whether it
+     * was created or reused.
+     */
+    async prepareDelegation(request) {
+        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 matches = makeMatchesSubscriptionDelegation({
+            delegatorAddress: request.payerAddress,
+            delegateAddress,
+            chainId,
+            tokenAddress: token.address,
+            periodAmount,
+            periodDuration,
+            nowSeconds,
+            isTrialDeferred,
+            enforcers,
+        });
+        const existingDelegations = await this.#messenger.call('AuthenticatedUserStorageService:listDelegations');
+        const reusable = existingDelegations.find(matches);
+        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 #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":"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","sourcesContent":["import type {\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} 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 (\n    !contracts?.ValueLteEnforcer ||\n    !contracts.ERC20PeriodTransferEnforcer ||\n    !contracts.RedeemerEnforcer\n  ) {\n    throw new Error(\n      `${SubscriptionDelegationServiceErrorMessage.DelegationContractsNotFound}: ${chainId}`,\n    );\n  }\n\n  return {\n    valueLte: contracts.ValueLteEnforcer,\n    erc20TokenPeriodTransfer: contracts.ERC20PeriodTransferEnforcer,\n    redeemer: contracts.RedeemerEnforcer,\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 both the delegation\n * `delegate` and the RedeemerEnforcer redeemer.\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   * 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   * @returns The delegation hash (CHOMP-verified unless skipped) and whether it\n   * was created or reused.\n   */\n  async prepareDelegation(\n    request: PrepareSubscriptionDelegationRequest,\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 matches = makeMatchesSubscriptionDelegation({\n      delegatorAddress: request.payerAddress,\n      delegateAddress,\n      chainId,\n      tokenAddress: token.address,\n      periodAmount,\n      periodDuration,\n      nowSeconds,\n      isTrialDeferred,\n      enforcers,\n    });\n\n    const existingDelegations = await this.#messenger.call(\n      'AuthenticatedUserStorageService:listDelegations',\n    );\n    const reusable = existingDelegations.find(matches);\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 #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"}

package/dist/subscription-delegation/amount.js

@@ -0,0 +1,84 @@
+import { SubscriptionDelegationServiceErrorMessage } from '../constants.js';
+import { RECURRING_INTERVALS } from '../types.js';
+const SECONDS_PER_DAY = 86_400;
+/**
+ * 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 function calculatePeriodAmount({ unitAmount, unitDecimals, tokenDecimals, }) {
+    assertNonNegativeInteger(unitAmount, SubscriptionDelegationServiceErrorMessage.InvalidAmount);
+    assertNonNegativeInteger(unitDecimals, SubscriptionDelegationServiceErrorMessage.InvalidDecimals);
+    assertNonNegativeInteger(tokenDecimals, SubscriptionDelegationServiceErrorMessage.InvalidDecimals);
+    const amount = BigInt(unitAmount);
+    if (tokenDecimals === unitDecimals) {
+        return amount;
+    }
+    if (tokenDecimals > unitDecimals) {
+        return amount * 10n ** BigInt(tokenDecimals - unitDecimals);
+    }
+    const divisor = 10n ** BigInt(unitDecimals - tokenDecimals);
+    if (amount % divisor !== 0n) {
+        throw new Error(SubscriptionDelegationServiceErrorMessage.LossyAmountScale);
+    }
+    return amount / divisor;
+}
+/**
+ * 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 function getPeriodDuration(recurringInterval) {
+    if (recurringInterval === RECURRING_INTERVALS.month) {
+        return 28 * SECONDS_PER_DAY;
+    }
+    if (recurringInterval === RECURRING_INTERVALS.year) {
+        return 365 * SECONDS_PER_DAY;
+    }
+    throw new Error(SubscriptionDelegationServiceErrorMessage.UnsupportedRecurringInterval);
+}
+/**
+ * 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 function getDelegationStartDate({ nowSeconds, trialPeriodDays = 0, }) {
+    assertNonNegativeInteger(trialPeriodDays, SubscriptionDelegationServiceErrorMessage.InvalidTrialPeriodDays);
+    return nowSeconds + trialPeriodDays * SECONDS_PER_DAY;
+}
+/**
+ * @param value - Candidate number.
+ * @param message - Error message when invalid.
+ */
+function assertNonNegativeInteger(value, message) {
+    if (!Number.isInteger(value) || value < 0) {
+        throw new Error(message);
+    }
+}
+/**
+ * @param value - Candidate number.
+ * @param message - Error message when invalid.
+ */
+export function assertPositiveInteger(value, message) {
+    if (!Number.isInteger(value) || value <= 0) {
+        throw new Error(message);
+    }
+}
+//# sourceMappingURL=amount.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"amount.js","sourceRoot":"","sources":["../../src/subscription-delegation/amount.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yCAAyC,EAAE,MAAM,iBAAiB,CAAC;AAC5E,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGlD,MAAM,eAAe,GAAG,MAAM,CAAC;AAE/B;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,qBAAqB,CAAC,EACpC,UAAU,EACV,YAAY,EACZ,aAAa,GAKd;IACC,wBAAwB,CACtB,UAAU,EACV,yCAAyC,CAAC,aAAa,CACxD,CAAC;IACF,wBAAwB,CACtB,YAAY,EACZ,yCAAyC,CAAC,eAAe,CAC1D,CAAC;IACF,wBAAwB,CACtB,aAAa,EACb,yCAAyC,CAAC,eAAe,CAC1D,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IAElC,IAAI,aAAa,KAAK,YAAY,EAAE,CAAC;QACnC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,aAAa,GAAG,YAAY,EAAE,CAAC;QACjC,OAAO,MAAM,GAAG,GAAG,IAAI,MAAM,CAAC,aAAa,GAAG,YAAY,CAAC,CAAC;IAC9D,CAAC;IAED,MAAM,OAAO,GAAG,GAAG,IAAI,MAAM,CAAC,YAAY,GAAG,aAAa,CAAC,CAAC;IAC5D,IAAI,MAAM,GAAG,OAAO,KAAK,EAAE,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,gBAAgB,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,MAAM,GAAG,OAAO,CAAC;AAC1B,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAC/B,iBAAoC;IAEpC,IAAI,iBAAiB,KAAK,mBAAmB,CAAC,KAAK,EAAE,CAAC;QACpD,OAAO,EAAE,GAAG,eAAe,CAAC;IAC9B,CAAC;IACD,IAAI,iBAAiB,KAAK,mBAAmB,CAAC,IAAI,EAAE,CAAC;QACnD,OAAO,GAAG,GAAG,eAAe,CAAC;IAC/B,CAAC;IACD,MAAM,IAAI,KAAK,CACb,yCAAyC,CAAC,4BAA4B,CACvE,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,sBAAsB,CAAC,EACrC,UAAU,EACV,eAAe,GAAG,CAAC,GAIpB;IACC,wBAAwB,CACtB,eAAe,EACf,yCAAyC,CAAC,sBAAsB,CACjE,CAAC;IACF,OAAO,UAAU,GAAG,eAAe,GAAG,eAAe,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,SAAS,wBAAwB,CAAC,KAAa,EAAE,OAAe;IAC9D,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAa,EAAE,OAAe;IAClE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC","sourcesContent":["import { SubscriptionDelegationServiceErrorMessage } from '../constants.js';\nimport { RECURRING_INTERVALS } from '../types.js';\nimport type { RecurringInterval } from '../types.js';\n\nconst SECONDS_PER_DAY = 86_400;\n\n/**\n * Rescales a plan fee from pricing `unitDecimals` into token base units.\n *\n * Uses a 1:1 numeric mapping (ADR 0057): the period amount is one billing\n * interval's fee, not `fee × minimumFundingCycles`.\n *\n * @param params - Amount and decimal inputs.\n * @param params.unitAmount - Fee in pricing minor units (non-negative integer).\n * @param params.unitDecimals - Decimals of `unitAmount`.\n * @param params.tokenDecimals - Decimals of the payment token.\n * @returns The period amount in token base units.\n * @throws If inputs are not non-negative integers, or downscaling would lose precision.\n */\nexport function calculatePeriodAmount({\n  unitAmount,\n  unitDecimals,\n  tokenDecimals,\n}: {\n  unitAmount: number;\n  unitDecimals: number;\n  tokenDecimals: number;\n}): bigint {\n  assertNonNegativeInteger(\n    unitAmount,\n    SubscriptionDelegationServiceErrorMessage.InvalidAmount,\n  );\n  assertNonNegativeInteger(\n    unitDecimals,\n    SubscriptionDelegationServiceErrorMessage.InvalidDecimals,\n  );\n  assertNonNegativeInteger(\n    tokenDecimals,\n    SubscriptionDelegationServiceErrorMessage.InvalidDecimals,\n  );\n\n  const amount = BigInt(unitAmount);\n\n  if (tokenDecimals === unitDecimals) {\n    return amount;\n  }\n\n  if (tokenDecimals > unitDecimals) {\n    return amount * 10n ** BigInt(tokenDecimals - unitDecimals);\n  }\n\n  const divisor = 10n ** BigInt(unitDecimals - tokenDecimals);\n  if (amount % divisor !== 0n) {\n    throw new Error(SubscriptionDelegationServiceErrorMessage.LossyAmountScale);\n  }\n  return amount / divisor;\n}\n\n/**\n * Plan-scoped ERC-20 period duration in seconds (ADR 0057).\n *\n * - Monthly: 28 days (minimum Stripe monthly invoice gap).\n * - Yearly: 365 days.\n *\n * @param recurringInterval - Subscription billing interval.\n * @returns Period duration in seconds.\n */\nexport function getPeriodDuration(\n  recurringInterval: RecurringInterval,\n): number {\n  if (recurringInterval === RECURRING_INTERVALS.month) {\n    return 28 * SECONDS_PER_DAY;\n  }\n  if (recurringInterval === RECURRING_INTERVALS.year) {\n    return 365 * SECONDS_PER_DAY;\n  }\n  throw new Error(\n    SubscriptionDelegationServiceErrorMessage.UnsupportedRecurringInterval,\n  );\n}\n\n/**\n * Computes the ERC20TokenPeriodTransfer `startDate` for a subscription\n * delegation, optionally deferred by a pricing trial.\n *\n * @param params - Clock and optional trial length.\n * @param params.nowSeconds - Current unix timestamp in seconds.\n * @param params.trialPeriodDays - Optional non-negative trial length in days.\n * Defaults to `0` (no offset) when omitted.\n * @returns Unix timestamp when the first period transfer may begin.\n */\nexport function getDelegationStartDate({\n  nowSeconds,\n  trialPeriodDays = 0,\n}: {\n  nowSeconds: number;\n  trialPeriodDays?: number;\n}): number {\n  assertNonNegativeInteger(\n    trialPeriodDays,\n    SubscriptionDelegationServiceErrorMessage.InvalidTrialPeriodDays,\n  );\n  return nowSeconds + trialPeriodDays * SECONDS_PER_DAY;\n}\n\n/**\n * @param value - Candidate number.\n * @param message - Error message when invalid.\n */\nfunction assertNonNegativeInteger(value: number, message: string): void {\n  if (!Number.isInteger(value) || value < 0) {\n    throw new Error(message);\n  }\n}\n\n/**\n * @param value - Candidate number.\n * @param message - Error message when invalid.\n */\nexport function assertPositiveInteger(value: number, message: string): void {\n  if (!Number.isInteger(value) || value <= 0) {\n    throw new Error(message);\n  }\n}\n"]}

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

@@ -0,0 +1,41 @@
+import type { SignedDelegation } from '@metamask/authenticated-user-storage';
+import type { Hex } from '@metamask/utils';
+import type { SubscriptionDelegationEnforcers } from './types.js';
+export type UnsignedSubscriptionDelegation = Omit<SignedDelegation, 'signature'>;
+export type BuildSubscriptionCaveatsParams = {
+    enforcers: SubscriptionDelegationEnforcers;
+    delegateAddress: Hex;
+    tokenAddress: Hex;
+    periodAmount: bigint;
+    periodDuration: number;
+    startDate: number;
+};
+/**
+ * Builds the caveat list for a cash-subscription delegation:
+ * `ValueLte(0)` then `ERC20TokenPeriodTransfer(...)`.
+ * RedeemerEnforcer is temporarily omitted pending CHOMP guidance.
+ *
+ * @param params - Enforcer addresses, parties, and period terms.
+ * @param params.enforcers - Delegation Framework enforcer addresses.
+ * @param params.tokenAddress - Subscription settlement token.
+ * @param params.periodAmount - Maximum token amount per period.
+ * @param params.periodDuration - Period length in seconds.
+ * @param params.startDate - Unix timestamp when transfers may begin.
+ * @returns Caveats in enforcer order.
+ */
+export declare function buildSubscriptionCaveats({ enforcers, tokenAddress, periodAmount, periodDuration, startDate, }: BuildSubscriptionCaveatsParams): SignedDelegation['caveats'];
+export type BuildUnsignedSubscriptionDelegationParams = BuildSubscriptionCaveatsParams & {
+    delegatorAddress: Hex;
+    /**
+     * Optional salt for tests. When omitted, a random 32-byte salt is generated.
+     */
+    salt?: Hex;
+};
+/**
+ * Builds an unsigned root cash-subscription delegation.
+ *
+ * @param params - Delegation parties, enforcers, and period terms.
+ * @returns An unsigned delegation ready for signing.
+ */
+export declare function buildUnsignedSubscriptionDelegation(params: BuildUnsignedSubscriptionDelegationParams): UnsignedSubscriptionDelegation;
+//# sourceMappingURL=caveats.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"caveats.d.ts","sourceRoot":"","sources":["../../src/subscription-delegation/caveats.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAO7E,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAE3C,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,YAAY,CAAC;AAElE,MAAM,MAAM,8BAA8B,GAAG,IAAI,CAC/C,gBAAgB,EAChB,WAAW,CACZ,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IAC3C,SAAS,EAAE,+BAA+B,CAAC;IAC3C,eAAe,EAAE,GAAG,CAAC;IACrB,YAAY,EAAE,GAAG,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CAAC,EACvC,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,SAAS,GACV,EAAE,8BAA8B,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAyB9D;AAED,MAAM,MAAM,yCAAyC,GACnD,8BAA8B,GAAG;IAC/B,gBAAgB,EAAE,GAAG,CAAC;IACtB;;OAEG;IACH,IAAI,CAAC,EAAE,GAAG,CAAC;CACZ,CAAC;AAEJ;;;;;GAKG;AACH,wBAAgB,mCAAmC,CACjD,MAAM,EAAE,yCAAyC,GAChD,8BAA8B,CAYhC"}

package/dist/subscription-delegation/caveats.js

@@ -0,0 +1,59 @@
+import { ROOT_AUTHORITY, createERC20TokenPeriodTransferTerms, createValueLteTerms, } from '@metamask/delegation-core';
+import { bytesToHex } from '@metamask/utils';
+/**
+ * Builds the caveat list for a cash-subscription delegation:
+ * `ValueLte(0)` then `ERC20TokenPeriodTransfer(...)`.
+ * RedeemerEnforcer is temporarily omitted pending CHOMP guidance.
+ *
+ * @param params - Enforcer addresses, parties, and period terms.
+ * @param params.enforcers - Delegation Framework enforcer addresses.
+ * @param params.tokenAddress - Subscription settlement token.
+ * @param params.periodAmount - Maximum token amount per period.
+ * @param params.periodDuration - Period length in seconds.
+ * @param params.startDate - Unix timestamp when transfers may begin.
+ * @returns Caveats in enforcer order.
+ */
+export function buildSubscriptionCaveats({ enforcers, tokenAddress, periodAmount, periodDuration, startDate, }) {
+    return [
+        {
+            enforcer: enforcers.valueLte,
+            terms: createValueLteTerms({ maxValue: 0n }),
+            args: '0x',
+        },
+        {
+            enforcer: enforcers.erc20TokenPeriodTransfer,
+            terms: createERC20TokenPeriodTransferTerms({
+                tokenAddress,
+                periodAmount,
+                periodDuration,
+                startDate,
+            }),
+            args: '0x',
+        },
+        // TODO: recheck with CHOMP team if we should set redeemer to subscription payment address
+        // or use allowed call data
+        // {
+        //   enforcer: enforcers.redeemer,
+        //   terms: createRedeemerTerms({ redeemers: [delegateAddress] }),
+        //   args: '0x',
+        // },
+    ];
+}
+/**
+ * Builds an unsigned root cash-subscription delegation.
+ *
+ * @param params - Delegation parties, enforcers, and period terms.
+ * @returns An unsigned delegation ready for signing.
+ */
+export function buildUnsignedSubscriptionDelegation(params) {
+    const salt = params.salt ??
+        bytesToHex(globalThis.crypto.getRandomValues(new Uint8Array(32)));
+    return {
+        delegate: params.delegateAddress,
+        delegator: params.delegatorAddress,
+        authority: ROOT_AUTHORITY,
+        caveats: buildSubscriptionCaveats(params),
+        salt,
+    };
+}
+//# sourceMappingURL=caveats.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"caveats.js","sourceRoot":"","sources":["../../src/subscription-delegation/caveats.ts"],"names":[],"mappings":"AACA,OAAO,EACL,cAAc,EACd,mCAAmC,EACnC,mBAAmB,GACpB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAmB7C;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,wBAAwB,CAAC,EACvC,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,SAAS,GACsB;IAC/B,OAAO;QACL;YACE,QAAQ,EAAE,SAAS,CAAC,QAAQ;YAC5B,KAAK,EAAE,mBAAmB,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;YAC5C,IAAI,EAAE,IAAI;SACX;QACD;YACE,QAAQ,EAAE,SAAS,CAAC,wBAAwB;YAC5C,KAAK,EAAE,mCAAmC,CAAC;gBACzC,YAAY;gBACZ,YAAY;gBACZ,cAAc;gBACd,SAAS;aACV,CAAC;YACF,IAAI,EAAE,IAAI;SACX;QACD,0FAA0F;QAC1F,2BAA2B;QAC3B,IAAI;QACJ,kCAAkC;QAClC,kEAAkE;QAClE,gBAAgB;QAChB,KAAK;KACN,CAAC;AACJ,CAAC;AAWD;;;;;GAKG;AACH,MAAM,UAAU,mCAAmC,CACjD,MAAiD;IAEjD,MAAM,IAAI,GACR,MAAM,CAAC,IAAI;QACX,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAEpE,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,eAAe;QAChC,SAAS,EAAE,MAAM,CAAC,gBAAgB;QAClC,SAAS,EAAE,cAAc;QACzB,OAAO,EAAE,wBAAwB,CAAC,MAAM,CAAC;QACzC,IAAI;KACL,CAAC;AACJ,CAAC","sourcesContent":["import type { SignedDelegation } from '@metamask/authenticated-user-storage';\nimport {\n  ROOT_AUTHORITY,\n  createERC20TokenPeriodTransferTerms,\n  createValueLteTerms,\n} from '@metamask/delegation-core';\nimport { bytesToHex } from '@metamask/utils';\nimport type { Hex } from '@metamask/utils';\n\nimport type { SubscriptionDelegationEnforcers } from './types.js';\n\nexport type UnsignedSubscriptionDelegation = Omit<\n  SignedDelegation,\n  'signature'\n>;\n\nexport type BuildSubscriptionCaveatsParams = {\n  enforcers: SubscriptionDelegationEnforcers;\n  delegateAddress: Hex;\n  tokenAddress: Hex;\n  periodAmount: bigint;\n  periodDuration: number;\n  startDate: number;\n};\n\n/**\n * Builds the caveat list for a cash-subscription delegation:\n * `ValueLte(0)` then `ERC20TokenPeriodTransfer(...)`.\n * RedeemerEnforcer is temporarily omitted pending CHOMP guidance.\n *\n * @param params - Enforcer addresses, parties, and period terms.\n * @param params.enforcers - Delegation Framework enforcer addresses.\n * @param params.tokenAddress - Subscription settlement token.\n * @param params.periodAmount - Maximum token amount per period.\n * @param params.periodDuration - Period length in seconds.\n * @param params.startDate - Unix timestamp when transfers may begin.\n * @returns Caveats in enforcer order.\n */\nexport function buildSubscriptionCaveats({\n  enforcers,\n  tokenAddress,\n  periodAmount,\n  periodDuration,\n  startDate,\n}: BuildSubscriptionCaveatsParams): SignedDelegation['caveats'] {\n  return [\n    {\n      enforcer: enforcers.valueLte,\n      terms: createValueLteTerms({ maxValue: 0n }),\n      args: '0x',\n    },\n    {\n      enforcer: enforcers.erc20TokenPeriodTransfer,\n      terms: createERC20TokenPeriodTransferTerms({\n        tokenAddress,\n        periodAmount,\n        periodDuration,\n        startDate,\n      }),\n      args: '0x',\n    },\n    // TODO: recheck with CHOMP team if we should set redeemer to subscription payment address\n    // or use allowed call data\n    // {\n    //   enforcer: enforcers.redeemer,\n    //   terms: createRedeemerTerms({ redeemers: [delegateAddress] }),\n    //   args: '0x',\n    // },\n  ];\n}\n\nexport type BuildUnsignedSubscriptionDelegationParams =\n  BuildSubscriptionCaveatsParams & {\n    delegatorAddress: Hex;\n    /**\n     * Optional salt for tests. When omitted, a random 32-byte salt is generated.\n     */\n    salt?: Hex;\n  };\n\n/**\n * Builds an unsigned root cash-subscription delegation.\n *\n * @param params - Delegation parties, enforcers, and period terms.\n * @returns An unsigned delegation ready for signing.\n */\nexport function buildUnsignedSubscriptionDelegation(\n  params: BuildUnsignedSubscriptionDelegationParams,\n): UnsignedSubscriptionDelegation {\n  const salt =\n    params.salt ??\n    bytesToHex(globalThis.crypto.getRandomValues(new Uint8Array(32)));\n\n  return {\n    delegate: params.delegateAddress,\n    delegator: params.delegatorAddress,\n    authority: ROOT_AUTHORITY,\n    caveats: buildSubscriptionCaveats(params),\n    salt,\n  };\n}\n"]}