@metamask-previews/gator-permissions-controller 4.2.3-preview-3f58e8b65 → 4.2.3-preview-e0f702919

package/dist/decodePermission/decoders/erc20TokenAllowance.mjs

@@ -0,0 +1,72 @@
+import { hexToNumber } from "@metamask/utils";
+import { getByteLength, getTermsByEnforcer, splitHex, UINT256_MAX, ZERO_32_BYTES } from "../utils.mjs";
+import { erc20PayeeRule } from "./erc20PayeeRule.mjs";
+import { expiryRule } from "./expiryRule.mjs";
+import { redeemerRule } from "./redeemerRule.mjs";
+/**
+ * Builds the configuration for the erc20-token-allowance permission decoder.
+ *
+ * This permission shares the same enforcer set as `erc20-token-periodic` but
+ * is distinguished by a `periodDuration` of `UINT256_MAX`, which effectively
+ * disables the periodic reset and turns the caveat into a one-off allowance.
+ *
+ * @param contractAddresses - Checksummed enforcer addresses for the chain.
+ * @returns The erc20-token-allowance permission decoder configuration.
+ */
+export function makeErc20TokenAllowanceDecoderConfig(contractAddresses) {
+    const { timestampEnforcer, erc20PeriodicEnforcer, valueLteEnforcer, nonceEnforcer, allowedCalldataEnforcer, redeemerEnforcer, } = contractAddresses;
+    return {
+        permissionType: 'erc20-token-allowance',
+        contractAddresses,
+        optionalEnforcers: [
+            timestampEnforcer, // expiry rule
+            redeemerEnforcer, // redeemer rule
+            allowedCalldataEnforcer, // payee rule
+        ],
+        requiredEnforcers: {
+            [erc20PeriodicEnforcer]: 1,
+            [valueLteEnforcer]: 1,
+            [nonceEnforcer]: 1,
+        },
+        rules: [expiryRule, redeemerRule, erc20PayeeRule],
+        validateAndDecodeData,
+    };
+}
+/**
+ * Decodes erc20-token-allowance permission data from caveats; throws on invalid.
+ *
+ * @param caveats - Caveats from the permission context (checksummed).
+ * @param contractAddresses - Checksummed enforcer addresses for the chain.
+ * @returns Decoded allowance terms.
+ */
+function validateAndDecodeData(caveats, contractAddresses) {
+    const { erc20PeriodicEnforcer, valueLteEnforcer } = contractAddresses;
+    const valueLteTerms = getTermsByEnforcer({
+        caveats,
+        enforcer: valueLteEnforcer,
+    });
+    if (valueLteTerms !== ZERO_32_BYTES) {
+        throw new Error(`Invalid value-lte terms: must be ${ZERO_32_BYTES}`);
+    }
+    const terms = getTermsByEnforcer({
+        caveats,
+        enforcer: erc20PeriodicEnforcer,
+    });
+    const EXPECTED_TERMS_BYTELENGTH = 116; // 20 + 32 + 32 + 32
+    if (getByteLength(terms) !== EXPECTED_TERMS_BYTELENGTH) {
+        throw new Error('Invalid erc20-token-allowance terms: expected 116 bytes');
+    }
+    const [tokenAddress, allowanceAmount, periodDurationRaw, startTimeRaw] = splitHex(terms, [20, 32, 32, 32]);
+    if (periodDurationRaw.toLowerCase() !== UINT256_MAX) {
+        throw new Error('Invalid erc20-token-allowance terms: periodDuration must be UINT256_MAX');
+    }
+    const startTime = hexToNumber(startTimeRaw);
+    if (startTime === 0) {
+        throw new Error('Invalid erc20-token-allowance terms: startTime must be a positive number');
+    }
+    if (allowanceAmount === ZERO_32_BYTES) {
+        throw new Error('Invalid erc20-token-allowance terms: allowanceAmount must be a positive number');
+    }
+    return { tokenAddress, allowanceAmount, startTime };
+}
+//# sourceMappingURL=erc20TokenAllowance.mjs.map

package/dist/decodePermission/decoders/erc20TokenAllowance.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"erc20TokenAllowance.mjs","sourceRoot":"","sources":["../../../src/decodePermission/decoders/erc20TokenAllowance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,wBAAwB;AAO9C,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,QAAQ,EACR,WAAW,EACX,aAAa,EACd,qBAAoB;AACrB,OAAO,EAAE,cAAc,EAAE,6BAA4B;AACrD,OAAO,EAAE,UAAU,EAAE,yBAAwB;AAE7C,OAAO,EAAE,YAAY,EAAE,2BAA0B;AAEjD;;;;;;;;;GASG;AACH,MAAM,UAAU,oCAAoC,CAClD,iBAA6C;IAE7C,MAAM,EACJ,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,EAChB,aAAa,EACb,uBAAuB,EACvB,gBAAgB,GACjB,GAAG,iBAAiB,CAAC;IAEtB,OAAO;QACL,cAAc,EAAE,uBAAuB;QACvC,iBAAiB;QACjB,iBAAiB,EAAE;YACjB,iBAAiB,EAAE,cAAc;YACjC,gBAAgB,EAAE,gBAAgB;YAClC,uBAAuB,EAAE,aAAa;SACvC;QACD,iBAAiB,EAAE;YACjB,CAAC,qBAAqB,CAAC,EAAE,CAAC;YAC1B,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACrB,CAAC,aAAa,CAAC,EAAE,CAAC;SACnB;QACD,KAAK,EAAE,CAAC,UAAU,EAAE,YAAY,EAAE,cAAc,CAAC;QACjD,qBAAqB;KACtB,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAS,qBAAqB,CAC5B,OAAyB,EACzB,iBAA6C;IAE7C,MAAM,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,GAAG,iBAAiB,CAAC;IAEtE,MAAM,aAAa,GAAG,kBAAkB,CAAC;QACvC,OAAO;QACP,QAAQ,EAAE,gBAAgB;KAC3B,CAAC,CAAC;IACH,IAAI,aAAa,KAAK,aAAa,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,oCAAoC,aAAa,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,KAAK,GAAG,kBAAkB,CAAC;QAC/B,OAAO;QACP,QAAQ,EAAE,qBAAqB;KAChC,CAAC,CAAC;IAEH,MAAM,yBAAyB,GAAG,GAAG,CAAC,CAAC,oBAAoB;IAE3D,IAAI,aAAa,CAAC,KAAK,CAAC,KAAK,yBAAyB,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,CAAC,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,YAAY,CAAC,GACpE,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IAEpC,IAAI,iBAAiB,CAAC,WAAW,EAAE,KAAK,WAAW,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CACb,yEAAyE,CAC1E,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC;IAE5C,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CACb,0EAA0E,CAC3E,CAAC;IACJ,CAAC;IAED,IAAI,eAAe,KAAK,aAAa,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CACb,gFAAgF,CACjF,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,CAAC;AACtD,CAAC","sourcesContent":["import { hexToNumber } from '@metamask/utils';\n\nimport type {\n  ChecksumCaveat,\n  ChecksumEnforcersByChainId,\n  DecodedPermission,\n} from '../types.js';\nimport {\n  getByteLength,\n  getTermsByEnforcer,\n  splitHex,\n  UINT256_MAX,\n  ZERO_32_BYTES,\n} from '../utils.js';\nimport { erc20PayeeRule } from './erc20PayeeRule.js';\nimport { expiryRule } from './expiryRule.js';\nimport type { MakePermissionDecoderConfig } from './makePermissionDecoder.js';\nimport { redeemerRule } from './redeemerRule.js';\n\n/**\n * Builds the configuration for the erc20-token-allowance permission decoder.\n *\n * This permission shares the same enforcer set as `erc20-token-periodic` but\n * is distinguished by a `periodDuration` of `UINT256_MAX`, which effectively\n * disables the periodic reset and turns the caveat into a one-off allowance.\n *\n * @param contractAddresses - Checksummed enforcer addresses for the chain.\n * @returns The erc20-token-allowance permission decoder configuration.\n */\nexport function makeErc20TokenAllowanceDecoderConfig(\n  contractAddresses: ChecksumEnforcersByChainId,\n): MakePermissionDecoderConfig {\n  const {\n    timestampEnforcer,\n    erc20PeriodicEnforcer,\n    valueLteEnforcer,\n    nonceEnforcer,\n    allowedCalldataEnforcer,\n    redeemerEnforcer,\n  } = contractAddresses;\n\n  return {\n    permissionType: 'erc20-token-allowance',\n    contractAddresses,\n    optionalEnforcers: [\n      timestampEnforcer, // expiry rule\n      redeemerEnforcer, // redeemer rule\n      allowedCalldataEnforcer, // payee rule\n    ],\n    requiredEnforcers: {\n      [erc20PeriodicEnforcer]: 1,\n      [valueLteEnforcer]: 1,\n      [nonceEnforcer]: 1,\n    },\n    rules: [expiryRule, redeemerRule, erc20PayeeRule],\n    validateAndDecodeData,\n  };\n}\n\n/**\n * Decodes erc20-token-allowance permission data from caveats; throws on invalid.\n *\n * @param caveats - Caveats from the permission context (checksummed).\n * @param contractAddresses - Checksummed enforcer addresses for the chain.\n * @returns Decoded allowance terms.\n */\nfunction validateAndDecodeData(\n  caveats: ChecksumCaveat[],\n  contractAddresses: ChecksumEnforcersByChainId,\n): DecodedPermission['permission']['data'] {\n  const { erc20PeriodicEnforcer, valueLteEnforcer } = contractAddresses;\n\n  const valueLteTerms = getTermsByEnforcer({\n    caveats,\n    enforcer: valueLteEnforcer,\n  });\n  if (valueLteTerms !== ZERO_32_BYTES) {\n    throw new Error(`Invalid value-lte terms: must be ${ZERO_32_BYTES}`);\n  }\n\n  const terms = getTermsByEnforcer({\n    caveats,\n    enforcer: erc20PeriodicEnforcer,\n  });\n\n  const EXPECTED_TERMS_BYTELENGTH = 116; // 20 + 32 + 32 + 32\n\n  if (getByteLength(terms) !== EXPECTED_TERMS_BYTELENGTH) {\n    throw new Error('Invalid erc20-token-allowance terms: expected 116 bytes');\n  }\n\n  const [tokenAddress, allowanceAmount, periodDurationRaw, startTimeRaw] =\n    splitHex(terms, [20, 32, 32, 32]);\n\n  if (periodDurationRaw.toLowerCase() !== UINT256_MAX) {\n    throw new Error(\n      'Invalid erc20-token-allowance terms: periodDuration must be UINT256_MAX',\n    );\n  }\n\n  const startTime = hexToNumber(startTimeRaw);\n\n  if (startTime === 0) {\n    throw new Error(\n      'Invalid erc20-token-allowance terms: startTime must be a positive number',\n    );\n  }\n\n  if (allowanceAmount === ZERO_32_BYTES) {\n    throw new Error(\n      'Invalid erc20-token-allowance terms: allowanceAmount must be a positive number',\n    );\n  }\n\n  return { tokenAddress, allowanceAmount, startTime };\n}\n"]}

