@veil-cash/sdk 0.6.4 → 0.7.0

package/dist/index.d.cts

@@ -1,4 +1,5 @@
 import { Buffer } from 'buffer';
+import { SettleResponse, PaymentRequired, PaymentRequirements } from '@x402/core/types';
 import MerkleTree from 'fixed-merkle-tree-legacy';
 
 /**
@@ -285,9 +286,12 @@ interface RelayExtData {
  */
 interface RelayMetadata {
     amount?: string;
+    amountAtomic?: string;
     recipient?: string;
     inputUtxoCount?: number;
     outputUtxoCount?: number;
+    x402?: boolean;
+    payerIndex?: string;
 }
 /**
  * Request body for relay service
@@ -349,6 +353,8 @@ interface BuildWithdrawProofOptions {
     pool?: RelayPool;
     /** Optional RPC URL */
     rpcUrl?: string;
+    /** Optional relay URL */
+    relayUrl?: string;
     /**
      * Optional proving key directory/base URL or resolver.
      *
@@ -914,31 +920,6 @@ declare function getQueueBalance(options: {
     rpcUrl?: string;
     onProgress?: ProgressCallback;
 }): Promise<QueueBalanceResult>;
-/**
- * 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}`);
- * ```
- */
-declare function getDailyFreeRemaining(options: {
-    address: `0x${string}`;
-    pool?: RelayPool;
-    rpcUrl?: string;
-}): Promise<number>;
 /**
  * Get private balance from the Pool contract
  * Decrypts all encrypted outputs, calculates nullifiers, and checks spent status
@@ -1027,6 +1008,130 @@ declare function buildWithdrawProof(options: BuildWithdrawProofOptions): Promise
  */
 declare function withdraw(options: BuildWithdrawProofOptions): Promise<WithdrawResult>;
 
