@veil-cash/sdk 0.6.2 → 0.6.3

package/README.md

@@ -93,7 +93,7 @@ veil subaccount recover --slot 0 --asset usdc --to 0xRecipientAddress --amount 2
 
 # 9. Use JSON or unsigned modes when you need automation
 veil status --json
-veil deposit ETH 0.1 --unsigned
+veil deposit ETH 0.1 --unsigned --address 0x...
 veil subaccount status --slot 0 --json
 ```
 
@@ -142,13 +142,14 @@ SIGNER_ADDRESS=0x... veil register --unsigned
 
 In `--unsigned` mode, `--address` is optional when `SIGNER_ADDRESS` is set. `veil register --force` checks on-chain state first and emits a `changeDepositKey` payload only if the address is already registered; otherwise it emits a normal `register` payload.
 
-Deposit ETH or USDC into Veil. The amount you specify is the **net** amount that arrives in your Veil balance. The 0.3% protocol fee is calculated on-chain and added automatically:
+Deposit ETH or USDC into Veil. The amount you specify is the **net** amount that arrives in your Veil balance. A 0.3% protocol fee is normally added on top, but each address gets free daily deposits (fee waived). The CLI checks automatically:
 
 ```bash
-veil deposit ETH 0.1            # 0.1 ETH lands in pool, ~0.1003 ETH sent
-veil deposit USDC 100           # 100 USDC lands in pool, ~100.30 USDC sent
+veil deposit ETH 0.1            # 0.1 ETH lands in pool (free or ~0.1003 ETH sent)
+veil deposit USDC 100           # 100 USDC lands in pool (free or ~100.30 USDC sent)
 veil deposit ETH 0.1 --json