package/dist/decodePermission/decoders/erc20TokenPeriodic.cjs

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeErc20TokenPeriodicDecoderConfig = void 0;
+const utils_1 = require("@metamask/utils");
+const utils_js_1 = require("../utils.cjs");
+const erc20PayeeRule_js_1 = require("./erc20PayeeRule.cjs");
+const expiryRule_js_1 = require("./expiryRule.cjs");
+const redeemerRule_js_1 = require("./redeemerRule.cjs");
+/**
+ * Builds the configuration for the erc20-token-periodic permission decoder.
+ *
+ * @param contractAddresses - Checksummed enforcer addresses for the chain.
+ * @returns The erc20-token-periodic permission decoder configuration.
+ */
+function makeErc20TokenPeriodicDecoderConfig(contractAddresses) {
+    const { timestampEnforcer, erc20PeriodicEnforcer, valueLteEnforcer, nonceEnforcer, allowedCalldataEnforcer, redeemerEnforcer, } = contractAddresses;
+    return {
+        permissionType: 'erc20-token-periodic',
+        contractAddresses,
+        optionalEnforcers: [
+            timestampEnforcer, // expiry rule
+            redeemerEnforcer, // redeemer rule
+            allowedCalldataEnforcer, // payee rule
+        ],
+        requiredEnforcers: {
+            [erc20PeriodicEnforcer]: 1,
+            [valueLteEnforcer]: 1,
+            [nonceEnforcer]: 1,
+        },
+        rules: [expiryRule_js_1.expiryRule, redeemerRule_js_1.redeemerRule, erc20PayeeRule_js_1.erc20PayeeRule],
+        validateAndDecodeData,
+    };
+}
+exports.makeErc20TokenPeriodicDecoderConfig = makeErc20TokenPeriodicDecoderConfig;
+/**
+ * Decodes erc20-token-periodic permission data from caveats; throws on invalid.
+ *
+ * @param caveats - Caveats from the permission context (checksummed).
+ * @param contractAddresses - Checksummed enforcer addresses for the chain.
+ * @returns Decoded periodic terms.
+ */
+function validateAndDecodeData(caveats, contractAddresses) {
+    const { erc20PeriodicEnforcer, valueLteEnforcer } = contractAddresses;
+    const valueLteTerms = (0, utils_js_1.getTermsByEnforcer)({
+        caveats,
+        enforcer: valueLteEnforcer,
+    });
+    if (valueLteTerms !== utils_js_1.ZERO_32_BYTES) {
+        throw new Error(`Invalid value-lte terms: must be ${utils_js_1.ZERO_32_BYTES}`);
+    }
+    const terms = (0, utils_js_1.getTermsByEnforcer)({
+        caveats,
+        enforcer: erc20PeriodicEnforcer,
+    });
+    const EXPECTED_TERMS_BYTELENGTH = 116; // 20 + 32 + 32 + 32
+    if ((0, utils_js_1.getByteLength)(terms) !== EXPECTED_TERMS_BYTELENGTH) {
+        throw new Error('Invalid erc20-token-periodic terms: expected 116 bytes');
+    }
+    const [tokenAddress, periodAmount, periodDurationRaw, startTimeRaw] = (0, utils_js_1.splitHex)(terms, [20, 32, 32, 32]);
+    const periodDuration = (0, utils_1.hexToNumber)(periodDurationRaw);
+    const periodAmountBigInt = (0, utils_1.hexToBigInt)(periodAmount);
+    const startTime = (0, utils_1.hexToNumber)(startTimeRaw);
+    if (periodAmountBigInt === 0n) {
+        throw new Error('Invalid erc20-token-periodic terms: periodAmount must be a positive number');
+    }
+    if (periodDuration === 0) {
+        throw new Error('Invalid erc20-token-periodic terms: periodDuration must be a positive number');
+    }
+    if (periodDuration > utils_js_1.MAX_PERIOD_DURATION) {
+        throw new Error('Invalid erc20-token-periodic terms: periodDuration must be less than or equal to MAX_PERIOD_DURATION');
+    }
+    if (startTime === 0) {
+        throw new Error('Invalid erc20-token-periodic terms: startTime must be a positive number');
+    }
+    return { tokenAddress, periodAmount, periodDuration, startTime };
+}
+//# sourceMappingURL=erc20TokenPeriodic.cjs.map

