Skip to content

FAQ

Frequently asked questions about Zylith.

General

What is Zylith?

Zylith is a privacy-preserving concentrated liquidity market maker (CLMM) on Starknet. It allows users to trade and provide liquidity without revealing their wallet addresses or transaction amounts.

How is Zylith different from other DEXs?

FeatureTraditional DEXMixerZylith
PrivacyNoneFullFull
AMM TypeConstant product or CLMMNoneCLMM
Capital EfficiencyVariesN/AHigh (concentrated liquidity)
ComplianceFullNonePrivacy Pools

Is Zylith audited?

Zylith is currently under development. Audits will be conducted before mainnet launch.

What chains does Zylith support?

Zylith is deployed on:

  • Starknet Mainnet
  • Starknet Sepolia (testnet)

Privacy

How does Zylith provide privacy?

Zylith uses zero-knowledge proofs to verify ownership and solvency without revealing:

  • Your wallet address
  • The amount you're trading
  • Your trading patterns

Can anyone see my trades?

Observers can see:

  • That a trade occurred
  • The approximate size (from pool impact)

Observers cannot see:

  • Who made the trade
  • Which specific deposit was used
  • Your trading history

Is Zylith compliant with regulations?

Zylith implements the Privacy Pools design:

  • Dual Merkle trees (deposit + association)
  • Association Set Providers can curate "clean" deposits
  • Users can prove their funds come from approved sources

What is Privacy Pools?

Privacy Pools is a protocol design that enables compliant privacy. Users can prove their funds are from legitimate sources without revealing their identity.

Technical

How long does a swap take?

StepDuration
Generate proof15-25 seconds
Submit transaction3-10 seconds
Total~20-35 seconds

Why does proof generation take so long?

Generating a Groth16 proof involves complex cryptographic operations. The 15-25 second time is competitive for browser-based proving.

What happens if I lose my secrets?

If you lose the secrets (secret, nullifier) for a commitment:

  • You cannot spend those funds
  • There is no recovery mechanism
  • Always backup your secrets

How do I backup my secrets?

The Zylith frontend provides an export function:

  1. Connect wallet
  2. Unlock secrets
  3. Export encrypted backup
  4. Store backup securely

Can I run my own relay server?

Yes. The relay server is open source. Running your own relay provides:

  • Censorship resistance
  • Maximum privacy
  • Independence from third parties

Usage

How do I deposit tokens?

  1. Connect wallet
  2. Go to Swap or Liquidity page
  3. Enter amount
  4. Approve token transfer
  5. Confirm deposit

The system handles commitment generation automatically.

How do I swap tokens?

  1. Ensure you have shielded balance (or use bundled deposit+swap)
  2. Select tokens and amount
  3. Set slippage tolerance
  4. Click Swap
  5. Wait for proof generation and execution

How do I provide liquidity?

  1. Go to Liquidity → Add
  2. Enter token amounts
  3. Set price range
  4. Confirm deposit + mint flow
  5. Position is created privately

How do I remove liquidity?

  1. Go to Liquidity
  2. Find your position
  3. Click Burn
  4. Enter amount to remove
  5. Confirm with ZK proof

What is slippage tolerance?

Slippage tolerance is the maximum acceptable difference between expected and actual output. It protects against:

  • Price movements during execution
  • Sandwich attacks

Why did my transaction fail?

Common reasons:

ErrorCauseSolution
Invalid proofStale Merkle rootRefresh and retry
Already spentCommitment usedUse different commitment
Slippage exceededPrice movedIncrease tolerance
Insufficient balanceNot enough tokensCheck shielded balance

Fees

What fees does Zylith charge?

Fee TypeRate
Swap fee0.3%
LP fee0.3% to LPs
Relay feeVariable (gas + margin)

How do LP fees work?

  • 0.3% of each swap goes to liquidity providers
  • Fees accumulate based on your share of liquidity
  • Collect fees via the Collect Fees function

Do I pay gas?

When using the relay:

  • Relay pays gas
  • Fee deducted from your shielded amount

When submitting directly:

  • You pay gas from wallet
  • Loses some privacy (wallet linked to transaction)

Troubleshooting

Proof generation is stuck

  1. Check browser console for errors
  2. Ensure sufficient memory (400+ MB free)
  3. Try refreshing the page
  4. Use a different browser

My balance isn't showing

  1. Ensure wallet is connected
  2. Click "Unlock Secrets"
  3. Sign the message
  4. Refresh pool state

Transaction pending for a long time

  1. Check Starknet block explorer
  2. Wait for network congestion to clear
  3. Transaction may still succeed

I can't find my position

LP positions are keyed by commitment. Ensure:

  1. Correct wallet connected
  2. Secrets are unlocked
  3. Position was successfully created

Getting Help

Where can I get support?

  • GitHub Issues: Bug reports and feature requests
  • Discord: Community support (if available)
  • Documentation: This site

How do I report a bug?

  1. Check existing issues
  2. Create detailed bug report with:
    • Steps to reproduce
    • Expected behavior
    • Actual behavior
    • Browser/device info
  3. Submit to GitHub Issues

Is there a bounty program?

Bug bounty program details to be announced. Focus areas:

  • Smart contract vulnerabilities
  • ZK circuit issues
  • Critical security bugs

Released under the MIT License.