Skip to main content

​
Before you start

  • Wallets: an EVM wallet (MetaMask / Rainbow) on Sepolia and/or a Stellar wallet (Freighter) on Testnet — you need the wallet of the chain you’re depositing from.
  • Test funds: Sepolia ETH for gas and the token you’re bridging; XLM on Stellar Testnet. The in-app faucet covers the test tokens.

​
Step 1 — Register your settlement key (once per wallet)

Every trading wallet needs a BLS settlement key registered before it can complete a trade. On the BLS Keys page:
1

Derive

Sign the derivation message. Your key is computed from this signature — it can be regenerated on any device by signing again, so there is nothing to back up.
2

Authorize

Sign the registration authorization. It carries a proof of possession, so nobody can register a key they don’t hold.
3

Confirm

The relayer submits the registration to the registries on both chains and pays the gas (for a Stellar wallet, the Soroban leg is one transaction you submit yourself). The page shows ✓ Registered when both legs confirm.
Keys belong to wallets, not accounts. If you trade from two wallets (one per chain), each wallet registers its own key.

​
Step 2 — Open an order

Pick a route on the Bridge tab, enter the amount, and confirm the deposit transaction from your wallet. Your tokens enter the OrderPortal escrow; the maker’s side locks automatically if their bot is running. If you close the wallet popup by mistake, the order waits for you on the Orders page — Complete Order re-serves the same transaction without reserving more of the maker’s liquidity. Unfunded orders expire after ~30 minutes and release the reservation.

​
Step 3 — Co-sign

When both deposits are confirmed the trade shows Co-sign. One click: your settlement key signs the trade locally (a single wallet signature unlocks the stored key — no transaction). The maker signs their half independently.

​
Step 4 — Watch it settle

Nothing else to do. The status ladder advances as background workers aggregate the signatures, generate the deposit proofs, and submit the unlocks on both chains:
Your bridged tokens arrive at your recipient address on the destination chain. Every transaction is public — the trade page links both unlocks.