package/dist/decodePermission/decoders/erc20TokenPeriodic.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"erc20TokenPeriodic.cjs","sourceRoot":"","sources":["../../../src/decodePermission/decoders/erc20TokenPeriodic.ts"],"names":[],"mappings":";;;AAAA,2CAA2D;AAO3D,2CAMqB;AACrB,4DAAqD;AACrD,oDAA6C;AAE7C,wDAAiD;AAEjD;;;;;GAKG;AACH,SAAgB,mCAAmC,CACjD,iBAA6C;IAE7C,MAAM,EACJ,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,EAChB,aAAa,EACb,uBAAuB,EACvB,gBAAgB,GACjB,GAAG,iBAAiB,CAAC;IAEtB,OAAO;QACL,cAAc,EAAE,sBAAsB;QACtC,iBAAiB;QACjB,iBAAiB,EAAE;YACjB,iBAAiB,EAAE,cAAc;YACjC,gBAAgB,EAAE,gBAAgB;YAClC,uBAAuB,EAAE,aAAa;SACvC;QACD,iBAAiB,EAAE;YACjB,CAAC,qBAAqB,CAAC,EAAE,CAAC;YAC1B,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACrB,CAAC,aAAa,CAAC,EAAE,CAAC;SACnB;QACD,KAAK,EAAE,CAAC,0BAAU,EAAE,8BAAY,EAAE,kCAAc,CAAC;QACjD,qBAAqB;KACtB,CAAC;AACJ,CAAC;AA5BD,kFA4BC;AAED;;;;;;GAMG;AACH,SAAS,qBAAqB,CAC5B,OAAyB,EACzB,iBAA6C;IAE7C,MAAM,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,GAAG,iBAAiB,CAAC;IAEtE,MAAM,aAAa,GAAG,IAAA,6BAAkB,EAAC;QACvC,OAAO;QACP,QAAQ,EAAE,gBAAgB;KAC3B,CAAC,CAAC;IACH,IAAI,aAAa,KAAK,wBAAa,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,oCAAoC,wBAAa,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,KAAK,GAAG,IAAA,6BAAkB,EAAC;QAC/B,OAAO;QACP,QAAQ,EAAE,qBAAqB;KAChC,CAAC,CAAC;IAEH,MAAM,yBAAyB,GAAG,GAAG,CAAC,CAAC,oBAAoB;IAE3D,IAAI,IAAA,wBAAa,EAAC,KAAK,CAAC,KAAK,yBAAyB,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;IAED,MAAM,CAAC,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,YAAY,CAAC,GACjE,IAAA,mBAAQ,EAAC,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IAEpC,MAAM,cAAc,GAAG,IAAA,mBAAW,EAAC,iBAAiB,CAAC,CAAC;IACtD,MAAM,kBAAkB,GAAG,IAAA,mBAAW,EAAC,YAAY,CAAC,CAAC;IACrD,MAAM,SAAS,GAAG,IAAA,mBAAW,EAAC,YAAY,CAAC,CAAC;IAE5C,IAAI,kBAAkB,KAAK,EAAE,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACb,4EAA4E,CAC7E,CAAC;IACJ,CAAC;IAED,IAAI,cAAc,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,8EAA8E,CAC/E,CAAC;IACJ,CAAC;IAED,IAAI,cAAc,GAAG,8BAAmB,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CACb,sGAAsG,CACvG,CAAC;IACJ,CAAC;IAED,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CACb,yEAAyE,CAC1E,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,CAAC;AACnE,CAAC","sourcesContent":["import { hexToBigInt, hexToNumber } from '@metamask/utils';\n\nimport type {\n  ChecksumCaveat,\n  ChecksumEnforcersByChainId,\n  DecodedPermission,\n} from '../types.js';\nimport {\n  getByteLength,\n  getTermsByEnforcer,\n  MAX_PERIOD_DURATION,\n  splitHex,\n  ZERO_32_BYTES,\n} from '../utils.js';\nimport { erc20PayeeRule } from './erc20PayeeRule.js';\nimport { expiryRule } from './expiryRule.js';\nimport type { MakePermissionDecoderConfig } from './makePermissionDecoder.js';\nimport { redeemerRule } from './redeemerRule.js';\n\n/**\n * Builds the configuration for the erc20-token-periodic permission decoder.\n *\n * @param contractAddresses - Checksummed enforcer addresses for the chain.\n * @returns The erc20-token-periodic permission decoder configuration.\n */\nexport function makeErc20TokenPeriodicDecoderConfig(\n  contractAddresses: ChecksumEnforcersByChainId,\n): MakePermissionDecoderConfig {\n  const {\n    timestampEnforcer,\n    erc20PeriodicEnforcer,\n    valueLteEnforcer,\n    nonceEnforcer,\n    allowedCalldataEnforcer,\n    redeemerEnforcer,\n  } = contractAddresses;\n\n  return {\n    permissionType: 'erc20-token-periodic',\n    contractAddresses,\n    optionalEnforcers: [\n      timestampEnforcer, // expiry rule\n      redeemerEnforcer, // redeemer rule\n      allowedCalldataEnforcer, // payee rule\n    ],\n    requiredEnforcers: {\n      [erc20PeriodicEnforcer]: 1,\n      [valueLteEnforcer]: 1,\n      [nonceEnforcer]: 1,\n    },\n    rules: [expiryRule, redeemerRule, erc20PayeeRule],\n    validateAndDecodeData,\n  };\n}\n\n/**\n * Decodes erc20-token-periodic permission data from caveats; throws on invalid.\n *\n * @param caveats - Caveats from the permission context (checksummed).\n * @param contractAddresses - Checksummed enforcer addresses for the chain.\n * @returns Decoded periodic terms.\n */\nfunction validateAndDecodeData(\n  caveats: ChecksumCaveat[],\n  contractAddresses: ChecksumEnforcersByChainId,\n): DecodedPermission['permission']['data'] {\n  const { erc20PeriodicEnforcer, valueLteEnforcer } = contractAddresses;\n\n  const valueLteTerms = getTermsByEnforcer({\n    caveats,\n    enforcer: valueLteEnforcer,\n  });\n  if (valueLteTerms !== ZERO_32_BYTES) {\n    throw new Error(`Invalid value-lte terms: must be ${ZERO_32_BYTES}`);\n  }\n\n  const terms = getTermsByEnforcer({\n    caveats,\n    enforcer: erc20PeriodicEnforcer,\n  });\n\n  const EXPECTED_TERMS_BYTELENGTH = 116; // 20 + 32 + 32 + 32\n\n  if (getByteLength(terms) !== EXPECTED_TERMS_BYTELENGTH) {\n    throw new Error('Invalid erc20-token-periodic terms: expected 116 bytes');\n  }\n\n  const [tokenAddress, periodAmount, periodDurationRaw, startTimeRaw] =\n    splitHex(terms, [20, 32, 32, 32]);\n\n  const periodDuration = hexToNumber(periodDurationRaw);\n  const periodAmountBigInt = hexToBigInt(periodAmount);\n  const startTime = hexToNumber(startTimeRaw);\n\n  if (periodAmountBigInt === 0n) {\n    throw new Error(\n      'Invalid erc20-token-periodic terms: periodAmount must be a positive number',\n    );\n  }\n\n  if (periodDuration === 0) {\n    throw new Error(\n      'Invalid erc20-token-periodic terms: periodDuration must be a positive number',\n    );\n  }\n\n  if (periodDuration > MAX_PERIOD_DURATION) {\n    throw new Error(\n      'Invalid erc20-token-periodic terms: periodDuration must be less than or equal to MAX_PERIOD_DURATION',\n    );\n  }\n\n  if (startTime === 0) {\n    throw new Error(\n      'Invalid erc20-token-periodic terms: startTime must be a positive number',\n    );\n  }\n\n  return { tokenAddress, periodAmount, periodDuration, startTime };\n}\n"]}

package/dist/decodePermission/decoders/erc20TokenPeriodic.d.cts

@@ -0,0 +1,10 @@
+import type { ChecksumEnforcersByChainId } from "../types.cjs";
+import type { MakePermissionDecoderConfig } from "./makePermissionDecoder.cjs";
+/**
+ * Builds the configuration for the erc20-token-periodic permission decoder.
+ *
+ * @param contractAddresses - Checksummed enforcer addresses for the chain.
+ * @returns The erc20-token-periodic permission decoder configuration.
+ */
+export declare function makeErc20TokenPeriodicDecoderConfig(contractAddresses: ChecksumEnforcersByChainId): MakePermissionDecoderConfig;
+//# sourceMappingURL=erc20TokenPeriodic.d.cts.map

package/dist/decodePermission/decoders/erc20TokenPeriodic.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"erc20TokenPeriodic.d.cts","sourceRoot":"","sources":["../../../src/decodePermission/decoders/erc20TokenPeriodic.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,0BAA0B,EAE3B,qBAAoB;AAUrB,OAAO,KAAK,EAAE,2BAA2B,EAAE,oCAAmC;AAG9E;;;;;GAKG;AACH,wBAAgB,mCAAmC,CACjD,iBAAiB,EAAE,0BAA0B,GAC5C,2BAA2B,CA0B7B"}

package/dist/decodePermission/decoders/erc20TokenPeriodic.d.mts

@@ -0,0 +1,10 @@
+import type { ChecksumEnforcersByChainId } from "../types.mjs";
+import type { MakePermissionDecoderConfig } from "./makePermissionDecoder.mjs";
+/**
+ * Builds the configuration for the erc20-token-periodic permission decoder.
+ *
+ * @param contractAddresses - Checksummed enforcer addresses for the chain.
+ * @returns The erc20-token-periodic permission decoder configuration.
+ */
+export declare function makeErc20TokenPeriodicDecoderConfig(contractAddresses: ChecksumEnforcersByChainId): MakePermissionDecoderConfig;
+//# sourceMappingURL=erc20TokenPeriodic.d.mts.map

package/dist/decodePermission/decoders/erc20TokenPeriodic.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"erc20TokenPeriodic.d.mts","sourceRoot":"","sources":["../../../src/decodePermission/decoders/erc20TokenPeriodic.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,0BAA0B,EAE3B,qBAAoB;AAUrB,OAAO,KAAK,EAAE,2BAA2B,EAAE,oCAAmC;AAG9E;;;;;GAKG;AACH,wBAAgB,mCAAmC,CACjD,iBAAiB,EAAE,0BAA0B,GAC5C,2BAA2B,CA0B7B"}

package/dist/decodePermission/decoders/erc20TokenPeriodic.mjs

