@metamask/gator-permissions-controller 1.0.0 → 1.1.1

package/dist/decodePermission/utils.d.cts

@@ -18,15 +18,15 @@ export type PermissionRule = {
  * @throws If the chain or an expected enforcer contract is not found.
  */
 export declare const getChecksumEnforcersByChainId: (contracts: DeployedContractsByName) => {
-    erc20StreamingEnforcer: `0x${string}`;
-    erc20PeriodicEnforcer: `0x${string}`;
-    nativeTokenStreamingEnforcer: `0x${string}`;
-    nativeTokenPeriodicEnforcer: `0x${string}`;
-    exactCalldataEnforcer: `0x${string}`;
-    valueLteEnforcer: `0x${string}`;
-    timestampEnforcer: `0x${string}`;
-    nonceEnforcer: `0x${string}`;
-    allowedCalldataEnforcer: `0x${string}`;
+    erc20StreamingEnforcer: Hex;
+    erc20PeriodicEnforcer: Hex;
+    nativeTokenStreamingEnforcer: Hex;
+    nativeTokenPeriodicEnforcer: Hex;
+    exactCalldataEnforcer: Hex;
+    valueLteEnforcer: Hex;
+    timestampEnforcer: Hex;
+    nonceEnforcer: Hex;
+    allowedCalldataEnforcer: Hex;
 };
 /**
  * Builds the canonical set of permission matching rules for a chain.
@@ -47,7 +47,7 @@ export declare const createPermissionRulesForChainId: (contracts: DeployedContra
  * @param superset - The set expected to contain all elements of `subset`.
  * @returns `true` if `subset` ⊆ `superset`, otherwise `false`.
  */
-export declare const isSubset: <T>(subset: Set<T>, superset: Set<T>) => boolean;
+export declare const isSubset: <TElement>(subset: Set<TElement>, superset: Set<TElement>) => boolean;
 /**
  * Gets the terms for a given enforcer from a list of caveats.
  *

package/dist/decodePermission/utils.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.cts","sourceRoot":"","sources":["../../src/decodePermission/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,kCAAkC;AAExD,OAAO,KAAK,EAAE,GAAG,EAAE,wBAAwB;AAE3C,OAAO,KAAK,EAAE,uBAAuB,EAAE,cAAc,EAAE,oBAAgB;AAEvE;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,cAAc,EAAE,cAAc,CAAC;IAC/B,iBAAiB,EAAE,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACpC,iBAAiB,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;CAC7B,CAAC;AAiBF;;;;;;;GAOG;AACH,eAAO,MAAM,6BAA6B,cAC7B,uBAAuB;;;;;;;;;;CAuDnC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,+BAA+B,EAAE,CAC5C,SAAS,EAAE,uBAAuB,KAC/B,cAAc,EAiElB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,2CAA0C,OAO9D,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,gBAAgB,SAAS,OAAO,GAAG,IAAI,EAAE,EAC1E,OAAO,EACP,QAAQ,EACR,eAAe,GAChB,EAAE;IACD,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IACvB,QAAQ,EAAE,GAAG,CAAC;IACd,eAAe,CAAC,EAAE,gBAAgB,CAAC;CACpC,GAAG,gBAAgB,SAAS,IAAI,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,CAiBnD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,GAAG,EAAE,CAU7D"}
+{"version":3,"file":"utils.d.cts","sourceRoot":"","sources":["../../src/decodePermission/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,kCAAkC;AAExD,OAAO,KAAK,EAAE,GAAG,EAAE,wBAAwB;AAE3C,OAAO,KAAK,EAAE,uBAAuB,EAAE,cAAc,EAAE,oBAAgB;AAEvE;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,cAAc,EAAE,cAAc,CAAC;IAC/B,iBAAiB,EAAE,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACpC,iBAAiB,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;CAC7B,CAAC;AAiBF;;;;;;;GAOG;AACH,eAAO,MAAM,6BAA6B,cAC7B,uBAAuB;4BAEV,GAAG;2BACJ,GAAG;kCACI,GAAG;iCACJ,GAAG;2BACT,GAAG;sBACR,GAAG;uBACF,GAAG;mBACP,GAAG;6BACO,GAAG;CAuD7B,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,+BAA+B,EAAE,CAC5C,SAAS,EAAE,uBAAuB,KAC/B,cAAc,EAiElB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,gEAGlB,OAOF,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,gBAAgB,SAAS,OAAO,GAAG,IAAI,EAAE,EAC1E,OAAO,EACP,QAAQ,EACR,eAAe,GAChB,EAAE;IACD,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IACvB,QAAQ,EAAE,GAAG,CAAC;IACd,eAAe,CAAC,EAAE,gBAAgB,CAAC;CACpC,GAAG,gBAAgB,SAAS,IAAI,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,CAiBnD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,GAAG,EAAE,CAU7D"}

package/dist/decodePermission/utils.d.mts

@@ -18,15 +18,15 @@ export type PermissionRule = {
  * @throws If the chain or an expected enforcer contract is not found.
  */
 export declare const getChecksumEnforcersByChainId: (contracts: DeployedContractsByName) => {
-    erc20StreamingEnforcer: `0x${string}`;
-    erc20PeriodicEnforcer: `0x${string}`;
-    nativeTokenStreamingEnforcer: `0x${string}`;
-    nativeTokenPeriodicEnforcer: `0x${string}`;
-    exactCalldataEnforcer: `0x${string}`;
-    valueLteEnforcer: `0x${string}`;
-    timestampEnforcer: `0x${string}`;
-    nonceEnforcer: `0x${string}`;
-    allowedCalldataEnforcer: `0x${string}`;
+    erc20StreamingEnforcer: Hex;
+    erc20PeriodicEnforcer: Hex;
+    nativeTokenStreamingEnforcer: Hex;
+    nativeTokenPeriodicEnforcer: Hex;
+    exactCalldataEnforcer: Hex;
+    valueLteEnforcer: Hex;
+    timestampEnforcer: Hex;
+    nonceEnforcer: Hex;
+    allowedCalldataEnforcer: Hex;
 };
 /**
  * Builds the canonical set of permission matching rules for a chain.
@@ -47,7 +47,7 @@ export declare const createPermissionRulesForChainId: (contracts: DeployedContra
  * @param superset - The set expected to contain all elements of `subset`.
  * @returns `true` if `subset` ⊆ `superset`, otherwise `false`.
  */
-export declare const isSubset: <T>(subset: Set<T>, superset: Set<T>) => boolean;
+export declare const isSubset: <TElement>(subset: Set<TElement>, superset: Set<TElement>) => boolean;
 /**
  * Gets the terms for a given enforcer from a list of caveats.
  *

package/dist/decodePermission/utils.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.mts","sourceRoot":"","sources":["../../src/decodePermission/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,kCAAkC;AAExD,OAAO,KAAK,EAAE,GAAG,EAAE,wBAAwB;AAE3C,OAAO,KAAK,EAAE,uBAAuB,EAAE,cAAc,EAAE,oBAAgB;AAEvE;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,cAAc,EAAE,cAAc,CAAC;IAC/B,iBAAiB,EAAE,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACpC,iBAAiB,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;CAC7B,CAAC;AAiBF;;;;;;;GAOG;AACH,eAAO,MAAM,6BAA6B,cAC7B,uBAAuB;;;;;;;;;;CAuDnC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,+BAA+B,EAAE,CAC5C,SAAS,EAAE,uBAAuB,KAC/B,cAAc,EAiElB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,2CAA0C,OAO9D,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,gBAAgB,SAAS,OAAO,GAAG,IAAI,EAAE,EAC1E,OAAO,EACP,QAAQ,EACR,eAAe,GAChB,EAAE;IACD,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IACvB,QAAQ,EAAE,GAAG,CAAC;IACd,eAAe,CAAC,EAAE,gBAAgB,CAAC;CACpC,GAAG,gBAAgB,SAAS,IAAI,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,CAiBnD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,GAAG,EAAE,CAU7D"}
+{"version":3,"file":"utils.d.mts","sourceRoot":"","sources":["../../src/decodePermission/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,kCAAkC;AAExD,OAAO,KAAK,EAAE,GAAG,EAAE,wBAAwB;AAE3C,OAAO,KAAK,EAAE,uBAAuB,EAAE,cAAc,EAAE,oBAAgB;AAEvE;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,cAAc,EAAE,cAAc,CAAC;IAC/B,iBAAiB,EAAE,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACpC,iBAAiB,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;CAC7B,CAAC;AAiBF;;;;;;;GAOG;AACH,eAAO,MAAM,6BAA6B,cAC7B,uBAAuB;4BAEV,GAAG;2BACJ,GAAG;kCACI,GAAG;iCACJ,GAAG;2BACT,GAAG;sBACR,GAAG;uBACF,GAAG;mBACP,GAAG;6BACO,GAAG;CAuD7B,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,+BAA+B,EAAE,CAC5C,SAAS,EAAE,uBAAuB,KAC/B,cAAc,EAiElB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,gEAGlB,OAOF,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,gBAAgB,SAAS,OAAO,GAAG,IAAI,EAAE,EAC1E,OAAO,EACP,QAAQ,EACR,eAAe,GAChB,EAAE;IACD,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IACvB,QAAQ,EAAE,GAAG,CAAC;IACd,eAAe,CAAC,EAAE,gBAAgB,CAAC;CACpC,GAAG,gBAAgB,SAAS,IAAI,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,CAiBnD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,GAAG,EAAE,CAU7D"}

package/dist/decodePermission/utils.mjs

@@ -124,8 +124,8 @@ export const createPermissionRulesForChainId = (contracts) => {
  * @returns `true` if `subset` ⊆ `superset`, otherwise `false`.
  */
 export const isSubset = (subset, superset) => {
-    for (const x of subset) {
-        if (!superset.has(x)) {
+    for (const element of subset) {
+        if (!superset.has(element)) {
             return false;
         }
     }

package/dist/decodePermission/utils.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"utils.mjs","sourceRoot":"","sources":["../../src/decodePermission/utils.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Caveat } from '@metamask/delegation-core';\nimport { getChecksumAddress } from '@metamask/utils';\nimport type { Hex } from '@metamask/utils';\n\nimport type { DeployedContractsByName, PermissionType } from './types';\n\n/**\n * A rule that defines the required and allowed enforcers for a permission type.\n */\nexport type PermissionRule = {\n  permissionType: PermissionType;\n  requiredEnforcers: Map<Hex, number>;\n  optionalEnforcers: Set<Hex>;\n};\n\n/**\n * The names of the enforcer contracts for each permission type.\n */\nconst ENFORCER_CONTRACT_NAMES = {\n  ERC20PeriodTransferEnforcer: 'ERC20PeriodTransferEnforcer',\n  ERC20StreamingEnforcer: 'ERC20StreamingEnforcer',\n  ExactCalldataEnforcer: 'ExactCalldataEnforcer',\n  NativeTokenPeriodTransferEnforcer: 'NativeTokenPeriodTransferEnforcer',\n  NativeTokenStreamingEnforcer: 'NativeTokenStreamingEnforcer',\n  TimestampEnforcer: 'TimestampEnforcer',\n  ValueLteEnforcer: 'ValueLteEnforcer',\n  NonceEnforcer: 'NonceEnforcer',\n  AllowedCalldataEnforcer: 'AllowedCalldataEnforcer',\n};\n\n/**\n * Resolves and returns checksummed addresses of all known enforcer contracts\n * for a given `chainId` under the current delegation framework version.\n *\n * @param contracts - The deployed contracts for the chain.\n * @returns An object mapping enforcer names to checksummed contract addresses.\n * @throws If the chain or an expected enforcer contract is not found.\n */\nexport const getChecksumEnforcersByChainId = (\n  contracts: DeployedContractsByName,\n) => {\n  const getChecksumContractAddress = (contractName: string) => {\n    const address = contracts[contractName];\n\n    if (!address) {\n      throw new Error(`Contract not found: ${contractName}`);\n    }\n\n    return getChecksumAddress(address);\n  };\n\n  // permission type specific enforcers\n  const erc20StreamingEnforcer = getChecksumContractAddress(\n    ENFORCER_CONTRACT_NAMES.ERC20StreamingEnforcer,\n  );\n  const erc20PeriodicEnforcer = getChecksumContractAddress(\n    ENFORCER_CONTRACT_NAMES.ERC20PeriodTransferEnforcer,\n  );\n  const nativeTokenStreamingEnforcer = getChecksumContractAddress(\n    ENFORCER_CONTRACT_NAMES.NativeTokenStreamingEnforcer,\n  );\n  const nativeTokenPeriodicEnforcer = getChecksumContractAddress(\n    ENFORCER_CONTRACT_NAMES.NativeTokenPeriodTransferEnforcer,\n  );\n\n  // general enforcers\n  const exactCalldataEnforcer = getChecksumContractAddress(\n    ENFORCER_CONTRACT_NAMES.ExactCalldataEnforcer,\n  );\n  const valueLteEnforcer = getChecksumContractAddress(\n    ENFORCER_CONTRACT_NAMES.ValueLteEnforcer,\n  );\n  const timestampEnforcer = getChecksumContractAddress(\n    ENFORCER_CONTRACT_NAMES.TimestampEnforcer,\n  );\n  const nonceEnforcer = getChecksumContractAddress(\n    ENFORCER_CONTRACT_NAMES.NonceEnforcer,\n  );\n\n  const allowedCalldataEnforcer = getChecksumContractAddress(\n    ENFORCER_CONTRACT_NAMES.AllowedCalldataEnforcer,\n  );\n\n  return {\n    erc20StreamingEnforcer,\n    erc20PeriodicEnforcer,\n    nativeTokenStreamingEnforcer,\n    nativeTokenPeriodicEnforcer,\n    exactCalldataEnforcer,\n    valueLteEnforcer,\n    timestampEnforcer,\n    nonceEnforcer,\n    allowedCalldataEnforcer,\n  };\n};\n\n/**\n * Builds the canonical set of permission matching rules for a chain.\n *\n * Each rule specifies the `permissionType`, the set of `requiredEnforcers`\n * that must be present, and the set of `optionalEnforcers` that may appear in\n * addition to the required set.\n *\n * @param contracts - The deployed contracts for the chain.\n * @returns A list of permission rules used to identify permission types.\n * @throws Propagates any errors from resolving enforcer addresses.\n */\nexport const createPermissionRulesForChainId: (\n  contracts: DeployedContractsByName,\n) => PermissionRule[] = (contracts: DeployedContractsByName) => {\n  const {\n    erc20StreamingEnforcer,\n    erc20PeriodicEnforcer,\n    nativeTokenStreamingEnforcer,\n    nativeTokenPeriodicEnforcer,\n    exactCalldataEnforcer,\n    valueLteEnforcer,\n    timestampEnforcer,\n    nonceEnforcer,\n    allowedCalldataEnforcer,\n  } = getChecksumEnforcersByChainId(contracts);\n\n  // the optional enforcers are the same for all permission types\n  const optionalEnforcers = new Set<Hex>([timestampEnforcer]);\n\n  const permissionRules: PermissionRule[] = [\n    {\n      requiredEnforcers: new Map<Hex, number>([\n        [nativeTokenStreamingEnforcer, 1],\n        [exactCalldataEnforcer, 1],\n        [nonceEnforcer, 1],\n      ]),\n      optionalEnforcers,\n      permissionType: 'native-token-stream',\n    },\n    {\n      requiredEnforcers: new Map<Hex, number>([\n        [nativeTokenPeriodicEnforcer, 1],\n        [exactCalldataEnforcer, 1],\n        [nonceEnforcer, 1],\n      ]),\n      optionalEnforcers,\n      permissionType: 'native-token-periodic',\n    },\n    {\n      requiredEnforcers: new Map<Hex, number>([\n        [erc20StreamingEnforcer, 1],\n        [valueLteEnforcer, 1],\n        [nonceEnforcer, 1],\n      ]),\n      optionalEnforcers,\n      permissionType: 'erc20-token-stream',\n    },\n    {\n      requiredEnforcers: new Map<Hex, number>([\n        [erc20PeriodicEnforcer, 1],\n        [valueLteEnforcer, 1],\n        [nonceEnforcer, 1],\n      ]),\n      optionalEnforcers,\n      permissionType: 'erc20-token-periodic',\n    },\n    {\n      requiredEnforcers: new Map<Hex, number>([\n        [allowedCalldataEnforcer, 2],\n        [valueLteEnforcer, 1],\n        [nonceEnforcer, 1],\n      ]),\n      optionalEnforcers,\n      permissionType: 'erc20-token-revocation',\n    },\n  ];\n\n  return permissionRules;\n};\n\n/**\n * Determines whether all elements of `subset` are contained within `superset`.\n *\n * @param subset - The candidate subset to test.\n * @param superset - The set expected to contain all elements of `subset`.\n * @returns `true` if `subset` ⊆ `superset`, otherwise `false`.\n */\nexport const isSubset = <T>(subset: Set<T>, superset: Set<T>): boolean => {\n  for (const x of subset) {\n    if (!superset.has(x)) {\n      return false;\n    }\n  }\n  return true;\n};\n\n/**\n * Gets the terms for a given enforcer from a list of caveats.\n *\n * @param args - The arguments to this function.\n * @param  args.throwIfNotFound - Whether to throw an error if no matching enforcer is found. Default is true.\n * @param args.caveats - The list of caveats to search.\n * @param args.enforcer - The enforcer to search for.\n * @returns The terms for the given enforcer.\n */\nexport function getTermsByEnforcer<TThrowIfNotFound extends boolean = true>({\n  caveats,\n  enforcer,\n  throwIfNotFound,\n}: {\n  caveats: Caveat<Hex>[];\n  enforcer: Hex;\n  throwIfNotFound?: TThrowIfNotFound;\n}): TThrowIfNotFound extends true ? Hex : Hex | null {\n  const matchingCaveats = caveats.filter(\n    (caveat) => caveat.enforcer === enforcer,\n  );\n\n  if (matchingCaveats.length === 0) {\n    if (throwIfNotFound ?? true) {\n      throw new Error('Invalid caveats');\n    }\n    return null as TThrowIfNotFound extends true ? Hex : Hex | null;\n  }\n\n  if (matchingCaveats.length > 1) {\n    throw new Error('Invalid caveats');\n  }\n\n  return matchingCaveats[0].terms;\n}\n\n/**\n * Splits a 0x-prefixed hex string into parts according to the provided byte lengths.\n *\n * Each entry in `lengths` represents a part length in bytes; internally this is\n * multiplied by 2 to derive the number of hexadecimal characters to slice. The\n * returned substrings do not include the `0x` prefix and preserve leading zeros.\n *\n * Note: This function does not perform input validation (e.g., verifying the\n * payload length equals the sum of requested lengths). Callers are expected to\n * provide well-formed inputs.\n *\n * Example:\n * splitHex('0x12345678', [1, 3]) => ['0x12', '0x345678']\n *\n * @param value - The 0x-prefixed hex string to split.\n * @param lengths - The lengths of each part, in bytes.\n * @returns An array of hex substrings (each with `0x` prefix), one for each part.\n */\nexport function splitHex(value: Hex, lengths: number[]): Hex[] {\n  let start = 2;\n  const parts: Hex[] = [];\n  for (const partLength of lengths) {\n    const partCharLength = partLength * 2;\n    const part = value.slice(start, start + partCharLength);\n    start += partCharLength;\n    parts.push(`0x${part}` as const);\n  }\n  return parts;\n}\n"]}
+{"version":3,"file":"utils.mjs","sourceRoot":"","sources":["../../src/decodePermission/utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,wBAAwB;AAcrD;;GAEG;AACH,MAAM,uBAAuB,GAAG;IAC9B,2BAA2B,EAAE,6BAA6B;IAC1D,sBAAsB,EAAE,wBAAwB;IAChD,qBAAqB,EAAE,uBAAuB;IAC9C,iCAAiC,EAAE,mCAAmC;IACtE,4BAA4B,EAAE,8BAA8B;IAC5D,iBAAiB,EAAE,mBAAmB;IACtC,gBAAgB,EAAE,kBAAkB;IACpC,aAAa,EAAE,eAAe;IAC9B,uBAAuB,EAAE,yBAAyB;CACnD,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAC3C,SAAkC,EAWlC,EAAE;IACF,MAAM,0BAA0B,GAAG,CAAC,YAAoB,EAAO,EAAE;QAC/D,MAAM,OAAO,GAAG,SAAS,CAAC,YAAY,CAAC,CAAC;QAExC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,uBAAuB,YAAY,EAAE,CAAC,CAAC;QACzD,CAAC;QAED,OAAO,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC,CAAC;IAEF,qCAAqC;IACrC,MAAM,sBAAsB,GAAG,0BAA0B,CACvD,uBAAuB,CAAC,sBAAsB,CAC/C,CAAC;IACF,MAAM,qBAAqB,GAAG,0BAA0B,CACtD,uBAAuB,CAAC,2BAA2B,CACpD,CAAC;IACF,MAAM,4BAA4B,GAAG,0BAA0B,CAC7D,uBAAuB,CAAC,4BAA4B,CACrD,CAAC;IACF,MAAM,2BAA2B,GAAG,0BAA0B,CAC5D,uBAAuB,CAAC,iCAAiC,CAC1D,CAAC;IAEF,oBAAoB;IACpB,MAAM,qBAAqB,GAAG,0BAA0B,CACtD,uBAAuB,CAAC,qBAAqB,CAC9C,CAAC;IACF,MAAM,gBAAgB,GAAG,0BAA0B,CACjD,uBAAuB,CAAC,gBAAgB,CACzC,CAAC;IACF,MAAM,iBAAiB,GAAG,0BAA0B,CAClD,uBAAuB,CAAC,iBAAiB,CAC1C,CAAC;IACF,MAAM,aAAa,GAAG,0BAA0B,CAC9C,uBAAuB,CAAC,aAAa,CACtC,CAAC;IAEF,MAAM,uBAAuB,GAAG,0BAA0B,CACxD,uBAAuB,CAAC,uBAAuB,CAChD,CAAC;IAEF,OAAO;QACL,sBAAsB;QACtB,qBAAqB;QACrB,4BAA4B;QAC5B,2BAA2B;QAC3B,qBAAqB;QACrB,gBAAgB;QAChB,iBAAiB;QACjB,aAAa;QACb,uBAAuB;KACxB,CAAC;AACJ,CAAC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAEpB,CAAC,SAAkC,EAAE,EAAE;IAC7D,MAAM,EACJ,sBAAsB,EACtB,qBAAqB,EACrB,4BAA4B,EAC5B,2BAA2B,EAC3B,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,uBAAuB,GACxB,GAAG,6BAA6B,CAAC,SAAS,CAAC,CAAC;IAE7C,+DAA+D;IAC/D,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAE5D,MAAM,eAAe,GAAqB;QACxC;YACE,iBAAiB,EAAE,IAAI,GAAG,CAAc;gBACtC,CAAC,4BAA4B,EAAE,CAAC,CAAC;gBACjC,CAAC,qBAAqB,EAAE,CAAC,CAAC;gBAC1B,CAAC,aAAa,EAAE,CAAC,CAAC;aACnB,CAAC;YACF,iBAAiB;YACjB,cAAc,EAAE,qBAAqB;SACtC;QACD;YACE,iBAAiB,EAAE,IAAI,GAAG,CAAc;gBACtC,CAAC,2BAA2B,EAAE,CAAC,CAAC;gBAChC,CAAC,qBAAqB,EAAE,CAAC,CAAC;gBAC1B,CAAC,aAAa,EAAE,CAAC,CAAC;aACnB,CAAC;YACF,iBAAiB;YACjB,cAAc,EAAE,uBAAuB;SACxC;QACD;YACE,iBAAiB,EAAE,IAAI,GAAG,CAAc;gBACtC,CAAC,sBAAsB,EAAE,CAAC,CAAC;gBAC3B,CAAC,gBAAgB,EAAE,CAAC,CAAC;gBACrB,CAAC,aAAa,EAAE,CAAC,CAAC;aACnB,CAAC;YACF,iBAAiB;YACjB,cAAc,EAAE,oBAAoB;SACrC;QACD;YACE,iBAAiB,EAAE,IAAI,GAAG,CAAc;gBACtC,CAAC,qBAAqB,EAAE,CAAC,CAAC;gBAC1B,CAAC,gBAAgB,EAAE,CAAC,CAAC;gBACrB,CAAC,aAAa,EAAE,CAAC,CAAC;aACnB,CAAC;YACF,iBAAiB;YACjB,cAAc,EAAE,sBAAsB;SACvC;QACD;YACE,iBAAiB,EAAE,IAAI,GAAG,CAAc;gBACtC,CAAC,uBAAuB,EAAE,CAAC,CAAC;gBAC5B,CAAC,gBAAgB,EAAE,CAAC,CAAC;gBACrB,CAAC,aAAa,EAAE,CAAC,CAAC;aACnB,CAAC;YACF,iBAAiB;YACjB,cAAc,EAAE,wBAAwB;SACzC;KACF,CAAC;IAEF,OAAO,eAAe,CAAC;AACzB,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CACtB,MAAqB,EACrB,QAAuB,EACd,EAAE;IACX,KAAK,MAAM,OAAO,IAAI,MAAM,EAAE,CAAC;QAC7B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3B,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAA0C,EAC1E,OAAO,EACP,QAAQ,EACR,eAAe,GAKhB;IACC,MAAM,eAAe,GAAG,OAAO,CAAC,MAAM,CACpC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,KAAK,QAAQ,CACzC,CAAC;IAEF,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,IAAI,eAAe,IAAI,IAAI,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACrC,CAAC;QACD,OAAO,IAAwD,CAAC;IAClE,CAAC;IAED,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACrC,CAAC;IAED,OAAO,eAAe,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AAClC,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAU,EAAE,OAAiB;IACpD,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,MAAM,KAAK,GAAU,EAAE,CAAC;IACxB,KAAK,MAAM,UAAU,IAAI,OAAO,EAAE,CAAC;QACjC,MAAM,cAAc,GAAG,UAAU,GAAG,CAAC,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,cAAc,CAAC,CAAC;QACxD,KAAK,IAAI,cAAc,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,EAAW,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["import type { Caveat } from '@metamask/delegation-core';\nimport { getChecksumAddress } from '@metamask/utils';\nimport type { Hex } from '@metamask/utils';\n\nimport type { DeployedContractsByName, PermissionType } from './types';\n\n/**\n * A rule that defines the required and allowed enforcers for a permission type.\n */\nexport type PermissionRule = {\n  permissionType: PermissionType;\n  requiredEnforcers: Map<Hex, number>;\n  optionalEnforcers: Set<Hex>;\n};\n\n/**\n * The names of the enforcer contracts for each permission type.\n */\nconst ENFORCER_CONTRACT_NAMES = {\n  ERC20PeriodTransferEnforcer: 'ERC20PeriodTransferEnforcer',\n  ERC20StreamingEnforcer: 'ERC20StreamingEnforcer',\n  ExactCalldataEnforcer: 'ExactCalldataEnforcer',\n  NativeTokenPeriodTransferEnforcer: 'NativeTokenPeriodTransferEnforcer',\n  NativeTokenStreamingEnforcer: 'NativeTokenStreamingEnforcer',\n  TimestampEnforcer: 'TimestampEnforcer',\n  ValueLteEnforcer: 'ValueLteEnforcer',\n  NonceEnforcer: 'NonceEnforcer',\n  AllowedCalldataEnforcer: 'AllowedCalldataEnforcer',\n};\n\n/**\n * Resolves and returns checksummed addresses of all known enforcer contracts\n * for a given `chainId` under the current delegation framework version.\n *\n * @param contracts - The deployed contracts for the chain.\n * @returns An object mapping enforcer names to checksummed contract addresses.\n * @throws If the chain or an expected enforcer contract is not found.\n */\nexport const getChecksumEnforcersByChainId = (\n  contracts: DeployedContractsByName,\n): {\n  erc20StreamingEnforcer: Hex;\n  erc20PeriodicEnforcer: Hex;\n  nativeTokenStreamingEnforcer: Hex;\n  nativeTokenPeriodicEnforcer: Hex;\n  exactCalldataEnforcer: Hex;\n  valueLteEnforcer: Hex;\n  timestampEnforcer: Hex;\n  nonceEnforcer: Hex;\n  allowedCalldataEnforcer: Hex;\n} => {\n  const getChecksumContractAddress = (contractName: string): Hex => {\n    const address = contracts[contractName];\n\n    if (!address) {\n      throw new Error(`Contract not found: ${contractName}`);\n    }\n\n    return getChecksumAddress(address);\n  };\n\n  // permission type specific enforcers\n  const erc20StreamingEnforcer = getChecksumContractAddress(\n    ENFORCER_CONTRACT_NAMES.ERC20StreamingEnforcer,\n  );\n  const erc20PeriodicEnforcer = getChecksumContractAddress(\n    ENFORCER_CONTRACT_NAMES.ERC20PeriodTransferEnforcer,\n  );\n  const nativeTokenStreamingEnforcer = getChecksumContractAddress(\n    ENFORCER_CONTRACT_NAMES.NativeTokenStreamingEnforcer,\n  );\n  const nativeTokenPeriodicEnforcer = getChecksumContractAddress(\n    ENFORCER_CONTRACT_NAMES.NativeTokenPeriodTransferEnforcer,\n  );\n\n  // general enforcers\n  const exactCalldataEnforcer = getChecksumContractAddress(\n    ENFORCER_CONTRACT_NAMES.ExactCalldataEnforcer,\n  );\n  const valueLteEnforcer = getChecksumContractAddress(\n    ENFORCER_CONTRACT_NAMES.ValueLteEnforcer,\n  );\n  const timestampEnforcer = getChecksumContractAddress(\n    ENFORCER_CONTRACT_NAMES.TimestampEnforcer,\n  );\n  const nonceEnforcer = getChecksumContractAddress(\n    ENFORCER_CONTRACT_NAMES.NonceEnforcer,\n  );\n\n  const allowedCalldataEnforcer = getChecksumContractAddress(\n    ENFORCER_CONTRACT_NAMES.AllowedCalldataEnforcer,\n  );\n\n  return {\n    erc20StreamingEnforcer,\n    erc20PeriodicEnforcer,\n    nativeTokenStreamingEnforcer,\n    nativeTokenPeriodicEnforcer,\n    exactCalldataEnforcer,\n    valueLteEnforcer,\n    timestampEnforcer,\n    nonceEnforcer,\n    allowedCalldataEnforcer,\n  };\n};\n\n/**\n * Builds the canonical set of permission matching rules for a chain.\n *\n * Each rule specifies the `permissionType`, the set of `requiredEnforcers`\n * that must be present, and the set of `optionalEnforcers` that may appear in\n * addition to the required set.\n *\n * @param contracts - The deployed contracts for the chain.\n * @returns A list of permission rules used to identify permission types.\n * @throws Propagates any errors from resolving enforcer addresses.\n */\nexport const createPermissionRulesForChainId: (\n  contracts: DeployedContractsByName,\n) => PermissionRule[] = (contracts: DeployedContractsByName) => {\n  const {\n    erc20StreamingEnforcer,\n    erc20PeriodicEnforcer,\n    nativeTokenStreamingEnforcer,\n    nativeTokenPeriodicEnforcer,\n    exactCalldataEnforcer,\n    valueLteEnforcer,\n    timestampEnforcer,\n    nonceEnforcer,\n    allowedCalldataEnforcer,\n  } = getChecksumEnforcersByChainId(contracts);\n\n  // the optional enforcers are the same for all permission types\n  const optionalEnforcers = new Set<Hex>([timestampEnforcer]);\n\n  const permissionRules: PermissionRule[] = [\n    {\n      requiredEnforcers: new Map<Hex, number>([\n        [nativeTokenStreamingEnforcer, 1],\n        [exactCalldataEnforcer, 1],\n        [nonceEnforcer, 1],\n      ]),\n      optionalEnforcers,\n      permissionType: 'native-token-stream',\n    },\n    {\n      requiredEnforcers: new Map<Hex, number>([\n        [nativeTokenPeriodicEnforcer, 1],\n        [exactCalldataEnforcer, 1],\n        [nonceEnforcer, 1],\n      ]),\n      optionalEnforcers,\n      permissionType: 'native-token-periodic',\n    },\n    {\n      requiredEnforcers: new Map<Hex, number>([\n        [erc20StreamingEnforcer, 1],\n        [valueLteEnforcer, 1],\n        [nonceEnforcer, 1],\n      ]),\n      optionalEnforcers,\n      permissionType: 'erc20-token-stream',\n    },\n    {\n      requiredEnforcers: new Map<Hex, number>([\n        [erc20PeriodicEnforcer, 1],\n        [valueLteEnforcer, 1],\n        [nonceEnforcer, 1],\n      ]),\n      optionalEnforcers,\n      permissionType: 'erc20-token-periodic',\n    },\n    {\n      requiredEnforcers: new Map<Hex, number>([\n        [allowedCalldataEnforcer, 2],\n        [valueLteEnforcer, 1],\n        [nonceEnforcer, 1],\n      ]),\n      optionalEnforcers,\n      permissionType: 'erc20-token-revocation',\n    },\n  ];\n\n  return permissionRules;\n};\n\n/**\n * Determines whether all elements of `subset` are contained within `superset`.\n *\n * @param subset - The candidate subset to test.\n * @param superset - The set expected to contain all elements of `subset`.\n * @returns `true` if `subset` ⊆ `superset`, otherwise `false`.\n */\nexport const isSubset = <TElement>(\n  subset: Set<TElement>,\n  superset: Set<TElement>,\n): boolean => {\n  for (const element of subset) {\n    if (!superset.has(element)) {\n      return false;\n    }\n  }\n  return true;\n};\n\n/**\n * Gets the terms for a given enforcer from a list of caveats.\n *\n * @param args - The arguments to this function.\n * @param  args.throwIfNotFound - Whether to throw an error if no matching enforcer is found. Default is true.\n * @param args.caveats - The list of caveats to search.\n * @param args.enforcer - The enforcer to search for.\n * @returns The terms for the given enforcer.\n */\nexport function getTermsByEnforcer<TThrowIfNotFound extends boolean = true>({\n  caveats,\n  enforcer,\n  throwIfNotFound,\n}: {\n  caveats: Caveat<Hex>[];\n  enforcer: Hex;\n  throwIfNotFound?: TThrowIfNotFound;\n}): TThrowIfNotFound extends true ? Hex : Hex | null {\n  const matchingCaveats = caveats.filter(\n    (caveat) => caveat.enforcer === enforcer,\n  );\n\n  if (matchingCaveats.length === 0) {\n    if (throwIfNotFound ?? true) {\n      throw new Error('Invalid caveats');\n    }\n    return null as TThrowIfNotFound extends true ? Hex : Hex | null;\n  }\n\n  if (matchingCaveats.length > 1) {\n    throw new Error('Invalid caveats');\n  }\n\n  return matchingCaveats[0].terms;\n}\n\n/**\n * Splits a 0x-prefixed hex string into parts according to the provided byte lengths.\n *\n * Each entry in `lengths` represents a part length in bytes; internally this is\n * multiplied by 2 to derive the number of hexadecimal characters to slice. The\n * returned substrings do not include the `0x` prefix and preserve leading zeros.\n *\n * Note: This function does not perform input validation (e.g., verifying the\n * payload length equals the sum of requested lengths). Callers are expected to\n * provide well-formed inputs.\n *\n * Example:\n * splitHex('0x12345678', [1, 3]) => ['0x12', '0x345678']\n *\n * @param value - The 0x-prefixed hex string to split.\n * @param lengths - The lengths of each part, in bytes.\n * @returns An array of hex substrings (each with `0x` prefix), one for each part.\n */\nexport function splitHex(value: Hex, lengths: number[]): Hex[] {\n  let start = 2;\n  const parts: Hex[] = [];\n  for (const partLength of lengths) {\n    const partCharLength = partLength * 2;\n    const part = value.slice(start, start + partCharLength);\n    start += partCharLength;\n    parts.push(`0x${part}` as const);\n  }\n  return parts;\n}\n"]}

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;AAAA,+EAAqF;AAA5E,yJAAA,OAAO,OAA8B;AAC9C,qCAGiB;AAFf,qHAAA,4BAA4B,OAAA;AAC5B,uHAAA,8BAA8B,OAAA;AAmBhC,6CAA2D;AAAlD,yHAAA,4BAA4B,OAAA","sourcesContent":["export { default as GatorPermissionsController } from './GatorPermissionsController';\nexport {\n  serializeGatorPermissionsMap,\n  deserializeGatorPermissionsMap,\n} from './utils';\nexport type {\n  GatorPermissionsControllerState,\n  GatorPermissionsControllerMessenger,\n  GatorPermissionsControllerGetStateAction,\n  GatorPermissionsControllerDecodePermissionFromPermissionContextForOriginAction,\n  GatorPermissionsControllerFetchAndUpdateGatorPermissionsAction,\n  GatorPermissionsControllerEnableGatorPermissionsAction,\n  GatorPermissionsControllerDisableGatorPermissionsAction,\n  GatorPermissionsControllerSubmitRevocationAction,\n  GatorPermissionsControllerAddPendingRevocationAction,\n  GatorPermissionsControllerSubmitDirectRevocationAction,\n  GatorPermissionsControllerIsPendingRevocationAction,\n  GatorPermissionsControllerActions,\n  GatorPermissionsControllerEvents,\n  GatorPermissionsControllerStateChangeEvent,\n} from './GatorPermissionsController';\nexport type { DecodedPermission } from './decodePermission';\nexport { DELEGATION_FRAMEWORK_VERSION } from './constants';\nexport type {\n  GatorPermissionsControllerErrorCode,\n  GatorPermissionsSnapRpcMethod,\n  CustomPermission,\n  PermissionTypesWithCustom,\n  PermissionRequest,\n  PermissionResponse,\n  PermissionResponseSanitized,\n  StoredGatorPermission,\n  StoredGatorPermissionSanitized,\n  GatorPermissionsMap,\n  SupportedGatorPermissionType,\n  GatorPermissionsMapByPermissionType,\n  GatorPermissionsListByPermissionTypeAndChainId,\n  DelegationDetails,\n  RevocationParams,\n} from './types';\n\nexport type {\n  NativeTokenStreamPermission,\n  NativeTokenPeriodicPermission,\n  Erc20TokenStreamPermission,\n  Erc20TokenPeriodicPermission,\n  MetaMaskBasePermissionData,\n} from '@metamask/7715-permission-types';\n"]}
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;AAAA,+EAAqF;AAA5E,yJAAA,OAAO,OAA8B;AAC9C,qCAGiB;AAFf,qHAAA,4BAA4B,OAAA;AAC5B,uHAAA,8BAA8B,OAAA;AAmBhC,6CAA2D;AAAlD,yHAAA,4BAA4B,OAAA","sourcesContent":["export { default as GatorPermissionsController } from './GatorPermissionsController';\nexport {\n  serializeGatorPermissionsMap,\n  deserializeGatorPermissionsMap,\n} from './utils';\nexport type {\n  GatorPermissionsControllerState,\n  GatorPermissionsControllerMessenger,\n  GatorPermissionsControllerGetStateAction,\n  GatorPermissionsControllerDecodePermissionFromPermissionContextForOriginAction,\n  GatorPermissionsControllerFetchAndUpdateGatorPermissionsAction,\n  GatorPermissionsControllerEnableGatorPermissionsAction,\n  GatorPermissionsControllerDisableGatorPermissionsAction,\n  GatorPermissionsControllerSubmitRevocationAction,\n  GatorPermissionsControllerAddPendingRevocationAction,\n  GatorPermissionsControllerSubmitDirectRevocationAction,\n  GatorPermissionsControllerIsPendingRevocationAction,\n  GatorPermissionsControllerActions,\n  GatorPermissionsControllerEvents,\n  GatorPermissionsControllerStateChangeEvent,\n} from './GatorPermissionsController';\nexport type { DecodedPermission } from './decodePermission';\nexport { DELEGATION_FRAMEWORK_VERSION } from './constants';\nexport type {\n  GatorPermissionsControllerErrorCode,\n  GatorPermissionsSnapRpcMethod,\n  CustomPermission,\n  PermissionTypesWithCustom,\n  PermissionRequest,\n  PermissionResponse,\n  PermissionResponseSanitized,\n  StoredGatorPermission,\n  StoredGatorPermissionSanitized,\n  GatorPermissionsMap,\n  SupportedGatorPermissionType,\n  GatorPermissionsMapByPermissionType,\n  GatorPermissionsListByPermissionTypeAndChainId,\n  DelegationDetails,\n  RevocationParams,\n  RevocationMetadata,\n} from './types';\n\nexport type {\n  NativeTokenStreamPermission,\n  NativeTokenPeriodicPermission,\n  Erc20TokenStreamPermission,\n  Erc20TokenPeriodicPermission,\n  MetaMaskBasePermissionData,\n} from '@metamask/7715-permission-types';\n"]}

package/dist/index.d.cts

@@ -3,6 +3,6 @@ export { serializeGatorPermissionsMap, deserializeGatorPermissionsMap, } from ".
 export type { GatorPermissionsControllerState, GatorPermissionsControllerMessenger, GatorPermissionsControllerGetStateAction, GatorPermissionsControllerDecodePermissionFromPermissionContextForOriginAction, GatorPermissionsControllerFetchAndUpdateGatorPermissionsAction, GatorPermissionsControllerEnableGatorPermissionsAction, GatorPermissionsControllerDisableGatorPermissionsAction, GatorPermissionsControllerSubmitRevocationAction, GatorPermissionsControllerAddPendingRevocationAction, GatorPermissionsControllerSubmitDirectRevocationAction, GatorPermissionsControllerIsPendingRevocationAction, GatorPermissionsControllerActions, GatorPermissionsControllerEvents, GatorPermissionsControllerStateChangeEvent, } from "./GatorPermissionsController.cjs";
 export type { DecodedPermission } from "./decodePermission/index.cjs";
 export { DELEGATION_FRAMEWORK_VERSION } from "./constants.cjs";
-export type { GatorPermissionsControllerErrorCode, GatorPermissionsSnapRpcMethod, CustomPermission, PermissionTypesWithCustom, PermissionRequest, PermissionResponse, PermissionResponseSanitized, StoredGatorPermission, StoredGatorPermissionSanitized, GatorPermissionsMap, SupportedGatorPermissionType, GatorPermissionsMapByPermissionType, GatorPermissionsListByPermissionTypeAndChainId, DelegationDetails, RevocationParams, } from "./types.cjs";
+export type { GatorPermissionsControllerErrorCode, GatorPermissionsSnapRpcMethod, CustomPermission, PermissionTypesWithCustom, PermissionRequest, PermissionResponse, PermissionResponseSanitized, StoredGatorPermission, StoredGatorPermissionSanitized, GatorPermissionsMap, SupportedGatorPermissionType, GatorPermissionsMapByPermissionType, GatorPermissionsListByPermissionTypeAndChainId, DelegationDetails, RevocationParams, RevocationMetadata, } from "./types.cjs";
 export type { NativeTokenStreamPermission, NativeTokenPeriodicPermission, Erc20TokenStreamPermission, Erc20TokenPeriodicPermission, MetaMaskBasePermissionData, } from "@metamask/7715-permission-types";
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,0BAA0B,EAAE,yCAAqC;AACrF,OAAO,EACL,4BAA4B,EAC5B,8BAA8B,GAC/B,oBAAgB;AACjB,YAAY,EACV,+BAA+B,EAC/B,mCAAmC,EACnC,wCAAwC,EACxC,8EAA8E,EAC9E,8DAA8D,EAC9D,sDAAsD,EACtD,uDAAuD,EACvD,gDAAgD,EAChD,oDAAoD,EACpD,sDAAsD,EACtD,mDAAmD,EACnD,iCAAiC,EACjC,gCAAgC,EAChC,0CAA0C,GAC3C,yCAAqC;AACtC,YAAY,EAAE,iBAAiB,EAAE,qCAA2B;AAC5D,OAAO,EAAE,4BAA4B,EAAE,wBAAoB;AAC3D,YAAY,EACV,mCAAmC,EACnC,6BAA6B,EAC7B,gBAAgB,EAChB,yBAAyB,EACzB,iBAAiB,EACjB,kBAAkB,EAClB,2BAA2B,EAC3B,qBAAqB,EACrB,8BAA8B,EAC9B,mBAAmB,EACnB,4BAA4B,EAC5B,mCAAmC,EACnC,8CAA8C,EAC9C,iBAAiB,EACjB,gBAAgB,GACjB,oBAAgB;AAEjB,YAAY,EACV,2BAA2B,EAC3B,6BAA6B,EAC7B,0BAA0B,EAC1B,4BAA4B,EAC5B,0BAA0B,GAC3B,wCAAwC"}
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,0BAA0B,EAAE,yCAAqC;AACrF,OAAO,EACL,4BAA4B,EAC5B,8BAA8B,GAC/B,oBAAgB;AACjB,YAAY,EACV,+BAA+B,EAC/B,mCAAmC,EACnC,wCAAwC,EACxC,8EAA8E,EAC9E,8DAA8D,EAC9D,sDAAsD,EACtD,uDAAuD,EACvD,gDAAgD,EAChD,oDAAoD,EACpD,sDAAsD,EACtD,mDAAmD,EACnD,iCAAiC,EACjC,gCAAgC,EAChC,0CAA0C,GAC3C,yCAAqC;AACtC,YAAY,EAAE,iBAAiB,EAAE,qCAA2B;AAC5D,OAAO,EAAE,4BAA4B,EAAE,wBAAoB;AAC3D,YAAY,EACV,mCAAmC,EACnC,6BAA6B,EAC7B,gBAAgB,EAChB,yBAAyB,EACzB,iBAAiB,EACjB,kBAAkB,EAClB,2BAA2B,EAC3B,qBAAqB,EACrB,8BAA8B,EAC9B,mBAAmB,EACnB,4BAA4B,EAC5B,mCAAmC,EACnC,8CAA8C,EAC9C,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,GACnB,oBAAgB;AAEjB,YAAY,EACV,2BAA2B,EAC3B,6BAA6B,EAC7B,0BAA0B,EAC1B,4BAA4B,EAC5B,0BAA0B,GAC3B,wCAAwC"}

package/dist/index.d.mts

@@ -3,6 +3,6 @@ export { serializeGatorPermissionsMap, deserializeGatorPermissionsMap, } from ".
 export type { GatorPermissionsControllerState, GatorPermissionsControllerMessenger, GatorPermissionsControllerGetStateAction, GatorPermissionsControllerDecodePermissionFromPermissionContextForOriginAction, GatorPermissionsControllerFetchAndUpdateGatorPermissionsAction, GatorPermissionsControllerEnableGatorPermissionsAction, GatorPermissionsControllerDisableGatorPermissionsAction, GatorPermissionsControllerSubmitRevocationAction, GatorPermissionsControllerAddPendingRevocationAction, GatorPermissionsControllerSubmitDirectRevocationAction, GatorPermissionsControllerIsPendingRevocationAction, GatorPermissionsControllerActions, GatorPermissionsControllerEvents, GatorPermissionsControllerStateChangeEvent, } from "./GatorPermissionsController.mjs";
 export type { DecodedPermission } from "./decodePermission/index.mjs";
 export { DELEGATION_FRAMEWORK_VERSION } from "./constants.mjs";
-export type { GatorPermissionsControllerErrorCode, GatorPermissionsSnapRpcMethod, CustomPermission, PermissionTypesWithCustom, PermissionRequest, PermissionResponse, PermissionResponseSanitized, StoredGatorPermission, StoredGatorPermissionSanitized, GatorPermissionsMap, SupportedGatorPermissionType, GatorPermissionsMapByPermissionType, GatorPermissionsListByPermissionTypeAndChainId, DelegationDetails, RevocationParams, } from "./types.mjs";
+export type { GatorPermissionsControllerErrorCode, GatorPermissionsSnapRpcMethod, CustomPermission, PermissionTypesWithCustom, PermissionRequest, PermissionResponse, PermissionResponseSanitized, StoredGatorPermission, StoredGatorPermissionSanitized, GatorPermissionsMap, SupportedGatorPermissionType, GatorPermissionsMapByPermissionType, GatorPermissionsListByPermissionTypeAndChainId, DelegationDetails, RevocationParams, RevocationMetadata, } from "./types.mjs";
 export type { NativeTokenStreamPermission, NativeTokenPeriodicPermission, Erc20TokenStreamPermission, Erc20TokenPeriodicPermission, MetaMaskBasePermissionData, } from "@metamask/7715-permission-types";
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,0BAA0B,EAAE,yCAAqC;AACrF,OAAO,EACL,4BAA4B,EAC5B,8BAA8B,GAC/B,oBAAgB;AACjB,YAAY,EACV,+BAA+B,EAC/B,mCAAmC,EACnC,wCAAwC,EACxC,8EAA8E,EAC9E,8DAA8D,EAC9D,sDAAsD,EACtD,uDAAuD,EACvD,gDAAgD,EAChD,oDAAoD,EACpD,sDAAsD,EACtD,mDAAmD,EACnD,iCAAiC,EACjC,gCAAgC,EAChC,0CAA0C,GAC3C,yCAAqC;AACtC,YAAY,EAAE,iBAAiB,EAAE,qCAA2B;AAC5D,OAAO,EAAE,4BAA4B,EAAE,wBAAoB;AAC3D,YAAY,EACV,mCAAmC,EACnC,6BAA6B,EAC7B,gBAAgB,EAChB,yBAAyB,EACzB,iBAAiB,EACjB,kBAAkB,EAClB,2BAA2B,EAC3B,qBAAqB,EACrB,8BAA8B,EAC9B,mBAAmB,EACnB,4BAA4B,EAC5B,mCAAmC,EACnC,8CAA8C,EAC9C,iBAAiB,EACjB,gBAAgB,GACjB,oBAAgB;AAEjB,YAAY,EACV,2BAA2B,EAC3B,6BAA6B,EAC7B,0BAA0B,EAC1B,4BAA4B,EAC5B,0BAA0B,GAC3B,wCAAwC"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,0BAA0B,EAAE,yCAAqC;AACrF,OAAO,EACL,4BAA4B,EAC5B,8BAA8B,GAC/B,oBAAgB;AACjB,YAAY,EACV,+BAA+B,EAC/B,mCAAmC,EACnC,wCAAwC,EACxC,8EAA8E,EAC9E,8DAA8D,EAC9D,sDAAsD,EACtD,uDAAuD,EACvD,gDAAgD,EAChD,oDAAoD,EACpD,sDAAsD,EACtD,mDAAmD,EACnD,iCAAiC,EACjC,gCAAgC,EAChC,0CAA0C,GAC3C,yCAAqC;AACtC,YAAY,EAAE,iBAAiB,EAAE,qCAA2B;AAC5D,OAAO,EAAE,4BAA4B,EAAE,wBAAoB;AAC3D,YAAY,EACV,mCAAmC,EACnC,6BAA6B,EAC7B,gBAAgB,EAChB,yBAAyB,EACzB,iBAAiB,EACjB,kBAAkB,EAClB,2BAA2B,EAC3B,qBAAqB,EACrB,8BAA8B,EAC9B,mBAAmB,EACnB,4BAA4B,EAC5B,mCAAmC,EACnC,8CAA8C,EAC9C,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,GACnB,oBAAgB;AAEjB,YAAY,EACV,2BAA2B,EAC3B,6BAA6B,EAC7B,0BAA0B,EAC1B,4BAA4B,EAC5B,0BAA0B,GAC3B,wCAAwC"}

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,0BAA0B,EAAE,yCAAqC;AACrF,OAAO,EACL,4BAA4B,EAC5B,8BAA8B,EAC/B,oBAAgB;AAkBjB,OAAO,EAAE,4BAA4B,EAAE,wBAAoB","sourcesContent":["export { default as GatorPermissionsController } from './GatorPermissionsController';\nexport {\n  serializeGatorPermissionsMap,\n  deserializeGatorPermissionsMap,\n} from './utils';\nexport type {\n  GatorPermissionsControllerState,\n  GatorPermissionsControllerMessenger,\n  GatorPermissionsControllerGetStateAction,\n  GatorPermissionsControllerDecodePermissionFromPermissionContextForOriginAction,\n  GatorPermissionsControllerFetchAndUpdateGatorPermissionsAction,\n  GatorPermissionsControllerEnableGatorPermissionsAction,\n  GatorPermissionsControllerDisableGatorPermissionsAction,\n  GatorPermissionsControllerSubmitRevocationAction,\n  GatorPermissionsControllerAddPendingRevocationAction,\n  GatorPermissionsControllerSubmitDirectRevocationAction,\n  GatorPermissionsControllerIsPendingRevocationAction,\n  GatorPermissionsControllerActions,\n  GatorPermissionsControllerEvents,\n  GatorPermissionsControllerStateChangeEvent,\n} from './GatorPermissionsController';\nexport type { DecodedPermission } from './decodePermission';\nexport { DELEGATION_FRAMEWORK_VERSION } from './constants';\nexport type {\n  GatorPermissionsControllerErrorCode,\n  GatorPermissionsSnapRpcMethod,\n  CustomPermission,\n  PermissionTypesWithCustom,\n  PermissionRequest,\n  PermissionResponse,\n  PermissionResponseSanitized,\n  StoredGatorPermission,\n  StoredGatorPermissionSanitized,\n  GatorPermissionsMap,\n  SupportedGatorPermissionType,\n  GatorPermissionsMapByPermissionType,\n  GatorPermissionsListByPermissionTypeAndChainId,\n  DelegationDetails,\n  RevocationParams,\n} from './types';\n\nexport type {\n  NativeTokenStreamPermission,\n  NativeTokenPeriodicPermission,\n  Erc20TokenStreamPermission,\n  Erc20TokenPeriodicPermission,\n  MetaMaskBasePermissionData,\n} from '@metamask/7715-permission-types';\n"]}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,0BAA0B,EAAE,yCAAqC;AACrF,OAAO,EACL,4BAA4B,EAC5B,8BAA8B,EAC/B,oBAAgB;AAkBjB,OAAO,EAAE,4BAA4B,EAAE,wBAAoB","sourcesContent":["export { default as GatorPermissionsController } from './GatorPermissionsController';\nexport {\n  serializeGatorPermissionsMap,\n  deserializeGatorPermissionsMap,\n} from './utils';\nexport type {\n  GatorPermissionsControllerState,\n  GatorPermissionsControllerMessenger,\n  GatorPermissionsControllerGetStateAction,\n  GatorPermissionsControllerDecodePermissionFromPermissionContextForOriginAction,\n  GatorPermissionsControllerFetchAndUpdateGatorPermissionsAction,\n  GatorPermissionsControllerEnableGatorPermissionsAction,\n  GatorPermissionsControllerDisableGatorPermissionsAction,\n  GatorPermissionsControllerSubmitRevocationAction,\n  GatorPermissionsControllerAddPendingRevocationAction,\n  GatorPermissionsControllerSubmitDirectRevocationAction,\n  GatorPermissionsControllerIsPendingRevocationAction,\n  GatorPermissionsControllerActions,\n  GatorPermissionsControllerEvents,\n  GatorPermissionsControllerStateChangeEvent,\n} from './GatorPermissionsController';\nexport type { DecodedPermission } from './decodePermission';\nexport { DELEGATION_FRAMEWORK_VERSION } from './constants';\nexport type {\n  GatorPermissionsControllerErrorCode,\n  GatorPermissionsSnapRpcMethod,\n  CustomPermission,\n  PermissionTypesWithCustom,\n  PermissionRequest,\n  PermissionResponse,\n  PermissionResponseSanitized,\n  StoredGatorPermission,\n  StoredGatorPermissionSanitized,\n  GatorPermissionsMap,\n  SupportedGatorPermissionType,\n  GatorPermissionsMapByPermissionType,\n  GatorPermissionsListByPermissionTypeAndChainId,\n  DelegationDetails,\n  RevocationParams,\n  RevocationMetadata,\n} from './types';\n\nexport type {\n  NativeTokenStreamPermission,\n  NativeTokenPeriodicPermission,\n  Erc20TokenStreamPermission,\n  Erc20TokenPeriodicPermission,\n  MetaMaskBasePermissionData,\n} from '@metamask/7715-permission-types';\n"]}

package/dist/types.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"types.cjs","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;AAcA;;GAEG;AACH,IAAY,mCAOX;AAPD,WAAY,mCAAmC;IAC7C,mGAA4D,CAAA;IAC5D,mGAA4D,CAAA;IAC5D,yGAAkE,CAAA;IAClE,0HAAmF,CAAA;IACnF,4FAAqD,CAAA;IACrD,yFAAkD,CAAA;AACpD,CAAC,EAPW,mCAAmC,mDAAnC,mCAAmC,QAO9C;AAED;;GAEG;AACH,IAAY,6BASX;AATD,WAAY,6BAA6B;IACvC;;OAEG;IACH,sHAAqF,CAAA;IACrF;;OAEG;IACH,4GAA2E,CAAA;AAC7E,CAAC,EATW,6BAA6B,6CAA7B,6BAA6B,QASxC","sourcesContent":["import type {\n  PermissionTypes,\n  BasePermission,\n  NativeTokenStreamPermission,\n  NativeTokenPeriodicPermission,\n  Erc20TokenStreamPermission,\n  Erc20TokenPeriodicPermission,\n  Rule,\n  MetaMaskBasePermissionData,\n  Erc20TokenRevocationPermission,\n} from '@metamask/7715-permission-types';\nimport type { Delegation } from '@metamask/delegation-core';\nimport type { Hex } from '@metamask/utils';\n\n/**\n * Enum for the error codes of the gator permissions controller.\n */\nexport enum GatorPermissionsControllerErrorCode {\n  GatorPermissionsFetchError = 'gator-permissions-fetch-error',\n  GatorPermissionsNotEnabled = 'gator-permissions-not-enabled',\n  GatorPermissionsProviderError = 'gator-permissions-provider-error',\n  GatorPermissionsMapSerializationError = 'gator-permissions-map-serialization-error',\n  PermissionDecodingError = 'permission-decoding-error',\n  OriginNotAllowedError = 'origin-not-allowed-error',\n}\n\n/**\n * Enum for the RPC methods of the gator permissions provider snap.\n */\nexport enum GatorPermissionsSnapRpcMethod {\n  /**\n   * This method is used by the metamask to request a permissions provider to get granted permissions for all sites.\n   */\n  PermissionProviderGetGrantedPermissions = 'permissionsProvider_getGrantedPermissions',\n  /**\n   * This method is used by the metamask to submit a revocation to the permissions provider.\n   */\n  PermissionProviderSubmitRevocation = 'permissionsProvider_submitRevocation',\n}\n\n/**\n * Represents a custom permission that are not of the standard ERC-7715 permission types.\n */\nexport type CustomPermission = BasePermission & {\n  type: 'custom';\n  data: MetaMaskBasePermissionData & Record<string, unknown>;\n};\n\n/**\n * Represents the type of the ERC-7715 permissions that can be granted including custom permissions.\n */\nexport type PermissionTypesWithCustom = PermissionTypes | CustomPermission;\n\n/**\n * Represents a ERC-7715 permission request.\n *\n * @template to - The type of the signer provided, either an AccountSigner or WalletSigner.\n * @template Permission - The type of the permission provided.\n */\nexport type PermissionRequest<TPermission extends PermissionTypesWithCustom> = {\n  /**\n   * hex-encoding of uint256 defined the chain with EIP-155\n   */\n  chainId: Hex;\n\n  /**\n   *\n   * The account being targeted for this permission request.\n   * It is optional to let the user choose which account to grant permission from.\n   */\n  from?: Hex;\n\n  /**\n   * A field that identifies the DApp session account associated with the permission\n   */\n  to: Hex;\n\n  /**\n   * Defines the allowed behavior the `to` account can do on behalf of the `from` account.\n   */\n  permission: TPermission;\n\n  rules?: Rule[] | null;\n};\n\n/**\n * Represents a ERC-7715 permission response.\n *\n * @template Permission - The type of the permission provided.\n */\nexport type PermissionResponse<TPermission extends PermissionTypesWithCustom> =\n  PermissionRequest<TPermission> & {\n    /**\n     * Is a catch-all to identify a permission for revoking permissions or submitting\n     * Defined in ERC-7710.\n     */\n    context: Hex;\n\n    /**\n     * The dependencyInfo field is required and contains information needed to deploy accounts.\n     * Each entry specifies a factory contract and its associated deployment data.\n     * If no account deployment is needed when redeeming the permission, this array must be empty.\n     * When non-empty, DApps MUST deploy the accounts by calling the factory contract with factoryData as the calldata.\n     * Defined in ERC-4337.\n     */\n    dependencies: {\n      factory: Hex;\n      factoryData: Hex;\n    }[];\n\n    /**\n     * Is required as defined in ERC-7710.\n     */\n    delegationManager: Hex;\n  };\n\n/**\n * Represents a sanitized version of the PermissionResponse type.\n * Internal fields (dependencies, to) are removed\n *\n * @template Permission - The type of the permission provided.\n */\nexport type PermissionResponseSanitized<\n  TPermission extends PermissionTypesWithCustom,\n> = Omit<PermissionResponse<TPermission>, 'dependencies' | 'to'>;\n\n/**\n * Represents a gator ERC-7715 granted(ie. signed by an user account) permission entry that is stored in profile sync.\n *\n * @template Permission - The type of the permission provided\n */\nexport type StoredGatorPermission<\n  TPermission extends PermissionTypesWithCustom,\n> = {\n  permissionResponse: PermissionResponse<TPermission>;\n  siteOrigin: string;\n  /**\n   * Flag indicating whether this permission has been revoked.\n   */\n  isRevoked?: boolean;\n};\n\n/**\n * Represents a sanitized version of the StoredGatorPermission type. Some fields have been removed but the fields are still present in profile sync.\n *\n * @template Permission - The type of the permission provided.\n */\nexport type StoredGatorPermissionSanitized<\n  TPermission extends PermissionTypesWithCustom,\n> = {\n  permissionResponse: PermissionResponseSanitized<TPermission>;\n  siteOrigin: string;\n  /**\n   * Flag indicating whether this permission has been revoked.\n   */\n  isRevoked?: boolean;\n};\n\n/**\n * Represents a map of gator permissions by chainId and permission type.\n */\nexport type GatorPermissionsMap = {\n  'erc20-token-revocation': {\n    [\n      chainId: Hex\n    ]: StoredGatorPermissionSanitized<Erc20TokenRevocationPermission>[];\n  };\n  'native-token-stream': {\n    [\n      chainId: Hex\n    ]: StoredGatorPermissionSanitized<NativeTokenStreamPermission>[];\n  };\n  'native-token-periodic': {\n    [\n      chainId: Hex\n    ]: StoredGatorPermissionSanitized<NativeTokenPeriodicPermission>[];\n  };\n  'erc20-token-stream': {\n    [\n      chainId: Hex\n    ]: StoredGatorPermissionSanitized<Erc20TokenStreamPermission>[];\n  };\n  'erc20-token-periodic': {\n    [\n      chainId: Hex\n    ]: StoredGatorPermissionSanitized<Erc20TokenPeriodicPermission>[];\n  };\n  other: {\n    [chainId: Hex]: StoredGatorPermissionSanitized<CustomPermission>[];\n  };\n};\n\n/**\n * Represents the supported permission type(e.g. 'native-token-stream', 'native-token-periodic', 'erc20-token-stream', 'erc20-token-periodic') of the gator permissions map.\n */\nexport type SupportedGatorPermissionType = keyof GatorPermissionsMap;\n\n/**\n * Represents a map of gator permissions for a given permission type with key of chainId. The value being an array of gator permissions for that chainId.\n */\nexport type GatorPermissionsMapByPermissionType<\n  TPermissionType extends SupportedGatorPermissionType,\n> = GatorPermissionsMap[TPermissionType];\n\n/**\n * Represents an array of gator permissions for a given permission type and chainId.\n */\nexport type GatorPermissionsListByPermissionTypeAndChainId<\n  TPermissionType extends SupportedGatorPermissionType,\n> = GatorPermissionsMap[TPermissionType][Hex];\n\n/**\n * Represents the details of a delegation, that are required to decode a permission.\n */\nexport type DelegationDetails = Pick<\n  Delegation<Hex>,\n  'caveats' | 'delegator' | 'delegate' | 'authority'\n>;\n\n/**\n * Represents the parameters for submitting a revocation.\n */\nexport type RevocationParams = {\n  /**\n   * The permission context as a hex string that identifies the permission to revoke.\n   */\n  permissionContext: Hex;\n};\n\n/**\n * Represents the parameters for adding a pending revocation.\n */\nexport type PendingRevocationParams = {\n  /**\n   * The transaction metadata ID to monitor.\n   */\n  txId: string;\n  /**\n   * The permission context as a hex string that identifies the permission to revoke.\n   */\n  permissionContext: Hex;\n};\n"]}
+{"version":3,"file":"types.cjs","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;AAcA;;GAEG;AACH,IAAY,mCAOX;AAPD,WAAY,mCAAmC;IAC7C,mGAA4D,CAAA;IAC5D,mGAA4D,CAAA;IAC5D,yGAAkE,CAAA;IAClE,0HAAmF,CAAA;IACnF,4FAAqD,CAAA;IACrD,yFAAkD,CAAA;AACpD,CAAC,EAPW,mCAAmC,mDAAnC,mCAAmC,QAO9C;AAED;;GAEG;AACH,IAAY,6BASX;AATD,WAAY,6BAA6B;IACvC;;OAEG;IACH,sHAAqF,CAAA;IACrF;;OAEG;IACH,4GAA2E,CAAA;AAC7E,CAAC,EATW,6BAA6B,6CAA7B,6BAA6B,QASxC","sourcesContent":["import type {\n  PermissionTypes,\n  BasePermission,\n  NativeTokenStreamPermission,\n  NativeTokenPeriodicPermission,\n  Erc20TokenStreamPermission,\n  Erc20TokenPeriodicPermission,\n  Rule,\n  MetaMaskBasePermissionData,\n  Erc20TokenRevocationPermission,\n} from '@metamask/7715-permission-types';\nimport type { Delegation } from '@metamask/delegation-core';\nimport type { Hex } from '@metamask/utils';\n\n/**\n * Enum for the error codes of the gator permissions controller.\n */\nexport enum GatorPermissionsControllerErrorCode {\n  GatorPermissionsFetchError = 'gator-permissions-fetch-error',\n  GatorPermissionsNotEnabled = 'gator-permissions-not-enabled',\n  GatorPermissionsProviderError = 'gator-permissions-provider-error',\n  GatorPermissionsMapSerializationError = 'gator-permissions-map-serialization-error',\n  PermissionDecodingError = 'permission-decoding-error',\n  OriginNotAllowedError = 'origin-not-allowed-error',\n}\n\n/**\n * Enum for the RPC methods of the gator permissions provider snap.\n */\nexport enum GatorPermissionsSnapRpcMethod {\n  /**\n   * This method is used by the metamask to request a permissions provider to get granted permissions for all sites.\n   */\n  PermissionProviderGetGrantedPermissions = 'permissionsProvider_getGrantedPermissions',\n  /**\n   * This method is used by the metamask to submit a revocation to the permissions provider.\n   */\n  PermissionProviderSubmitRevocation = 'permissionsProvider_submitRevocation',\n}\n\n/**\n * Represents a custom permission that are not of the standard ERC-7715 permission types.\n */\nexport type CustomPermission = BasePermission & {\n  type: 'custom';\n  data: MetaMaskBasePermissionData & Record<string, unknown>;\n};\n\n/**\n * Represents the type of the ERC-7715 permissions that can be granted including custom permissions.\n */\nexport type PermissionTypesWithCustom = PermissionTypes | CustomPermission;\n\n/**\n * Represents a ERC-7715 permission request.\n *\n * @template to - The type of the signer provided, either an AccountSigner or WalletSigner.\n * @template Permission - The type of the permission provided.\n */\nexport type PermissionRequest<TPermission extends PermissionTypesWithCustom> = {\n  /**\n   * hex-encoding of uint256 defined the chain with EIP-155\n   */\n  chainId: Hex;\n\n  /**\n   *\n   * The account being targeted for this permission request.\n   * It is optional to let the user choose which account to grant permission from.\n   */\n  from?: Hex;\n\n  /**\n   * A field that identifies the DApp session account associated with the permission\n   */\n  to: Hex;\n\n  /**\n   * Defines the allowed behavior the `to` account can do on behalf of the `from` account.\n   */\n  permission: TPermission;\n\n  rules?: Rule[] | null;\n};\n\n/**\n * Represents a ERC-7715 permission response.\n *\n * @template Permission - The type of the permission provided.\n */\nexport type PermissionResponse<TPermission extends PermissionTypesWithCustom> =\n  PermissionRequest<TPermission> & {\n    /**\n     * Is a catch-all to identify a permission for revoking permissions or submitting\n     * Defined in ERC-7710.\n     */\n    context: Hex;\n\n    /**\n     * The dependencyInfo field is required and contains information needed to deploy accounts.\n     * Each entry specifies a factory contract and its associated deployment data.\n     * If no account deployment is needed when redeeming the permission, this array must be empty.\n     * When non-empty, DApps MUST deploy the accounts by calling the factory contract with factoryData as the calldata.\n     * Defined in ERC-4337.\n     */\n    dependencies: {\n      factory: Hex;\n      factoryData: Hex;\n    }[];\n\n    /**\n     * Is required as defined in ERC-7710.\n     */\n    delegationManager: Hex;\n  };\n\n/**\n * Represents a sanitized version of the PermissionResponse type.\n * Internal fields (dependencies, to) are removed\n *\n * @template Permission - The type of the permission provided.\n */\nexport type PermissionResponseSanitized<\n  TPermission extends PermissionTypesWithCustom,\n> = Omit<PermissionResponse<TPermission>, 'dependencies' | 'to'>;\n\n/**\n * Represents a gator ERC-7715 granted(ie. signed by a user's account) permission entry that is stored in profile sync.\n *\n * @template Permission - The type of the permission provided\n */\nexport type StoredGatorPermission<\n  TPermission extends PermissionTypesWithCustom,\n> = {\n  permissionResponse: PermissionResponse<TPermission>;\n  siteOrigin: string;\n  revocationMetadata?: RevocationMetadata;\n};\n\n/**\n * Represents a sanitized version of the StoredGatorPermission type. Some fields have been removed but the fields are still present in profile sync.\n *\n * @template Permission - The type of the permission provided.\n */\nexport type StoredGatorPermissionSanitized<\n  TPermission extends PermissionTypesWithCustom,\n> = {\n  permissionResponse: PermissionResponseSanitized<TPermission>;\n  siteOrigin: string;\n  revocationMetadata?: RevocationMetadata;\n};\n\n/**\n * Represents a map of gator permissions by chainId and permission type.\n */\nexport type GatorPermissionsMap = {\n  'erc20-token-revocation': {\n    [\n      chainId: Hex\n    ]: StoredGatorPermissionSanitized<Erc20TokenRevocationPermission>[];\n  };\n  'native-token-stream': {\n    [\n      chainId: Hex\n    ]: StoredGatorPermissionSanitized<NativeTokenStreamPermission>[];\n  };\n  'native-token-periodic': {\n    [\n      chainId: Hex\n    ]: StoredGatorPermissionSanitized<NativeTokenPeriodicPermission>[];\n  };\n  'erc20-token-stream': {\n    [\n      chainId: Hex\n    ]: StoredGatorPermissionSanitized<Erc20TokenStreamPermission>[];\n  };\n  'erc20-token-periodic': {\n    [\n      chainId: Hex\n    ]: StoredGatorPermissionSanitized<Erc20TokenPeriodicPermission>[];\n  };\n  other: {\n    [chainId: Hex]: StoredGatorPermissionSanitized<CustomPermission>[];\n  };\n};\n\n/**\n * Represents the supported permission type(e.g. 'native-token-stream', 'native-token-periodic', 'erc20-token-stream', 'erc20-token-periodic') of the gator permissions map.\n */\nexport type SupportedGatorPermissionType = keyof GatorPermissionsMap;\n\n/**\n * Represents a map of gator permissions for a given permission type with key of chainId. The value being an array of gator permissions for that chainId.\n */\nexport type GatorPermissionsMapByPermissionType<\n  TPermissionType extends SupportedGatorPermissionType,\n> = GatorPermissionsMap[TPermissionType];\n\n/**\n * Represents an array of gator permissions for a given permission type and chainId.\n */\nexport type GatorPermissionsListByPermissionTypeAndChainId<\n  TPermissionType extends SupportedGatorPermissionType,\n> = GatorPermissionsMap[TPermissionType][Hex];\n\n/**\n * Represents the details of a delegation, that are required to decode a permission.\n */\nexport type DelegationDetails = Pick<\n  Delegation<Hex>,\n  'caveats' | 'delegator' | 'delegate' | 'authority'\n>;\n\n/**\n * Represents the metadata for confirmed transaction revocation.\n */\nexport type RevocationMetadata = {\n  // The timestamp at which the revocation was recorded in storage.\n  recordedAt: number;\n  // The hash of the transaction that was used to revoke the permission. Optional because we might not have submitted the transaction ourselves.\n  txHash?: Hex | undefined;\n};\n\n/**\n * Parameters for the `permissionsProvider_submitRevocation` method\n */\nexport type RevocationParams = {\n  /**\n   * The permission context as a hex string that identifies the permission to revoke.\n   */\n  permissionContext: Hex;\n\n  /**\n   * The hash of the transaction that was used to revoke the permission. Optional because we might not have submitted the transaction ourselves.\n   */\n  txHash: Hex | undefined;\n};\n\n/**\n * Represents the parameters for adding a pending revocation.\n */\nexport type PendingRevocationParams = {\n  /**\n   * The transaction metadata ID to monitor.\n   */\n  txId: string;\n  /**\n   * The permission context as a hex string that identifies the permission to revoke.\n   */\n  permissionContext: Hex;\n};\n"]}

package/dist/types.d.cts

@@ -98,17 +98,14 @@ export type PermissionResponse<TPermission extends PermissionTypesWithCustom> =
  */
 export type PermissionResponseSanitized<TPermission extends PermissionTypesWithCustom> = Omit<PermissionResponse<TPermission>, 'dependencies' | 'to'>;
 /**
- * Represents a gator ERC-7715 granted(ie. signed by an user account) permission entry that is stored in profile sync.
+ * Represents a gator ERC-7715 granted(ie. signed by a user's account) permission entry that is stored in profile sync.
  *
  * @template Permission - The type of the permission provided
  */
 export type StoredGatorPermission<TPermission extends PermissionTypesWithCustom> = {
     permissionResponse: PermissionResponse<TPermission>;
     siteOrigin: string;
-    /**
-     * Flag indicating whether this permission has been revoked.
-     */
-    isRevoked?: boolean;
+    revocationMetadata?: RevocationMetadata;
 };
 /**
  * Represents a sanitized version of the StoredGatorPermission type. Some fields have been removed but the fields are still present in profile sync.
@@ -118,10 +115,7 @@ export type StoredGatorPermission<TPermission extends PermissionTypesWithCustom>
 export type StoredGatorPermissionSanitized<TPermission extends PermissionTypesWithCustom> = {
     permissionResponse: PermissionResponseSanitized<TPermission>;
     siteOrigin: string;
-    /**
-     * Flag indicating whether this permission has been revoked.
-     */
-    isRevoked?: boolean;
+    revocationMetadata?: RevocationMetadata;
 };
 /**
  * Represents a map of gator permissions by chainId and permission type.
@@ -163,13 +157,24 @@ export type GatorPermissionsListByPermissionTypeAndChainId<TPermissionType exten
  */
 export type DelegationDetails = Pick<Delegation<Hex>, 'caveats' | 'delegator' | 'delegate' | 'authority'>;
 /**
- * Represents the parameters for submitting a revocation.
+ * Represents the metadata for confirmed transaction revocation.
+ */
+export type RevocationMetadata = {
+    recordedAt: number;
+    txHash?: Hex | undefined;
+};
+/**
+ * Parameters for the `permissionsProvider_submitRevocation` method
  */
 export type RevocationParams = {
     /**
      * The permission context as a hex string that identifies the permission to revoke.
      */
     permissionContext: Hex;
+    /**
+     * The hash of the transaction that was used to revoke the permission. Optional because we might not have submitted the transaction ourselves.
+     */
+    txHash: Hex | undefined;
 };
 /**
  * Represents the parameters for adding a pending revocation.

package/dist/types.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.cts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.cts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.d.mts

@@ -98,17 +98,14 @@ export type PermissionResponse<TPermission extends PermissionTypesWithCustom> =
  */
 export type PermissionResponseSanitized<TPermission extends PermissionTypesWithCustom> = Omit<PermissionResponse<TPermission>, 'dependencies' | 'to'>;
 /**
- * Represents a gator ERC-7715 granted(ie. signed by an user account) permission entry that is stored in profile sync.
+ * Represents a gator ERC-7715 granted(ie. signed by a user's account) permission entry that is stored in profile sync.
  *
  * @template Permission - The type of the permission provided
  */
 export type StoredGatorPermission<TPermission extends PermissionTypesWithCustom> = {
     permissionResponse: PermissionResponse<TPermission>;
     siteOrigin: string;
-    /**
-     * Flag indicating whether this permission has been revoked.
-     */
-    isRevoked?: boolean;
+    revocationMetadata?: RevocationMetadata;
 };
 /**
  * Represents a sanitized version of the StoredGatorPermission type. Some fields have been removed but the fields are still present in profile sync.
@@ -118,10 +115,7 @@ export type StoredGatorPermission<TPermission extends PermissionTypesWithCustom>
 export type StoredGatorPermissionSanitized<TPermission extends PermissionTypesWithCustom> = {
     permissionResponse: PermissionResponseSanitized<TPermission>;
     siteOrigin: string;
-    /**
-     * Flag indicating whether this permission has been revoked.
-     */
-    isRevoked?: boolean;
+    revocationMetadata?: RevocationMetadata;
 };
 /**
  * Represents a map of gator permissions by chainId and permission type.
@@ -163,13 +157,24 @@ export type GatorPermissionsListByPermissionTypeAndChainId<TPermissionType exten
  */
 export type DelegationDetails = Pick<Delegation<Hex>, 'caveats' | 'delegator' | 'delegate' | 'authority'>;
 /**
- * Represents the parameters for submitting a revocation.
+ * Represents the metadata for confirmed transaction revocation.
+ */
+export type RevocationMetadata = {
+    recordedAt: number;
+    txHash?: Hex | undefined;
+};
+/**
+ * Parameters for the `permissionsProvider_submitRevocation` method
  */
 export type RevocationParams = {
     /**
      * The permission context as a hex string that identifies the permission to revoke.
      */
     permissionContext: Hex;
+    /**
+     * The hash of the transaction that was used to revoke the permission. Optional because we might not have submitted the transaction ourselves.
+     */
+    txHash: Hex | undefined;
 };
 /**
  * Represents the parameters for adding a pending revocation.

package/dist/types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.mts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"types.mjs","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAcA;;GAEG;AACH,MAAM,CAAN,IAAY,mCAOX;AAPD,WAAY,mCAAmC;IAC7C,mGAA4D,CAAA;IAC5D,mGAA4D,CAAA;IAC5D,yGAAkE,CAAA;IAClE,0HAAmF,CAAA;IACnF,4FAAqD,CAAA;IACrD,yFAAkD,CAAA;AACpD,CAAC,EAPW,mCAAmC,KAAnC,mCAAmC,QAO9C;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,6BASX;AATD,WAAY,6BAA6B;IACvC;;OAEG;IACH,sHAAqF,CAAA;IACrF;;OAEG;IACH,4GAA2E,CAAA;AAC7E,CAAC,EATW,6BAA6B,KAA7B,6BAA6B,QASxC","sourcesContent":["import type {\n  PermissionTypes,\n  BasePermission,\n  NativeTokenStreamPermission,\n  NativeTokenPeriodicPermission,\n  Erc20TokenStreamPermission,\n  Erc20TokenPeriodicPermission,\n  Rule,\n  MetaMaskBasePermissionData,\n  Erc20TokenRevocationPermission,\n} from '@metamask/7715-permission-types';\nimport type { Delegation } from '@metamask/delegation-core';\nimport type { Hex } from '@metamask/utils';\n\n/**\n * Enum for the error codes of the gator permissions controller.\n */\nexport enum GatorPermissionsControllerErrorCode {\n  GatorPermissionsFetchError = 'gator-permissions-fetch-error',\n  GatorPermissionsNotEnabled = 'gator-permissions-not-enabled',\n  GatorPermissionsProviderError = 'gator-permissions-provider-error',\n  GatorPermissionsMapSerializationError = 'gator-permissions-map-serialization-error',\n  PermissionDecodingError = 'permission-decoding-error',\n  OriginNotAllowedError = 'origin-not-allowed-error',\n}\n\n/**\n * Enum for the RPC methods of the gator permissions provider snap.\n */\nexport enum GatorPermissionsSnapRpcMethod {\n  /**\n   * This method is used by the metamask to request a permissions provider to get granted permissions for all sites.\n   */\n  PermissionProviderGetGrantedPermissions = 'permissionsProvider_getGrantedPermissions',\n  /**\n   * This method is used by the metamask to submit a revocation to the permissions provider.\n   */\n  PermissionProviderSubmitRevocation = 'permissionsProvider_submitRevocation',\n}\n\n/**\n * Represents a custom permission that are not of the standard ERC-7715 permission types.\n */\nexport type CustomPermission = BasePermission & {\n  type: 'custom';\n  data: MetaMaskBasePermissionData & Record<string, unknown>;\n};\n\n/**\n * Represents the type of the ERC-7715 permissions that can be granted including custom permissions.\n */\nexport type PermissionTypesWithCustom = PermissionTypes | CustomPermission;\n\n/**\n * Represents a ERC-7715 permission request.\n *\n * @template to - The type of the signer provided, either an AccountSigner or WalletSigner.\n * @template Permission - The type of the permission provided.\n */\nexport type PermissionRequest<TPermission extends PermissionTypesWithCustom> = {\n  /**\n   * hex-encoding of uint256 defined the chain with EIP-155\n   */\n  chainId: Hex;\n\n  /**\n   *\n   * The account being targeted for this permission request.\n   * It is optional to let the user choose which account to grant permission from.\n   */\n  from?: Hex;\n\n  /**\n   * A field that identifies the DApp session account associated with the permission\n   */\n  to: Hex;\n\n  /**\n   * Defines the allowed behavior the `to` account can do on behalf of the `from` account.\n   */\n  permission: TPermission;\n\n  rules?: Rule[] | null;\n};\n\n/**\n * Represents a ERC-7715 permission response.\n *\n * @template Permission - The type of the permission provided.\n */\nexport type PermissionResponse<TPermission extends PermissionTypesWithCustom> =\n  PermissionRequest<TPermission> & {\n    /**\n     * Is a catch-all to identify a permission for revoking permissions or submitting\n     * Defined in ERC-7710.\n     */\n    context: Hex;\n\n    /**\n     * The dependencyInfo field is required and contains information needed to deploy accounts.\n     * Each entry specifies a factory contract and its associated deployment data.\n     * If no account deployment is needed when redeeming the permission, this array must be empty.\n     * When non-empty, DApps MUST deploy the accounts by calling the factory contract with factoryData as the calldata.\n     * Defined in ERC-4337.\n     */\n    dependencies: {\n      factory: Hex;\n      factoryData: Hex;\n    }[];\n\n    /**\n     * Is required as defined in ERC-7710.\n     */\n    delegationManager: Hex;\n  };\n\n/**\n * Represents a sanitized version of the PermissionResponse type.\n * Internal fields (dependencies, to) are removed\n *\n * @template Permission - The type of the permission provided.\n */\nexport type PermissionResponseSanitized<\n  TPermission extends PermissionTypesWithCustom,\n> = Omit<PermissionResponse<TPermission>, 'dependencies' | 'to'>;\n\n/**\n * Represents a gator ERC-7715 granted(ie. signed by an user account) permission entry that is stored in profile sync.\n *\n * @template Permission - The type of the permission provided\n */\nexport type StoredGatorPermission<\n  TPermission extends PermissionTypesWithCustom,\n> = {\n  permissionResponse: PermissionResponse<TPermission>;\n  siteOrigin: string;\n  /**\n   * Flag indicating whether this permission has been revoked.\n   */\n  isRevoked?: boolean;\n};\n\n/**\n * Represents a sanitized version of the StoredGatorPermission type. Some fields have been removed but the fields are still present in profile sync.\n *\n * @template Permission - The type of the permission provided.\n */\nexport type StoredGatorPermissionSanitized<\n  TPermission extends PermissionTypesWithCustom,\n> = {\n  permissionResponse: PermissionResponseSanitized<TPermission>;\n  siteOrigin: string;\n  /**\n   * Flag indicating whether this permission has been revoked.\n   */\n  isRevoked?: boolean;\n};\n\n/**\n * Represents a map of gator permissions by chainId and permission type.\n */\nexport type GatorPermissionsMap = {\n  'erc20-token-revocation': {\n    [\n      chainId: Hex\n    ]: StoredGatorPermissionSanitized<Erc20TokenRevocationPermission>[];\n  };\n  'native-token-stream': {\n    [\n      chainId: Hex\n    ]: StoredGatorPermissionSanitized<NativeTokenStreamPermission>[];\n  };\n  'native-token-periodic': {\n    [\n      chainId: Hex\n    ]: StoredGatorPermissionSanitized<NativeTokenPeriodicPermission>[];\n  };\n  'erc20-token-stream': {\n    [\n      chainId: Hex\n    ]: StoredGatorPermissionSanitized<Erc20TokenStreamPermission>[];\n  };\n  'erc20-token-periodic': {\n    [\n      chainId: Hex\n    ]: StoredGatorPermissionSanitized<Erc20TokenPeriodicPermission>[];\n  };\n  other: {\n    [chainId: Hex]: StoredGatorPermissionSanitized<CustomPermission>[];\n  };\n};\n\n/**\n * Represents the supported permission type(e.g. 'native-token-stream', 'native-token-periodic', 'erc20-token-stream', 'erc20-token-periodic') of the gator permissions map.\n */\nexport type SupportedGatorPermissionType = keyof GatorPermissionsMap;\n\n/**\n * Represents a map of gator permissions for a given permission type with key of chainId. The value being an array of gator permissions for that chainId.\n */\nexport type GatorPermissionsMapByPermissionType<\n  TPermissionType extends SupportedGatorPermissionType,\n> = GatorPermissionsMap[TPermissionType];\n\n/**\n * Represents an array of gator permissions for a given permission type and chainId.\n */\nexport type GatorPermissionsListByPermissionTypeAndChainId<\n  TPermissionType extends SupportedGatorPermissionType,\n> = GatorPermissionsMap[TPermissionType][Hex];\n\n/**\n * Represents the details of a delegation, that are required to decode a permission.\n */\nexport type DelegationDetails = Pick<\n  Delegation<Hex>,\n  'caveats' | 'delegator' | 'delegate' | 'authority'\n>;\n\n/**\n * Represents the parameters for submitting a revocation.\n */\nexport type RevocationParams = {\n  /**\n   * The permission context as a hex string that identifies the permission to revoke.\n   */\n  permissionContext: Hex;\n};\n\n/**\n * Represents the parameters for adding a pending revocation.\n */\nexport type PendingRevocationParams = {\n  /**\n   * The transaction metadata ID to monitor.\n   */\n  txId: string;\n  /**\n   * The permission context as a hex string that identifies the permission to revoke.\n   */\n  permissionContext: Hex;\n};\n"]}
+{"version":3,"file":"types.mjs","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAcA;;GAEG;AACH,MAAM,CAAN,IAAY,mCAOX;AAPD,WAAY,mCAAmC;IAC7C,mGAA4D,CAAA;IAC5D,mGAA4D,CAAA;IAC5D,yGAAkE,CAAA;IAClE,0HAAmF,CAAA;IACnF,4FAAqD,CAAA;IACrD,yFAAkD,CAAA;AACpD,CAAC,EAPW,mCAAmC,KAAnC,mCAAmC,QAO9C;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,6BASX;AATD,WAAY,6BAA6B;IACvC;;OAEG;IACH,sHAAqF,CAAA;IACrF;;OAEG;IACH,4GAA2E,CAAA;AAC7E,CAAC,EATW,6BAA6B,KAA7B,6BAA6B,QASxC","sourcesContent":["import type {\n  PermissionTypes,\n  BasePermission,\n  NativeTokenStreamPermission,\n  NativeTokenPeriodicPermission,\n  Erc20TokenStreamPermission,\n  Erc20TokenPeriodicPermission,\n  Rule,\n  MetaMaskBasePermissionData,\n  Erc20TokenRevocationPermission,\n} from '@metamask/7715-permission-types';\nimport type { Delegation } from '@metamask/delegation-core';\nimport type { Hex } from '@metamask/utils';\n\n/**\n * Enum for the error codes of the gator permissions controller.\n */\nexport enum GatorPermissionsControllerErrorCode {\n  GatorPermissionsFetchError = 'gator-permissions-fetch-error',\n  GatorPermissionsNotEnabled = 'gator-permissions-not-enabled',\n  GatorPermissionsProviderError = 'gator-permissions-provider-error',\n  GatorPermissionsMapSerializationError = 'gator-permissions-map-serialization-error',\n  PermissionDecodingError = 'permission-decoding-error',\n  OriginNotAllowedError = 'origin-not-allowed-error',\n}\n\n/**\n * Enum for the RPC methods of the gator permissions provider snap.\n */\nexport enum GatorPermissionsSnapRpcMethod {\n  /**\n   * This method is used by the metamask to request a permissions provider to get granted permissions for all sites.\n   */\n  PermissionProviderGetGrantedPermissions = 'permissionsProvider_getGrantedPermissions',\n  /**\n   * This method is used by the metamask to submit a revocation to the permissions provider.\n   */\n  PermissionProviderSubmitRevocation = 'permissionsProvider_submitRevocation',\n}\n\n/**\n * Represents a custom permission that are not of the standard ERC-7715 permission types.\n */\nexport type CustomPermission = BasePermission & {\n  type: 'custom';\n  data: MetaMaskBasePermissionData & Record<string, unknown>;\n};\n\n/**\n * Represents the type of the ERC-7715 permissions that can be granted including custom permissions.\n */\nexport type PermissionTypesWithCustom = PermissionTypes | CustomPermission;\n\n/**\n * Represents a ERC-7715 permission request.\n *\n * @template to - The type of the signer provided, either an AccountSigner or WalletSigner.\n * @template Permission - The type of the permission provided.\n */\nexport type PermissionRequest<TPermission extends PermissionTypesWithCustom> = {\n  /**\n   * hex-encoding of uint256 defined the chain with EIP-155\n   */\n  chainId: Hex;\n\n  /**\n   *\n   * The account being targeted for this permission request.\n   * It is optional to let the user choose which account to grant permission from.\n   */\n  from?: Hex;\n\n  /**\n   * A field that identifies the DApp session account associated with the permission\n   */\n  to: Hex;\n\n  /**\n   * Defines the allowed behavior the `to` account can do on behalf of the `from` account.\n   */\n  permission: TPermission;\n\n  rules?: Rule[] | null;\n};\n\n/**\n * Represents a ERC-7715 permission response.\n *\n * @template Permission - The type of the permission provided.\n */\nexport type PermissionResponse<TPermission extends PermissionTypesWithCustom> =\n  PermissionRequest<TPermission> & {\n    /**\n     * Is a catch-all to identify a permission for revoking permissions or submitting\n     * Defined in ERC-7710.\n     */\n    context: Hex;\n\n    /**\n     * The dependencyInfo field is required and contains information needed to deploy accounts.\n     * Each entry specifies a factory contract and its associated deployment data.\n     * If no account deployment is needed when redeeming the permission, this array must be empty.\n     * When non-empty, DApps MUST deploy the accounts by calling the factory contract with factoryData as the calldata.\n     * Defined in ERC-4337.\n     */\n    dependencies: {\n      factory: Hex;\n      factoryData: Hex;\n    }[];\n\n    /**\n     * Is required as defined in ERC-7710.\n     */\n    delegationManager: Hex;\n  };\n\n/**\n * Represents a sanitized version of the PermissionResponse type.\n * Internal fields (dependencies, to) are removed\n *\n * @template Permission - The type of the permission provided.\n */\nexport type PermissionResponseSanitized<\n  TPermission extends PermissionTypesWithCustom,\n> = Omit<PermissionResponse<TPermission>, 'dependencies' | 'to'>;\n\n/**\n * Represents a gator ERC-7715 granted(ie. signed by a user's account) permission entry that is stored in profile sync.\n *\n * @template Permission - The type of the permission provided\n */\nexport type StoredGatorPermission<\n  TPermission extends PermissionTypesWithCustom,\n> = {\n  permissionResponse: PermissionResponse<TPermission>;\n  siteOrigin: string;\n  revocationMetadata?: RevocationMetadata;\n};\n\n/**\n * Represents a sanitized version of the StoredGatorPermission type. Some fields have been removed but the fields are still present in profile sync.\n *\n * @template Permission - The type of the permission provided.\n */\nexport type StoredGatorPermissionSanitized<\n  TPermission extends PermissionTypesWithCustom,\n> = {\n  permissionResponse: PermissionResponseSanitized<TPermission>;\n  siteOrigin: string;\n  revocationMetadata?: RevocationMetadata;\n};\n\n/**\n * Represents a map of gator permissions by chainId and permission type.\n */\nexport type GatorPermissionsMap = {\n  'erc20-token-revocation': {\n    [\n      chainId: Hex\n    ]: StoredGatorPermissionSanitized<Erc20TokenRevocationPermission>[];\n  };\n  'native-token-stream': {\n    [\n      chainId: Hex\n    ]: StoredGatorPermissionSanitized<NativeTokenStreamPermission>[];\n  };\n  'native-token-periodic': {\n    [\n      chainId: Hex\n    ]: StoredGatorPermissionSanitized<NativeTokenPeriodicPermission>[];\n  };\n  'erc20-token-stream': {\n    [\n      chainId: Hex\n    ]: StoredGatorPermissionSanitized<Erc20TokenStreamPermission>[];\n  };\n  'erc20-token-periodic': {\n    [\n      chainId: Hex\n    ]: StoredGatorPermissionSanitized<Erc20TokenPeriodicPermission>[];\n  };\n  other: {\n    [chainId: Hex]: StoredGatorPermissionSanitized<CustomPermission>[];\n  };\n};\n\n/**\n * Represents the supported permission type(e.g. 'native-token-stream', 'native-token-periodic', 'erc20-token-stream', 'erc20-token-periodic') of the gator permissions map.\n */\nexport type SupportedGatorPermissionType = keyof GatorPermissionsMap;\n\n/**\n * Represents a map of gator permissions for a given permission type with key of chainId. The value being an array of gator permissions for that chainId.\n */\nexport type GatorPermissionsMapByPermissionType<\n  TPermissionType extends SupportedGatorPermissionType,\n> = GatorPermissionsMap[TPermissionType];\n\n/**\n * Represents an array of gator permissions for a given permission type and chainId.\n */\nexport type GatorPermissionsListByPermissionTypeAndChainId<\n  TPermissionType extends SupportedGatorPermissionType,\n> = GatorPermissionsMap[TPermissionType][Hex];\n\n/**\n * Represents the details of a delegation, that are required to decode a permission.\n */\nexport type DelegationDetails = Pick<\n  Delegation<Hex>,\n  'caveats' | 'delegator' | 'delegate' | 'authority'\n>;\n\n/**\n * Represents the metadata for confirmed transaction revocation.\n */\nexport type RevocationMetadata = {\n  // The timestamp at which the revocation was recorded in storage.\n  recordedAt: number;\n  // The hash of the transaction that was used to revoke the permission. Optional because we might not have submitted the transaction ourselves.\n  txHash?: Hex | undefined;\n};\n\n/**\n * Parameters for the `permissionsProvider_submitRevocation` method\n */\nexport type RevocationParams = {\n  /**\n   * The permission context as a hex string that identifies the permission to revoke.\n   */\n  permissionContext: Hex;\n\n  /**\n   * The hash of the transaction that was used to revoke the permission. Optional because we might not have submitted the transaction ourselves.\n   */\n  txHash: Hex | undefined;\n};\n\n/**\n * Represents the parameters for adding a pending revocation.\n */\nexport type PendingRevocationParams = {\n  /**\n   * The transaction metadata ID to monitor.\n   */\n  txId: string;\n  /**\n   * The permission context as a hex string that identifies the permission to revoke.\n   */\n  permissionContext: Hex;\n};\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamask/gator-permissions-controller",
-  "version": "1.0.0",
+  "version": "1.1.1",
   "description": "Controller for managing gator permissions with profile sync integration",
   "keywords": [
     "MetaMask",
@@ -56,7 +56,7 @@
     "@metamask/snaps-controllers": "^17.2.0",
     "@metamask/snaps-sdk": "^10.3.0",
     "@metamask/snaps-utils": "^11.7.0",
-    "@metamask/transaction-controller": "^62.9.1",
+    "@metamask/transaction-controller": "^62.10.0",
     "@metamask/utils": "^11.9.0"
   },
   "devDependencies": {