feat: upgrade to 4.2.0-aztecnr-rc.2 + testnet deployment + smart swap routing

[alejoamiras]

Summary

Upgrade from 4.0.0-devnet.2 → 4.2.0-aztecnr-rc.2 targeting Aztec testnet (rpc.testnet.aztec-labs.com). Includes everything from PR #10 (wallet-sdk, Uniswap V4 fuel swap, Permit2) plus the full version upgrade, testnet deployment, and smart swap routing.

What's new since PR #10

Aztec 4.2.0-aztecnr-rc.2 Upgrade

• All @aztec/* packages upgraded from 4.0.0-devnet.2 → 4.2.0-aztecnr-rc.2
• Wonderland standards (prerelease-1ad0e28) and fee-payment (prerelease-07982ed) updated
• Noir contracts compiled with v4.2.0-aztecnr-rc.2 aztec-nr
• Transaction API migration: .send() → { receipt }, .simulate() → { result }, deploy → { contract }
• computeL2ToL1MembershipWitness updated to new (node, msgLeaf, txHash) signature
• getL1ToL2MessageBlock → getL1ToL2MessageCheckpoint
• Account deployment uses NO_FROM pattern (workaround for PXE entrypoint simulation issue)

Smart Swap Routing

• buildCandidateRoutes() generates multiple candidate routes per token
• getBestRoute() quotes all candidates in parallel via V4 Quoter, picks highest output
• Supports both direct (1-hop) and via-WETH (2-hop) routes
• Non-existent pools gracefully fail and are skipped
• Direct USDC/FeeJuice pool on testnet for cheaper fuel swaps

Deployment Pipeline Integration

• Renamed devnet → testnet (scripts, configs, file names)
• UniswapFuelSwap + SwapBridgeRouter deployment integrated into main deploy script
• Trusted forwarder auto-set on all portals after token deployment
• BridgedFPC address auto-computed and saved to deployment JSON
• Single command: AZTEC_ENV=testnet pnpm run deploy-testnet:compliant
• Pool seeding remains a separate forge script step (requires Solidity callback)

Cleanup

• Removed BridgeAndFuel/MockFuelSwap (replaced by SwapBridgeRouter)
• Removed old devnet deployment files and config
• Removed stale deployments from version selector
• registerBridgedContract updated for new salt parameter
• Allowance check uses publicClient instead of WAAP eth_call

Tested on testnet ✅

Flow	Status	Notes
Public bridge (L1→L2)	✅ Working	Via SwapBridgeRouter with Permit2
L1→L2 + public fuel swap	✅ Working	Smart routing picks best path
L1→L2 + private fuel (BridgedFPC)	✅ Working	skipFeeEnforcement required for PXE sync lag
L2→L1 withdrawal	Ready	Both public and private paths
Wallet-SDK connection	✅ Working	Discovery + emoji verification
Multi-token support	✅ Working	7 tokens deployed (USDC, USDT, DAI, HUMN, GOAT, WBTC, WETH)
Smart swap routing	✅ Working	Direct USDC/FJ pool wins over multi-hop

Known Issues

• SponsoredFPC PXE bug: The wallet's PXE can't simulate FeeJuice.claim during fee payment setup because its L1→L2 message tree lags behind the sequencer. Workaround: skipFeeEnforcement: true on claim transactions.
• BridgedFPC no-refund: The FPC deducts ~32 FJ max gas cost upfront but actual fee is ~3.76 FJ. No refund mechanism — Wonderland design tradeoff.
• L2 SBT minting: Still a stub (useL2MintSoulboundToken does nothing). L1 SBT works.
• Pool seeding: Not integrated into the TS deploy script (requires Solidity unlockCallback). Run SeedUniswapPools.s.sol separately.

Deployment

# 1. Deploy everything (tokens + fuel infra + forwarders)
AZTEC_ENV=testnet pnpm run deploy-testnet:compliant

# 2. Seed Uniswap V4 pools (separate step)
cd l1-contracts
source .env
# ETH/AZTEC + USDC/WETH + USDC/AZTEC direct
ERC20_TOKEN=<usdc-address> SEED_DIRECT_POOL=true \
  forge script script/SeedUniswapPools.s.sol --rpc-url $RPC_URL --broadcast

# 3. Start frontend
cd frontend && pnpm dev

Also vibe coded 🤖

Built with Claude across a marathon session. The contracts, routing logic, and deployment pipeline should get a proper review — the logic is solid from testing but fresh eyes always help.

🤖 Generated with Claude Code