@@ -0,0 +1,73 @@
+import { hexToBigInt, hexToNumber } from "@metamask/utils";
+import { getByteLength, getTermsByEnforcer, MAX_PERIOD_DURATION, splitHex, ZERO_32_BYTES } from "../utils.mjs";
+import { erc20PayeeRule } from "./erc20PayeeRule.mjs";
+import { expiryRule } from "./expiryRule.mjs";
+import { redeemerRule } from "./redeemerRule.mjs";
+/**
+ * Builds the configuration for the erc20-token-periodic permission decoder.
+ *
+ * @param contractAddresses - Checksummed enforcer addresses for the chain.
+ * @returns The erc20-token-periodic permission decoder configuration.
+ */
+export function makeErc20TokenPeriodicDecoderConfig(contractAddresses) {
+    const { timestampEnforcer, erc20PeriodicEnforcer, valueLteEnforcer, nonceEnforcer, allowedCalldataEnforcer, redeemerEnforcer, } = contractAddresses;
+    return {
+        permissionType: 'erc20-token-periodic',
+        contractAddresses,
+        optionalEnforcers: [
+            timestampEnforcer, // expiry rule
+            redeemerEnforcer, // redeemer rule
+            allowedCalldataEnforcer, // payee rule
+        ],
+        requiredEnforcers: {
+            [erc20PeriodicEnforcer]: 1,
+            [valueLteEnforcer]: 1,
+            [nonceEnforcer]: 1,
+        },
+        rules: [expiryRule, redeemerRule, erc20PayeeRule],
+        validateAndDecodeData,
+    };
+}
+/**
+ * Decodes erc20-token-periodic permission data from caveats; throws on invalid.
+ *
+ * @param caveats - Caveats from the permission context (checksummed).
+ * @param contractAddresses - Checksummed enforcer addresses for the chain.
+ * @returns Decoded periodic terms.
+ */
+function validateAndDecodeData(caveats, contractAddresses) {
+    const { erc20PeriodicEnforcer, valueLteEnforcer } = contractAddresses;
+    const valueLteTerms = getTermsByEnforcer({
+        caveats,
+        enforcer: valueLteEnforcer,
+    });
+    if (valueLteTerms !== ZERO_32_BYTES) {
+        throw new Error(`Invalid value-lte terms: must be ${ZERO_32_BYTES}`);
+    }
+    const terms = getTermsByEnforcer({
+        caveats,
+        enforcer: erc20PeriodicEnforcer,
+    });
+    const EXPECTED_TERMS_BYTELENGTH = 116; // 20 + 32 + 32 + 32
+    if (getByteLength(terms) !== EXPECTED_TERMS_BYTELENGTH) {
+        throw new Error('Invalid erc20-token-periodic terms: expected 116 bytes');
+    }
+    const [tokenAddress, periodAmount, periodDurationRaw, startTimeRaw] = splitHex(terms, [20, 32, 32, 32]);
+    const periodDuration = hexToNumber(periodDurationRaw);
+    const periodAmountBigInt = hexToBigInt(periodAmount);
+    const startTime = hexToNumber(startTimeRaw);
+    if (periodAmountBigInt === 0n) {
+        throw new Error('Invalid erc20-token-periodic terms: periodAmount must be a positive number');
+    }
+    if (periodDuration === 0) {
+        throw new Error('Invalid erc20-token-periodic terms: periodDuration must be a positive number');
+    }
+    if (periodDuration > MAX_PERIOD_DURATION) {
+        throw new Error('Invalid erc20-token-periodic terms: periodDuration must be less than or equal to MAX_PERIOD_DURATION');
+    }
+    if (startTime === 0) {
+        throw new Error('Invalid erc20-token-periodic terms: startTime must be a positive number');
+    }
+    return { tokenAddress, periodAmount, periodDuration, startTime };
+}
+//# sourceMappingURL=erc20TokenPeriodic.mjs.map

package/dist/decodePermission/decoders/erc20TokenPeriodic.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"erc20TokenPeriodic.mjs","sourceRoot":"","sources":["../../../src/decodePermission/decoders/erc20TokenPeriodic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,wBAAwB;AAO3D,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,QAAQ,EACR,aAAa,EACd,qBAAoB;AACrB,OAAO,EAAE,cAAc,EAAE,6BAA4B;AACrD,OAAO,EAAE,UAAU,EAAE,yBAAwB;AAE7C,OAAO,EAAE,YAAY,EAAE,2BAA0B;AAEjD;;;;;GAKG;AACH,MAAM,UAAU,mCAAmC,CACjD,iBAA6C;IAE7C,MAAM,EACJ,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,EAChB,aAAa,EACb,uBAAuB,EACvB,gBAAgB,GACjB,GAAG,iBAAiB,CAAC;IAEtB,OAAO;QACL,cAAc,EAAE,sBAAsB;QACtC,iBAAiB;QACjB,iBAAiB,EAAE;YACjB,iBAAiB,EAAE,cAAc;YACjC,gBAAgB,EAAE,gBAAgB;YAClC,uBAAuB,EAAE,aAAa;SACvC;QACD,iBAAiB,EAAE;YACjB,CAAC,qBAAqB,CAAC,EAAE,CAAC;YAC1B,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACrB,CAAC,aAAa,CAAC,EAAE,CAAC;SACnB;QACD,KAAK,EAAE,CAAC,UAAU,EAAE,YAAY,EAAE,cAAc,CAAC;QACjD,qBAAqB;KACtB,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAS,qBAAqB,CAC5B,OAAyB,EACzB,iBAA6C;IAE7C,MAAM,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,GAAG,iBAAiB,CAAC;IAEtE,MAAM,aAAa,GAAG,kBAAkB,CAAC;QACvC,OAAO;QACP,QAAQ,EAAE,gBAAgB;KAC3B,CAAC,CAAC;IACH,IAAI,aAAa,KAAK,aAAa,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,oCAAoC,aAAa,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,KAAK,GAAG,kBAAkB,CAAC;QAC/B,OAAO;QACP,QAAQ,EAAE,qBAAqB;KAChC,CAAC,CAAC;IAEH,MAAM,yBAAyB,GAAG,GAAG,CAAC,CAAC,oBAAoB;IAE3D,IAAI,aAAa,CAAC,KAAK,CAAC,KAAK,yBAAyB,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;IAED,MAAM,CAAC,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,YAAY,CAAC,GACjE,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IAEpC,MAAM,cAAc,GAAG,WAAW,CAAC,iBAAiB,CAAC,CAAC;IACtD,MAAM,kBAAkB,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC;IACrD,MAAM,SAAS,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC;IAE5C,IAAI,kBAAkB,KAAK,EAAE,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACb,4EAA4E,CAC7E,CAAC;IACJ,CAAC;IAED,IAAI,cAAc,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,8EAA8E,CAC/E,CAAC;IACJ,CAAC;IAED,IAAI,cAAc,GAAG,mBAAmB,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CACb,sGAAsG,CACvG,CAAC;IACJ,CAAC;IAED,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CACb,yEAAyE,CAC1E,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,CAAC;AACnE,CAAC","sourcesContent":["import { hexToBigInt, hexToNumber } from '@metamask/utils';\n\nimport type {\n  ChecksumCaveat,\n  ChecksumEnforcersByChainId,\n  DecodedPermission,\n} from '../types.js';\nimport {\n  getByteLength,\n  getTermsByEnforcer,\n  MAX_PERIOD_DURATION,\n  splitHex,\n  ZERO_32_BYTES,\n} from '../utils.js';\nimport { erc20PayeeRule } from './erc20PayeeRule.js';\nimport { expiryRule } from './expiryRule.js';\nimport type { MakePermissionDecoderConfig } from './makePermissionDecoder.js';\nimport { redeemerRule } from './redeemerRule.js';\n\n/**\n * Builds the configuration for the erc20-token-periodic permission decoder.\n *\n * @param contractAddresses - Checksummed enforcer addresses for the chain.\n * @returns The erc20-token-periodic permission decoder configuration.\n */\nexport function makeErc20TokenPeriodicDecoderConfig(\n  contractAddresses: ChecksumEnforcersByChainId,\n): MakePermissionDecoderConfig {\n  const {\n    timestampEnforcer,\n    erc20PeriodicEnforcer,\n    valueLteEnforcer,\n    nonceEnforcer,\n    allowedCalldataEnforcer,\n    redeemerEnforcer,\n  } = contractAddresses;\n\n  return {\n    permissionType: 'erc20-token-periodic',\n    contractAddresses,\n    optionalEnforcers: [\n      timestampEnforcer, // expiry rule\n      redeemerEnforcer, // redeemer rule\n      allowedCalldataEnforcer, // payee rule\n    ],\n    requiredEnforcers: {\n      [erc20PeriodicEnforcer]: 1,\n      [valueLteEnforcer]: 1,\n      [nonceEnforcer]: 1,\n    },\n    rules: [expiryRule, redeemerRule, erc20PayeeRule],\n    validateAndDecodeData,\n  };\n}\n\n/**\n * Decodes erc20-token-periodic permission data from caveats; throws on invalid.\n *\n * @param caveats - Caveats from the permission context (checksummed).\n * @param contractAddresses - Checksummed enforcer addresses for the chain.\n * @returns Decoded periodic terms.\n */\nfunction validateAndDecodeData(\n  caveats: ChecksumCaveat[],\n  contractAddresses: ChecksumEnforcersByChainId,\n): DecodedPermission['permission']['data'] {\n  const { erc20PeriodicEnforcer, valueLteEnforcer } = contractAddresses;\n\n  const valueLteTerms = getTermsByEnforcer({\n    caveats,\n    enforcer: valueLteEnforcer,\n  });\n  if (valueLteTerms !== ZERO_32_BYTES) {\n    throw new Error(`Invalid value-lte terms: must be ${ZERO_32_BYTES}`);\n  }\n\n  const terms = getTermsByEnforcer({\n    caveats,\n    enforcer: erc20PeriodicEnforcer,\n  });\n\n  const EXPECTED_TERMS_BYTELENGTH = 116; // 20 + 32 + 32 + 32\n\n  if (getByteLength(terms) !== EXPECTED_TERMS_BYTELENGTH) {\n    throw new Error('Invalid erc20-token-periodic terms: expected 116 bytes');\n  }\n\n  const [tokenAddress, periodAmount, periodDurationRaw, startTimeRaw] =\n    splitHex(terms, [20, 32, 32, 32]);\n\n  const periodDuration = hexToNumber(periodDurationRaw);\n  const periodAmountBigInt = hexToBigInt(periodAmount);\n  const startTime = hexToNumber(startTimeRaw);\n\n  if (periodAmountBigInt === 0n) {\n    throw new Error(\n      'Invalid erc20-token-periodic terms: periodAmount must be a positive number',\n    );\n  }\n\n  if (periodDuration === 0) {\n    throw new Error(\n      'Invalid erc20-token-periodic terms: periodDuration must be a positive number',\n    );\n  }\n\n  if (periodDuration > MAX_PERIOD_DURATION) {\n    throw new Error(\n      'Invalid erc20-token-periodic terms: periodDuration must be less than or equal to MAX_PERIOD_DURATION',\n    );\n  }\n\n  if (startTime === 0) {\n    throw new Error(\n      'Invalid erc20-token-periodic terms: startTime must be a positive number',\n    );\n  }\n\n  return { tokenAddress, periodAmount, periodDuration, startTime };\n}\n"]}

