warptoad-v1

The next itteration of the PoC here https://github.com/warptoad/warp-toad
Build in noir but with a potential circom rewrite in mind, with no proof recursion.

Some of the new privacy features are:

• swaptoad: shielded swaps
• nulltoad: makes commitments spendable on pending roots
• swaptoad

New techincal features:

• nft support (1155/721):
• modular wrappers:
• permissionless gigabridge:
• jubjub signature

Contracts

pnpm install
pnpm compile   # hardhat compile
pnpm test      # hardhat test
pnpm size      # contract size report

Deploy + verify on Sepolia

Secrets go in the hardhat keystore once (plain env vars with the same names also work):

npx hardhat keystore set SEPOLIA_RPC_URL
npx hardhat keystore set SEPOLIA_PRIVATE_KEY
npx hardhat keystore set ETHERSCAN_API_KEY

deploy with ignition

pnpm deploy:sepolia   # ignition deploy + etherscan verify

Constructor args are in: ignition/parameters/sepolia.json. For other chains you need to copy paste from: src/config.ts, this is a limitation of hardhat ignition

Wrapper tokens are deployed by WrapperFactory on first wrap, so they might not be automatically verified. In case you need one verified do:

pnpm verify:wrapper:sepolia 0xfc632092084235675bebe56263976397959a0ff7

Run test on sepolia

pnpm hardhat run test/ClaudeLilMessaging.test.ts --network sepolia

Circuits

Install Noir

curl -L https://raw.githubusercontent.com/noir-lang/noirup/main/install | bash
noirup -v 1.0.0-beta.22

curl -L https://raw.githubusercontent.com/AztecProtocol/aztec-packages/refs/heads/next/barretenberg/bbup/install | bash
bbup    # picks the bb release matching your nargo

source ~/.bashrc
nargo --version   # 1.0.0-beta.22
bb --version      # 5.0.0-nightly.20260522

Use beta.22: newer nargo compiles fine, but bbup's version map has no bb for anything past it.

Build

pnpm noir;
pnpm hardhat compile;

aztec-nargo conflicts

Aztec ships its own nargo and puts it ahead of yours, so nargo --version shows a version you never installed (which -a nargo shows who wins). We don't use Aztec here — remove it, then reinstall Noir:

sudo rm -f /usr/local/bin/nargo /usr/local/bin/aztec
rm -rf ~/.aztec

Gas

pnpm hardhat test test/ClaudeLilMessaging.test.ts --gas-stats, CIRCUIT_SIZE 4:

	gas
WarptoadVerifier.verify on its own (8.7 KB proof, 30 public inputs)	~875k, ~150k of that is calldata
verifyShieldedTx (1 spend, 1 unshield, 3 tree inserts)	~1.37M
shieldErc20	~211k
wrapERC20 first time (deploys the wrapper)	~756k
deploy Warptoad / WarptoadVerifier	5.5M / 3.6M

deployments

warptoad: 0x49A549C7aC6A79567240e39870B509005d18b5b6
wrapperFactory: 0x1aa30A44d55ff4126F9d316e8d2E91BF8202fC3A
verifier: 0x372324B18395C52995E93Baf9592EC7910A92436
chainConfig: 0x8E0EDF630b3E51d97f21A526d778c5A075D86afc
skinnyIMTPoseidon2WriteStorage: 0x00000066C760D24272a9E8A424EF7233A0F0da83