@metamask/delegation-core 1.1.0 → 2.0.0

package/dist/index.d.cts

@@ -15,6 +15,11 @@ type DelegationStruct<TBytes extends BytesLike = BytesLike> = {
     signature: TBytes;
 };
 
+declare enum BalanceChangeType {
+    Increase = 0,
+    Decrease = 1
+}
+
 type ResultValue = 'hex' | 'bytes';
 type ResultType<TResultValue extends ResultValue> = TResultValue extends 'hex' ? Hex : Uint8Array;
 type DecodedBytesLike<TResultValue extends ResultValue> = ResultType<TResultValue>;
@@ -119,7 +124,7 @@ declare function decodeNativeTokenPaymentTerms(terms: BytesLike, encodingOptions
 type NativeBalanceChangeTerms<TBytesLike extends BytesLike = BytesLike> = {
     recipient: TBytesLike;
     balance: bigint;
-    changeType: number;
+    changeType: BalanceChangeType;
 };
 declare function createNativeBalanceChangeTerms(terms: NativeBalanceChangeTerms, encodingOptions?: EncodingOptions<'hex'>): Hex;
 declare function createNativeBalanceChangeTerms(terms: NativeBalanceChangeTerms, encodingOptions: EncodingOptions<'bytes'>): Uint8Array;
@@ -162,7 +167,7 @@ type ERC20BalanceChangeTerms<TBytesLike extends BytesLike = BytesLike> = {
     tokenAddress: TBytesLike;
     recipient: TBytesLike;
     balance: bigint;
-    changeType: number;
+    changeType: BalanceChangeType;
 };
 declare function createERC20BalanceChangeTerms(terms: ERC20BalanceChangeTerms, encodingOptions?: EncodingOptions<'hex'>): Hex;
 declare function createERC20BalanceChangeTerms(terms: ERC20BalanceChangeTerms, encodingOptions: EncodingOptions<'bytes'>): Uint8Array;
@@ -173,7 +178,7 @@ type ERC721BalanceChangeTerms<TBytesLike extends BytesLike = BytesLike> = {
     tokenAddress: TBytesLike;
     recipient: TBytesLike;
     amount: bigint;
-    changeType: number;
+    changeType: BalanceChangeType;
 };
 declare function createERC721BalanceChangeTerms(terms: ERC721BalanceChangeTerms, encodingOptions?: EncodingOptions<'hex'>): Hex;
 declare function createERC721BalanceChangeTerms(terms: ERC721BalanceChangeTerms, encodingOptions: EncodingOptions<'bytes'>): Uint8Array;
@@ -194,7 +199,7 @@ type ERC1155BalanceChangeTerms<TBytesLike extends BytesLike = BytesLike> = {
     recipient: TBytesLike;
     tokenId: bigint;
     balance: bigint;
-    changeType: number;
+    changeType: BalanceChangeType;
 };
 declare function createERC1155BalanceChangeTerms(terms: ERC1155BalanceChangeTerms, encodingOptions?: EncodingOptions<'hex'>): Hex;
 declare function createERC1155BalanceChangeTerms(terms: ERC1155BalanceChangeTerms, encodingOptions: EncodingOptions<'bytes'>): Uint8Array;
@@ -316,6 +321,22 @@ declare function createSpecificActionERC20TransferBatchTerms(terms: SpecificActi
 declare function decodeSpecificActionERC20TransferBatchTerms(terms: BytesLike, encodingOptions?: EncodingOptions<'hex'>): SpecificActionERC20TransferBatchTerms<DecodedBytesLike<'hex'>>;
 declare function decodeSpecificActionERC20TransferBatchTerms(terms: BytesLike, encodingOptions: EncodingOptions<'bytes'>): SpecificActionERC20TransferBatchTerms<DecodedBytesLike<'bytes'>>;
 
+type LogicalOrWrapperTerms<TBytesLike extends BytesLike = BytesLike> = {
+    caveatGroups: CaveatStruct<TBytesLike>[][];
+};
+type LogicalOrWrapperArgs<TBytesLike extends BytesLike = BytesLike> = {
+    groupIndex: bigint;
+    caveatArgs: TBytesLike[];
+};
+declare function createLogicalOrWrapperTerms(terms: LogicalOrWrapperTerms, encodingOptions?: EncodingOptions<'hex'>): Hex;
+declare function createLogicalOrWrapperTerms(terms: LogicalOrWrapperTerms, encodingOptions: EncodingOptions<'bytes'>): Uint8Array;
+declare function decodeLogicalOrWrapperTerms(terms: BytesLike, encodingOptions?: EncodingOptions<'hex'>): LogicalOrWrapperTerms<DecodedBytesLike<'hex'>>;
+declare function decodeLogicalOrWrapperTerms(terms: BytesLike, encodingOptions: EncodingOptions<'bytes'>): LogicalOrWrapperTerms<DecodedBytesLike<'bytes'>>;
+declare function createLogicalOrWrapperArgs(args: LogicalOrWrapperArgs, encodingOptions?: EncodingOptions<'hex'>): Hex;
+declare function createLogicalOrWrapperArgs(args: LogicalOrWrapperArgs, encodingOptions: EncodingOptions<'bytes'>): Uint8Array;
+declare function decodeLogicalOrWrapperArgs(args: BytesLike, encodingOptions?: EncodingOptions<'hex'>): LogicalOrWrapperArgs<DecodedBytesLike<'hex'>>;
+declare function decodeLogicalOrWrapperArgs(args: BytesLike, encodingOptions: EncodingOptions<'bytes'>): LogicalOrWrapperArgs<DecodedBytesLike<'bytes'>>;
+
 declare const ANY_BENEFICIARY: "0x0000000000000000000000000000000000000a11";
 declare const ROOT_AUTHORITY: "0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff";
 declare const DELEGATION_TYPEHASH: "0x88c1d2ecf185adf710588203a5f263f0ff61be0d33da39792cde19ba9aa4331e";
@@ -331,4 +352,4 @@ declare function decodeDelegation(encoded: BytesLike, options: EncodingOptions<'
 declare function hashDelegation(delegation: DelegationStruct, options?: EncodingOptions<'hex'>): Hex;
 declare function hashDelegation(delegation: DelegationStruct, options: EncodingOptions<'bytes'>): Uint8Array;
 
-export { ANY_BENEFICIARY, CAVEAT_TYPEHASH, type CaveatStruct as Caveat, DELEGATION_TYPEHASH, type DelegationStruct as Delegation, ROOT_AUTHORITY, createAllowedCalldataTerms, createAllowedMethodsTerms, createAllowedTargetsTerms, createArgsEqualityCheckTerms, createBlockNumberTerms, createDeployedTerms, createERC1155BalanceChangeTerms, createERC20BalanceChangeTerms, createERC20StreamingTerms, createERC20TokenPeriodTransferTerms, createERC20TransferAmountTerms, createERC721BalanceChangeTerms, createERC721TransferTerms, createExactCalldataBatchTerms, createExactCalldataTerms, createExactExecutionBatchTerms, createExactExecutionTerms, createIdTerms, createLimitedCallsTerms, createMultiTokenPeriodTerms, createNativeBalanceChangeTerms, createNativeTokenPaymentTerms, createNativeTokenPeriodTransferTerms, createNativeTokenStreamingTerms, createNativeTokenTransferAmountTerms, createNonceTerms, createOwnershipTransferTerms, createRedeemerTerms, createSpecificActionERC20TransferBatchTerms, createTimestampTerms, createValueLteTerms, decodeAllowedCalldataTerms, decodeAllowedMethodsTerms, decodeAllowedTargetsTerms, decodeArgsEqualityCheckTerms, decodeBlockNumberTerms, decodeDelegation, decodeDelegations, decodeDeployedTerms, decodeERC1155BalanceChangeTerms, decodeERC20BalanceChangeTerms, decodeERC20StreamingTerms, decodeERC20TokenPeriodTransferTerms, decodeERC20TransferAmountTerms, decodeERC721BalanceChangeTerms, decodeERC721TransferTerms, decodeExactCalldataBatchTerms, decodeExactCalldataTerms, decodeExactExecutionBatchTerms, decodeExactExecutionTerms, decodeIdTerms, decodeLimitedCallsTerms, decodeMultiTokenPeriodTerms, decodeNativeBalanceChangeTerms, decodeNativeTokenPaymentTerms, decodeNativeTokenPeriodTransferTerms, decodeNativeTokenStreamingTerms, decodeNativeTokenTransferAmountTerms, decodeNonceTerms, decodeOwnershipTransferTerms, decodeRedeemerTerms, decodeSpecificActionERC20TransferBatchTerms, decodeTimestampTerms, decodeValueLteTerms, encodeDelegation, encodeDelegations, hashDelegation };
+export { ANY_BENEFICIARY, BalanceChangeType, CAVEAT_TYPEHASH, type CaveatStruct as Caveat, DELEGATION_TYPEHASH, type DelegationStruct as Delegation, ROOT_AUTHORITY, createAllowedCalldataTerms, createAllowedMethodsTerms, createAllowedTargetsTerms, createArgsEqualityCheckTerms, createBlockNumberTerms, createDeployedTerms, createERC1155BalanceChangeTerms, createERC20BalanceChangeTerms, createERC20StreamingTerms, createERC20TokenPeriodTransferTerms, createERC20TransferAmountTerms, createERC721BalanceChangeTerms, createERC721TransferTerms, createExactCalldataBatchTerms, createExactCalldataTerms, createExactExecutionBatchTerms, createExactExecutionTerms, createIdTerms, createLimitedCallsTerms, createLogicalOrWrapperArgs, createLogicalOrWrapperTerms, createMultiTokenPeriodTerms, createNativeBalanceChangeTerms, createNativeTokenPaymentTerms, createNativeTokenPeriodTransferTerms, createNativeTokenStreamingTerms, createNativeTokenTransferAmountTerms, createNonceTerms, createOwnershipTransferTerms, createRedeemerTerms, createSpecificActionERC20TransferBatchTerms, createTimestampTerms, createValueLteTerms, decodeAllowedCalldataTerms, decodeAllowedMethodsTerms, decodeAllowedTargetsTerms, decodeArgsEqualityCheckTerms, decodeBlockNumberTerms, decodeDelegation, decodeDelegations, decodeDeployedTerms, decodeERC1155BalanceChangeTerms, decodeERC20BalanceChangeTerms, decodeERC20StreamingTerms, decodeERC20TokenPeriodTransferTerms, decodeERC20TransferAmountTerms, decodeERC721BalanceChangeTerms, decodeERC721TransferTerms, decodeExactCalldataBatchTerms, decodeExactCalldataTerms, decodeExactExecutionBatchTerms, decodeExactExecutionTerms, decodeIdTerms, decodeLimitedCallsTerms, decodeLogicalOrWrapperArgs, decodeLogicalOrWrapperTerms, decodeMultiTokenPeriodTerms, decodeNativeBalanceChangeTerms, decodeNativeTokenPaymentTerms, decodeNativeTokenPeriodTransferTerms, decodeNativeTokenStreamingTerms, decodeNativeTokenTransferAmountTerms, decodeNonceTerms, decodeOwnershipTransferTerms, decodeRedeemerTerms, decodeSpecificActionERC20TransferBatchTerms, decodeTimestampTerms, decodeValueLteTerms, encodeDelegation, encodeDelegations, hashDelegation };

package/dist/index.d.ts

@@ -15,6 +15,11 @@ type DelegationStruct<TBytes extends BytesLike = BytesLike> = {
     signature: TBytes;
 };
 
+declare enum BalanceChangeType {
+    Increase = 0,
+    Decrease = 1
+}
+
 type ResultValue = 'hex' | 'bytes';
 type ResultType<TResultValue extends ResultValue> = TResultValue extends 'hex' ? Hex : Uint8Array;
 type DecodedBytesLike<TResultValue extends ResultValue> = ResultType<TResultValue>;
@@ -119,7 +124,7 @@ declare function decodeNativeTokenPaymentTerms(terms: BytesLike, encodingOptions
 type NativeBalanceChangeTerms<TBytesLike extends BytesLike = BytesLike> = {
     recipient: TBytesLike;
     balance: bigint;
-    changeType: number;
+    changeType: BalanceChangeType;
 };
 declare function createNativeBalanceChangeTerms(terms: NativeBalanceChangeTerms, encodingOptions?: EncodingOptions<'hex'>): Hex;
 declare function createNativeBalanceChangeTerms(terms: NativeBalanceChangeTerms, encodingOptions: EncodingOptions<'bytes'>): Uint8Array;
@@ -162,7 +167,7 @@ type ERC20BalanceChangeTerms<TBytesLike extends BytesLike = BytesLike> = {
     tokenAddress: TBytesLike;
     recipient: TBytesLike;
     balance: bigint;
-    changeType: number;
+    changeType: BalanceChangeType;
 };
 declare function createERC20BalanceChangeTerms(terms: ERC20BalanceChangeTerms, encodingOptions?: EncodingOptions<'hex'>): Hex;
 declare function createERC20BalanceChangeTerms(terms: ERC20BalanceChangeTerms, encodingOptions: EncodingOptions<'bytes'>): Uint8Array;
@@ -173,7 +178,7 @@ type ERC721BalanceChangeTerms<TBytesLike extends BytesLike = BytesLike> = {
     tokenAddress: TBytesLike;
     recipient: TBytesLike;
     amount: bigint;
-    changeType: number;
+    changeType: BalanceChangeType;
 };
 declare function createERC721BalanceChangeTerms(terms: ERC721BalanceChangeTerms, encodingOptions?: EncodingOptions<'hex'>): Hex;
 declare function createERC721BalanceChangeTerms(terms: ERC721BalanceChangeTerms, encodingOptions: EncodingOptions<'bytes'>): Uint8Array;
@@ -194,7 +199,7 @@ type ERC1155BalanceChangeTerms<TBytesLike extends BytesLike = BytesLike> = {
     recipient: TBytesLike;
     tokenId: bigint;
     balance: bigint;
-    changeType: number;
+    changeType: BalanceChangeType;
 };
 declare function createERC1155BalanceChangeTerms(terms: ERC1155BalanceChangeTerms, encodingOptions?: EncodingOptions<'hex'>): Hex;
 declare function createERC1155BalanceChangeTerms(terms: ERC1155BalanceChangeTerms, encodingOptions: EncodingOptions<'bytes'>): Uint8Array;
@@ -316,6 +321,22 @@ declare function createSpecificActionERC20TransferBatchTerms(terms: SpecificActi
 declare function decodeSpecificActionERC20TransferBatchTerms(terms: BytesLike, encodingOptions?: EncodingOptions<'hex'>): SpecificActionERC20TransferBatchTerms<DecodedBytesLike<'hex'>>;
 declare function decodeSpecificActionERC20TransferBatchTerms(terms: BytesLike, encodingOptions: EncodingOptions<'bytes'>): SpecificActionERC20TransferBatchTerms<DecodedBytesLike<'bytes'>>;
 
+type LogicalOrWrapperTerms<TBytesLike extends BytesLike = BytesLike> = {
+    caveatGroups: CaveatStruct<TBytesLike>[][];
+};
+type LogicalOrWrapperArgs<TBytesLike extends BytesLike = BytesLike> = {
+    groupIndex: bigint;
+    caveatArgs: TBytesLike[];
+};
+declare function createLogicalOrWrapperTerms(terms: LogicalOrWrapperTerms, encodingOptions?: EncodingOptions<'hex'>): Hex;
+declare function createLogicalOrWrapperTerms(terms: LogicalOrWrapperTerms, encodingOptions: EncodingOptions<'bytes'>): Uint8Array;
+declare function decodeLogicalOrWrapperTerms(terms: BytesLike, encodingOptions?: EncodingOptions<'hex'>): LogicalOrWrapperTerms<DecodedBytesLike<'hex'>>;
+declare function decodeLogicalOrWrapperTerms(terms: BytesLike, encodingOptions: EncodingOptions<'bytes'>): LogicalOrWrapperTerms<DecodedBytesLike<'bytes'>>;
+declare function createLogicalOrWrapperArgs(args: LogicalOrWrapperArgs, encodingOptions?: EncodingOptions<'hex'>): Hex;
+declare function createLogicalOrWrapperArgs(args: LogicalOrWrapperArgs, encodingOptions: EncodingOptions<'bytes'>): Uint8Array;
+declare function decodeLogicalOrWrapperArgs(args: BytesLike, encodingOptions?: EncodingOptions<'hex'>): LogicalOrWrapperArgs<DecodedBytesLike<'hex'>>;
+declare function decodeLogicalOrWrapperArgs(args: BytesLike, encodingOptions: EncodingOptions<'bytes'>): LogicalOrWrapperArgs<DecodedBytesLike<'bytes'>>;
+
 declare const ANY_BENEFICIARY: "0x0000000000000000000000000000000000000a11";
 declare const ROOT_AUTHORITY: "0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff";
 declare const DELEGATION_TYPEHASH: "0x88c1d2ecf185adf710588203a5f263f0ff61be0d33da39792cde19ba9aa4331e";
@@ -331,4 +352,4 @@ declare function decodeDelegation(encoded: BytesLike, options: EncodingOptions<'
 declare function hashDelegation(delegation: DelegationStruct, options?: EncodingOptions<'hex'>): Hex;
 declare function hashDelegation(delegation: DelegationStruct, options: EncodingOptions<'bytes'>): Uint8Array;
 
-export { ANY_BENEFICIARY, CAVEAT_TYPEHASH, type CaveatStruct as Caveat, DELEGATION_TYPEHASH, type DelegationStruct as Delegation, ROOT_AUTHORITY, createAllowedCalldataTerms, createAllowedMethodsTerms, createAllowedTargetsTerms, createArgsEqualityCheckTerms, createBlockNumberTerms, createDeployedTerms, createERC1155BalanceChangeTerms, createERC20BalanceChangeTerms, createERC20StreamingTerms, createERC20TokenPeriodTransferTerms, createERC20TransferAmountTerms, createERC721BalanceChangeTerms, createERC721TransferTerms, createExactCalldataBatchTerms, createExactCalldataTerms, createExactExecutionBatchTerms, createExactExecutionTerms, createIdTerms, createLimitedCallsTerms, createMultiTokenPeriodTerms, createNativeBalanceChangeTerms, createNativeTokenPaymentTerms, createNativeTokenPeriodTransferTerms, createNativeTokenStreamingTerms, createNativeTokenTransferAmountTerms, createNonceTerms, createOwnershipTransferTerms, createRedeemerTerms, createSpecificActionERC20TransferBatchTerms, createTimestampTerms, createValueLteTerms, decodeAllowedCalldataTerms, decodeAllowedMethodsTerms, decodeAllowedTargetsTerms, decodeArgsEqualityCheckTerms, decodeBlockNumberTerms, decodeDelegation, decodeDelegations, decodeDeployedTerms, decodeERC1155BalanceChangeTerms, decodeERC20BalanceChangeTerms, decodeERC20StreamingTerms, decodeERC20TokenPeriodTransferTerms, decodeERC20TransferAmountTerms, decodeERC721BalanceChangeTerms, decodeERC721TransferTerms, decodeExactCalldataBatchTerms, decodeExactCalldataTerms, decodeExactExecutionBatchTerms, decodeExactExecutionTerms, decodeIdTerms, decodeLimitedCallsTerms, decodeMultiTokenPeriodTerms, decodeNativeBalanceChangeTerms, decodeNativeTokenPaymentTerms, decodeNativeTokenPeriodTransferTerms, decodeNativeTokenStreamingTerms, decodeNativeTokenTransferAmountTerms, decodeNonceTerms, decodeOwnershipTransferTerms, decodeRedeemerTerms, decodeSpecificActionERC20TransferBatchTerms, decodeTimestampTerms, decodeValueLteTerms, encodeDelegation, encodeDelegations, hashDelegation };
+export { ANY_BENEFICIARY, BalanceChangeType, CAVEAT_TYPEHASH, type CaveatStruct as Caveat, DELEGATION_TYPEHASH, type DelegationStruct as Delegation, ROOT_AUTHORITY, createAllowedCalldataTerms, createAllowedMethodsTerms, createAllowedTargetsTerms, createArgsEqualityCheckTerms, createBlockNumberTerms, createDeployedTerms, createERC1155BalanceChangeTerms, createERC20BalanceChangeTerms, createERC20StreamingTerms, createERC20TokenPeriodTransferTerms, createERC20TransferAmountTerms, createERC721BalanceChangeTerms, createERC721TransferTerms, createExactCalldataBatchTerms, createExactCalldataTerms, createExactExecutionBatchTerms, createExactExecutionTerms, createIdTerms, createLimitedCallsTerms, createLogicalOrWrapperArgs, createLogicalOrWrapperTerms, createMultiTokenPeriodTerms, createNativeBalanceChangeTerms, createNativeTokenPaymentTerms, createNativeTokenPeriodTransferTerms, createNativeTokenStreamingTerms, createNativeTokenTransferAmountTerms, createNonceTerms, createOwnershipTransferTerms, createRedeemerTerms, createSpecificActionERC20TransferBatchTerms, createTimestampTerms, createValueLteTerms, decodeAllowedCalldataTerms, decodeAllowedMethodsTerms, decodeAllowedTargetsTerms, decodeArgsEqualityCheckTerms, decodeBlockNumberTerms, decodeDelegation, decodeDelegations, decodeDeployedTerms, decodeERC1155BalanceChangeTerms, decodeERC20BalanceChangeTerms, decodeERC20StreamingTerms, decodeERC20TokenPeriodTransferTerms, decodeERC20TransferAmountTerms, decodeERC721BalanceChangeTerms, decodeERC721TransferTerms, decodeExactCalldataBatchTerms, decodeExactCalldataTerms, decodeExactExecutionBatchTerms, decodeExactExecutionTerms, decodeIdTerms, decodeLimitedCallsTerms, decodeLogicalOrWrapperArgs, decodeLogicalOrWrapperTerms, decodeMultiTokenPeriodTerms, decodeNativeBalanceChangeTerms, decodeNativeTokenPaymentTerms, decodeNativeTokenPeriodTransferTerms, decodeNativeTokenStreamingTerms, decodeNativeTokenTransferAmountTerms, decodeNonceTerms, decodeOwnershipTransferTerms, decodeRedeemerTerms, decodeSpecificActionERC20TransferBatchTerms, decodeTimestampTerms, decodeValueLteTerms, encodeDelegation, encodeDelegations, hashDelegation };

package/dist/index.mjs

@@ -1,3 +1,10 @@
+// src/caveats/types.ts
+var BalanceChangeType = /* @__PURE__ */ ((BalanceChangeType2) => {
+  BalanceChangeType2[BalanceChangeType2["Increase"] = 0] = "Increase";
+  BalanceChangeType2[BalanceChangeType2["Decrease"] = 1] = "Decrease";
+  return BalanceChangeType2;
+})(BalanceChangeType || {});
+
 // src/internalUtils.ts
 import {
   bytesToHex,
@@ -467,7 +474,7 @@ function decodeNativeTokenPaymentTerms(terms, encodingOptions = defaultOptions)
 
 // src/caveats/nativeBalanceChange.ts
 function createNativeBalanceChangeTerms(terms, encodingOptions = defaultOptions) {
-  const { recipient, balance, changeType: changeTypeNumber } = terms;
+  const { recipient, balance, changeType } = terms;
   const recipientHex = normalizeAddressLowercase(
     recipient,
     "Invalid recipient: must be a valid Address"
@@ -475,7 +482,6 @@ function createNativeBalanceChangeTerms(terms, encodingOptions = defaultOptions)
   if (balance <= 0n) {
     throw new Error("Invalid balance: must be a positive number");
   }
-  const changeType = changeTypeNumber;
   if (changeType !== 0 /* Increase */ && changeType !== 1 /* Decrease */) {
     throw new Error("Invalid changeType: must be either Increase or Decrease");
   }
@@ -653,12 +659,7 @@ function decodeERC20TransferAmountTerms(terms, encodingOptions = defaultOptions)
 
 // src/caveats/erc20BalanceChange.ts
 function createERC20BalanceChangeTerms(terms, encodingOptions = defaultOptions) {
-  const {
-    tokenAddress,
-    recipient,
-    balance,
-    changeType: changeTypeNumber
-  } = terms;
+  const { tokenAddress, recipient, balance, changeType } = terms;
   const tokenAddressHex = normalizeAddressLowercase(
     tokenAddress,
     "Invalid tokenAddress: must be a valid address"
@@ -670,7 +671,6 @@ function createERC20BalanceChangeTerms(terms, encodingOptions = defaultOptions)
   if (balance <= 0n) {
     throw new Error("Invalid balance: must be a positive number");
   }
-  const changeType = changeTypeNumber;
   if (changeType !== 0 /* Increase */ && changeType !== 1 /* Decrease */) {
     throw new Error("Invalid changeType: must be either Increase or Decrease");
   }
@@ -705,12 +705,7 @@ function decodeERC20BalanceChangeTerms(terms, encodingOptions = defaultOptions)
 
 // src/caveats/erc721BalanceChange.ts
 function createERC721BalanceChangeTerms(terms, encodingOptions = defaultOptions) {
-  const {
-    tokenAddress,
-    recipient,
-    amount,
-    changeType: changeTypeNumber
-  } = terms;
+  const { tokenAddress, recipient, amount, changeType } = terms;
   const tokenAddressHex = normalizeAddressLowercase(
     tokenAddress,
     "Invalid tokenAddress: must be a valid address"
@@ -722,7 +717,6 @@ function createERC721BalanceChangeTerms(terms, encodingOptions = defaultOptions)
   if (amount <= 0n) {
     throw new Error("Invalid balance: must be a positive number");
   }
-  const changeType = changeTypeNumber;
   if (changeType !== 0 /* Increase */ && changeType !== 1 /* Decrease */) {
     throw new Error("Invalid changeType: must be either Increase or Decrease");
   }
@@ -786,13 +780,7 @@ function decodeERC721TransferTerms(terms, encodingOptions = defaultOptions) {
 
 // src/caveats/erc1155BalanceChange.ts
 function createERC1155BalanceChangeTerms(terms, encodingOptions = defaultOptions) {
-  const {
-    tokenAddress,
-    recipient,
-    tokenId,
-    balance,
-    changeType: changeTypeNumber
-  } = terms;
+  const { tokenAddress, recipient, tokenId, balance, changeType } = terms;
   const tokenAddressHex = normalizeAddressLowercase(
     tokenAddress,
     "Invalid tokenAddress: must be a valid address"
@@ -807,7 +795,6 @@ function createERC1155BalanceChangeTerms(terms, encodingOptions = defaultOptions
   if (tokenId < 0n) {
     throw new Error("Invalid tokenId: must be a non-negative number");
   }
-  const changeType = changeTypeNumber;
   if (changeType !== 0 /* Increase */ && changeType !== 1 /* Decrease */) {
     throw new Error("Invalid changeType: must be either Increase or Decrease");
   }
@@ -1311,8 +1298,87 @@ function decodeSpecificActionERC20TransferBatchTerms(terms, encodingOptions = de
   };
 }
 
+// src/caveats/logicalOrWrapper.ts
+import { decodeSingle as decodeSingle3, encodeSingle as encodeSingle3 } from "@metamask/abi-utils";
+import { bytesToHex as bytesToHex11 } from "@metamask/utils";
+var CAVEAT_GROUPS_ABI = "((address,bytes,bytes)[])[]";
+var SELECTED_GROUP_ABI = "(uint256,bytes[])";
+function assertValidCaveatGroups(groups) {
+  if (!groups?.length) {
+    throw new Error(
+      "Invalid caveatGroups: must provide at least one caveat group"
+    );
+  }
+  for (let i = 0; i < groups.length; i++) {
+    const group = groups[i];
+    if (!group?.length) {
+      throw new Error(
+        `Invalid caveatGroups: group at index ${i} must contain at least one caveat`
+      );
+    }
+  }
+}
+function normalizeCaveatTuple(caveat) {
+  return [
+    normalizeAddress(
+      caveat.enforcer,
+      "Invalid enforcer: must be a valid address"
+    ),
+    normalizeHex(caveat.terms, "Invalid terms: must be a valid hex string"),
+    normalizeHex(caveat.args, "Invalid args: must be a valid hex string")
+  ];
+}
+function encodeCaveatGroupTuple(group) {
+  return [group.map(normalizeCaveatTuple)];
+}
+function createLogicalOrWrapperTerms(terms, encodingOptions = defaultOptions) {
+  assertValidCaveatGroups(terms.caveatGroups);
+  const encodableGroups = terms.caveatGroups.map(encodeCaveatGroupTuple);
+  const hexValue = encodeSingle3(CAVEAT_GROUPS_ABI, encodableGroups);
+  return prepareResult(hexValue, encodingOptions);
+}
+function decodeLogicalOrWrapperTerms(terms, encodingOptions = defaultOptions) {
+  const hexTerms = bytesLikeToHex(terms);
+  const decoded = decodeSingle3(
+    CAVEAT_GROUPS_ABI,
+    hexTerms
+  );
+  const caveatGroups = decoded.map(
+    ([caveats]) => caveats.map(([enforcer, caveatTerms, args]) => ({
+      enforcer: prepareResult(enforcer, encodingOptions),
+      terms: prepareResult(bytesToHex11(caveatTerms), encodingOptions),
+      args: prepareResult(bytesToHex11(args), encodingOptions)
+    }))
+  );
+  return { caveatGroups };
+}
+function createLogicalOrWrapperArgs(args, encodingOptions = defaultOptions) {
+  if (args.groupIndex < 0n) {
+    throw new Error("Invalid groupIndex: must be a non-negative number");
+  }
+  const caveatArgsHex = args.caveatArgs.map(
+    (arg) => normalizeHex(arg, "Invalid caveatArgs: must be valid hex strings")
+  );
+  const hexValue = encodeSingle3(SELECTED_GROUP_ABI, [
+    args.groupIndex,
+    caveatArgsHex
+  ]);
+  return prepareResult(hexValue, encodingOptions);
+}
+function decodeLogicalOrWrapperArgs(args, encodingOptions = defaultOptions) {
+  const hexArgs = bytesLikeToHex(args);
+  const [groupIndex, caveatArgsRaw] = decodeSingle3(
+    SELECTED_GROUP_ABI,
+    hexArgs
+  );
+  const caveatArgs = caveatArgsRaw.map(
+    (arg) => prepareResult(bytesToHex11(arg), encodingOptions)
+  );
+  return { groupIndex, caveatArgs };
+}
+
 // src/delegation.ts
-import { encode, encodeSingle as encodeSingle3, decodeSingle as decodeSingle3 } from "@metamask/abi-utils";
+import { encode, encodeSingle as encodeSingle4, decodeSingle as decodeSingle4 } from "@metamask/abi-utils";
 import { hexToBytes as hexToBytes3 } from "@metamask/utils";
 import { keccak_256 as keccak256 } from "@noble/hashes/sha3";
 var ANY_BENEFICIARY = "0x0000000000000000000000000000000000000a11";
@@ -1339,7 +1405,7 @@ function encodeDelegations(delegations, options = defaultOptions) {
       struct.salt,
       struct.signature
     ]);
-    result = encodeSingle3(DELEGATION_ARRAY_ABI_TYPES, encodableStructs);
+    result = encodeSingle4(DELEGATION_ARRAY_ABI_TYPES, encodableStructs);
   }
   return prepareResult(result, options);
 }
@@ -1356,7 +1422,7 @@ function encodeDelegation(delegation, options = defaultOptions) {
     delegation.salt,
     delegation.signature
   ];
-  const result = encodeSingle3(DELEGATION_ABI_TYPE, encodableStruct);
+  const result = encodeSingle4(DELEGATION_ABI_TYPE, encodableStruct);
   return prepareResult(result, options);
 }
 var delegationFromDecodedDelegation = (decodedDelegation, convertFn) => {
@@ -1375,7 +1441,7 @@ var delegationFromDecodedDelegation = (decodedDelegation, convertFn) => {
   };
 };
 function decodeDelegations(encoded, options = defaultOptions) {
-  const decodedStructs = decodeSingle3(
+  const decodedStructs = decodeSingle4(
     DELEGATION_ARRAY_ABI_TYPES,
     encoded
     // return types cannot be inferred from complex ABI types, so we must assert the type
@@ -1390,7 +1456,7 @@ function decodeDelegations(encoded, options = defaultOptions) {
   );
 }
 function decodeDelegation(encoded, options = defaultOptions) {
-  const decodedStruct = decodeSingle3(
+  const decodedStruct = decodeSingle4(
     DELEGATION_ABI_TYPE,
     encoded
     // return types cannot be inferred from complex ABI types, so we must assert the type
@@ -1440,6 +1506,7 @@ function getCaveatHash(caveat) {
 }
 export {
   ANY_BENEFICIARY,
+  BalanceChangeType,
   CAVEAT_TYPEHASH,
   DELEGATION_TYPEHASH,
   ROOT_AUTHORITY,
@@ -1462,6 +1529,8 @@ export {
   createExactExecutionTerms,
   createIdTerms,
   createLimitedCallsTerms,
+  createLogicalOrWrapperArgs,
+  createLogicalOrWrapperTerms,
   createMultiTokenPeriodTerms,
   createNativeBalanceChangeTerms,
   createNativeTokenPaymentTerms,
@@ -1495,6 +1564,8 @@ export {
   decodeExactExecutionTerms,
   decodeIdTerms,
   decodeLimitedCallsTerms,
+  decodeLogicalOrWrapperArgs,
+  decodeLogicalOrWrapperTerms,
   decodeMultiTokenPeriodTerms,
   decodeNativeBalanceChangeTerms,
   decodeNativeTokenPaymentTerms,