package/dist/decodePermission/decoders/erc20TokenRevocation.cjs

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeErc20TokenRevocationDecoderConfig = void 0;
+const utils_js_1 = require("../utils.cjs");
+const expiryRule_js_1 = require("./expiryRule.cjs");
+const redeemerRule_js_1 = require("./redeemerRule.cjs");
+/**
+ * Builds the configuration for the erc20-token-revocation permission decoder.
+ *
+ * Revocation permissions intentionally do not support a payee rule: the
+ * AllowedCalldataEnforcer is required (with count=2) to encode both the
+ * `approve` selector and the zero-amount constraint, so it cannot also be
+ * used to extract a payee address.
+ *
+ * @param contractAddresses - Checksummed enforcer addresses for the chain.
+ * @returns The erc20-token-revocation permission decoder configuration.
+ */
+function makeErc20TokenRevocationDecoderConfig(contractAddresses) {
+    const { timestampEnforcer, allowedCalldataEnforcer, valueLteEnforcer, nonceEnforcer, redeemerEnforcer, } = contractAddresses;
+    return {
+        permissionType: 'erc20-token-revocation',
+        contractAddresses,
+        optionalEnforcers: [
+            timestampEnforcer, // expiry rule
+            redeemerEnforcer, // redeemer rule
+        ],
+        requiredEnforcers: {
+            [allowedCalldataEnforcer]: 2,
+            [valueLteEnforcer]: 1,
+            [nonceEnforcer]: 1,
+        },
+        rules: [expiryRule_js_1.expiryRule, redeemerRule_js_1.redeemerRule],
+        validateAndDecodeData,
+    };
+}
+exports.makeErc20TokenRevocationDecoderConfig = makeErc20TokenRevocationDecoderConfig;
+/**
+ * Decodes erc20-token-revocation permission data from caveats; throws on invalid.
+ *
+ * @param caveats - Caveats from the permission context (checksummed).
+ * @param contractAddresses - Checksummed enforcer addresses for the chain.
+ * @returns Empty object (revocation has no decoded data payload).
+ */
+function validateAndDecodeData(caveats, contractAddresses) {
+    const { allowedCalldataEnforcer, valueLteEnforcer } = contractAddresses;
+    const allowedCalldataCaveats = caveats.filter((caveat) => caveat.enforcer === allowedCalldataEnforcer);
+    const allowedCalldataTerms = allowedCalldataCaveats.map((caveat) => caveat.terms.toLowerCase());
+    const hasApproveSelector = allowedCalldataTerms.includes(utils_js_1.ERC20_APPROVE_SELECTOR_TERMS);
+    const hasZeroAmount = allowedCalldataTerms.includes(utils_js_1.ERC20_APPROVE_ZERO_AMOUNT_TERMS);
+    if (!hasApproveSelector || !hasZeroAmount) {
+        throw new Error('Invalid erc20-token-revocation terms: expected approve selector and zero amount constraints');
+    }
+    const valueLteTerms = (0, utils_js_1.getTermsByEnforcer)({
+        caveats,
+        enforcer: valueLteEnforcer,
+    });
+    if (valueLteTerms !== utils_js_1.ZERO_32_BYTES) {
+        throw new Error('Invalid ValueLteEnforcer terms: maxValue must be 0');
+    }
+    return {};
+}
+//# sourceMappingURL=erc20TokenRevocation.cjs.map

package/dist/decodePermission/decoders/erc20TokenRevocation.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"erc20TokenRevocation.cjs","sourceRoot":"","sources":["../../../src/decodePermission/decoders/erc20TokenRevocation.ts"],"names":[],"mappings":";;;AAKA,2CAKqB;AACrB,oDAA6C;AAE7C,wDAAiD;AAEjD;;;;;;;;;;GAUG;AACH,SAAgB,qCAAqC,CACnD,iBAA6C;IAE7C,MAAM,EACJ,iBAAiB,EACjB,uBAAuB,EACvB,gBAAgB,EAChB,aAAa,EACb,gBAAgB,GACjB,GAAG,iBAAiB,CAAC;IAEtB,OAAO;QACL,cAAc,EAAE,wBAAwB;QACxC,iBAAiB;QACjB,iBAAiB,EAAE;YACjB,iBAAiB,EAAE,cAAc;YACjC,gBAAgB,EAAE,gBAAgB;SACnC;QACD,iBAAiB,EAAE;YACjB,CAAC,uBAAuB,CAAC,EAAE,CAAC;YAC5B,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACrB,CAAC,aAAa,CAAC,EAAE,CAAC;SACnB;QACD,KAAK,EAAE,CAAC,0BAAU,EAAE,8BAAY,CAAC;QACjC,qBAAqB;KACtB,CAAC;AACJ,CAAC;AA1BD,sFA0BC;AAED;;;;;;GAMG;AACH,SAAS,qBAAqB,CAC5B,OAAyB,EACzB,iBAA6C;IAE7C,MAAM,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,GAAG,iBAAiB,CAAC;IAExE,MAAM,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAC3C,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,KAAK,uBAAuB,CACxD,CAAC;IACF,MAAM,oBAAoB,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CACjE,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,CAC3B,CAAC;IAEF,MAAM,kBAAkB,GAAG,oBAAoB,CAAC,QAAQ,CACtD,uCAA4B,CAC7B,CAAC;IAEF,MAAM,aAAa,GAAG,oBAAoB,CAAC,QAAQ,CACjD,0CAA+B,CAChC,CAAC;IAEF,IAAI,CAAC,kBAAkB,IAAI,CAAC,aAAa,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CACb,6FAA6F,CAC9F,CAAC;IACJ,CAAC;IAED,MAAM,aAAa,GAAG,IAAA,6BAAkB,EAAC;QACvC,OAAO;QACP,QAAQ,EAAE,gBAAgB;KAC3B,CAAC,CAAC;IAEH,IAAI,aAAa,KAAK,wBAAa,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC","sourcesContent":["import type {\n  ChecksumCaveat,\n  ChecksumEnforcersByChainId,\n  DecodedPermission,\n} from '../types.js';\nimport {\n  ERC20_APPROVE_SELECTOR_TERMS,\n  ERC20_APPROVE_ZERO_AMOUNT_TERMS,\n  getTermsByEnforcer,\n  ZERO_32_BYTES,\n} from '../utils.js';\nimport { expiryRule } from './expiryRule.js';\nimport type { MakePermissionDecoderConfig } from './makePermissionDecoder.js';\nimport { redeemerRule } from './redeemerRule.js';\n\n/**\n * Builds the configuration for the erc20-token-revocation permission decoder.\n *\n * Revocation permissions intentionally do not support a payee rule: the\n * AllowedCalldataEnforcer is required (with count=2) to encode both the\n * `approve` selector and the zero-amount constraint, so it cannot also be\n * used to extract a payee address.\n *\n * @param contractAddresses - Checksummed enforcer addresses for the chain.\n * @returns The erc20-token-revocation permission decoder configuration.\n */\nexport function makeErc20TokenRevocationDecoderConfig(\n  contractAddresses: ChecksumEnforcersByChainId,\n): MakePermissionDecoderConfig {\n  const {\n    timestampEnforcer,\n    allowedCalldataEnforcer,\n    valueLteEnforcer,\n    nonceEnforcer,\n    redeemerEnforcer,\n  } = contractAddresses;\n\n  return {\n    permissionType: 'erc20-token-revocation',\n    contractAddresses,\n    optionalEnforcers: [\n      timestampEnforcer, // expiry rule\n      redeemerEnforcer, // redeemer rule\n    ],\n    requiredEnforcers: {\n      [allowedCalldataEnforcer]: 2,\n      [valueLteEnforcer]: 1,\n      [nonceEnforcer]: 1,\n    },\n    rules: [expiryRule, redeemerRule],\n    validateAndDecodeData,\n  };\n}\n\n/**\n * Decodes erc20-token-revocation permission data from caveats; throws on invalid.\n *\n * @param caveats - Caveats from the permission context (checksummed).\n * @param contractAddresses - Checksummed enforcer addresses for the chain.\n * @returns Empty object (revocation has no decoded data payload).\n */\nfunction validateAndDecodeData(\n  caveats: ChecksumCaveat[],\n  contractAddresses: ChecksumEnforcersByChainId,\n): DecodedPermission['permission']['data'] {\n  const { allowedCalldataEnforcer, valueLteEnforcer } = contractAddresses;\n\n  const allowedCalldataCaveats = caveats.filter(\n    (caveat) => caveat.enforcer === allowedCalldataEnforcer,\n  );\n  const allowedCalldataTerms = allowedCalldataCaveats.map((caveat) =>\n    caveat.terms.toLowerCase(),\n  );\n\n  const hasApproveSelector = allowedCalldataTerms.includes(\n    ERC20_APPROVE_SELECTOR_TERMS,\n  );\n\n  const hasZeroAmount = allowedCalldataTerms.includes(\n    ERC20_APPROVE_ZERO_AMOUNT_TERMS,\n  );\n\n  if (!hasApproveSelector || !hasZeroAmount) {\n    throw new Error(\n      'Invalid erc20-token-revocation terms: expected approve selector and zero amount constraints',\n    );\n  }\n\n  const valueLteTerms = getTermsByEnforcer({\n    caveats,\n    enforcer: valueLteEnforcer,\n  });\n\n  if (valueLteTerms !== ZERO_32_BYTES) {\n    throw new Error('Invalid ValueLteEnforcer terms: maxValue must be 0');\n  }\n\n  return {};\n}\n"]}

