@veil-cash/sdk 0.6.4 → 0.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veil-cash/sdk",
-  "version": "0.6.4",
+  "version": "0.7.0",
   "description": "SDK and CLI for interacting with Veil Cash privacy pools - keypair generation, deposits, and status checking",
   "type": "module",
   "main": "./dist/index.js",
@@ -48,6 +48,8 @@
     "url": "https://github.com/veildotcash/veildotcash-sdk"
   },
   "dependencies": {
+    "@x402/core": "2.14.0",
+    "@x402/evm": "2.14.0",
     "buffer": "^6.0.3",
     "circomlib": "github:tornadocash/circomlib#d20d53411d1bef61f38c99a8b36d5d0cc4836aa1",
     "commander": "^14.0.2",

package/skills/veil/SKILL.md

@@ -330,9 +330,7 @@ Important:
   - If not yet registered, returns a normal `register` payload.
 
 Deposits treat the CLI amount as the **net** amount that lands in the pool.
-Each address gets a configurable number of fee-free deposits per UTC day.
-The CLI checks automatically — if free slots remain the fee is waived;
-otherwise the `0.3%` protocol fee is calculated on-chain and added.
+A `0.3%` protocol fee is calculated on-chain and added on top.
 After submission, deposits go through screening / queue processing before they
 are accepted into the private pool. This typically takes around `10-15 minutes`.
 

package/skills/veil/reference.md

@@ -307,10 +307,10 @@ Common codes: `VEIL_KEY_MISSING`, `WALLET_KEY_MISSING`, `DEPOSIT_KEY_MISSING`,
 
 | Asset | Minimum (net) | Notes |
 |-------|--------------|-------|
-| ETH | 0.01 | Fee (0.3%) added automatically, or waived if daily free deposits remain |
-| USDC | 10 | Fee (0.3%) added automatically, or waived if daily free deposits remain |
+| ETH | 0.01 | Fee (0.3%) added automatically |
+| USDC | 10 | Fee (0.3%) added automatically |
 
-The CLI amount is the **net** amount that lands in the pool. The CLI checks `getDailyFreeRemaining` on the queue contract — if the user has free slots left today the fee is skipped; otherwise the 0.3% fee is calculated on-chain and added to the transaction automatically.
+The CLI amount is the **net** amount that lands in the pool. A 0.3% protocol fee is calculated on-chain and added to the transaction automatically.
 
 ---
 

package/src/abi.ts

@@ -218,14 +218,6 @@ export const QUEUE_ABI = [
     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',
-  },
 ] as const;
 
 /**

package/src/balance.ts

@@ -127,54 +127,6 @@ export async function getQueueBalance(options: {
   };
 }
 
-/**
- * Get remaining daily free deposits for an address.
- * Returns 0 if the queue contract has not been upgraded to V3 yet
- * or if the daily free feature is disabled.
- *
- * @param options - Query options
- * @param options.address - Depositor address to check
- * @param options.pool - Pool identifier ('eth' or 'usdc', default: 'eth')
- * @param options.rpcUrl - Optional RPC URL
- * @returns Number of free deposits remaining today
- *
- * @example
- * ```typescript
- * const remaining = await getDailyFreeRemaining({
- *   address: '0x...',
- *   pool: 'eth',
- * });
- * console.log(`Free deposits left today: ${remaining}`);
- * ```
- */
-export async function getDailyFreeRemaining(options: {
-  address: `0x${string}`;
-  pool?: RelayPool;
-  rpcUrl?: string;
-}): Promise<number> {
-  const { address, pool = 'eth', rpcUrl } = options;
-  const queueAddress = getQueueAddress(pool);
-
-  const publicClient = createPublicClient({
-    chain: base,
-    transport: http(rpcUrl),
-  });
-
-  try {
-    const remaining = await publicClient.readContract({
-      address: queueAddress,
-      abi: QUEUE_ABI,
-      functionName: 'getDailyFreeRemaining',
-      args: [address],
-    }) as bigint;
-
-    return Number(remaining);
-  } catch {
-    // V2 contracts don't have this function — treat as 0 remaining
-    return 0;
-  }
-}
-
 /**
  * Get private balance from the Pool contract
  * Decrypts all encrypted outputs, calculates nullifiers, and checks spent status

package/src/cli/commands/deposit.ts

@@ -4,7 +4,6 @@
 
 import { Command } from 'commander';
 import { buildDepositETHTx, buildDepositUSDCTx, buildApproveUSDCTx } from '../../deposit.js';
-import { getDailyFreeRemaining } from '../../balance.js';
 import { sendTransaction, getAddress, getBalance } from '../wallet.js';
 import { getConfig, resolveAddress } from '../config.js';
 import { createPublicClient, http, parseEther, parseUnits, formatEther, formatUnits } from 'viem';
@@ -23,21 +22,12 @@ const MINIMUM_NET: Record<string, number> = {
 
 /**
  * Compute the gross amount and fee for a deposit.
- * Checks daily free deposit availability first — if the user has
- * free slots remaining the fee is waived and gross === net.
+ * The 0.3% protocol fee is always added on top of the net amount.
  */
 async function getGrossAmount(
   netWei: bigint,
-  depositor: `0x${string}`,
-  pool: 'eth' | 'usdc',
   rpcUrl: string | undefined,
-): Promise<{ grossWei: bigint; feeWei: bigint; dailyFreeUsed: boolean; dailyFreeRemaining: number }> {
-  const freeRemaining = await getDailyFreeRemaining({ address: depositor, pool, rpcUrl });
-
-  if (freeRemaining > 0) {
-    return { grossWei: netWei, feeWei: 0n, dailyFreeUsed: true, dailyFreeRemaining: freeRemaining - 1 };
-  }
-
+): Promise<{ grossWei: bigint; feeWei: bigint }> {
   const publicClient = createPublicClient({
     chain: base,
     transport: http(rpcUrl),
@@ -50,7 +40,7 @@ async function getGrossAmount(
     args: [netWei],
   }) as bigint;
 
-  return { grossWei, feeWei: grossWei - netWei, dailyFreeUsed: false, dailyFreeRemaining: 0 };
+  return { grossWei, feeWei: grossWei - netWei };
 }
 
 const SUPPORTED_ASSETS = ['ETH', 'USDC'];
@@ -65,12 +55,11 @@ export function createDepositCommand(): Command {
     .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.
+A 0.3% protocol fee is added on top.
 
 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          # deposits 0.1 ETH (~0.1003 ETH sent)
+  veil deposit USDC 100         # deposits 100 USDC (~100.30 USDC sent)
   veil deposit ETH 0.1 --unsigned --address 0x...
   SIGNER_ADDRESS=0x... veil deposit ETH 0.1 --unsigned
   veil deposit ETH 0.1 --json
@@ -123,12 +112,7 @@ Examples:
 
         progress('Checking deposit fee...');
 
-        const { grossWei, feeWei, dailyFreeUsed, dailyFreeRemaining } = await getGrossAmount(
-          netWei,
-          address,
-          pool,
-          feeRpcUrl,
-        );
+        const { grossWei, feeWei } = await getGrossAmount(netWei, feeRpcUrl);
         const grossStr = assetUpper === 'ETH'
           ? formatEther(grossWei)
           : formatUnits(grossWei, poolConfig.decimals);
@@ -244,7 +228,6 @@ Examples:
           asset: assetUpper,
           amount,
           fee: feeStr,
-          dailyFreeUsed,
           totalSent: grossStr,
           blockNumber: result.receipt.blockNumber.toString(),
         };
@@ -254,9 +237,7 @@ Examples:
           return;
         }
 
