@invisi-labs/protocol 1.1.7 → 1.2.0

package/dist/note.cjs

@@ -0,0 +1,3456 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/note/index.ts
+var note_exports = {};
+__export(note_exports, {
+  AGGREGATE_ROUTES: () => AGGREGATE_ROUTES,
+  TRANSACT_CAPACITIES: () => TRANSACT_CAPACITIES,
+  aggregateMemberRequestHash: () => aggregateMemberRequestHash,
+  aggregatePublicInputs: () => aggregatePublicInputs,
+  buildShieldCalldata: () => buildShieldCalldata,
+  buildTransactAggregateCalldata: () => buildTransactAggregateCalldata,
+  buildTransactCalldata: () => buildTransactCalldata,
+  encodeAggregateFundingTypedData: () => encodeAggregateFundingTypedData,
+  encodeShieldFundingTypedData: () => encodeShieldFundingTypedData,
+  encodeTransactFundingTypedData: () => encodeTransactFundingTypedData,
+  encodeTransactTypedData: () => encodeTransactTypedData,
+  normalizeTransactRequest: () => normalizeTransactRequest,
+  selectAggregateRoute: () => selectAggregateRoute,
+  selectTransactCapacity: () => selectTransactCapacity,
+  shieldFundingRequestHash: () => shieldFundingRequestHash,
+  transactFundingRequestHash: () => transactFundingRequestHash,
+  transactPublicInputs: () => transactPublicInputs,
+  validateShieldRequest: () => validateShieldRequest
+});
+module.exports = __toCommonJS(note_exports);
+
+// src/note/request.ts
+var import_ethers2 = require("ethers");
+
+// src/validation.ts
+var import_primitives = require("@invisi-labs/primitives");
+var import_ethers = require("ethers");
+var FIELD_MODULUS = 21888242871839275222246405745257275088548364400416034343698204186575808495617n;
+var ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
+var ZERO_WORD = (0, import_ethers.toBeHex)(0n, 32);
+var EMPTY_PERMIT = {
+  deadline: 0n,
+  v: 0,
+  r: ZERO_WORD,
+  s: ZERO_WORD
+};
+var EMPTY_FUNDING = {
+  payer: ZERO_ADDRESS,
+  amount: 0n,
+  sigNonce: 0n,
+  deadline: 0n,
+  signature: "0x",
+  permit: EMPTY_PERMIT
+};
+function uint(v, bits, name = "value") {
+  if (typeof v !== "bigint" && typeof v !== "number" && typeof v !== "string" || typeof v === "number" && !Number.isSafeInteger(v))
+    throw new Error(`${name} must be an integer`);
+  const n = BigInt(v);
+  if (n < 0n || n >= 1n << BigInt(bits)) throw new Error(`${name} exceeds u${bits}`);
+  return n;
+}
+function field(v, name = "field") {
+  const n = uint(v, 256, name);
+  if (n >= FIELD_MODULUS) throw new Error(`${name} is noncanonical field`);
+  return n;
+}
+var word = (v) => (0, import_ethers.toBeHex)(typeof v === "bigint" ? v : BigInt(v), 32);
+function dense(v, name) {
+  if (!Array.isArray(v)) throw new Error(`${name} must be array`);
+  for (let i = 0; i < v.length; i++)
+    if (!Object.hasOwn(v, i) || v[i] === void 0 || v[i] === null)
+      throw new Error(`${name} has missing or sparse entries`);
+  return v;
+}
+function known(v, keys, name = "params") {
+  if (!v || typeof v !== "object" || Array.isArray(v) || Object.keys(v).some((k) => !keys.includes(k)))
+    throw new Error(`${name} has unsupported fields`);
+}
+function notes(v, name) {
+  const r = dense(v, name).map((v2) => word(field(v2, name)));
+  if (r.some((v2) => BigInt(v2) === 0n) || new Set(r).size !== r.length)
+    throw new Error(`duplicate or zero ${name}`);
+  return r;
+}
+function envelope(v, length, version, maximum = length) {
+  if (!(0, import_ethers.isHexString)(v) || !/^0x(?:[a-fA-F0-9]{2})*$/.test(v) || (0, import_ethers.dataLength)(v) < length || (0, import_ethers.dataLength)(v) > maximum)
+    throw new Error(`ciphertext must be ${length} bytes`);
+  if (version !== void 0 && Number.parseInt(v.slice(2, 4), 16) !== version)
+    throw new Error("unsupported ciphertext envelope version");
+  return v;
+}
+function normalizeContext(c) {
+  return {
+    ...c,
+    chainId: uint(c.chainId, 64, "chainId"),
+    protocolAddress: (0, import_ethers.getAddress)(c.protocolAddress),
+    tokenAddress: (0, import_ethers.getAddress)(c.tokenAddress)
+  };
+}
+function checkDeadline(c, value) {
+  const n = uint(value, 64, "deadline");
+  if (c.now !== void 0 && n < uint(c.now, 64, "now")) throw new Error("deadline has expired");
+  return n;
+}
+function normalizeSources(sources, inputCount, capacity) {
+  dense(sources, "sources");
+  if (inputCount < 0 || inputCount > capacity || sources.length > inputCount || (inputCount === 0 ? sources.length !== 0 : sources.length === 0))
+    throw new Error("source count must be 1..inputCount, or empty for zero inputs");
+  let previous = 0n;
+  return sources.map((s) => {
+    known(s, ["treeId", "merkleRoot"], "source");
+    const treeId = uint(s.treeId, 64, "treeId"), merkleRoot = word(field(s.merkleRoot, "merkleRoot"));
+    if (treeId === 0n || treeId <= previous || BigInt(merkleRoot) === 0n)
+      throw new Error("sources must have positive roots and strictly ascending tree IDs");
+    previous = treeId;
+    return { treeId, merkleRoot };
+  });
+}
+var pad = (v, n) => [
+  ...v,
+  ...Array(n - v.length).fill(0n)
+];
+function normalizeOpaqueDelivery(value, options = {}) {
+  known(value, ["ciphertext", "clue"], "delivery");
+  if (options.empty) {
+    if (value.ciphertext !== "0x" || value.clue !== "0x")
+      throw new Error("absent output requires an empty delivery");
+    return { ciphertext: "0x", clue: "0x" };
+  }
+  if (options.allowEmpty && value.ciphertext === "0x" && value.clue === "0x")
+    return { ciphertext: "0x", clue: "0x" };
+  const ciphertext = envelope(value.ciphertext, 1, void 0, import_primitives.MAX_CIPHERTEXT_BYTES);
+  const clue = envelope(value.clue, 68);
+  if (clue.slice(130, 132).toLowerCase() !== "18") throw new Error("clue precision must be 24");
+  return { ciphertext, clue };
+}
+var deliveriesHash = (v) => (0, import_ethers.keccak256)(
+  import_ethers.AbiCoder.defaultAbiCoder().encode(
+    [
+      {
+        type: "tuple[]",
+        components: [
+          { name: "ciphertext", type: "bytes" },
+          { name: "clue", type: "bytes" }
+        ]
+      }
+    ].map((parameter) => import_ethers.ParamType.from(parameter)),
+    [dense(v, "deliveries")]
+  )
+);
+function normalizeFunding(input = {}) {
+  const f = { ...EMPTY_FUNDING, ...input };
+  (0, import_ethers.getAddress)(f.payer);
+  uint(f.amount, 128, "depositAmount");
+  uint(f.sigNonce, 256, "sigNonce");
+  uint(f.deadline, 256, "funding deadline");
+  if (!(0, import_ethers.isHexString)(f.signature) || !/^0x(?:[a-fA-F0-9]{2})*$/.test(f.signature))
+    throw new Error("invalid signature bytes");
+  const p = f.permit;
+  uint(p.deadline, 256);
+  uint(p.v, 8);
+  for (const v of [p.r, p.s])
+    if (!(0, import_ethers.isHexString)(v) || (0, import_ethers.dataLength)(v) !== 32) throw new Error("permit r/s must be bytes32");
+  if (f.amount === 0n !== (BigInt(f.payer) === 0n))
+    throw new Error("deposit amount and payer must both be zero or positive");
+  if (f.amount === 0n && (f.sigNonce !== 0n || f.deadline !== 0n || f.signature !== "0x" || p.deadline !== 0n || p.v !== 0 || BigInt(p.r) !== 0n || BigInt(p.s) !== 0n))
+    throw new Error("zero funding must be entirely empty");
+  return { ...f, payer: (0, import_ethers.getAddress)(f.payer) };
+}
+function validateFundingSubmission(f, caller, now) {
+  if (f.signature !== "0x" && now !== void 0 && uint(now, 64, "now") > f.deadline)
+    throw new Error("funding authorization has expired");
+  if (f.signature === "0x" && (f.sigNonce !== 0n || f.deadline !== 0n || caller !== void 0 && f.amount > 0n && (0, import_ethers.getAddress)(caller) !== f.payer))
+    throw new Error("direct funding requires payer caller and zero nonce/deadline");
+}
+var getEIP712Domain = (c) => ({
+  name: "InvisibleProtocol",
+  version: "1",
+  chainId: uint(c.chainId, 64),
+  verifyingContract: (0, import_ethers.getAddress)(c.protocolAddress)
+});
+var fundingFields = [
+  { name: "requestHash", type: "bytes32" },
+  { name: "payer", type: "address" },
+  { name: "amount", type: "uint256" },
+  { name: "sigNonce", type: "uint256" },
+  { name: "deadline", type: "uint256" }
+];
+
+// src/note/request.ts
+var TRANSACT_CAPACITIES = [
+  1,
+  2,
+  3,
+  4,
+  5,
+  6,
+  7,
+  8,
+  9,
+  10,
+  20,
+  30,
+  40,
+  50,
+  60,
+  70,
+  80,
+  90,
+  100,
+  110,
+  120,
+  130,
+  140,
+  150,
+  160,
+  170,
+  180,
+  190
+];
+function selectTransactCapacity(inputs, outputs) {
+  if (!Number.isInteger(inputs) || !Number.isInteger(outputs) || inputs < 0 || outputs < 0 || inputs + outputs < 1 || inputs === 0 && outputs < 2 || inputs + outputs > 190)
+    throw new Error("unsupported transact shape");
+  return TRANSACT_CAPACITIES.find((n) => inputs + outputs <= n);
+}
+function normalizeTransactRequest(c, p, cs, funding = {}) {
+  const ctx = normalizeContext(c);
+  if ((0, import_ethers2.getAddress)(p.token) !== ctx.tokenAddress)
+    throw new Error("request token mismatch");
+  known(p, [
+    "token",
+    "sources",
+    "nullifiers",
+    "noteCommitments",
+    "withdrawalAddress",
+    "withdrawalAmount",
+    "deadline",
+    "feeRecipient",
+    "feeAmount"
+  ]);
+  const ns = notes(p.nullifiers, "nullifiers"), os = notes(p.noteCommitments, "noteCommitments"), capacity = selectTransactCapacity(ns.length, os.length);
+  const sources = normalizeSources(p.sources, ns.length, capacity), deliveries = dense(cs, "deliveries").map(
+    (v) => normalizeOpaqueDelivery(v, { allowEmpty: true })
+  );
+  if (deliveries.length !== os.length) throw new Error("deliveries count mismatch");
+  const withdrawalAmount = uint(p.withdrawalAmount, 128, "withdrawalAmount"), withdrawalAddress = (0, import_ethers2.getAddress)(p.withdrawalAddress), f = normalizeFunding(funding);
+  const feeAmount = uint(p.feeAmount ?? 0n, 128, "feeAmount");
+  const feeRecipient = (0, import_ethers2.getAddress)(
+    p.feeRecipient ?? "0x0000000000000000000000000000000000000000"
+  );
+  if (feeAmount === 0n !== (BigInt(feeRecipient) === 0n)) throw new Error("invalid fee");
+  if (withdrawalAmount === 0n !== (BigInt(withdrawalAddress) === 0n) || os.length === 0 && withdrawalAmount === 0n)
+    throw new Error("invalid withdrawal");
+  if (ns.length === 0 && (f.amount === 0n || withdrawalAmount !== 0n))
+    throw new Error("zero inputs require positive funding and zero withdrawal");
+  return {
+    ...ctx,
+    capacity,
+    sources,
+    nullifiers: ns,
+    noteCommitments: os,
+    inputCount: ns.length,
+    outputCount: os.length,
+    sourceCount: sources.length,
+    inputTreeIds: pad(
+      sources.map((s) => s.treeId),
+      capacity
+    ),
+    merkleRoots: pad(
+      sources.map((s) => BigInt(s.merkleRoot)),
+      capacity
+    ),
+    slotValues: pad([...ns, ...os].map(BigInt), capacity),
+    deliveries,
+    deliveriesHash: deliveriesHash(deliveries),
+    withdrawalAddress,
+    withdrawalAmount,
+    feeRecipient,
+    feeAmount,
+    deadline: checkDeadline(c, p.deadline),
+    depositAmount: f.amount,
+    depositPayer: f.payer,
+    funding: f
+  };
+}
+function transactPublicInputs(c, p, cs, f = {}) {
+  const r = normalizeTransactRequest(c, p, cs, f), h = BigInt(r.deliveriesHash);
+  return [
+    r.chainId,
+    BigInt(r.protocolAddress),
+    BigInt(r.tokenAddress),
+    BigInt(r.inputCount),
+    BigInt(r.outputCount),
+    BigInt(r.sourceCount),
+    ...r.inputTreeIds,
+    ...r.merkleRoots,
+    ...r.slotValues,
+    h >> 128n,
+    h & (1n << 128n) - 1n,
+    BigInt(r.withdrawalAddress),
+    r.withdrawalAmount,
+    r.deadline,
+    r.depositAmount,
+    BigInt(r.depositPayer),
+    BigInt(r.feeRecipient),
+    r.feeAmount
+  ].map(word);
+}
+
+// src/note/calldata.ts
+var import_ethers3 = require("ethers");
+
+// src/contracts/abis/InvisiProtocol.ts
+var invisiProtocolAbi = [
+  {
+    "type": "constructor",
+    "inputs": [
+      {
+        "name": "params",
+        "type": "tuple",
+        "internalType": "struct InstanceParams",
+        "components": [
+          {
+            "name": "factory",
+            "type": "address",
+            "internalType": "address"
+          },
+          {
+            "name": "initialOwner",
+            "type": "address",
+            "internalType": "address"
+          },
+          {
+            "name": "globalEmergency",
+            "type": "address",
+            "internalType": "address"
+          },
+          {
+            "name": "emergencyAdmin",
+            "type": "address",
+            "internalType": "address"
+          },
+          {
+            "name": "verifierRouter",
+            "type": "address",
+            "internalType": "contract IVerifierRouter"
+          }
+        ]
+      },
+      {
+        "name": "_screener",
+        "type": "address",
+        "internalType": "address"
+      },
+      {
+        "name": "_addressRegistry",
+        "type": "address",
+        "internalType": "address"
+      }
+    ],
+    "stateMutability": "nonpayable"
+  },
+  {
+    "type": "function",
+    "name": "CHAIN_ID",
+    "inputs": [],
+    "outputs": [
+      {
+        "name": "",
+        "type": "uint256",
+        "internalType": "uint256"
+      }
+    ],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "FUND_SHIELD_TYPEHASH",
+    "inputs": [],
+    "outputs": [
+      {
+        "name": "",
+        "type": "bytes32",
+        "internalType": "bytes32"
+      }
+    ],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "FUND_TRANSACT_TYPEHASH",
+    "inputs": [],
+    "outputs": [
+      {
+        "name": "",
+        "type": "bytes32",
+        "internalType": "bytes32"
+      }
+    ],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "VERSION",
+    "inputs": [],
+    "outputs": [
+      {
+        "name": "",
+        "type": "uint256",
+        "internalType": "uint256"
+      }
+    ],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "acceptOwnership",
+    "inputs": [],
+    "outputs": [],
+    "stateMutability": "nonpayable"
+  },
+  {
+    "type": "function",
+    "name": "activeNoteTreeId",
+    "inputs": [],
+    "outputs": [
+      {
+        "name": "",
+        "type": "uint256",
+        "internalType": "uint256"
+      }
+    ],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "addressRegistry",
+    "inputs": [],
+    "outputs": [
+      {
+        "name": "",
+        "type": "address",
+        "internalType": "contract IAddressRegistry"
+      }
+    ],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "broadcasterFeeBalance",
+    "inputs": [
+      {
+        "name": "token",
+        "type": "address",
+        "internalType": "address"
+      },
+      {
+        "name": "recipient",
+        "type": "address",
+        "internalType": "address"
+      }
+    ],
+    "outputs": [
+      {
+        "name": "",
+        "type": "uint256",
+        "internalType": "uint256"
+      }
+    ],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "circuitPaused",
+    "inputs": [],
+    "outputs": [
+      {
+        "name": "",
+        "type": "bool",
+        "internalType": "bool"
+      }
+    ],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "createCredit",
+    "inputs": [
+      {
+        "name": "",
+        "type": "bytes",
+        "internalType": "bytes"
+      },
+      {
+        "name": "p",
+        "type": "tuple",
+        "internalType": "struct IInvisiProtocol.CreateCreditParams",
+        "components": [
+          {
+            "name": "token",
+            "type": "address",
+            "internalType": "address"
+          },
+          {
+            "name": "owner",
+            "type": "address",
+            "internalType": "address"
+          },
+          {
+            "name": "revocationShard",
+            "type": "uint64",
+            "internalType": "uint64"
+          },
+          {
+            "name": "revocationSlot",
+            "type": "uint16",
+            "internalType": "uint16"
+          },
+          {
+            "name": "creditCommitment",
+            "type": "bytes32",
+            "internalType": "bytes32"
+          },
+          {
+            "name": "deadline",
+            "type": "uint256",
+            "internalType": "uint256"
+          },
+          {
+            "name": "feeRecipient",
+            "type": "address",
+            "internalType": "address"
+          },
+          {
+            "name": "feeAmount",
+            "type": "uint256",
+            "internalType": "uint256"
+          }
+        ]
+      },
+      {
+        "name": "",
+        "type": "tuple[]",
+        "internalType": "struct IInvisiProtocol.Delivery[]",
+        "components": [
+          {
+            "name": "ciphertext",
+            "type": "bytes",
+            "internalType": "bytes"
+          },
+          {
+            "name": "clue",
+            "type": "bytes",
+            "internalType": "bytes"
+          }
+        ]
+      }
+    ],
+    "outputs": [],
+    "stateMutability": "nonpayable"
+  },
+  {
+    "type": "function",
+    "name": "creditAllocation",
+    "inputs": [
+      {
+        "name": "owner",
+        "type": "address",
+        "internalType": "address"
+      },
+      {
+        "name": "token",
+        "type": "address",
+        "internalType": "address"
+      }
+    ],
+    "outputs": [
+      {
+        "name": "shard",
+        "type": "uint64",
+        "internalType": "uint64"
+      },
+      {
+        "name": "slot",
+        "type": "uint16",
+        "internalType": "uint16"
+      }
+    ],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "creditDraw",
+    "inputs": [
+      {
+        "name": "",
+        "type": "bytes",
+        "internalType": "bytes"
+      },
+      {
+        "name": "p",
+        "type": "tuple",
+        "internalType": "struct IInvisiProtocol.CreditDrawParams",
+        "components": [
+          {
+            "name": "token",
+            "type": "address",
+            "internalType": "address"
+          },
+          {
+            "name": "sources",
+            "type": "tuple[]",
+            "internalType": "struct IInvisiProtocol.InputSource[]",
+            "components": [
+              {
+                "name": "treeId",
+                "type": "uint256",
+                "internalType": "uint256"
+              },
+              {
+                "name": "merkleRoot",
+                "type": "bytes32",
+                "internalType": "bytes32"
+              }
+            ]
+          },
+          {
+            "name": "payers",
+            "type": "tuple[]",
+            "internalType": "struct IInvisiProtocol.CreditPayer[]",
+            "components": [
+              {
+                "name": "payer",
+                "type": "address",
+                "internalType": "address"
+              },
+              {
+                "name": "amount",
+                "type": "uint256",
+                "internalType": "uint256"
+              }
+            ]
+          },
+          {
+            "name": "grantRefs",
+            "type": "tuple[]",
+            "internalType": "struct IInvisiProtocol.CreditGrantRef[]",
+            "components": [
+              {
+                "name": "payerIndex",
+                "type": "uint256",
+                "internalType": "uint256"
+              },
+              {
+                "name": "shard",
+                "type": "uint64",
+                "internalType": "uint64"
+              },
+              {
+                "name": "slot",
+                "type": "uint16",
+                "internalType": "uint16"
+              }
+            ]
+          },
+          {
+            "name": "nullifiers",
+            "type": "bytes32[]",
+            "internalType": "bytes32[]"
+          },
+          {
+            "name": "creditCommitments",
+            "type": "bytes32[]",
+            "internalType": "bytes32[]"
+          },
+          {
+            "name": "recoveryAmounts",
+            "type": "bytes32[]",
+            "internalType": "bytes32[]"
+          },
+          {
+            "name": "noteCommitment",
+            "type": "bytes32",
+            "internalType": "bytes32"
+          },
+          {
+            "name": "totalAmount",
+            "type": "uint256",
+            "internalType": "uint256"
+          },
+          {
+            "name": "deadline",
+            "type": "uint256",
+            "internalType": "uint256"
+          },
+          {
+            "name": "feeRecipient",
+            "type": "address",
+            "internalType": "address"
+          },
+          {
+            "name": "feeAmount",
+            "type": "uint256",
+            "internalType": "uint256"
+          }
+        ]
+      },
+      {
+        "name": "",
+        "type": "tuple[]",
+        "internalType": "struct IInvisiProtocol.Delivery[]",
+        "components": [
+          {
+            "name": "ciphertext",
+            "type": "bytes",
+            "internalType": "bytes"
+          },
+          {
+            "name": "clue",
+            "type": "bytes",
+            "internalType": "bytes"
+          }
+        ]
+      }
+    ],
+    "outputs": [],
+    "stateMutability": "nonpayable"
+  },
+  {
+    "type": "function",
+    "name": "creditRevocationBitmap",
+    "inputs": [
+      {
+        "name": "owner",
+        "type": "address",
+        "internalType": "address"
+      },
+      {
+        "name": "token",
+        "type": "address",
+        "internalType": "address"
+      },
+      {
+        "name": "shard",
+        "type": "uint64",
+        "internalType": "uint64"
+      },
+      {
+        "name": "word",
+        "type": "uint8",
+        "internalType": "uint8"
+      }
+    ],
+    "outputs": [
+      {
+        "name": "",
+        "type": "uint256",
+        "internalType": "uint256"
+      }
+    ],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "eip712Domain",
+    "inputs": [],
+    "outputs": [
+      {
+        "name": "fields",
+        "type": "bytes1",
+        "internalType": "bytes1"
+      },
+      {
+        "name": "name",
+        "type": "string",
+        "internalType": "string"
+      },
+      {
+        "name": "version",
+        "type": "string",
+        "internalType": "string"
+      },
+      {
+        "name": "chainId",
+        "type": "uint256",
+        "internalType": "uint256"
+      },
+      {
+        "name": "verifyingContract",
+        "type": "address",
+        "internalType": "address"
+      },
+      {
+        "name": "salt",
+        "type": "bytes32",
+        "internalType": "bytes32"
+      },
+      {
+        "name": "extensions",
+        "type": "uint256[]",
+        "internalType": "uint256[]"
+      }
+    ],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "emergencyAdmin",
+    "inputs": [],
+    "outputs": [
+      {
+        "name": "",
+        "type": "address",
+        "internalType": "address"
+      }
+    ],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "factory",
+    "inputs": [],
+    "outputs": [
+      {
+        "name": "",
+        "type": "address",
+        "internalType": "address"
+      }
+    ],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "getNoteTreeNextLeafIndex",
+    "inputs": [
+      {
+        "name": "treeId",
+        "type": "uint256",
+        "internalType": "uint256"
+      }
+    ],
+    "outputs": [
+      {
+        "name": "",
+        "type": "uint32",
+        "internalType": "uint32"
+      }
+    ],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "getNoteTreeRoot",
+    "inputs": [
+      {
+        "name": "treeId",
+        "type": "uint256",
+        "internalType": "uint256"
+      }
+    ],
+    "outputs": [
+      {
+        "name": "",
+        "type": "bytes32",
+        "internalType": "bytes32"
+      }
+    ],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "getTreeCount",
+    "inputs": [],
+    "outputs": [
+      {
+        "name": "count",
+        "type": "uint256",
+        "internalType": "uint256"
+      }
+    ],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "globalEmergency",
+    "inputs": [],
+    "outputs": [
+      {
+        "name": "",
+        "type": "address",
+        "internalType": "address"
+      }
+    ],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "invalidateNonce",
+    "inputs": [],
+    "outputs": [],
+    "stateMutability": "nonpayable"
+  },
+  {
+    "type": "function",
+    "name": "isCommitmentRegistered",
+    "inputs": [
+      {
+        "name": "commitment",
+        "type": "bytes32",
+        "internalType": "bytes32"
+      }
+    ],
+    "outputs": [
+      {
+        "name": "",
+        "type": "bool",
+        "internalType": "bool"
+      }
+    ],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "isNullifierSpent",
+    "inputs": [
+      {
+        "name": "nullifier",
+        "type": "bytes32",
+        "internalType": "bytes32"
+      }
+    ],
+    "outputs": [
+      {
+        "name": "",
+        "type": "bool",
+        "internalType": "bool"
+      }
+    ],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "isTreeFull",
+    "inputs": [
+      {
+        "name": "treeId",
+        "type": "uint256",
+        "internalType": "uint256"
+      }
+    ],
+    "outputs": [
+      {
+        "name": "",
+        "type": "bool",
+        "internalType": "bool"
+      }
+    ],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "nonces",
+    "inputs": [
+      {
+        "name": "",
+        "type": "address",
+        "internalType": "address"
+      }
+    ],
+    "outputs": [
+      {
+        "name": "",
+        "type": "uint256",
+        "internalType": "uint256"
+      }
+    ],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "owner",
+    "inputs": [],
+    "outputs": [
+      {
+        "name": "",
+        "type": "address",
+        "internalType": "address"
+      }
+    ],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "pause",
+    "inputs": [],
+    "outputs": [],
+    "stateMutability": "nonpayable"
+  },
+  {
+    "type": "function",
+    "name": "pauseCircuit",
+    "inputs": [],
+    "outputs": [],
+    "stateMutability": "nonpayable"
+  },
+  {
+    "type": "function",
+    "name": "paused",
+    "inputs": [],
+    "outputs": [
+      {
+        "name": "",
+        "type": "bool",
+        "internalType": "bool"
+      }
+    ],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "pendingOwner",
+    "inputs": [],
+    "outputs": [
+      {
+        "name": "",
+        "type": "address",
+        "internalType": "address"
+      }
+    ],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "renounceOwnership",
+    "inputs": [],
+    "outputs": [],
+    "stateMutability": "nonpayable"
+  },
+  {
+    "type": "function",
+    "name": "revokeCredit",
+    "inputs": [
+      {
+        "name": "token",
+        "type": "address",
+        "internalType": "address"
+      },
+      {
+        "name": "owner",
+        "type": "address",
+        "internalType": "address"
+      },
+      {
+        "name": "shard",
+        "type": "uint64",
+        "internalType": "uint64"
+      },
+      {
+        "name": "slot",
+        "type": "uint16",
+        "internalType": "uint16"
+      },
+      {
+        "name": "deadline",
+        "type": "uint256",
+        "internalType": "uint256"
+      },
+      {
+        "name": "feeRecipient",
+        "type": "address",
+        "internalType": "address"
+      },
+      {
+        "name": "feeAmount",
+        "type": "uint256",
+        "internalType": "uint256"
+      },
+      {
+        "name": "signature",
+        "type": "bytes",
+        "internalType": "bytes"
+      }
+    ],
+    "outputs": [],
+    "stateMutability": "nonpayable"
+  },
+  {
+    "type": "function",
+    "name": "rootHistory",
+    "inputs": [
+      {
+        "name": "",
+        "type": "uint256",
+        "internalType": "uint256"
+      },
+      {
+        "name": "",
+        "type": "bytes32",
+        "internalType": "bytes32"
+      }
+    ],
+    "outputs": [
+      {
+        "name": "",
+        "type": "bool",
+        "internalType": "bool"
+      }
+    ],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "screener",
+    "inputs": [],
+    "outputs": [
+      {
+        "name": "",
+        "type": "address",
+        "internalType": "address"
+      }
+    ],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "setScreener",
+    "inputs": [
+      {
+        "name": "newScreener",
+        "type": "address",
+        "internalType": "address"
+      }
+    ],
+    "outputs": [],
+    "stateMutability": "nonpayable"
+  },
+  {
+    "type": "function",
+    "name": "shield",
+    "inputs": [
+      {
+        "name": "p",
+        "type": "tuple",
+        "internalType": "struct IInvisiProtocol.ShieldParams",
+        "components": [
+          {
+            "name": "token",
+            "type": "address",
+            "internalType": "address"
+          },
+          {
+            "name": "noteCommitments",
+            "type": "bytes32[]",
+            "internalType": "bytes32[]"
+          },
+          {
+            "name": "deadline",
+            "type": "uint256",
+            "internalType": "uint256"
+          },
+          {
+            "name": "feeRecipient",
+            "type": "address",
+            "internalType": "address"
+          },
+          {
+            "name": "feeAmount",
+            "type": "uint256",
+            "internalType": "uint256"
+          }
+        ]
+      },
+      {
+        "name": "",
+        "type": "tuple[]",
+        "internalType": "struct IInvisiProtocol.ShieldOutput[]",
+        "components": [
+          {
+            "name": "identity",
+            "type": "bytes32",
+            "internalType": "bytes32"
+          },
+          {
+            "name": "amount",
+            "type": "uint256",
+            "internalType": "uint256"
+          }
+        ]
+      },
+      {
+        "name": "",
+        "type": "tuple[]",
+        "internalType": "struct IInvisiProtocol.Delivery[]",
+        "components": [
+          {
+            "name": "ciphertext",
+            "type": "bytes",
+            "internalType": "bytes"
+          },
+          {
+            "name": "clue",
+            "type": "bytes",
+            "internalType": "bytes"
+          }
+        ]
+      },
+      {
+        "name": "",
+        "type": "tuple",
+        "internalType": "struct IInvisiProtocol.FundingParams",
+        "components": [
+          {
+            "name": "payer",
+            "type": "address",
+            "internalType": "address"
+          },
+          {
+            "name": "amount",
+            "type": "uint256",
+            "internalType": "uint256"
+          },
+          {
+            "name": "sigNonce",
+            "type": "uint256",
+            "internalType": "uint256"
+          },
+          {
+            "name": "deadline",
+            "type": "uint256",
+            "internalType": "uint256"
+          },
+          {
+            "name": "signature",
+            "type": "bytes",
+            "internalType": "bytes"
+          },
+          {
+            "name": "permit",
+            "type": "tuple",
+            "internalType": "struct IMetaTx.TokenPermit",
+            "components": [
+              {
+                "name": "deadline",
+                "type": "uint256",
+                "internalType": "uint256"
+              },
+              {
+                "name": "v",
+                "type": "uint8",
+                "internalType": "uint8"
+              },
+              {
+                "name": "r",
+                "type": "bytes32",
+                "internalType": "bytes32"
+              },
+              {
+                "name": "s",
+                "type": "bytes32",
+                "internalType": "bytes32"
+              }
+            ]
+          }
+        ]
+      }
+    ],
+    "outputs": [],
+    "stateMutability": "nonpayable"
+  },
+  {
+    "type": "function",
+    "name": "transact",
+    "inputs": [
+      {
+        "name": "",
+        "type": "bytes",
+        "internalType": "bytes"
+      },
+      {
+        "name": "r",
+        "type": "tuple",
+        "internalType": "struct IInvisiProtocol.TransactRequest",
+        "components": [
+          {
+            "name": "params",
+            "type": "tuple",
+            "internalType": "struct IInvisiProtocol.CrossTreeTransactParams",
+            "components": [
+              {
+                "name": "token",
+                "type": "address",
+                "internalType": "address"
+              },
+              {
+                "name": "sources",
+                "type": "tuple[]",
+                "internalType": "struct IInvisiProtocol.InputSource[]",
+                "components": [
+                  {
+                    "name": "treeId",
+                    "type": "uint256",
+                    "internalType": "uint256"
+                  },
+                  {
+                    "name": "merkleRoot",
+                    "type": "bytes32",
+                    "internalType": "bytes32"
+                  }
+                ]
+              },
+              {
+                "name": "nullifiers",
+                "type": "bytes32[]",
+                "internalType": "bytes32[]"
+              },
+              {
+                "name": "noteCommitments",
+                "type": "bytes32[]",
+                "internalType": "bytes32[]"
+              },
+              {
+                "name": "withdrawalAddress",
+                "type": "address",
+                "internalType": "address"
+              },
+              {
+                "name": "withdrawalAmount",
+                "type": "uint256",
+                "internalType": "uint256"
+              },
+              {
+                "name": "deadline",
+                "type": "uint256",
+                "internalType": "uint256"
+              },
+              {
+                "name": "feeRecipient",
+                "type": "address",
+                "internalType": "address"
+              },
+              {
+                "name": "feeAmount",
+                "type": "uint256",
+                "internalType": "uint256"
+              }
+            ]
+          },
+          {
+            "name": "deliveries",
+            "type": "tuple[]",
+            "internalType": "struct IInvisiProtocol.Delivery[]",
+            "components": [
+              {
+                "name": "ciphertext",
+                "type": "bytes",
+                "internalType": "bytes"
+              },
+              {
+                "name": "clue",
+                "type": "bytes",
+                "internalType": "bytes"
+              }
+            ]
+          },
+          {
+            "name": "funding",
+            "type": "tuple",
+            "internalType": "struct IInvisiProtocol.FundingParams",
+            "components": [
+              {
+                "name": "payer",
+                "type": "address",
+                "internalType": "address"
+              },
+              {
+                "name": "amount",
+                "type": "uint256",
+                "internalType": "uint256"
+              },
+              {
+                "name": "sigNonce",
+                "type": "uint256",
+                "internalType": "uint256"
+              },
+              {
+                "name": "deadline",
+                "type": "uint256",
+                "internalType": "uint256"
+              },
+              {
+                "name": "signature",
+                "type": "bytes",
+                "internalType": "bytes"
+              },
+              {
+                "name": "permit",
+                "type": "tuple",
+                "internalType": "struct IMetaTx.TokenPermit",
+                "components": [
+                  {
+                    "name": "deadline",
+                    "type": "uint256",
+                    "internalType": "uint256"
+                  },
+                  {
+                    "name": "v",
+                    "type": "uint8",
+                    "internalType": "uint8"
+                  },
+                  {
+                    "name": "r",
+                    "type": "bytes32",
+                    "internalType": "bytes32"
+                  },
+                  {
+                    "name": "s",
+                    "type": "bytes32",
+                    "internalType": "bytes32"
+                  }
+                ]
+              }
+            ]
+          }
+        ]
+      }
+    ],
+    "outputs": [],
+    "stateMutability": "nonpayable"
+  },
+  {
+    "type": "function",
+    "name": "transact",
+    "inputs": [
+      {
+        "name": "",
+        "type": "bytes",
+        "internalType": "bytes"
+      },
+      {
+        "name": "requests",
+        "type": "tuple[]",
+        "internalType": "struct IInvisiProtocol.TransactRequest[]",
+        "components": [
+          {
+            "name": "params",
+            "type": "tuple",
+            "internalType": "struct IInvisiProtocol.CrossTreeTransactParams",
+            "components": [
+              {
+                "name": "token",
+                "type": "address",
+                "internalType": "address"
+              },
+              {
+                "name": "sources",
+                "type": "tuple[]",
+                "internalType": "struct IInvisiProtocol.InputSource[]",
+                "components": [
+                  {
+                    "name": "treeId",
+                    "type": "uint256",
+                    "internalType": "uint256"
+                  },
+                  {
+                    "name": "merkleRoot",
+                    "type": "bytes32",
+                    "internalType": "bytes32"
+                  }
+                ]
+              },
+              {
+                "name": "nullifiers",
+                "type": "bytes32[]",
+                "internalType": "bytes32[]"
+              },
+              {
+                "name": "noteCommitments",
+                "type": "bytes32[]",
+                "internalType": "bytes32[]"
+              },
+              {
+                "name": "withdrawalAddress",
+                "type": "address",
+                "internalType": "address"
+              },
+              {
+                "name": "withdrawalAmount",
+                "type": "uint256",
+                "internalType": "uint256"
+              },
+              {
+                "name": "deadline",
+                "type": "uint256",
+                "internalType": "uint256"
+              },
+              {
+                "name": "feeRecipient",
+                "type": "address",
+                "internalType": "address"
+              },
+              {
+                "name": "feeAmount",
+                "type": "uint256",
+                "internalType": "uint256"
+              }
+            ]
+          },
+          {
+            "name": "deliveries",
+            "type": "tuple[]",
+            "internalType": "struct IInvisiProtocol.Delivery[]",
+            "components": [
+              {
+                "name": "ciphertext",
+                "type": "bytes",
+                "internalType": "bytes"
+              },
+              {
+                "name": "clue",
+                "type": "bytes",
+                "internalType": "bytes"
+              }
+            ]
+          },
+          {
+            "name": "funding",
+            "type": "tuple",
+            "internalType": "struct IInvisiProtocol.FundingParams",
+            "components": [
+              {
+                "name": "payer",
+                "type": "address",
+                "internalType": "address"
+              },
+              {
+                "name": "amount",
+                "type": "uint256",
+                "internalType": "uint256"
+              },
+              {
+                "name": "sigNonce",
+                "type": "uint256",
+                "internalType": "uint256"
+              },
+              {
+                "name": "deadline",
+                "type": "uint256",
+                "internalType": "uint256"
+              },
+              {
+                "name": "signature",
+                "type": "bytes",
+                "internalType": "bytes"
+              },
+              {
+                "name": "permit",
+                "type": "tuple",
+                "internalType": "struct IMetaTx.TokenPermit",
+                "components": [
+                  {
+                    "name": "deadline",
+                    "type": "uint256",
+                    "internalType": "uint256"
+                  },
+                  {
+                    "name": "v",
+                    "type": "uint8",
+                    "internalType": "uint8"
+                  },
+                  {
+                    "name": "r",
+                    "type": "bytes32",
+                    "internalType": "bytes32"
+                  },
+                  {
+                    "name": "s",
+                    "type": "bytes32",
+                    "internalType": "bytes32"
+                  }
+                ]
+              }
+            ]
+          }
+        ]
+      }
+    ],
+    "outputs": [],
+    "stateMutability": "nonpayable"
+  },
+  {
+    "type": "function",
+    "name": "transferOwnership",
+    "inputs": [
+      {
+        "name": "newOwner",
+        "type": "address",
+        "internalType": "address"
+      }
+    ],
+    "outputs": [],
+    "stateMutability": "nonpayable"
+  },
+  {
+    "type": "function",
+    "name": "unpause",
+    "inputs": [],
+    "outputs": [],
+    "stateMutability": "nonpayable"
+  },
+  {
+    "type": "function",
+    "name": "unpauseCircuit",
+    "inputs": [],
+    "outputs": [],
+    "stateMutability": "nonpayable"
+  },
+  {
+    "type": "function",
+    "name": "updateCredit",
+    "inputs": [
+      {
+        "name": "",
+        "type": "bytes",
+        "internalType": "bytes"
+      },
+      {
+        "name": "p",
+        "type": "tuple",
+        "internalType": "struct IInvisiProtocol.UpdateCreditParams",
+        "components": [
+          {
+            "name": "token",
+            "type": "address",
+            "internalType": "address"
+          },
+          {
+            "name": "owner",
+            "type": "address",
+            "internalType": "address"
+          },
+          {
+            "name": "source",
+            "type": "tuple",
+            "internalType": "struct IInvisiProtocol.InputSource",
+            "components": [
+              {
+                "name": "treeId",
+                "type": "uint256",
+                "internalType": "uint256"
+              },
+              {
+                "name": "merkleRoot",
+                "type": "bytes32",
+                "internalType": "bytes32"
+              }
+            ]
+          },
+          {
+            "name": "nullifier",
+            "type": "bytes32",
+            "internalType": "bytes32"
+          },
+          {
+            "name": "creditCommitment",
+            "type": "bytes32",
+            "internalType": "bytes32"
+          },
+          {
+            "name": "revocationShard",
+            "type": "uint64",
+            "internalType": "uint64"
+          },
+          {
+            "name": "revocationSlot",
+            "type": "uint16",
+            "internalType": "uint16"
+          },
+          {
+            "name": "deadline",
+            "type": "uint256",
+            "internalType": "uint256"
+          },
+          {
+            "name": "feeRecipient",
+            "type": "address",
+            "internalType": "address"
+          },
+          {
+            "name": "feeAmount",
+            "type": "uint256",
+            "internalType": "uint256"
+          }
+        ]
+      },
+      {
+        "name": "",
+        "type": "tuple[]",
+        "internalType": "struct IInvisiProtocol.Delivery[]",
+        "components": [
+          {
+            "name": "ciphertext",
+            "type": "bytes",
+            "internalType": "bytes"
+          },
+          {
+            "name": "clue",
+            "type": "bytes",
+            "internalType": "bytes"
+          }
+        ]
+      }
+    ],
+    "outputs": [],
+    "stateMutability": "nonpayable"
+  },
+  {
+    "type": "function",
+    "name": "verifierRouter",
+    "inputs": [],
+    "outputs": [
+      {
+        "name": "",
+        "type": "address",
+        "internalType": "contract IVerifierRouter"
+      }
+    ],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "withdrawBroadcasterFees",
+    "inputs": [
+      {
+        "name": "token",
+        "type": "address",
+        "internalType": "address"
+      },
+      {
+        "name": "recipient",
+        "type": "address",
+        "internalType": "address"
+      }
+    ],
+    "outputs": [
+      {
+        "name": "",
+        "type": "uint256",
+        "internalType": "uint256"
+      }
+    ],
+    "stateMutability": "nonpayable"
+  },
+  {
+    "type": "event",
+    "name": "BatchOutputs",
+    "inputs": [
+      {
+        "name": "treeId",
+        "type": "uint256",
+        "indexed": true,
+        "internalType": "uint256"
+      },
+      {
+        "name": "startLeafIndex",
+        "type": "uint32",
+        "indexed": false,
+        "internalType": "uint32"
+      },
+      {
+        "name": "firstOutputOffset",
+        "type": "uint256",
+        "indexed": false,
+        "internalType": "uint256"
+      },
+      {
+        "name": "tokens",
+        "type": "address[]",
+        "indexed": false,
+        "internalType": "address[]"
+      },
+      {
+        "name": "noteCommitments",
+        "type": "bytes32[]",
+        "indexed": false,
+        "internalType": "bytes32[]"
+      },
+      {
+        "name": "packedDeliveries",
+        "type": "bytes",
+        "indexed": false,
+        "internalType": "bytes"
+      }
+    ],
+    "anonymous": false
+  },
+  {
+    "type": "event",
+    "name": "BatchRequest",
+    "inputs": [
+      {
+        "name": "token",
+        "type": "address",
+        "indexed": false,
+        "internalType": "address"
+      },
+      {
+        "name": "requestIndex",
+        "type": "uint256",
+        "indexed": true,
+        "internalType": "uint256"
+      },
+      {
+        "name": "capacity",
+        "type": "uint256",
+        "indexed": false,
+        "internalType": "uint256"
+      },
+      {
+        "name": "sources",
+        "type": "tuple[]",
+        "indexed": false,
+        "internalType": "struct IInvisiProtocol.InputSource[]",
+        "components": [
+          {
+            "name": "treeId",
+            "type": "uint256",
+            "internalType": "uint256"
+          },
+          {
+            "name": "merkleRoot",
+            "type": "bytes32",
+            "internalType": "bytes32"
+          }
+        ]
+      },
+      {
+        "name": "nullifiers",
+        "type": "bytes32[]",
+        "indexed": false,
+        "internalType": "bytes32[]"
+      },
+      {
+        "name": "outputCount",
+        "type": "uint256",
+        "indexed": false,
+        "internalType": "uint256"
+      },
+      {
+        "name": "payer",
+        "type": "address",
+        "indexed": false,
+        "internalType": "address"
+      },
+      {
+        "name": "depositAmount",
+        "type": "uint256",
+        "indexed": false,
+        "internalType": "uint256"
+      },
+      {
+        "name": "withdrawalAddress",
+        "type": "address",
+        "indexed": false,
+        "internalType": "address"
+      },
+      {
+        "name": "withdrawalAmount",
+        "type": "uint256",
+        "indexed": false,
+        "internalType": "uint256"
+      },
+      {
+        "name": "deadline",
+        "type": "uint256",
+        "indexed": false,
+        "internalType": "uint256"
+      },
+      {
+        "name": "statementHash",
+        "type": "bytes32",
+        "indexed": false,
+        "internalType": "bytes32"
+      }
+    ],
+    "anonymous": false
+  },
+  {
+    "type": "event",
+    "name": "BroadcasterFee",
+    "inputs": [
+      {
+        "name": "token",
+        "type": "address",
+        "indexed": true,
+        "internalType": "address"
+      },
+      {
+        "name": "recipient",
+        "type": "address",
+        "indexed": true,
+        "internalType": "address"
+      },
+      {
+        "name": "amount",
+        "type": "uint256",
+        "indexed": false,
+        "internalType": "uint256"
+      }
+    ],
+    "anonymous": false
+  },
+  {
+    "type": "event",
+    "name": "BroadcasterFeeWithdrawn",
+    "inputs": [
+      {
+        "name": "token",
+        "type": "address",
+        "indexed": true,
+        "internalType": "address"
+      },
+      {
+        "name": "recipient",
+        "type": "address",
+        "indexed": true,
+        "internalType": "address"
+      },
+      {
+        "name": "amount",
+        "type": "uint256",
+        "indexed": false,
+        "internalType": "uint256"
+      }
+    ],
+    "anonymous": false
+  },
+  {
+    "type": "event",
+    "name": "CircuitPauseUpdated",
+    "inputs": [
+      {
+        "name": "paused",
+        "type": "bool",
+        "indexed": false,
+        "internalType": "bool"
+      }
+    ],
+    "anonymous": false
+  },
+  {
+    "type": "event",
+    "name": "CommitmentsInserted",
+    "inputs": [
+      {
+        "name": "treeId",
+        "type": "uint256",
+        "indexed": true,
+        "internalType": "uint256"
+      },
+      {
+        "name": "startLeafIndex",
+        "type": "uint32",
+        "indexed": false,
+        "internalType": "uint32"
+      },
+      {
+        "name": "commitments",
+        "type": "bytes32[]",
+        "indexed": false,
+        "internalType": "bytes32[]"
+      }
+    ],
+    "anonymous": false
+  },
+  {
+    "type": "event",
+    "name": "CreditCreated",
+    "inputs": [
+      {
+        "name": "token",
+        "type": "address",
+        "indexed": true,
+        "internalType": "address"
+      },
+      {
+        "name": "owner",
+        "type": "address",
+        "indexed": true,
+        "internalType": "address"
+      },
+      {
+        "name": "outputTreeId",
+        "type": "uint256",
+        "indexed": true,
+        "internalType": "uint256"
+      },
+      {
+        "name": "revocationShard",
+        "type": "uint64",
+        "indexed": false,
+        "internalType": "uint64"
+      },
+      {
+        "name": "revocationSlot",
+        "type": "uint16",
+        "indexed": false,
+        "internalType": "uint16"
+      },
+      {
+        "name": "creditCommitment",
+        "type": "bytes32",
+        "indexed": false,
+        "internalType": "bytes32"
+      },
+      {
+        "name": "leafIndex",
+        "type": "uint32",
+        "indexed": false,
+        "internalType": "uint32"
+      },
+      {
+        "name": "deliveries",
+        "type": "tuple[]",
+        "indexed": false,
+        "internalType": "struct IInvisiProtocol.Delivery[]",
+        "components": [
+          {
+            "name": "ciphertext",
+            "type": "bytes",
+            "internalType": "bytes"
+          },
+          {
+            "name": "clue",
+            "type": "bytes",
+            "internalType": "bytes"
+          }
+        ]
+      },
+      {
+        "name": "deadline",
+        "type": "uint256",
+        "indexed": false,
+        "internalType": "uint256"
+      },
+      {
+        "name": "feeRecipient",
+        "type": "address",
+        "indexed": false,
+        "internalType": "address"
+      },
+      {
+        "name": "feeAmount",
+        "type": "uint256",
+        "indexed": false,
+        "internalType": "uint256"
+      }
+    ],
+    "anonymous": false
+  },
+  {
+    "type": "event",
+    "name": "CreditDraw",
+    "inputs": [
+      {
+        "name": "outputTreeId",
+        "type": "uint256",
+        "indexed": true,
+        "internalType": "uint256"
+      },
+      {
+        "name": "params",
+        "type": "tuple",
+        "indexed": false,
+        "internalType": "struct IInvisiProtocol.CreditDrawParams",
+        "components": [
+          {
+            "name": "token",
+            "type": "address",
+            "internalType": "address"
+          },
+          {
+            "name": "sources",
+            "type": "tuple[]",
+            "internalType": "struct IInvisiProtocol.InputSource[]",
+            "components": [
+              {
+                "name": "treeId",
+                "type": "uint256",
+                "internalType": "uint256"
+              },
+              {
+                "name": "merkleRoot",
+                "type": "bytes32",
+                "internalType": "bytes32"
+              }
+            ]
+          },
+          {
+            "name": "payers",
+            "type": "tuple[]",
+            "internalType": "struct IInvisiProtocol.CreditPayer[]",
+            "components": [
+              {
+                "name": "payer",
+                "type": "address",
+                "internalType": "address"
+              },
+              {
+                "name": "amount",
+                "type": "uint256",
+                "internalType": "uint256"
+              }
+            ]
+          },
+          {
+            "name": "grantRefs",
+            "type": "tuple[]",
+            "internalType": "struct IInvisiProtocol.CreditGrantRef[]",
+            "components": [
+              {
+                "name": "payerIndex",
+                "type": "uint256",
+                "internalType": "uint256"
+              },
+              {
+                "name": "shard",
+                "type": "uint64",
+                "internalType": "uint64"
+              },
+              {
+                "name": "slot",
+                "type": "uint16",
+                "internalType": "uint16"
+              }
+            ]
+          },
+          {
+            "name": "nullifiers",
+            "type": "bytes32[]",
+            "internalType": "bytes32[]"
+          },
+          {
+            "name": "creditCommitments",
+            "type": "bytes32[]",
+            "internalType": "bytes32[]"
+          },
+          {
+            "name": "recoveryAmounts",
+            "type": "bytes32[]",
+            "internalType": "bytes32[]"
+          },
+          {
+            "name": "noteCommitment",
+            "type": "bytes32",
+            "internalType": "bytes32"
+          },
+          {
+            "name": "totalAmount",
+            "type": "uint256",
+            "internalType": "uint256"
+          },
+          {
+            "name": "deadline",
+            "type": "uint256",
+            "internalType": "uint256"
+          },
+          {
+            "name": "feeRecipient",
+            "type": "address",
+            "internalType": "address"
+          },
+          {
+            "name": "feeAmount",
+            "type": "uint256",
+            "internalType": "uint256"
+          }
+        ]
+      },
+      {
+        "name": "leafIndices",
+        "type": "uint32[]",
+        "indexed": false,
+        "internalType": "uint32[]"
+      },
+      {
+        "name": "deliveries",
+        "type": "tuple[]",
+        "indexed": false,
+        "internalType": "struct IInvisiProtocol.Delivery[]",
+        "components": [
+          {
+            "name": "ciphertext",
+            "type": "bytes",
+            "internalType": "bytes"
+          },
+          {
+            "name": "clue",
+            "type": "bytes",
+            "internalType": "bytes"
+          }
+        ]
+      }
+    ],
+    "anonymous": false
+  },
+  {
+    "type": "event",
+    "name": "CreditRevoked",
+    "inputs": [
+      {
+        "name": "owner",
+        "type": "address",
+        "indexed": true,
+        "internalType": "address"
+      },
+      {
+        "name": "token",
+        "type": "address",
+        "indexed": true,
+        "internalType": "address"
+      },
+      {
+        "name": "shard",
+        "type": "uint64",
+        "indexed": true,
+        "internalType": "uint64"
+      },
+      {
+        "name": "slot",
+        "type": "uint16",
+        "indexed": false,
+        "internalType": "uint16"
+      },
+      {
+        "name": "feeRecipient",
+        "type": "address",
+        "indexed": false,
+        "internalType": "address"
+      },
+      {
+        "name": "feeAmount",
+        "type": "uint256",
+        "indexed": false,
+        "internalType": "uint256"
+      }
+    ],
+    "anonymous": false
+  },
+  {
+    "type": "event",
+    "name": "CreditUpdated",
+    "inputs": [
+      {
+        "name": "owner",
+        "type": "address",
+        "indexed": true,
+        "internalType": "address"
+      },
+      {
+        "name": "outputTreeId",
+        "type": "uint256",
+        "indexed": true,
+        "internalType": "uint256"
+      },
+      {
+        "name": "params",
+        "type": "tuple",
+        "indexed": false,
+        "internalType": "struct IInvisiProtocol.UpdateCreditParams",
+        "components": [
+          {
+            "name": "token",
+            "type": "address",
+            "internalType": "address"
+          },
+          {
+            "name": "owner",
+            "type": "address",
+            "internalType": "address"
+          },
+          {
+            "name": "source",
+            "type": "tuple",
+            "internalType": "struct IInvisiProtocol.InputSource",
+            "components": [
+              {
+                "name": "treeId",
+                "type": "uint256",
+                "internalType": "uint256"
+              },
+              {
+                "name": "merkleRoot",
+                "type": "bytes32",
+                "internalType": "bytes32"
+              }
+            ]
+          },
+          {
+            "name": "nullifier",
+            "type": "bytes32",
+            "internalType": "bytes32"
+          },
+          {
+            "name": "creditCommitment",
+            "type": "bytes32",
+            "internalType": "bytes32"
+          },
+          {
+            "name": "revocationShard",
+            "type": "uint64",
+            "internalType": "uint64"
+          },
+          {
+            "name": "revocationSlot",
+            "type": "uint16",
+            "internalType": "uint16"
+          },
+          {
+            "name": "deadline",
+            "type": "uint256",
+            "internalType": "uint256"
+          },
+          {
+            "name": "feeRecipient",
+            "type": "address",
+            "internalType": "address"
+          },
+          {
+            "name": "feeAmount",
+            "type": "uint256",
+            "internalType": "uint256"
+          }
+        ]
+      },
+      {
+        "name": "leafIndex",
+        "type": "uint32",
+        "indexed": false,
+        "internalType": "uint32"
+      },
+      {
+        "name": "deliveries",
+        "type": "tuple[]",
+        "indexed": false,
+        "internalType": "struct IInvisiProtocol.Delivery[]",
+        "components": [
+          {
+            "name": "ciphertext",
+            "type": "bytes",
+            "internalType": "bytes"
+          },
+          {
+            "name": "clue",
+            "type": "bytes",
+            "internalType": "bytes"
+          }
+        ]
+      }
+    ],
+    "anonymous": false
+  },
+  {
+    "type": "event",
+    "name": "CrossTreeTransact",
+    "inputs": [
+      {
+        "name": "token",
+        "type": "address",
+        "indexed": false,
+        "internalType": "address"
+      },
+      {
+        "name": "outputTreeId",
+        "type": "uint256",
+        "indexed": true,
+        "internalType": "uint256"
+      },
+      {
+        "name": "sources",
+        "type": "tuple[]",
+        "indexed": false,
+        "internalType": "struct IInvisiProtocol.InputSource[]",
+        "components": [
+          {
+            "name": "treeId",
+            "type": "uint256",
+            "internalType": "uint256"
+          },
+          {
+            "name": "merkleRoot",
+            "type": "bytes32",
+            "internalType": "bytes32"
+          }
+        ]
+      },
+      {
+        "name": "nullifiers",
+        "type": "bytes32[]",
+        "indexed": false,
+        "internalType": "bytes32[]"
+      },
+      {
+        "name": "noteCommitments",
+        "type": "bytes32[]",
+        "indexed": false,
+        "internalType": "bytes32[]"
+      },
+      {
+        "name": "leafIndices",
+        "type": "uint32[]",
+        "indexed": false,
+        "internalType": "uint32[]"
+      },
+      {
+        "name": "deliveries",
+        "type": "tuple[]",
+        "indexed": false,
+        "internalType": "struct IInvisiProtocol.Delivery[]",
+        "components": [
+          {
+            "name": "ciphertext",
+            "type": "bytes",
+            "internalType": "bytes"
+          },
+          {
+            "name": "clue",
+            "type": "bytes",
+            "internalType": "bytes"
+          }
+        ]
+      },
+      {
+        "name": "withdrawalAddress",
+        "type": "address",
+        "indexed": false,
+        "internalType": "address"
+      },
+      {
+        "name": "withdrawalAmount",
+        "type": "uint256",
+        "indexed": false,
+        "internalType": "uint256"
+      },
+      {
+        "name": "deadline",
+        "type": "uint256",
+        "indexed": false,
+        "internalType": "uint256"
+      }
+    ],
+    "anonymous": false
+  },
+  {
+    "type": "event",
+    "name": "EIP712DomainChanged",
+    "inputs": [],
+    "anonymous": false
+  },
+  {
+    "type": "event",
+    "name": "NonceInvalidated",
+    "inputs": [
+      {
+        "name": "signer",
+        "type": "address",
+        "indexed": true,
+        "internalType": "address"
+      },
+      {
+        "name": "newNonce",
+        "type": "uint256",
+        "indexed": false,
+        "internalType": "uint256"
+      }
+    ],
+    "anonymous": false
+  },
+  {
+    "type": "event",
+    "name": "OwnershipTransferStarted",
+    "inputs": [
+      {
+        "name": "previousOwner",
+        "type": "address",
+        "indexed": true,
+        "internalType": "address"
+      },
+      {
+        "name": "newOwner",
+        "type": "address",
+        "indexed": true,
+        "internalType": "address"
+      }
+    ],
+    "anonymous": false
+  },
+  {
+    "type": "event",
+    "name": "OwnershipTransferred",
+    "inputs": [
+      {
+        "name": "previousOwner",
+        "type": "address",
+        "indexed": true,
+        "internalType": "address"
+      },
+      {
+        "name": "newOwner",
+        "type": "address",
+        "indexed": true,
+        "internalType": "address"
+      }
+    ],
+    "anonymous": false
+  },
+  {
+    "type": "event",
+    "name": "Paused",
+    "inputs": [
+      {
+        "name": "account",
+        "type": "address",
+        "indexed": false,
+        "internalType": "address"
+      }
+    ],
+    "anonymous": false
+  },
+  {
+    "type": "event",
+    "name": "PublicDeposit",
+    "inputs": [
+      {
+        "name": "token",
+        "type": "address",
+        "indexed": true,
+        "internalType": "address"
+      },
+      {
+        "name": "payer",
+        "type": "address",
+        "indexed": true,
+        "internalType": "address"
+      },
+      {
+        "name": "amount",
+        "type": "uint256",
+        "indexed": false,
+        "internalType": "uint256"
+      },
+      {
+        "name": "proofHash",
+        "type": "bytes32",
+        "indexed": false,
+        "internalType": "bytes32"
+      }
+    ],
+    "anonymous": false
+  },
+  {
+    "type": "event",
+    "name": "ScreenerUpdated",
+    "inputs": [
+      {
+        "name": "newScreener",
+        "type": "address",
+        "indexed": true,
+        "internalType": "address"
+      }
+    ],
+    "anonymous": false
+  },
+  {
+    "type": "event",
+    "name": "Shield",
+    "inputs": [
+      {
+        "name": "token",
+        "type": "address",
+        "indexed": true,
+        "internalType": "address"
+      },
+      {
+        "name": "payer",
+        "type": "address",
+        "indexed": true,
+        "internalType": "address"
+      },
+      {
+        "name": "amount",
+        "type": "uint256",
+        "indexed": false,
+        "internalType": "uint256"
+      },
+      {
+        "name": "treeId",
+        "type": "uint256",
+        "indexed": true,
+        "internalType": "uint256"
+      },
+      {
+        "name": "startLeafIndex",
+        "type": "uint32",
+        "indexed": false,
+        "internalType": "uint32"
+      },
+      {
+        "name": "deliveries",
+        "type": "tuple[]",
+        "indexed": false,
+        "internalType": "struct IInvisiProtocol.Delivery[]",
+        "components": [
+          {
+            "name": "ciphertext",
+            "type": "bytes",
+            "internalType": "bytes"
+          },
+          {
+            "name": "clue",
+            "type": "bytes",
+            "internalType": "bytes"
+          }
+        ]
+      },
+      {
+        "name": "deadline",
+        "type": "uint256",
+        "indexed": false,
+        "internalType": "uint256"
+      }
+    ],
+    "anonymous": false
+  },
+  {
+    "type": "event",
+    "name": "Transact",
+    "inputs": [
+      {
+        "name": "token",
+        "type": "address",
+        "indexed": false,
+        "internalType": "address"
+      },
+      {
+        "name": "inputTreeId",
+        "type": "uint256",
+        "indexed": true,
+        "internalType": "uint256"
+      },
+      {
+        "name": "outputTreeId",
+        "type": "uint256",
+        "indexed": true,
+        "internalType": "uint256"
+      },
+      {
+        "name": "nullifiers",
+        "type": "bytes32[]",
+        "indexed": false,
+        "internalType": "bytes32[]"
+      },
+      {
+        "name": "noteCommitments",
+        "type": "bytes32[]",
+        "indexed": false,
+        "internalType": "bytes32[]"
+      },
+      {
+        "name": "leafIndices",
+        "type": "uint32[]",
+        "indexed": false,
+        "internalType": "uint32[]"
+      },
+      {
+        "name": "deliveries",
+        "type": "tuple[]",
+        "indexed": false,
+        "internalType": "struct IInvisiProtocol.Delivery[]",
+        "components": [
+          {
+            "name": "ciphertext",
+            "type": "bytes",
+            "internalType": "bytes"
+          },
+          {
+            "name": "clue",
+            "type": "bytes",
+            "internalType": "bytes"
+          }
+        ]
+      },
+      {
+        "name": "withdrawalAddress",
+        "type": "address",
+        "indexed": false,
+        "internalType": "address"
+      },
+      {
+        "name": "withdrawalAmount",
+        "type": "uint256",
+        "indexed": false,
+        "internalType": "uint256"
+      },
+      {
+        "name": "deadline",
+        "type": "uint256",
+        "indexed": false,
+        "internalType": "uint256"
+      }
+    ],
+    "anonymous": false
+  },
+  {
+    "type": "event",
+    "name": "TransactAggregated",
+    "inputs": [
+      {
+        "name": "proofHash",
+        "type": "bytes32",
+        "indexed": true,
+        "internalType": "bytes32"
+      },
+      {
+        "name": "requestCount",
+        "type": "uint256",
+        "indexed": false,
+        "internalType": "uint256"
+      }
+    ],
+    "anonymous": false
+  },
+  {
+    "type": "event",
+    "name": "TreeCreated",
+    "inputs": [
+      {
+        "name": "treeId",
+        "type": "uint256",
+        "indexed": true,
+        "internalType": "uint256"
+      }
+    ],
+    "anonymous": false
+  },
+  {
+    "type": "event",
+    "name": "Unpaused",
+    "inputs": [
+      {
+        "name": "account",
+        "type": "address",
+        "indexed": false,
+        "internalType": "address"
+      }
+    ],
+    "anonymous": false
+  },
+  {
+    "type": "error",
+    "name": "AddressEmptyCode",
+    "inputs": [
+      {
+        "name": "target",
+        "type": "address",
+        "internalType": "address"
+      }
+    ]
+  },
+  {
+    "type": "error",
+    "name": "AddressInsufficientBalance",
+    "inputs": [
+      {
+        "name": "account",
+        "type": "address",
+        "internalType": "address"
+      }
+    ]
+  },
+  {
+    "type": "error",
+    "name": "AddressScreeningFailed",
+    "inputs": [
+      {
+        "name": "account",
+        "type": "address",
+        "internalType": "address"
+      }
+    ]
+  },
+  {
+    "type": "error",
+    "name": "ChainIdMismatch",
+    "inputs": []
+  },
+  {
+    "type": "error",
+    "name": "CommitmentAlreadyRegistered",
+    "inputs": [
+      {
+        "name": "commitment",
+        "type": "bytes32",
+        "internalType": "bytes32"
+      }
+    ]
+  },
+  {
+    "type": "error",
+    "name": "CreditAlreadyRevoked",
+    "inputs": []
+  },
+  {
+    "type": "error",
+    "name": "DoubleSpend",
+    "inputs": [
+      {
+        "name": "nullifier",
+        "type": "bytes32",
+        "internalType": "bytes32"
+      }
+    ]
+  },
+  {
+    "type": "error",
+    "name": "EnforcedPause",
+    "inputs": []
+  },
+  {
+    "type": "error",
+    "name": "ExpectedPause",
+    "inputs": []
+  },
+  {
+    "type": "error",
+    "name": "FailedInnerCall",
+    "inputs": []
+  },
+  {
+    "type": "error",
+    "name": "InexactTokenReceipt",
+    "inputs": [
+      {
+        "name": "requested",
+        "type": "uint256",
+        "internalType": "uint256"
+      },
+      {
+        "name": "received",
+        "type": "uint256",
+        "internalType": "uint256"
+      }
+    ]
+  },
+  {
+    "type": "error",
+    "name": "InvalidAddressRegistry",
+    "inputs": []
+  },
+  {
+    "type": "error",
+    "name": "InvalidAggregateBatch",
+    "inputs": []
+  },
+  {
+    "type": "error",
+    "name": "InvalidAmount",
+    "inputs": []
+  },
+  {
+    "type": "error",
+    "name": "InvalidBatchSize",
+    "inputs": []
+  },
+  {
+    "type": "error",
+    "name": "InvalidCommitment",
+    "inputs": []
+  },
+  {
+    "type": "error",
+    "name": "InvalidCreditAllocation",
+    "inputs": []
+  },
+  {
+    "type": "error",
+    "name": "InvalidDelivery",
+    "inputs": []
+  },
+  {
+    "type": "error",
+    "name": "InvalidFunding",
+    "inputs": []
+  },
+  {
+    "type": "error",
+    "name": "InvalidMerkleRoot",
+    "inputs": [
+      {
+        "name": "root",
+        "type": "bytes32",
+        "internalType": "bytes32"
+      }
+    ]
+  },
+  {
+    "type": "error",
+    "name": "InvalidNonce",
+    "inputs": []
+  },
+  {
+    "type": "error",
+    "name": "InvalidPrivateTransferContext",
+    "inputs": []
+  },
+  {
+    "type": "error",
+    "name": "InvalidPrivateTransferShape",
+    "inputs": [
+      {
+        "name": "inputs",
+        "type": "uint256",
+        "internalType": "uint256"
+      },
+      {
+        "name": "outputs",
+        "type": "uint256",
+        "internalType": "uint256"
+      }
+    ]
+  },
+  {
+    "type": "error",
+    "name": "InvalidProof",
+    "inputs": []
+  },
+  {
+    "type": "error",
+    "name": "InvalidReceivingAddress",
+    "inputs": []
+  },
+  {
+    "type": "error",
+    "name": "InvalidShieldContext",
+    "inputs": []
+  },
+  {
+    "type": "error",
+    "name": "InvalidShieldOutputCount",
+    "inputs": [
+      {
+        "name": "outputs",
+        "type": "uint256",
+        "internalType": "uint256"
+      }
+    ]
+  },
+  {
+    "type": "error",
+    "name": "InvalidShortString",
+    "inputs": []
+  },
+  {
+    "type": "error",
+    "name": "InvalidSignature",
+    "inputs": []
+  },
+  {
+    "type": "error",
+    "name": "InvalidToken",
+    "inputs": [
+      {
+        "name": "token",
+        "type": "address",
+        "internalType": "address"
+      }
+    ]
+  },
+  {
+    "type": "error",
+    "name": "InvalidTree",
+    "inputs": [
+      {
+        "name": "treeId",
+        "type": "uint256",
+        "internalType": "uint256"
+      }
+    ]
+  },
+  {
+    "type": "error",
+    "name": "LengthMismatch",
+    "inputs": []
+  },
+  {
+    "type": "error",
+    "name": "NoBroadcasterFees",
+    "inputs": []
+  },
+  {
+    "type": "error",
+    "name": "NotEmergencyAdmin",
+    "inputs": []
+  },
+  {
+    "type": "error",
+    "name": "NotGlobalEmergency",
+    "inputs": []
+  },
+  {
+    "type": "error",
+    "name": "OwnableInvalidOwner",
+    "inputs": [
+      {
+        "name": "owner",
+        "type": "address",
+        "internalType": "address"
+      }
+    ]
+  },
+  {
+    "type": "error",
+    "name": "OwnableUnauthorizedAccount",
+    "inputs": [
+      {
+        "name": "account",
+        "type": "address",
+        "internalType": "address"
+      }
+    ]
+  },
+  {
+    "type": "error",
+    "name": "PrivateTransferExpired",
+    "inputs": []
+  },
+  {
+    "type": "error",
+    "name": "ReentrancyGuardReentrantCall",
+    "inputs": []
+  },
+  {
+    "type": "error",
+    "name": "SafeERC20FailedOperation",
+    "inputs": [
+      {
+        "name": "token",
+        "type": "address",
+        "internalType": "address"
+      }
+    ]
+  },
+  {
+    "type": "error",
+    "name": "ShieldExpired",
+    "inputs": []
+  },
+  {
+    "type": "error",
+    "name": "SignatureExpired",
+    "inputs": []
+  },
+  {
+    "type": "error",
+    "name": "StaleRoot",
+    "inputs": [
+      {
+        "name": "root",
+        "type": "bytes32",
+        "internalType": "bytes32"
+      }
+    ]
+  },
+  {
+    "type": "error",
+    "name": "StringTooLong",
+    "inputs": [
+      {
+        "name": "str",
+        "type": "string",
+        "internalType": "string"
+      }
+    ]
+  },
+  {
+    "type": "error",
+    "name": "ZeroNullifier",
+    "inputs": []
+  }
+];
+
+// src/note/calldata.ts
+function buildTransactCalldata(p) {
+  const r = normalizeTransactRequest(p.context, p.params, p.deliveries, p.funding);
+  validateFundingSubmission(r.funding, p.caller, p.context.now);
+  const request = {
+    params: {
+      token: r.tokenAddress,
+      sources: r.sources,
+      nullifiers: r.nullifiers,
+      noteCommitments: r.noteCommitments,
+      withdrawalAddress: r.withdrawalAddress,
+      withdrawalAmount: r.withdrawalAmount,
+      deadline: r.deadline,
+      feeRecipient: r.feeRecipient,
+      feeAmount: r.feeAmount
+    },
+    deliveries: p.deliveries,
+    funding: r.funding
+  };
+  const abi = invisiProtocolAbi.filter(
+    (item) => item.type === "function" && item.name === "transact" && item.inputs.length === 2 && item.inputs[1]?.type === "tuple"
+  );
+  const data = new import_ethers3.Interface(abi).encodeFunctionData("transact", [p.proof, request]);
+  return { data, capacity: r.capacity, approveAmount: r.depositAmount };
+}
+
+// src/note/funding.ts
+var import_primitives2 = require("@invisi-labs/primitives");
+var import_ethers4 = require("ethers");
+
+// src/note/abi-tuples.ts
+var singleTuple = [
+  "(address token,bytes32 merkleRoot,bytes32[] nullifiers,bytes32[] noteCommitments,uint256 inputTreeId,address withdrawalAddress,uint256 withdrawalAmount,uint256 deadline,address feeRecipient,uint256 feeAmount)"
+][0];
+var crossTuple = [
+  "(address token,(uint256 treeId,bytes32 merkleRoot)[] sources,bytes32[] nullifiers,bytes32[] noteCommitments,address withdrawalAddress,uint256 withdrawalAmount,uint256 deadline,address feeRecipient,uint256 feeAmount)"
+][0];
+
+// src/note/funding.ts
+function encodeTransactTypedData(c, p, deliveries, f = {}) {
+  const r = normalizeTransactRequest(c, p, deliveries, f);
+  return (0, import_primitives2.walletAuthorizationTypedData)({
+    context: { chainId: r.chainId, protocolAddress: BigInt(r.protocolAddress) },
+    operation: "transact",
+    capacity: r.capacity,
+    words: transactPublicInputs(c, p, deliveries, f).map(BigInt)
+  });
+}
+function transactFundingRequestHash(proof, p, cs) {
+  const single = {
+    token: p.token,
+    merkleRoot: p.sources[0]?.merkleRoot ?? word(0n),
+    nullifiers: p.nullifiers,
+    noteCommitments: p.noteCommitments,
+    inputTreeId: p.sources[0]?.treeId ?? 0n,
+    withdrawalAddress: p.withdrawalAddress,
+    withdrawalAmount: p.withdrawalAmount,
+    deadline: p.deadline,
+    feeRecipient: p.feeRecipient ?? "0x0000000000000000000000000000000000000000",
+    feeAmount: p.feeAmount ?? 0n
+  };
+  return p.sources.length > 1 ? (0, import_ethers4.keccak256)(
+    import_ethers4.AbiCoder.defaultAbiCoder().encode(
+      [{ type: "bytes32" }, { type: "bytes32" }, crossTuple, { type: "bytes32" }].map(
+        (parameter) => import_ethers4.ParamType.from(parameter)
+      ),
+      [
+        (0, import_ethers4.keccak256)(new TextEncoder().encode("InvisiCrossTreeTransact")),
+        (0, import_ethers4.keccak256)(proof),
+        { ...p, feeRecipient: single.feeRecipient, feeAmount: single.feeAmount },
+        deliveriesHash(cs)
+      ]
+    )
+  ) : (0, import_ethers4.keccak256)(
+    import_ethers4.AbiCoder.defaultAbiCoder().encode(
+      [{ type: "bytes32" }, singleTuple, { type: "bytes32" }].map(
+        (parameter) => import_ethers4.ParamType.from(parameter)
+      ),
+      [(0, import_ethers4.keccak256)(proof), single, deliveriesHash(cs)]
+    )
+  );
+}
+function encodeTransactFundingTypedData(c, proof, p, cs, funding) {
+  normalizeTransactRequest(c, p, cs, funding);
+  const f = normalizeFunding(funding);
+  if (f.amount === 0n) throw new Error("funding authorization requires positive deposit");
+  return {
+    domain: getEIP712Domain(c),
+    primaryType: "FundTransact",
+    types: { FundTransact: fundingFields },
+    message: {
+      requestHash: transactFundingRequestHash(proof, p, cs),
+      payer: f.payer,
+      amount: f.amount,
+      sigNonce: f.sigNonce,
+      deadline: f.deadline
+    }
+  };
+}
+
+// src/note/aggregate-routes.ts
+var AGGREGATE_ROUTES = Object.freeze(
+  [
+    ...Array.from({ length: 10 }, (_, i) => i + 1).flatMap(
+      (capacity) => [1, 2, 5].map((count) => ({
+        kind: "dedicated",
+        capacity,
+        count,
+        name: `transact_aggregate_${capacity}_${count}`,
+        publicInputCount: (17 + 3 * capacity) * count + 1
+      }))
+    ),
+    ...[2, 3, 4, 5].map((count) => ({
+      kind: "mixed",
+      capacity: 0,
+      count,
+      name: `transact_aggregate_mixed_1_5_${count}`,
+      publicInputCount: 33 * count + 5
+    }))
+  ].map((route) => Object.freeze(route))
+);
+function selectAggregateRoute(capacities) {
+  if (!capacities.length || Array.from(
+    { length: capacities.length },
+    (_, i) => Number.isInteger(capacities[i]) && capacities[i] >= 1 && capacities[i] <= 10
+  ).some((v) => !v))
+    throw Error("unsupported aggregate capacities");
+  const count = capacities.length, dedicated = AGGREGATE_ROUTES.find(
+    (r) => r.kind === "dedicated" && r.capacity === capacities[0] && r.count === count
+  );
+  if (dedicated && capacities.every((c) => c === capacities[0])) return dedicated;
+  const mixed = AGGREGATE_ROUTES.find((r) => r.kind === "mixed" && r.count === count);
+  if (mixed && capacities.every((c) => c <= 5)) return mixed;
+  throw Error("unsupported aggregate capacity/count combination");
+}
+
+// src/note/aggregate.ts
+var import_ethers5 = require("ethers");
+function buildTransactAggregateCalldata(p) {
+  const route = selectAggregateRoute(
+    dense(p.requests, "requests").map(
+      (r) => selectTransactCapacity(r.params.nullifiers.length, r.params.noteCommitments.length)
+    )
+  );
+  const requests = p.requests.map((request) => {
+    const r = normalizeTransactRequest(
+      { ...p.context, tokenAddress: request.params.token },
+      request.params,
+      request.deliveries,
+      request.funding
+    );
+    if (r.capacity > 10) throw Error("aggregate supports C1..C10");
+    validateFundingSubmission(r.funding, p.caller, p.context.now);
+    return {
+      ...request,
+      params: { ...request.params, feeRecipient: r.feeRecipient, feeAmount: r.feeAmount }
+    };
+  });
+  const approvalRequirements = [];
+  for (const request of requests) {
+    const funding = normalizeFunding(request.funding);
+    if (funding.amount === 0n) continue;
+    const token = request.params.token;
+    const existing = approvalRequirements.find(
+      (item) => item.token.toLowerCase() === token.toLowerCase() && item.payer.toLowerCase() === funding.payer.toLowerCase()
+    );
+    if (existing) existing.amount += funding.amount;
+    else approvalRequirements.push({ token, payer: funding.payer, amount: funding.amount });
+  }
+  return {
+    data: new import_ethers5.Interface(
+      invisiProtocolAbi.filter(
+        (item) => item.type === "function" && item.name === "transact" && item.inputs[1]?.type === "tuple[]"
+      )
+    ).encodeFunctionData("transact", [p.proof, requests]),
+    capacity: route.capacity,
+    approvalRequirements
+  };
+}
+function aggregateMemberRequestHash(c, r) {
+  const capacity = selectTransactCapacity(
+    r.params.nullifiers.length,
+    r.params.noteCommitments.length
+  );
+  if (capacity > 10) throw Error("aggregate supports C1..C10");
+  return (0, import_ethers5.keccak256)(
+    import_ethers5.AbiCoder.defaultAbiCoder().encode(
+      ["bytes32", "uint256", "bytes32[]"].map((parameter) => import_ethers5.ParamType.from(parameter)),
+      [
+        (0, import_ethers5.keccak256)(new TextEncoder().encode("InvisiAtomicBatchMemberV1")),
+        BigInt(capacity),
+        transactPublicInputs(c, r.params, r.deliveries, r.funding)
+      ]
+    )
+  );
+}
+function aggregatePublicInputs(c, requests) {
+  selectAggregateRoute(
+    dense(requests, "requests").map(
+      (r) => selectTransactCapacity(r.params.nullifiers.length, r.params.noteCommitments.length)
+    )
+  );
+  return requests.flatMap((r) => {
+    const context = { ...c, tokenAddress: r.params.token };
+    aggregateMemberRequestHash(context, r);
+    return [
+      word(
+        BigInt(
+          selectTransactCapacity(
+            r.params.nullifiers.length,
+            r.params.noteCommitments.length
+          )
+        )
+      ),
+      ...transactPublicInputs(context, r.params, r.deliveries, r.funding)
+    ];
+  });
+}
+function encodeAggregateFundingTypedData(c, r) {
+  const f = normalizeFunding(r.funding);
+  if (f.amount === 0n) throw new Error("funding authorization requires positive deposit");
+  return {
+    domain: getEIP712Domain(c),
+    primaryType: "FundTransact",
+    types: { FundTransact: fundingFields },
+    message: {
+      requestHash: aggregateMemberRequestHash(c, r),
+      payer: f.payer,
+      amount: f.amount,
+      sigNonce: f.sigNonce,
+      deadline: f.deadline
+    }
+  };
+}
+
+// src/note/shield.ts
+var import_primitives3 = require("@invisi-labs/primitives");
+var import_ethers7 = require("ethers");
+
+// src/fees/fee.ts
+var import_ethers6 = require("ethers");
+function normalizeFee(p) {
+  const feeRecipient = (0, import_ethers6.getAddress)(p.feeRecipient ?? ZERO_ADDRESS);
+  const feeAmount = uint(p.feeAmount ?? 0n, 128, "feeAmount");
+  if (BigInt(feeRecipient) === 0n !== (feeAmount === 0n))
+    throw new Error("invalid fee context");
+  return { feeRecipient, feeAmount };
+}
+
+// src/note/shield.ts
+async function validateShieldRequest(p) {
+  normalizeContext(p.context);
+  if ((0, import_ethers7.getAddress)(p.params.token) !== (0, import_ethers7.getAddress)(p.context.tokenAddress))
+    throw new Error("request token mismatch");
+  known(p.params, ["token", "noteCommitments", "deadline", "feeRecipient", "feeAmount"]);
+  checkDeadline(p.context, p.params.deadline);
+  const outputs = dense(p.outputs, "outputs"), commitments = notes(p.params.noteCommitments, "noteCommitments"), cs = dense(p.deliveries, "deliveries"), f = normalizeFunding(p.funding);
+  if (outputs.length < 1 || outputs.length > 10 || commitments.length !== outputs.length || cs.length !== outputs.length)
+    throw new Error("shield requires 1..10 outputs and matching deliveries");
+  let total = 0n;
+  for (const [i, o] of outputs.entries()) {
+    known(o, ["identity", "amount"], "output");
+    uint(o.amount, 128, "amount");
+    if (o.amount === 0n) throw new Error("amount must be positive");
+    field(o.identity);
+    normalizeOpaqueDelivery(cs[i], { allowEmpty: true });
+    if (await (0, import_primitives3.computeNoteCommitment)(
+      p.context.chainId,
+      BigInt(p.context.protocolAddress),
+      o.identity,
+      BigInt(p.context.tokenAddress),
+      o.amount
+    ) !== commitments[i])
+      throw new Error("output commitment mismatch");
+    total += o.amount;
+  }
+  if (total + normalizeFee(p.params).feeAmount !== f.amount)
+    throw new Error("funding must equal output total plus fee");
+  return f;
+}
+async function encodeShieldFundingTypedData(p) {
+  const f = await validateShieldRequest(p);
+  return {
+    domain: getEIP712Domain(p.context),
+    primaryType: "FundShield",
+    types: { FundShield: fundingFields },
+    message: {
+      requestHash: shieldFundingRequestHash(p.params, p.outputs, p.deliveries),
+      payer: f.payer,
+      amount: f.amount,
+      sigNonce: f.sigNonce,
+      deadline: f.deadline
+    }
+  };
+}
+async function buildShieldCalldata(p) {
+  const f = await validateShieldRequest(p);
+  validateFundingSubmission(f, p.caller, p.context.now);
+  return {
+    data: new import_ethers7.Interface(invisiProtocolAbi).encodeFunctionData("shield", [
+      { ...p.params, ...normalizeFee(p.params) },
+      p.outputs,
+      p.deliveries,
+      f
+    ]),
+    approveAmount: f.amount
+  };
+}
+function shieldFundingRequestHash(params, outputs, cs) {
+  const outputHash = (0, import_ethers7.keccak256)(
+    import_ethers7.AbiCoder.defaultAbiCoder().encode(
+      ["(bytes32 identity,uint256 amount)[]"].map((parameter) => import_ethers7.ParamType.from(parameter)),
+      [outputs]
+    )
+  );
+  return (0, import_ethers7.keccak256)(
+    import_ethers7.AbiCoder.defaultAbiCoder().encode(
+      [
+        "bytes32",
+        "(address token,bytes32[] noteCommitments,uint256 deadline,address feeRecipient,uint256 feeAmount)",
+        "bytes32",
+        "bytes32"
+      ].map((parameter) => import_ethers7.ParamType.from(parameter)),
+      [
+        (0, import_ethers7.keccak256)(new TextEncoder().encode("InvisiShield")),
+        { ...params, ...normalizeFee(params) },
+        outputHash,
+        deliveriesHash(cs)
+      ]
+    )
+  );
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AGGREGATE_ROUTES,
+  TRANSACT_CAPACITIES,
+  aggregateMemberRequestHash,
+  aggregatePublicInputs,
+  buildShieldCalldata,
+  buildTransactAggregateCalldata,
+  buildTransactCalldata,
+  encodeAggregateFundingTypedData,
+  encodeShieldFundingTypedData,
+  encodeTransactFundingTypedData,
+  encodeTransactTypedData,
+  normalizeTransactRequest,
+  selectAggregateRoute,
+  selectTransactCapacity,
+  shieldFundingRequestHash,
+  transactFundingRequestHash,
+  transactPublicInputs,
+  validateShieldRequest
+});
+//# sourceMappingURL=note.cjs.map