package/dist/decodePermission/decoders/erc20TokenRevocation.d.cts

@@ -0,0 +1,15 @@
+import type { ChecksumEnforcersByChainId } from "../types.cjs";
+import type { MakePermissionDecoderConfig } from "./makePermissionDecoder.cjs";
+/**
+ * Builds the configuration for the erc20-token-revocation permission decoder.
+ *
+ * Revocation permissions intentionally do not support a payee rule: the
+ * AllowedCalldataEnforcer is required (with count=2) to encode both the
+ * `approve` selector and the zero-amount constraint, so it cannot also be
+ * used to extract a payee address.
+ *
+ * @param contractAddresses - Checksummed enforcer addresses for the chain.
+ * @returns The erc20-token-revocation permission decoder configuration.
+ */
+export declare function makeErc20TokenRevocationDecoderConfig(contractAddresses: ChecksumEnforcersByChainId): MakePermissionDecoderConfig;
+//# sourceMappingURL=erc20TokenRevocation.d.cts.map

package/dist/decodePermission/decoders/erc20TokenRevocation.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"erc20TokenRevocation.d.cts","sourceRoot":"","sources":["../../../src/decodePermission/decoders/erc20TokenRevocation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,0BAA0B,EAE3B,qBAAoB;AAQrB,OAAO,KAAK,EAAE,2BAA2B,EAAE,oCAAmC;AAG9E;;;;;;;;;;GAUG;AACH,wBAAgB,qCAAqC,CACnD,iBAAiB,EAAE,0BAA0B,GAC5C,2BAA2B,CAwB7B"}

package/dist/decodePermission/decoders/erc20TokenRevocation.d.mts

@@ -0,0 +1,15 @@
+import type { ChecksumEnforcersByChainId } from "../types.mjs";
+import type { MakePermissionDecoderConfig } from "./makePermissionDecoder.mjs";
+/**
+ * Builds the configuration for the erc20-token-revocation permission decoder.
+ *
+ * Revocation permissions intentionally do not support a payee rule: the
+ * AllowedCalldataEnforcer is required (with count=2) to encode both the
+ * `approve` selector and the zero-amount constraint, so it cannot also be
+ * used to extract a payee address.
+ *
+ * @param contractAddresses - Checksummed enforcer addresses for the chain.
+ * @returns The erc20-token-revocation permission decoder configuration.
+ */
+export declare function makeErc20TokenRevocationDecoderConfig(contractAddresses: ChecksumEnforcersByChainId): MakePermissionDecoderConfig;
+//# sourceMappingURL=erc20TokenRevocation.d.mts.map

package/dist/decodePermission/decoders/erc20TokenRevocation.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"erc20TokenRevocation.d.mts","sourceRoot":"","sources":["../../../src/decodePermission/decoders/erc20TokenRevocation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,0BAA0B,EAE3B,qBAAoB;AAQrB,OAAO,KAAK,EAAE,2BAA2B,EAAE,oCAAmC;AAG9E;;;;;;;;;;GAUG;AACH,wBAAgB,qCAAqC,CACnD,iBAAiB,EAAE,0BAA0B,GAC5C,2BAA2B,CAwB7B"}

package/dist/decodePermission/decoders/erc20TokenRevocation.mjs

@@ -0,0 +1,58 @@
+import { ERC20_APPROVE_SELECTOR_TERMS, ERC20_APPROVE_ZERO_AMOUNT_TERMS, getTermsByEnforcer, ZERO_32_BYTES } from "../utils.mjs";
+import { expiryRule } from "./expiryRule.mjs";
+import { redeemerRule } from "./redeemerRule.mjs";
+/**
+ * Builds the configuration for the erc20-token-revocation permission decoder.
+ *
+ * Revocation permissions intentionally do not support a payee rule: the
+ * AllowedCalldataEnforcer is required (with count=2) to encode both the
+ * `approve` selector and the zero-amount constraint, so it cannot also be
+ * used to extract a payee address.
+ *
+ * @param contractAddresses - Checksummed enforcer addresses for the chain.
+ * @returns The erc20-token-revocation permission decoder configuration.
+ */
+export function makeErc20TokenRevocationDecoderConfig(contractAddresses) {
+    const { timestampEnforcer, allowedCalldataEnforcer, valueLteEnforcer, nonceEnforcer, redeemerEnforcer, } = contractAddresses;
+    return {
+        permissionType: 'erc20-token-revocation',
+        contractAddresses,
+        optionalEnforcers: [
+            timestampEnforcer, // expiry rule
+            redeemerEnforcer, // redeemer rule
+        ],
+        requiredEnforcers: {
+            [allowedCalldataEnforcer]: 2,
+            [valueLteEnforcer]: 1,
+            [nonceEnforcer]: 1,
+        },
+        rules: [expiryRule, redeemerRule],
+        validateAndDecodeData,
+    };
+}
+/**
+ * Decodes erc20-token-revocation permission data from caveats; throws on invalid.
+ *
+ * @param caveats - Caveats from the permission context (checksummed).
+ * @param contractAddresses - Checksummed enforcer addresses for the chain.
+ * @returns Empty object (revocation has no decoded data payload).
+ */
+function validateAndDecodeData(caveats, contractAddresses) {
+    const { allowedCalldataEnforcer, valueLteEnforcer } = contractAddresses;
+    const allowedCalldataCaveats = caveats.filter((caveat) => caveat.enforcer === allowedCalldataEnforcer);
+    const allowedCalldataTerms = allowedCalldataCaveats.map((caveat) => caveat.terms.toLowerCase());
+    const hasApproveSelector = allowedCalldataTerms.includes(ERC20_APPROVE_SELECTOR_TERMS);
+    const hasZeroAmount = allowedCalldataTerms.includes(ERC20_APPROVE_ZERO_AMOUNT_TERMS);
+    if (!hasApproveSelector || !hasZeroAmount) {
+        throw new Error('Invalid erc20-token-revocation terms: expected approve selector and zero amount constraints');
+    }
+    const valueLteTerms = getTermsByEnforcer({
+        caveats,
+        enforcer: valueLteEnforcer,
+    });
+    if (valueLteTerms !== ZERO_32_BYTES) {
+        throw new Error('Invalid ValueLteEnforcer terms: maxValue must be 0');
+    }
+    return {};
+}
+//# sourceMappingURL=erc20TokenRevocation.mjs.map