+interface PayX402ResourceOptions {
+    url: string;
+    rootPrivateKey: `0x${string}`;
+    payerIndex: bigint | number | string;
+    rpcUrl?: string;
+    relayUrl?: string;
+    /**
+     * Maximum USDC the caller will pay for this resource, as a human-readable
+     * decimal string (e.g. "0.10" or "10"). If the merchant's x402 requirement
+     * exceeds this cap, the payment is rejected before any proof is built or the
+     * payer EOA is funded. Prefer setting a tight per-request cap.
+     */
+    maxPayment?: string;
+    fetchImpl?: typeof fetch;
+    init?: RequestInit;
+    provingKeyPath?: ProvingKeyPath;
+    onProgress?: (stage: string, detail?: string) => void;
+    /**
+     * Fired immediately after the payer EOA is funded by the relay, before the
+     * x402 payment is signed and submitted. Lets callers persist a funded-state
+     * record so that funds are traceable even if a later step (signing, the second
+     * fetch, settle-header parse) fails. Best-effort: callback errors are ignored.
+     */
+    onPayerFunded?: (info: X402PayerFundedInfo) => void;
+    /**
+     * Controls funding when the derived payer EOA already holds USDC:
+     * - `true`: if the payer holds >= the required amount, skip the relay-funded
+     *   withdrawal and pay from that balance; throws if the balance is insufficient.
+     * - `'topup'`: reuse the payer, withdrawing only the shortfall (amount - balance)
+     *   when it holds less than the price. Drains stranded dust toward zero without a
+     *   fresh full withdrawal; if the payer already holds enough, funding is skipped.
+     * - `false`/undefined: always withdraw the full amount to the payer.
+     * Use reuse to retry a payment whose funding succeeded but whose delivery failed.
+     */
+    reuseExistingBalance?: boolean | 'topup';
+}
+interface X402PayerFundedInfo {
+    payerAddress: `0x${string}`;
+    payerIndex: string;
+    amount: string;
+    amountAtomic: string;
+    relayTransactionHash: string;
+    relayBlockNumber: string;
+}
+interface PayX402ResourceResult {
+    response: Response;
+    payerAddress: `0x${string}`;
+    payerIndex: string;
+    amount: string;
+    amountAtomic: string;
+    relayTransactionHash: string;
+    relayBlockNumber: string;
+    paymentResponse?: SettleResponse;
+    paymentTransactionHash?: string;
+}
+declare function usdcAtomicToDecimalString(amountAtomic: string | bigint): string;
+/**
+ * Convert a human-readable USDC amount (e.g. "10" or "0.10") to atomic units.
+ */
+declare function usdcDecimalToAtomic(amount: string): bigint;
+declare function deriveX402PayerKey(rootPrivateKey: string, index: bigint | number | string): `0x${string}`;
+declare function deriveX402PayerAddress(rootPrivateKey: string, index: bigint | number | string): `0x${string}`;
+declare function selectBaseUsdcExactRequirement(paymentRequired: PaymentRequired): PaymentRequirements;
+declare function payX402Resource(options: PayX402ResourceOptions): Promise<PayX402ResourceResult>;
+interface QuoteX402ResourceOptions {
+    url: string;
+    rpcUrl?: string;
+    /**
+     * Optional USDC spend cap (decimal string). When set, the result reports
+     * whether the merchant's price exceeds it so a caller can refuse before paying.
+     */
+    maxPayment?: string;
+    fetchImpl?: typeof fetch;
+    init?: RequestInit;
+}
+interface QuoteX402ResourceResult {
+    /** True when the endpoint returned HTTP 402 (payment required). */
+    requiresPayment: boolean;
+    /** True when the 402 offers a Veil-supported exact Base USDC requirement. */
+    supported: boolean;
+    /** Initial HTTP status from the unpaid probe. */
+    status: number;
+    amount?: string;
+    amountAtomic?: string;
+    payTo?: string;
+    network?: string;
+    asset?: string;
+    /** Set when maxPayment was supplied: true if the price exceeds the cap. */
+    exceedsMax?: boolean;
+    maxPayment?: string;
+    /** Parsed response body for a non-402 probe, so the caller can see the error. */
+    body?: unknown;
+    /** Populated when a 402 was returned but no supported requirement could be parsed. */
+    error?: string;
+}
+/**
+ * Probe an x402 resource WITHOUT funding a payer or signing a payment. Returns
+ * the price/requirement for a supported 402, or the raw response for anything
+ * else, so a caller can validate the request and confirm cost before committing
+ * a withdrawal. Note: a merchant that only validates the request body after
+ * payment will still return 402 here; this cannot catch post-payment errors.
+ */
+declare function quoteX402Resource(options: QuoteX402ResourceOptions): Promise<QuoteX402ResourceResult>;
+interface X402PayerBalance {
+    payerIndex: string;
+    payerAddress: `0x${string}`;
+    usdc: string;
+    usdcAtomic: string;
+}
+interface GetX402PayerBalancesOptions {
+    rootPrivateKey: `0x${string}`;
+    startIndex?: bigint | number | string;
+    count?: number;
+    rpcUrl?: string;
+    /** When true, only return payers that currently hold a non-zero USDC balance. */
+    nonZeroOnly?: boolean;
+}
+/**
+ * Inspect Base USDC balances held by deterministic x402 payer EOAs over an index
+ * range. Useful for surfacing dust or funds left on a payer when a payment failed
+ * after funding. This is read-only; it does not move funds or reuse payers.
+ */
+declare function getX402PayerBalances(options: GetX402PayerBalancesOptions): Promise<X402PayerBalance[]>;
+
 /**
  * Check if a recipient is registered and get their deposit key
  *
@@ -1710,18 +1815,6 @@ declare const QUEUE_ABI: readonly [{
     }];
     readonly stateMutability: "view";
     readonly type: "function";
-}, {
-    readonly inputs: readonly [{
-        readonly name: "_depositor";
-        readonly type: "address";
-    }];
-    readonly name: "getDailyFreeRemaining";
-    readonly outputs: readonly [{
-        readonly name: "remaining";
-        readonly type: "uint256";
-    }];
-    readonly stateMutability: "view";
-    readonly type: "function";
 }];
 /**
  * ETH Pool Contract ABI
@@ -2854,4 +2947,4 @@ declare function getExtDataHash(extData: ExtDataInput): bigint;
  */
 declare function shuffle<T>(array: T[]): T[];
 