-        const feeLabel = dailyFreeUsed
-          ? `0 ${assetUpper} (free — ${dailyFreeRemaining} remaining today)`
-          : `${feeStr} ${assetUpper} (0.3%)`;
+        const feeLabel = `${feeStr} ${assetUpper} (0.3%)`;
 
         printHeader('Deposit Submitted');
         printFields([

package/src/compat.ts

@@ -0,0 +1,23 @@
+/**
+ * CJS/ESM interop for legacy dependencies that only ship CommonJS.
+ *
+ * eth-sig-util sets __esModule: true but has no default export — only named
+ * exports. circomlib uses module.exports = { poseidon, ... }.
+ *
+ * Using namespace imports (import * as X) works reliably across both tsup's
+ * CJS and ESM outputs, and browser bundlers (webpack/vite) handle them correctly.
+ */
+
+import * as _ethSigUtil from 'eth-sig-util';
+import * as _circomlib from 'circomlib';
+
+function resolveInterop<T>(mod: T): T {
+  if (mod && typeof mod === 'object' && 'default' in (mod as object)) {
+    const defaultVal = (mod as unknown as { default: T }).default;
+    if (defaultVal != null) return defaultVal;
+  }
+  return mod;
+}
+
+export const ethSigUtil = resolveInterop(_ethSigUtil);
+export const circomlib = resolveInterop(_circomlib);

package/src/ffjavascript.d.ts

@@ -6,8 +6,9 @@ declare module 'ffjavascript' {
 }
 
 declare module 'circomlib' {
+  export const poseidon: (items: Array<bigint | string | number>) => { toString: () => string };
   const circomlib: {
-    poseidon: (items: Array<bigint | string | number>) => { toString: () => string };
+    poseidon: typeof poseidon;
   };
   export default circomlib;
 }
@@ -15,14 +16,18 @@ declare module 'circomlib' {
 declare module 'eth-sig-util' {
   import type { EncryptedMessage } from './types.js';
 
+  export function getEncryptionPublicKey(privateKey: string): string;
+  export function encrypt(
+    receiverPublicKey: string,
+    msgParams: { data: string },
+    version: 'x25519-xsalsa20-poly1305'
+  ): EncryptedMessage;
+  export function decrypt(encryptedData: EncryptedMessage, receiverPrivateKey: string): string;
+
   const ethSigUtil: {
-    getEncryptionPublicKey: (privateKey: string) => string;
-    encrypt: (
-      receiverPublicKey: string,
-      msgParams: { data: string },
-      version: 'x25519-xsalsa20-poly1305'
-    ) => EncryptedMessage;
-    decrypt: (encryptedData: EncryptedMessage, receiverPrivateKey: string) => string;
+    getEncryptionPublicKey: typeof getEncryptionPublicKey;
+    encrypt: typeof encrypt;
+    decrypt: typeof decrypt;
   };
   export default ethSigUtil;
 }

package/src/index.ts

@@ -53,7 +53,6 @@ export {
 export {
   getQueueBalance,
   getPrivateBalance,
-  getDailyFreeRemaining,
 } from './balance.js';
 export type { ProgressCallback } from './balance.js';
 
@@ -64,6 +63,27 @@ export {
   selectUtxosForWithdraw,
 } from './withdraw.js';
 
+// x402 payment helpers
+export {
+  deriveX402PayerKey,
+  deriveX402PayerAddress,
+  getX402PayerBalances,
+  payX402Resource,
+  quoteX402Resource,
+  selectBaseUsdcExactRequirement,
+  usdcAtomicToDecimalString,
+  usdcDecimalToAtomic,
+} from './x402.js';
+export type {
+  GetX402PayerBalancesOptions,
+  PayX402ResourceOptions,
+  PayX402ResourceResult,
+  QuoteX402ResourceOptions,
+  QuoteX402ResourceResult,
+  X402PayerBalance,
+  X402PayerFundedInfo,
+} from './x402.js';
+
 // Transfer functions
 export {
   transfer,

package/src/keypair.ts

@@ -6,7 +6,7 @@
 import { ethers } from 'ethers';
 import { Buffer } from 'buffer';
 import { privateKeyToAccount } from 'viem/accounts';
-import ethSigUtil from 'eth-sig-util';
+import { ethSigUtil } from './compat.js';
 import { poseidonHash, toFixedHex } from './utils.js';
 import type { EncryptedMessage } from './types.js';
 

package/src/types.ts

@@ -155,9 +155,12 @@ export interface RelayExtData {
  */
 export interface RelayMetadata {
   amount?: string;
+  amountAtomic?: string;
   recipient?: string;
   inputUtxoCount?: number;
   outputUtxoCount?: number;
+  x402?: boolean;
+  payerIndex?: string;
 }
 
 /**
@@ -228,6 +231,8 @@ export interface BuildWithdrawProofOptions {
   pool?: RelayPool;
   /** Optional RPC URL */
   rpcUrl?: string;
+  /** Optional relay URL */
+  relayUrl?: string;
   /**
    * Optional proving key directory/base URL or resolver.
    *

package/src/utils.ts

@@ -5,7 +5,7 @@
 
 import { ethers } from 'ethers';
 import { Buffer } from 'buffer';
-import circomlib from 'circomlib';
+import { circomlib } from './compat.js';
 
 const poseidon = circomlib.poseidon;
 
@@ -44,7 +44,9 @@ export const randomBN = (nbytes: number = 31): bigint => {
   }).crypto;
 
   if (!cryptoApi?.getRandomValues) {
-    throw new Error('Secure random number generation is unavailable in this runtime');
+    throw new Error(
+      'Secure random number generation is unavailable. Provide globalThis.crypto.getRandomValues in this runtime.'
+    );
   }
 
   const bytes = cryptoApi.getRandomValues(new Uint8Array(nbytes));

package/src/withdraw.ts

@@ -272,7 +272,7 @@ export async function buildWithdrawProof(
 export async function withdraw(
   options: BuildWithdrawProofOptions
 ): Promise<WithdrawResult> {
-  const { amount, recipient, pool = 'eth', onProgress } = options;
+  const { amount, recipient, pool = 'eth', onProgress, relayUrl } = options;
 
   // Build the proof
   const proof = await buildWithdrawProof(options);
@@ -282,6 +282,7 @@ export async function withdraw(
   const relayResult = await submitRelay({
     type: 'withdraw',
     pool,
+    relayUrl,
     proofArgs: proof.proofArgs,
     extData: proof.extData,
     metadata: {