@tokenops/sdk 2.0.0-alpha.1 → 2.0.0-alpha.2

package/dist/{chunk-PUX5VXDB.cjs → chunk-PZZK3O3S.cjs}

@@ -1,10 +1,10 @@
 'use strict';
 
-var chunkM4IT6DNJ_cjs = require('./chunk-M4IT6DNJ.cjs');
+var chunkAREQJHKA_cjs = require('./chunk-AREQJHKA.cjs');
 var chunkFAXIIH5R_cjs = require('./chunk-FAXIIH5R.cjs');
 var chunkUG5RKLU2_cjs = require('./chunk-UG5RKLU2.cjs');
 var chunkMVDQMV25_cjs = require('./chunk-MVDQMV25.cjs');
-var chunk5576FRT3_cjs = require('./chunk-5576FRT3.cjs');
+var chunkFT5H2Q7Y_cjs = require('./chunk-FT5H2Q7Y.cjs');
 var chunkJK4XMMKM_cjs = require('./chunk-JK4XMMKM.cjs');
 var chunk66IHPTOK_cjs = require('./chunk-66IHPTOK.cjs');
 var chunk67OV5CX2_cjs = require('./chunk-67OV5CX2.cjs');
@@ -5101,7 +5101,7 @@ var AirdropBaseClient = class {
         clientLabel: "AirdropBaseClient"
       });
     }
-    chunkM4IT6DNJ_cjs.assertSupportedChain(chainId);
+    chunkAREQJHKA_cjs.assertSupportedChain(chainId);
     this.chainId = chainId;
     this.address = chunkJK4XMMKM_cjs.normaliseAddress(config.address);
     this.aclAddress = config.aclAddress ? chunkJK4XMMKM_cjs.normaliseAddress(config.aclAddress) : chunkFAXIIH5R_cjs.requireFhevmAclAddress(chainId, "AirdropBaseClient");