-export { ADDRESSES, type BuildTransferProofOptions, type BuildWithdrawProofOptions, CIRCUIT_CONFIG, type DepositTxOptions, ENTRY_ABI, ERC20_ABI, type EncryptedMessage, type ExtData, type ExtDataInput, FIELD_SIZE, FORWARDER_ABI, FORWARDER_CONTRACT_VERSION, FORWARDER_FACTORY_ABI, Keypair, MAX_SUBACCOUNT_SLOTS, MERKLE_TREE_HEIGHT, type MessageSigner, type NetworkAddresses, POOL_ABI, POOL_CONFIG, type PendingDeposit, type PoolConfig, type PrepareTransactionParams, type PrivateBalanceResult, type ProgressCallback, type ProofArgs, type ProofBuildResult, type ProofInput, type ProveOptions, type ProvingKeyPath, QUEUE_ABI, type QueueBalanceResult, type RegisterTxOptions, RelayError, type RelayErrorResponse, type RelayExtData, type RelayMetadata, type RelayPool, type RelayProofArgs, type RelayRequest, type RelayResponse, type RelayType, type SubaccountAsset, type SubaccountAssetBalance, type SubaccountBalances, type SubaccountDeployRequest, type SubaccountMergeOptions, type SubaccountMergeResult, type SubaccountPrivateBalanceStatus, type SubaccountPrivateBalances, type SubaccountQueueStatus, type SubaccountRecoveryResult, type SubaccountRelayResult, type SubaccountSlot, type SubaccountStatusResult, type SubaccountSweepRequest, type SubaccountWithdrawTypedData, type SubmitRelayOptions, type Token, type TransactionData, type TransactionResult, type TransferResult, Utxo, type UtxoInfo, type UtxoParams, type UtxoSelectionResult, VEIL_SIGNED_MESSAGE, type WithdrawResult, buildApproveUSDCTx, buildChangeDepositKeyTx, buildDepositETHTx, buildDepositTx, buildDepositUSDCTx, buildMerkleTree, buildRegisterTx, buildSubaccountRecoveryTx, buildSubaccountWithdrawTypedData, buildTransferProof, buildWithdrawProof, checkRecipientRegistration, checkRelayHealth, deploySubaccountForwarder, deriveSubaccountChildDepositKey, deriveSubaccountChildOwner, deriveSubaccountChildPrivateKey, deriveSubaccountSalt, deriveSubaccountSlot, findNextSubaccountWithdrawNonce, getAddresses, getDailyFreeRemaining, getExtDataHash, getForwarderFactoryAddress, getMerklePath, getPoolAddress, getPrivateBalance, getQueueAddress, getQueueBalance, getRelayInfo, getRelayUrl, getSubaccountPrivateBalance, getSubaccountStatus, isSubaccountForwarderDeployed, isSubaccountWithdrawNonceUsed, mergeSubaccount, mergeUtxos, packEncryptedMessage, poseidonHash, poseidonHash2, predictSubaccountForwarder, prepareTransaction, prove, randomBN, selectCircuit, selectUtxosForWithdraw, shuffle, signSubaccountWithdraw, submitRelay, sweepSubaccountForwarder, toBuffer, toFixedHex, transfer, unpackEncryptedMessage, withdraw };
+export { ADDRESSES, type BuildTransferProofOptions, type BuildWithdrawProofOptions, CIRCUIT_CONFIG, type DepositTxOptions, ENTRY_ABI, ERC20_ABI, type EncryptedMessage, type ExtData, type ExtDataInput, FIELD_SIZE, FORWARDER_ABI, FORWARDER_CONTRACT_VERSION, FORWARDER_FACTORY_ABI, type GetX402PayerBalancesOptions, Keypair, MAX_SUBACCOUNT_SLOTS, MERKLE_TREE_HEIGHT, type MessageSigner, type NetworkAddresses, POOL_ABI, POOL_CONFIG, type PayX402ResourceOptions, type PayX402ResourceResult, type PendingDeposit, type PoolConfig, type PrepareTransactionParams, type PrivateBalanceResult, type ProgressCallback, type ProofArgs, type ProofBuildResult, type ProofInput, type ProveOptions, type ProvingKeyPath, QUEUE_ABI, type QueueBalanceResult, type QuoteX402ResourceOptions, type QuoteX402ResourceResult, type RegisterTxOptions, RelayError, type RelayErrorResponse, type RelayExtData, type RelayMetadata, type RelayPool, type RelayProofArgs, type RelayRequest, type RelayResponse, type RelayType, type SubaccountAsset, type SubaccountAssetBalance, type SubaccountBalances, type SubaccountDeployRequest, type SubaccountMergeOptions, type SubaccountMergeResult, type SubaccountPrivateBalanceStatus, type SubaccountPrivateBalances, type SubaccountQueueStatus, type SubaccountRecoveryResult, type SubaccountRelayResult, type SubaccountSlot, type SubaccountStatusResult, type SubaccountSweepRequest, type SubaccountWithdrawTypedData, type SubmitRelayOptions, type Token, type TransactionData, type TransactionResult, type TransferResult, Utxo, type UtxoInfo, type UtxoParams, type UtxoSelectionResult, VEIL_SIGNED_MESSAGE, type WithdrawResult, type X402PayerBalance, type X402PayerFundedInfo, buildApproveUSDCTx, buildChangeDepositKeyTx, buildDepositETHTx, buildDepositTx, buildDepositUSDCTx, buildMerkleTree, buildRegisterTx, buildSubaccountRecoveryTx, buildSubaccountWithdrawTypedData, buildTransferProof, buildWithdrawProof, checkRecipientRegistration, checkRelayHealth, deploySubaccountForwarder, deriveSubaccountChildDepositKey, deriveSubaccountChildOwner, deriveSubaccountChildPrivateKey, deriveSubaccountSalt, deriveSubaccountSlot, deriveX402PayerAddress, deriveX402PayerKey, findNextSubaccountWithdrawNonce, getAddresses, getExtDataHash, getForwarderFactoryAddress, getMerklePath, getPoolAddress, getPrivateBalance, getQueueAddress, getQueueBalance, getRelayInfo, getRelayUrl, getSubaccountPrivateBalance, getSubaccountStatus, getX402PayerBalances, isSubaccountForwarderDeployed, isSubaccountWithdrawNonceUsed, mergeSubaccount, mergeUtxos, packEncryptedMessage, payX402Resource, poseidonHash, poseidonHash2, predictSubaccountForwarder, prepareTransaction, prove, quoteX402Resource, randomBN, selectBaseUsdcExactRequirement, selectCircuit, selectUtxosForWithdraw, shuffle, signSubaccountWithdraw, submitRelay, sweepSubaccountForwarder, toBuffer, toFixedHex, transfer, unpackEncryptedMessage, usdcAtomicToDecimalString, usdcDecimalToAtomic, withdraw };

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import { Buffer } from 'buffer';
+import { SettleResponse, PaymentRequired, PaymentRequirements } from '@x402/core/types';
 import MerkleTree from 'fixed-merkle-tree-legacy';
 
 /**
@@ -285,9 +286,12 @@ interface RelayExtData {
  */
 interface RelayMetadata {
     amount?: string;
+    amountAtomic?: string;
     recipient?: string;
     inputUtxoCount?: number;
     outputUtxoCount?: number;
+    x402?: boolean;
+    payerIndex?: string;
 }
 /**
  * Request body for relay service
@@ -349,6 +353,8 @@ interface BuildWithdrawProofOptions {
     pool?: RelayPool;
     /** Optional RPC URL */
     rpcUrl?: string;
