@metamask/subscription-controller 9.0.1 → 10.0.0

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,40 @@
+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(...)`.
+ *
+ * @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;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CAAC,EACvC,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,SAAS,GACV,EAAE,8BAA8B,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAkB9D;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,51 @@
+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(...)`.
+ *
+ * @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',
+        },
+    ];
+}
+/**
+ * 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;;;;;;;;;;;GAWG;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;KACF,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 *\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  ];\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"]}

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

@@ -0,0 +1,53 @@
+import type { DelegationResponse } from '@metamask/authenticated-user-storage';
+import type { Hex } from '@metamask/utils';
+import type { SubscriptionDelegationEnforcers } from './types.js';
+export type SubscriptionDelegationFingerprint = {
+    delegatorAddress: Hex;
+    delegateAddress: Hex;
+    chainId: Hex;
+    tokenAddress: Hex;
+    periodAmount: bigint;
+    periodDuration: number;
+    /**
+     * Current unix timestamp in seconds. Used to classify a stored period
+     * `startDate` as immediately redeemable (`<= now`) vs trial-deferred (`> now`).
+     */
+    nowSeconds: number;
+    /**
+     * When true, only a still-deferred period start (`> nowSeconds`) matches.
+     * When false, only an immediately redeemable start (`<= nowSeconds`) matches.
+     */
+    isTrialDeferred: boolean;
+    enforcers: SubscriptionDelegationEnforcers;
+};
+/**
+ * Case-insensitive hex equality.
+ *
+ * @param left - First hex value.
+ * @param right - Second hex value.
+ * @returns Whether the values are equal ignoring case.
+ */
+export declare function equalsIgnoreCase(left: string, right: string): boolean;
+/**
+ * Builds a predicate that matches a stored AUS delegation to the semantic
+ * cash-subscription fingerprint. Salt is ignored so a previously signed
+ * equivalent permission can be reused. Period `startDate` is compared only
+ * as trial-deferred (`> nowSeconds`) vs immediately redeemable (`<= nowSeconds`)
+ * so a positive-length trial cannot reuse a live permission and vice versa.
+ *
+ * @param expected - Semantic fields that must match.
+ * @returns Predicate over {@link DelegationResponse}.
+ */
+export declare function makeMatchesSubscriptionDelegation(expected: SubscriptionDelegationFingerprint): (entry: DelegationResponse) => boolean;
+/**
+ * Returns the fingerprint match with the latest period `startDate`.
+ *
+ * Equal `startDate`s keep list order. A delegation whose `startDate` cannot
+ * be read sorts last.
+ *
+ * @param matches - Fingerprint-matching AUS delegations, in list order.
+ * @param enforcers - Enforcer addresses used to read `startDate`.
+ * @returns The preferred match, or `undefined` when `matches` is empty.
+ */
+export declare function pickLatestMatchingSubscriptionDelegation(matches: readonly DelegationResponse[], enforcers: SubscriptionDelegationEnforcers): DelegationResponse | undefined;
+//# sourceMappingURL=fingerprint.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.d.ts","sourceRoot":"","sources":["../../src/subscription-delegation/fingerprint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAK/E,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAE3C,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,YAAY,CAAC;AAGlE,MAAM,MAAM,iCAAiC,GAAG;IAC9C,gBAAgB,EAAE,GAAG,CAAC;IACtB,eAAe,EAAE,GAAG,CAAC;IACrB,OAAO,EAAE,GAAG,CAAC;IACb,YAAY,EAAE,GAAG,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,eAAe,EAAE,OAAO,CAAC;IACzB,SAAS,EAAE,+BAA+B,CAAC;CAC5C,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAErE;AAED;;;;;;;;;GASG;AACH,wBAAgB,iCAAiC,CAC/C,QAAQ,EAAE,iCAAiC,GAC1C,CAAC,KAAK,EAAE,kBAAkB,KAAK,OAAO,CAsExC;AA8BD;;;;;;;;;GASG;AACH,wBAAgB,wCAAwC,CACtD,OAAO,EAAE,SAAS,kBAAkB,EAAE,EACtC,SAAS,EAAE,+BAA+B,GACzC,kBAAkB,GAAG,SAAS,CAYhC"}

