💱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 interface and connect a supported wallet.

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.

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.

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.

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.

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.