@@ -5788,7 +5788,7 @@ var AirdropBaseClient = class {
       method,
       contractAddress: this.address,
       abi: this.abi,
-      productMapper: chunkM4IT6DNJ_cjs.airdropProductMapper,
+      productMapper: chunkAREQJHKA_cjs.airdropProductMapper,
       account: accountAddress(account),
       productContext: {
         creator: accountAddress(account),
@@ -5809,6 +5809,17 @@ var AirdropBaseClient = class {
     }
     return acct;
   }
+  /**
+   * The address that will actually send the transaction, as a plain `Address`.
+   *
+   * Needed by any method whose arguments must be validated against the sender before
+   * the write — on the Merkle variant the claim identity, the payout destination and
+   * the submitter are three separate addresses with rules between them.
+   */
+  resolveSender(override, method) {
+    const wallet = this.requireWallet(method);
+    return accountAddress(this.resolveAccount(wallet, override, method));
+  }
 };
 function createAirdropBaseClient(config) {
   return new AirdropBaseClient(config);
@@ -6108,7 +6119,7 @@ async function signClaimAuthorization(args) {
   return chunk66IHPTOK_cjs.asSignature(sig);
 }
 function toDeploymentModeOrdinal(mode) {
-  return chunkM4IT6DNJ_cjs.DEPLOYMENT_MODE[mode];
+  return chunkAREQJHKA_cjs.DEPLOYMENT_MODE[mode];
 }
 function toContractCommonParams(common) {
   return {
@@ -6124,7 +6135,7 @@ function toContractEcdsaParams(params) {
   return {
     common: toContractCommonParams(params.common),
     signer: params.signer,
-    dedupMode: chunkM4IT6DNJ_cjs.DEDUP_MODE[params.dedupMode]
+    dedupMode: chunkAREQJHKA_cjs.DEDUP_MODE[params.dedupMode]
   };
 }
 function toContractMerkleParams(params) {
@@ -6155,9 +6166,9 @@ var ConfidentialAirdropFactoryClient = class {
         clientLabel: "ConfidentialAirdropFactoryClient"
       });
     }
-    chunkM4IT6DNJ_cjs.assertSupportedChain(chainId);
+    chunkAREQJHKA_cjs.assertSupportedChain(chainId);
     this.chainId = chainId;
-    this.address = config.address ? chunkJK4XMMKM_cjs.normaliseAddress(config.address) : chunk5576FRT3_cjs.requireFheAirdropFactoryAddress(chainId);
+    this.address = config.address ? chunkJK4XMMKM_cjs.normaliseAddress(config.address) : chunkFT5H2Q7Y_cjs.requireFheAirdropFactoryAddress(chainId);
     this.#telemetry = config.telemetry;
     this.#telemetry?.event("fhe-airdrop.client.init", {
       surface: "factory",
@@ -6228,7 +6239,7 @@ var ConfidentialAirdropFactoryClient = class {
    * @throws {@link InvalidArgumentError} when the root is zero and `isMerkleRootMutable` is false, or the salt was already used.
    */
   async createMerkleAirdrop(args) {
-    chunkM4IT6DNJ_cjs.assertMerkleModeSupported(args.mode);
+    chunkAREQJHKA_cjs.assertMerkleModeSupported(args.mode);
     return chunkVJKZWYYJ_cjs.withTelemetry(this.#telemetry, "fhe-airdrop.factory.createMerkleAirdrop", async () => {
       const method = "createMerkleAirdrop";
       const account = this.#senderFor(args.account, method);
@@ -6320,7 +6331,7 @@ var ConfidentialAirdropFactoryClient = class {
    * @throws {@link MissingEncryptorError} when `amount` is given and no encryptor is resolvable.
    */
   async createAndFundMerkleAirdrop(args) {
-    chunkM4IT6DNJ_cjs.assertMerkleModeSupported(args.mode);
+    chunkAREQJHKA_cjs.assertMerkleModeSupported(args.mode);
     return chunkVJKZWYYJ_cjs.withTelemetry(
       this.#telemetry,
       "fhe-airdrop.factory.createAndFundMerkleAirdrop",
@@ -6893,7 +6904,7 @@ var ConfidentialAirdropFactoryClient = class {
    */
   async #guardCreate(input) {
     const { variant, args, deployer, method } = input;
-    await chunkM4IT6DNJ_cjs.assertStockWrapper({
+    await chunkAREQJHKA_cjs.assertStockWrapper({
       publicClient: this.publicClient,
       token: args.params.common.token,
       unwrappable: args.params.common.unwrappable
@@ -6906,7 +6917,7 @@ var ConfidentialAirdropFactoryClient = class {
       params: args.params,
       ...predictArgs
     });
-    await chunkM4IT6DNJ_cjs.assertSaltAvailable({
+    await chunkAREQJHKA_cjs.assertSaltAvailable({
       publicClient: this.publicClient,
       predictedAddress,
       variant,
@@ -7009,7 +7020,7 @@ var ConfidentialAirdropFactoryClient = class {
       method,
       contractAddress: this.address,
       abi: airdropFactoryAbi,
-      productMapper: chunkM4IT6DNJ_cjs.airdropProductMapper,
+      productMapper: chunkAREQJHKA_cjs.airdropProductMapper,
       account: accountAddress2(account),
       // `UpgradeabilityNotAllowed` and `ZamaProtocolUnsupported` carry no args
       // on-chain; the mapper can only name the creator and chain if we forward
@@ -7332,22 +7343,6 @@ var merkleConfidentialAirdropAbi = [
     name: "SafeERC20FailedOperation",
     type: "error"
   },
-  {
-    inputs: [
-      {
-        internalType: "bytes32",
-        name: "handle",
-        type: "bytes32"
-      },
-      {
-        internalType: "address",
-        name: "sender",
-        type: "address"
-      }
-    ],
-    name: "SenderNotAllowedToUseHandle",
-    type: "error"
-  },
   {
     inputs: [],
     name: "TokenNotAWrapper",
@@ -7374,11 +7369,32 @@ var merkleConfidentialAirdropAbi = [
     name: "UUPSUnsupportedProxiableUUID",
     type: "error"
   },
+  {
+    inputs: [
+      {
+        internalType: "address",
+        name: "account",
+        type: "address"
+      },
+      {
+        internalType: "address",
+        name: "to",
+        type: "address"
+      }
+    ],
+    name: "UnauthorizedRedirect",
+    type: "error"
+  },
   {
     inputs: [],
     name: "ZamaProtocolUnsupported",
     type: "error"
   },
+  {
+    inputs: [],
+    name: "ZeroAccount",
+    type: "error"
+  },
   {
     inputs: [],
     name: "ZeroAdminGrant",
@@ -7998,6 +8014,11 @@ var merkleConfidentialAirdropAbi = [
   },
   {
     inputs: [
+      {
+        internalType: "address",
+        name: "account",
+        type: "address"
+      },
       {
         internalType: "address",
         name: "to",
@@ -8124,6 +8145,11 @@ var merkleConfidentialAirdropAbi = [
   },
   {
     inputs: [
+      {
+        internalType: "address",
+        name: "account",
+        type: "address"
+      },
       {
         internalType: "externalEuint64",
         name: "inputAmount",
@@ -8676,8 +8702,8 @@ var MerkleAirdropClient = class extends AirdropBaseClient {
   //                          CLAIM
   // ============================================================
   /**
-   * Claim the outstanding amount for a proof-bearing entry, delivering the
-   * tokens to `to` (defaults to the sending account).
+   * Claim the outstanding amount for a proof-bearing entry, delivering the tokens to
+   * `to` — which defaults to `entry.account`, the CLAIM IDENTITY, not the sender.
    *
    * Requires `msg.value == gasFee()` exactly — handled for you; see the
    * class TSDoc.
@@ -8694,16 +8720,31 @@ var MerkleAirdropClient = class extends AirdropBaseClient {
    *
    * @throws {@link ClaimNotStartedError} before `startTime`.
    * @throws {@link ClaimWindowClosedError} after `endTime`.
-   * @throws {@link InvalidArgumentError} (`argument: "merkleProof"`) when the proof does not verify against
-   *   the current root — including when `entry.recipient` does not match the sending account.
+   * @throws {@link InvalidArgumentError} (`argument: "entry.boundTo"`) when the entry's proof is bound to
+   *   another address, or (`argument: "merkleProof"`) when the proof does not verify against the current root.
+   * @throws {@link UnauthorizedRedirectError} when a third-party submitter passes a `to` other than `entry.account`.
    * @returns The transaction hash.
    */
   async claim(args) {
     return chunkVJKZWYYJ_cjs.withTelemetry(this.telemetry, `${this.spanPrefix}.claim`, async () => {
+      const submitter = this.resolveSender(args.account, "claim");
+      chunkAREQJHKA_cjs.assertMerkleClaimIdentity({
+        method: "claim",
+        account: args.entry.account,
+        boundTo: args.entry.boundTo,
+        submitter,
+        to: args.to
+      });
       const fee = await this.gasFee();
       return this.write(
         "claim",
-        [args.to ?? viem.zeroAddress, args.entry.handle, args.entry.inputProof, args.entry.merkleProof],
+        [
+          args.entry.account,
+          args.to ?? viem.zeroAddress,
+          args.entry.handle,
+          args.entry.inputProof,
+          args.entry.merkleProof
+        ],
         args.account,
         "claim",
         fee
@@ -8719,12 +8760,29 @@ var MerkleAirdropClient = class extends AirdropBaseClient {
    * Same replay/accounting semantics and `msg.value == gasFee()` requirement
    * as {@link claim} — see its `@remarks`.
    *
+   * @remarks
+   * **Self-only by design.** This entrypoint takes no claim identity: releasing an
+   * allocation as a public ERC-20 transfer publishes the amount irreversibly, which is
+   * the recipient's own choice to make. A relayed unwrap is therefore unrepresentable
+   * rather than merely rejected, and an entry whose `account` is not the sender is
+   * refused before the write. A third party can still submit a confidential
+   * {@link claim}.
+   *
    * @returns The transaction hash. The underlying ERC-20 is released later by
    *   a separate, permissionless `finalizeUnwrap` — this hash is only the
    *   unwrap request.
    */
   async claimAndUnwrap(args) {
     return chunkVJKZWYYJ_cjs.withTelemetry(this.telemetry, `${this.spanPrefix}.claimAndUnwrap`, async () => {
+      const submitter = this.resolveSender(args.account, "claimAndUnwrap");
+      chunkAREQJHKA_cjs.assertMerkleClaimIdentity({
+        method: "claimAndUnwrap",
+        account: args.entry.account,
+        boundTo: args.entry.boundTo,
+        submitter,
+        to: args.to,
+        entrypoint: "claimAndUnwrap"
+      });
       const fee = await this.gasFee();
       return this.write(
         "claimAndUnwrap",
@@ -8740,16 +8798,32 @@ var MerkleAirdropClient = class extends AirdropBaseClient {
    * caller can decrypt. Consumes no accounting and no per-leaf state — the
    * same entry still pays the same amount after a preview. No fee.
    *
-   * An encrypted view: the contract calls `FHE.allow(outstanding, msg.sender)`,
-   * so the result is recovered from the receipt's ACL `Allowed` event, never
-   * from a simulation. See {@link AirdropBaseClient}'s class TSDoc.
+   * **Submits a transaction.** The contract calls `FHE.allow(outstanding, account)`, so
+   * the result is recovered from the receipt's ACL `Allowed` event, never from a
+   * simulation. See {@link AirdropBaseClient}'s class TSDoc.
    *
-   * @returns `{ handle, hash }` — pass `handle` to the Zama relayer's `userDecrypt`.
+   * **`entry.account` is the decryptable party, not the caller.** A relayer previewing on
+   * someone's behalf gets a valid handle it cannot read — that is the contract's intent,
+   * and it is what makes a blind relayed submission possible.
+   *
+   * @returns `{ handle, hash }` — pass `handle` to the Zama relayer's `userDecrypt`, as `entry.account`.
    */
   async getClaimAmount(args) {
+    const submitter = this.resolveSender(args.account, "getClaimAmount");
+    chunkAREQJHKA_cjs.assertMerkleClaimIdentity({
+      method: "getClaimAmount",
+      account: args.entry.account,
+      boundTo: args.entry.boundTo,
+      submitter
+    });
     return this.encryptedView({
       functionName: "getClaimAmount",
-      args: [args.entry.handle, args.entry.inputProof, args.entry.merkleProof],
+      args: [args.entry.account, args.entry.handle, args.entry.inputProof, args.entry.merkleProof],
+      // The contract grants the outstanding handle to `account`, never to the caller
+      // (`_outstandingOf(account, account, …)`), so the receipt's ACL `Allowed` event
+      // names the account. Defaulting to the sender would fail extraction on any
+      // relayed preview — after the transaction had already been mined.
+      grantee: args.entry.account,
       account: args.account
     });
   }
@@ -8772,10 +8846,15 @@ var MerkleAirdropClient = class extends AirdropBaseClient {
    *   leaves for the same recipient, claiming both pays the higher of the
    *   two totals net of this running value — `max`, not `sum`.
    *
-   * The zero handle (uninitialized ciphertext) before an account's first
-   * settled claim decrypts as zero.
+   * **An account that has never claimed returns the ZERO handle, which cannot be
+   * decrypted.** It is an uninitialized ciphertext, so nobody holds an ACL on it and
+   * the relayer rejects it with "not authorized to user decrypt handle 0x0…0" rather
+   * than answering zero. Treat `handle === zeroHash` as "nothing delivered yet" and
+   * skip the decrypt; only call `userDecrypt` on a non-zero handle. (A mock FHEVM
+   * instance does answer zero here, so this only bites against a live relayer.)
    *
-   * @returns The account's cumulative delivered total, as an encrypted handle.
+   * @returns The account's cumulative delivered total as an encrypted handle, or the
+   *   zero handle if it has never claimed.
    */
   async getClaimedAmount(account) {
     const handle = await this.read("getClaimedAmount", [account]);
@@ -8822,9 +8901,925 @@ function createMerkleAirdropClient(config) {
   return new MerkleAirdropClient(config);
 }
 
+// src/fhe-airdrop/abis/compliance.ts
+var complianceRoleManagerAbi = [
+  {
+    inputs: [],
+    stateMutability: "nonpayable",
+    type: "constructor"
+  },
+  {
+    inputs: [],
+    name: "AccessControlBadConfirmation",
+    type: "error"
+  },
+  {
+    inputs: [
+      {
+        internalType: "address",
+        name: "account",
+        type: "address"
+      },
+      {
+        internalType: "bytes32",
+        name: "neededRole",
+        type: "bytes32"
+      }
+    ],
+    name: "AccessControlUnauthorizedAccount",
+    type: "error"
+  },
+  {
+    inputs: [
+      {
+        internalType: "address",
+        name: "airdrop",
+        type: "address"
+      }
+    ],
+    name: "AirdropAndManagerAreSameAddress",
+    type: "error"
+  },
+  {
+    inputs: [],
+    name: "CannotManageComplianceDelegate",
+    type: "error"
+  },
+  {
+    inputs: [],
+    name: "DelegateAlreadyAdded",
+    type: "error"
+  },
+  {
+    inputs: [
+      {
+        internalType: "address",
+        name: "delegate",
+        type: "address"
+      }
+    ],
+    name: "DelegateAndAirdropAreSameAddress",
+    type: "error"
+  },
+  {
+    inputs: [
+      {
+        internalType: "address",
+        name: "delegate",
+        type: "address"
+      }
+    ],
+    name: "DelegateAndManagerAreSameAddress",
+    type: "error"
+  },
+  {
+    inputs: [],
+    name: "DelegateNotFound",
+    type: "error"
+  },
+  {
+    inputs: [],
+    name: "InvalidInitialization",
+    type: "error"
+  },
+  {
+    inputs: [],
+    name: "NotInitializing",
+    type: "error"
+  },
+  {
+    inputs: [],
+    name: "ZamaProtocolUnsupported",
+    type: "error"
+  },
+  {
+    inputs: [],
+    name: "ZeroAirdrop",
+    type: "error"
+  },
+  {
+    inputs: [],
+    name: "ZeroClientAdmin",
+    type: "error"
+  },
+  {
+    inputs: [],
+    name: "ZeroDelegate",
+    type: "error"
+  },
+  {
+    anonymous: false,
+    inputs: [
+      {
+        indexed: true,
+        internalType: "address",
+        name: "delegate",
+        type: "address"
+      }
+    ],
+    name: "ClientDelegateAdded",
+    type: "event"
+  },
+  {
+    anonymous: false,
+    inputs: [
+      {
+        indexed: true,
+        internalType: "address",
+        name: "delegate",
+        type: "address"
+      }
+    ],
+    name: "ClientDelegateRevoked",
+    type: "event"
+  },
+  {
+    anonymous: false,
+    inputs: [
+      {
+        indexed: true,
+        internalType: "address",
+        name: "delegate",
+        type: "address"
+      }
+    ],
+    name: "ComplianceDelegateSet",
+    type: "event"
+  },
+  {
+    anonymous: false,
+    inputs: [
+      {
+        indexed: false,
+        internalType: "uint64",
+        name: "version",
+        type: "uint64"
+      }
+    ],
+    name: "Initialized",
+    type: "event"
+  },
+  {
+    anonymous: false,
+    inputs: [
+      {
+        indexed: true,
+        internalType: "bytes32",
+        name: "role",
+        type: "bytes32"
+      },
+      {
+        indexed: true,
+        internalType: "bytes32",
+        name: "previousAdminRole",
+        type: "bytes32"
+      },
+      {
+        indexed: true,
+        internalType: "bytes32",
+        name: "newAdminRole",
+        type: "bytes32"
+      }
+    ],
+    name: "RoleAdminChanged",
+    type: "event"
+  },
+  {
+    anonymous: false,
+    inputs: [
+      {
+        indexed: true,
+        internalType: "bytes32",
+        name: "role",
+        type: "bytes32"
+      },
+      {
+        indexed: true,
+        internalType: "address",
+        name: "account",
+        type: "address"
+      },
+      {
+        indexed: true,
+        internalType: "address",
+        name: "sender",
+        type: "address"
+      }
+    ],
+    name: "RoleGranted",
+    type: "event"
+  },
+  {
+    anonymous: false,
+    inputs: [
+      {
+        indexed: true,
+        internalType: "bytes32",
+        name: "role",
+        type: "bytes32"
+      },
+      {
+        indexed: true,
+        internalType: "address",
+        name: "account",
+        type: "address"
+      },
+      {
+        indexed: true,
+        internalType: "address",
+        name: "sender",
+        type: "address"
+      }
+    ],
+    name: "RoleRevoked",
+    type: "event"
+  },
+  {
+    inputs: [],
+    name: "DEFAULT_ADMIN_ROLE",
+    outputs: [
+      {
+        internalType: "bytes32",
+        name: "",
+        type: "bytes32"
+      }
+    ],
+    stateMutability: "view",
+    type: "function"
+  },
+  {
+    inputs: [],
+    name: "DELEGATION_ADMIN_ROLE",
+    outputs: [
+      {
+        internalType: "bytes32",
+        name: "",
+        type: "bytes32"
+      }
+    ],
+    stateMutability: "view",
+    type: "function"
+  },
+  {
+    inputs: [
+      {
+        internalType: "address",
+        name: "delegate",
+        type: "address"
+      }
+    ],
+    name: "addDelegate",
+    outputs: [],
+    stateMutability: "nonpayable",
+    type: "function"
+  },
+  {
+    inputs: [],
+    name: "airdrop",
+    outputs: [
+      {
+        internalType: "address",
+        name: "",
+        type: "address"
+      }
+    ],
+    stateMutability: "view",
+    type: "function"
+  },
+  {
+    inputs: [],
+    name: "clientDelegates",
+    outputs: [
+      {
+        internalType: "address[]",
+        name: "",
+        type: "address[]"
+      }
+    ],
+    stateMutability: "view",
+    type: "function"
+  },
+  {
+    inputs: [],
+    name: "complianceDelegate",
+    outputs: [
+      {
+        internalType: "address",
+        name: "",
+        type: "address"
+      }
+    ],
+    stateMutability: "view",
+    type: "function"
+  },
+  {
+    inputs: [
+      {
+        internalType: "bytes32",
+        name: "role",
+        type: "bytes32"
+      }
+    ],
+    name: "getRoleAdmin",
+    outputs: [
+      {
+        internalType: "bytes32",
+        name: "",
+        type: "bytes32"
+      }
+    ],
+    stateMutability: "view",
+    type: "function"
+  },
+  {
+    inputs: [
+      {
+        internalType: "bytes32",
+        name: "role",
+        type: "bytes32"
+      },
+      {
+        internalType: "uint256",
+        name: "index",
+        type: "uint256"
+      }
+    ],
+    name: "getRoleMember",
+    outputs: [
+      {
+        internalType: "address",
+        name: "",
+        type: "address"
+      }
+    ],
+    stateMutability: "view",
+    type: "function"
+  },
+  {
+    inputs: [
+      {
+        internalType: "bytes32",
+        name: "role",
+        type: "bytes32"
+      }
+    ],
+    name: "getRoleMemberCount",
+    outputs: [
+      {
+        internalType: "uint256",
+        name: "",
+        type: "uint256"
+      }
+    ],
+    stateMutability: "view",
+    type: "function"
+  },
+  {
+    inputs: [
+      {
+        internalType: "bytes32",
+        name: "role",
+        type: "bytes32"
+      }
+    ],
+    name: "getRoleMembers",
+    outputs: [
+      {
+        internalType: "address[]",
+        name: "",
+        type: "address[]"
+      }
+    ],
+    stateMutability: "view",
+    type: "function"
+  },
+  {
+    inputs: [
+      {
+        internalType: "bytes32",
+        name: "role",
+        type: "bytes32"
+      },
+      {
+        internalType: "address",
+        name: "account",
+        type: "address"
+      }
+    ],
+    name: "grantRole",
+    outputs: [],
+    stateMutability: "nonpayable",
+    type: "function"
+  },
+  {
+    inputs: [
+      {
+        internalType: "bytes32",
+        name: "role",
+        type: "bytes32"
+      },
+      {
+        internalType: "address",
+        name: "account",
+        type: "address"
+      }
+    ],
+    name: "hasRole",
+    outputs: [
+      {
+        internalType: "bool",
+        name: "",
+        type: "bool"
+      }
+    ],
+    stateMutability: "view",
+    type: "function"
+  },
+  {
+    inputs: [
+      {
+        internalType: "address",
+        name: "airdrop_",
+        type: "address"
+      },
+      {
+        internalType: "address",
+        name: "clientAdmin",
+        type: "address"
+      },
+      {
+        internalType: "address",
+        name: "clientDelegate",
+        type: "address"
+      },
+      {
+        internalType: "address",
+        name: "complianceDelegate_",
+        type: "address"
+      }
+    ],
+    name: "initialize",
+    outputs: [],
+    stateMutability: "nonpayable",
+    type: "function"
+  },
+  {
+    inputs: [
+      {
+        internalType: "address",
+        name: "delegate",
+        type: "address"
+      }
+    ],
+    name: "isActiveDelegate",
+    outputs: [
+      {
+        internalType: "bool",
+        name: "",
+        type: "bool"
+      }
+    ],
+    stateMutability: "view",
+    type: "function"
+  },
+  {
+    inputs: [
+      {
+        internalType: "bytes32",
+        name: "role",
+        type: "bytes32"
+      },
+      {
+        internalType: "address",
+        name: "callerConfirmation",
+        type: "address"
+      }
+    ],
+    name: "renounceRole",
+    outputs: [],
+    stateMutability: "nonpayable",
+    type: "function"
+  },
+  {
+    inputs: [
+      {
+        internalType: "address",
+        name: "delegate",
+        type: "address"
+      }
+    ],
+    name: "revokeDelegate",
+    outputs: [],
+    stateMutability: "nonpayable",
+    type: "function"
+  },
+  {
+    inputs: [
+      {
+        internalType: "bytes32",
+        name: "role",
+        type: "bytes32"
+      },
+      {
+        internalType: "address",
+        name: "account",
+        type: "address"
+      }
+    ],
+    name: "revokeRole",
+    outputs: [],
+    stateMutability: "nonpayable",
+    type: "function"
+  },
+  {
+    inputs: [
+      {
+        internalType: "bytes4",
+        name: "interfaceId",
+        type: "bytes4"
+      }
+    ],
+    name: "supportsInterface",
+    outputs: [
+      {
+        internalType: "bool",
+        name: "",
+        type: "bool"
+      }
+    ],
+    stateMutability: "view",
+    type: "function"
+  }
+];
+
+// src/fhe-airdrop/compliance.ts
+var ACL_PROPAGATION_CODE = "DELEGATION_NOT_PROPAGATED";
+var ACL_PROPAGATION_ERROR_NAME = "DelegationNotPropagatedError";
+var ACL_PROPAGATION_STATUSES = /* @__PURE__ */ new Set([400, 500]);
+function matchesPropagationMessage(message) {
+  const lower = message.toLowerCase();
+  if (lower.includes("acl check not propagated")) return true;
+  return lower.includes("propagat") && lower.includes("gateway");
+}
+function readRecord(value) {
+  return typeof value === "object" && value !== null ? value : void 0;
+}
+function readNumber(obj, key) {
+  const value = obj?.[key];
+  return typeof value === "number" ? value : void 0;
+}
+function readString(obj, key) {
+  const value = obj?.[key];
+  return typeof value === "string" ? value : void 0;
+}
+function isAclPropagationError(error) {
+  const err = readRecord(error);
+  if (!err) return false;
+  const cause = readRecord(err["cause"]);
+  if (err["code"] === ACL_PROPAGATION_CODE || err["name"] === ACL_PROPAGATION_ERROR_NAME || cause?.["code"] === ACL_PROPAGATION_CODE || cause?.["name"] === ACL_PROPAGATION_ERROR_NAME) {
+    return true;
+  }
+  const status = readNumber(err, "status") ?? readNumber(err, "statusCode") ?? readNumber(cause, "status") ?? readNumber(cause, "statusCode");
+  if (status === void 0 || !ACL_PROPAGATION_STATUSES.has(status)) return false;
+  const errMessage = readString(err, "message");
+  const causeMessage = readString(cause, "message");
+  return errMessage !== void 0 && matchesPropagationMessage(errMessage) || causeMessage !== void 0 && matchesPropagationMessage(causeMessage);
+}
+var ComplianceManagerClient = class {
+  publicClient;
+  walletClient;
+  address;
+  chainId;
+  #telemetry;
+  constructor(config) {
+    this.publicClient = config.publicClient;
+    this.walletClient = config.walletClient;
+    const chainId = config.chainId ?? config.publicClient.chain?.id;
+    if (chainId === void 0) {
+      throw new chunk67OV5CX2_cjs.DeploymentAddressUnavailableError({
+        reason: "chain-id-missing",
+        product: "fheAirdrop",
+        contract: "complianceManager",
+        clientLabel: "ComplianceManagerClient"
+      });
+    }
+    chunkAREQJHKA_cjs.assertSupportedChain(chainId);
+    this.chainId = chainId;
+    this.address = chunkJK4XMMKM_cjs.normaliseAddress(config.address);
+    this.#telemetry = config.telemetry;
+    this.#telemetry?.event("fhe-airdrop.client.init", {
+      surface: "compliance",
+      chainId,
+      hasWallet: !!this.walletClient,
+      sdkVersion: chunkUG5RKLU2_cjs.SDK_VERSION
+    });
+  }
+  // ============================================================
+  //                    CLIENT DELEGATION MGMT
+  // ============================================================
+  /**
+   * Add a client delegate: grants `delegate` permanent (never-expiring)
+   * user-decryption delegation over this clone's airdrop. Requires
+   * {@link DELEGATION_ADMIN_ROLE}.
+   *
+   * Effective on-chain immediately; see the class TSDoc for the gateway
+   * propagation lag before `delegatedUserDecrypt` catches up.
+   *
+   * @throws {@link InvalidArgumentError} (`argument: "delegate"`) when `delegate` is the zero address
+   *   (`ZeroDelegate`), already an active client delegate (`DelegateAlreadyAdded`), or targets the
+   *   irrevocable platform compliance delegate (`CannotManageComplianceDelegate`).
+   * @returns The transaction hash.
+   */
+  async addDelegate(args) {
+    return chunkVJKZWYYJ_cjs.withTelemetry(
+      this.#telemetry,
+      "fhe-airdrop.compliance.addDelegate",
+      () => this.#write("addDelegate", [args.delegate], args.account, "addDelegate")
+    );
+  }
+  /**
+   * Revoke a client delegate. Requires {@link DELEGATION_ADMIN_ROLE}.
+   *
+   * Effective on-chain immediately — but off-chain, gateway-served
+   * `delegatedUserDecrypt` calls stop succeeding only once the gateway
+   * observes the revocation, which is not instantaneous either. Cannot target
+   * the platform compliance delegate, which is irrevocable by construction.
+   *
+   * **Not in the same block as {@link addDelegate} for the same delegate.**
+   * The FHEVM ACL rejects an add and a revoke of one delegate within a single
+   * block (`AlreadyDelegatedOrRevokedInSameBlock`), and because that revert
+   * comes from the ACL rather than from this contract, it surfaces as an
+   * opaque {@link ContractRevertError} with no decodable selector — nothing
+   * names the delegate or the cause. Batching an add and a revoke into one
+   * multicall, or sending both inside one block, is the way to hit it; wait a
+   * block between them. This is the sequencing counterpart to the propagation
+   * gotcha on the class TSDoc: that one is the gateway lagging the chain, this
+   * one is the chain refusing two conflicting writes at the same height.
+   *
+   * @throws {@link InvalidArgumentError} (`argument: "delegate"`) when `delegate` is the zero address
+   *   (`ZeroDelegate`), not currently an active client delegate (`DelegateNotFound`), or targets the
+   *   irrevocable platform compliance delegate (`CannotManageComplianceDelegate`).
+   * @returns The transaction hash.
+   */
+  async revokeDelegate(args) {
+    return chunkVJKZWYYJ_cjs.withTelemetry(
+      this.#telemetry,
+      "fhe-airdrop.compliance.revokeDelegate",
+      () => this.#write("revokeDelegate", [args.delegate], args.account, "revokeDelegate")
+    );
+  }
+  // ============================================================
+  //                            READS
+  // ============================================================
+  /** The one airdrop instance this clone serves — set once, at `initialize`. */
+  async airdrop() {
+    return this.#read("airdrop");
+  }
+  /**
+   * The platform compliance delegate.
+   *
+   * @returns The delegate address, or the zero address when this clone was
+   *   created with the platform compliance policy OFF. Because `initialize`
+   *   always runs atomically before this client can reach the clone (see the
+   *   class TSDoc), a zero return never means "not wired yet" — there is no
+   *   such observable state on this contract. It unambiguously means "no
+   *   platform delegate for this airdrop."
+   */
+  async complianceDelegate() {
+    return this.#read("complianceDelegate");
+  }
+  /** The current set of active client delegates (excludes the platform compliance delegate, if any). */
+  async clientDelegates() {
+    return this.#read("clientDelegates");
+  }
+  /**
+   * Authoritative active-delegate check for `delegate` — reads the ACL
+   * expiration date directly rather than the contract's `EnumerableSet`
+   * mirror, so it reflects the platform compliance delegate too (which never
+   * appears in {@link clientDelegates}).
+   *
+   * On-chain truth only: a `true` result means the delegation is live in the
+   * ACL, not that the gateway has caught up with it yet — see the class
+   * TSDoc's propagation note.
+   */
+  async isActiveDelegate(delegate) {
+    return this.#read("isActiveDelegate", [delegate]);
+  }
+  // Role-constant getters are named for the contract function they read, the
+  // same convention every other client in this module follows: one spelling
+  // per role, whichever client you happen to be holding.
+  /** Gates {@link addDelegate} / {@link revokeDelegate}. */
+  async DELEGATION_ADMIN_ROLE() {
+    return this.#read("DELEGATION_ADMIN_ROLE");
+  }
+  /**
+   * OpenZeppelin's root role (`bytes32(0)`), read from the clone rather than
+   * hard-coded. It administers {@link DELEGATION_ADMIN_ROLE}.
+   */
+  async DEFAULT_ADMIN_ROLE() {
+    return this.#read("DEFAULT_ADMIN_ROLE");
+  }
+  // ============================================================
+  //                     ROLE ADMINISTRATION
+  // ============================================================
+  //
+  // The clone is `AccessControlEnumerableUpgradeable`, so membership is
+  // enumerable as well as checkable. This surface is what makes the delegation
+  // verbs above administrable: without it, whoever the factory named at
+  // `initialize` is the only account that can ever add a delegate, and there
+  // is no way to find out who that is.
+  //
+  // Unlike an airdrop instance, this contract adds no "never empty" floor of
+  // its own - emptying `DEFAULT_ADMIN_ROLE` here permanently freezes the
+  // clone's delegate set at whatever it currently holds.
+  /**
+   * Whether `holder` holds `role`.
+   *
+   * The role subject is called `holder`, not `account`: on the writes below
+   * `account` already means "who sends this transaction", and one key cannot
+   * be both.
+   *
+   * @param args.role A `bytes32` from {@link DELEGATION_ADMIN_ROLE} or {@link DEFAULT_ADMIN_ROLE}.
+   */
+  async hasRole(args) {
+    return this.#read("hasRole", [args.role, args.holder]);
+  }
+  /** The role whose holders may {@link grantRole} and {@link revokeRole} `role`. */
+  async getRoleAdmin(role) {
+    return this.#read("getRoleAdmin", [role]);
+  }
+  /** How many accounts hold `role`. */
+  async getRoleMemberCount(role) {
+    return this.#read("getRoleMemberCount", [role]);
+  }
+  /**
+   * The `index`-th holder of `role`, in `EnumerableSet` order - which is not
+   * stable across grants and revokes. Prefer {@link getRoleMembers}.
+   */
+  async getRoleMember(args) {
+    return this.#read("getRoleMember", [args.role, args.index]);
+  }
+  /**
+   * Every account currently holding `role`.
+   *
+   * With {@link DELEGATION_ADMIN_ROLE} this answers "who may add or revoke a
+   * delegate on this clone?" - the administrative counterpart to
+   * {@link clientDelegates}, which answers "who may currently decrypt?".
+   */
+  async getRoleMembers(role) {
+    return this.#read("getRoleMembers", [role]);
+  }
+  /**
+   * Grant `role` to `holder`. Requires the role's admin role
+   * ({@link getRoleAdmin}).
+   *
+   * This is how a second operator is added to {@link DELEGATION_ADMIN_ROLE} -
+   * the delegation verbs themselves are unaffected, the grant only widens who
+   * may call them.
+   *
+   * @returns The transaction hash.
+   */
+  async grantRole(args) {
+    return chunkVJKZWYYJ_cjs.withTelemetry(
+      this.#telemetry,
+      "fhe-airdrop.compliance.grantRole",
+      () => this.#write("grantRole", [args.role, args.holder], args.account, "grantRole")
+    );
+  }
+  /**
+   * Revoke `role` from `holder`. Requires the role's admin role.
+   *
+   * Revoking a delegation admin does **not** revoke the delegations they
+   * created: an existing delegate keeps decrypting until
+   * {@link revokeDelegate} is called for it explicitly.
+   *
+   * @returns The transaction hash.
+   */
+  async revokeRole(args) {
+    return chunkVJKZWYYJ_cjs.withTelemetry(
+      this.#telemetry,
+      "fhe-airdrop.compliance.revokeRole",
+      () => this.#write("revokeRole", [args.role, args.holder], args.account, "revokeRole")
+    );
+  }
+  /**
+   * Give up `role` yourself.
+   *
+   * The contract's signature is `renounceRole(role, callerConfirmation)` and
+   * it reverts `AccessControlBadConfirmation` unless `callerConfirmation` is
+   * the sender, so this method takes no holder and fills the confirmation from
+   * the resolved sending account. Renouncing for somebody else is not a call
+   * that can succeed; use {@link revokeRole} to remove another account's role.
+   *
+   * @returns The transaction hash.
+   */
+  async renounceRole(args) {
+    const method = "renounceRole";
+    const wallet = this.#requireWallet(method);
+    const account = this.#resolveAccount(wallet, args.account, method);
+    return chunkVJKZWYYJ_cjs.withTelemetry(
+      this.#telemetry,
+      "fhe-airdrop.compliance.renounceRole",
+      () => this.#write(method, [args.role, accountAddress3(account)], account, method)
+    );
+  }
+  // ============================================================
+  //                     INTERNALS (private)
+  // ============================================================
+  async #write(functionName, args, account, method) {
+    const wallet = this.#requireWallet(method);
+    const acct = this.#resolveAccount(wallet, account, method);
+    await this.#preflightWrite(method, functionName, args, acct);
+    try {
+      return await wallet.writeContract({
+        address: this.address,
+        abi: complianceRoleManagerAbi,
+        functionName,
+        args,
+        account: acct,
+        chain: wallet.chain
+      });
+    } catch (err) {
+      throw this.#mapRevert(method, err, acct);
+    }
+  }
+  async #read(functionName, args = []) {
+    const result = await this.publicClient.readContract({
+      address: this.address,
+      abi: complianceRoleManagerAbi,
+      functionName,
+      args
+    });
+    return result;
+  }
+  /**
+   * Simulate a write purely to surface typed reverts.
+   *
+   * The simulate's return value is discarded on principle: this contract
+   * returns nothing from `addDelegate` / `revokeDelegate` anyway, but the
+   * pattern is kept identical to every other airdrop v2 client so a revert is
+   * always decoded before the user pays for it.
+   */
+  async #preflightWrite(method, functionName, args, account) {
+    try {
+      await this.publicClient.simulateContract({
+        address: this.address,
+        abi: complianceRoleManagerAbi,
+        functionName,
+        args,
+        account
+      });
+    } catch (err) {
+      if (chunkMVDQMV25_cjs.isContractRevert(err)) {
+        throw this.#mapRevert(method, err, account);
+      }
+    }
+  }
+  /**
+   * Map a viem error to the SDK's typed palette.
+   *
+   * `productContext` deliberately carries only public identifiers — the
+   * caller, the chain. Never an amount: this contract never handles amounts
+   * at all, but the convention is shared across every airdrop v2 client.
+   */
+  #mapRevert(method, err, account) {
+    return chunkMVDQMV25_cjs.mapContractRevert(err, {
+      method,
+      contractAddress: this.address,
+      abi: complianceRoleManagerAbi,
+      productMapper: chunkAREQJHKA_cjs.airdropProductMapper,
+      account: accountAddress3(account),
+      productContext: {
+        creator: accountAddress3(account),
+        chainId: this.chainId
+      }
+    });
+  }
+  #requireWallet(method) {
+    if (!this.walletClient) {
+      throw new chunk67OV5CX2_cjs.MissingWalletClientError(method);
+    }
+    return this.walletClient;
+  }
+  #resolveAccount(wallet, override, method) {
+    const acct = override ?? wallet.account;
+    if (!acct) {
+      throw new chunk67OV5CX2_cjs.MissingAccountError(method);
+    }
+    return acct;
+  }
+};
+function createComplianceManagerClient(config) {
+  return new ComplianceManagerClient(config);
+}
+function accountAddress3(account) {
+  return typeof account === "string" ? account : account.address;
+}
+
 exports.AirdropBaseClient = AirdropBaseClient;
 exports.CLAIM_TYPEHASH = CLAIM_TYPEHASH;
 exports.CLAIM_TYPES = CLAIM_TYPES;
+exports.ComplianceManagerClient = ComplianceManagerClient;
 exports.ConfidentialAirdropFactoryClient = ConfidentialAirdropFactoryClient;
 exports.EIP712_DOMAIN_NAME = EIP712_DOMAIN_NAME;
 exports.EIP712_DOMAIN_VERSION = EIP712_DOMAIN_VERSION;
@@ -8832,14 +9827,17 @@ exports.EcdsaAirdropClient = EcdsaAirdropClient;
 exports.FACTORY_ROLE_CONCENTRATION_NOTE = FACTORY_ROLE_CONCENTRATION_NOTE;
 exports.MerkleAirdropClient = MerkleAirdropClient;
 exports.airdropFactoryAbi = airdropFactoryAbi;
+exports.complianceRoleManagerAbi = complianceRoleManagerAbi;
 exports.confidentialAirdropBaseAbi = confidentialAirdropBaseAbi;
 exports.createAirdropBaseClient = createAirdropBaseClient;
+exports.createComplianceManagerClient = createComplianceManagerClient;
 exports.createConfidentialAirdropFactoryClient = createConfidentialAirdropFactoryClient;
 exports.createEcdsaAirdropClient = createEcdsaAirdropClient;
 exports.createMerkleAirdropClient = createMerkleAirdropClient;
 exports.ecdsaConfidentialAirdropAbi = ecdsaConfidentialAirdropAbi;
 exports.encryptUint64 = encryptUint64;
 exports.encryptUint64Batch = encryptUint64Batch;
+exports.isAclPropagationError = isAclPropagationError;
 exports.merkleConfidentialAirdropAbi = merkleConfidentialAirdropAbi;
 exports.resolveEncryptor = resolveEncryptor;
 exports.signClaimAuthorization = signClaimAuthorization;