+    /** Optional relay URL */
+    relayUrl?: string;
     /**
      * Optional proving key directory/base URL or resolver.
      *
@@ -914,31 +920,6 @@ declare function getQueueBalance(options: {
     rpcUrl?: string;
     onProgress?: ProgressCallback;
 }): Promise<QueueBalanceResult>;
-/**
- * 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}`);
- * ```
- */
-declare function getDailyFreeRemaining(options: {
-    address: `0x${string}`;
-    pool?: RelayPool;
-    rpcUrl?: string;
-}): Promise<number>;
 /**
  * Get private balance from the Pool contract
  * Decrypts all encrypted outputs, calculates nullifiers, and checks spent status
@@ -1027,6 +1008,130 @@ declare function buildWithdrawProof(options: BuildWithdrawProofOptions): Promise
  */
 declare function withdraw(options: BuildWithdrawProofOptions): Promise<WithdrawResult>;
 
+interface PayX402ResourceOptions {
+    url: string;
+    rootPrivateKey: `0x${string}`;
+    payerIndex: bigint | number | string;
+    rpcUrl?: string;
+    relayUrl?: string;
+    /**
+     * Maximum USDC the caller will pay for this resource, as a human-readable
+     * decimal string (e.g. "0.10" or "10"). If the merchant's x402 requirement
+     * exceeds this cap, the payment is rejected before any proof is built or the
+     * payer EOA is funded. Prefer setting a tight per-request cap.
+     */
+    maxPayment?: string;
+    fetchImpl?: typeof fetch;
+    init?: RequestInit;
+    provingKeyPath?: ProvingKeyPath;
+    onProgress?: (stage: string, detail?: string) => void;
+    /**
+     * Fired immediately after the payer EOA is funded by the relay, before the
+     * x402 payment is signed and submitted. Lets callers persist a funded-state
+     * record so that funds are traceable even if a later step (signing, the second
+     * fetch, settle-header parse) fails. Best-effort: callback errors are ignored.
+     */
+    onPayerFunded?: (info: X402PayerFundedInfo) => void;
+    /**
+     * Controls funding when the derived payer EOA already holds USDC:
+     * - `true`: if the payer holds >= the required amount, skip the relay-funded
+     *   withdrawal and pay from that balance; throws if the balance is insufficient.
+     * - `'topup'`: reuse the payer, withdrawing only the shortfall (amount - balance)
+     *   when it holds less than the price. Drains stranded dust toward zero without a
+     *   fresh full withdrawal; if the payer already holds enough, funding is skipped.
+     * - `false`/undefined: always withdraw the full amount to the payer.
+     * Use reuse to retry a payment whose funding succeeded but whose delivery failed.
+     */
+    reuseExistingBalance?: boolean | 'topup';
+}
+interface X402PayerFundedInfo {
+    payerAddress: `0x${string}`;
+    payerIndex: string;
+    amount: string;
+    amountAtomic: string;
+    relayTransactionHash: string;
+    relayBlockNumber: string;
+}
+interface PayX402ResourceResult {
+    response: Response;
+    payerAddress: `0x${string}`;
+    payerIndex: string;
+    amount: string;
+    amountAtomic: string;
+    relayTransactionHash: string;
+    relayBlockNumber: string;
+    paymentResponse?: SettleResponse;
+    paymentTransactionHash?: string;
+}
+declare function usdcAtomicToDecimalString(amountAtomic: string | bigint): string;
+/**
+ * Convert a human-readable USDC amount (e.g. "10" or "0.10") to atomic units.
+ */
+declare function usdcDecimalToAtomic(amount: string): bigint;
+declare function deriveX402PayerKey(rootPrivateKey: string, index: bigint | number | string): `0x${string}`;
+declare function deriveX402PayerAddress(rootPrivateKey: string, index: bigint | number | string): `0x${string}`;
+declare function selectBaseUsdcExactRequirement(paymentRequired: PaymentRequired): PaymentRequirements;
+declare function payX402Resource(options: PayX402ResourceOptions): Promise<PayX402ResourceResult>;
+interface QuoteX402ResourceOptions {
+    url: string;
+    rpcUrl?: string;
+    /**
+     * Optional USDC spend cap (decimal string). When set, the result reports
+     * whether the merchant's price exceeds it so a caller can refuse before paying.
+     */
+    maxPayment?: string;
+    fetchImpl?: typeof fetch;
+    init?: RequestInit;
+}
+interface QuoteX402ResourceResult {
+    /** True when the endpoint returned HTTP 402 (payment required). */
+    requiresPayment: boolean;
+    /** True when the 402 offers a Veil-supported exact Base USDC requirement. */
+    supported: boolean;
+    /** Initial HTTP status from the unpaid probe. */
+    status: number;
+    amount?: string;
+    amountAtomic?: string;
+    payTo?: string;
+    network?: string;
+    asset?: string;
+    /** Set when maxPayment was supplied: true if the price exceeds the cap. */
+    exceedsMax?: boolean;
+    maxPayment?: string;
+    /** Parsed response body for a non-402 probe, so the caller can see the error. */
+    body?: unknown;
+    /** Populated when a 402 was returned but no supported requirement could be parsed. */
+    error?: string;
+}
+/**
+ * Probe an x402 resource WITHOUT funding a payer or signing a payment. Returns
+ * the price/requirement for a supported 402, or the raw response for anything
+ * else, so a caller can validate the request and confirm cost before committing
+ * a withdrawal. Note: a merchant that only validates the request body after
+ * payment will still return 402 here; this cannot catch post-payment errors.
+ */
+declare function quoteX402Resource(options: QuoteX402ResourceOptions): Promise<QuoteX402ResourceResult>;
+interface X402PayerBalance {
+    payerIndex: string;
+    payerAddress: `0x${string}`;
+    usdc: string;
+    usdcAtomic: string;
+}
+interface GetX402PayerBalancesOptions {
+    rootPrivateKey: `0x${string}`;
+    startIndex?: bigint | number | string;
+    count?: number;
+    rpcUrl?: string;
+    /** When true, only return payers that currently hold a non-zero USDC balance. */
+    nonZeroOnly?: boolean;
+}
+/**
+ * Inspect Base USDC balances held by deterministic x402 payer EOAs over an index
+ * range. Useful for surfacing dust or funds left on a payer when a payment failed
+ * after funding. This is read-only; it does not move funds or reuse payers.
+ */
+declare function getX402PayerBalances(options: GetX402PayerBalancesOptions): Promise<X402PayerBalance[]>;
+
 /**
  * Check if a recipient is registered and get their deposit key
  *
@@ -1710,18 +1815,6 @@ declare const QUEUE_ABI: readonly [{
     }];
     readonly stateMutability: "view";
     readonly type: "function";
-}, {
-    readonly inputs: readonly [{
-        readonly name: "_depositor";
-        readonly type: "address";
-    }];
-    readonly name: "getDailyFreeRemaining";
-    readonly outputs: readonly [{
-        readonly name: "remaining";
-        readonly type: "uint256";
-    }];
-    readonly stateMutability: "view";
-    readonly type: "function";
 }];
 /**
  * ETH Pool Contract ABI
@@ -2854,4 +2947,4 @@ declare function getExtDataHash(extData: ExtDataInput): bigint;
  */
 declare function shuffle<T>(array: T[]): T[];
 
