# Liberty Swap Docs ## Liberty Swap Docs - [Introduction](https://docs.libertyswap.finance/general-information/introduction.md) - [Liberty SHIELD vs Liberty Swap](https://docs.libertyswap.finance/general-information/introduction/liberty-shield-vs-liberty-swap.md): Understanding the Architecture Behind Private Cross-Chain Finance - [Vision & Mission](https://docs.libertyswap.finance/general-information/vision-and-mission.md) - [Roadmap](https://docs.libertyswap.finance/general-information/roadmap.md): Disclaimer: This roadmap is for informational purposes only and reflects current plans as of January 2026. All objectives and timelines are subject to change without prior notice. - [Privacy Policy](https://docs.libertyswap.finance/general-information/privacy-policy.md) - [Terms of Service](https://docs.libertyswap.finance/general-information/terms-of-service.md) - [Token Listings](https://docs.libertyswap.finance/general-information/token-listings.md) - [Buy Us a Coffee](https://docs.libertyswap.finance/general-information/buy-us-a-coffee.md): Donation Address: 0x78e7715C1f29C12FBb93779d6D0790f8A46d2CDb - [Security Notice: Beware of Fake Websites](https://docs.libertyswap.finance/general-information/security-notice-beware-of-fake-websites.md) - [Recommended Wallets for Using Liberty Swap Finance](https://docs.libertyswap.finance/general-information/recommended-wallets-for-using-liberty-swap-finance.md) - [Core Architecture](https://docs.libertyswap.finance/liberty-swap-2.0/core-architecture.md) - [Supported Operations](https://docs.libertyswap.finance/liberty-swap-2.0/supported-operations.md) - [Private Swap](https://docs.libertyswap.finance/liberty-swap-2.0/private-swap.md) - [The Principle of Communicating Vessels](https://docs.libertyswap.finance/liberty-swap-2.0/private-swap/the-principle-of-communicating-vessels.md): The principle of communicating vessels states that in connected containers, a liquid will naturally settle at the same level in all vessels because pressure equalizes under gravity. - [RAILGUN Private Mode](https://docs.libertyswap.finance/liberty-swap-2.0/private-swap/railgun-private-mode.md): The features and the entire LibertySwap dApps are currently in the beta phase. - [Private Mode Step-by-Step Guide](https://docs.libertyswap.finance/liberty-swap-2.0/private-swap/railgun-private-mode/private-mode-step-by-step-guide.md): Private Swap is a core feature of LibertySwap 2.0 that allows users to swap directly from Railgun balances into assets on other blockchains, all while remaining private. - [Transaction Visibility And Knowledge](https://docs.libertyswap.finance/liberty-swap-2.0/private-swap/railgun-private-mode/transaction-visibility-and-knowledge.md): This page explains what LibertySwap knows and does not know about user transactions when using LibertySwap Railgun Routes. - [Railgun Private Sends: Privacy and Fee Structure](https://docs.libertyswap.finance/liberty-swap-2.0/private-swap/railgun-private-mode/railgun-private-sends-privacy-and-fee-structure.md): This page explains what Railgun Private Sends are, their level of privacy, and the internal Railgun fee structure that is not under LibertySwap control but the blockchain networks and Railgun relayers - [Cross-Chain Swaps](https://docs.libertyswap.finance/liberty-swap-2.0/cross-chain-swaps.md) - [PulseChain Card Payments](https://docs.libertyswap.finance/liberty-swap-2.0/pulsechain-card-payments.md) - [Fiat On and Off Ramp with Peer](https://docs.libertyswap.finance/liberty-swap-2.0/fiat-on-and-off-ramp-with-peer.md): No KYC. No middlemen. Just code. - [Buy Crypto with Fiat Using Peer](https://docs.libertyswap.finance/liberty-swap-2.0/fiat-on-and-off-ramp-with-peer/buy-crypto-with-fiat-using-peer.md): LibertySwap integrates with Peer to provide a seamless way to purchase crypto using fiat currency. - [Solana ⇄ PulseChain Bridging](https://docs.libertyswap.finance/liberty-swap-2.0/solana-pulsechain-bridging.md) - [Core Architecture](https://docs.libertyswap.finance/liberty-shield/core-architecture.md): Liberty SHIELD is a unified privacy and routing layer designed for dApps across any blockchain to integrate and use. - [Liberty Shield SDK](https://docs.libertyswap.finance/liberty-shield/liberty-shield-sdk.md): Working on this page - [Shield and Unshield Your Coins with Liberty Shield](https://docs.libertyswap.finance/liberty-shield/shield-and-unshield-your-coins-with-liberty-shield.md): This page provides guidance on using LibertySwap to shield and unshield your coins effectively while maintaining your privacy and protecting your trades. - [Overview](https://docs.libertyswap.finance/liberty-dex/overview.md) - [Core Architecture](https://docs.libertyswap.finance/liberty-dex/overview/core-architecture.md): Working on this page - [Benefits for Swappers](https://docs.libertyswap.finance/liberty-dex/overview/benefits-for-swappers.md) - [Supported Tokens](https://docs.libertyswap.finance/liberty-dex/overview/supported-tokens.md) - [Minimum Swap Size](https://docs.libertyswap.finance/liberty-dex/overview/minimum-swap-size.md) - [Execution Model](https://docs.libertyswap.finance/liberty-dex/execution-model.md) - [Open Execution Network](https://docs.libertyswap.finance/liberty-dex/execution-model/open-execution-network.md) - [Swap Execution Errors](https://docs.libertyswap.finance/liberty-dex/execution-model/swap-execution-errors.md) - [How to Swap with Liberty DEX](https://docs.libertyswap.finance/liberty-dex/how-to-swap-with-liberty-dex.md): Swaps executed through Liberty DEX follow an intent-based flow, where the user signs an order and the execution is handled by the network. - [Network Costs](https://docs.libertyswap.finance/liberty-dex/how-to-swap-with-liberty-dex/network-costs.md) - [Slippage Handling](https://docs.libertyswap.finance/liberty-dex/how-to-swap-with-liberty-dex/slippage-handling.md) - [Limit Orders](https://docs.libertyswap.finance/liberty-dex/limit-orders.md): Introducing a new way to trade - combining self-custody, privacy, and zero-friction execution into a single seamless experience. - [How to Use Limit Orders](https://docs.libertyswap.finance/liberty-dex/limit-orders/how-to-use-limit-orders.md) - [Important Notes](https://docs.libertyswap.finance/liberty-dex/limit-orders/important-notes.md) - [Overview](https://docs.libertyswap.finance/liberty-pool/overview.md) - [Core Architecture](https://docs.libertyswap.finance/liberty-pool/overview/core-architecture.md): Working on this page - [Protocol Objectives](https://docs.libertyswap.finance/liberty-pool/overview/protocol-objectives.md) - [Trading Fee Distribution](https://docs.libertyswap.finance/liberty-pool/overview/trading-fee-distribution.md) - [Liquidity Model](https://docs.libertyswap.finance/liberty-pool/overview/liquidity-model.md) - [Routing and Swap Execution](https://docs.libertyswap.finance/liberty-pool/overview/routing-and-swap-execution.md) - [Smart Contracts](https://docs.libertyswap.finance/liberty-pool/smart-contracts.md) - [Risk Considerations](https://docs.libertyswap.finance/liberty-pool/risk-considerations.md) - [Ecosystem Expansion](https://docs.libertyswap.finance/liberty-pool/ecosystem-expansion.md) - [What is ZKX Wallet?](https://docs.libertyswap.finance/zkx-wallet/what-is-zkx-wallet.md) - [Privacy Policy](https://docs.libertyswap.finance/zkx-wallet/privacy-policy.md) - [Core Architecture](https://docs.libertyswap.finance/zkx-wallet/core-architecture.md): Working on this page - [Private Mode](https://docs.libertyswap.finance/zkx-wallet/private-mode.md) - [Public Mode](https://docs.libertyswap.finance/zkx-wallet/public-mode.md) - [User Manual](https://docs.libertyswap.finance/zkx-wallet/user-manual.md) - [Create your ZKX Wallet account](https://docs.libertyswap.finance/zkx-wallet/user-manual/create-your-zkx-wallet-account.md) - [Switching Between Public Mode and Private Mode](https://docs.libertyswap.finance/zkx-wallet/user-manual/switching-between-public-mode-and-private-mode.md) - [Managing networks](https://docs.libertyswap.finance/zkx-wallet/user-manual/managing-networks.md) - [Adding a Custom Token](https://docs.libertyswap.finance/zkx-wallet/user-manual/adding-a-custom-token.md) - [Sending Tokens](https://docs.libertyswap.finance/zkx-wallet/user-manual/sending-tokens.md) - [Shielding Tokens](https://docs.libertyswap.finance/zkx-wallet/user-manual/shielding-tokens.md) - [Unshielding Tokens](https://docs.libertyswap.finance/zkx-wallet/user-manual/unshielding-tokens.md) - [Accessing dApps](https://docs.libertyswap.finance/zkx-wallet/user-manual/accessing-dapps.md) - [Using Batch Transactions](https://docs.libertyswap.finance/zkx-wallet/user-manual/using-batch-transactions.md) - [Connecting ZKX Wallet to Keystone](https://docs.libertyswap.finance/zkx-wallet/user-manual/connecting-zkx-wallet-to-keystone.md) - [Connecting ZKX Wallet to imToken](https://docs.libertyswap.finance/zkx-wallet/user-manual/connecting-zkx-wallet-to-imtoken.md) - [Core Architecture](https://docs.libertyswap.finance/liberty-lend-coming-soon/core-architecture.md): Working on this product - [Brand Kit](https://docs.libertyswap.finance/resources/brand-kit.md): Brand kit assets for LibertySwap - [Railgun Stats](https://docs.libertyswap.finance/resources/railgun-stats.md) - [Liberty Swap API](https://docs.libertyswap.finance/resources/liberty-swap-api.md): The official API for Liberty Swap! 🚀 - [Get Started On PulseChain](https://docs.libertyswap.finance/how-to/get-started-on-pulsechain.md) - [Buy USDC with GBP and Bridge to PulseChain](https://docs.libertyswap.finance/how-to/get-started-on-pulsechain/buy-usdc-with-gbp-and-bridge-to-pulsechain.md): Using zkp2p.xyz and LibertySwap - [Protect Your Trading Privacy With LibertySwap](https://docs.libertyswap.finance/how-to/protect-your-trading-privacy-with-libertyswap.md) - [Shield/Unshield assets between BNBChain and Railgun](https://docs.libertyswap.finance/how-to/protect-your-trading-privacy-with-libertyswap/shield-unshield-assets-between-bnbchain-and-railgun.md): Below is a step-by-step guide for shielding/unshielding USDC between BNBChain and Railgun. - [Shield your ETH or WETH from MegaETH to Railgun](https://docs.libertyswap.finance/how-to/protect-your-trading-privacy-with-libertyswap/shield-your-eth-or-weth-from-megaeth-to-railgun.md) - [Use Private Swap](https://docs.libertyswap.finance/how-to/protect-your-trading-privacy-with-libertyswap/use-private-swap.md): This page provides guidance on using LibertySwap’s Private Swap effectively while maintaining your privacy and protecting your trades. - [Use Privacy Protocols Like Railgun](https://docs.libertyswap.finance/how-to/protect-your-trading-privacy-with-libertyswap/use-privacy-protocols-like-railgun.md): This content summarizes commonly known, high-level best practices related to privacy protocols such as Railgun and TornadoCash. - [Unshield assets from BNBChain (Railgun) to PulseChain assets](https://docs.libertyswap.finance/how-to/protect-your-trading-privacy-with-libertyswap/unshield-assets-from-bnbchain-railgun-to-pulsechain-assets.md): Below is a clear, step-by-step guide for unshielding assets from BNBChain (Railgun) to PulseChain using Liberty Swap Finance - [Use Railway Wallet](https://docs.libertyswap.finance/how-to/use-railway-wallet.md) - [Railway Wallet Basic Troubleshooting](https://docs.libertyswap.finance/how-to/use-railway-wallet/railway-wallet-basic-troubleshooting.md): This guide covers common issues and step by step actions to help you resolve them quickly. - [RPC Configuration](https://docs.libertyswap.finance/how-to/use-railway-wallet/rpc-configuration.md) - [Common Issues While Using Liberty Swap](https://docs.libertyswap.finance/how-to/common-issues-while-using-liberty-swap.md) - [Gasless Mode Not Available](https://docs.libertyswap.finance/how-to/common-issues-while-using-liberty-swap/gasless-mode-not-available.md): If you connected your wallet to Liberty Swap Finance but the Gasless option does not appear, this is most likely due to your wallet being a Smart Account. - [Setup & Configure RPCs & Networks](https://docs.libertyswap.finance/how-to/common-issues-while-using-liberty-swap/setup-and-configure-rpcs-and-networks.md) - [Fix Wallet Connection Issues](https://docs.libertyswap.finance/how-to/common-issues-while-using-liberty-swap/fix-wallet-connection-issues.md): If you are experiencing issues while using Liberty Swap Finance, the problem may come from the wallet you are connecting rather than from Liberty Swap or the blockchain itself. - [Fix Pending Transactions](https://docs.libertyswap.finance/how-to/common-issues-while-using-liberty-swap/fix-pending-transactions.md): If your transaction on Liberty Swap Finance is stuck on Pending, Confirming, or Waiting for confirmation, this is usually caused by a nonce or gas issue in your wallet. - [Fix Low Gas Fee Issues](https://docs.libertyswap.finance/how-to/common-issues-while-using-liberty-swap/fix-low-gas-fee-issues.md): If your transaction on Liberty Swap Finance fails, stays pending, or never gets confirmed, the most common reason is that the gas fee is too low. - [Install Liberty Swap as a Desktop App](https://docs.libertyswap.finance/how-to/install-liberty-swap-as-a-desktop-app.md) - [Install Liberty Swap as a Mobile App (iOS)](https://docs.libertyswap.finance/how-to/install-liberty-swap-as-a-mobile-app-ios.md) - [Install Liberty Swap as a Mobile App (Android)](https://docs.libertyswap.finance/how-to/install-liberty-swap-as-a-mobile-app-android.md) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on a page URL with the `ask` query parameter: ``` GET https://docs.libertyswap.finance/general-information/introduction.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.