UI walkthrough placeholder. Screenshots and exact button labels will be
filled in once the Nacre app is published. The flow described below is
authoritative against the protocol, not the UI.
Prerequisites
- A Solana wallet that holds a small amount of SOL for transaction fees (Phantom, Backpack, Solflare, or similar).
- A Pearl wallet that holds the PRL you want to bridge.
- A minimum deposit large enough to cover bridge fees (see Fees).
Step-by-step
Open the Nacre app and connect your Solana wallet
Visit
TBD and connect the Solana wallet that will hold wPRL.
(UI: connect-wallet button, screenshot TBD.)Create a Deposit Address
Click Deposit PRL. The app calls
create_hot_reserve on the
nacre_liquidity_management program, which derives a Pearl Taproot
address unique to your Solana key.The Deposit Address has two spending paths:- Key-path: controlled by the validator quorum (this is the path used to sweep your deposit to the Cold Reserve and mint wPRL to you).
- Script-path: controlled by you, but only after 7 days (1,008 Pearl blocks). This is your emergency exit.
Verify the address (recommended)
Click Verify offline. The app re-derives the Deposit Address from
your Solana key entirely client-side and compares it with the on-chain
record. If they don’t match, do not deposit.
Send PRL to the Deposit Address
From your Pearl wallet, send PRL to the displayed address. Send any amount
above the minimum; the protocol does not require an exact amount.Validators wait for a configurable confirmation depth (default 6
Pearl blocks, set on-chain in
ProtocolConfig.confirmation_depth)
before processing the deposit. At Pearl’s typical block time this is
roughly TBD minutes.Wait for the sweep
Once confirmations are reached, the validator quorum signs a sweep that
moves your deposit from the Deposit Address into the shared Cold Reserve.
The Nacre app shows live progress:
- Detected: deposit transaction has appeared in a Pearl block.
- Confirming: the indexer is tracking the deposit through each block toward the configured confirmation depth (UI shows “n / 6”). No validator action yet.
- Confirmed: confirmation depth reached; the validator quorum begins attesting.
- Swept: Cold Reserve sweep broadcast and confirmed.
- Minted: wPRL credited to your Solana wallet.
Receive wPRL
The See Fees for the parameter values.
nacre_two_way_peg program mints user_net wPRL to your associated
token account, where:How long does it take?
| Phase | Typical duration |
|---|---|
| Pearl confirmations (default 6 blocks) | TBD |
| Validator detection + quorum signing | seconds to minutes |
| Cold Reserve sweep confirmation | 1 Pearl block |
| Solana mint transaction | < 1 minute |
| End-to-end | TBD |
Troubleshooting
My deposit confirmed on Pearl but wPRL hasn't been minted
My deposit confirmed on Pearl but wPRL hasn't been minted
Validators wait for the configured confirmation depth (default 6
Pearl blocks) before sweeping. After that, the sweep and mint
typically complete within minutes. Check the Nacre app
status. If it’s been stuck for more than a few hours, contact support
(
TBD).I sent PRL to the wrong address
I sent PRL to the wrong address
If the address belongs to someone else, the PRL is theirs. If you sent it
to a Deposit Address you control but for the wrong Solana wallet, you can
still mint into the correct address by re-running this flow from the
original wallet, or recover the deposit and start over.
I want my PRL back without minting wPRL
I want my PRL back without minting wPRL
Use the emergency exit. After 7 days you can spend the
deposit yourself via the script-path on the Deposit Address.