# Introduction

As blockchain adoption grows, balancing transparency and privacy is vital to protect sensitive financial data. Liberty Swap offers a non-custodial, intent-based cross-chain exchange for the PulseChain community, ensuring interoperability and privacy. It allows users to swap, send, and bridge assets across chains without revealing transactional metadata on public ledgers.

While cross-chain liquidity has expanded rapidly across DeFi, most existing solutions remain fundamentally transparent. Addresses, token flows, amounts, and behavioral patterns are permanently recorded and trivially analyzed. For sophisticated users, this transparency introduces strategic risk, front-running exposure, and long-term identity leakage. Liberty Swap is built on the premise that any transactions, including cross-chain executions, should not require surrendering privacy and anonimity.

To address this, Liberty Swap integrates an on-chain zero-knowledge privacy system that allows users to interact with decentralized exchanges and bridges through shielded balances. Transactions are executed through cryptographic proofs rather than direct wallet interactions, ensuring that externally visible on-chain activity cannot be linked to a user’s identity, balance history, or trading behavior. Liberty Swap itself never takes custody of assets and never has access to private keys, balances, or transaction details.

Liberty Swap further adopts an **intent-based execution model**, allowing users to define desired outcomes rather than explicit execution paths. Instead of manually orchestrating multiple swaps, bridges, and approvals, users specify the asset they wish to send and the asset they wish to receive. The protocol then coordinates execution across supported chains and liquidity sources while preserving privacy throughout the process.

The result is a system where cross-chain liquidity becomes accessible without compromising user sovereignty, operational security, or anonymity.

Liberty Swap's non-custodial architecture also guarantees that users retain full control over their assets throughout the transaction process.

Combining intent-based architecture with a robust privacy framework, Liberty Swap empowers PulseChain users to engage in seamless, secure, and anonymous cross-chain asset transfers without ever relinquishing control over their funds.

For the PulseChain community, Liberty Swap offers a convenient and private avenue for cross-chain swaps, bridging, and asset transfers.

## Development Phases

* **Phase 1**: Focuses on cross-chain swap and send functionalities between PulseChain and other blockchains.
* **Phase 2**: Plans to integrate additional privacy routes and services, enhancing the platform's privacy features.
* **Phase 3**: Expanding to a full set trading suit for PulseChain, Ethereum, and EVM networks<br>

## Contact Us

