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.

wPRL (“wrapped PRL”) is the Solana SPL representation of native PRL. Every wPRL in circulation is backed 1:1 by PRL held in Pearl reserves under the Nacre validator quorum.

At a glance

PropertyValue
SymbolwPRL
Decimals8 (matches PRL satoshis)
Token programSPL Token (classic)
Mint authoritynacre_liquidity_management vault PDA
Freeze authoritynacre_two_way_peg PDA (used for withdrawal escrow)
Transfer taxNone — wPRL is freely transferable
Supply modelMint-on-deposit, burn-on-redemption
wPRL imposes no transfer tax and no per-transfer fee. Fees only apply when crossing the bridge (mint or burn). Once minted, wPRL behaves like any other SPL token and can be moved, traded, lent, or held without protocol fees.

Contract addresses

ContractAddress
wPRL SPL mintTBD
nacre_two_way_peg programTBD
nacre_liquidity_management programTBD
nacre_layer_ca programTBD
nacre_layer_fee_management programTBD
nacre_protocol_config programTBD
Admin multisig (3-of-5)TBD
Protocol treasuryTBD

Fees

Nacre charges fees only at the bridge boundary. There are three components on both mint (deposit) and burn (withdrawal):
ComponentWhat it isWho keeps it
Miner feePearl network fee for the sweep / redemption transactionPearl miners (passthrough)
Validator marginFixed satoshi amount per validator attestationValidators (distributed monthly)
Protocol feeBasis-point fee on the amount crossing the bridgeProtocol treasury
The math the on-chain program enforces:
user_net = amount − miner_fee − validator_margin − protocol_fee
protocol_fee = amount × protocol_fee_bps / 10_000

Current parameters

All fee parameters are set in the on-chain ProtocolConfig account and can be adjusted by the admin multisig (subject to timelock).
ParameterMint (deposit)Burn (withdraw)
protocol_fee_bpsTBD bpsTBD bps
validator_margin_sats_per_attestationTBD satsTBD sats
Miner feedynamic (Pearl mempool)dynamic (Pearl mempool)

Token functionality

Because wPRL is a standard SPL token, it supports everything the SPL standard supports out of the box:
  • Transfer — send wPRL to any Solana address.
  • Approve / delegate — grant another account the right to spend on your behalf (e.g. for DEX routing).
  • Associated Token Accounts — wallets create ATAs automatically.
  • Burn — anyone can burn their own wPRL, but burning outside the withdrawal flow does not release PRL on Pearl. Always burn via the Nacre app or by calling AddWithdrawalRequest on nacre_two_way_peg.
Do not send wPRL to centralized exchanges or contracts that do not explicitly support wPRL — they may not credit your deposit, and if they burn the token outside the Nacre flow, the underlying PRL becomes permanently unredeemable.

Where to go next

Mint wPRL

Lock PRL on Pearl, receive wPRL on Solana.

Burn wPRL

Redeem wPRL for PRL on Pearl.