-veil deposit ETH 0.1 --unsigned
+veil deposit ETH 0.1 --unsigned --address 0x...
+SIGNER_ADDRESS=0x... veil deposit ETH 0.1 --unsigned
 ```
 
 ### Balances
@@ -295,7 +296,7 @@ The CLI is the main entrypoint for most users. If you are integrating Veil progr
 2. **Derive Keypair**: Run `veil init` to derive and save your Veil keypair
 3. **Register**: Run `veil register` to link your deposit key on-chain (one-time)
 4. **Check Status**: Run `veil status` to verify your setup
-5. **Deposit**: Run `veil deposit <asset> <amount>` — the amount is what lands in your balance (e.g., `veil deposit ETH 0.1` deposits 0.1 ETH; the 0.3% fee is added automatically)
+5. **Deposit**: Run `veil deposit <asset> <amount>` — the amount is what lands in your balance (e.g., `veil deposit ETH 0.1` deposits 0.1 ETH; the fee is waived if you have daily free deposits remaining, otherwise 0.3% is added automatically)
 6. **Wait**: The Veil deposit engine processes your deposit
 7. **Done**: Your deposit is accepted into the privacy pool
 

package/SDK.md

@@ -109,6 +109,11 @@ keypair.privkey; // '0x...'
 
 ### Transaction Builders
 
+> **Daily free deposits**: Each address gets a configurable number of fee-free
+> deposits per UTC day. The CLI handles this automatically. If you use the
+> builders programmatically, call `getDailyFreeRemaining()` first — when the
+> user has free slots, pass the net amount directly (no fee markup needed).
+
 ```typescript
 import {
   buildRegisterTx, buildChangeDepositKeyTx, buildDepositETHTx, buildDepositTx,
@@ -182,7 +187,7 @@ const mergeResult = await mergeUtxos({
 Balance functions accept an optional `pool` parameter (`'eth'` | `'usdc'`), defaulting to `'eth'`.
 
 ```typescript
-import { getQueueBalance, getPrivateBalance } from '@veil-cash/sdk';
+import { getQueueBalance, getPrivateBalance, getDailyFreeRemaining } from '@veil-cash/sdk';
 
 // Check ETH queue balance (pending deposits)
 const queueBalance = await getQueueBalance({
@@ -195,6 +200,13 @@ const privateBalance = await getPrivateBalance({
   keypair,
   pool: 'usdc',
 });
+
+// Check how many fee-free deposits the user has left today
+const freeRemaining = await getDailyFreeRemaining({
+  address: '0x...',
+  pool: 'eth', // default
+});
+// freeRemaining: number — 0 when all free slots are used or the feature is disabled
 ```
 
 ### Subaccounts
@@ -291,8 +303,8 @@ veil init --json
 
 # Get unsigned transaction payloads for agent signing
 SIGNER_ADDRESS=0x... veil register --unsigned
-veil deposit ETH 0.1 --unsigned
-veil deposit USDC 100 --unsigned    # Outputs approve + deposit payloads
+SIGNER_ADDRESS=0x... veil deposit ETH 0.1 --unsigned
+veil deposit USDC 100 --unsigned --address 0x...    # Outputs approve + deposit payloads
 
 # Request machine-readable status or balances
 veil balance --json
@@ -344,12 +356,13 @@ Use `--unsigned` to get signer-compatible transaction payloads:
 ```bash
 SIGNER_ADDRESS=0x... veil register --unsigned
 SIGNER_ADDRESS=0x... veil register --unsigned --force
-veil deposit ETH 0.1 --unsigned
+SIGNER_ADDRESS=0x... veil deposit ETH 0.1 --unsigned
+veil deposit ETH 0.1 --unsigned --address 0x...
 # {"to":"0x...","data":"0x...","value":"100000000000000000","chainId":8453}
 ```
 
 The `--unsigned` flag outputs a standard `{to, data, value, chainId}` payload compatible with any signer that accepts arbitrary transactions.
-When `SIGNER_ADDRESS` is set, `veil register --unsigned` no longer requires the `--address` flag.
+When `SIGNER_ADDRESS` is set, `veil register --unsigned` and `veil deposit --unsigned` no longer require the `--address` flag.
 For `veil register --unsigned --force`, the CLI checks on-chain registration state first and emits `changeDepositKey` only when the address is already registered; otherwise it falls back to `register`.
 
 ### Programmatic SDK Usage

package/dist/cli/index.cjs

@@ -4203,6 +4203,14 @@ var QUEUE_ABI = [
     outputs: [{ name: "count", type: "uint256" }],
     stateMutability: "view",
     type: "function"
+  },
+  // Get remaining daily free deposits for an address (V3+)
+  {
+    inputs: [{ name: "_depositor", type: "address" }],
+    name: "getDailyFreeRemaining",
+    outputs: [{ name: "remaining", type: "uint256" }],
+    stateMutability: "view",
+    type: "function"
   }
 ];
 var POOL_ABI = [
@@ -5784,174 +5792,6 @@ function createRegisterCommand() {
   });
   return register;
 }
-var MINIMUM_NET = {
-  ETH: 0.01,
-  USDC: 10
-};
-async function getGrossAmount(netWei, rpcUrl) {
-  const publicClient = viem.createPublicClient({
-    chain: chains.base,
-    transport: viem.http(rpcUrl)
-  });
-  const grossWei = await publicClient.readContract({
-    address: getAddresses().entry,
-    abi: ENTRY_ABI,
-    functionName: "getDepositAmountWithFee",
-    args: [netWei]
-  });
-  return { grossWei, feeWei: grossWei - netWei };
-}
-var SUPPORTED_ASSETS = ["ETH", "USDC"];
-function createDepositCommand() {
-  const deposit = new Command("deposit").description("Deposit ETH or USDC into Veil").argument("<asset>", "Asset to deposit (ETH or USDC)").argument("<amount>", "Amount to deposit \u2014 this is what arrives in your Veil balance").option("--unsigned", "Output unsigned transaction payload instead of sending").option("--json", "Output as JSON").addHelpText("after", `
-The amount you specify is the net amount that lands in your Veil balance.
-The 0.3% protocol fee is automatically added on top.
-
-Examples:
-  veil deposit ETH 0.1          # deposits 0.1 ETH (sends ~0.1003 ETH)
-  veil deposit USDC 100         # deposits 100 USDC (sends ~100.30 USDC)
-  veil deposit ETH 0.1 --unsigned
-  veil deposit ETH 0.1 --json
-`).action(async (asset, amount, options) => {
-    try {
-      const assetUpper = asset.toUpperCase();
-      if (!SUPPORTED_ASSETS.includes(assetUpper)) {
-        throw new CLIError(ErrorCode.INVALID_AMOUNT, `Unsupported asset: ${asset}. Supported: ${SUPPORTED_ASSETS.join(", ")}`);
-      }
-      const amountNum = parseFloat(amount);
-      const minimumNet = MINIMUM_NET[assetUpper];
-      if (amountNum < minimumNet) {
-        throw new CLIError(
-          ErrorCode.INVALID_AMOUNT,
-          `Minimum deposit is ${minimumNet} ${assetUpper}.`
-        );
-      }
-      const rpcUrl = process.env.RPC_URL;
-      const poolConfig = POOL_CONFIG[assetUpper.toLowerCase()];
-      const netWei = assetUpper === "ETH" ? viem.parseEther(amount) : viem.parseUnits(amount, poolConfig.decimals);
-      const progress = createProgressReporter();
-      progress("Calculating fee...");
-      const { grossWei, feeWei } = await getGrossAmount(netWei, rpcUrl);
-      const grossStr = assetUpper === "ETH" ? viem.formatEther(grossWei) : viem.formatUnits(grossWei, poolConfig.decimals);
-      const feeStr = assetUpper === "ETH" ? viem.formatEther(feeWei) : viem.formatUnits(feeWei, poolConfig.decimals);
-      const depositKey = process.env.DEPOSIT_KEY;
-      if (!depositKey) {
-        throw new CLIError(ErrorCode.DEPOSIT_KEY_MISSING, 'DEPOSIT_KEY not set. Run "veil init" first.');
-      }
-      progress("Building transaction...");
-      let tx;
-      let approveTx = null;
-      if (assetUpper === "USDC") {
-        approveTx = buildApproveUSDCTx({ amount: grossStr });
-        tx = buildDepositUSDCTx({ depositKey, amount: grossStr });
-      } else {
-        tx = buildDepositETHTx({ depositKey, amount: grossStr });
-      }
-      if (options.unsigned) {
-        clearProgress();
-        const payloads = [];
-        if (approveTx) {
-          payloads.push({
-            step: "approve",
-            to: approveTx.to,
-            data: approveTx.data,
-            value: "0",
-            chainId: 8453
-          });
-        }
-        payloads.push({
-          step: "deposit",
-          to: tx.to,
-          data: tx.data,
-          value: tx.value ? tx.value.toString() : "0",
-          chainId: 8453
-        });
-        printJson(payloads.length === 1 ? payloads[0] : payloads);
-        return;
-      }
-      const config = getConfig(options);
-      const address = getAddress(config.privateKey);
-      if (assetUpper === "ETH") {
-        progress("Checking balance...");
-        const balance = await getBalance(address, config.rpcUrl);
-        if (balance < grossWei) {
-          clearProgress();
-          throw new CLIError(
-            ErrorCode.INSUFFICIENT_BALANCE,
-            `Insufficient ETH balance. Have: ${viem.formatEther(balance)} ETH, Need: ${grossStr} ETH (${amount} + fee)`
-          );
-        }
-      }
-      if (approveTx) {
-        progress(`Approving ${assetUpper}...`);
-        const approvalResult = await sendTransaction(config, approveTx);
-        if (assetUpper === "USDC") {
-          const publicClient = viem.createPublicClient({
-            chain: chains.base,
-            transport: viem.http(config.rpcUrl)
-          });
-          const addresses = getAddresses();
-          let allowance = await publicClient.readContract({
-            address: getAddresses().usdcToken,
-            abi: ERC20_ABI,
-            functionName: "allowance",
-            args: [address, addresses.entry]
-          });
-          for (let confirmations = 2; allowance < grossWei && confirmations <= 3; confirmations++) {
-            await publicClient.waitForTransactionReceipt({
-              hash: approvalResult.hash,
-              confirmations
-            });
-            allowance = await publicClient.readContract({
-              address: addresses.usdcToken,
-              abi: ERC20_ABI,
-              functionName: "allowance",
-              args: [address, addresses.entry]
-            });
-          }
-          if (allowance < grossWei) {
-            throw new CLIError(
-              ErrorCode.CONTRACT_ERROR,
-              `USDC approval is not yet visible on RPC after confirmation. Allowance ${allowance.toString()} < required ${grossWei.toString()}.`
-            );
-          }
-        }
-      }
-      progress("Sending deposit transaction...");
-      const result = await sendTransaction(config, tx);
-      progress("Confirming...");
-      clearProgress();
-      const output = {
-        success: result.receipt.status === "success",
-        hash: result.hash,
-        asset: assetUpper,
-        amount,
-        fee: feeStr,
-        totalSent: grossStr,
-        blockNumber: result.receipt.blockNumber.toString()
-      };
-      if (options.json) {
-        printJson(output);
-        return;
-      }
-      printHeader("Deposit Submitted");
-      printFields([
-        { label: "Asset", value: assetUpper },
-        { label: "Amount", value: `${amount} ${assetUpper}` },
-        { label: "Fee", value: `${feeStr} ${assetUpper} (0.3%)` },
-        { label: "Total sent", value: `${grossStr} ${assetUpper}` },
-        { label: "From", value: address },
-        { label: "Transaction", value: txUrl(result.hash) },
-        { label: "Block", value: result.receipt.blockNumber }
-      ]);
-      printLine();
-    } catch (error) {
-      clearProgress();
-      handleCLIError(error);
-    }
-  });
-  return deposit;
-}
 
 // src/utxo.ts
 var Utxo = class _Utxo {
@@ -6084,6 +5924,25 @@ async function getQueueBalance(options) {
     pendingCount: pendingDeposits.length
   };
 }
+async function getDailyFreeRemaining(options) {
+  const { address, pool = "eth", rpcUrl } = options;
+  const queueAddress = getQueueAddress(pool);
+  const publicClient = viem.createPublicClient({
+    chain: chains.base,
+    transport: viem.http(rpcUrl)
+  });
+  try {
+    const remaining = await publicClient.readContract({
+      address: queueAddress,
+      abi: QUEUE_ABI,
+      functionName: "getDailyFreeRemaining",
+      args: [address]
+    });
+    return Number(remaining);
+  } catch {
+    return 0;
+  }
+}
 async function getPrivateBalance(options) {
   const { keypair, pool = "eth", rpcUrl, onProgress } = options;
   const poolAddress = getPoolAddress(pool);
@@ -6177,6 +6036,206 @@ async function getPrivateBalance(options) {
     utxos: utxoInfos
   };
 }
+var MINIMUM_NET = {
+  ETH: 0.01,
+  USDC: 10
+};
+async function getGrossAmount(netWei, depositor, pool, rpcUrl) {
+  const freeRemaining = await getDailyFreeRemaining({ address: depositor, pool, rpcUrl });
+  if (freeRemaining > 0) {
+    return { grossWei: netWei, feeWei: 0n, dailyFreeUsed: true, dailyFreeRemaining: freeRemaining - 1 };
+  }
+  const publicClient = viem.createPublicClient({
+    chain: chains.base,
+    transport: viem.http(rpcUrl)
+  });
+  const grossWei = await publicClient.readContract({
+    address: getAddresses().entry,
+    abi: ENTRY_ABI,
+    functionName: "getDepositAmountWithFee",
+    args: [netWei]
+  });
+  return { grossWei, feeWei: grossWei - netWei, dailyFreeUsed: false, dailyFreeRemaining: 0 };
+}
+var SUPPORTED_ASSETS = ["ETH", "USDC"];
+function createDepositCommand() {
+  const deposit = new Command("deposit").description("Deposit ETH or USDC into Veil").argument("<asset>", "Asset to deposit (ETH or USDC)").argument("<amount>", "Amount to deposit \u2014 this is what arrives in your Veil balance").option("--address <address>", "Signer address (required in --unsigned mode unless SIGNER_ADDRESS or WALLET_KEY is set)").option("--unsigned", "Output unsigned transaction payload instead of sending").option("--json", "Output as JSON").addHelpText("after", `
+The amount you specify is the net amount that lands in your Veil balance.
+A 0.3% protocol fee is normally added on top, but each address gets
+free daily deposits (fee waived). The CLI checks automatically.
+
+Examples:
+  veil deposit ETH 0.1          # deposits 0.1 ETH (free or ~0.1003 ETH)
+  veil deposit USDC 100         # deposits 100 USDC (free or ~100.30 USDC)
+  veil deposit ETH 0.1 --unsigned --address 0x...
+  SIGNER_ADDRESS=0x... veil deposit ETH 0.1 --unsigned
+  veil deposit ETH 0.1 --json
+`).action(async (asset, amount, options) => {
+    try {
+      const assetUpper = asset.toUpperCase();
+      if (!SUPPORTED_ASSETS.includes(assetUpper)) {
+        throw new CLIError(ErrorCode.INVALID_AMOUNT, `Unsupported asset: ${asset}. Supported: ${SUPPORTED_ASSETS.join(", ")}`);
+      }
+      const amountNum = parseFloat(amount);
+      const minimumNet = MINIMUM_NET[assetUpper];
+      if (amountNum < minimumNet) {
+        throw new CLIError(
+          ErrorCode.INVALID_AMOUNT,
+          `Minimum deposit is ${minimumNet} ${assetUpper}.`
+        );
+      }
+      const rpcUrl = process.env.RPC_URL;
+      const pool = assetUpper.toLowerCase();
+      const poolConfig = POOL_CONFIG[pool];
+      const netWei = assetUpper === "ETH" ? viem.parseEther(amount) : viem.parseUnits(amount, poolConfig.decimals);
+      const progress = createProgressReporter();
+      let config = null;
+      let address;
+      let feeRpcUrl = rpcUrl;
+      if (options.unsigned) {
+        const resolved = resolveAddress({ address: options.address }, { required: true });
+        if (!resolved) {
+          throw new CLIError(
+            ErrorCode.WALLET_KEY_MISSING,
+            "Must provide --address, set SIGNER_ADDRESS, or set WALLET_KEY env."
+          );
+        }
+        address = resolved.address;
+      } else {
+        config = getConfig(options);
+        address = getAddress(config.privateKey);
+        feeRpcUrl = config.rpcUrl;
+      }
+      progress("Checking deposit fee...");
+      const { grossWei, feeWei, dailyFreeUsed, dailyFreeRemaining } = await getGrossAmount(
+        netWei,
+        address,
+        pool,
+        feeRpcUrl
+      );
+      const grossStr = assetUpper === "ETH" ? viem.formatEther(grossWei) : viem.formatUnits(grossWei, poolConfig.decimals);
+      const feeStr = assetUpper === "ETH" ? viem.formatEther(feeWei) : viem.formatUnits(feeWei, poolConfig.decimals);
+      const depositKey = process.env.DEPOSIT_KEY;
+      if (!depositKey) {
+        throw new CLIError(ErrorCode.DEPOSIT_KEY_MISSING, 'DEPOSIT_KEY not set. Run "veil init" first.');
+      }
+      progress("Building transaction...");
+      let tx;
+      let approveTx = null;
+      if (assetUpper === "USDC") {
+        approveTx = buildApproveUSDCTx({ amount: grossStr });
+        tx = buildDepositUSDCTx({ depositKey, amount: grossStr });
+      } else {
+        tx = buildDepositETHTx({ depositKey, amount: grossStr });
+      }
+      if (options.unsigned) {
+        clearProgress();
+        const payloads = [];
+        if (approveTx) {
+          payloads.push({
+            step: "approve",
+            to: approveTx.to,
+            data: approveTx.data,
+            value: "0",
+            chainId: 8453
+          });
+        }
+        payloads.push({
+          step: "deposit",
+          to: tx.to,
+          data: tx.data,
+          value: tx.value ? tx.value.toString() : "0",
+          chainId: 8453
+        });
+        printJson(payloads.length === 1 ? payloads[0] : payloads);
+        return;
+      }
+      if (!config) {
+        throw new CLIError(ErrorCode.WALLET_KEY_MISSING, "WALLET_KEY env var required. Set it before running this command.");
+      }
+      if (assetUpper === "ETH") {
+        progress("Checking balance...");
+        const balance = await getBalance(address, config.rpcUrl);
+        if (balance < grossWei) {
+          clearProgress();
+          throw new CLIError(
+            ErrorCode.INSUFFICIENT_BALANCE,
+            `Insufficient ETH balance. Have: ${viem.formatEther(balance)} ETH, Need: ${grossStr} ETH (${amount} + fee)`
+          );
+        }
+      }
+      if (approveTx) {
+        progress(`Approving ${assetUpper}...`);
+        const approvalResult = await sendTransaction(config, approveTx);
+        if (assetUpper === "USDC") {
+          const publicClient = viem.createPublicClient({
+            chain: chains.base,
+            transport: viem.http(config.rpcUrl)
+          });
+          const addresses = getAddresses();
+          let allowance = await publicClient.readContract({
+            address: getAddresses().usdcToken,
+            abi: ERC20_ABI,
+            functionName: "allowance",
+            args: [address, addresses.entry]
+          });
+          for (let confirmations = 2; allowance < grossWei && confirmations <= 3; confirmations++) {
+            await publicClient.waitForTransactionReceipt({
+              hash: approvalResult.hash,
+              confirmations
+            });
+            allowance = await publicClient.readContract({
+              address: addresses.usdcToken,
+              abi: ERC20_ABI,
+              functionName: "allowance",
+              args: [address, addresses.entry]
+            });
+          }
+          if (allowance < grossWei) {
+            throw new CLIError(
+              ErrorCode.CONTRACT_ERROR,
+              `USDC approval is not yet visible on RPC after confirmation. Allowance ${allowance.toString()} < required ${grossWei.toString()}.`
+            );
+          }
+        }
+      }
+      progress("Sending deposit transaction...");
+      const result = await sendTransaction(config, tx);
+      progress("Confirming...");
+      clearProgress();
+      const output = {
+        success: result.receipt.status === "success",
+        hash: result.hash,
+        asset: assetUpper,
+        amount,
+        fee: feeStr,
+        dailyFreeUsed,
+        totalSent: grossStr,
+        blockNumber: result.receipt.blockNumber.toString()
+      };
+      if (options.json) {
+        printJson(output);
+        return;
+      }
+      const feeLabel = dailyFreeUsed ? `0 ${assetUpper} (free \u2014 ${dailyFreeRemaining} remaining today)` : `${feeStr} ${assetUpper} (0.3%)`;
+      printHeader("Deposit Submitted");
+      printFields([
+        { label: "Asset", value: assetUpper },
+        { label: "Amount", value: `${amount} ${assetUpper}` },
+        { label: "Fee", value: feeLabel },
+        { label: "Total sent", value: `${grossStr} ${assetUpper}` },
+        { label: "From", value: address },
+        { label: "Transaction", value: txUrl(result.hash) },
+        { label: "Block", value: result.receipt.blockNumber }
+      ]);
+      printLine();
+    } catch (error) {
+      clearProgress();
+      handleCLIError(error);
+    }
+  });
+  return deposit;
+}
 
 // src/cli/commands/private-balance.ts
 var SUPPORTED_POOLS = ["eth", "usdc"];

package/dist/index.cjs

@@ -625,6 +625,14 @@ var QUEUE_ABI = [
     outputs: [{ name: "count", type: "uint256" }],
     stateMutability: "view",
     type: "function"
+  },
+  // Get remaining daily free deposits for an address (V3+)
+  {
+    inputs: [{ name: "_depositor", type: "address" }],
+    name: "getDailyFreeRemaining",
+    outputs: [{ name: "remaining", type: "uint256" }],
+    stateMutability: "view",
+    type: "function"
   }
 ];
 var POOL_ABI = [
@@ -1342,6 +1350,25 @@ async function getQueueBalance(options) {
     pendingCount: pendingDeposits.length
   };
 }
