JuiceSwap

# Overview

JuiceSwap is a decentralized exchange (DEX) built on Citrea, Bitcoin's first ZK rollup, deeply integrated with the JuiceDollar stablecoin ecosystem.

# What is JuiceSwap?

JuiceSwap is a Uniswap V3 fork optimized for the Citrea network. It enables trustless token swaps and liquidity provision with a unique twist: liquidity providers earn both swap fees AND savings interest through automatic svJUSD integration.

# Key Features

Feature Description
Concentrated Liquidity Uniswap V3's capital-efficient AMM model
svJUSD Integration LPs automatically earn savings interest on JUSD
JUICE Governance Same veto-based governance as JuiceDollar
Fee Buyback Protocol fees are converted to JUSD and added to JUICE equity
Bitcoin-Native Built on Citrea, Bitcoin's ZK rollup

# The Cypherpunk Heritage

JuiceSwap, like JuiceDollar, embodies the core principles of the cypherpunk movement:

"We the Cypherpunks are dedicated to building anonymous systems... Privacy is necessary for an open society in the electronic age." — Eric Hughes, A Cypherpunk's Manifesto (1993)

# Principles Realized in JuiceSwap

Cypherpunk Ideal JuiceSwap Implementation
Decentralization No admin keys, veto-based governance only
Trustlessness Immutable contracts, no upgrades
Permissionlessness Anyone can create pools, provide liquidity, or swap
Self-Custody Users hold their own LP NFTs
Censorship Resistance No entity can block trades or freeze liquidity

JuiceSwap brings decentralized trading to Bitcoin through Citrea's ZK rollup technology, continuing the cypherpunk vision of permissionless financial infrastructure.

# Architecture Overview

┌─────────────────────────────────────────────────────────────┐
│                      JuiceSwap Ecosystem                     │
├─────────────────────────────────────────────────────────────┤
│                                                              │
│   ┌───────────────┐     ┌───────────────┐                   │
│   │ JuiceSwap     │     │ Uniswap V3    │                   │
│   │ Gateway       │────▶│ Core Contracts│                   │
│   │               │     │ (Pools, NFTs) │                   │
│   └───────┬───────┘     └───────────────┘                   │
│           │                                                  │
│           ▼                                                  │
│   ┌───────────────┐     ┌───────────────┐                   │
│   │ JUSD ←→ svJUSD│     │ Fee Collector │                   │
│   │ Conversion    │     │ → JUICE Equity│                   │
│   └───────────────┘     └───────────────┘                   │
│                                                              │
│   ┌─────────────────────────────────────────────────────┐   │
│   │              JuiceDollar Protocol                    │   │
│   │   JUSD (Stablecoin) │ JUICE (Equity) │ svJUSD (Vault)│  │
│   └─────────────────────────────────────────────────────┘   │
│                                                              │
└─────────────────────────────────────────────────────────────┘

# How JuiceSwap Works

# 1. Token Swapping

Users swap tokens through the JuiceSwapGateway, which handles automatic conversions:

  • JUSD is converted to svJUSD (interest-bearing) for pool interactions
  • cBTC (native Bitcoin) is wrapped to WcBTC automatically
  • JUICE trades route through the Equity contract

# 2. Liquidity Provision

Liquidity providers deposit tokens into Uniswap V3-style concentrated liquidity pools:

  • Receive an NFT representing their position
  • Earn swap fees from traders
  • Bonus: JUSD liquidity automatically earns savings interest via svJUSD

# 3. Fee Distribution

Protocol fees flow back to JUICE holders:

  1. Fees collected from pools in various tokens
  2. JuiceSwapFeeCollector swaps all fees to JUSD
  3. JUSD sent to JUICE Equity contract
  4. JUICE token price increases

# 4. Governance

JuiceSwap uses the same governance model as JuiceDollar:

  • Propose: Pay 1,000 JUSD, wait 14 days minimum
  • Veto: Anyone with 2% voting power can block proposals
  • Execute: After veto period, anyone can execute

# Integration with JuiceDollar

JuiceSwap is tightly integrated with the JuiceDollar protocol:

Component JuiceDollar JuiceSwap Usage
JUSD Stablecoin Trading pair, converted to svJUSD in pools
JUICE Equity token Governance voting, fee recipient
svJUSD Savings vault Used in pools for auto-interest
Governance Veto system Same mechanism for JuiceSwap proposals

# Contract Addresses

# Mainnet (Chain ID: 4114)

Contract Address
JuiceSwapGateway 0xAFcfD58Fe17BEb0c9D15C51D19519682dFcdaab9 (opens new window)
JuiceSwapGovernor 0x51f3D5905C768CCA2D4904Ca7877614CeaD607ae (opens new window)
JuiceSwapFeeCollector 0xD2D68A452A6f5d9090153f52E64f23cc7fF8A97b (opens new window)
UniswapV3Factory 0xd809b1285aDd8eeaF1B1566Bf31B2B4C4Bba8e82 (opens new window)
SwapRouter 0x565eD3D57fe40f78A46f348C220121AE093c3cF8 (opens new window)
NonfungiblePositionManager 0x3D3821D358f56395d4053954f98aec0E1F0fa568 (opens new window)

# Testnet (Chain ID: 5115)

Contract Address
JuiceSwapGateway 0x8eE3Dd585752805A258ad3a963949a7c3fec44eB (opens new window)
JuiceSwapGovernor 0x8AFD7CB73Ce85b44996B86ec604c125af244A2B8 (opens new window)
JuiceSwapFeeCollector 0xfac6303F78A2b316a20eD927Ba0f7a7d07AaC47E (opens new window)
UniswapV3Factory 0xdd6Db52dB41CE2C03002bB1adFdCC8E91C594238 (opens new window)
SwapRouter 0x26C106BC45E0dd599cbDD871605497B2Fc87c185 (opens new window)
NonfungiblePositionManager 0x86e7A161cb9696E6d438c0c77dd18244efa2B8b1 (opens new window)

# JuiceDollar Protocol (Referenced)

Contract Mainnet Testnet
JUSD 0x0987...35C (opens new window) 0x6a85...E39 (opens new window)
JUICE (Equity) 0x2A36...ae4 (opens new window) 0x7fa1...D5E (opens new window)
svJUSD (SavingsVault) 0x1b70...97d (opens new window) 0x802a...c7B (opens new window)
WcBTC 0x3100...006 (opens new window) 0x8d0c...d93 (opens new window)

# Why JuiceSwap?

# For Traders

  • Low slippage through concentrated liquidity
  • Seamless UX - JUSD/svJUSD conversion is automatic
  • Bitcoin-native - trade on Citrea's ZK rollup

# For Liquidity Providers

  • Double yield - swap fees PLUS savings interest
  • Capital efficiency - concentrated liquidity positions
  • NFT positions - transferable, composable LP tokens

# For JUICE Holders

  • Fee revenue - all protocol fees increase JUICE value
  • Governance power - same voting rights as JuiceDollar
  • Ecosystem growth - more trading volume = more fees

# Getting Started

  1. Swapping Tokens - Learn how to trade on JuiceSwap
  2. Providing Liquidity - Earn fees as a liquidity provider
  3. Governance - Participate in protocol governance
  4. Smart Contracts - Technical contract reference

# Resources

Swapping Tokens →