-export { ADDRESSES, type BuildTransferProofOptions, type BuildWithdrawProofOptions, CIRCUIT_CONFIG, type DepositTxOptions, ENTRY_ABI, ERC20_ABI, type EncryptedMessage, type ExtData, type ExtDataInput, FIELD_SIZE, FORWARDER_ABI, FORWARDER_CONTRACT_VERSION, FORWARDER_FACTORY_ABI, Keypair, MAX_SUBACCOUNT_SLOTS, MERKLE_TREE_HEIGHT, type MessageSigner, type NetworkAddresses, POOL_ABI, POOL_CONFIG, type PendingDeposit, type PoolConfig, type PrepareTransactionParams, type PrivateBalanceResult, type ProgressCallback, type ProofArgs, type ProofBuildResult, type ProofInput, type ProveOptions, type ProvingKeyPath, QUEUE_ABI, type QueueBalanceResult, type RegisterTxOptions, RelayError, type RelayErrorResponse, type RelayExtData, type RelayMetadata, type RelayPool, type RelayProofArgs, type RelayRequest, type RelayResponse, type RelayType, type SubaccountAsset, type SubaccountAssetBalance, type SubaccountBalances, type SubaccountDeployRequest, type SubaccountMergeOptions, type SubaccountMergeResult, type SubaccountPrivateBalanceStatus, type SubaccountPrivateBalances, type SubaccountQueueStatus, type SubaccountRecoveryResult, type SubaccountRelayResult, type SubaccountSlot, type SubaccountStatusResult, type SubaccountSweepRequest, type SubaccountWithdrawTypedData, type SubmitRelayOptions, type Token, type TransactionData, type TransactionResult, type TransferResult, Utxo, type UtxoInfo, type UtxoParams, type UtxoSelectionResult, VEIL_SIGNED_MESSAGE, type WithdrawResult, buildApproveUSDCTx, buildChangeDepositKeyTx, buildDepositETHTx, buildDepositTx, buildDepositUSDCTx, buildMerkleTree, buildRegisterTx, buildSubaccountRecoveryTx, buildSubaccountWithdrawTypedData, buildTransferProof, buildWithdrawProof, checkRecipientRegistration, checkRelayHealth, deploySubaccountForwarder, deriveSubaccountChildDepositKey, deriveSubaccountChildOwner, deriveSubaccountChildPrivateKey, deriveSubaccountSalt, deriveSubaccountSlot, findNextSubaccountWithdrawNonce, getAddresses, getDailyFreeRemaining, getExtDataHash, getForwarderFactoryAddress, getMerklePath, getPoolAddress, getPrivateBalance, getQueueAddress, getQueueBalance, getRelayInfo, getRelayUrl, getSubaccountPrivateBalance, getSubaccountStatus, isSubaccountForwarderDeployed, isSubaccountWithdrawNonceUsed, mergeSubaccount, mergeUtxos, packEncryptedMessage, poseidonHash, poseidonHash2, predictSubaccountForwarder, prepareTransaction, prove, randomBN, selectCircuit, selectUtxosForWithdraw, shuffle, signSubaccountWithdraw, submitRelay, sweepSubaccountForwarder, toBuffer, toFixedHex, transfer, unpackEncryptedMessage, withdraw };
+export { ADDRESSES, type BuildTransferProofOptions, type BuildWithdrawProofOptions, CIRCUIT_CONFIG, type DepositTxOptions, ENTRY_ABI, ERC20_ABI, type EncryptedMessage, type ExtData, type ExtDataInput, FIELD_SIZE, FORWARDER_ABI, FORWARDER_CONTRACT_VERSION, FORWARDER_FACTORY_ABI, type GetX402PayerBalancesOptions, Keypair, MAX_SUBACCOUNT_SLOTS, MERKLE_TREE_HEIGHT, type MessageSigner, type NetworkAddresses, POOL_ABI, POOL_CONFIG, type PayX402ResourceOptions, type PayX402ResourceResult, type PendingDeposit, type PoolConfig, type PrepareTransactionParams, type PrivateBalanceResult, type ProgressCallback, type ProofArgs, type ProofBuildResult, type ProofInput, type ProveOptions, type ProvingKeyPath, QUEUE_ABI, type QueueBalanceResult, type QuoteX402ResourceOptions, type QuoteX402ResourceResult, type RegisterTxOptions, RelayError, type RelayErrorResponse, type RelayExtData, type RelayMetadata, type RelayPool, type RelayProofArgs, type RelayRequest, type RelayResponse, type RelayType, type SubaccountAsset, type SubaccountAssetBalance, type SubaccountBalances, type SubaccountDeployRequest, type SubaccountMergeOptions, type SubaccountMergeResult, type SubaccountPrivateBalanceStatus, type SubaccountPrivateBalances, type SubaccountQueueStatus, type SubaccountRecoveryResult, type SubaccountRelayResult, type SubaccountSlot, type SubaccountStatusResult, type SubaccountSweepRequest, type SubaccountWithdrawTypedData, type SubmitRelayOptions, type Token, type TransactionData, type TransactionResult, type TransferResult, Utxo, type UtxoInfo, type UtxoParams, type UtxoSelectionResult, VEIL_SIGNED_MESSAGE, type WithdrawResult, type X402PayerBalance, type X402PayerFundedInfo, buildApproveUSDCTx, buildChangeDepositKeyTx, buildDepositETHTx, buildDepositTx, buildDepositUSDCTx, buildMerkleTree, buildRegisterTx, buildSubaccountRecoveryTx, buildSubaccountWithdrawTypedData, buildTransferProof, buildWithdrawProof, checkRecipientRegistration, checkRelayHealth, deploySubaccountForwarder, deriveSubaccountChildDepositKey, deriveSubaccountChildOwner, deriveSubaccountChildPrivateKey, deriveSubaccountSalt, deriveSubaccountSlot, deriveX402PayerAddress, deriveX402PayerKey, findNextSubaccountWithdrawNonce, getAddresses, getExtDataHash, getForwarderFactoryAddress, getMerklePath, getPoolAddress, getPrivateBalance, getQueueAddress, getQueueBalance, getRelayInfo, getRelayUrl, getSubaccountPrivateBalance, getSubaccountStatus, getX402PayerBalances, isSubaccountForwarderDeployed, isSubaccountWithdrawNonceUsed, mergeSubaccount, mergeUtxos, packEncryptedMessage, payX402Resource, poseidonHash, poseidonHash2, predictSubaccountForwarder, prepareTransaction, prove, quoteX402Resource, randomBN, selectBaseUsdcExactRequirement, selectCircuit, selectUtxosForWithdraw, shuffle, signSubaccountWithdraw, submitRelay, sweepSubaccountForwarder, toBuffer, toFixedHex, transfer, unpackEncryptedMessage, usdcAtomicToDecimalString, usdcDecimalToAtomic, withdraw };