Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.nacrelabs.xyz/llms.txt

Use this file to discover all available pages before exploring further.

Minting wPRL is a two-step on-chain process: you send PRL to a Hot Reserve address derived from your Solana key, and the validator quorum mints the corresponding wPRL to your Solana wallet after the deposit confirms.
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

1

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.)
2

Create a Hot Reserve address

Click Deposit PRL. The app calls CreateHotReserveBucket on the nacre_two_way_peg program, which derives a Pearl Taproot address unique to your Solana key.The Hot Reserve 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.
(UI: Hot Reserve address card with QR code and copy button — screenshot TBD.)
3

Verify the address (recommended)

Click Verify offline. The app re-derives the Hot Reserve address from your Solana key entirely client-side and compares it with the on-chain record. If they don’t match, do not deposit.
4

Send PRL to the Hot Reserve 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 100 Pearl confirmations before processing the deposit. At Pearl’s typical block time this is roughly TBD minutes.
5

Wait for the sweep

Once confirmations are reached, the validator quorum signs a sweep that moves your deposit from the Hot Reserve into the shared Cold Reserve. The Nacre app shows live progress:
  1. Detected — validators have seen the deposit.
  2. Confirmed — 100 confirmations reached.
  3. Swept — Cold Reserve sweep broadcast and confirmed.
  4. Minted — wPRL credited to your Solana wallet.
6

Receive wPRL

The nacre_two_way_peg program mints user_net wPRL to your associated token account, where:
user_net = deposit_amount − miner_fee − validator_margin − protocol_fee
See Fees for the parameter values.

​
How long does it take?

PhaseTypical duration
Pearl confirmations (100 blocks)TBD
Validator detection + quorum signingseconds to minutes
Cold Reserve sweep confirmation1 Pearl block
Solana mint transaction< 1 minute
End-to-endTBD

​
Troubleshooting

Validators wait for 100 confirmations 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).
If the address belongs to someone else, the PRL is theirs. If you sent it to a Hot Reserve 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.
Use the emergency exit. After 7 days you can spend the deposit yourself via the script-path on the Hot Reserve.