* Website: <https://libertyswap.finance/>
* X (Twitter):[ @LibertySwapFi](https://x.com/LibertySwapFi)
* E-mail: <support@libertyswap.finance><br>


# Liberty SHIELD vs Liberty Swap

Understanding the Architecture Behind Private Cross-Chain Finance

Liberty has evolved from a single application into a **full protocol layer** with the launch of **Liberty SHIELD** — a unified privacy and routing infrastructure designed to power the next generation of cross-chain and private DeFi.

This page explains the fundamental difference between **Liberty Swap** and **Liberty SHIELD**, and how they work together.

### What is Liberty SHIELD?

**Liberty SHIELD** is a **privacy and routing infrastructure layer**.

It is designed to be:

* **Chain-agnostic**
* **dApp-agnostic**
* **Privacy-first**

Liberty SHIELD allows **any application, on any blockchain**, to interact with **Railgun and other privacy protocols** through a single unified layer.

Instead of every dApp needing to:

* integrate Railgun
* manage relayers
* handle gas abstraction
* route liquidity across chains
* coordinate private settlement

…all of this is handled by **Liberty SHIELD**.

It acts as the **private financial operating system** for Web3.

***

### What does Liberty SHIELD do?

Liberty SHIELD provides a single interface for:

* Shielding assets into privacy pools (Railgun and other ZK systems)
* Unshielding assets back to public blockchains
* Routing funds across chains while preserving privacy
* Abstracting gas, relayers, and fragmented liquidity
* Orchestrating private execution and settlement

In other words:

> **Liberty SHIELD turns privacy into a shared infrastructure instead of a feature that every app has to build from scratch.**

***

### What is Liberty Swap?

**Liberty Swap** is a **single application** built on top of **Liberty SHIELD**.

It uses SHIELD to provide:

* Private swaps
* Private cross-chain routing
* Railgun-powered anonymity
* Gas and relayer abstraction

Liberty Swap does **not** implement privacy itself.

It simply **calls the Liberty SHIELD protocol** to:

* move assets into privacy
* route them across chains
* swap them
* and return them back to users

Think of Liberty Swap as:

> A **frontend and trading interface** powered by Liberty SHIELD’s infrastructure.

***

### Key Difference

|                           | **Liberty SHIELD**                                           | **Liberty Swap**               |
| ------------------------- | ------------------------------------------------------------ | ------------------------------ |
| What it is                | Protocol & infrastructure layer                              | User-facing dApp               |
| Purpose                   | Enable private routing, shielding, and execution for any app | Provide private swaps to users |
| Who uses it               | Developers, protocols, dApps                                 | Traders, users                 |
| Integrates Railgun        | Yes (natively)                                               | Yes (via SHIELD)               |
| Cross-chain routing       | Built-in                                                     | Uses SHIELD                    |
| Gas & relayer abstraction | Built-in                                                     | Uses SHIELD                    |
| Can other apps use it?    | Yes                                                          | No — it is just one app        |

***

### Why this architecture matters

Without Liberty SHIELD, every privacy-enabled dApp would need to:

* Integrate Railgun manually
* Run its own relayers
* Manage gas across chains
* Handle fragmented liquidity
* Build custom privacy logic

This is slow, expensive, and fragile.

Liberty SHIELD solves this by creating a **shared privacy and routing layer** that all apps can use.

This allows:

* Faster development
* More secure privacy
* More liquidity
* More composability

***

### The Big Picture

Liberty is no longer just a swap app.

It is now a **protocol stack**:

> **Liberty SHIELD = the private cross-chain infrastructure**\
> **Liberty Swap = one application built on top of it**

This architecture allows Liberty to scale beyond a single product into a **privacy-native financial network** where any dApp can become private by default.


# Vision & Mission

## Vision

Liberty Swap envisions a DeFi landscape where privacy is not an optional feature, but an architectural baseline. As blockchain adoption expands globally, on-chain transparency has increasingly conflicted with legitimate user needs: financial confidentiality, protection from surveillance, and resistance to exploitative market behavior.

Our vision is to establish Liberty Swap as the primary privacy-native liquidity rail for PulseChain and its surrounding ecosystem—one that enables capital to move freely across chains while remaining shielded from public observation. In this future, users can rebalance portfolios, deploy capital, and bridge between networks without broadcasting their strategies, net worth, or counterparties.

We believe intent-based execution is a critical component of this future. By separating *what* a user wants from *how* it is achieved, Liberty Swap reduces complexity, minimizes execution risk, and removes unnecessary on-chain footprints. Privacy and usability reinforce each other rather than existing in tension.

Long term, Liberty Swap aims to contribute to a broader shift in DeFi architecture: away from wallet-centric, transaction-by-transaction exposure, and toward outcome-driven systems where users interact through cryptographic guarantees rather than observable behavior. In doing so, Liberty Swap supports a more resilient, censorship-resistant, and user-aligned financial system, while balancing obligations to prevent illicit finance and protect the broader ecosystem.

## Mission

Liberty Swap’s mission is to deliver a secure, private, and efficient cross-chain exchange that respects user sovereignty at every layer of the stack. This mission is executed through the following core objectives:

#### 1. Privacy by Default

Liberty Swap is designed so that privacy is not an advanced option or opt-in feature. User interactions occur through shielded balances and zero-knowledge proofs, preventing third parties from linking addresses, balances, or transaction histories. All swaps and bridges are executed without revealing sensitive metadata on-chain.

#### 2. Intent-Driven Cross-Chain Execution

Liberty Swap abstracts away manual routing, bridge selection, and execution sequencing. Users express high-level intents, such as swapping or bridging between assets across chains, and the protocol determines the optimal execution path. This model reduces user error, limits behavioral leakage, and improves capital efficiency across fragmented liquidity environments.

#### 3. Non-Custodial and Trust-Minimized Design

Liberty Swap never holds user funds, never controls private keys, and never acts as a custodian. Assets remain fully under user control at all times. Smart contracts are deterministic and permissionless, ensuring that users rely on cryptography and code rather than intermediaries or operators.

#### 4. PulseChain-Centric Interoperability

Liberty Swap is purpose-built for the PulseChain ecosystem, with native support for PulseChain assets and liquidity. At the same time, it serves as a private gateway between PulseChain and other major EVM networks, enabling capital inflows and outflows without exposing users to unnecessary public tracking or bridge-level surveillance.


# Roadmap

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.

## **2026**

**INTENT-BASED TRADING, PRIVACY, AND USERS EXPERIENCE**

LibertySwap is developing the default cross-chain privacy layer for PulseChain, aiming to unify liquidity, execution, and privacy across over 40 blockchains. Our ecosystem integrates intent-based trading, native privacy routing, and a user-friendly wallet to provide professional-grade, private trading for all PulseChain and other blockchain users. The 2026 product roadmap includes 4 distinct products, with plans to fund, build, launch, and market each one.

**1. LibertySwap 2.0: Cross-Chain Intent Protocol**\
\
LibertySwap transforms into an intent-based liquidity protocol with two modes:

* Public Mode: Offers instant, gasless, low-fee cross-chain swaps, connecting high-activity blockchains like Sui, Hyperliquid L1, TRX, Polygon, and Avalanche with PulseChain. Features optimized UX/UI for fast execution and rapid volume growth.
* Private Mode: Unique to LibertySwap, enabling cross-chain routing between Railgun shielded balances (BNB/ETH/Polygon/PulseChain) and allowing any blockchain to use Railgun with a unified anonymity set.

**2. Liberty DEX: Intent-Based Trading Protocol for PulseChain**\
\
Liberty DEX is tailored for the PulseChain ecosystem, consolidating liquidity and execution across PulseX, Piteas, and other native platforms. Users specify trade intents, including token details, slippage tolerance, and deadlines, without handling execution logic. It supports LIMIT and TWAP orders.\
\
Key features include:

* Intent-based architecture: Separates user intent from execution.
* Cross-DEX aggregation: Integrates PulseX and Piteas liquidity.
* Gas optimization: Fillers can sponsor or optimize gas usage.
* MEV-aware execution: Minimizes value leakage and failed transactions.
* Modular design: Allows future integration with privacy routes and off-chain solvers.

Liberty DEX is non-custodial, ensuring users retain asset control and only authorize execution under predefined conditions. No liquidity is locked, guaranteeing user fund safety. The goal is to provide professional-grade execution, better pricing, and smoother UX for PulseChain traders, leveraging PulseX and Piteas strengths.\
\
**3. Native Railgun on PulseChain + Governance**

* Deploy native Railgun contracts on PulseChain.&#x20;
* Support native PulseChain assets and cross-chain connectivity between PulseChain Railgun balances and other blockchains.
* Introduce a governance token, ZKX, to align protocol incentives and streamline decentralized decision-making.

**4. ZKX Wallet: Privacy-First Wallet Layer**\
\
A next-generation privacy wallet built around LibertySwap, featuring:

* Support for EIP 7702 standard and PulseChain.
* Default support for privacy protocols (TornadoCash and Railgun).
* High privacy standards: private RPC and no metadata leak.
* Stealth addresses and open-source design.
* Built on Kohaku and Ambire framework.
* Private asset swaps.

## 2025

🦅 LIBERTY NOVEMBER ROADMAP: PCOCK TO THE MOON 🚀

🎯Nov 1 – Nov 8

Purchase $200K–$300K worth of PLS to provide liquidity.

🎯 Nov 8

* WPLS routes go live, enabling instant movement of PLS between Ethereum Mainnet and PulseChain.
* Max per transaction: 1B PLS (no daily limit).
* All fees collected will be used to add liquidity for PCOCK.

🎯 Nov 15

* PDAI Deflationary Routes go live; enabling cross-chain movement between Ethereum Mainnet and PulseChain.
* WETH (PulseChain) ↔ ETH (Mainnet) two-way bridge launches.
* All fees collected will support PCOCK liquidity.

🎯 Nov 30

* Railgun ↔ PulseChain bridge goes live for privacy-enabled transfers.

LIBERTYSWAP & PCOCK: “FEED THE BIRD” ROADMAP

**Disclaimer:** This roadmap is for informational purposes only and reflects current plans as of September 2025.

All objectives and timelines are subject to change or revision without prior notice based on market conditions, technical considerations, and strategic priorities.

## September 2025 Objectives

### 1. Gasless Support Expansion

We will expand **gasless trading** to additional ecosystems, including:

* BNB Chain
* PulseChain
* Ethereum
* Arbitrum
* Base

***

### 2. PulseChain ⇆ Railgun Bridge *(Top Priority)*

Development of the **PulseChain–Railgun bridge** is our highest priority for September and the coming months.

* **Focus Areas**: Research, testing, and core development.
* **Timeline**: Targeting completion within the next few months, with the goal of final delivery before year’s end.
* **Additional Detail**: A dedicated roadmap will be published to cover this critical piece of PulseChain infrastructure.

***

### 3. USDC Transfers

We will enable **seamless USDC transfers** between **PulseChain and Ethereum**, with **gas fully abstracted and sponsored** on both sides of the transaction.

***

### 4. USD1 (BNB) Integration

Integration of **USD1 (BNB)** conversions into PulseChain assets will be supported.

***

### 5. Liberty Dashboard & Leaderboard

In collaboration with **@DevJuyoung**, we will launch the **LibertySwap Dashboard** and **Leaderboard** for PumpTires coins, providing enhanced transparency and community engagement.

***

### 6. zkP2P Integration

We plan to integrate **zkP2P** to deliver a more private and efficient **peer-to-peer trading experience**.

***

### 7. Coinbase Onramp Integration

We will begin integrating **Coinbase Onramp**, making it easier for users to directly access and acquire **PulseChain assets**.


# Privacy Policy

Welcome to Liberty Swap — a privacy-centric digital asset swap platform designed for the PulseChain ecosystem.

This Privacy Policy outlines how Liberty Swap (“we,” “us,” or “our”) collects, uses, and safeguards personal and transactional data when users (“you,” “your,” or “user”) engage with our services via our website and swap interface (collectively, the “Services”).

By using our Services, you acknowledge and consent to the terms of this Privacy Policy. If you do not agree with our practices, please do not use our Services.

## 1. Core Privacy Principles

Liberty Swap is founded on the belief that financial freedom and data sovereignty go hand-in-hand. Our platform is engineered to minimize data collection and promote user autonomy while still enabling effective customer support and maintaining compliance with relevant regulations.

## 2. Types of Data We Collect

### A. Transaction Data

When you perform a swap—standard or private—we may temporarily collect:

* Sender and receiver wallet addresses
* Token types and amounts sent/received
* Timestamps and routing data

Note: Liberty Swap does not tie these data points to real-world identities, nor do we attempt to deanonymize blockchain data.

### B. Optional Account Data (for Staking/Support Services)

If you opt into services like staking or open a support ticket, we may collect:

* Wallet address (public)
* Telegram or social handle (if support is requested via social media)
* User-submitted metadata (e.g., screenshots, logs)

We never request or store private keys or seed phrases.

## 3. Data Retention & Deletion

* Automatic Retention: Transaction data is retained for 24 hours to support issue resolution.
* User-Initiated Deletion: Users may opt to delete their transaction data immediately after a swap. This may limit our ability to troubleshoot issues post-swap.
* Extended Retention: In case of ongoing support matters, data may be retained beyond 24 hours and deleted upon resolution.

All deletions are handled via automated backend systems with no manual override.

## 4. Privacy Modes

### A. Standard Mode

For Standard Mode, Liberty Swap facilitates user-initiated blockchain transactions using account abstraction and intent-based routing. Transactions are recorded on public blockchains and are publicly observable via standard blockchain explorers. Liberty Swap does not collect or retain personal data, wallet addresses, or transaction histories, and does not monitor or analyze user activity beyond transient processing required to execute the requested operation. Users independently verify transactions using on-chain data.

### B. Private Mode

Private Mode is conducted with on-chain zero-knowledge privacy technology to enable transactions that obscure sender addresses, recipient addresses, asset types, and transferred amounts at the blockchain level. Transactions are executed using cryptographic proofs rather than transparent transfers. Liberty Swap does not have access to private balances, viewing keys, or decrypted transaction data and does not retain any off-chain records of private transactions. While this mode is designed to enhance transactional confidentiality, Liberty Swap does not provide legal anonymity guarantees and users remain responsible for complying with applicable laws and regulations in their jurisdiction.

## 5. Legal & Regulatory Disclosure

We comply with lawful requests from authorities, as mandated by applicable jurisdiction, but do not store personal data that can be proactively shared. Requests are reviewed for legal validity before any cooperation occurs.

## 6. Use of Personal Data

We may use collected data for:

* Transactional support
* Service optimization
* Fraud prevention
* Legal compliance
* Statistical analysis

We do not use your data for marketing or share it with advertisers.

## 7. Third-Party Integrations

Our platform may link to or rely on:

* RPC endpoints
* Privacy chain relayers
* PulseChain-based DeFi protocols
* Social platforms (e.g., Telegram, X)

Please review their privacy practices separately.

## 8. Security Practices

We implement:

* TLS encryption for all data in transit
* Anonymization of logged IPs
* Smart contract audits
* Zero-access policies for customer-facing staff

Despite these protections, blockchain data is immutable and inherently public in some cases. Users should take precautions when interacting with DeFi protocols.

## 9. Children’s Privacy

Liberty Swap is not intended for use by individuals under 18 years of age. We do not knowingly collect data from minors. If we learn that a minor has submitted data, we will promptly delete it.

## 10. Updates to This Policy

We may periodically revise this Privacy Policy. Changes will be posted on this page, with the updated date. Continued use of the Services implies consent to the latest version.

## 11. Contact Us

For privacy-related questions or support:

* Website: <https://libertyswap.finance/>&#x20;
* X (Twitter):[ @LibertySwapFi](https://x.com/LibertySwapFi)


# Terms of Service

PLEASE READ THESE TERMS OF SERVICE ("TERMS") CAREFULLY BEFORE USING LIBERTY SWAP. BY ACCESSING OR USING THE PLATFORM IN ANY MANNER, YOU AGREE TO BE BOUND BY THESE TERMS. IF YOU DO NOT ACCEPT THESE TERMS, YOU MAY NOT ACCESS OR USE THE PLATFORM.

## 1. Introduction

These Terms of Service (“Terms”) govern your access to and use of the Liberty Swap decentralized platform, which includes but is not limited to our websites, application interfaces, APIs, smart contracts, and related communication tools (collectively, the “Services”).

By using the Services, whether directly or through any third-party tool or integration, you acknowledge that you have read, understood, and agree to be legally bound by these Terms. If you do not agree, you must not access or use the Services.

These Terms constitute a binding agreement between you (“User,” “you,” “your”) and Liberty Swap, a decentralized software platform, its core contributors, affiliated developers, or operational partners (collectively, “Liberty Swap,” “we,” “our,” or “us”). Certain legal obligations herein may survive termination of your use of the Services.

By accessing, browsing, interacting with, or otherwise using any part of the Services, you affirm that you have read, understood, and agree to be legally bound by these Terms and any policies referenced herein, including our \[Privacy Policy].

## 2. Scope of Services

Liberty Swap is a multi-chain, non-custodial decentralized exchange (DEX) infrastructure that enables users to conduct secure asset swaps across supported blockchain networks. It is built to enhance user autonomy and privacy through advanced cryptographic and routing mechanisms.

Liberty Swap enables users to:

* Conduct decentralized digital asset swaps across various Layer 1 and Layer 2 blockchain protocols;
* Choose between Standard Swap and Private Swap modes, with the latter integrating privacy mechanisms such as randomized routing, time-delayed execution, and optional use of privacy-centric networks;
* Utilize the Platform without creating user accounts or undergoing centralized custody or control by Liberty Swap;
* Connect via non-custodial wallets to perform smart contract interactions directly.

All swaps are facilitated through smart contracts and/or relayed across privacy bridges, ensuring that Liberty Swap does not ever hold, custody, or have access to your digital assets.

Liberty Swap provides limited support services through encrypted communication channels strictly for operational assistance, not for asset management or user account intervention.

We offer two distinct transaction modes:

### 2.1 Standard Mode

This mode supports general cross-chain swaps through optimized routing algorithms. Users may conduct swaps via transparent smart contract interactions, which typically settle through visible chain operations.

### 2.2 Private Mode

This mode adds layers of transaction privacy using one or more of the following techniques:

* Obfuscation through randomized intermediaries.
* Integration with privacy-focused smart contracts (e.g., RAILGUN, etc.).
* Transaction delays or batching to prevent temporal correlation.
* Non-interactive zero-knowledge proof (zk-SNARKs) usage where applicable.

Private Mode is a non-custodial software feature that facilitates user-initiated blockchain transactions. We do not offer financial advice, investment recommendations, or custodial services. We also do not guarantee transaction completion times; intermediate, reverse, or censor user transactions; and/or collect personal data or maintain off-chain records of user activity. The Services are software utilities facilitating transaction execution; users are wholly responsible for their own actions and decision-making.

## 3. Eligibility

### 3.1 Age Requirements

To access or use the Services, you must be at least eighteen (18) years of age or the age of majority in your jurisdiction, whichever is older.

### 3.2 Legal Capacity

You represent and warrant that you have the full legal right, authority, and capacity to enter into and comply with these Terms.

### 3.3 Prohibited Jurisdictions

You may not use the Services if you are a resident, citizen, or located in any country or region that is:

* Sanctioned by the United Nations, United States (OFAC), European Union, or United Kingdom.
* Identified on the Financial Action Task Force (FATF) high-risk list.
* Subject to legal or regulatory restrictions applicable to digital assets.
* We reserve the right to geo-block access or suspend Services for users located in restricted jurisdictions, and we may use publicly available tools and third-party services for geographic validation.

## 4. Non-Custodial Infrastructure

### 4.1 No Custody

Liberty Swap is a non-custodial infrastructure. At no point does Liberty Swap have possession, control, or access to user funds, private keys, or signing credentials. You maintain full custody of your digital assets at all times.

### 4.2 Wallet Requirements

All transactions initiated via Liberty Swap require the use of a self-custodial wallet compatible with the blockchain(s) you wish to transact on. Examples include MetaMask, Rabby, Ledger, Trezor, Trust Wallet, and others supported via WalletConnect.

### 4.3 Transaction Finality

Transactions submitted through the Services are executed directly on the blockchain via user-controlled wallets. These are irreversible and cannot be reversed, canceled, or modified once confirmed by the network.

### 4.4 Smart Contract Use

Liberty Swap leverages autonomous smart contracts deployed on various public blockchain networks. Users interact with these contracts at their own risk. We do not control or alter the execution logic of deployed smart contracts once verified and published.

## 5. Wallet Connectivity and Interoperability

### 5.1 Supported Wallets

Liberty Swap supports a broad range of EVM-compatible wallets, hardware wallets, and browser extensions. Users are responsible for verifying wallet security and compatibility before initiating any transaction.

### 5.2 Key Management

We do not store seed phrases, recovery words, or passwords. You bear full responsibility for safeguarding your wallet credentials. If you lose access to your wallet, we cannot recover funds or provide technical intervention.

### 5.3 Cross-Chain Capabilities

Transactions involving different blockchains may require third-party bridges or relayers. Liberty Swap does not operate such bridges directly but may route through existing decentralized protocols. All bridge-related risks are borne by the user.

### 5.4 Integration Risks

Users who connect via third-party dApps, aggregators, or DeFi dashboards must understand and accept that Liberty Swap is not responsible for the reliability, security, or legality of those tools. You must independently evaluate the risks before proceeding.

## 6. Privacy Reference and Data Minimization

### 6.1 No Personally Identifiable Information Required

Liberty Swap is designed to operate without requiring personal data from users. We do not request, collect, or store personally identifiable information (PII) in the normal course of providing the Services.

### 6.2 Voluntary User Submissions

You may choose to contact us through optional forms, email, or encrypted messaging channels to seek support or provide feedback. In such cases, any information you voluntarily submit will be processed in accordance with our Privacy Policy.

### 6.3 On-Chain Transparency and Limitations

All blockchain-based transactions are inherently public. While Liberty Swap does not associate wallets with identities, transactions may still be traceable using blockchain analytics. Users must take independent steps to ensure privacy, especially when transacting on public chains.

### 6.4 Reference to Privacy Policy

Please review the full Liberty Swap Privacy Policy to understand how we handle user data, including anonymized telemetry (where applicable), cookies, or third-party analytics. That policy governs the collection, storage, and protection of information outside the scope of this Terms of Service.

## 7. Legal Compliance and Regulatory Considerations

### 7.1 Sanctions and Export Controls

You represent that you are not subject to trade restrictions or sanctions imposed by regulatory bodies including, but not limited to:

* The U.S. Department of the Treasury’s Office of Foreign Assets Control (OFAC)
* The European Union’s consolidated sanctions list
* Her Majesty’s Treasury (UK) Sanctions List
* United Nations Security Council Sanctions Committees

We reserve the right to block access from such jurisdictions or terminate access by users who breach these requirements.

### 7.2 Financial Compliance

Liberty Swap is a non‑custodial protocol and does not provide regulated financial services or custodial asset management. The protocol is designed to enhance user privacy while operating in accordance with applicable laws. To meet legal obligations and protect the integrity of the ecosystem, we are committed to compliance with applicable AML (Anti-Money Laundering), CTF (Counter-Terrorist Financing), and international obligations. This may include but is not limited to:

* Rate-limiting usage patterns indicative of layering, smurfing, structuring, or other illicit activities
* Flagging transactions with confirmed links to illicit activity (e.g., sanctioned addresses, ransomware wallets)
* Cooperating with competent authorities when compelled by legal process

### 7.3 Tax Obligations

Users are solely responsible for determining and fulfilling any tax obligations associated with their use of the Services. Liberty Swap does not issue tax documents, track profit/loss, or report to tax authorities. We recommend consulting a qualified tax advisor for jurisdiction-specific guidance.

### 7.4 Legal Investigations

In the event of a law enforcement or regulatory request that meets applicable legal thresholds, Liberty Swap contributors and infrastructure providers may cooperate as necessary. We reserve the right to implement selective or full protocol limitations to comply with such mandates.

### 7.5 No Securities or Derivatives

Tokens and digital assets accessible via Liberty Swap are not offered or sold by Liberty Swap. We do not offer investment contracts, derivative instruments, or financial products that constitute securities under applicable law. Users are responsible for determining whether their activity is lawful under local securities regulation.

### 7.6 No Profit Expectation and No Common Enterprise

Liberty Swap does not promise, guarantee, or imply that you will receive any profit, income, or financial return as a result of your use of the Services. Your use of the Platform does not constitute participation in a common enterprise, nor is there any expectation of profits to be derived from the efforts of Liberty Swap, its contributors, developers, or any third party. Any benefits you may obtain from using the Services result solely from your own actions, decisions, and market conditions, and not from the managerial or entrepreneurial efforts of others. The Services are provided solely as decentralized transaction execution tools. Users are responsible for their own due diligence and decision-making, and any value fluctuation of digital assets is a result of open market dynamics beyond Liberty Swap’s control.

### 7.7 Conflict-of-Interest Policy

Effective July 15, 2025, Liberty Swap core contributors, developers, employees, and affiliated team members are strictly prohibited from owning, trading, or launching any tokens on the PulseChain network other than PLS, PLSX, HEX, and INC. This restriction is intended to maintain neutrality, reduce conflicts of interest, and preserve the integrity of the Platform.

Any violation of this internal policy shall result in immediate termination of the individual’s engagement with Liberty Swap and may be subject to further remedies under applicable law. This clause applies exclusively to Liberty Swap personnel and does not restrict or govern the independent trading activity of Platform users.

## 8. User Conduct and Prohibited Activity

### 8.1 Prohibited Conduct

You agree to use the Platform solely for lawful, ethical, and non-fraudulent purposes. You further agree to not engage in any of the following activities:

* Violating any law, regulation, or court order in connection with the use of the Services.
* Accessing or attempting to access another user’s wallet, transaction, or information without permission.
* Deploying bots or automated software to manipulate liquidity, frontrun transactions, or perform denial-of-service attacks.
* Uploading viruses, malware, or malicious scripts to the interface or any third-party node infrastructure.
* Using the protocol in connection with money laundering, terrorist financing, human trafficking, or the distribution of child sexual abuse material.

### 8.2 Network Abuse and Interference&#x20;

You agree not to interfere with the normal operation of Liberty Swap or associated smart contracts. This includes refraining from:

* Exploiting bugs or protocol inefficiencies to gain unfair advantages.
* Conducting stress testing or penetration testing without written permission.
* Attempting to reverse engineer smart contracts or backend services outside the bounds of open-source licenses.

### 8.3 Harmful or Fraudulent Behavior

The following actions are expressly forbidden:

* Impersonating Liberty Swap, its contributors, or partners.
* Creating false or misleading content purporting to be associated with Liberty Swap.
* Soliciting personal data from other users under false pretenses.
* Using the Liberty Swap brand in scams, phishing campaigns, or copycat websites.

### 8.4 Enforcement and Remedies

Violation of these provisions may result in one or more of the following:

* IP-based access blocking.
* Reporting to blockchain analytics firms or regulatory entities.
* Civil or criminal prosecution, if applicable.
* Restriction from future governance participation or protocol improvements.

## 9. Transaction Mechanism and Fees

### 9.1 Transaction Finality

All transactions routed via Liberty Swap are executed on-chain through deterministic smart contract logic. By initiating a transaction, you authorize execution by the designated contract. Transactions are irreversible once broadcasted and mined.

You must not send assets directly to any Liberty Swap smart contract address or liquidity pool address unless explicitly instructed through the official Liberty Swap interface or verified communication channels. Doing so — including sending unsupported tokens, omitting required parameters (e.g., memo, tag, or payload), or interacting with the wrong network — may result in the permanent and unrecoverable loss of funds. Liberty Swap has no ability to reverse, cancel, or recover such transactions and shall bear no responsibility for any loss arising from user error.

### 9.2 Gas Fees

You are responsible for paying network gas fees required to process transactions on the underlying blockchains. These are separate from Liberty Swap’s protocol-level fees and may vary significantly depending on network congestion.

### 9.3 Protocol Fees

Certain swaps executed via the platform may incur protocol fees, which are transparently displayed before confirmation. These fees may be distributed to relayers, liquidity providers, developers, or future governance treasuries.

### 9.4 Refunds and Disputes

Due to the immutable nature of smart contract execution, Liberty Swap cannot offer refunds. If you believe your funds were misrouted due to a contract bug or third-party error, please contact support immediately. We may attempt to analyze the incident, but we do not guarantee fund recovery.

### 9.5 Delayed Settlements in Private Mode

Some Private Mode transactions may be subject to latency as part of their privacy-preserving mechanisms. In such cases, delays do not constitute failed transactions unless settlement exceeds pre-disclosed thresholds. By proceeding, you acknowledge and accept these potential delays.

## 10. Intellectual Property and License

### 10.1 Ownership of Materials

All content, codebases, architecture, algorithms, visual design, brand marks, and documentation associated with Liberty Swap are either:

* Owned by the Liberty Swap core contributors,
* Licensed under open-source protocols (e.g., MIT, GPL, or Apache), or
* Used under fair-use or public domain licenses with attribution.

### 10.2 Brand Use

The Liberty Swap name, logo, and associated branding elements may not be used without express written permission. Unauthorized use may constitute trademark infringement.

### 10.3 Open-Source Licensing

Where applicable, specific parts of the protocol are open-source and published under permissive licenses. You are free to fork, audit, or extend these components under the terms of the applicable license. You may not claim them as proprietary, nor may you use Liberty Swap branding on modified forks.

### 10.4 Limited License to Users

You are granted a limited, non-exclusive, revocable license to access and use the Services solely for personal, non-commercial purposes in accordance with these Terms. This license does not permit resale, redistribution, or derivative commercial use of the Services or any Materials therein.

## 11. Disclaimers and No Warranties

### 11.1 Use at Your Own Risk

The Services are provided on an “as-is” and “as-available” basis without warranties or representations of any kind, whether express or implied, including but not limited to merchantability, fitness for a particular purpose, title, and non-infringement. Your use of the Services is entirely at your own risk.

### 11.2 No Warranty on Accuracy or Timeliness

We do not guarantee that information or data presented on the Liberty Swap interface (including token prices, pool balances, or route estimates) is current, complete, or accurate. Due to the decentralized and asynchronous nature of blockchain networks, price or routing data may be stale, incorrect, or delayed. Use third-party price oracles at your own discretion.

### 11.3 No Liability for Third-Party Integrations

We disclaim all responsibility and liability for the actions or omissions of any third-party protocols, wallets, bridges, explorers, or price feeds integrated into or referenced by the Liberty Swap platform. These tools are provided for user convenience only and may be subject to separate terms of use and privacy policies.

### 11.4 Smart Contract Risk

Although we conduct internal and community-based code audits where feasible, no smart contract can be guaranteed to be free from bugs, exploits, or attack vectors. You acknowledge the risk of smart contract vulnerabilities, including but not limited to reentrancy, flash loan manipulation, governance attacks, MEV exposure, or logic flaws.

### 11.5 No Financial Advice

Nothing in the Services constitutes investment, legal, tax, or accounting advice. We do not recommend or endorse any digital asset or transaction. You should consult with licensed professionals before engaging in any activity involving blockchain-based assets.

## 12. Risk Disclosures

### 12.1 Blockchain Risks

You acknowledge that all blockchain-based activities involve inherent risks, including but not limited to:

* Finality failures or unexpected forks in the underlying chain.
* Gas fee volatility or chain congestion.
* Consensus layer failures, validator slashing, or oracle failure.
* Miner or validator censorship or reordering.

### 12.2 Asset Volatility

Digital assets are subject to extreme price volatility, illiquidity, and speculative interest. You may lose some or all of the value of your assets when participating in swaps. We make no representations as to the risk, legality, or suitability of any specific asset or transaction.

### 12.3 Regulatory Uncertainty

The legal status of decentralized finance protocols, tokens, and privacy-enhancing technologies is evolving. Legislative and regulatory bodies in multiple jurisdictions may restrict, criminalize, or reclassify certain activities. You accept the risk that your use of Liberty Swap may become restricted or prohibited without notice.

### 12.4 Bridge and Cross-Chain Risk

When engaging in cross-chain transactions using bridge protocols, you are exposed to additional risks including but not limited to:

* Custodial failures by the bridge provider.
* Synthetic asset de-pegging.
* Contract upgrade exploits or administrative key compromises.
* Relayer failure or validator collusion.

### 12.5 Privacy Mode Limitations

Transactions routed through Privacy Mode may suffer from reduced reliability, longer confirmation times, and increased susceptibility to timing-based deanonymization. Privacy is not absolute, and advanced adversaries may still correlate transaction metadata. Use responsibly and combine with external measures (e.g., VPN, Tor) if needed.

### 12.6 Protocol Upgrades and Governance

Liberty Swap may be subject to protocol upgrades, parameter changes, or governance actions proposed and voted upon by the community or contributors. You acknowledge that such changes may materially impact the protocol’s operation, fees, supported chains, or token compatibility.

## 13. Limitation of Liability

### 13.1 No Liability for Damages

To the fullest extent permitted by law, in no event shall Liberty Swap, its developers, contributors, maintainers, affiliates, or service providers be liable for any indirect, incidental, special, punitive, or consequential damages, including but not limited to:

* Lost profits, revenue, or business opportunity.
* Loss of data or digital assets.
* Errors in smart contract execution or unintended outcomes.
* Service interruptions or unauthorized access.

This limitation applies even if we were advised of the possibility of such damages.

### 13.2 Cap on Liability

To the extent a court of competent jurisdiction finds Liberty Swap liable despite the above disclaimers, our aggregate liability to you shall not exceed the lesser of (a) USD $100 or (b) the total amount of protocol fees paid by you in the preceding 12 months.

### 13.3 Force Majeure

We shall not be liable for any delay or failure in performance resulting from acts beyond our reasonable control, including but not limited to acts of God, internet outages, network disruptions, denial-of-service attacks, protocol layer bugs, regulatory interventions, or war.

## 14. Indemnification

### 14.1 Your Obligation to Indemnify

You agree to indemnify, defend, and hold harmless Liberty Swap, its contributors, developers, node operators, affiliates, and partners from and against any and all third-party claims, actions, damages, losses, liabilities, costs, or expenses (including legal fees) arising out of or related to:

* Your use of the Services.
* Your violation of these Terms.
* Your violation of any applicable law or regulation.
* Your infringement of any intellectual property or privacy rights.

### 14.2 Defense and Control

We reserve the right to assume exclusive defense and control of any matter subject to indemnification by you, in which case you agree to cooperate fully with us in asserting any available defenses.

### 14.3 Survival

This indemnification obligation shall survive any termination of your access to the Services and/or these Terms.

## 15. Governing Law and Dispute Resolution

These Terms shall be governed and construed under the laws of the jurisdiction in which Liberty Swap is legally established or otherwise operates.

Any dispute, controversy, or claim arising out of or in connection with these Terms or the Platform shall be settled by confidential binding arbitration, unless prohibited by law. The arbitration shall be conducted under the rules of a recognized arbitral institution, and the decision rendered shall be final and binding.

## 16. Termination

You may discontinue use of the Services at any time. Provisions of these Terms that by their nature should survive termination shall remain in effect, including but not limited to: intellectual property, disclaimers, limitation of liability, and indemnification.

## 17. Modifications to Terms

We reserve the right to update or modify these Terms at any time. Changes will become effective upon posting the updated Terms on our official website or interface. We may provide advance notice where feasible, but it is your responsibility to regularly review the Terms.

Your continued use of the Services after any such updates constitutes acceptance of the revised Terms.

## 18. Severability

If any provision of these Terms is found to be unlawful, void, or unenforceable under applicable law, the remaining provisions shall remain in full force and effect.

## 19. Entire Agreement

These Terms, together with any additional terms or policies referenced herein (including our Privacy Policy), constitute the entire agreement between you and Liberty Swap and supersede all prior or contemporaneous understandings.


# Token Listings

Liberty Swap supports a wide range of tokens across supported networks, including community-created tokens, meme coins, and experimental assets. This includes tokens created through platforms like PumpTires, which enables users to launch tokens in a decentralized and permissionless manner.

While some of these assets may experience notable price appreciation due to market dynamics, others may not perform as expected. Such volatility is an inherent characteristic of decentralized crypto markets.

Liberty Swap does **not** buy, endorse, or promote any specific tokens or projects created on PumpTires - with the sole exception of our community mascot token, PCOCK, which exists as a symbolic representation of community culture.

For all other tokens, any interactions or mentions on social media platforms are intended solely to foster community participation and engagement. These do **not** imply any form of endorsement, financial recommendation, or project affiliation.

Our role is strictly limited to observing and analyzing on-chain trading activity. If a token demonstrates organic user demand and contributes meaningfully to the burn mechanisms of $PLS or $PLSX through trading volume, it may be considered for listing on Liberty Swap. Such listings are provided **only** to facilitate access to trading and do not constitute a validation of the underlying project.

**Users bear full responsibility** for all trading decisions made on the platform. This includes, but is not limited to, evaluating project credibility, understanding risk exposure, and analyzing historical token performance.

Always exercise caution and conduct thorough research before engaging in any trading activity.


# Buy Us a Coffee

Donation Address: 0x78e7715C1f29C12FBb93779d6D0790f8A46d2CDb

At Liberty Swap, we believe in transparency, sustainability, and community-powered innovation. Your coffee contributions help us build a stronger, more accessible cross-chain future, starting with PulseChain.

## 🔥 How Donations Are Used

### 1️⃣ Covering PulseChain Gas Fees

We sponsor PulseChain gas fees for all users who purchase PulseChain assets through our swap.

While we already cover these costs today, your donations help us:

* Prepare for spikes in gas fees
* Offset rising PLS prices
* Maintain seamless, gasless user experience

***

### 2️⃣ Validator Support & Rewards Reinvestment

When contributions are sufficient, we will:

* Run or delegate a PulseChain validator
* Reinvest any validator rewards into gas fee sponsorships for PulseChain swaps

This adds long-term sustainability and keeps user costs low.

***

### 3️⃣ Strengthening Cross-Chain Liquidity

If we accumulate **surplus PLS**, we will:

* Establish a **WPLS (ETH)/PLS** route
* Seed it with our own liquidity
* Enable arbitrage between Ethereum and PulseChain to keep prices aligned and routes active

***

## 🪙 Asset Conversion Policy

All donations received in other tokens will be **converted to PLS or DAI** and used for:

* Gas fee coverage
* Validator setup and delegation
* Providing liquidity in future PulseChain pools

***

## 💼 Treasury Structure & Wallets

To maintain full transparency, Liberty Swap operates with clearly separated wallets:

* **Liberty Cold Wallet**: `0xc4459301147058872013f34e2ada930e7217543b`
  * Fully isolated from the internet and secured on dedicated hardware.
* **Liberty Warm Wallet (LP & Treasury Transactions)**: `0x4295523c4adf685eacbe1e0d43a6f6104c9e5e12`
  * Used only for adding liquidity and handling treasury-related transactions.
* **Liberty Coffee Shop (Donations)**: `0x78e7715c1f29c12fbb93779d6d0790f8a46d2cdb`
  * Used exclusively for community donations to cover PulseChain gas fees.

{% hint style="warning" %}
**Important note:**

* If you are a project team or token creator, **do not send tokens to the Coffee Shop wallet** unless you explicitly want them sold to fund gas fees.
* Treasury and liquidity operations are handled **exclusively** through the Cold and Warm wallets. When you see coins moving between the cold and warm wallets, this does ***not*** mean assets are being sold. These transfers are simply preparations for liquidity provision. Please rest assured—our treasury remains fully dedicated to LP and ecosystem support.
* Donations sent to the Coffee Shop wallet are **final and non-refundable**.
  {% endhint %}

***

## 🤝 Our Commitment

We’re committed to transparency and accountability. Every contribution supports the long-term health of PulseChain's ecosystem.

* Donation funds from the Coffee Shop wallet are **never kept for personal gain,** they are converted and applied directly toward community gas fees.
* The Coffee Shop wallet is **strictly reserved for community donations**. Any tokens sent there will be automatically liquidated and applied to gas fee support, in line with our established policy.
* Please do **not** treat this wallet as a way to request support. While we may, in exceptional and strictly necessary cases, consider offering limited assistance separately. Please keep in mind that such actions are rare and entirely discretionary.

Mistakes happen. What matters is keeping the conversation respectful and constructive, we’re all here to build together.

We’ll continue updating the community on fund usage and milestones.

Thank you for helping us make Liberty Swap better for everyone.

***

## 💸 How to Donate

Support Liberty Swap by sending a donation to:

{% hint style="success" %}
**0x78e7715C1f29C12FBb93779d6D0790f8A46d2CDb**
{% endhint %}

Send any amount. Every contribution helps us grow PulseChain adoption.&#x20;

Together, we’re building a faster, cheaper, and more decentralized future.

## 🍵 Donation Policy & Disclaimer

We are grateful for support, but to ensure clarity and trust, we encourage contributors to read through carefully and understand our policy before sending tokens. Thank you for your understanding.

### **1. Policy Purpose**

This policy is intended to clarify our established procedures for handling unsolicited crypto contributions. We maintain this wallet solely for minor supporter‑initiated donations, not for project token distributions.

### **2. Use of Received Tokens**

Tokens sent to the coffee shop address are **immediately** converted to fiat or appropriate assets that will be transferred to our paymaster address for gas payments and operational expenses.

### **3. Guidance for Token Creators**

Creators and project teams are strongly advised ***not*** to send tokens to this address—unless the intent is specifically for tokens to be sold in support of our initiatives. Sending tokens for other purposes may lead to unintended conversion or disposal.

### **4. No Solicitation of Tokens**

We never request tokens from project teams. If you or anyone independently chooses to send tokens to our coffee shop wallet in support of our initiatives, we sincerely appreciate the gesture. However, if that is not your intent, please refrain from sending tokens.


# Security Notice: Beware of Fake Websites

**Liberty Swap Finance operates on ONE AND ONLY ONE official domain:**

🔗 [**https://libertyswap.finance/**](https://libertyswap.finance/)

Any other website, domain, or URL using similar names (such as *liberty-swap.finance*, *libertyswapp.finance*, *libertywsap.finance*, or any other variations) is **NOT affiliated with Liberty Swap Finance** and has **not been authorized** by our team.

#### 🚨 Risks of Fake & Phishing Websites

Fake websites are commonly used to:

* Trick users into **connecting their wallets** and **signing malicious transactions**
* Ask for **seed phrases, private keys, or wallet approvals**
* Imitate the design of the real Liberty Swap interface to deceive users

Once a wallet is connected to a malicious site, attackers may gain **full access to your funds**, and blockchain transactions are **irreversible**.

#### ✔️ How to Verify the Official Website

Before interacting with Liberty Swap Finance, always verify:

* The domain is exactly [**https://libertyswap.finance/**](https://libertyswap.finance/)
* The URL has no extra characters, misspellings, hyphens, or suspicious extensions
* You did not access the site from unknown links in DMs, Telegram groups, Discord, or random websites

If the domain is not **libertyswap.finance**, **do not connect your wallet**.

#### 🛡️ Security Best Practices

* **Never share** your seed phrase or private key with anyone or any website
* Liberty Swap Finance will **never** ask for your private keys or recovery phrases
* Use a hardware wallet or a separate hot wallet when interacting with DeFi protocols
* Bookmark the official site and always use that bookmark to access the platform


# Recommended Wallets for Using Liberty Swap Finance

To ensure the best security, compatibility, and user experience when interacting with Liberty Swap Finance, we recommend the following wallets. These wallets are known for strong DeFi support and are compatible with PulseChain and EVM networks.

#### 🟢 Native Wallets (Recommended)

These wallets are optimized for Liberty Swap Finance and provide the best integration, stability, and security.

[**ZKX Wallet**](https://zkxwallet.com/)

* Privacy-focused wallet with integrated Private Mode powered by Railgun
* Supports both public and shielded transactions across multiple EVM networks
* Seamless access to DeFi applications with advanced multi-chain support
* Designed for users who want enhanced privacy, security, and flexibility within the PulseChain ecosystem

[**Internet Money Wallet**](https://internetmoney.io/)

* Native integration with the PulseChain ecosystem
* Designed for fast, low-latency transactions and secure key management

[**Pulse Wallet**](https://pulsewallet.co/)

* Built specifically for PulseChain
* User-friendly interface for both beginners and advanced users

#### 🔵 External Software Wallets

These widely used wallets work well with Liberty Swap Finance and most DeFi applications:

1. [**MetaMask**](https://metamask.io/)
   * Industry-standard wallet for EVM networks
   * Browser, mobile, and hardware wallet integrations
2. [**Rabby Wallet**](https://rabby.io/)
   * Advanced security and UX features
   * Multi-chain and DeFi focused
3. [**OKX Wallet**](https://web3.okx.com/)
   * Multi-chain support + built-in dApp browser
   * Integrates with hardware wallets
4. [**Trust Wallet**](https://trustwallet.com/)
   * Mobile first DeFi wallet
   * Easy access to tokens & DApps
5. [**Coinbase Wallet**](https://www.coinbase.com/wallet)
   * User-friendly wallet with strong security
   * Self-custody wallet separate from Coinbase exchange

***

#### 🟣 Hardware Wallets (Maximum Security)

For users prioritizing asset protection, hardware wallets are the safest option:

* [**Ledger**](https://www.ledger.com/)
  * Top-tier cold storage protection
  * Works with MetaMask, Rabby, and others
* [**Trezor**](https://trezor.io/)
  * Open-source hardware security
  * Compatible with major software wallet interfaces

***

#### ⚠️ Important Security Reminder

Liberty Swap Finance **never** asks for your private keys or recovery phrase.\
Always verify you are connecting your wallet only at:

🔗 [**https://libertyswap.finance/**](https://libertyswap.finance/)

Using a trusted wallet together with the official domain is the best way to protect your assets when interacting with Liberty Swap Finance.


# Core Architecture

Liberty Swap is designed as an intent-driven, non-custodial cross-chain swap protocol that abstracts away complex multi-chain transfers into simple user goals. Users simply specify what they want to do (e.g. “send 100 USDC from Base to PulseChain”), and a decentralized solver network computes and executes the optimal swap path across chains. In this model, the user’s funds never leave their own wallet; instead, a chain of smart contracts and relayer nodes fulfill the intent while preserving user control and privacy. The entire system is on-chain and non-custodial, so Liberty Swap does not hold user funds or require any KYC – it merely orchestrates on-chain trades and transfers in a privacy-preserving way.

## Cross-Chain Scope and Asset Coverage

Liberty Swap’s supported operations are centered on **bridging liquidity into and out of PulseChain**. Supported flows include:

* PulseChain ↔ Ethereum
* PulseChain ↔ BNB Smart Chain
* PulseChain ↔ Arbitrum
* PulseChain ↔ Base
* PulseChain ↔ Solana

Cross-chain swaps between non-PulseChain networks may be enabled when liquidity depth and execution reliability meet protocol thresholds. This conditional routing policy is designed to protect users from partial execution, excessive delays, or unfavorable pricing.

Across supported networks, Liberty Swap currently facilitates over 1,000 trading pairs, including major stablecoins, wrapped assets, and widely used native tokens. Stablecoins are commonly used as intermediate settlement assets to ensure deterministic pricing and execution consistency.

## Direct Multi-Chain Integration

Liberty Swap integrates directly with multiple blockchain networks at the protocol level. As of this writing, the system supports PulseChain, Ethereum, BNB Smart Chain, Arbitrum, Base, and Solana, with additional networks under evaluation. Integration is performed through native smart contracts and protocol-specific adapters, rather than custodial wrappers or off-chain accounting systems.

This direct integration enables Liberty Swap to support over 1,000 trading pairs across six blockchains (and counting) while maintaining consistent execution semantics across environments. Cross-chain transfers are performed through deterministic contract interactions, and no centralized bridge or custodian is introduced at any point in the asset lifecycle.

## **Intent-Abstraction & Solver Network**

At the heart of Liberty Swap is an *intent abstraction* engine. When a user submits a swap request, the protocol translates it into a sequence of on-chain operations. A distributed network of solver/relayer nodes then performs the actual token exchanges and transfers. Crucially, this separation means the user is only signing a high-level intent, not each individual transaction, and the relayers execute each step on-chain. The relayers coordinate to optimize routes and liquidity, and they are incentivized to fulfill swaps efficiently. Because the user’s intent is decoupled from execution, no single party ever sees the complete transaction trail. This split execution model (sometimes called “dual-hop”) is a core privacy feature.

## **Dual-Hop Privacy Execution**

Every swap is broken into two independent legs, handled by separate relayers (or “nodes”).&#x20;

In practice, *Node A* accepts the user’s input token on the source chain and swaps it into an intermediate asset (often a stablecoin on a random chain).&#x20;

*Node B* then takes that intermediate asset and swaps it to the destination token on the target chain, finally sending it to the user’s specified address.&#x20;

Because Node A and Node B never share information about both ends of the swap, no single relayer ever learns both the sender’s and recipient’s identity or token path. This two-step execution effectively “severs” the on-chain link between sender and receiver.

## **Account/Gas Abstraction**

Liberty Swap incorporates account abstraction and gas-payment abstraction so that users don’t need native gas tokens (like ETH) in their wallets. Behind the scenes, the protocol can sponsor or aggregate gas costs, letting users pay fees in stablecoins or even bypass gas altogether when possible. This account-abstraction layer means users simply fund a swap (in USDC or another supported token) and sign it, without manually acquiring chain-native gas. All complex fee payment and bundling is handled by the protocol’s smart contracts and relayers.

## RAILGUN Integration (Private Mode)

Private mode integrates RAILGUN, an on-chain zero-knowledge privacy system, directly into Liberty Swap’s execution pipeline. When private mode is selected, swaps and cross-chain transfers are executed using zero-knowledge proofs.

In this mode, transaction settlement conceals sender and recipient addresses, asset types, and transferred amounts from public view. On-chain observers see only privacy-preserving contract interactions, without access to the underlying economic details. Liberty Swap itself does not possess viewing keys, decryption capabilities, or access to private balances.

RAILGUN integration is strictly **non-custodial and user-controlled**. Users retain sole authority over their private keys and shielded assets. Liberty Swap smart contracts interface with the privacy layer only to verify cryptographic proofs and enforce intent constraints. This architecture ensures that privacy is achieved through cryptography rather than trust assumptions.

## **Native Wallet Integration**

The protocol is built to integrate directly into wallet UIs. For example, Liberty Swap is accessible as a built-in dApp in EVM-compatible wallets, requiring no browser extension or manual bridging steps. Users launch Liberty Swap from within their wallet app, select chains and amounts, and the wallet handles signing. \
\
This tight integration (supported by EIP-4337 smart-account wallets and similar technologies) yields a seamless user experience where complex multi-chain swaps feel like one native action.

***

Collectively, these architectural features make Liberty Swap a high-performance cross-chain engine: it supports thousands of swaps daily, with many completing in seconds to minutes. The protocol’s on-chain design and non-custodial model also help ensure compliance: there is no custody of user funds and no centralized point of control, reducing counterparty and regulatory risk.


# Supported Operations

Liberty Swap provides a production-ready set of cross-chain swap and bridge operations designed to balance execution efficiency, user autonomy, and privacy. The protocol currently supports **over 1,000 asset pairs across six blockchain networks**: PulseChain, Ethereum, BNB Smart Chain, Arbitrum, Base, and Solana. Support for additional networks and pairs is introduced incrementally as liquidity conditions permit.

Liberty Swap’s operational design prioritizes PulseChain-centric interoperability. Bridging to and from PulseChain is the primary supported use case. Cross-chain swaps between non-PulseChain networks (for example, Base ↔ Ethereum) are conditionally enabled only when sufficient liquidity and execution guarantees are available, ensuring predictable settlement and minimizing execution risk.

All supported operations are non-custodial and executed entirely on-chain.

## 🔄 Standard Swaps

In standard mode, Liberty Swap executes swaps using account abstraction and intent-based routing. This mode is optimized for speed, composability, and ease of use, while preserving non-custodial guarantees.

Each user-initiated intent is assigned a **unique Order ID**, generated solely for temporary status tracking within the Liberty Swap interface. The Order ID serves as a short-lived reference to the execution lifecycle (e.g., pending, executing, completed) and automatically expires after **24 hours**. It is not a persistent identifier and is not linked to wallet addresses, transaction hashes, or any form of user identity.

Upon successful execution, the user interface may display:

* the **Order ID**, for short-term confirmation and support reference, and
* the **on-chain transaction hash(es)** produced by the underlying blockchain execution.

Transaction hashes are provided strictly for user-side verification and transparency. Liberty Swap does **not** store, index, or retain transaction hashes, wallet addresses, or execution metadata off-chain. No internal mapping exists between Order IDs and transaction hashes once execution is complete.

As a result, only the user, by virtue of controlling the originating wallet or destination address, can independently verify or track a completed operation using public blockchain explorers. Liberty Swap does not monitor user transactions after execution and does not maintain any proprietary record of user activity after 24 hours.

This design ensures that:

* post-settlement traceability is entirely under user control, and
* Liberty Swap cannot correlate orders, addresses, or transactions across time.

In private execution mode, this principle is further strengthened through zero-knowledge settlement, where transaction hashes themselves do not reveal sender, recipient, asset type, or transferred amount. In both modes, privacy is preserved by design, and verification authority rests solely with the user.

The fastest path to use Standard Mode is to connect any EVM-compatible wallet (e.g. MetaMask, Rabby, Internet Money, or Pulse Wallet) and submit a swap intent. The user signs a single transaction in their wallet, and the protocol’s relayers immediately execute the swap. Because the user’s wallet is directly involved, execution is typically very quick (on the order of 0–2 minutes) and gas costs are minimized. The trade is settled on-chain with one signature, and the user’s funds remain in their wallet until the last step.&#x20;

This standard mode applies account-abstraction technology so that the user need not hold any particular chain’s gas token, which makes it highly efficient and secure.

## 🕵️ Private Swaps

Liberty Swap's Private Swaps are designed for users prioritizing privacy and anonymity in their transactions. For users requiring strong anonymity, Liberty Swap’s Private Mode leverages the Railgun privacy protocol.

In practice, the user’s swap order is sent to Liberty Swap relayers, which deposit the funds into Railgun smart contracts. The Railgun system then generates zero-knowledge proofs so that the sender’s address, recipient’s address, and transfer amounts become confidential on-chain. After the zk-proof verifies on the target chain, the destination token is released to the receiver’s address. Throughout this process, no on-chain observer can link the input to the output. Railgun privatizes the sender, recipient, asset, and amount simultaneously.

Liberty Swap does not have access to viewing keys, private balances, or decrypted transaction details. Privacy guarantees are enforced cryptographically and remain fully under user control. Private mode operations incur additional computational overhead and may have longer settlement times compared to standard mode, reflecting the cost of zero-knowledge proof generation and verification. However, they provide more anonymity: the swap path mostly cannot be traced.

***

### Gas Policy and Execution Costs

Liberty Swap maintains a gas abstraction policy across supported networks. Where possible, transaction fees are bundled or sponsored at the protocol level, allowing users to complete swaps without holding chain-native gas tokens.

Execution costs and protocol fees are clearly disclosed prior to confirmation. Fees are applied deterministically based on the selected route and execution mode. Liquidity-aware routing minimizes slippage, and no discretionary pricing adjustments are performed by the protocol.

### Data Minimization and User Transparency

Liberty Swap is designed with strict data-minimization principles:

* No user identity data is collected.
* No wallet metadata is retained.
* No transaction hashes are stored off-chain.
* Order IDs are temporary, non-identifying, and expire automatically.

All transaction verification remains fully on-chain and independently auditable. Liberty Swap functions solely as execution infrastructure and does not monitor, aggregate, or analyze user activity beyond what is required for real-time transaction fulfillment.


# Private Swap

Liberty Swap is built on the principle that **privacy is a requirement, not a luxury**, for serious on-chain finance. By integrating directly with the RAILGUN privacy system and extending it with intent-based execution, cross-chain routing, and PulseChain-native execution, Liberty Swap enables users to trade, transfer, and move liquidity with a level of confidentiality that most public DeFi protocols cannot provide.

## Built on RAILGUN: On-Chain, Non-Custodial Privacy

Liberty Swap builds our Private Mode on RAILGUN, an on-chain privacy system deployed directly on EVM blockchains. RAILGUN is not a separate chain, bridge, or custodial service. It is a smart contract code that has been live on Ethereum for years and is fully non-custodial.

* Funds are held in immutable smart contracts.
* No admin key can move user funds.
* Users control the private keys that generate zero-knowledge proofs.
* Liberty Swap, RAILGUN relayers, and frontends cannot access or move user balances.

Users interact with DeFi in a way that feels familiar, while gaining strong on-chain privacy guarantees.

***

## Privacy Features of Liberty Swap

### Permissionless, Non-Custodial Access (No KYC)

Liberty Swap by principle is a permissionless DeFi protocol. It does not require Know Your Customer (KYC) checks or the submission of personal identification.

* There are no accounts, approvals, or identity verification steps.
* Users interact directly from their wallets.
* Access is governed by smart contracts, not intermediaries.

This design ensures that privacy is preserved not only on chain or only in Private Mode, but also at the access layer.

### What Liberty Swap's Private Mode Protects

When using Liberty Swap's Private Mode, the following information is hidden on-chain:

* Sender address
* Recipient address
* Transaction amount

On public blockchain explorers, interactions appear to originate from neutral broadcaster addresses. There is no visible link between a user’s public wallet and their private activity.

### Shielded Balances and Privacy Sets

Funds deposited through Liberty Swap's Private Mode enter a shielded balance, also known as a privacy set. Within this set, tokens and users become indistinguishable from one another.

Privacy strength increases as:

* More users interact with the system
* More value remains shielded
* More swaps, transfers, and dApp interactions occur

The integration of RAILGUN supports full DeFi activity inside the privacy pool. Every private swap or transfer adds noise, improving privacy for all users.

Because Liberty Swap enables trading directly from shielded balances, users can keep funds private for longer periods, which further strengthens anonymity.

### Broadcasters and Gas Abstraction

Liberty Swap's private transactions are submitted to the blockchain through Broadcasters.

* Broadcasters pay gas on behalf of users.
* Transactions appear to come from the broadcaster, not the user.
* Transaction details are encrypted and cannot be read or modified by the broadcaster.

Broadcasters never custody funds and cannot censor users permanently. If one broadcaster fails, another can be used.

This design removes wallet-level identity leakage and reduces transaction-level fingerprinting.

### Intent-Based Private Routing

Liberty Swap uses an intent-based model.

Users sign a single intent describing what they want to receive. Liberty Swap executes the required steps internally, without exposing intermediate actions on-chain.

This eliminates common privacy leaks caused by manual, multi-step transactions such as:

* Deposit → swap → withdraw patterns
* Predictable timing sequences
* Identifiable transaction chains

The result is cleaner execution and fewer behavioral signals.

### Full Layer 1 Security

Because RAILGUN operates directly on Layer 1:

* Users of Liberty Swap's Private Mode inherit the security of both Ethereum and PulseChain L1
* There is no separate validator set
* If your funds stay in a RAILGUN shielded balance, you avoid bridge custody risk, because you are not using a bridge. Your remaining risks are smart contract risk and the underlying chain itself
* There are no L2 fraud proofs or sequencer assumptions

Privacy is achieved without sacrificing decentralization or security.

***

## Best Practices

Liberty Swap's Private Mode protects on-chain data, but user behavior still matters. Privacy can be weakened by predictable patterns.

Liberty Swap is designed to reduce these risks, but users should follow these principles:

* Avoid instant withdrawals after deposits
* Use irregular amounts rather than round numbers
* Split and recombine balances over time
* Avoid repetitive timing or destination patterns
* Use different wallets for different roles
* Allow funds to rest in shielded balances when possible

Liberty Swap’s low fees and gas abstraction make these practices easy to follow.

Future UI improvements will continue to guide users toward safer privacy defaults.


# The Principle of Communicating Vessels

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.

The principle of communicating vessels applies to privacy as well. When liquidity and users are connected through shared routes, the effective anonymity level equalizes and rises together.

Railgun anonymity strength depends heavily on the size and activity of its anonymity set. A smaller, newer deployment like native Railgun on PulseChain naturally starts weaker because it has fewer users and fewer transactions.

{% hint style="info" %}
Shielded balances are chain specific. A shielded balance on Ethereum is separate from shielded balances on BNB Chain or other networks. Before LibertySwap, these balances could not exchange or communicate with each other. We are here to change that.
{% endhint %}

<figure><img src="/files/aMSW88ljSFRHouO0ra0f" alt=""><figcaption></figcaption></figure>

LibertySwap changes this dynamic by acting as the connection:

* Shared flow creates shared privacy: When LibertySwap routes transactions between PulseChain and larger Railgun deployments on other chains, funds move through the same privacy pool logic. Activity from strong anonymity sets effectively mixes with PulseChain flows.
* Pressure equalization through routing: Just like liquid levels equalize in connected vessels, privacy strength equalizes when transaction flows are connected. A user entering Railgun on PulseChain is no longer isolated inside a small pool. They are statistically blended with a much larger global set.
* Time accelerates growth: Increased routed volume attracts more users. More users increase the local anonymity set. This creates a positive feedback loop where PulseChain Railgun grows faster than it would in isolation.
* No need to wait for organic scale: Without LibertySwap, PulseChain Railgun would need months or years of organic adoption to reach strong privacy guarantees. With connected routes, it borrows strength immediately from existing mature anonymity sets.
* Chain differences become irrelevant: Privacy no longer depends on how popular a single chain is. It depends on how well that chain is connected. LibertySwap makes PulseChain part of a larger privacy system rather than a standalone island.


# RAILGUN Private Mode

The features and the entire LibertySwap dApps are currently in the beta phase.

Private Mode is LibertySwap’s privacy preserving execution path for cross chain asset transfers across Ethereum, PulseChain, and other supported blockchains, including both EVM and non EVM networks. It uses zero knowledge based shielding infrastructure to prevent on chain linkage between source and destination transactions, while fully preserving non custodial control and user autonomy.

In its current implementation, Private Mode supports **ETH (Ethereum) ⇄ WETH (PulseChain)** routes and operates through a unified intent-based workflow. Users submit a single instruction (“intent”), and Liberty Swap coordinates the necessary settlement steps across chains without exposing sender identity, recipient identity, or transaction amounts on public ledgers.

Private Mode is optional and distinct from Liberty Swap’s standard execution mode. Users explicitly choose when to enter or exit privacy.

## Architectural Design

### Privacy-Preserving Routing

Private Mode establishes a bidirectional, privacy-preserving route:

```
Ethereum ⇄ Railgun ⇄ PulseChain
```

Under this design:

* Assets entering PulseChain from Ethereum are routed through Railgun and arrive in a shielded state.
* Assets exiting PulseChain to Ethereum are likewise routed through Railgun before settlement.
* No direct on-chain linkage between source and destination addresses is created on public ledgers.

This architecture allows users to selectively enter or exit privacy without forcing continuous participation in shielded pools.

### Key Properties

* **User-Controlled Privacy**\
  Users retain full discretion over timing, amounts, and duration of shielded balances. Assets may be transferred immediately through the route or held privately for any period.
* **Intent-Based Execution**\
  Users submit a single signed intent. All intermediate steps are executed by Liberty Swap relayers requiring minimal user intervention.
* **Non-Custodial Operation**\
  At no point does Liberty Swap assume custody or discretionary control over user assets.
* **Gas abstraction**\
  Private Mode leverages gas abstraction where supported, allowing users to initiate intents without maintaining native gas balances on each participating blockchain. Required execution fees are handled within the protocol’s settlement process.
* **On-Chain Verifiability**\
  Settlement occurs entirely on-chain via smart contracts. Liberty Swap does not maintain off-chain transaction records.

### Supported Routes (Current)

* **Ethereum → PulseChain**\
  ETH/USDC (Railgun) → ETH/USDC (PulseChain)
* **PulseChain → Ethereum**\
  ETH/USDC (PulseChain) → ETH/USDC (Railgun)

Private Mode routes are currently subject to conservative transaction limits during early deployment. These limits may be adjusted as liquidity and system capacity mature.

### Railgun Balance Model

Railgun maintains chain-specific shielded balances:

* A user’s shielded balance on Ethereum is distinct from their shielded balance on PulseChain.
* Each network operates its own Railgun smart contracts and Merkle tree.
* Assets remain local to a chain unless explicitly transferred via a bridge or intent route.

Liberty Swap’s private routing connects these isolated shielded environments through an intent-driven settlement process, enabling cross-chain movement without exposing transactional linkage.

### Transaction Tracking and Privacy

Each Private Mode transaction is assigned a temporary Order ID for user-side status tracking. The Order ID:

* Exists solely to communicate execution state to the user.
* Automatically expires after 24 hours.
* Is not stored alongside wallet addresses or transaction hashes.

Liberty Swap does **not** retain transaction hashes, wallet identifiers, or user metadata. Users who wish to independently verify execution may do so using their own wallet addresses and on-chain explorers. Privacy guarantees remain intact regardless of whether verification is performed.

### Status Visibility and UX Considerations

Due to the multi-layered nature of zero-knowledge execution and cross-chain settlement, private transactions may involve longer confirmation windows than standard swaps.

Liberty Swap is actively improving UI-level status notifications to provide clearer execution feedback without compromising privacy or storing user-identifiable data.

## Important Considerations

* Private Mode is optional and user-initiated.
* Shielded transfers may incur higher fees and longer settlement times due to zero-knowledge proof generation.
* Users are responsible for understanding applicable laws and regulations in their jurisdiction when using privacy-enhancing technologies.


# Private Mode Step-by-Step Guide

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.

### First Step: Prepare a Railgun-Supported Wallet

To use Liberty Swap Private Mode, users must have a wallet that support Railgun and 0zk addresss. Your tokens into a compatible privacy smart contract of Railgun using a supported wallet interface which is very secure and standing the test of time, and thoroughly audited.&#x20;

{% hint style="info" %}
Check out a list of RAILGUN powered wallets [here](https://www.railgun.org/wallets.html).
{% endhint %}

{% hint style="info" %}
Shielded balances are chain specific. A shielded balance on Ethereum is separate from shielded balances on BNB Chain or other networks. Before LibertySwap, these balances could not exchange or communicate with each other. We are here to change that.
{% endhint %}

### PulseChain → RAILGUN

#### Step 1: Initiate an Intent to Receive ETH (Ethereum) in RAILGUN

Within the Liberty Swap interface:

1. Connect your wallet
2. Select **Private Mode**.
3. Choose the supported private route (WETH → ETH).
4. Specify the amount to swap (subject to current private route limits).
5. Fill in the Railgun Private 0zk Address.
6. Click \[**Swap**] then \[**Confirm**].

#### Step 2: Sign the Intent

Sign the intent as shown in your connected wallet.

#### Step 3: DONE

The relay executes the settlement and delivers ETH (RAILGUN) to the user in less than a minute.

{% embed url="<https://x.com/LibertySwapFi/status/1998089231407759485>" %}

### RAILGUN → PulseChain

#### Step 1: Initiate an Intent to Receive WETH (PulseChain) in Liberty Swap

Within the Liberty Swap interface:

1. Connect your wallet
2. Select **Private Mode**.
3. Choose the supported private route (ETH → WETH).
4. Specify the amount to swap (subject to current private route limits).
5. Fill in the Destination Address.
6. Click \[**Swap**] then \[**Next**].
7. Copy LibertySwap’s given Railgun ZK address.

#### Step 2: Send ETH to Liberty Swap

&#x20;Within the RAILGUN-powered wallet:

1. Ensure you are operating on the **ZK (shielded) side**.
2. Initiate a transfer from your ZK address to Liberty Swap’s ZK address by pasting the Liberty Swap’s given ZK address into the Recipient box.
3. Enter the same amount as filled in the Liberty Swap interface in the previous step.

#### Step 3: Include the Private Memo

1. Copy the memo provided by LibertySwap.
2. Paste it into the **optional private memo field** in your RAILGUN wallet.
3. Generate the ZK proof.
4. Submit the transaction in your wallet.
5. Then confirm the transaction on the Liberty Swap side.

This memo enables Liberty Swap’s relay to correctly attribute and settle the incoming shielded transfer.

#### Step 4: DONE

The relayer executes the settlement and delivers WETH on PulseChain to the user instantly in less than a minute.

{% embed url="<https://x.com/LibertySwapFi/status/1998089117532573756>" %}


# Transaction Visibility And Knowledge

This page explains what LibertySwap knows and does not know about user transactions when using LibertySwap Railgun Routes.

## 1. System Overview

LibertySwap Railgun Routes allow users to route swaps through Railgun shielded pools and cross chain paths, including Ethereum, PulseChain, and other supported networks.

LibertySwap acts as:

* A routing interface
* A transaction coordinator
* A notification and status relay

LibertySwap is not a custodian, wallet provider, or identity broker.

## 2. What LibertySwap CAN See

LibertySwap has limited visibility required to operate the routing service reliably.

<figure><img src="/files/8iXB2qTENCwDhOhXXCuf" alt=""><figcaption></figcaption></figure>

**2.1 Transaction Status Metadata**

LibertySwap can observe:

* Swap initiation events
* Swap completion or failure states
* Input and output transaction hashes that show LibertySwap contract interacted with Railgun Relayer &#x20;
* Network paths used, for example Ethereum to Railgun to PulseChain
* Fees charged by the protocol

This data is used only to:

* Display transaction progress
* Confirm delivery
* Provide support for failed or delayed swaps

\
**2.2 Non Identifying Routing Information**

LibertySwap may temporarily process:

* Asset type involved, for example ETH, WETH, USDC
* Approximate amounts for routing calculation
* Network selection and bridge path

This information is not linked to a known identity.

## **3. What LibertySwap CANNOT See**

**3.1 User Identity**

LibertySwap does not know:

* Who the user is
* The real world identity of the sender
* Any KYC, name, email, or account ownership

Transactions routed through Railgun appear as unknown senders by design.

**3.2 Wallet Ownership**

LibertySwap does not know:

* Which wallet owns the funds
* Which wallet controls the shielded balance
* Whether multiple transactions belong to the same user

Railgun cryptography prevents wallet level attribution.

**3.3 Shielded Transaction Internals**

LibertySwap cannot access:

* Railgun shielded balance history
* Private notes or commitments
* Internal transfers within Railgun
* Sender recipient relationships inside the shielded pool

These are cryptographically hidden and never exposed to LibertySwap.

## 4. What LibertySwap NEVER Stores

LibertySwap does not store:

* User addresses mapped to identities
* Transaction histories tied to users
* Behavioral profiles
* IP to wallet correlations
* Any long term personal data

Any temporary operational data is ephemeral and used only for swap execution and monitoring.

## 5. On Chain Transparency vs Shielded Privacy

**5.1 Public Chains**

On public chains, observers can see:

* Contract interactions
* Aggregate volume
* Network level activity

This is inherent to public blockchains.

\
**5.2 Railgun Shielded Layer**

Within Railgun:

* Sender and recipient are cryptographically hidden
* Transaction amounts are shielded
* Historical linkability is removed

LibertySwap cannot override or bypass this privacy layer.

## 6. Compliance and Responsibility Boundary

\
LibertySwap:

* Does not custody funds
* Does not initiate transactions on behalf of users
* Does not control Railgun cryptography
* Does not deanonymize users

Users are fully responsible for:

* Their wallet security
* Their jurisdictional compliance
* Their transaction intent

LibertySwap provides software and routing infrastructure only.

\
7\. Summary Table
-----------------

<table data-header-hidden><thead><tr><th valign="middle"></th><th valign="middle"></th><th valign="middle"></th></tr></thead><tbody><tr><td valign="middle">Category</td><td valign="middle">LibertySwap Knows</td><td valign="middle">LibertySwap Does Not Know</td></tr><tr><td valign="middle">Transaction Status</td><td valign="middle">Yes</td><td valign="middle">—</td></tr><tr><td valign="middle">Network Path</td><td valign="middle">Yes</td><td valign="middle">—</td></tr><tr><td valign="middle">Asset Type</td><td valign="middle">Yes</td><td valign="middle">—</td></tr><tr><td valign="middle">User Identity</td><td valign="middle">—</td><td valign="middle">Yes</td></tr><tr><td valign="middle">Wallet Ownership</td><td valign="middle">—</td><td valign="middle">Yes</td></tr><tr><td valign="middle">Shielded History</td><td valign="middle">—</td><td valign="middle">Yes</td></tr><tr><td valign="middle">Sender Recipient Links</td><td valign="middle">—</td><td valign="middle">Yes</td></tr></tbody></table>

## 8. Final Statement

LibertySwap is designed to minimize data exposure by default. When users utilize Railgun Routes, LibertySwap only processes the minimum technical information required to complete swaps, while Railgun ensures cryptographic privacy at the transaction level.

LibertySwap cannot identify users, trace shielded funds, or reconstruct transaction histories beyond public chain confirmations.

Privacy is not a promise. It is an architectural constraint.


# Railgun Private Sends: Privacy and Fee Structure

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

## What are Railgun Private Sends?

Railgun has three forms of transactions inside of shielded balances with different levels of privacy: Private Sends, Private Swap, and Private DeFi.

<figure><img src="/files/O9Pxn9agj4xIDP5qznZa" alt=""><figcaption></figcaption></figure>

Private Sends are transfers from one shielded address to another shielded address inside Railgun with the highest level of privacy: complete privacy. This is the simplest and strongest privacy flow in Railgun.

{% hint style="info" %}
Private Sends? From an 0zk address to another 0zk address
{% endhint %}

Private Sends happen entirely inside Railgun’s privacy system.

* No public blockchain transaction is created.
* No miner or validator interaction is required.
* No gas is paid by the user.

Because nothing is written publicly on chain, the cost is minimal and predictable.

LibertySwap is designed to preserve this strong privacy model.

Our swap flows are built so that:

* Funds remain shielded as long as possible.
* Swaps originate from shielded balances.
* Users benefit from Railgun’s strongest anonymity guarantees.

## Railgun Private Sends Fee Structure and Estimation

{% hint style="info" %}
Railgun 0zk → 0zk Transfer Fees (Ethereum Example)
{% endhint %}

For a Railgun 0zk → 0zk private transfer on Ethereum, the fee you pay is essentially independent of the value transferred. Whether you send $10 or $100,000, the underlying transaction cost remains roughly the same. This is because the fee is driven by computation and network gas price, not the dollar amount of the transfer.

\
**What the Fee Depends On**

*zk-SNARK Transaction Gas:*&#x20;

* Railgun uses zero-knowledge proofs for private transfers.&#x20;
* The gas consumed by proof verification and shielded state updates is almost fixed for a single private send.

*Underlying Chain Gas Price (Real Estimate)*

* Current Ethereum gas prices are extremely low, around 0.03–0.5 Gwei at the moment. &#x20;
* With Ether trading around $3,200 per ETH, this results in minimal fees even for complex contract interactions. &#x20;

*Relayer Premium*

* Railgun relayers add a small premium on gas, usually around 10% over the base gas cost. &#x20;
* This premium can vary by relayer and market conditions.

\
**What the Fee Does NOT Depend On**

*Transfer Amount*

* The fee is not proportional to how much value you move.
* Railgun does not charge per dollar moved for private transfers.

*Percentage-Based Protocol Fees*

* Private 0zk → 0zk transfers do not incur percentage fees like shielding/unshielding does.

**Practical Ethereum Cost Estimate (Right Now)**\
Assuming:

* An estimated zk-SNARK Railgun transaction uses a substantial amount of gas compared to a simple transfer (eg hundreds of thousands of gas units),
* Gas price \~0.1–0.5 Gwei as seen on Ethereum today, &#x20;
* Ether price around $3,200 per ETH,&#x20;

{% hint style="info" %}
Estimated Railgun 0zk → 0zk Fee: Approximately $0.50 to $2.00 total, including relayer premium.
{% endhint %}

This is much lower than what many users remember from earlier years, thanks to recent upgrades that have compressed gas prices and lower on-chain congestion.&#x20;

**When Fees Can Change**

Fees may be higher if:

* You include multiple assets in one private transfer.
* Ethereum gas prices rise due to higher demand.
* You choose a relayer charging a higher premium.


# Cross-Chain Swaps

Liberty Swap provides a non-custodial, intent-based mechanism for executing cross-chain swaps across multiple blockchain networks. The protocol is designed to allow users to exchange assets between chains while retaining control over execution parameters, custody, and privacy posture. All cross-chain swaps are executed through deterministic smart contract logic and cryptographic authorization, without reliance on centralized intermediaries or off-chain custody.

Cross-chain functionality within Liberty Swap is **PulseChain-centered by design**, enabling efficient capital movement into and out of the PulseChain ecosystem while maintaining conditional support for other inter-chain routes when liquidity and execution reliability thresholds are met.

## 1. Supported Blockchains

Liberty Swap currently supports cross-chain swaps across **six blockchain networks**, with additional networks under active evaluation:

| Blockchain      | Chain ID |
| --------------- | -------- |
| PulseChain      | 369      |
| Ethereum        | 1        |
| Base            | 8453     |
| Solana          | 101      |
| BNB Smart Chain | 56       |
| Arbitrum One    | 42161    |

Each supported network is integrated directly at the protocol level. Liberty Swap does not rely on custodial wrappers, or off-chain ledger systems. Cross-chain settlement occurs through on-chain contract interactions and cryptographically enforced execution rules.

***

## 2. Supported Assets and Swap Directionality

### Standard Execution Mode

In standard execution mode, Liberty Swap supports a defined set of input tokens that may be used to initiate cross-chain swaps: USDC, USDT, DAI, ETH, PCOCK, PLS, and PDAI.

From these inputs, users may swap into **hundreds of supported destination tokens** across available networks. Destination asset availability depends on network support and real-time liquidity conditions. Liberty Swap does not guarantee availability of any specific asset pair.

### Private Execution Mode

Private execution mode is currently available on a limited basis. At present, private cross-chain swaps are supported only for:

* ETH (Ethereum) ↔ WETH (PulseChain)

This restriction reflects the additional cryptographic and liquidity requirements of zero-knowledge execution. Private mode support will expand incrementally as infrastructure and liquidity conditions allow. Availability of private routes should not be assumed beyond those explicitly listed at the time of execution.

### Swap Routing Model

Liberty Swap employs a PulseChain-centered routing model. Cross-chain swaps involving PulseChain, either inbound or outbound, are prioritized and broadly supported.

Cross-chain swaps that do **not** involve PulseChain (for example, Base ↔ Ethereum) may be enabled selectively. Such routes are made available only when sufficient liquidity depth, pricing stability, and execution reliability can be maintained. This conditional routing policy is intended to protect users from partial execution, excessive delays, extreme volatility, or unpredictable settlement outcomes.

All routing decisions are constrained by the user’s signed intent and executed deterministically. Liberty Swap does not exercise discretionary control over trade outcomes or asset pricing.

### Execution Flow

When initiating a cross-chain swap, the user defines an intent specifying:

* execution mode (standard or private),
* input asset and amount,
* destination chain and asset.

Each intent is assigned a temporary Order ID for status tracking. Upon execution, the underlying blockchain transactions generate one or more transaction hashes, which are verifiable directly on the respective networks. Liberty Swap does not retain transaction hashes or maintain off-chain transaction records. Verification remains entirely user-controlled via public blockchain explorers.

{% hint style="success" %}
Users may submit requests for additional swap routes or asset pairs through Liberty Swap’s public communication channels. Such requests are non-binding and subject to technical feasibility, liquidity availability, and protocol security assessments. Liberty Swap does not guarantee the addition of any requested route or pair.
{% endhint %}

***

## 3. Fees

Liberty Swap applies a transparent, flat transaction fee model for cross-chain swaps:

* **Inbound swap fee:** 0.3%
* **Outbound swap fee:** 0.5%

These fees are applied deterministically based on swap direction and execution path. Fee rates may be adjusted in response to liquidity conditions, network costs, or market dynamics. Any applicable fees are disclosed to the user prior to confirmation and execution.

***

## 4. Swap Limits

To maintain liquidity stability and protect user experience, each transaction must adhere to the following constraints:

* **Minimum Swap Size:** 10 USDC/0.003 ETH (or equivalent)
* **Maximum Swap Size:** 25,000 USDC/20 ETH (or equivalent)

Limits may vary by route or execution mode and may be updated as liquidity conditions evolve. These constraints are enforced programmatically and disclosed prior to execution.

***

## 5. Smart Contract Addresses

### Current Addresses

| Network                                                    | Smart Contract Address                                                                                                                            |
| ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| PulseChain                                                 | <p>• USDC: 0xe7EE706a6708b691a232452c9cb267d186942F09                                                                                             |
| <br>• WETH: 0x80C2C603d72ea17A0D85B670D4489eB3012035Cd</p> |                                                                                                                                                   |
| Base                                                       | • USDC: 0x8871de4668D3CF1FB7F93Baf4a78FEB0d1E13869                                                                                                |
| BSC                                                        | <p>• USDC: 0x43f403972080406e3e6602793A5072DBc4389bAb                                                                                             |
| <br>• USDT: 0xc438D51F296fF3e53d061293D2bC4Bb9fb2f7f19</p> |                                                                                                                                                   |
| Arbitrum                                                   | • USDC: 0x05216280d45Bb8E8dcb863186E4762090bab7b6F                                                                                                |
| Ethereum                                                   | <p>• USDC: 0x06291eeE038e94E8DEC2b3bfB6e030c0b5615506                                                                                             |
| <br>• USDT: 0x12352B55e0b4305Dd83A349A5d7845bE9B5a2Eea     |                                                                                                                                                   |
| <br>• DAI: 0xAA7a195D69327a894eeb969D3bCb89116FC78A14      |                                                                                                                                                   |
| <br>• ETH: 0x60FDAf9198eFCD6fAF27D50E955e1A42905f2eeb</p>  |                                                                                                                                                   |
| Solana (Program ID)                                        | • USDC: LBSarUewo4GFr8z8ekaCewLK2daJfTzV13h9GSkkSb3                                                                                               |
| Others                                                     | <p>• Fund Balancer Wallet: 0xDB8AA76f4B32Ed107d47983261f91178fEeafC0c<br>• Gasless Support Wallet: 0x42ec2a5fc5a23553a353a4219a42dea765877160</p> |

### Old Addresses

| Network                                                                                                                                        | Smart Contract Address                                                                                                                                                                      |
| ---------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| PulseChain                                                                                                                                     | <p>0x8dC4aBf5Bc294dEF5c4bB1D3398528D28f714416                                                                                                                                               |
| <br>0xC1fBB3a198917FF62342d2D00407Eab56Ee4c99A<br>0x0E0eDDaE092176d851d5C70A49b5d83e2510e72f<br>0x63F334D054236e51C241E0bf6b095E67448A4366</p> |                                                                                                                                                                                             |
| Ethereum                                                                                                                                       | <p>0x317DD5Ab50C6948f6486b9Ed65c4Ba1eb678a529<br>0xA06Bb3F88c3F4A8D92342799dC2D27Ba12174315<br>0x79e5EBA07ccBf03506c871f6114a112f3A879418<br>0xFfCA0FebFc9B9C73dB9e2b2C5FA453656668a402</p> |
| Base                                                                                                                                           | <p>0x59deC8b4733F333937039ca2d171c87Ff4590429                                                                                                                                               |
| <br>0xC1fBB3a198917FF62342d2D00407Eab56Ee4c99A<br>0x1A19B9f2687C390a130a261d1E9f0B34f5ABf312</p>                                               |                                                                                                                                                                                             |
| BSC                                                                                                                                            | <p>0xA5ebb6f9329096465EE4Ba3DB7b04f0fBf5CB2d4<br>0xA377f83BB5F63cb03f1ED7F9C1edB4BEC8db9CBC<br>0x36eF9AC33A138D6b5452fd6211f23bBb51c889c6</p>                                               |
| Arbitrum                                                                                                                                       | <p>0x895BaDA008609619394107AaBD81bDb611DFB4ed<br>0xfFf6bf6a8B42B3A4ba833FD3A0875154B885D4fc</p>                                                                                             |
| Solana                                                                                                                                         | HG3XyB1ZvR3DQB6a5gmK9w6bpcVwiXS7tXv6wJze5bpE                                                                                                                                                |
| Others                                                                                                                                         | 0xc4459301147058872013f34e2ada930e7217543b                                                                                                                                                  |


# PulseChain Card Payments

Using a crypto payment card always involves two steps:

1. Load your card
2. Spend with your card

## Current Option

You can already load your card with **USDC from PulseChain**:

* Send USDC through **LibertySwap** to **USDC on Base**
* Set your [**Cypher card address**](https://cypherhq.io/card/) or any crypto card address as the destination

## **Advantages**

* Up to **9% cashback** in USDC
* **1:1 USD exchange rate** (no extra forex fees)
* **Minimal KYC** requirements

## Future Options

Work is underway to allow direct funding with **PLS and other PulseChain assets**.

* LibertySwap can whitelist service providers to reduce cross-chain fees
* The process will still follow the same two steps:
  1. Load your card
  2. Spend with your card


# Fiat On and Off Ramp with Peer

No KYC. No middlemen. Just code.

Using [Peer](https://www.zkp2p.xyz/) with LibertySwap allows users to move funds from traditional Web2 payment apps such as Venmo, Revolut, and Wise directly into crypto through trustless on ramping powered by zero knowledge proofs. The off ramp works the same way, enabling users to convert crypto back to fiat privately without relying on centralized intermediaries.

Learn more about Peer via this [official tutorial](https://youtube.com/playlist?list=PLAEkz-ou5ssDD7YPdVcVjGo8rsbQz9Xve\&si=7YHiwG9Ut1JZQk00) from the Peer Team.

LibertySwap acts as an interface that facilitates cross-chain transactions, enabling users to receive USDC or PLS on PulseChain without using a centralized exchange.&#x20;

{% hint style="info" %}
Currently, LibertySwap users can access ZKP2P from the LibertySwap interface. Please note that ZKP2P is a third-party application not operated by LibertySwap.
{% endhint %}

<div><figure><img src="/files/ERNchq3VCbSocA6DNzbo" alt=""><figcaption></figcaption></figure> <figure><img src="/files/wLruoBfWr2lQJTuDDJrN" alt=""><figcaption></figcaption></figure></div>


# Buy Crypto with Fiat Using Peer

LibertySwap integrates with Peer to provide a seamless way to purchase crypto using fiat currency.

Follow these steps to get started:

#### 1. Access LibertySwap

* Go to: [https://libertyswap.finance](https://libertyswap.finance?utm_source=chatgpt.com)

#### 2. Click “Buy”

* On the main interface, click the **“Buy”** button
* You will be redirected to the fiat on-ramp flow powered by Peer

#### 3. Complete the Purchase via Peer

* Follow the official onboarding and purchase guide here:\
  <https://docs.peer.xyz/guides/for-buyers/complete-guide-to-onboarding>

This guide will walk you through:

* Account setup (if required)
* Selecting payment method (card, bank transfer, etc.)
* Choosing the crypto asset and network
* Completing the transaction

#### Notes

* The entire fiat purchase process is handled by Peer
* Available payment methods and fees may vary depending on your region
* Make sure to select the correct **network and wallet address** before confirming

Once completed, your purchased crypto will be sent directly to your connected wallet, ready to use within LibertySwap.


# Solana ⇄ PulseChain Bridging

As Liberty Swap prepares to open direct bridging between Solana (SVM) and PulseChain (EVM), it is critical for all users to understand the inherent technical differences and risks involved.

## Cross-Chain Complexity: Solana vs. EVM

Bridging from Solana to an EVM-compatible blockchain like PulseChain is not as straightforward as other EVM-to-EVM transfers. The Solana and EVM ecosystems are fundamentally different in how they manage cryptographic keys and wallet infrastructure.

### ⚠️ Key Incompatibility Warning

Solana and EVM chains use **different cryptographic curves**:

* **Solana:** Uses `Ed25519`
* **EVM Chains (Ethereum, PulseChain, BNB, Arbitrum, Base, etc.):** Use `secp256k1`

These cryptographic schemes are **not natively compatible**. While it is *technically* possible to derive or convert keypairs across chains using advanced tools, this is **strongly discouraged** in production environments due to the following risks:

* 🔐 **Security Vulnerabilities:** Nonstandard keypair converters or smart wallet hacks may expose your keys or funds.
* ⚠️ **Lack of Guarantees:** These methods are often experimental, centralized, or unsupported by mainstream wallet providers.
* ❌ **Incompatible Wallets:** Common Solana wallets like **Phantom** and other EVM wallets like might not share infrastructure and cannot use the same private key safely.

## Recommended Best Practices

To ensure the safe use of our Solana–PulseChain bridge, we advise all users to:

* **Maintain separate seed phrases and private keys** for Solana and EVM-compatible blockchains.
* **Use a trusted multi-chain wallet** such as:
  * **Ledger** (hardware wallet with native support for both key types)
  * **Rabby Wallet** or **XDEFI Wallet** (multi-chain software wallets with dedicated key management)
* **Double-check recipient addresses** when bridging assets. While Liberty Swap's bridging system ensures safe and accurate execution, incorrect address input by users cannot be reversed.

## Built-In Warnings for Safety

To mitigate the risk of misconfiguration:

* Liberty Swap implements **dynamic warning systems** that alert users during the bridging process.
* When operating on an EVM chain, users may be prompted to switch to a compatible PulseChain wallet.
* However, for **SVM ⇄ EVM transfers**, **error recovery is significantly more limited**. Always verify that your wallet is compatible and correctly configured before initiating a transfer.

***

**In short:**\
Solana and EVM are fundamentally different ecosystems. Treat them as such. For maximum security, always use distinct keys, trusted wallets, and follow all prompts and warnings provided by Liberty Swap.

If you're unsure at any step, contact Liberty Swap's support before proceeding.


# Transaction Export

### Overview

The Transaction Export feature allows users to export transaction records processed through the Liberty Swap protocol.

By connecting a supported wallet to the Liberty Swap Explorer, users can generate and download their transaction history for personal record keeping, portfolio management, accounting, or tax reporting.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqaQp0E2p9WUSJko6TzUr%2Fuploads%2F2ar5ioIZcsO1IMw6zlfh%2FLiberty_Swap_C.R.O.P.S._on_PulseChain_-_We_have_added_an__Export__function_to____Thi_bURrZR.mp4?alt=media&token=e2666061-66fd-43b4-88c6-195a50b95abd>" %}

The export feature is available through:

[**https://scan.libertyswap.finance**](https://scan.libertyswap.finance)

## Supported Data

The exported transaction history includes all transactions executed through Liberty Swap that are associated with the connected wallet.

Depending on the transaction type, exported records may include:

* Transaction hash
* Block number
* Timestamp
* Source network
* Destination network
* Wallet address
* Token symbols
* Token amounts
* Transaction status
* Swap or bridge operation details

The available fields may expand as additional protocol features are introduced.

## Exporting Transactions

To export your transaction history:

1. Visit [**https://scan.libertyswap.finance**](https://scan.libertyswap.finance)
2. Connect your wallet.
3. Navigate to your transaction history.
4. Select **Export**.
5. Download the generated transaction file.

Only transactions associated with the connected wallet will be included in the exported data.

## Supported Use Cases

The exported transaction history can be used for a variety of purposes, including:

* personal transaction records
* portfolio tracking
* accounting
* tax reporting
* auditing wallet activity
* historical transaction analysis

The exported data is intended to simplify record management for users interacting with the Liberty Swap ecosystem.

## Privacy

Transaction exports are generated only after wallet ownership has been verified through a wallet connection.

Liberty Swap does not require users to create an account or provide personally identifiable information in order to export transaction history.

Exported records contain publicly available blockchain transaction data associated with the connected wallet.

## Future Development

The current export feature is focused on transactions executed through the Liberty Swap protocol.

Future releases will expand this functionality to support comprehensive transaction exports across the PulseChain ecosystem, enabling users to generate unified transaction histories for:

* decentralized exchanges
* token transfers
* liquidity positions
* staking activities
* additional on-chain interactions

This functionality is intended to simplify portfolio management, accounting workflows, and tax reporting for PulseChain users through a single export interface.


# Core Architecture

Liberty SHIELD is a unified privacy and routing layer designed for dApps across any blockchain to integrate and use.

{% hint style="info" %}
LibertySwap is one of the applications that leverages Liberty Shield to facilitate private swaps. See [Liberty Shield vs Liberty Swap](/general-information/introduction/liberty-shield-vs-liberty-swap)
{% endhint %}

Liberty SHIELD enables users to move assets into and out of Railgun and other privacy protocols seamlessly, while preserving strong privacy guarantees and reducing cross-chain complexity.

Liberty Shield abstracts away gas management, relayers, and liquidity fragmentation, allowing users to focus on outcomes rather than infrastructure.

<div><figure><img src="/files/QCXIlXDNxUGY0eXDIKkb" alt=""><figcaption></figcaption></figure> <figure><img src="/files/F360MuMQFPVFMPyN28rw" alt=""><figcaption></figcaption></figure></div>

## Functionality

*At launch, Liberty Shield supports the following flows on*&#x20;

* Shield ETH:\
  Convert public ETH on Ethereum into a private Railgun balance instantly.
* Unshield ETH:\
  Convert ETH held in a Railgun balance back into public ETH on Ethereum instantly.

These operations are executed directly from the Railgun system and do not rely on external liquidity pools.<br>

*In the future state:*

* Users can shield multiple assets, such as ETH and stablecoins, from many source blockchains into Railgun and other supported privacy protocols and layers.
* From a shielded balance, for example a Railgun balance, users can unshield assets to any supported destination chain.
* The destination chain does not need native Railgun or other privacy protocol or layer support.
* Liberty Shield becomes the universal entry and exit point for leading privacy protocols and layers.

## How Shielding Works

1. Users start with assets on a public blockchain.
2. Liberty Shield routes the assets into Railgun or other privacy contracts.
3. Funds appear as shielded balances inside Railgun or other privacy contract balances.
4. Public transaction history is broken, and assets gain strong privacy guarantees.

From this point forward, all actions originate from shielded balances.

## How Unshielding Works

1. Users choose a destination chain and asset.
2. Liberty Shield routes funds out of Railgun or other privacy contract balances
3. Assets are delivered directly to the destination chain.
4. The user receives funds without revealing source history.

This works even if the destination chain does not natively support Railgun.

\
Fees and Execution Model
------------------------

Liberty Shield uses a simple fixed fee model:

0.5% total fee, covering:

* Blockchain gas fees
* Railgun fees
* Relayer fees
* Cross chain execution costs
* Gasless for users
* Instant execution
* No liquidity constraints

There are no variable fees, no gas estimation issues, and no need to manage multiple tokens for gas.


# Liberty Shield SDK

Working on this page

TBA


# Shield and Unshield Your Coins with Liberty Shield

This page provides guidance on using LibertySwap to shield and unshield your coins effectively while maintaining your privacy and protecting your trades.

{% hint style="info" %}
It is provided for general educational and informational purposes only and does not constitute legal, financial, or compliance advice.
{% endhint %}

## Step 1. Prepare a clean execution wallet

`Use a fresh EVM wallet. This wallet should have no public history tied to your identity.`

`Do not use wallets previously posted on X, Discord, or GitHub.`

This wallet is only for receiving and using unshielded funds later.

## Step 2. Shield funds using LibertySwap. Inbound

`Go to Shield mode.`\
`Select ETH.`\
`Enter an amount using common, rounded values.`\
`Enter your Railway wallet private 0zk address.`\
`Confirm the shield transaction.`

Why this is safe?

* LibertySwap pays the transaction fee.
* No personal wallet sponsors gas.
* Your funding wallet is not linked to the Railgun withdrawal later.

<figure><img src="/files/8qjXtpL9Sq3qC5nBOExD" alt=""><figcaption></figcaption></figure>

## Step 3. Wait. Do nothing.

`Do not unshield immediately.`\
`Wait hours or days.`\
`Let your funds blend into the anonymity set.`

Time variance is privacy.<br>

## Step 4. Unshield using LibertySwap. Outbound

\
`Switch to Unshield mode.`\
`Select ETH. RAILGUN.`\
`Enter a non unique, rounded amount.`\
`Enter the clean execution wallet address.`\
`Confirm.`

Key protection:

* LibertySwap pays the fee.
* No external gas payer wallet.
* No A → B correlation possible.

<figure><img src="/files/WaRtm1yHEnwNC49LGiZM" alt=""><figcaption></figcaption></figure>

## Step 5. Optional. Private cross chain or private swap

If you want to move or trade:

`Use Exchange → Private mode.`

`Swap ETH. RAILGUN directly to PLS or other supported assets.`

`Receive directly into your clean execution wallet.`

You will have PLS to pay gas on PulseChain

<figure><img src="/files/btVRp33VADDhSfCSXI3a" alt=""><figcaption></figcaption></figure>

## Step 6. Post execution discipline

`Do not immediately trade, deploy, or bridge.`

`Avoid deterministic sequences like unshield → deploy token.`

`Introduce delays and randomness.`

Behavior is metadata.

## Step 7. Social OPSEC. Critical

`Do not post transactions on X.`

`Do not flex timing.`

`Do not reuse known addresses.`

Once inside Railgun, disappear.


# Overview

Liberty DEX is a permissionless, ZERO fee, gas less protocol, MEV protection designed for executing token swaps through a competitive auction mechanism across multiple liquidity sources.

Rather than routing trades exclusively through a single automated market maker (AMM), Liberty DEX introduces an open execution layer where independent participants compete to fulfill swap intents. These participants may source liquidity from AMMs, private inventory, or other on-chain venues in order to provide the best possible execution.

Liberty DEX is integrated into the Liberty Swap ecosystem and will initially support the Ethereum mainnet and other compatible networks, with additional chain support planned over time.


# Core Architecture

Working on this page

TBA


# Benefits for Swappers

By separating order creation from order execution, Liberty DEX enables several improvements compared with traditional AMM swaps:

#### Improved pricing

Liquidity can be sourced from multiple venues rather than a single pool. Competing executors are incentivized to provide better prices in order to win the swap.

#### Gasless swapping

Users do not need to submit on-chain transactions directly. Execution costs are handled by the party that fulfills the order.

#### Protection from MEV

Swap execution can occur through private transaction relays, reducing exposure to front-running and other forms of extractive MEV.

#### No cost for failed execution

If an order cannot be filled, users do not incur failed transaction fees.

<br>


# Supported Tokens

Liberty DEX supports a broad range of tokens that are available within the default token set integrated into the Liberty Swap interface.

Any asset included in this supported token list may be routed through the Liberty DEX execution layer, provided that sufficient liquidity is available across connected venues.

### Quote Variability

Swap quotes generated through Liberty DEX are not fixed and may change over time.

Because execution is handled by a competitive network of independent executors, quoted prices depend on current market conditions and the ability of participants to fulfill the order efficiently. Factors such as liquidity availability, routing opportunities, and network conditions can all influence the final execution price.

As a result, a quote may be updated or may not be executable if market conditions change before the order is filled.


# Minimum Swap Size

Liberty DEX does not enforce a fixed minimum swap amount at the protocol level. However, the availability of Liberty DEX routing depends on whether a swap can be executed efficiently under current network conditions.

In practice, swaps below a certain value threshold may not be routed through Liberty DEX. This is because the total execution cost, including network fees and routing complexity, must remain economically viable for executors.

The effective minimum swap size is therefore dynamic and may vary depending on factors such as:

* current network fees
* asset liquidity
* routing complexity
* executor participation

If a swap does not meet these conditions, it may be routed through alternative execution paths within the interface instead of Liberty DEX.

This design ensures that Liberty DEX is used only when it can provide efficient and competitive execution outcomes.


# Execution Model

Liberty DEX operates through an intent-based swap system.

Instead of directly submitting a transaction to an AMM, a user signs an off-chain order describing the desired trade parameters. This signed order specifies the asset being sold, the asset being received, and acceptable pricing bounds.

The order is then broadcast to a network of independent executors. Each executor evaluates whether the order can be profitably fulfilled by combining liquidity sources, routing strategies, or internal inventory.

If an executor determines that the order can be filled within the specified parameters, the executor submits an on-chain transaction that completes the swap. In return for executing the trade, the executor captures any remaining routing surplus.

To ensure users always receive competitive pricing, orders may gradually adjust over time within the defined bounds. This mechanism allows other executors to step in if better execution becomes available.

## Liquidity Routing

Executors participating in Liberty DEX may fulfill orders in several ways:

* routing through automated market makers
* combining liquidity across multiple protocols
* using privately held inventory
* executing multi-hop routing strategies

Because the execution layer is open and competitive, participants continuously search for the most efficient routing paths across available liquidity.

## Price Improvement

By allowing swaps to access liquidity beyond a single protocol, Liberty DEX can produce execution prices that exceed what a user would receive from a direct AMM trade.

Advanced routing strategies may capture surplus value that would otherwise be extracted by MEV arbitrageurs. In Liberty DEX, this value can instead be shared with the user through improved swap outcomes.

## MEV Mitigation

Execution responsibility is delegated to specialized executors. These participants may submit transactions through private relays, which helps reduce the likelihood of front-running or other adversarial transaction ordering strategies.

This architecture improves trade privacy while protecting swap outcomes from common forms of MEV exploitation.

<br>


# Open Execution Network

Liberty DEX relies on an open network of independent third-party executors to fulfill swap orders.

These participants compete to execute user intents by sourcing liquidity from multiple on-chain venues, internal inventory, or advanced routing strategies. Because execution is competitive, participants are incentivized to deliver the most efficient trade in order to capture the order.

This architecture can improve swap outcomes for users in several ways:

#### Price improvement through aggregated liquidity

Executors are able to route trades across multiple liquidity sources rather than relying on a single pool. By combining liquidity from different venues, Liberty DEX can often deliver better execution prices than a direct AMM swap.

#### Gasless swap submission

Orders are signed off-chain and executed by network participants. The executor who fulfills the order is responsible for submitting the transaction, removing the need for users to pay network fees directly.

#### No cost for failed execution

If an order cannot be completed, no on-chain transaction is submitted by the user. As a result, users avoid the network costs typically associated with failed transactions.

#### Reduced exposure to MEV

Executors may submit transactions through private relays or protected execution channels, reducing the likelihood of front-running and other MEV extraction strategies that can negatively impact swap outcomes.

<br>


# Swap Execution Errors

In some situations, a Liberty DEX swap request may not be executed successfully. When this occurs, the interface may display a notification indicating that the swap could not be completed at that moment.

A swap may fail to execute for several reasons, including:

#### Submission errors

An issue may occur while broadcasting the signed order to the Liberty DEX execution network. If the order is not successfully propagated, it cannot be evaluated by executors.

#### Signature issues

If a problem occurs during the order signing process, the order cannot be validated or processed by the execution layer.

#### Token approval inconsistencies

In certain cases, existing token approvals may prevent the order from being processed correctly. Revoking the approval and submitting a new approval transaction can resolve this issue.

Because Liberty DEX orders are created and distributed off-chain, a failed or unfilled swap does not generate an on-chain transaction from the user. As a result, no network fees are incurred when execution is unsuccessful.

If a swap cannot be filled, the order can simply be submitted again after the issue has been resolved.

<br>


# How to Swap with Liberty DEX

Swaps executed through Liberty DEX follow an intent-based flow, where the user signs an order and the execution is handled by the network.

#### Step 1: Connect Wallet

Access the [Liberty DEX](https://dex.libertyswap.finance/) interface and connect a supported wallet.

<figure><img src="/files/7uKz03EjdDKyctj3pOrc" alt=""><figcaption></figcaption></figure>

#### Step 2: Select Assets

Choose the asset to swap from and the asset to receive.

Supported tokens can be selected from the available token list. Availability depends on supported assets and accessible liquidity within the execution network.

<figure><img src="/files/cuPPLF81mPK2Mh303xd7" alt=""><figcaption></figcaption></figure>

#### Step 3: Enter Amount

Specify the amount to swap, users may input the amount to send.

The interface will automatically calculate the corresponding value based on current quotes.

An option to use the maximum available balance may also be provided.

#### Step 4: Review and Initiate Swap

Review the quoted price and execution details, then proceed to initiate the swap.

<figure><img src="/files/06NpVkgSxL7rvNU83bfl" alt=""><figcaption></figcaption></figure>

#### Step 5: Approve Token Access

If the selected token has not been previously approved, an approval transaction is required to allow the protocol to interact with the asset.

This step requires an on-chain transaction and associated network fees.

#### Step 6: Sign Order

After approval, the user signs an off-chain message representing the swap intent.

This signature authorizes the execution of the swap under predefined parameters and does not require network fees.

<figure><img src="/files/6qh84hDiz9IBm7otgTib" alt=""><figcaption></figcaption></figure>

#### Step 7: Order Submission

Once signed, the order is submitted to the Liberty DEX execution network.

Independent executors evaluate the order and attempt to fulfill it by sourcing liquidity and submitting the corresponding on-chain transaction.

#### Step 8: Execution and Settlement

If an executor successfully fills the order, the swap is completed and the output assets are delivered to the user’s wallet.

Execution status is reflected in the interface once the transaction is confirmed on-chain.

<figure><img src="/files/Scf4ONNz8fwGMfGVGkBG" alt=""><figcaption></figcaption></figure>

### Additional Notes

**Native asset handling**

When swapping native assets (such as PLS, WPLS), an additional transaction may be required to convert the asset into its wrapped/unwrapped equivalent before execution. This step incurs network fees.

<figure><img src="/files/PmC9rU1jTUSH2vArHe7Y" alt=""><figcaption></figcaption></figure>


# Network Costs

All blockchain transactions require network fees in order to be processed. Within Liberty DEX, the responsibility for transaction submission is delegated to executors, which changes how these costs are handled from the user’s perspective.

In most cases, the executor who fulfills the order covers the network costs associated with executing the swap. These costs are incorporated into the final execution price rather than charged separately to the user.

Executors may optimize execution costs by batching multiple orders, sourcing liquidity efficiently, or using internal inventory. This allows overall transaction costs to be reduced at the system level.

As a result, users are not required to hold the native token of the network in order to perform swaps, and no network fees are incurred if an order is not executed.

### When Users Pay Network Fees

There are specific cases where users may still incur network costs:

**Token approvals**

If a token has not been previously approved, an on-chain approval transaction is required. This step incurs standard network fees.

**Native asset (PLS) wrapping**

When swapping native assets (such as PLS), the asset may need to be converted into its wrapped form before execution. This conversion requires an on-chain transaction and associated network costs.


# Slippage Handling

Liberty DEX does not use a user-defined slippage setting in the traditional sense.

Instead of relying on manual slippage tolerance, each swap is executed based on predefined pricing bounds included in the signed order. These bounds define the acceptable execution range for the trade and are enforced at the protocol level.

### Execution Guarantees

Before submitting a swap, the interface provides a best output amount.

This value represents the best amount of tokens the user will receive if the order is executed. Any execution that does not meet this condition will not be completed.

Because pricing constraints are embedded directly into the order, users are protected from unfavorable price movement without needing to configure slippage manually.

### Comparison to Traditional Swaps

In conventional AMM-based swaps, slippage tolerance must be explicitly defined by the user and may expose the trade to price impact or MEV-related risks.

In Liberty DEX, pricing constraints are enforced through the intent-based execution model, removing the need for manual slippage configuration while ensuring predictable outcomes.

***

This approach simplifies the swap experience while maintaining strict control over execution quality.


# Limit Orders

Introducing a new way to trade - combining self-custody, privacy, and zero-friction execution into a single seamless experience.

Built with Permit2 and an **intent-based execution model**, Liberty DEX allows users to place limit orders without ever giving up control of their assets.

***

### A Smarter Way to Trade

Traditional limit orders often require users to:

* Lock funds in advance
* Pay gas fees upfront
* Expose their strategy on-chain

Liberty DEX changes that.

With Liberty DEX Limit Orders, your trade is treated as an **intent**, not an immediate transaction. Execution is handled by **fillers** who compete to fulfill your order under the exact conditions you set.

### Key Advantages

#### Full Self-Custody

* Your tokens **remain in your wallet at all times** until the order is executed. No deposits, and no smart contract lockups.

#### Exact Execution Only

* Only the **exact amount required** for the trade is used. No overfills, no hidden deductions.

#### Powered by Permit2

* Secure signature-based approvals
* No need for repeated token approvals
* Reduced risk of malicious spending

#### No Pre-Locking, No Early Movement

* Funds are **never locked or moved prematurely**.
* Execution happens **only when conditions are met**.

#### 100% Gasless

* No gas fees for placing orders
* No gas fees for execution

Users interact with the system **without paying network costs**.

#### No Minimum Size

Whether you're trading small or large amounts:

* **No minimum order size**
* Fully flexible participation

#### Aggregated Liquidity

Liberty DEX taps into on-chain liquidity and off-chain liquidity. This ensures **better pricing and deeper execution opportunities**.

#### Private by Default

Your orders are:

* **Not visible on-chain** before execution
* Protected from front-running and MEV

Your strategy stays **confidential until filled**.

### How It Works (Simplified)

1. You create a limit order by signing an intent
2. The order is broadcast to fillers (off-chain)
3. Fillers execute the trade when conditions match
4. Tokens are transferred **directly from your wallet at execution**

### Summary

**Liberty DEX Limit Orders redefine trading UX:**

* No custody risk
* No gas friction
* No strategy leakage
* No unnecessary complexity

It’s a system designed for traders who want **control, privacy, and efficiency - all at once**.


# How to Use Limit Orders

**Liberty DEX Limit Orders** are designed to be simple, gasless, and fully self-custodial. Below is a clear step-by-step guide to help you get started.

### 1. One-Time Setup

Before placing your first order, you need to approve Permit2.

* This allows the protocol to **execute trades on your behalf only when conditions are met**
* Requires a **small gas fee**
* Done **once per token** (not per order)

<figure><img src="/files/qG22YVlW94lnrkRk3axX" alt=""><figcaption></figcaption></figure>

After this step, you won’t need to approve again for future orders.

### 2. Place Your Order (Gasless)

* Enter:
  * Token pair (e.g. ETH → USDC)
  * Desired price
  * Amount
  * Expiry time
* Sign the order with your wallet

<figure><img src="/files/BH7va7g7lfZjvgQj7wOd" alt=""><figcaption></figcaption></figure>

Important:

* This is **just a signed message (intent)**
* **No on-chain transaction happens**
* **No gas fee required**
* Your tokens **stay in your wallet**

<figure><img src="/files/KBXUpQM7K1lifMLNKhDc" alt=""><figcaption></figcaption></figure>

### Setting Limit Prices with ±% (Buy Low / Sell High)

Liberty DEX makes it easy to define your desired execution price using **quick percentage options** like **±1%, ±5%, ±10%**, or a custom value. These options adjust your order relative to the current market price.

#### **Positive Values (+1%, +5%, +10%) - Better Price**

<figure><img src="/files/IboE7XYmmVav2eM5L6VK" alt=""><figcaption></figcaption></figure>

Selecting a **positive percentage** means you want a **better price than the current market**.

* Your order will **only execute when the market moves in your favor**

**How it works:**

* **Buy orders** → execute when price goes **lower**
* **Sell orders** → execute when price goes **higher**

> Example:\
> Choosing **+10%** means your order will only execute when you receive a price **10% better** than the current market rate.

#### **Negative Values (-1%, -5%, -10%)  Faster Execution**

<figure><img src="/files/bjHsUJI81y1Kq5MLlCGW" alt=""><figcaption></figcaption></figure>

Selecting a **negative percentage** means you accept a **worse price than the current market**.

* Your order will execute **more easily and faster**, since conditions are less strict

**How it works:**

* **Buy orders** → execute even if price goes **higher**
* **Sell orders** → execute even if price goes **lower**

> Example:\
> Choosing **-10%** means your order can execute at a price **10% worse** than the current market rate.

**Best Practices**

* Use **+% values** when you want to:
  * Buy low
  * Sell high
  * Optimize entry/exit price
* Use **-% values** when you want to:
  * Increase execution probability
  * Exit or enter positions quickly

#### Summary

* **+% = Better price, slower execution**
* **-% = Worse price, faster execution**

This flexible pricing system allows you to **control both your execution price and timing**, depending on your trading strategy.

### 3. While Waiting

While your order is open:

* You remain in **full control of your funds**
* You can:
  * Transfer tokens
  * Trade elsewhere
  * Use them in DeFi

Note:

* If your balance becomes insufficient, the order simply won’t be filled

### 4. When Price is Met

* A **filler** detects that your conditions are satisfied
* The filler executes the trade **on-chain**
* At that moment:
  * Tokens are pulled from your wallet
  * Trade is completed instantly

Only the **exact required amount** is used\
Execution happens **only when your price is met**

### Key Benefits Recap

* **Self-custody:** funds always stay in your wallet
* **Gasless UX:** no fees for placing or execution
* **Precision:** exact amount, exact conditions
* **Private:** orders are not visible on-chain before execution
* **Flexible:** cancel implicitly by moving funds


# Important Notes

To ensure a smooth experience when using **Libety DEX Limit Orders**, please keep the following in mind:

#### Token Balance Changes

If you **move or spend your tokens before the order is filled**:

* The order will **fail to execute**
* No tokens will be taken from your wallet
* No penalties or fees are applied

> Your funds remain fully under your control at all times.

#### Order Expiry & Cancellation

* If your order **expires**:
  * It simply becomes invalid
  * **No tokens are moved**
  * No action required
* If you choose to **cancel the order manually**:
  * Requires a **separate on-chain transaction**
  * A **small gas fee** will apply

#### No Partial Fills

Liberty DEX Limit Orders follow an **all-or-nothing execution model**:

* Orders are either:
  * **Fully executed**, or
  * **Not executed at all**
* Partial fills are **not supported**

> This ensures price precision and prevents fragmented execution.

### Summary

* Funds are **never locked**
* Orders are **risk-free while waiting**
* Execution only happens when:
  * Price conditions are met
  * Full amount is available

Liberty DEX is designed to give you **maximum control, zero custody risk, and predictable execution** at all times.


# Overview

Liberty Pool is a concentrated liquidity infrastructure protocol built for the PulseChain ecosystem.

The protocol is based on the concentrated liquidity architecture introduced by Uniswap V3 and PancakeSwap V3, enabling liquidity providers to deploy capital more efficiently while supporting deeper on-chain liquidity for PulseChain assets.

Liberty Pool is designed to serve as a foundational liquidity layer for the Liberty Swap ecosystem and external routing protocols. The protocol supports advanced liquidity routing, fee generation, and integration with DEX aggregators operating across PulseChain.


# Core Architecture

Working on this page

Liberty Pool utilizes a concentrated liquidity market maker (CLMM) model.

Unlike traditional constant-product automated market makers where liquidity is distributed uniformly across the entire price curve, concentrated liquidity allows providers to allocate liquidity within custom price ranges.

This architecture improves capital efficiency by concentrating liquidity around actively traded market prices.

Liquidity providers may:

* define custom price ranges
* deploy liquidity with higher precision
* earn fees only while liquidity is active within the selected range
* rebalance positions as market conditions evolve

The protocol is optimized for:

* efficient liquidity utilization
* lower slippage for traders
* scalable liquidity routing
* integration with aggregation protocols


# Protocol Objectives

Liberty Pool is designed to support several long-term ecosystem objectives.

### Deepening PulseChain Liquidity

The protocol aims to improve overall liquidity depth across the PulseChain ecosystem by introducing an additional concentrated liquidity venue optimized for routing and aggregation.

As additional liquidity is added over time, Liberty Pool is expected to support more efficient execution for PulseChain-native assets.

### Capital Efficiency

Concentrated liquidity allows liquidity providers to utilize capital more effectively compared with traditional AMM models.

By focusing liquidity within active trading ranges, providers may achieve higher fee generation per unit of deployed capital.

### Aggregator Integration

Liberty Pool is designed to function as a routing source for DEX aggregators and intent-based swap protocols.

The protocol is currently being integrated with ecosystem routing partners in order to expand:

* routing coverage
* trade execution paths
* accessible liquidity depth
* swap efficiency for PulseChain assets

As integrations expand, trading volume may originate from external protocols and routing systems rather than directly from the Liberty Pool interface.

### Ecosystem Fee Redistribution

A portion of protocol-generated trading fees is allocated toward ecosystem growth and token support mechanisms.

This model is intended to align liquidity growth with long-term ecosystem sustainability.


# Trading Fee Distribution

Trading fees generated through Liberty Pool are distributed according to the following allocation model:

| **Allocation** | **Distribution**                                                           |
| -------------- | -------------------------------------------------------------------------- |
| 80%            | Distributed to liquidity providers                                         |
| 10%            | Used to acquire PCOCK from the open market for the PCOCK Strategy treasury |
| 10%            | Used to acquire and permanently burn PCOCK                                 |

***

### Liquidity Provider Rewards

Liquidity providers receive the majority of protocol-generated trading fees.

Fee earnings are proportional to:

* active liquidity position size
* selected price range
* pool trading activity
* duration of active liquidity participation

Only liquidity active within the current market range is eligible to receive fees.

***

### PCOCK Buyback Mechanism

A portion of protocol revenue is used to acquire PCOCK tokens from the open market.

These acquired tokens are allocated to the PCOCK Strategy treasury in order to support broader ecosystem initiatives and treasury-backed protocol activities.

***

### PCOCK Burn Mechanism

An additional portion of trading fees is used to repurchase and permanently remove PCOCK tokens from circulation.

This mechanism introduces a continuous deflationary component tied directly to protocol activity and trading volume.


# Liquidity Model

Liberty Pool supports concentrated liquidity positions similar to the Uniswap V3 model.

Liquidity providers specify:

* lower price bound
* upper price bound
* deposited asset quantities

Liquidity remains active only while the market price trades within the selected range.

If the market moves outside the selected range:

* the position becomes inactive
* fee generation pauses
* assets may become fully converted into one side of the trading pair

Liquidity providers may rebalance or reposition liquidity ranges at any time.


# Routing and Swap Execution

Swap execution within Liberty Pool is handled through routing infrastructure compatible with concentrated liquidity pools.

Routing systems may:

* split orders across multiple pools
* combine liquidity from external protocols
* execute multi-hop routing paths
* optimize execution pricing across available liquidity venues

This architecture enables Liberty Pool to function as a liquidity source for aggregators and advanced swap protocols within the PulseChain ecosystem.


# Smart Contracts

### Factory Contract

The Factory contract is responsible for deploying and registering liquidity pools.

#### Factory Address

```
0x796fcbDC956b85797EFe21145Aa97599B7FB36a6
```

Responsibilities include:

* pool creation
* fee tier configuration
* pool registry management
* protocol-level pool initialization

***

### SwapRouter Contract

The SwapRouter contract manages swap execution and routing interactions.

#### SwapRouter Address

```
0x48e8100374ae6Ff2Cc8871Db6224B296718EeB0d
```

Supported functionality includes:

* exact input swaps
* exact output swaps
* multi-hop routing
* path-based execution

***

### QuoterV2 Contract

The QuoterV2 contract provides swap estimation and routing simulation functionality.

#### QuoterV2 Address

```
0xdB368A7f9eDF3EF73e7ceDA97bC67ECF84E39D95
```

The contract may be used to:

* estimate output amounts
* simulate swap routes
* calculate expected pricing
* evaluate liquidity depth


# Risk Considerations

Providing liquidity through concentrated liquidity protocols introduces several risks, including:

* impermanent loss
* inactive liquidity positions
* smart contract vulnerabilities
* market volatility
* reduced fee generation outside selected ranges

Users are responsible for evaluating their own risk tolerance before interacting with the protocol.


# Ecosystem Expansion

Liberty Pool is expected to expand gradually as additional liquidity and routing integrations are introduced.

The protocol is designed to evolve into a broader liquidity infrastructure layer supporting:

* Liberty Swap
* LibertyX
* PulseChain aggregators
* external routing protocols
* future ecosystem trading products


# LIBERTY SCAN

LibertyScan is Liberty Swap's own transaction explorer, available at [scan.libertyswap.finance](https://scan.libertyswap.finance). It gives you a way to look up and review cross-chain swap and bridge activity processed through the protocol, without needing to piece it together from a general-purpose block explorer on each individual chain.

You may also see this tool referred to as the **Liberty Swap Explorer** - for example, on the Transaction Export page. LibertyScan and the Liberty Swap Explorer are the same tool, at the same address; this page uses the name shown on the site itself.

#### Why LibertyScan Exists

As explained in Supported Operations, Liberty Swap is deliberately data-minimal: the **Order ID** shown after a standard swap is a temporary, non-identifying reference that expires after 24 hours, and Liberty Swap does not store transaction hashes, wallet addresses, or execution metadata off-chain once a swap has settled. That design protects your privacy, but it also means Liberty Swap itself keeps no long-term internal record you can query after the fact.

LibertyScan fills that gap. Instead of relying on Liberty Swap to retain a private record of your activity, LibertyScan reads and presents the same information that is already public on-chain - organized specifically around Liberty Swap routes and fills, so you don't have to cross-reference multiple chains' explorers by hand.


# Accessing LibertyScan

Go to [scan.libertyswap.finance](https://scan.libertyswap.finance). The page shares the same top navigation as the rest of the ecosystem (Swap, DEX, Shield, Pool, Hypermarket), so you can move between LibertyScan and the other apps without re-entering the site. A **Connect Wallet** button sits in the top-right corner, available from anywhere in LibertyScan.


# All Transactions vs. My Transactions

LibertyScan splits its view into two tabs:

* **All Transactions** - the default view. A general, unfiltered feed of routes and fills processed through Liberty Swap, showing everyone's transactions, newest first.
* **My Transactions** - filtered to your own activity.

Switching to **My Transactions** without a connected wallet shows an empty state: a wallet icon, the heading **"Connect your wallet,"** the line *"Connect a wallet to filter the explorer down to your own transactions,"* and a **Connect Wallet** button. In other words, a wallet connection is required to use this tab - LibertyScan has no other way to know which transactions are "yours."


# Searching and Filtering

Above the results table, LibertyScan gives you two ways to narrow things down:

* A **search bar** ("Search by wallet address or transaction hash") for looking up a specific wallet or a specific transaction directly.
* A **Route** filter with **From** and **To** chain selectors (each defaulting to **All Chains**), plus a small swap-direction icon between them that flips your From and To selections.

Clicking either the **From** or **To** selector opens a searchable dropdown ("Search chains...") listing every network LibertyScan can filter by. The full list, in order, is:

1. All Chains
2. PulseChain
3. Base
4. Ethereum
5. BNB Smart Chain
6. Solana
7. Optimism
8. Arbitrum
9. Unichain
10. Polygon
11. Linea
12. Ink
13. Ethereum (Railgun)
14. BNB Smart Chain (Railgun)
15. Arbitrum (Railgun)

The three **"(Railgun)"** entries represent private, shielded balances rather than a public chain — they line up exactly with the three networks currently listed as shielding-capable in Shielding Tokens (Ethereum, BNB Chain, and Arbitrum). Selecting one of these lets you filter specifically for shield or unshield activity to or from that network's Railgun balance.

Set From, To, or both, or use the search bar, to look up transactions along a specific path (for example, Ethereum → PulseChain) instead of scrolling through the full feed.


# Reading the Results Table

Each row in the results table represents a single tracked transaction, laid out in four columns:

* **From** - the source amount and token (e.g. "52.612606 USDC"), the source chain name underneath, and a **Sender** address below that (shown truncated, e.g. `0xE384...F8ed`).
* **To** - the destination amount and token, destination chain name, and a **Recipient** address. Sender and Recipient are usually the same address (a user bridging to themselves), but not always - they can differ, since Liberty Swap supports sending the output of a swap to a separate destination address.
* **Transactions** - up to two linked entries: a **Deposit** hash (the transaction that sent funds into the route, with a copy icon next to it) and a **Fill** hash (the transaction that completed delivery on the destination side, with an external-link icon to view it elsewhere). Amounts can differ very slightly between From and To beyond what the swap rate alone would explain (visible on several real rows) - most likely reflecting the protocol fee taken from the output side; this page does not restate that mechanic in detail, see Supported Operations and Liberty Swap API for the fee model.
* **Status** - a status pill with a checkmark icon, and a relative timestamp underneath (e.g. "6 minutes ago"). The only status observed in practice so far is **Completed**; other possible values (such as a pending or failed state) were not seen in the sample reviewed and should be confirmed with the team if you need to document them.

Pagination controls are available below the table for moving through additional results.


# What LibertyScan Does and Doesn't Show

* LibertyScan surfaces information that is already public on-chain - it is a convenience layer for reading that data in one place, not a private or proprietary record kept by Liberty Swap.
* Connecting a wallet to use **My Transactions** or **Export** is for filtering the view to your own activity; per Transaction Export, it does not require creating an account or submitting personal information.
* **\[NEEDS CONFIRMATION]** Whether LibertyScan's coverage extends beyond Liberty Swap's own swap/bridge routes to other products that share its navigation bar (Liberty DEX, Liberty Pool, Liberty Shield, Liberty Hypermarket) is unclear. The published Transaction Export page scopes itself to "transactions executed through the Liberty Swap protocol," and separately notes that broader, ecosystem-wide export across DEXs, transfers, liquidity positions, and staking is planned for a future release - implying LibertyScan's current coverage is Liberty Swap-specific rather than ecosystem-wide today.
* The chain dropdown includes three Railgun-specific entries, so shield/unshield routes do appear to be filterable in LibertyScan. **\[NEEDS CONFIRMATION]** No example row using an "(Railgun)" route was reviewed directly, so it's not confirmed whether such rows display a Sender/Recipient address the same way standard rows do, or handle that display differently to preserve Railgun's privacy guarantees (see RAILGUN Private Mode and Transaction Visibility And Knowledge).


# LIBERTY HYPERMARKET

Liberty Hypermarket is a prediction market product built on Hyperliquid, using the HIP-4 event-contract standard and HyperCore as its execution and settlement layer. It lets users trade outcome contracts on real-world events - sports, politics, and crypto - as part of the wider Liberty ecosystem.

Liberty Hypermarket is live at predict.libertyswap.finance (also reachable at perps.libertyswap.finance), and appears in the shared navigation alongside Liberty Swap, Liberty Shield, Liberty DEX, and Liberty Pool.

The app currently exposes two sections:

•       Outcomes - browse and trade prediction-market shares. This is the core, user-facing product.

•       Portfolio - deposit and withdraw funds, and review balances, positions, orders, and trade history.

#### Getting Started

1\.      Go to predict.libertyswap.finance.

2\.      Click Connect to connect a supported wallet.

3\.      Go to Portfolio and Deposit funds before trading.

4\.      Browse open markets under Outcomes and buy Yes/No shares.

5\.      Track open holdings, orders, and history under Portfolio.

#### Important Notes

•       Liberty Hypermarket outcome contracts carry the same risks as other derivative/prediction products: a losing position can go to zero.

•       Always verify you are on an official domain (predict.libertyswap.finance or perps.libertyswap.finance) before connecting a wallet.

•       Product mechanics, fee routing, and market availability are subject to change. See Page 7 for open questions the team should confirm before this section is published.


# How It Works

Liberty Hypermarket markets are structured as outcome shares. Each market asks a yes/no question about a future event (for example, "Will Argentina win the World Cup?"). Shares for an outcome trade between $0 and $1, and the share price reflects the market's implied probability for that outcome.

•       If the outcome occurs, each share pays out $1.

•       If the outcome does not occur, each share is worth $0.

This share-based structure allows Hypermarket to be used two ways:

Speculation. A trader who believes an outcome is under-priced can buy shares below their expected value and profit if the event resolves in their favor.

Hedging. A user with a real-world financial exposure to an event's outcome can buy shares to offset that exposure. For example, a business owner planning a promotion tied to a sports result can buy shares corresponding to that outcome; if the event happens and the promotion becomes costly, the share payout offsets the cost, and if it doesn't happen, the cost of the shares functions similarly to an insurance premium.

Pricing, matching, and settlement of markets are handled by Hyperliquid's HyperCore infrastructure under the HIP-4 event-contract framework.


# Key Features

• Outcome contracts on real-world events - sports, politics, and crypto markets, browsable from the Outcomes view.

• Portfolio tracking - balances, open outcome holdings, resting orders, and trade/order history are visible from the in-app Portfolio view.

• Built on Hyperliquid (HIP-4 / HyperCore) - Liberty Hypermarket uses Hyperliquid's event-contract infrastructure for execution and settlement rather than its own matching engine.

• Part of the Liberty ecosystem - accessible from the same navigation as Liberty Swap, Liberty Shield, Liberty DEX, and Liberty Pool, and linked from the Liberty Swap API and docs.


# Core Architecture

Liberty Hypermarket is a front-end built on top of Hyperliquid, specifically its HyperCore execution layer and the HIP-4 event-contract standard. Liberty Hypermarket does not run its own order-matching engine, custody layer, or settlement logic — these are provided by Hyperliquid, and Liberty Hypermarket's role is to present outcome markets to PulseChain-ecosystem users and route their funds and orders into HyperCore.

#### What HIP-4 Event Contracts Are

HIP-4 is Hyperliquid's standard for event contracts — instruments that settle based on the outcome of a real-world event rather than the price of an underlying asset. Each event contract trades as a share priced between $0 and $1:

•       The share price at any time reflects the market's implied probability of the event occurring.

•       At resolution, each share pays $1 if the event occurred, or $0 if it did not.

#### Execution and Settlement

Order matching, pricing, and final settlement of outcome markets happen on HyperCore.

#### Account Model: Perps and Spot Balances

Hyperliquid's account system separates user funds into distinct balance types — commonly referred to as a Perps balance and a Spot balance. Liberty Hypermarket's Portfolio page reflects this underlying account model: when depositing, users choose which balance to fund (see Page 3).


# Depositing and Withdrawing Funds

Before you can trade on Liberty Hypermarket, you need to deposit funds into your Hypermarket account. This page walks through the Deposit and Withdraw flow as it appears on the Portfolio page.

#### Step-by-Step: Depositing

1\.      Go to predict.libertyswap.finance/portfolio and connect your wallet.

2\.      Click Deposit.

3\.      Confirm the deposit amount, and complete the transaction in your wallet.

4\.      Your balance will appear on the Portfolio page once the deposit is confirmed.

#### Step-by-Step: Withdrawing

6\.      Go to Portfolio.

7\.      Click Withdraw.

8\.      Confirm the amount and destination.

9\.      Confirm the transaction in your wallet.

#### Important Notes

•       Always confirm you are depositing from a network and asset that Liberty Hypermarket actually supports before sending funds.

•       Double-check the Perps vs. Spot choice before depositing — see Page 2 for background on why this choice exists.

•       If in doubt, deposit a small test amount first.


# Trading Outcomes

This page explains how to read and trade outcome-share markets on Liberty Hypermarket.

#### Reading a Market

Each market shows a real-world question (for example, "Will Argentina win the World Cup?") with two sides — typically Yes and No. The price of a share on either side is always between $0.00 and $1.00, and can be read directly as an implied probability. A Yes share trading at $0.65, for example, implies the market currently prices that outcome at roughly 65%.

#### Step-by-Step: Buying a Position

1\.      Go to Outcomes and browse open markets.

2\.      Open the market you want to trade.

3\.      Choose the side (Yes or No) and the amount of shares, or the dollar amount you want to spend.

4\.      Review the estimated cost and potential payout before confirming.

5\.      Confirm the trade.

#### Closing a Position Before Resolution

Outcome shares can typically be sold back into the market before the event resolves, at the current market price, rather than held until settlement.

#### What Happens at Resolution

When the underlying event resolves, winning shares settle at $1.00 and losing shares settle at $0.00.

#### Reading Your Open Positions

Open outcome holdings appear under Positions on the Portfolio page (labeled "Open outcome holdings"). Resting (unfilled) limit orders appear under Open orders ("Resting limit orders"), and completed trades appear under Recent fills ("Latest outcome trades").

#### Important Notes

•       A losing outcome position settles to $0 — this is a real loss of the amount spent on those shares, not a temporary drawdown.

•       Market prices can move quickly around real-world news; review the current price immediately before confirming any trade.

•       This page describes the mechanics based on Hypermarket's own marketing description and the fields visible on its Portfolio page. Exact order-entry UI (market vs. limit order flow, slippage handling, minimum trade size) should be verified against the live app before this page is published.


# Understanding Your Portfolio

The Portfolio page is where you manage funds and review your activity on Liberty Hypermarket.

#### Top of Page

•       Total balance - your account value and its change over the past day, shown at the top of the page.

•       Deposit / Withdraw - see Page 3 for the full deposit/withdraw flow.

#### Activity Summary

| Section      | What it shows                        |
| ------------ | ------------------------------------ |
| Positions    | Your open outcome holdings           |
| Open orders  | Your resting (unfilled) limit orders |
| Recent fills | Your latest outcome trades           |

&#x20;

#### Detailed History Tabs

Further down the Portfolio page, five tabs give a more detailed view:

•       Balances - your current balances (see Page 2 and Page 3 for the Perps/Spot distinction).

•       Outcomes - your outcome-share holdings in detail.

•       Open orders - full list of resting orders.

•       Trade history - a full log of your completed trades.

•       Order history - a full log of past orders, including ones that were cancelled or expired.

All of these require a connected wallet - the app shows "Connect wallet to view balances, positions, and history" until you do.

#### Important Notes

•       Portfolio data reflects on-chain/HyperCore activity tied to your connected wallet; it is not a substitute for verifying balances directly against a block explorer if you need independent confirmation.

If a deposit or trade does not appear on the Portfolio page after confirmation, wait for the underlying transaction to finalize before assuming something went wrong, and check LibertyScan or the relevant chain explorer if it persists.


# What is ZKX Wallet?

ZKX Wallet is a self-custodial wallet, meaning you retain full control over your funds at all times. Your credentials are never stored or accessed by ZKX Wallet, ensuring that only you can manage your assets.

As a browser extension, ZKX Wallet enables you to securely manage private keys across multiple blockchains, including PulseChain, Ethereum, BNB Chain, Base, and others. It functions as a wallet client for PLS and a wide range of tokens, while also allowing seamless interaction with decentralized applications (dApps).

With ZKX Wallet, you maintain complete ownership of your crypto identity and digital assets.

### Can I use ZKX Wallet in my country?

ZKX Wallet is designed to be accessible in most regions worldwide. However, due to regulatory, compliance, and operational considerations, the service may not be available in certain jurisdictions.

These restricted jurisdictions may include, but are not limited to:

* North Korea
* Iran
* Syria
* Cuba
* China
* Vietnam
* Crimea, Donetsk, and Luhansk regions

Users are responsible for ensuring that their access to and use of ZKX Wallet complies with all applicable local laws and regulations in their jurisdiction.

If users choose to access or use ZKX Wallet from a restricted region, they do so at their own discretion and risk. ZKX Wallet and Liberty Swap Finance assume no responsibility or liability arising from such use.

### Installing ZKX Wallet

<figure><img src="/files/hOnUTvh8q4ZgslE6yL0y" alt=""><figcaption></figcaption></figure>

ZKX Wallet is available as a browser extension and can be installed on all Chromium-based browsers via the [Chrome Web Store](https://chromewebstore.google.com/detail/zkx-web3-wallet/fibfaangghabdbndamiaceoahiajfgck).

To install ZKX Wallet:

1. Open the Chrome Web Store from your browser.
2. Search for “ZKX Wallet”.
3. Select the official extension.
4. Click Add to Chrome and confirm the installation.

Once installed, the ZKX Wallet extension will be available in your browser toolbar, ready for setup and use.


# Privacy Policy

This Privacy Policy explains how ZKX Wallet (“we,” “us,” or “the extension”) handles information when users (“you,” “your,” or “user”) install and use the ZKX Wallet browser extension and related services (collectively, the **“Services”**).

By installing or using ZKX Wallet, you acknowledge that you have read and understood this Privacy Policy.

## 1. Privacy by Design

ZKX Wallet is designed as a **self-custodial wallet extension**. Users retain full control of their private keys and digital assets at all times.

The extension operates locally within the user's browser environment and does not require the creation of accounts or the submission of personally identifiable information.

Our design philosophy is to **minimize data collection while maintaining essential functionality**, allowing users to securely interact with blockchain networks and decentralized applications.

## 2. Information Processed by the Extension

### A. Wallet Data (Stored Locally)

When a wallet is created or imported, the extension generates or stores cryptographic wallet information locally within the browser environment. This may include:

* encrypted private keys
* public wallet addresses
* locally stored wallet configuration data

This information is encrypted and stored only on the user’s device. ZKX Wallet does **not** transmit or store private keys on external servers.

Users are solely responsible for securely storing their recovery phrase or backup information.

### B. Blockchain Transaction Data

When users initiate blockchain transactions through the extension, certain information is processed in order to broadcast the transaction to the blockchain network. This may include:

* wallet address
* destination address
* token type and transfer amount
* transaction metadata required by the network

These transactions are submitted directly to blockchain nodes or RPC providers and become publicly visible according to the transparency rules of the underlying blockchain.

ZKX Wallet does not maintain a centralized record of user transactions.

### C. Network and Infrastructure Requests

To function properly, the extension may interact with external infrastructure services such as:

* blockchain RPC nodes
* transaction relays
* blockchain indexers
* price or token metadata providers

These requests may include the user’s wallet address or transaction data strictly as required to perform the requested blockchain operation.

### D. Optional Support Information

If a user contacts support or interacts with official communication channels, they may voluntarily provide limited information such as:

* wallet address
* transaction hash
* screenshots or diagnostic details
* communication handles (e.g., Telegram or X)

This information is used solely for troubleshooting and user support.

ZKX Wallet will **never request private keys, seed phrases, or wallet recovery phrases**.

## 3. Data Storage and Retention

Most wallet data is stored locally on the user’s device and is not transmitted to external servers.

Operational logs or limited diagnostic information may be temporarily retained to maintain system stability or investigate reported issues. Such information is periodically removed through automated processes.

ZKX Wallet does not maintain permanent centralized databases containing user wallet data.

## 4. Third-Party Services

ZKX Wallet may rely on third-party services to support blockchain connectivity and application functionality. These services may include:

* blockchain RPC providers
* decentralized application (dApp) integrations
* token price data providers
* blockchain explorers

These providers operate under their own privacy policies. Users should review those policies separately when interacting with third-party services through the wallet.

## 5. Security Practices

ZKX Wallet implements several technical safeguards designed to protect wallet data and extension integrity, including:

* local encryption of sensitive wallet data
* secure communication protocols for network requests
* restricted internal access to infrastructure systems
* regular security reviews of wallet components

Despite these measures, users remain responsible for protecting their device security, wallet backups, and recovery phrases.

## 6. Blockchain Transparency

Blockchain networks are inherently transparent. Transactions submitted through ZKX Wallet are permanently recorded on public ledgers and may be visible through blockchain explorers.

ZKX Wallet does not control how blockchain data is indexed, stored, or displayed by third-party services.

## 7. Legal Compliance

ZKX Wallet may comply with lawful requests from authorities where required by applicable law.

Because the extension does not collect personally identifiable user information, the scope of information that can be provided in response to such requests is limited.

## 8. Children's Privacy

ZKX Wallet is not intended for use by individuals under the age of 18.

We do not knowingly collect personal information from minors.

## 9. Updates to This Policy

This Privacy Policy may be updated periodically to reflect improvements to the extension or changes in regulatory requirements.

Updated versions will be published through official Liberty Swap communication channels.

Continued use of the extension after updates constitutes acceptance of the revised policy.

## 10. Contact

For questions related to privacy or wallet security:

**Website:** <https://libertyswap.finance/>

**X (Twitter):** @LibertySwapFi


# Core Architecture

Working on this page

TBA


# Private Mode

Private Mode is a privacy-focused feature integrated into ZKX Wallet through Railgun technology, designed to help users protect their on-chain activity and maintain greater control over their digital identity.

Traditional blockchain transactions are fully transparent, meaning wallet addresses, balances, and transaction histories can often be viewed and tracked publicly. Private Mode helps reduce this exposure by enabling users to shield and unshield assets through privacy-preserving mechanisms powered by Railgun.

When using Private Mode:

* Your transaction activity becomes significantly more difficult to trace publicly.
* Shielded assets can be transferred with enhanced privacy protection.
* Users can unshield assets to a brand-new wallet address, helping separate on-chain activity from previously exposed wallet histories.

In practice, this means that when assets are shielded and later unshielded to a fresh address, it becomes extremely difficult for external observers to associate the new address with your previous wallet activity or real-world identity.

#### **Key Benefits**

* Enhanced transaction privacy
* Reduced wallet traceability
* Better separation between public and private on-chain activity
* Seamless integration directly within ZKX Wallet

#### **Important Notes**

* Private Mode is intended to enhance personal privacy, not to bypass applicable laws or regulations.
* Users remain fully responsible for complying with local regulations in their jurisdiction.
* Always verify recipient addresses carefully before sending shielded or unshielded assets.

By integrating Railgun technology directly into the wallet experience, ZKX Wallet provides users with a more private and secure way to interact with decentralized ecosystems.


# Public Mode

Public Mode is the standard transaction mode in ZKX Wallet, designed for regular blockchain interactions across supported networks. In this mode, transactions operate similarly to most traditional crypto wallets, where on-chain activity is publicly visible and can be viewed through blockchain explorers.

When using Public Mode:

* Wallet addresses are publicly visible on-chain.
* Transaction history, token balances, and transfer activity can be tracked through blockchain explorers.
* Interactions with decentralized applications (dApps) follow the standard transparency model of public blockchains.

Public Mode is suitable for everyday blockchain activity, including:

* Sending and receiving tokens
* Swapping assets
* Connecting to dApps
* Bridging assets across networks
* Participating in DeFi protocols

#### **How Public Mode Works**

Blockchains such as PulseChain, Ethereum, BNB Chain, and Base are designed with transparent ledgers. Every confirmed transaction is permanently recorded on-chain and can be accessed publicly.

As a result:

* Transactions can often be linked together through wallet activity.
* Wallet balances and token holdings may be visible to external observers.
* On-chain behavior may be analyzed through publicly available blockchain data.

This transparency is a core characteristic of most blockchain networks and enables verification, security, and decentralization across the ecosystem.

#### **Key Benefits**

* Fast and seamless blockchain interactions
* Full compatibility with supported dApps and protocols
* Standard transaction flow familiar to most crypto users
* Easy transaction verification through blockchain explorers

#### **Important Notes**

* All on-chain activity performed in Public Mode may be permanently visible on public blockchain explorers.
* Always verify transaction details and recipient addresses before confirming transactions.
* Users are responsible for understanding the transparency model of public blockchain networks when using Public Mode.


# User Manual

The User Manual provides step-by-step guidance on how to use ZKX Wallet effectively. It includes instructions for setting up your wallet, managing assets and accounts, switching networks, and interacting with decentralized applications (dApps).

This section is designed to help users at all levels understand and navigate the wallet’s core features in a clear, structured, and secure manner.


# Create your ZKX Wallet account

<h3 align="center"><img src="/files/V6ZpfODL4MY1tFzGkIZb" alt=""></h3>

### Creating a New Wallet (Create New Account)

To create a new wallet in ZKX Wallet, follow these steps:

1. Click Create New Account on the welcome screen.
2. Review the security tips carefully, then tick the checkbox to confirm. Click Create Recovery Phrase to proceed.
3. Your recovery phrase will be displayed.
4. Write it down or store it securely in an offline location.
5. Do not share it with anyone. If your recovery phrase is exposed, anyone can gain full access to your wallet and assets.
6. Once you have securely saved it, click I’ve saved the phrase.
7. Click Complete to finish the wallet creation process.

After setup, you can create additional accounts (sub-wallets) under the same recovery phrase if needed.

<figure><img src="/files/4C1xdR9VUKBIJEN21Dtj" alt="" width="357"><figcaption></figcaption></figure>

### Importing an Existing Account

ZKX Wallet allows you to import an existing wallet using multiple methods, depending on your setup and preferences.

Available import options include:

* Private Key
* Recovery Phrase (Seed Phrase)
* Trezor Hardware Wallet
* Ledger Hardware Wallet
* Grid Plus
* SafePal
* JSON backup file

To import your account:

1. Select Import Existing Account.
2. Choose your preferred import method.
3. Follow the on-screen instructions to complete the process.

Ensure that you only input sensitive information (such as private keys or recovery phrases) in a secure environment. Never share this information with anyone.

<br>


# Switching Between Public Mode and Private Mode

### **Switching Between Public Mode and Private Mode**

<figure><img src="/files/86h1Sm8jLKW9NMUrlekQ" alt=""><figcaption></figcaption></figure>

ZKX Wallet allows users to easily switch between **Public Mode** and **Private Mode** at any time directly from the main wallet interface.

<figure><img src="/files/ZSi4zfgEKhnq0AFFLkjX" alt=""><figcaption></figcaption></figure>

To change modes:

1. Open the ZKX Wallet main interface.
2. Locate the mode toggle button in the top-right corner of the wallet.
3. Click the button to switch between:
   * **Public Mode** - Standard on-chain transactions with full blockchain transparency.
   * **Private Mode** - Privacy-enhanced transactions powered by Railgun technology.

Once selected, the wallet interface and available actions will adjust according to the chosen mode.

#### **When to Use Each Mode**

**Public Mode**

* Best for standard blockchain activity
* Ideal for regular dApp interactions and transparent transactions
* Similar to traditional crypto wallet behavior

**Private Mode**

* Designed for enhanced transaction privacy
* Helps reduce wallet traceability on-chain
* Suitable for users who want greater separation between wallet activity and public blockchain visibility

Users can switch between modes at any time depending on their preferred level of privacy and transaction transparency.


# Managing networks

By default, ZKX Wallet displays all your assets across all supported networks in a unified view.

To switch networks:

1. On the main interface, click the **“All Networks”** selector located on the right side.
2. Choose your desired network from the list.

<figure><img src="/files/feJ4RASVqDnjMw7VLlqq" alt="" width="375"><figcaption></figcaption></figure>

ZKX Wallet also allows you to add custom EVM-compatible networks:

* Click **Add New Network**.

<figure><img src="/files/RSC7jGhmms1Mm5mGb3uA" alt="" width="375"><figcaption></figcaption></figure>

* Select **Go to Chainlist** to quickly add networks from a curated list.
* Select **Go to Settings** if you prefer to manually add a network using custom RPC details.

<figure><img src="/files/EqvSTY2sSrtZYyARxxwO" alt=""><figcaption></figcaption></figure>

This flexibility ensures you can easily manage assets across multiple blockchain environments.


# Adding a Custom Token

<figure><img src="/files/GtMomVtGFFsFNZGDQCF0" alt=""><figcaption></figcaption></figure>

ZKX Wallet allows you to manually add tokens that are not displayed by default.

To add a custom token:

* On the main screen, click **Add Custom Token** at the bottom of the interface.

<figure><img src="/files/M3F1XLWYsHjrJTiepxgt" alt=""><figcaption></figcaption></figure>

* In the **Add Token** screen, select the appropriate **Network** and enter the **Token Address**.
* Once the correct token address is provided, the token name and details will be populated automatically.

<figure><img src="/files/sX66QXzcVXYpKUmkGfOD" alt="" width="364"><figcaption></figcaption></figure>

* Click **Add Token** to complete the process.

The token will now appear in your wallet’s asset list.


# Sending Tokens

To send tokens using ZKX Wallet, follow these steps:

* On the main screen, click **Send**.

<figure><img src="/files/s9IgtrJUCSJs3ITNe2zK" alt=""><figcaption></figcaption></figure>

* In the **Send Token** interface, enter the recipient’s wallet address.
* Select the token you want to send and enter the amount.
* Review all transaction details carefully, then click and hold **Hold to proceed**.

<figure><img src="/files/L3QOV5U7t91N2BkmMueg" alt=""><figcaption></figcaption></figure>

* Check the estimated gas fee. You can adjust the transaction speed - faster speeds require higher gas fees.
* Confirm the gas fee details, then click **Send** to complete the transaction.

Always double-check the recipient address and amount before confirming, as transactions cannot be reversed.


# Speed Up Transaction

The **Speed Up Transaction** feature allows you to accelerate pending blockchain transactions without manually creating replacement transactions or worrying about duplicate transfers.

Although uncommon, network congestion can occasionally cause transactions to remain pending longer than expected. This is most likely to occur during periods of high network activity when gas fees increase rapidly.

With ZKX Wallet, you can quickly resubmit your pending transaction using a higher gas fee, giving it a higher priority for confirmation.

## **Why Transactions Become Stuck**

Blockchain networks such as PulseChain process transactions based on gas fees. During periods of increased demand, validators prioritize transactions offering higher gas prices.

If your transaction was submitted with a gas price that is too low, it may remain pending until network congestion decreases.

## **How to Speed Up a Transaction**

If a transaction remains pending:

1. Open the **Activity** section in ZKX Wallet.
2. Select the pending transaction.
3. Click **Speed Up Transaction**.
4. Choose a higher gas fee (for example, **Ape Gas**).
5. Review the updated transaction details.
6. Confirm the transaction.

The wallet will broadcast a replacement transaction with the same nonce but a higher gas fee, increasing its likelihood of being confirmed sooner.

## **Why Use Speed Up Instead of Sending Again?**

Many crypto wallets require users to manually cancel pending transactions or resend them themselves.

If this process is performed incorrectly, users may encounter problems such as:

* Duplicate transactions
* Nonce conflicts
* Confusing pending transaction states
* Accidentally sending funds multiple times

For example, if you send funds to Alice and then manually submit another transfer because the first appears stuck, you may unintentionally send the payment twice once both transactions are confirmed.

## **Smarter Transaction Management**

ZKX Wallet is designed to simplify pending transaction management and reduce these risks.

Instead of requiring manual intervention, the wallet intelligently handles transaction replacement by prioritizing the original transaction. If conflicting replacement transactions are created, duplicate executions are prevented whenever possible through proper nonce management.

This approach helps users:

* Reduce the risk of accidental duplicate transactions
* Avoid common nonce-related issues
* Resolve pending transactions more safely
* Improve the overall transaction experience during network congestion

## **When Should You Use Speed Up?**

Consider using **Speed Up Transaction** when:

* A transaction has remained pending for an unusually long period.
* Network gas fees have increased significantly since the transaction was submitted.
* You want the transaction to be confirmed more quickly without manually managing replacement transactions.

## **Important Notes**

* Speed Up Transaction does **not** modify the transaction recipient, transferred assets, or transaction data. It only increases the gas fee used to prioritize confirmation.
* A higher gas fee generally increases the probability of faster confirmation but does not guarantee immediate inclusion in a block.
* Always review the updated network fee before confirming the replacement transaction.

By automating transaction replacement and simplifying nonce management, **Speed Up Transaction** provides a safer and more reliable way to handle pending transactions while helping protect users from common mistakes that can occur with manual transaction resubmission.


# Shielding Tokens

ZKX Wallet allows users to shield supported assets into Private Mode using integrated Railgun privacy technology.

Currently, token shielding is supported on the following networks:

* Ethereum
* BNB Chain
* Arbitrum

Support is limited to networks where the underlying Railgun protocol is deployed. Other networks in your wallet (including PulseChain) will gain shielding support as Railgun becomes available there - see the Liberty Swap roadmap for the current timeline.

**Current Limitations**

* Shielding assets using hardware wallets is not supported at this time.
* Support for hardware wallet shielding and additional blockchain networks is currently under development.
* ZKX Wallet is also working on additional shield/unshield modes, including a faster option - if you see more than one mode offered when shielding, check the in-app description of each mode before choosing, as they may differ in speed, cost, or privacy guarantees.

#### **How to Shield Assets**

Follow these steps to shield your assets:

1. Open ZKX Wallet in **Public Mode**.
2. On the main interface, click the **Shield** button located on the right side.
3. Confirm the private address the funds will be shielded into.

**About Private Addresses**

Each public wallet address (`0x...`) automatically generates its own corresponding private address (`0zk...`) within ZKX Wallet. This happens automatically - there is nothing you need to set up, and shielded funds always go to your own private address.

4. Select the asset and amount you want to shield.
5. Review the fee for the transaction, shown before you confirm. Shielding carries a fee, separate from network gas - see Railgun Private Sends: Privacy and Fee Structure for background on how Railgun-related fees work across the Liberty ecosystem.
6. Click **Next**.
7. Review the transaction details carefully, then click **Shield** to confirm.

Once confirmed, the selected assets will begin transferring into your Private Mode balance.

#### **Checking Your Private Balance**

After shielding is completed:

1. Switch to **Private Mode** using the mode toggle in the wallet interface.
2. View your private balance and shielded assets.

Please note that private balance synchronization may take up to 30 minutes in some cases. If your balance does not appear immediately, allow additional time for the system to finish processing and updating the private state. If it still hasn't appeared well beyond that window, verify the transaction went through on a block explorer before reaching out for support.

#### **Important Notes**

* Always verify the selected asset, amount, and fee before confirming a shield transaction.
* Shielded assets are managed separately from publicly visible wallet balances.
* Transaction processing times may vary depending on network conditions.
* For background on what shielding does and does not hide, and general best practices when using Railgun-based privacy, see Private Mode and Use Privacy Protocols Like Railgun.


# Unshielding Tokens

ZKX Wallet allows users to move shielded assets from Private Mode back into their public wallet balance through the Unshield process.

#### **How to Unshield Assets**

Follow these steps to unshield your assets:

1. Open ZKX Wallet in **Private Mode**.
2. On the main interface, click the **Unshield** button located on the right side.
3. Select your destination public wallet address.

⚠️ Double-check this address before continuing. Unshielding sends funds to whatever public address you enter here - it does not have to be the wallet you're currently using, and once confirmed, the transaction cannot be reversed. Sending to the wrong address means those funds are permanently lost.

Choosing a **fresh address you haven't used before** as the destination makes it harder for outside observers to connect the unshielded funds back to your previous wallet activity. Reusing a well-known or previously public address reduces this benefit. See Private Mode for more on why this matters.

4. Choose the asset and amount you want to unshield.
5. Review the fee for the transaction, shown before you confirm. Like shielding, unshielding carries a fee separate from network gas - see Railgun Private Sends: Privacy and Fee Structure for background.
6. Click **Next**.
7. Review the transaction details carefully, then click **Unshield** to confirm.

Once confirmed, the selected assets will begin transferring from your private balance back to your public wallet balance.

#### **Checking Your Public Balance**

After the unshield transaction is completed:

1. Switch back to **Public Mode**.
2. Check your wallet balance on the selected network.

Transaction processing times may vary depending on network conditions and private balance synchronization. If a balance you expect still hasn't appeared after a reasonable wait, verify the transaction on a block explorer before assuming something went wrong.

#### **Important Notes**

* Always verify the destination address before confirming an unshield transaction - this step cannot be undone.
* Unshielded assets will become publicly visible again on the blockchain.
* Sending to a new, previously unused address offers stronger privacy separation than unshielding back to an already-public address.
* Depending on network conditions, balance updates may take some time to appear.
* ZKX Wallet is also working on additional shield/unshield modes, including a faster option - available modes and their trade-offs may evolve, so check the in-app description of each mode at the time you unshield.


# Accessing dApps

ZKX Wallet provides seamless access to a wide range of decentralized applications (dApps), allowing users to easily explore and interact with the DeFi ecosystem directly from the wallet.

The wallet includes an integrated dApp directory featuring various supported platforms across multiple blockchain networks.

### **Connecting to a dApp**

To connect ZKX Wallet to a dApp:

1. Open the dApp section within ZKX Wallet.
2. Browse or select a dApp from the available list.
3. On the selected dApp interface, choose the appropriate wallet connection option.
4. The dApp will automatically detect ZKX Wallet.
5. Approve the connection request within the wallet interface.

Once connected, you can begin interacting with the dApp, including:

* Swapping assets
* Providing liquidity
* Bridging tokens
* Participating in DeFi protocols
* Managing on-chain activities

### **Automatic Wallet Detection**

ZKX Wallet is designed to integrate smoothly with EVM-compatible dApps. In most cases, supported platforms will automatically recognize the wallet extension without requiring additional configuration.

### **Important Notes**

* Always verify the authenticity of a dApp before connecting your wallet.
* Carefully review all transaction and signature requests before approving them.
* Some dApps may require switching to a specific network before interaction.


# Using Batch Transactions

ZKX Wallet supports Batch Transactions, allowing users to combine multiple transactions into a single confirmation flow. This feature helps simplify transaction management and can reduce the number of separate approvals and gas payments required.

Batch Transactions are especially useful for:

* Multiple token swaps
* Sequential DeFi interactions
* Managing several transactions at once
* Improving transaction efficiency

### **How Batch Transactions Work**

Instead of confirming every transaction individually, ZKX Wallet allows you to group multiple actions together and sign them in a single batch.

#### **Step 1**

Whenever you initiate a transaction, the transaction confirmation window will appear.

#### **Step 2**

For the first transaction in the sequence, click **Start a Batch**.

#### **Step 3**

For each additional transaction, click **Add to Batch** instead of confirming individually.

#### **Step 4**

After adding all desired transactions to the batch, click **Sign** to approve and execute the batch transaction.

ZKX Wallet will then process all included transactions together.

### **Benefits of Batch Transactions**

#### **Single Confirmation Flow**

Approve multiple transactions at once instead of confirming each transaction separately.

#### **Improved User Experience**

Execute complex workflows more efficiently with fewer interruptions.

#### **Optimized Gas Usage**

Multiple actions can be bundled into a single execution flow, reducing unnecessary gas overhead.

> Multiple swaps. One confirmation. One gas payment.

### **Important Notes**

* Always review every transaction included in the batch before signing.
* Gas fees and execution results may vary depending on network conditions and transaction complexity.
* Failed transactions within a batch may affect the execution of the remaining transactions depending on protocol behavior.


# Connecting ZKX Wallet to Keystone

ZKX Wallet supports QR-based hardware wallet connections, allowing users to securely import Keystone accounts and sign transactions or messages in both online and offline environments.

### Importing Keystone Accounts into ZKX Wallet

**Step 1:** Install the ZKX Wallet browser extension and select Import Existing Account.

If you already have ZKX Wallet installed:

* Open the wallet
* Navigate to Account → Add Account → Connect a Hardware Wallet

**Step 2:** Select More, or scroll down and choose the QR-based connection option.

**Step 3:** Allow the ZKX Wallet extension to access your device camera.

<figure><img src="/files/ckyDDkWn3T3J5rNPxA0s" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="/files/g8g20YpNimm2XzHoKncH" alt="" width="375"><figcaption></figcaption></figure>

**Step 4:** Unlock your Keystone device and select Connect Software Wallet.

**Step 5:** Choose the MetaMask option on your Keystone device to generate the QR code.

<figure><img src="/files/ZCWpCCRUsLuSg9SoS3NJ" alt="" width="375"><figcaption></figcaption></figure>

**Step 6:** Use ZKX Wallet to scan the QR code displayed on the Keystone device.

**Step 7:** ZKX Wallet will display the wallet addresses derived from the scanned QR code.\
Select the accounts you want to import, then click Continue.

**Step 8:** Optionally, assign custom names to the imported accounts or keep the default names.

<figure><img src="/files/tKlvQ2xpJPL6F2BSMKT5" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="/files/Go4DqQdsBilm6AUOvaNJ" alt="" width="375"><figcaption></figcaption></figure>

**Step 9:** Your Keystone accounts are now connected and ready to use within ZKX Wallet.

### Signing Transactions with a Keystone Account

**Step 1:** Prepare the transaction in the ZKX Wallet extension and click Proceed.

**Step 2:** Review the network fee and transaction details carefully.

**Step 3:** Scan the QR code displayed in ZKX Wallet using your Keystone device.

Important:\
Complex transactions or messages may generate dynamic QR codes. If this occurs, allow enough time for the Keystone device to scan the full QR sequence completely.

**Step 4:** Review the transaction details on your Keystone device and select Sign.\
The device will generate a QR-based signature.

**Step 5:** Confirm the signing process on the Keystone device.

**Step 6:** Return to ZKX Wallet, click Get Signature, and scan the QR signature displayed on your Keystone device.

**Step 7:** ZKX Wallet will process and confirm the transaction status.\
Once completed successfully, the transaction will appear in the wallet’s Activity section.

<br>


# Connecting ZKX Wallet to imToken

ZKX Wallet supports QR-based connections, allowing users to securely import accounts from imToken and sign transactions or messages through a QR authentication flow.

## Importing imToken Accounts into ZKX Wallet

**Step 1:** Install the ZKX Wallet browser extension and select Import Existing Account.

If you already have ZKX Wallet installed:

* Open the wallet
* Navigate to Accounts → Add Account → Connect a Hardware Wallet

**Step 2:** Select More, or scroll down and choose the QR-based connection option.

**Step 3:** Allow the ZKX Wallet extension to access your device camera.

<div><figure><img src="/files/cLjgbOwYdNZwtuLry5YI" alt=""><figcaption></figcaption></figure> <figure><img src="/files/h9GPwWANqywTjAmSGtRW" alt=""><figcaption></figcaption></figure></div>

**Step 4:** Open the imToken mobile application and tap the “>” icon in the account information section.

**Step 5:** Select Connect with Other Wallet Apps to display the QR code.

<div><figure><img src="/files/rAyCOdjsoF9VlZB1gV8n" alt=""><figcaption></figcaption></figure> <figure><img src="/files/ri4cWUFpbQKF9w7M56E2" alt=""><figcaption></figcaption></figure> <figure><img src="/files/MekJQFt7H48NZPVpF3kU" alt=""><figcaption></figcaption></figure></div>

**Step 6:** Use ZKX Wallet to scan the QR code displayed in the imToken application.

**Step 7:** ZKX Wallet will display the wallet addresses derived from the scanned QR code.\
Select the accounts you want to import, then click Continue.

**Step 8:** Optionally, assign custom names to the imported accounts or keep the default names.

<div><figure><img src="/files/Uw4y6Vz6dklksq9nb67U" alt=""><figcaption></figcaption></figure> <figure><img src="/files/vEszpwFBTEEsatxQNvxT" alt=""><figcaption></figcaption></figure> <figure><img src="/files/1tYOPg6r7dfF5iunSeCx" alt=""><figcaption></figcaption></figure></div>

**Step 9:** Your imToken accounts are now connected and ready to use within ZKX Wallet.

## Signing Transactions with an imToken Account

**Step 1:** Prepare the transaction in the ZKX Wallet extension and click Proceed.

**Step 2:** Review the network fee and transaction details carefully.

**Note:** imToken currently does not support EIP-7702. Gas fees must be paid using the network’s native token.

**Step 3:** Scan the QR code displayed in ZKX Wallet using the imToken mobile application.

**Important:** Complex transactions or messages may generate dynamic QR codes. If this occurs, allow enough time for the device to scan the full QR sequence completely.

**Step 4:** Review the transaction details in the imToken application and click Send.

**Step 5:** Confirm the transaction to generate the QR-based signature.

**Step 6:** Return to ZKX Wallet, click Get Signature, and scan the QR signature displayed in the imToken application.

**Step 7:** ZKX Wallet will process and confirm the transaction status.\
Once completed successfully, the transaction will appear in the wallet’s Activity section.

<br>


# Manually Switching RPC URLs

ZKX Wallet lets you choose which RPC endpoint is used for any network already configured in your wallet, and add your own custom RPC endpoints - without removing or re-adding the network. This is useful when a network's default RPC is slow, rate-limited, temporarily down, or when you prefer a private or self-hosted RPC endpoint.

Switching the RPC URL only changes which server your wallet talks to for reading and broadcasting on-chain data. It does **not** change your account, address, balances, or transaction history.

#### Before You Start

* This works for any network already in your wallet - built-in networks (PulseChain, Ethereum, OP Mainnet, BNB Chain, Polygon, Monad) as well as networks you added yourself via Chainlist or manually.
* You do not need to remove the network to change its RPC - everything happens inside that network's **Edit network** screen.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqaQp0E2p9WUSJko6TzUr%2Fuploads%2FiSso4AzU4NNQhzivPjHa%2F0U4jdmpnvwDj4PlX.mp4?alt=media&token=f4e4a202-3521-415a-a9b2-51de0bbab81a>" %}

#### Step 1 - Open Settings

Click the ZKX Wallet icon to open the extension, then open **Settings**.

The Settings panel shows two columns of options:

|                     |                    |
| ------------------- | ------------------ |
| General             | Accounts           |
| Address Book        | **Networks**       |
| Transaction history | Signed messages    |
| Recovery phrases    | Extension password |
| Privacy Opt-outs    | Custom tokens      |

Click **Networks**.

#### Step 2 - Select the Network and Open Edit

The Networks screen has two panels:

* On the left, a searchable list of your networks (**Search for network**), with **Add network from Chainlist** and **Add network manually** at the bottom.
* On the right, **Network details** for whichever network is selected - shown read-only, with **Edit** and **Disable** buttons in the top-right corner.

Click the network you want to change (for example, **PulseChain**), then click **Edit**. This opens the **Edit network** window for that network.

***

#### Step 3 - Choose a Different Default RPC URL

Inside **Edit network**, under **Network details**, you'll see:

* **Network name**, **Currency Symbol**, and **Currency Name** - shown but not editable here.
* An **RPC URL** input field with an **Add** button next to it (see Step 4).
* **Select default RPC URL** - a list of every RPC endpoint currently available for this network, each with a radio button. The endpoint with the filled/green radio button is the one your wallet is actively using.
* **Chain ID** and **Block Explorer URL** - shown but not editable here.

To switch RPCs, simply click the radio button next to a different endpoint in the **Select default RPC URL** list.&#x20;

For example, on PulseChain you may see multiple options such as `https://rpc.pulsechain.com`, `https://rpc.gigatheminter.com`, and `https://rpc-pulsechain.g4mm4.io` — clicking any one of them selects it as the new default.

On the right-hand side of the Edit network window, an **Available features** box lists what the network supports (for example, whether smart contract wallets are supported, whether transaction simulation is supported, and whether token prices are available).

#### Step 4 - (Optional) Add a Custom RPC URL

If you want to use an RPC endpoint that isn't already listed:

1. Paste the RPC URL into the **RPC URL** field near the top of the Edit network window.
2. Click **Add**.
3. The new endpoint appears in the **Select default RPC URL** list below, alongside the existing options.
4. Click its radio button to make it the active default.

#### Step 5 - (Optional) Remove a Custom RPC URL

Hovering over an entry in the **Select default RPC URL** list reveals a red **Remove** link next to it. Click **Remove** to delete that RPC endpoint from the list.

#### Step 6 - Save Your Changes

At the bottom of the Edit network window are two buttons: **Cancel** and a second button that reads **No changes** (greyed out) until you actually change something, at which point it becomes **Save** (active, blue).

1. Once you've selected a different RPC (and/or added or removed one), click **Save**.
2. A green confirmation banner appears at the top of the window: **"\[Network name] settings saved!"** - for example, "PulseChain settings saved!" - with a small **×** to dismiss it.
3. Close the window to return to the Networks screen, which now reflects your updated RPC selection.

***

#### Important Notes

* If the RPC you switch to is invalid, overloaded, or offline, your wallet may fail to load balances or broadcast transactions on that network. If this happens, reopen **Edit network** and switch back to a working RPC.
* Always double-check a custom RPC URL before adding it - connecting to an untrusted or malicious RPC endpoint could expose which addresses and balances you're viewing, or serve your wallet incorrect chain data.
* The **Save** button stays disabled ("No changes") until a real change is detected - if you don't see it become active after clicking a radio button, make sure you actually selected a different endpoint than the one already active.


# ZKX WALLET WEB APP


# Introduction

<figure><img src="/files/SGuGfggKctsO4Q0yEA16" alt=""><figcaption></figcaption></figure>

The ZKX Wallet Web App brings the full ZKX Wallet experience to any modern web browser, eliminating the need for platform-specific applications or browser extensions. Built from the same trusted codebase as the ZKX Wallet Extension, it delivers the same security, functionality, and user experience across virtually any device.

Whether you're using a desktop, laptop, tablet, or smartphone, you can securely access your wallet from:

* Windows
* macOS
* Linux
* Android
* iOS (Safari, Chrome, and other modern browsers)
* ChromeOS
* Any device with a modern web browser

No native installation is required. For a more app-like experience, the Web App can also be installed as a **Progressive Web App (PWA)** on supported devices.

### **Secure by Design**

The ZKX Wallet Web App remains fully self-custodial. Your private keys are encrypted and remain under your exclusive control at all times. The wallet utilizes encrypted passkey-based security to protect your HOT wallet without requiring identity verification or dependence on centralized backup services.

### **Full Feature Compatibility**

The Web App includes the same core functionality available in the ZKX Wallet Extension, including:

* Public Mode and Private Mode powered by Railgun
* Shielding and unshielding supported assets
* Multi-chain support across PulseChain and EVM-compatible networks
* Unified management of public and private balances
* Hardware wallet support, including QR-based signing
* Seamless interaction with decentralized applications (dApps)

### **Continuous Improvements**

Because the Web App is delivered directly through the browser, new features, performance enhancements, and security updates can be deployed rapidly without requiring users to install new software or wait for app store approvals.

The ZKX Wallet Web App combines accessibility, privacy, and security into a single experience - making secure self-custody available wherever a modern web browser is available.


# Getting Started

#### Creating or Importing an Account

From **Settings → Accounts**, open **Add an account** to add a wallet. Five options are available:

1. **Add from stored recovery phrases** — creates an additional account derived from a recovery phrase already stored in the wallet.
2. **Create new recovery phrase** — generates a brand-new seed phrase and account.
3. **Import an account** — restores an existing wallet using either a recovery phrase or a private key.
4. **Connect a hardware wallet** — supports Trezor, Ledger, GridPlus, SafePal, and QR-based hardware wallets.
5. **Watch an address** — adds a read-only account by address, with no signing capability.

**Important: private-key-only accounts cannot use privacy features**

An account imported using only a private key can view and transact with public balances, but it **cannot** use Private Mode, Shield, or Unshield. These features require deriving a Railgun viewing key, which is only possible from a full recovery phrase (seed phrase).

If you try to open Shield on a private-key-only account, the Web App shows a tooltip explaining that a private wallet requires a seed phrase, and navigating directly to the Shield URL redirects you back to the dashboard. If you plan to use Private Mode, make sure the account was created or imported with a recovery phrase rather than a private key alone.

#### The Home Screen (Dashboard)

<figure><img src="/files/KuVRmwNH9qlaGoTmZSgx" alt=""><figcaption></figcaption></figure>

The Home screen shows:

* **Estimated Balance** for the active account
* A **portfolio allocation** breakdown
* A **Recent Activity** feed

A network filter, set to **All Networks** by default, narrows the view to a single chain — for example PulseChain, Ethereum, OP Mainnet, BNB Chain, Polygon, Base, or Arbitrum. A second filter switches the asset view between **Tokens**, **NFTs**, and **DeFi positions**. Click the eye icon next to the balance to toggle its visibility; when hidden, the numeric balance is replaced with masked dots.


# Public Mode vs Private Mode

ZKX Wallet Web App operates in one of two modes, toggled with the **Public / Private** switch near the account name:

* **Public Mode** displays ordinary on-chain balances tied to the account's public (`0x…`) address. Standard sending, receiving, and swapping happen here.
* **Private Mode** displays Railgun shielded balances tied to the account's private (`0zk…`) address. The interface switches to an orange/amber accent to visually distinguish it from Public Mode.

For background on what each mode means and its privacy tradeoffs, see Public Mode and Private Mode.

**Switching into Private Mode for the first time**

<figure><img src="/files/N8p48PDpsevFxNPaDs6U" alt=""><figcaption></figcaption></figure>

The first time you switch to Private Mode, the wallet scans encrypted Railgun notes belonging to your account's viewing key. This is shown as a percentage loader — in testing, this progressed from roughly 5% to 18% within about 15 seconds — with a notice that the initial load may take up to **15 minutes**. Subsequent switches are faster, since the wallet no longer needs to scan from scratch.

**Swap & Bridge always requires Public Mode**

If you open **Swap & Bridge** while in Private Mode, the app automatically switches you back to Public Mode, since swapping and bridging only operate on public balances, not shielded ones.


# Managing Accounts

<figure><img src="/files/VJfP7oyBk228AjpPbpe9" alt=""><figcaption></figcaption></figure>

**Settings → Accounts** lists every account added to the wallet, each shown with its public address (and its private address, once Private Mode has been used at least once). From this screen you can:

* Add further accounts, using the same five-option panel described in 2.1 Creating or Importing an Account
* Switch the active account
* Review account details

<figure><img src="/files/U6k2iBU5fjlCUoS03IxN" alt=""><figcaption></figcaption></figure>

**Settings → Recovery phrases** lists the recovery phrases stored in the wallet. This list is empty for accounts created purely from a private key import, which is expected — see the note in 2.1 on why private-key-only accounts have reduced functionality.


# Managing Networks

<figure><img src="/files/aYuGTo1ujQhVA7Sv6RFY" alt=""><figcaption></figcaption></figure>

**Settings → Networks** shows every configured network — PulseChain, Ethereum, BNB Chain, Polygon, Base, Arbitrum, OP Mainnet, and others. Selecting a network opens an edit screen showing:

* Its **RPC URL**, which can be changed manually if the default endpoint becomes slow or unavailable
* A list of **Available features** supported on that network

**Important Notes**

* Changing a network's RPC endpoint affects only how your wallet connects to that chain — it does not change which assets or contracts exist on it.
* If you experience connection issues on a specific network, check **Available features** first to confirm the network supports what you're trying to do.


# Sending Tokens (Public Mode)

<figure><img src="/files/2TXZCILq1XVrOUFmZqUk" alt=""><figcaption></figcaption></figure>

The **Send** screen is titled **"Send public tokens"** while in Public Mode.

1. Choose the **token** you want to send.
2. Enter the **recipient address**.
3. Specify the **amount**.
4. Optionally, use **Start a batch** to queue this transfer alongside others instead of sending it immediately.
5. Use the **Address Book** shortcut to reuse a previously saved address.

**Important Notes**

* Always double-check the recipient address before confirming - public transfers cannot be reversed once broadcast.
* Public sends are visible on-chain and can be viewed through a block explorer.


# Receving Tokens (Public Mode)

<figure><img src="/files/498T9BNbiWzjNPMZs6VY" alt=""><figcaption></figcaption></figure>

Open **Receive** to display a modal containing:

* A **QR code** of your account's public address
* The **address text**, for copying
* A **Supported networks** row showing which chains that address can safely receive funds on

Only send funds on a network listed under **Supported networks** for that address. Sending an asset on an unsupported network can result in permanent loss of funds.


# Swap & Bridge

**Swap & Bridge** provides in-wallet token swapping and cross-chain bridging. It only operates on **public balances** - opening it while in Private Mode automatically switches the wallet back to Public Mode first, as noted in Public Mode vs. Private Mode.

<figure><img src="/files/Y1JOJ0IqPnseANLfBjFM" alt=""><figcaption></figcaption></figure>

The interface includes:

* A **Top pair** suggestion
* **You send** and **You receive** fields
* A **Gasless mode** toggle
* **Minimum / maximum amount** limits for the selected pair
* A **Before you swap** panel summarizing key conditions before you confirm

**Important Notes**

* Review the **Before you swap** summary every time - minimums, maximums, and rates can vary by token pair and network.
* Gasless mode lets the swap proceed without requiring a separate native gas token balance in the source wallet; see Common Issues While Using Liberty Swap → Gasless Mode Not Available if the toggle isn't available for your selected pair.


# Shielding Tokens (Entering Private Mode)

Shield converts public tokens into private Railgun balances. As noted in 2.1, this is only available on accounts that have a recovery phrase — private-key-only imports cannot shield assets.

<figure><img src="/files/3zk7aD1QJpyOx0Xznbml" alt=""><figcaption></figcaption></figure>

The Shield screen includes:

* **Add recipient** - the destination is always a private `0zk` address, typically your own private address.
* **Route selection** - choose between:
  * **Fast route**: roughly 2 minutes, a **0.5% fee**, supports receiving a different token than the one you sent, and covers roughly six chains.
  * **Slow route**: roughly 60 minutes, a **0.25% fee**, but the recipient receives the **same token** that was sent, and supports fewer chains.
* **You send** - choose the source token and network (for example, USDC on PulseChain), within the token's minimum and maximum shieldable amount (observed as roughly **10–25,000 USDC**). The token picker groups available assets by network: PulseChain, BNB Chain, Ethereum, Base, Arbitrum, Polygon.
* **You receive** - shows the destination token labeled with a **RAILGUN** suffix (for example, "USDC · RAILGUN"). Available destination networks can be narrower than the source options — for USDC, only Ethereum and BNB Chain were available as receive networks during testing.
* **Gasless mode** - enabled by default; when enabled, the shielding fee is used to cover gas costs so you don't need a separate native token balance to complete the transaction.
* **One last check** - a confirmation summary showing the chosen route, gasless mode status, the resulting private RAILGUN balance, and an explicit warning to double-check the recipient address.


# Unshielding Tokens

Unshield converts private Railgun balances back into public tokens.

If the wallet is in Public Mode when you open **Unshield**, it automatically switches to Private Mode and shows a banner instructing you to let the private wallet finish loading balances before unshielding. Once balances are loaded, the Unshield flow mirrors the Shield flow — recipient, route, send/receive amounts, and **One last check** — but in the reverse direction.

**Important Notes**

* Wait for the private balance to finish loading before starting an unshield — attempting to unshield from a partially synced balance can be confusing or show incomplete amounts.
* As with shielding, double-check the recipient address before confirming; unshield transactions cannot be reversed.


# Sending Private Tokens

While in Private Mode, the **Send** screen becomes **"Send private tokens."** Instead of a standard address field, it requires a **Private address** (a `0zk` address).

A **Before you send** panel highlights three important points:

* Private transfers do **not** appear on the public on-chain ledger.
* The `0zk` recipient address must be checked carefully — private sends cannot be undone.
* Generating the zero-knowledge proof required for the transfer may take some time to complete; this is expected and not a sign of a stuck transaction.


# Receiving Tokens Privately

While in Private Mode, **Receive** opens a **"Private receive"** modal showing:

* A **QR code** of your `0zk` address
* A **Supported networks** row

Private receive supports fewer networks than public receive — in testing, only Ethereum, BNB Chain, and Arbitrum were shown. Confirm the sender is using a supported network before sharing your private address.


# Batch Transactions

<figure><img src="/files/y95LKcgrtZVYjFqQVYHq" alt=""><figcaption></figcaption></figure>

The **Send** screen offers a **Start a batch** option, letting you group multiple send operations into a single batch flow instead of submitting each transfer separately. This is useful when sending to several recipients or sending multiple tokens at once, since it reduces the number of individual signing steps.


# Accessing dApps

<figure><img src="/files/h1BwGVoR6E81SB6r3wPg" alt=""><figcaption></figcaption></figure>

The **Apps** section is a directory of decentralized applications reachable directly from within the wallet, including entries such as Liberty Swap, Liberty Dex, Drops, Bitrefill, Snapshot, and Guild. Use the **Favorites** and **Connected** filters, or browse by category, to find a dApp quickly.


# Connecting Hardware and QR-Based Wallets

Under **Settings → Accounts → Add an account → Connect a hardware wallet**, the Web App supports:

* Trezor
* Ledger
* GridPlus
* SafePal
* Generic QR-based hardware wallets

Once connected, hardware-secured accounts are managed through the same interface as software accounts.

**Current Limitations**

* Shielding assets using a hardware wallet is not currently supported.


# Activity and Transaction History

The **Activity** screen (mirrored under **Settings → Transaction history**) lists past transactions for the active account and mode.

* **In Public Mode:** if the account was imported rather than created fresh in this wallet, the app cannot retrieve transactions that occurred before the import. A link is provided to view the full history on Etherscan instead.
* **In Private Mode:** Activity shows a **"Syncing private activity"** state while it scans the private ledger. The first sync can take a few minutes.


# Settings

The **Settings** section is organized into the following pages:

| Page                    | What it covers                                                                                  |
| ----------------------- | ----------------------------------------------------------------------------------------------- |
| **General**             | Lock Wallet, Auto-lock timing, Passkey unlock, Theme mode, Account icon style, Development logs |
| **Accounts**            | Account list and the Add an account panel — see 2.1                                             |
| **Address Book**        | Saved recipient addresses for quick reuse when sending                                          |
| **Networks**            | Network list and RPC configuration — see 5. Managing Networks                                   |
| **Transaction history** | Same data as the Activity screen — see 16. Activity and Transaction History                     |
| **Signed messages**     | A log of messages the wallet has signed for dApps                                               |
| **Recovery phrases**    | Stored recovery phrases; empty for private-key-only accounts                                    |
| **Password**            | Change the wallet's unlock password                                                             |
| **Privacy Opt-outs**    | Toggle to disable automatic discovery of tokens, NFTs, and DeFi positions                       |
| **Custom tokens**       | Separate lists for manually added Custom Tokens and Hidden Tokens                               |
| **About**               | App version, link to Terms of Service, links to ZKX social platforms                            |




---

[Next Page](/llms-full.txt/1)