Skip to main content
The Tornado Nova JavaScript SDK provides a complete toolkit for building privacy-preserving applications on Ethereum. It enables developers to create shielded transactions using zero-knowledge proofs.

​
Core components

The SDK consists of several key modules:
  • Utxo - Unspent transaction output management
  • Keypair - Key generation and cryptographic operations
  • Prover - Zero-knowledge proof generation
  • Transaction functions - Build and submit transactions

​
Installation

Clone the repository and install dependencies: 
git clone https://github.com/tornadocash/tornado-nova.git
cd tornado-nova
yarn install

​
Quick start

Here’s a basic example of creating a deposit transaction: 
const { Utxo, Keypair, transaction } = require('./src/index')
const { ethers } = require('hardhat')

// Create a keypair
const keypair = new Keypair()

// Create a UTXO with amount
const outputUtxo = new Utxo({
  amount: ethers.utils.parseEther('1.0'),
  keypair: keypair
})

// Execute transaction
const receipt = await transaction({
  tornadoPool: tornadoPoolContract,
  outputs: [outputUtxo],
  fee: 0,
  recipient: '0x0000000000000000000000000000000000000000',
  relayer: '0x0000000000000000000000000000000000000000'
})

​
Key features

​
Privacy by default

All transactions use zero-knowledge proofs to hide sender, recipient, and amount information on-chain.

​
UTXO model

The SDK implements a UTXO-based system similar to Bitcoin, where each transaction consumes inputs and creates outputs.

​
Encrypted data

UTXO data is encrypted using the recipient’s public key, ensuring only they can access transaction details.

​
Merkle tree tracking

The SDK automatically builds and maintains Merkle trees of commitments for proof generation.

​
Architecture

The SDK follows this transaction flow:
  1. Create input and output UTXOs
  2. Build Merkle tree from on-chain commitments
  3. Generate zero-knowledge proof
  4. Submit transaction to TornadoPool contract

​
Next steps

Utxo class

Learn about UTXO creation and management

Keypair class

Generate keys and handle encryption

Proof generation

Create zero-knowledge proofs

Transactions

Build and submit transactions

Build docs developers (and LLMs) love

Get started for freeTalk to us