🔏RAILGUN Private Bridging
Private Mode is Liberty Swap’s privacy-preserving execution path for cross-chain asset transfers between Ethereum and PulseChain. It leverages zero-knowledge–based shielding infrastructure to prevent on-chain linkage between source and destination transactions while 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 (Railgun) → WETH (PulseChain)
PulseChain → Ethereum WETH (PulseChain) → ETH (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
First Thing First: Prepare a Shielded Balance
To use Private Mode, users must hold ETH or WETH within a RAILGUN shielded balance. This is achieved by depositing your tokens into a compatible privacy smart contract using a supported wallet interface.
Shielded balances are chain-specific. A shielded balance on Ethereum is distinct from shielded balances on PulseChain or other networks.
RAILGUN → PulseChain
Step 1: Initiate an Intent to Receive WETH (PulseChain) in Liberty Swap
Within the Liberty Swap interface:
Connect your wallet
Select Private Mode.
Choose the supported private route (ETH → WETH).
Specify the amount to swap (subject to current private route limits).
Fill in the Destination Address.
Click [Swap] then [Next].
Copy LibertySwap’s given Railgun ZK address.
Step 2: Send ETH to Liberty Swap
Within the RAILGUN-powered wallet:
Ensure you are operating on the ZK (shielded) side.
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.
Enter the same amount as filled in the Liberty Swap interface in the previous step.
Step 3: Include the Private Memo
Copy the memo provided by LibertySwap.
Paste it into the optional private memo field in your RAILGUN wallet.
Generate the ZK proof.
Submit the transaction in your wallet.
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.
PulseChain → RAILGUN
Step 1: Initiate an Intent to Receive ETH (Ethereum) in RAILGUN
Within the Liberty Swap interface:
Connect your wallet
Select Private Mode.
Choose the supported private route (WETH → ETH).
Specify the amount to swap (subject to current private route limits).
Fill in the Railgun Private 0zk Address.
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.
Last updated