package/dist/decodePermission/decoders/erc20TokenRevocation.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"erc20TokenRevocation.mjs","sourceRoot":"","sources":["../../../src/decodePermission/decoders/erc20TokenRevocation.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,4BAA4B,EAC5B,+BAA+B,EAC/B,kBAAkB,EAClB,aAAa,EACd,qBAAoB;AACrB,OAAO,EAAE,UAAU,EAAE,yBAAwB;AAE7C,OAAO,EAAE,YAAY,EAAE,2BAA0B;AAEjD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,qCAAqC,CACnD,iBAA6C;IAE7C,MAAM,EACJ,iBAAiB,EACjB,uBAAuB,EACvB,gBAAgB,EAChB,aAAa,EACb,gBAAgB,GACjB,GAAG,iBAAiB,CAAC;IAEtB,OAAO;QACL,cAAc,EAAE,wBAAwB;QACxC,iBAAiB;QACjB,iBAAiB,EAAE;YACjB,iBAAiB,EAAE,cAAc;YACjC,gBAAgB,EAAE,gBAAgB;SACnC;QACD,iBAAiB,EAAE;YACjB,CAAC,uBAAuB,CAAC,EAAE,CAAC;YAC5B,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACrB,CAAC,aAAa,CAAC,EAAE,CAAC;SACnB;QACD,KAAK,EAAE,CAAC,UAAU,EAAE,YAAY,CAAC;QACjC,qBAAqB;KACtB,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAS,qBAAqB,CAC5B,OAAyB,EACzB,iBAA6C;IAE7C,MAAM,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,GAAG,iBAAiB,CAAC;IAExE,MAAM,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAC3C,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,KAAK,uBAAuB,CACxD,CAAC;IACF,MAAM,oBAAoB,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CACjE,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,CAC3B,CAAC;IAEF,MAAM,kBAAkB,GAAG,oBAAoB,CAAC,QAAQ,CACtD,4BAA4B,CAC7B,CAAC;IAEF,MAAM,aAAa,GAAG,oBAAoB,CAAC,QAAQ,CACjD,+BAA+B,CAChC,CAAC;IAEF,IAAI,CAAC,kBAAkB,IAAI,CAAC,aAAa,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CACb,6FAA6F,CAC9F,CAAC;IACJ,CAAC;IAED,MAAM,aAAa,GAAG,kBAAkB,CAAC;QACvC,OAAO;QACP,QAAQ,EAAE,gBAAgB;KAC3B,CAAC,CAAC;IAEH,IAAI,aAAa,KAAK,aAAa,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC","sourcesContent":["import type {\n  ChecksumCaveat,\n  ChecksumEnforcersByChainId,\n  DecodedPermission,\n} from '../types.js';\nimport {\n  ERC20_APPROVE_SELECTOR_TERMS,\n  ERC20_APPROVE_ZERO_AMOUNT_TERMS,\n  getTermsByEnforcer,\n  ZERO_32_BYTES,\n} from '../utils.js';\nimport { expiryRule } from './expiryRule.js';\nimport type { MakePermissionDecoderConfig } from './makePermissionDecoder.js';\nimport { redeemerRule } from './redeemerRule.js';\n\n/**\n * Builds the configuration for the erc20-token-revocation permission decoder.\n *\n * Revocation permissions intentionally do not support a payee rule: the\n * AllowedCalldataEnforcer is required (with count=2) to encode both the\n * `approve` selector and the zero-amount constraint, so it cannot also be\n * used to extract a payee address.\n *\n * @param contractAddresses - Checksummed enforcer addresses for the chain.\n * @returns The erc20-token-revocation permission decoder configuration.\n */\nexport function makeErc20TokenRevocationDecoderConfig(\n  contractAddresses: ChecksumEnforcersByChainId,\n): MakePermissionDecoderConfig {\n  const {\n    timestampEnforcer,\n    allowedCalldataEnforcer,\n    valueLteEnforcer,\n    nonceEnforcer,\n    redeemerEnforcer,\n  } = contractAddresses;\n\n  return {\n    permissionType: 'erc20-token-revocation',\n    contractAddresses,\n    optionalEnforcers: [\n      timestampEnforcer, // expiry rule\n      redeemerEnforcer, // redeemer rule\n    ],\n    requiredEnforcers: {\n      [allowedCalldataEnforcer]: 2,\n      [valueLteEnforcer]: 1,\n      [nonceEnforcer]: 1,\n    },\n    rules: [expiryRule, redeemerRule],\n    validateAndDecodeData,\n  };\n}\n\n/**\n * Decodes erc20-token-revocation permission data from caveats; throws on invalid.\n *\n * @param caveats - Caveats from the permission context (checksummed).\n * @param contractAddresses - Checksummed enforcer addresses for the chain.\n * @returns Empty object (revocation has no decoded data payload).\n */\nfunction validateAndDecodeData(\n  caveats: ChecksumCaveat[],\n  contractAddresses: ChecksumEnforcersByChainId,\n): DecodedPermission['permission']['data'] {\n  const { allowedCalldataEnforcer, valueLteEnforcer } = contractAddresses;\n\n  const allowedCalldataCaveats = caveats.filter(\n    (caveat) => caveat.enforcer === allowedCalldataEnforcer,\n  );\n  const allowedCalldataTerms = allowedCalldataCaveats.map((caveat) =>\n    caveat.terms.toLowerCase(),\n  );\n\n  const hasApproveSelector = allowedCalldataTerms.includes(\n    ERC20_APPROVE_SELECTOR_TERMS,\n  );\n\n  const hasZeroAmount = allowedCalldataTerms.includes(\n    ERC20_APPROVE_ZERO_AMOUNT_TERMS,\n  );\n\n  if (!hasApproveSelector || !hasZeroAmount) {\n    throw new Error(\n      'Invalid erc20-token-revocation terms: expected approve selector and zero amount constraints',\n    );\n  }\n\n  const valueLteTerms = getTermsByEnforcer({\n    caveats,\n    enforcer: valueLteEnforcer,\n  });\n\n  if (valueLteTerms !== ZERO_32_BYTES) {\n    throw new Error('Invalid ValueLteEnforcer terms: maxValue must be 0');\n  }\n\n  return {};\n}\n"]}

package/dist/decodePermission/decoders/erc20TokenStream.cjs

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeErc20TokenStreamDecoderConfig = void 0;
+const utils_1 = require("@metamask/utils");
+const utils_js_1 = require("../utils.cjs");
+const erc20PayeeRule_js_1 = require("./erc20PayeeRule.cjs");
+const expiryRule_js_1 = require("./expiryRule.cjs");
+const redeemerRule_js_1 = require("./redeemerRule.cjs");
+/**
+ * Builds the configuration for the erc20-token-stream permission decoder.
+ *
+ * @param contractAddresses - Checksummed enforcer addresses for the chain.
+ * @returns The erc20-token-stream permission decoder configuration.
+ */
+function makeErc20TokenStreamDecoderConfig(contractAddresses) {
+    const { timestampEnforcer, erc20StreamingEnforcer, valueLteEnforcer, nonceEnforcer, allowedCalldataEnforcer, redeemerEnforcer, } = contractAddresses;
+    return {
+        permissionType: 'erc20-token-stream',
+        contractAddresses,
+        optionalEnforcers: [
+            timestampEnforcer, // expiry rule
+            redeemerEnforcer, // redeemer rule
+            allowedCalldataEnforcer, // payee rule
+        ],
+        requiredEnforcers: {
+            [erc20StreamingEnforcer]: 1,
+            [valueLteEnforcer]: 1,
+            [nonceEnforcer]: 1,
+        },
+        rules: [expiryRule_js_1.expiryRule, redeemerRule_js_1.redeemerRule, erc20PayeeRule_js_1.erc20PayeeRule],
+        validateAndDecodeData,
+    };
+}
+exports.makeErc20TokenStreamDecoderConfig = makeErc20TokenStreamDecoderConfig;
+/**
+ * Decodes erc20-token-stream permission data from caveats; throws on invalid.
+ *
+ * @param caveats - Caveats from the permission context (checksummed).
+ * @param contractAddresses - Checksummed enforcer addresses for the chain.
+ * @returns Decoded stream terms.
+ */
+function validateAndDecodeData(caveats, contractAddresses) {
+    const { erc20StreamingEnforcer, valueLteEnforcer } = contractAddresses;
+    const valueLteTerms = (0, utils_js_1.getTermsByEnforcer)({
+        caveats,
+        enforcer: valueLteEnforcer,
+    });
+    if (valueLteTerms !== utils_js_1.ZERO_32_BYTES) {
+        throw new Error(`Invalid value-lte terms: must be ${utils_js_1.ZERO_32_BYTES}`);
+    }
+    const terms = (0, utils_js_1.getTermsByEnforcer)({
+        caveats,
+        enforcer: erc20StreamingEnforcer,
+    });
+    const EXPECTED_TERMS_BYTELENGTH = 148;
+    if ((0, utils_js_1.getByteLength)(terms) !== EXPECTED_TERMS_BYTELENGTH) {
+        throw new Error('Invalid erc20-token-stream terms: expected 148 bytes');
+    }
+    const [tokenAddress, initialAmount, maxAmount, amountPerSecond, startTimeRaw,] = (0, utils_js_1.splitHex)(terms, [20, 32, 32, 32, 32]);
+    const startTime = (0, utils_1.hexToNumber)(startTimeRaw);
+    const initialAmountBigInt = (0, utils_1.hexToBigInt)(initialAmount);
+    const maxAmountBigInt = (0, utils_1.hexToBigInt)(maxAmount);
+    const amountPerSecondBigInt = (0, utils_1.hexToBigInt)(amountPerSecond);
+    if (maxAmountBigInt <= initialAmountBigInt) {
+        throw new Error('Invalid erc20-token-stream terms: maxAmount must be greater than initialAmount');
+    }
+    if (amountPerSecondBigInt === 0n) {
+        throw new Error('Invalid erc20-token-stream terms: amountPerSecond must be a positive number');
+    }
+    if (startTime === 0) {
+        throw new Error('Invalid erc20-token-stream terms: startTime must be a positive number');
+    }
+    return {
+        tokenAddress,
+        initialAmount,
+        maxAmount,
+        amountPerSecond,
+        startTime,
+    };
+}
+//# sourceMappingURL=erc20TokenStream.cjs.map

