Skip to content
ClearPortX

Get started

This page walks through the fastest path to a working ClearPortX session on Canton DevNet. By the end you will have a wallet connected, test assets in hand, and a completed swap through the live CC/cBTC pool.

DevNet

These instructions target the public Canton DevNet. MainNet onboarding follows the same flow but requires wallet KYC with your provider of choice and is restricted to approved participants.

Step 1 — Install a Canton wallet

Section titled “Step 1 — Install a Canton wallet”

ClearPortX supports any wallet that exposes the standard Canton Ledger API. Two good starting points:

Loop Wallet

Browser, self-custody

Web-based self-custodial wallet from 5N. Supports desktop and mobile browsers. QR-based pairing with applications like ClearPortX.

Zoro Wallet

Extension, MPC-based

Non-custodial browser extension with multi-party computation key management. Integrates directly with the ClearPortX dApp.

Both wallets run locally and hold your private keys on your device. ClearPortX never sees or requests your key material.

Step 2 — Create a Canton party

Section titled “Step 2 — Create a Canton party”

A Canton party is the cryptographic identity that signs transactions. Your wallet will prompt you to create one on first launch; if you are connecting an existing party, paste its identifier in the format party::namespace.

# Example party identifier
trader-alice::1220c3b0b4f1...9ab7

The namespace portion is determined by your wallet provider and corresponds to the participant node that hosts your data. You will not need to edit it manually.

Step 3 — Acquire test assets

Section titled “Step 3 — Acquire test assets”

On DevNet, test CC and test cBTC are available through faucets. Ask your wallet provider for the current faucet URL, or request tokens directly from the #validator-operations Slack channel in the Canton ecosystem.

You will need:

  • Test CC to pay for transaction traffic fees
  • A second asset (typically cBTC) to swap against

Keep at least a small CC balance in reserve — every Canton transaction consumes traffic fees paid in CC.

Step 4 — Connect to ClearPortX

Section titled “Step 4 — Connect to ClearPortX”

Open the dApp at app.clearportx.com. Click Connect wallet, choose your provider, and approve the pairing request in your wallet.

Once connected, you will see:

  • Your party identifier in the header
  • Your current balances for any supported assets
  • The active DLMM pools with live liquidity

Step 5 — Execute your first swap

Section titled “Step 5 — Execute your first swap”

From the Swap tab, choose your input and output tokens, enter the amount you want to trade, and review the quote. The ClearPortX router will automatically select the best multi-bin path through available pools.

Review

Before confirming, verify the minimum received field. It represents the floor amount you will receive after accounting for slippage tolerance. If the price moves beyond that floor during execution, the swap reverts cleanly with no tokens consumed.

Click Confirm and sign the transaction in your wallet. On Canton, the swap either commits atomically or fails cleanly — there is no intermediate state.

Step 6 — Verify the result

Section titled “Step 6 — Verify the result”

After confirmation, you can verify the swap in three ways:

  1. In-app: your balance updates, and the trade appears in the Activity panel.
  2. On the CC Explorer: navigate to the transaction hash returned by your wallet.
  3. In Daml Studio: query the ledger for the resulting Pool contract state using your party identifier.

Next steps

Section titled “Next steps”

You are now ready to explore the rest of the protocol:

If anything is unclear, reach out on X or LinkedIn — we read every message.