@hula-privacy/mixer 0.5.0 → 1.0.0

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { PublicKey, TransactionInstruction, Keypair, Connection } from '@solana/web3.js';
+import { PublicKey, TransactionInstruction, Keypair, Connection, Transaction, VersionedTransaction } from '@solana/web3.js';
 import { BN, Program } from '@coral-xyz/anchor';
 import { Poseidon } from 'circomlibjs';
 
@@ -341,6 +341,18 @@ declare function toAnchorPublicInputs(builtTx: BuiltTransaction): {
  * High-level wallet abstraction that manages keys, UTXOs, and syncing
  */
 
+/**
+ * Minimal wallet interface compatible with both Keypair and wallet adapters
+ */
+interface WalletAdapter {
+    publicKey: PublicKey;
+    signTransaction<T extends Transaction | VersionedTransaction>(tx: T): Promise<T>;
+    signAllTransactions<T extends Transaction | VersionedTransaction>(txs: T[]): Promise<T[]>;
+}
+/**
+ * Create a wallet adapter from a Keypair (for Node.js/CLI usage)
+ */
+declare function createKeypairWalletAdapter(keypair: Keypair): WalletAdapter;
 /**
  * Hula Privacy Wallet
  *
@@ -351,7 +363,7 @@ declare class HulaWallet {
     private relayerUrl;
     private programId;
     private keys;
-    private signer?;
+    private walletAdapter?;
     private utxos;
     private lastSyncedSlot;
     private initialized;
@@ -405,13 +417,17 @@ declare class HulaWallet {
      */
     getConnection(): Connection;
     /**
-     * Get the signer keypair (if available)
+     * Get the wallet adapter (if available)
      */
-    getSigner(): Keypair | undefined;
+    getWalletAdapter(): WalletAdapter | undefined;
     /**
-     * Set the signer keypair
+     * Set the wallet adapter (for browser usage with Phantom etc.)
      */
-    setSigner(signer: Keypair): void;
+    setWalletAdapter(adapter: WalletAdapter): void;
+    /**
+     * Get the program ID
+     */
+    getProgramId(): PublicKey;
     /**
      * Sync wallet with relayer
      *
@@ -438,6 +454,10 @@ declare class HulaWallet {
      * Export UTXOs for backup
      */
     exportUTXOs(): SerializableUTXO[];
+    /**
+     * Build and submit a transaction using the wallet adapter
+     */
+    private submitTransactionWithAdapter;
     /**
      * Deposit tokens into the privacy pool
      *
@@ -766,6 +786,7 @@ declare function scanNotesForUTXOs(notes: Array<{
 declare function syncUTXOs(walletKeys: WalletKeys, existingUTXOs: SerializableUTXO[], relayerUrl?: string, afterSlot?: string): Promise<{
     newUTXOs: SerializableUTXO[];
     spentUTXOs: string[];
+    lastSlot: string | null;
 }>;
 /**
  * Select UTXOs for spending (greedy algorithm)
@@ -835,22 +856,26 @@ declare function getCurrentTreeIndex(relayerUrl?: string): Promise<number>;
 /**
  * ZK Proof generation utilities
  *
- * Uses snarkjs to generate Groth16 proofs for the transaction circuit
+ * Uses snarkjs to generate Groth16 proofs for the transaction circuit.
+ * Supports both browser (using URLs) and Node.js (using file paths) environments.
  */
 
 /**
- * Set circuit file paths
+ * Set circuit file paths (Node.js) or URLs (browser)
+ *
+ * In browser: use URLs like "/circuits/transaction.wasm"
+ * In Node.js: use file paths like "/path/to/transaction.wasm"
  */
 declare function setCircuitPaths(wasmPath: string, zkeyPath: string): void;
 /**
- * Get circuit file paths (with fallback to default locations)
+ * Get circuit file paths/URLs
  */
 declare function getCircuitPaths(): {
     wasmPath: string;
     zkeyPath: string;
 };
 /**
- * Verify circuit files exist
+ * Verify circuit files exist (only works in Node.js)
  */
 declare function verifyCircuitFiles(): void;
 /**
@@ -864,19 +889,19 @@ declare function parseProof(proofJson: {
     pi_c: string[];
 }): Uint8Array;
 /**
- * Generate ZK proof using snarkjs CLI (subprocess for Bun compatibility)
+ * Generate ZK proof using snarkjs
  *
- * This spawns snarkjs as a subprocess to avoid web-worker issues with Bun.
- * Works in both Node.js and Bun environments.
+ * Works in both browser and Node.js environments:
+ * - Browser: loads WASM and zkey from URLs, generates proof in-memory
+ * - Node.js: uses file paths for WASM and zkey
  */
 declare function generateProof(circuitInputs: CircuitInputs): Promise<{
     proof: Uint8Array;
     publicSignals: string[];
 }>;
 /**
- * Generate proof using snarkjs in-memory (for Node.js environments)
- *
- * This is more efficient but may not work in all environments.
+ * Generate proof using snarkjs in-memory
+ * Alias for generateProof for backwards compatibility
  */
 declare function generateProofInMemory(circuitInputs: CircuitInputs): Promise<{
     proof: Uint8Array;
@@ -928,4 +953,4 @@ declare function getVaultPDA(mint: PublicKey): [PublicKey, number];
  */
 declare function getNullifierPDA(nullifier: Uint8Array): [PublicKey, number];
 
-export { type BuiltTransaction, type CircuitInputs, DOMAIN_ENCRYPTION, DOMAIN_NULLIFIER, DOMAIN_OWNER, DOMAIN_VIEWING, type EncryptedNote, FIELD_PRIME, type HulaSDKConfig, HulaWallet, type LeafData, MAX_LEAVES, MERKLE_TREE_DEPTH, MERKLE_TREE_SEED, type MerklePath, NULLIFIER_SEED, NUM_INPUT_UTXOS, NUM_OUTPUT_UTXOS, type NoteData, type OutputSpec, POOL_SEED, PROGRAM_ID, PROOF_SIZE, type PaginatedResponse, type PoolData, type PublicInputs, RelayerClient, type SerializableUTXO, type StatsData, type SyncProgress, type SyncResult, TOKEN_2022_PROGRAM_ID, type TransactionData, type TransactionRequest, type TreeData, type UTXO, VAULT_SEED, type WalletKeys, bigIntToBytes, bigIntToBytes32, buildTransaction, buildTransactionAccounts, bytesToBigInt, bytesToHex, calculateBalance, computeCommitment, computeMerklePathFromLeaves, computeMerkleRoot, computeNullifier, computeNullifierFromKeys, computeZeros, createDummyUTXO, createUTXO, decryptNote, deriveKeys, deriveSpendingKeyFromSignature, deserializeEncryptedNote, deserializeUTXO, encryptNote, fetchMerklePath, fetchMerkleRoot, formatCommitment, generateProof, generateProofInMemory, generateSpendingKey, getCircuitPaths, getCurrentTreeIndex, getEmptyTreeRoot, getKeyDerivationMessage, getMerkleTreePDA, getNextLeafIndex, getNullifierPDA, getPoolPDA, getPoseidon, getRelayerClient, getVaultPDA, getZeroAtLevel, hexToBytes, initHulaSDK, initPoseidon, isPoseidonInitialized, parseProof, poseidonHash, pubkeyToBigInt, scanNotesForUTXOs, selectUTXOs, serializeEncryptedNote, serializeUTXO, setCircuitPaths, setDefaultRelayerUrl, syncUTXOs, toAnchorPublicInputs, verifyCircuitFiles, verifyMerklePath };
+export { type BuiltTransaction, type CircuitInputs, DOMAIN_ENCRYPTION, DOMAIN_NULLIFIER, DOMAIN_OWNER, DOMAIN_VIEWING, type EncryptedNote, FIELD_PRIME, type HulaSDKConfig, HulaWallet, type LeafData, MAX_LEAVES, MERKLE_TREE_DEPTH, MERKLE_TREE_SEED, type MerklePath, NULLIFIER_SEED, NUM_INPUT_UTXOS, NUM_OUTPUT_UTXOS, type NoteData, type OutputSpec, POOL_SEED, PROGRAM_ID, PROOF_SIZE, type PaginatedResponse, type PoolData, type PublicInputs, RelayerClient, type SerializableUTXO, type StatsData, type SyncProgress, type SyncResult, TOKEN_2022_PROGRAM_ID, type TransactionData, type TransactionRequest, type TreeData, type UTXO, VAULT_SEED, type WalletAdapter, type WalletKeys, bigIntToBytes, bigIntToBytes32, buildTransaction, buildTransactionAccounts, bytesToBigInt, bytesToHex, calculateBalance, computeCommitment, computeMerklePathFromLeaves, computeMerkleRoot, computeNullifier, computeNullifierFromKeys, computeZeros, createDummyUTXO, createKeypairWalletAdapter, createUTXO, decryptNote, deriveKeys, deriveSpendingKeyFromSignature, deserializeEncryptedNote, deserializeUTXO, encryptNote, fetchMerklePath, fetchMerkleRoot, formatCommitment, generateProof, generateProofInMemory, generateSpendingKey, getCircuitPaths, getCurrentTreeIndex, getEmptyTreeRoot, getKeyDerivationMessage, getMerkleTreePDA, getNextLeafIndex, getNullifierPDA, getPoolPDA, getPoseidon, getRelayerClient, getVaultPDA, getZeroAtLevel, hexToBytes, initHulaSDK, initPoseidon, isPoseidonInitialized, parseProof, poseidonHash, pubkeyToBigInt, scanNotesForUTXOs, selectUTXOs, serializeEncryptedNote, serializeUTXO, setCircuitPaths, setDefaultRelayerUrl, syncUTXOs, toAnchorPublicInputs, verifyCircuitFiles, verifyMerklePath };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { PublicKey, TransactionInstruction, Keypair, Connection } from '@solana/web3.js';
+import { PublicKey, TransactionInstruction, Keypair, Connection, Transaction, VersionedTransaction } from '@solana/web3.js';
 import { BN, Program } from '@coral-xyz/anchor';
 import { Poseidon } from 'circomlibjs';
 
@@ -341,6 +341,18 @@ declare function toAnchorPublicInputs(builtTx: BuiltTransaction): {
  * High-level wallet abstraction that manages keys, UTXOs, and syncing
  */
 
+/**
+ * Minimal wallet interface compatible with both Keypair and wallet adapters
+ */
+interface WalletAdapter {
+    publicKey: PublicKey;
+    signTransaction<T extends Transaction | VersionedTransaction>(tx: T): Promise<T>;
+    signAllTransactions<T extends Transaction | VersionedTransaction>(txs: T[]): Promise<T[]>;
+}
+/**
+ * Create a wallet adapter from a Keypair (for Node.js/CLI usage)
+ */
+declare function createKeypairWalletAdapter(keypair: Keypair): WalletAdapter;
 /**
  * Hula Privacy Wallet
  *
@@ -351,7 +363,7 @@ declare class HulaWallet {
     private relayerUrl;
     private programId;
     private keys;
-    private signer?;
+    private walletAdapter?;
     private utxos;
     private lastSyncedSlot;
     private initialized;
@@ -405,13 +417,17 @@ declare class HulaWallet {
      */
     getConnection(): Connection;
     /**
-     * Get the signer keypair (if available)
+     * Get the wallet adapter (if available)
      */
-    getSigner(): Keypair | undefined;
+    getWalletAdapter(): WalletAdapter | undefined;
     /**
-     * Set the signer keypair
+     * Set the wallet adapter (for browser usage with Phantom etc.)
      */
-    setSigner(signer: Keypair): void;
+    setWalletAdapter(adapter: WalletAdapter): void;
+    /**
+     * Get the program ID
+     */
+    getProgramId(): PublicKey;
     /**
      * Sync wallet with relayer
      *
@@ -438,6 +454,10 @@ declare class HulaWallet {
      * Export UTXOs for backup
      */
     exportUTXOs(): SerializableUTXO[];
+    /**
+     * Build and submit a transaction using the wallet adapter
+     */
+    private submitTransactionWithAdapter;
     /**
      * Deposit tokens into the privacy pool
      *
@@ -766,6 +786,7 @@ declare function scanNotesForUTXOs(notes: Array<{
 declare function syncUTXOs(walletKeys: WalletKeys, existingUTXOs: SerializableUTXO[], relayerUrl?: string, afterSlot?: string): Promise<{
     newUTXOs: SerializableUTXO[];
     spentUTXOs: string[];
+    lastSlot: string | null;
 }>;
 /**
  * Select UTXOs for spending (greedy algorithm)
@@ -835,22 +856,26 @@ declare function getCurrentTreeIndex(relayerUrl?: string): Promise<number>;
 /**
  * ZK Proof generation utilities
  *
- * Uses snarkjs to generate Groth16 proofs for the transaction circuit
+ * Uses snarkjs to generate Groth16 proofs for the transaction circuit.
+ * Supports both browser (using URLs) and Node.js (using file paths) environments.
  */
 
 /**
- * Set circuit file paths
+ * Set circuit file paths (Node.js) or URLs (browser)
+ *
+ * In browser: use URLs like "/circuits/transaction.wasm"
+ * In Node.js: use file paths like "/path/to/transaction.wasm"
  */
 declare function setCircuitPaths(wasmPath: string, zkeyPath: string): void;
 /**
- * Get circuit file paths (with fallback to default locations)
+ * Get circuit file paths/URLs
  */
 declare function getCircuitPaths(): {
     wasmPath: string;
     zkeyPath: string;
 };
 /**
- * Verify circuit files exist
+ * Verify circuit files exist (only works in Node.js)
  */
 declare function verifyCircuitFiles(): void;
 /**
@@ -864,19 +889,19 @@ declare function parseProof(proofJson: {
     pi_c: string[];
 }): Uint8Array;
 /**
- * Generate ZK proof using snarkjs CLI (subprocess for Bun compatibility)
+ * Generate ZK proof using snarkjs
  *
- * This spawns snarkjs as a subprocess to avoid web-worker issues with Bun.
- * Works in both Node.js and Bun environments.
+ * Works in both browser and Node.js environments:
+ * - Browser: loads WASM and zkey from URLs, generates proof in-memory
+ * - Node.js: uses file paths for WASM and zkey
  */
 declare function generateProof(circuitInputs: CircuitInputs): Promise<{
     proof: Uint8Array;
     publicSignals: string[];
 }>;
 /**
- * Generate proof using snarkjs in-memory (for Node.js environments)
- *
- * This is more efficient but may not work in all environments.
+ * Generate proof using snarkjs in-memory
+ * Alias for generateProof for backwards compatibility
  */
 declare function generateProofInMemory(circuitInputs: CircuitInputs): Promise<{
     proof: Uint8Array;
@@ -928,4 +953,4 @@ declare function getVaultPDA(mint: PublicKey): [PublicKey, number];
  */
 declare function getNullifierPDA(nullifier: Uint8Array): [PublicKey, number];
 
-export { type BuiltTransaction, type CircuitInputs, DOMAIN_ENCRYPTION, DOMAIN_NULLIFIER, DOMAIN_OWNER, DOMAIN_VIEWING, type EncryptedNote, FIELD_PRIME, type HulaSDKConfig, HulaWallet, type LeafData, MAX_LEAVES, MERKLE_TREE_DEPTH, MERKLE_TREE_SEED, type MerklePath, NULLIFIER_SEED, NUM_INPUT_UTXOS, NUM_OUTPUT_UTXOS, type NoteData, type OutputSpec, POOL_SEED, PROGRAM_ID, PROOF_SIZE, type PaginatedResponse, type PoolData, type PublicInputs, RelayerClient, type SerializableUTXO, type StatsData, type SyncProgress, type SyncResult, TOKEN_2022_PROGRAM_ID, type TransactionData, type TransactionRequest, type TreeData, type UTXO, VAULT_SEED, type WalletKeys, bigIntToBytes, bigIntToBytes32, buildTransaction, buildTransactionAccounts, bytesToBigInt, bytesToHex, calculateBalance, computeCommitment, computeMerklePathFromLeaves, computeMerkleRoot, computeNullifier, computeNullifierFromKeys, computeZeros, createDummyUTXO, createUTXO, decryptNote, deriveKeys, deriveSpendingKeyFromSignature, deserializeEncryptedNote, deserializeUTXO, encryptNote, fetchMerklePath, fetchMerkleRoot, formatCommitment, generateProof, generateProofInMemory, generateSpendingKey, getCircuitPaths, getCurrentTreeIndex, getEmptyTreeRoot, getKeyDerivationMessage, getMerkleTreePDA, getNextLeafIndex, getNullifierPDA, getPoolPDA, getPoseidon, getRelayerClient, getVaultPDA, getZeroAtLevel, hexToBytes, initHulaSDK, initPoseidon, isPoseidonInitialized, parseProof, poseidonHash, pubkeyToBigInt, scanNotesForUTXOs, selectUTXOs, serializeEncryptedNote, serializeUTXO, setCircuitPaths, setDefaultRelayerUrl, syncUTXOs, toAnchorPublicInputs, verifyCircuitFiles, verifyMerklePath };
+export { type BuiltTransaction, type CircuitInputs, DOMAIN_ENCRYPTION, DOMAIN_NULLIFIER, DOMAIN_OWNER, DOMAIN_VIEWING, type EncryptedNote, FIELD_PRIME, type HulaSDKConfig, HulaWallet, type LeafData, MAX_LEAVES, MERKLE_TREE_DEPTH, MERKLE_TREE_SEED, type MerklePath, NULLIFIER_SEED, NUM_INPUT_UTXOS, NUM_OUTPUT_UTXOS, type NoteData, type OutputSpec, POOL_SEED, PROGRAM_ID, PROOF_SIZE, type PaginatedResponse, type PoolData, type PublicInputs, RelayerClient, type SerializableUTXO, type StatsData, type SyncProgress, type SyncResult, TOKEN_2022_PROGRAM_ID, type TransactionData, type TransactionRequest, type TreeData, type UTXO, VAULT_SEED, type WalletAdapter, type WalletKeys, bigIntToBytes, bigIntToBytes32, buildTransaction, buildTransactionAccounts, bytesToBigInt, bytesToHex, calculateBalance, computeCommitment, computeMerklePathFromLeaves, computeMerkleRoot, computeNullifier, computeNullifierFromKeys, computeZeros, createDummyUTXO, createKeypairWalletAdapter, createUTXO, decryptNote, deriveKeys, deriveSpendingKeyFromSignature, deserializeEncryptedNote, deserializeUTXO, encryptNote, fetchMerklePath, fetchMerkleRoot, formatCommitment, generateProof, generateProofInMemory, generateSpendingKey, getCircuitPaths, getCurrentTreeIndex, getEmptyTreeRoot, getKeyDerivationMessage, getMerkleTreePDA, getNextLeafIndex, getNullifierPDA, getPoolPDA, getPoseidon, getRelayerClient, getVaultPDA, getZeroAtLevel, hexToBytes, initHulaSDK, initPoseidon, isPoseidonInitialized, parseProof, poseidonHash, pubkeyToBigInt, scanNotesForUTXOs, selectUTXOs, serializeEncryptedNote, serializeUTXO, setCircuitPaths, setDefaultRelayerUrl, syncUTXOs, toAnchorPublicInputs, verifyCircuitFiles, verifyMerklePath };