+async function getDailyFreeRemaining(options) {
+  const { address, pool = "eth", rpcUrl } = options;
+  const queueAddress = getQueueAddress(pool);
+  const publicClient = viem.createPublicClient({
+    chain: chains.base,
+    transport: viem.http(rpcUrl)
+  });
+  try {
+    const remaining = await publicClient.readContract({
+      address: queueAddress,
+      abi: QUEUE_ABI,
+      functionName: "getDailyFreeRemaining",
+      args: [address]
+    });
+    return Number(remaining);
+  } catch {
+    return 0;
+  }
+}
 async function getPrivateBalance(options) {
   const { keypair, pool = "eth", rpcUrl, onProgress } = options;
   const poolAddress = getPoolAddress(pool);
@@ -2720,6 +2747,7 @@ exports.deriveSubaccountSalt = deriveSubaccountSalt;
 exports.deriveSubaccountSlot = deriveSubaccountSlot;
 exports.findNextSubaccountWithdrawNonce = findNextSubaccountWithdrawNonce;
 exports.getAddresses = getAddresses;
+exports.getDailyFreeRemaining = getDailyFreeRemaining;
 exports.getExtDataHash = getExtDataHash;
 exports.getForwarderFactoryAddress = getForwarderFactoryAddress;
 exports.getMerklePath = getMerklePath;