package/dist/subscription-delegation/fingerprint.js

@@ -0,0 +1,109 @@
+import { decodeERC20TokenPeriodTransferTerms, decodeValueLteTerms, } from '@metamask/delegation-core';
+import { CASH_SUBSCRIPTION_DELEGATION_TYPE } from './types.js';
+/**
+ * Case-insensitive hex equality.
+ *
+ * @param left - First hex value.
+ * @param right - Second hex value.
+ * @returns Whether the values are equal ignoring case.
+ */
+export function equalsIgnoreCase(left, right) {
+    return left.toLowerCase() === right.toLowerCase();
+}
+/**
+ * Builds a predicate that matches a stored AUS delegation to the semantic
+ * cash-subscription fingerprint. Salt is ignored so a previously signed
+ * equivalent permission can be reused. Period `startDate` is compared only
+ * as trial-deferred (`> nowSeconds`) vs immediately redeemable (`<= nowSeconds`)
+ * so a positive-length trial cannot reuse a live permission and vice versa.
+ *
+ * @param expected - Semantic fields that must match.
+ * @returns Predicate over {@link DelegationResponse}.
+ */
+export function makeMatchesSubscriptionDelegation(expected) {
+    return (entry) => {
+        if (entry.metadata.type !== CASH_SUBSCRIPTION_DELEGATION_TYPE) {
+            return false;
+        }
+        if (!equalsIgnoreCase(entry.signedDelegation.delegator, expected.delegatorAddress)) {
+            return false;
+        }
+        if (!equalsIgnoreCase(entry.signedDelegation.delegate, expected.delegateAddress)) {
+            return false;
+        }
+        if (!equalsIgnoreCase(entry.metadata.chainIdHex, expected.chainId)) {
+            return false;
+        }
+        if (!equalsIgnoreCase(entry.metadata.tokenAddress, expected.tokenAddress)) {
+            return false;
+        }
+        const { caveats } = entry.signedDelegation;
+        if (caveats.length < 2) {
+            return false;
+        }
+        const valueLteCaveat = caveats.find((caveat) => equalsIgnoreCase(caveat.enforcer, expected.enforcers.valueLte));
+        const periodCaveat = caveats.find((caveat) => equalsIgnoreCase(caveat.enforcer, expected.enforcers.erc20TokenPeriodTransfer));
+        if (!valueLteCaveat || !periodCaveat) {
+            return false;
+        }
+        try {
+            const valueTerms = decodeValueLteTerms(valueLteCaveat.terms);
+            if (valueTerms.maxValue !== 0n) {
+                return false;
+            }
+            const periodTerms = decodeERC20TokenPeriodTransferTerms(periodCaveat.terms);
+            const storedStartDate = Number(periodTerms.startDate);
+            const isStoredDeferred = storedStartDate > expected.nowSeconds;
+            if (expected.isTrialDeferred !== isStoredDeferred) {
+                return false;
+            }
+            return (equalsIgnoreCase(periodTerms.tokenAddress, expected.tokenAddress) &&
+                periodTerms.periodAmount === expected.periodAmount &&
+                Number(periodTerms.periodDuration) === expected.periodDuration);
+        }
+        catch {
+            return false;
+        }
+    };
+}
+/**
+ * Reads the ERC-20 period-transfer `startDate` from a stored delegation.
+ *
+ * @param entry - Stored AUS delegation.
+ * @param enforcers - Enforcer addresses used to locate the period caveat.
+ * @returns Unix timestamp in seconds, or `undefined` when the caveat is
+ * missing or malformed.
+ */
+function getSubscriptionDelegationStartDate(entry, enforcers) {
+    const periodCaveat = entry.signedDelegation.caveats.find((caveat) => equalsIgnoreCase(caveat.enforcer, enforcers.erc20TokenPeriodTransfer));
+    if (!periodCaveat) {
+        return undefined;
+    }
+    try {
+        return Number(decodeERC20TokenPeriodTransferTerms(periodCaveat.terms).startDate);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Returns the fingerprint match with the latest period `startDate`.
+ *
+ * Equal `startDate`s keep list order. A delegation whose `startDate` cannot
+ * be read sorts last.
+ *
+ * @param matches - Fingerprint-matching AUS delegations, in list order.
+ * @param enforcers - Enforcer addresses used to read `startDate`.
+ * @returns The preferred match, or `undefined` when `matches` is empty.
+ */
+export function pickLatestMatchingSubscriptionDelegation(matches, enforcers) {
+    const byStartDateDescending = [...matches].sort((left, right) => {
+        const leftStart = getSubscriptionDelegationStartDate(left, enforcers) ??
+            Number.NEGATIVE_INFINITY;
+        const rightStart = getSubscriptionDelegationStartDate(right, enforcers) ??
+            Number.NEGATIVE_INFINITY;
+        return rightStart - leftStart;
+    });
+    return byStartDateDescending[0];
+}
+//# sourceMappingURL=fingerprint.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.js","sourceRoot":"","sources":["../../src/subscription-delegation/fingerprint.ts"],"names":[],"mappings":"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","sourcesContent":["import type { DelegationResponse } from '@metamask/authenticated-user-storage';\nimport {\n  decodeERC20TokenPeriodTransferTerms,\n  decodeValueLteTerms,\n} from '@metamask/delegation-core';\nimport type { Hex } from '@metamask/utils';\n\nimport type { SubscriptionDelegationEnforcers } from './types.js';\nimport { CASH_SUBSCRIPTION_DELEGATION_TYPE } from './types.js';\n\nexport type SubscriptionDelegationFingerprint = {\n  delegatorAddress: Hex;\n  delegateAddress: Hex;\n  chainId: Hex;\n  tokenAddress: Hex;\n  periodAmount: bigint;\n  periodDuration: number;\n  /**\n   * Current unix timestamp in seconds. Used to classify a stored period\n   * `startDate` as immediately redeemable (`<= now`) vs trial-deferred (`> now`).\n   */\n  nowSeconds: number;\n  /**\n   * When true, only a still-deferred period start (`> nowSeconds`) matches.\n   * When false, only an immediately redeemable start (`<= nowSeconds`) matches.\n   */\n  isTrialDeferred: boolean;\n  enforcers: SubscriptionDelegationEnforcers;\n};\n\n/**\n * Case-insensitive hex equality.\n *\n * @param left - First hex value.\n * @param right - Second hex value.\n * @returns Whether the values are equal ignoring case.\n */\nexport function equalsIgnoreCase(left: string, right: string): boolean {\n  return left.toLowerCase() === right.toLowerCase();\n}\n\n/**\n * Builds a predicate that matches a stored AUS delegation to the semantic\n * cash-subscription fingerprint. Salt is ignored so a previously signed\n * equivalent permission can be reused. Period `startDate` is compared only\n * as trial-deferred (`> nowSeconds`) vs immediately redeemable (`<= nowSeconds`)\n * so a positive-length trial cannot reuse a live permission and vice versa.\n *\n * @param expected - Semantic fields that must match.\n * @returns Predicate over {@link DelegationResponse}.\n */\nexport function makeMatchesSubscriptionDelegation(\n  expected: SubscriptionDelegationFingerprint,\n): (entry: DelegationResponse) => boolean {\n  return (entry) => {\n    if (entry.metadata.type !== CASH_SUBSCRIPTION_DELEGATION_TYPE) {\n      return false;\n    }\n    if (\n      !equalsIgnoreCase(\n        entry.signedDelegation.delegator,\n        expected.delegatorAddress,\n      )\n    ) {\n      return false;\n    }\n    if (\n      !equalsIgnoreCase(\n        entry.signedDelegation.delegate,\n        expected.delegateAddress,\n      )\n    ) {\n      return false;\n    }\n    if (!equalsIgnoreCase(entry.metadata.chainIdHex, expected.chainId)) {\n      return false;\n    }\n    if (!equalsIgnoreCase(entry.metadata.tokenAddress, expected.tokenAddress)) {\n      return false;\n    }\n\n    const { caveats } = entry.signedDelegation;\n    if (caveats.length < 2) {\n      return false;\n    }\n\n    const valueLteCaveat = caveats.find((caveat) =>\n      equalsIgnoreCase(caveat.enforcer, expected.enforcers.valueLte),\n    );\n    const periodCaveat = caveats.find((caveat) =>\n      equalsIgnoreCase(\n        caveat.enforcer,\n        expected.enforcers.erc20TokenPeriodTransfer,\n      ),\n    );\n    if (!valueLteCaveat || !periodCaveat) {\n      return false;\n    }\n\n    try {\n      const valueTerms = decodeValueLteTerms(valueLteCaveat.terms);\n      if (valueTerms.maxValue !== 0n) {\n        return false;\n      }\n\n      const periodTerms = decodeERC20TokenPeriodTransferTerms(\n        periodCaveat.terms,\n      );\n      const storedStartDate = Number(periodTerms.startDate);\n      const isStoredDeferred = storedStartDate > expected.nowSeconds;\n      if (expected.isTrialDeferred !== isStoredDeferred) {\n        return false;\n      }\n\n      return (\n        equalsIgnoreCase(periodTerms.tokenAddress, expected.tokenAddress) &&\n        periodTerms.periodAmount === expected.periodAmount &&\n        Number(periodTerms.periodDuration) === expected.periodDuration\n      );\n    } catch {\n      return false;\n    }\n  };\n}\n\n/**\n * Reads the ERC-20 period-transfer `startDate` from a stored delegation.\n *\n * @param entry - Stored AUS delegation.\n * @param enforcers - Enforcer addresses used to locate the period caveat.\n * @returns Unix timestamp in seconds, or `undefined` when the caveat is\n * missing or malformed.\n */\nfunction getSubscriptionDelegationStartDate(\n  entry: DelegationResponse,\n  enforcers: SubscriptionDelegationEnforcers,\n): number | undefined {\n  const periodCaveat = entry.signedDelegation.caveats.find((caveat) =>\n    equalsIgnoreCase(caveat.enforcer, enforcers.erc20TokenPeriodTransfer),\n  );\n  if (!periodCaveat) {\n    return undefined;\n  }\n\n  try {\n    return Number(\n      decodeERC20TokenPeriodTransferTerms(periodCaveat.terms).startDate,\n    );\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Returns the fingerprint match with the latest period `startDate`.\n *\n * Equal `startDate`s keep list order. A delegation whose `startDate` cannot\n * be read sorts last.\n *\n * @param matches - Fingerprint-matching AUS delegations, in list order.\n * @param enforcers - Enforcer addresses used to read `startDate`.\n * @returns The preferred match, or `undefined` when `matches` is empty.\n */\nexport function pickLatestMatchingSubscriptionDelegation(\n  matches: readonly DelegationResponse[],\n  enforcers: SubscriptionDelegationEnforcers,\n): DelegationResponse | undefined {\n  const byStartDateDescending = [...matches].sort((left, right) => {\n    const leftStart =\n      getSubscriptionDelegationStartDate(left, enforcers) ??\n      Number.NEGATIVE_INFINITY;\n    const rightStart =\n      getSubscriptionDelegationStartDate(right, enforcers) ??\n      Number.NEGATIVE_INFINITY;\n    return rightStart - leftStart;\n  });\n\n  return byStartDateDescending[0];\n}\n"]}

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

@@ -0,0 +1,72 @@
+import type { Hex } from '@metamask/utils';
+import { PRODUCT_TYPES } from '../types.js';
+import type { RecurringInterval } from '../types.js';
+/**
+ * Storage / CHOMP metadata type for cash-subscription delegations.
+ *
+ * Defined locally so this package does not depend on an unreleased
+ * `@metamask/chomp-api-service` intent type. Production CHOMP intent
+ * registration still requires a follow-up chomp-api-service release that
+ * accepts `'cash-subscription'`.
+ */
+export declare const CASH_SUBSCRIPTION_DELEGATION_TYPE: 'cash-subscription';
+/**
+ * Request to prepare a cash-subscription delegation.
+ *
+ * The service resolves all amount, token, delegate, and trial-duration fields
+ * from authoritative pricing held by `SubscriptionController`.
+ *
+ * Only Money Account Plus is supported; Shield continues to use ERC-20
+ * approval rather than delegation.
+ */
+export type PrepareSubscriptionDelegationRequest = {
+    product: typeof PRODUCT_TYPES.MONEY_ACCOUNT_PLUS;
+    recurringInterval: RecurringInterval;
+    payerAddress: Hex;
+    /**
+     * Whether the user selected the pricing trial. Pricing `trialPeriodDays`
+     * only affects the delegation start date when this is true.
+     */
+    isTrialRequested: boolean;
+    /**
+     * When true, gates preparation on a sufficient Money Account balance
+     * (`unitAmount × minBillingCyclesForBalance` in mUSD) before side effects.
+     */
+    checkBalance?: boolean;
+    /**
+     * When true, skips CHOMP verify/intent interactions. Required for alpha
+     * until `@metamask/chomp-api-service` accepts `'cash-subscription'` intent
+     * metadata. Defaults to false (production path; unsupported until that
+     * follow-up release).
+     */
+    skipChompInteractions?: boolean;
+};
+/**
+ * Result of {@link SubscriptionDelegationService.prepareDelegation}.
+ */
+export type PreparedSubscriptionDelegation = {
+    delegationHash: Hex;
+    disposition: 'created' | 'reused';
+};
+/**
+ * Request to check whether a Money Account holds enough convertible mUSD value
+ * to cover the subscription funding requirement.
+ */
+export type MoneyAccountBalanceCheckRequest = Pick<PrepareSubscriptionDelegationRequest, 'product' | 'recurringInterval' | 'payerAddress'>;
+/**
+ * Result of {@link SubscriptionDelegationService.checkMoneyAccountBalance}.
+ * `balance` and `requiredBalance` are mUSD base units (6 decimals).
+ */
+export type MoneyAccountBalanceCheckResult = {
+    hasSufficientBalance: boolean;
+    balance: string;
+    requiredBalance: string;
+};
+/**
+ * Delegation Framework enforcers used by cash-subscription delegations.
+ */
+export type SubscriptionDelegationEnforcers = {
+    valueLte: Hex;
+    erc20TokenPeriodTransfer: Hex;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/subscription-delegation/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAE3C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD;;;;;;;GAOG;AACH,eAAO,MAAM,iCAAiC,EAAG,mBAA4B,CAAC;AAE9E;;;;;;;;GAQG;AACH,MAAM,MAAM,oCAAoC,GAAG;IACjD,OAAO,EAAE,OAAO,aAAa,CAAC,kBAAkB,CAAC;IACjD,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,YAAY,EAAE,GAAG,CAAC;IAClB;;;OAGG;IACH,gBAAgB,EAAE,OAAO,CAAC;IAC1B;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,8BAA8B,GAAG;IAC3C,cAAc,EAAE,GAAG,CAAC;IACpB,WAAW,EAAE,SAAS,GAAG,QAAQ,CAAC;CACnC,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,+BAA+B,GAAG,IAAI,CAChD,oCAAoC,EACpC,SAAS,GAAG,mBAAmB,GAAG,cAAc,CACjD,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,8BAA8B,GAAG;IAC3C,oBAAoB,EAAE,OAAO,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,+BAA+B,GAAG;IAC5C,QAAQ,EAAE,GAAG,CAAC;IACd,wBAAwB,EAAE,GAAG,CAAC;CAC/B,CAAC"}

package/dist/subscription-delegation/types.js

@@ -0,0 +1,10 @@
+/**
+ * Storage / CHOMP metadata type for cash-subscription delegations.
+ *
+ * Defined locally so this package does not depend on an unreleased
+ * `@metamask/chomp-api-service` intent type. Production CHOMP intent
+ * registration still requires a follow-up chomp-api-service release that
+ * accepts `'cash-subscription'`.
+ */
+export const CASH_SUBSCRIPTION_DELEGATION_TYPE = 'cash-subscription';
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/subscription-delegation/types.ts"],"names":[],"mappings":"AAKA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,mBAA4B,CAAC","sourcesContent":["import type { Hex } from '@metamask/utils';\n\nimport { PRODUCT_TYPES } from '../types.js';\nimport type { RecurringInterval } from '../types.js';\n\n/**\n * Storage / CHOMP metadata type for cash-subscription delegations.\n *\n * Defined locally so this package does not depend on an unreleased\n * `@metamask/chomp-api-service` intent type. Production CHOMP intent\n * registration still requires a follow-up chomp-api-service release that\n * accepts `'cash-subscription'`.\n */\nexport const CASH_SUBSCRIPTION_DELEGATION_TYPE = 'cash-subscription' as const;\n\n/**\n * Request to prepare a cash-subscription delegation.\n *\n * The service resolves all amount, token, delegate, and trial-duration fields\n * from authoritative pricing held by `SubscriptionController`.\n *\n * Only Money Account Plus is supported; Shield continues to use ERC-20\n * approval rather than delegation.\n */\nexport type PrepareSubscriptionDelegationRequest = {\n  product: typeof PRODUCT_TYPES.MONEY_ACCOUNT_PLUS;\n  recurringInterval: RecurringInterval;\n  payerAddress: Hex;\n  /**\n   * Whether the user selected the pricing trial. Pricing `trialPeriodDays`\n   * only affects the delegation start date when this is true.\n   */\n  isTrialRequested: boolean;\n  /**\n   * When true, gates preparation on a sufficient Money Account balance\n   * (`unitAmount × minBillingCyclesForBalance` in mUSD) before side effects.\n   */\n  checkBalance?: boolean;\n  /**\n   * When true, skips CHOMP verify/intent interactions. Required for alpha\n   * until `@metamask/chomp-api-service` accepts `'cash-subscription'` intent\n   * metadata. Defaults to false (production path; unsupported until that\n   * follow-up release).\n   */\n  skipChompInteractions?: boolean;\n};\n\n/**\n * Result of {@link SubscriptionDelegationService.prepareDelegation}.\n */\nexport type PreparedSubscriptionDelegation = {\n  delegationHash: Hex;\n  disposition: 'created' | 'reused';\n};\n\n/**\n * Request to check whether a Money Account holds enough convertible mUSD value\n * to cover the subscription funding requirement.\n */\nexport type MoneyAccountBalanceCheckRequest = Pick<\n  PrepareSubscriptionDelegationRequest,\n  'product' | 'recurringInterval' | 'payerAddress'\n>;\n\n/**\n * Result of {@link SubscriptionDelegationService.checkMoneyAccountBalance}.\n * `balance` and `requiredBalance` are mUSD base units (6 decimals).\n */\nexport type MoneyAccountBalanceCheckResult = {\n  hasSufficientBalance: boolean;\n  balance: string;\n  requiredBalance: string;\n};\n\n/**\n * Delegation Framework enforcers used by cash-subscription delegations.\n */\nexport type SubscriptionDelegationEnforcers = {\n  valueLte: Hex;\n  erc20TokenPeriodTransfer: Hex;\n};\n"]}