package/dist/decodePermission/decoders/erc20TokenStream.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"erc20TokenStream.cjs","sourceRoot":"","sources":["../../../src/decodePermission/decoders/erc20TokenStream.ts"],"names":[],"mappings":";;;AAAA,2CAA2D;AAO3D,2CAKqB;AACrB,4DAAqD;AACrD,oDAA6C;AAE7C,wDAAiD;AAEjD;;;;;GAKG;AACH,SAAgB,iCAAiC,CAC/C,iBAA6C;IAE7C,MAAM,EACJ,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EAChB,aAAa,EACb,uBAAuB,EACvB,gBAAgB,GACjB,GAAG,iBAAiB,CAAC;IAEtB,OAAO;QACL,cAAc,EAAE,oBAAoB;QACpC,iBAAiB;QACjB,iBAAiB,EAAE;YACjB,iBAAiB,EAAE,cAAc;YACjC,gBAAgB,EAAE,gBAAgB;YAClC,uBAAuB,EAAE,aAAa;SACvC;QACD,iBAAiB,EAAE;YACjB,CAAC,sBAAsB,CAAC,EAAE,CAAC;YAC3B,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACrB,CAAC,aAAa,CAAC,EAAE,CAAC;SACnB;QACD,KAAK,EAAE,CAAC,0BAAU,EAAE,8BAAY,EAAE,kCAAc,CAAC;QACjD,qBAAqB;KACtB,CAAC;AACJ,CAAC;AA5BD,8EA4BC;AAED;;;;;;GAMG;AACH,SAAS,qBAAqB,CAC5B,OAAyB,EACzB,iBAA6C;IAE7C,MAAM,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,GAAG,iBAAiB,CAAC;IACvE,MAAM,aAAa,GAAG,IAAA,6BAAkB,EAAC;QACvC,OAAO;QACP,QAAQ,EAAE,gBAAgB;KAC3B,CAAC,CAAC;IAEH,IAAI,aAAa,KAAK,wBAAa,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,oCAAoC,wBAAa,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,KAAK,GAAG,IAAA,6BAAkB,EAAC;QAC/B,OAAO;QACP,QAAQ,EAAE,sBAAsB;KACjC,CAAC,CAAC;IAEH,MAAM,yBAAyB,GAAG,GAAG,CAAC;IAEtC,IAAI,IAAA,wBAAa,EAAC,KAAK,CAAC,KAAK,yBAAyB,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC1E,CAAC;IAED,MAAM,CACJ,YAAY,EACZ,aAAa,EACb,SAAS,EACT,eAAe,EACf,YAAY,EACb,GAAG,IAAA,mBAAQ,EAAC,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IAE1C,MAAM,SAAS,GAAG,IAAA,mBAAW,EAAC,YAAY,CAAC,CAAC;IAC5C,MAAM,mBAAmB,GAAG,IAAA,mBAAW,EAAC,aAAa,CAAC,CAAC;IACvD,MAAM,eAAe,GAAG,IAAA,mBAAW,EAAC,SAAS,CAAC,CAAC;IAC/C,MAAM,qBAAqB,GAAG,IAAA,mBAAW,EAAC,eAAe,CAAC,CAAC;IAE3D,IAAI,eAAe,IAAI,mBAAmB,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CACb,gFAAgF,CACjF,CAAC;IACJ,CAAC;IAED,IAAI,qBAAqB,KAAK,EAAE,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CACb,6EAA6E,CAC9E,CAAC;IACJ,CAAC;IAED,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CACb,uEAAuE,CACxE,CAAC;IACJ,CAAC;IAED,OAAO;QACL,YAAY;QACZ,aAAa;QACb,SAAS;QACT,eAAe;QACf,SAAS;KACV,CAAC;AACJ,CAAC","sourcesContent":["import { hexToBigInt, hexToNumber } from '@metamask/utils';\n\nimport type {\n  ChecksumCaveat,\n  ChecksumEnforcersByChainId,\n  DecodedPermission,\n} from '../types.js';\nimport {\n  getByteLength,\n  getTermsByEnforcer,\n  splitHex,\n  ZERO_32_BYTES,\n} from '../utils.js';\nimport { erc20PayeeRule } from './erc20PayeeRule.js';\nimport { expiryRule } from './expiryRule.js';\nimport type { MakePermissionDecoderConfig } from './makePermissionDecoder.js';\nimport { redeemerRule } from './redeemerRule.js';\n\n/**\n * Builds the configuration for the erc20-token-stream permission decoder.\n *\n * @param contractAddresses - Checksummed enforcer addresses for the chain.\n * @returns The erc20-token-stream permission decoder configuration.\n */\nexport function makeErc20TokenStreamDecoderConfig(\n  contractAddresses: ChecksumEnforcersByChainId,\n): MakePermissionDecoderConfig {\n  const {\n    timestampEnforcer,\n    erc20StreamingEnforcer,\n    valueLteEnforcer,\n    nonceEnforcer,\n    allowedCalldataEnforcer,\n    redeemerEnforcer,\n  } = contractAddresses;\n\n  return {\n    permissionType: 'erc20-token-stream',\n    contractAddresses,\n    optionalEnforcers: [\n      timestampEnforcer, // expiry rule\n      redeemerEnforcer, // redeemer rule\n      allowedCalldataEnforcer, // payee rule\n    ],\n    requiredEnforcers: {\n      [erc20StreamingEnforcer]: 1,\n      [valueLteEnforcer]: 1,\n      [nonceEnforcer]: 1,\n    },\n    rules: [expiryRule, redeemerRule, erc20PayeeRule],\n    validateAndDecodeData,\n  };\n}\n\n/**\n * Decodes erc20-token-stream permission data from caveats; throws on invalid.\n *\n * @param caveats - Caveats from the permission context (checksummed).\n * @param contractAddresses - Checksummed enforcer addresses for the chain.\n * @returns Decoded stream terms.\n */\nfunction validateAndDecodeData(\n  caveats: ChecksumCaveat[],\n  contractAddresses: ChecksumEnforcersByChainId,\n): DecodedPermission['permission']['data'] {\n  const { erc20StreamingEnforcer, valueLteEnforcer } = contractAddresses;\n  const valueLteTerms = getTermsByEnforcer({\n    caveats,\n    enforcer: valueLteEnforcer,\n  });\n\n  if (valueLteTerms !== ZERO_32_BYTES) {\n    throw new Error(`Invalid value-lte terms: must be ${ZERO_32_BYTES}`);\n  }\n\n  const terms = getTermsByEnforcer({\n    caveats,\n    enforcer: erc20StreamingEnforcer,\n  });\n\n  const EXPECTED_TERMS_BYTELENGTH = 148;\n\n  if (getByteLength(terms) !== EXPECTED_TERMS_BYTELENGTH) {\n    throw new Error('Invalid erc20-token-stream terms: expected 148 bytes');\n  }\n\n  const [\n    tokenAddress,\n    initialAmount,\n    maxAmount,\n    amountPerSecond,\n    startTimeRaw,\n  ] = splitHex(terms, [20, 32, 32, 32, 32]);\n\n  const startTime = hexToNumber(startTimeRaw);\n  const initialAmountBigInt = hexToBigInt(initialAmount);\n  const maxAmountBigInt = hexToBigInt(maxAmount);\n  const amountPerSecondBigInt = hexToBigInt(amountPerSecond);\n\n  if (maxAmountBigInt <= initialAmountBigInt) {\n    throw new Error(\n      'Invalid erc20-token-stream terms: maxAmount must be greater than initialAmount',\n    );\n  }\n\n  if (amountPerSecondBigInt === 0n) {\n    throw new Error(\n      'Invalid erc20-token-stream terms: amountPerSecond must be a positive number',\n    );\n  }\n\n  if (startTime === 0) {\n    throw new Error(\n      'Invalid erc20-token-stream terms: startTime must be a positive number',\n    );\n  }\n\n  return {\n    tokenAddress,\n    initialAmount,\n    maxAmount,\n    amountPerSecond,\n    startTime,\n  };\n}\n"]}

package/dist/decodePermission/decoders/erc20TokenStream.d.cts

@@ -0,0 +1,10 @@
+import type { ChecksumEnforcersByChainId } from "../types.cjs";
+import type { MakePermissionDecoderConfig } from "./makePermissionDecoder.cjs";
+/**
+ * Builds the configuration for the erc20-token-stream permission decoder.
+ *
+ * @param contractAddresses - Checksummed enforcer addresses for the chain.
+ * @returns The erc20-token-stream permission decoder configuration.
+ */
+export declare function makeErc20TokenStreamDecoderConfig(contractAddresses: ChecksumEnforcersByChainId): MakePermissionDecoderConfig;
+//# sourceMappingURL=erc20TokenStream.d.cts.map

package/dist/decodePermission/decoders/erc20TokenStream.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"erc20TokenStream.d.cts","sourceRoot":"","sources":["../../../src/decodePermission/decoders/erc20TokenStream.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,0BAA0B,EAE3B,qBAAoB;AASrB,OAAO,KAAK,EAAE,2BAA2B,EAAE,oCAAmC;AAG9E;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAC/C,iBAAiB,EAAE,0BAA0B,GAC5C,2BAA2B,CA0B7B"}

package/dist/decodePermission/decoders/erc20TokenStream.d.mts

@@ -0,0 +1,10 @@
+import type { ChecksumEnforcersByChainId } from "../types.mjs";
+import type { MakePermissionDecoderConfig } from "./makePermissionDecoder.mjs";
+/**
+ * Builds the configuration for the erc20-token-stream permission decoder.
+ *
+ * @param contractAddresses - Checksummed enforcer addresses for the chain.
+ * @returns The erc20-token-stream permission decoder configuration.
+ */
+export declare function makeErc20TokenStreamDecoderConfig(contractAddresses: ChecksumEnforcersByChainId): MakePermissionDecoderConfig;
+//# sourceMappingURL=erc20TokenStream.d.mts.map

package/dist/decodePermission/decoders/erc20TokenStream.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"erc20TokenStream.d.mts","sourceRoot":"","sources":["../../../src/decodePermission/decoders/erc20TokenStream.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,0BAA0B,EAE3B,qBAAoB;AASrB,OAAO,KAAK,EAAE,2BAA2B,EAAE,oCAAmC;AAG9E;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAC/C,iBAAiB,EAAE,0BAA0B,GAC5C,2BAA2B,CA0B7B"}