Pearl wallet: download, setup and prl1 addresses

Pearl Research Labs publishes one wallet app, the Pearl Wallet desktop app, plus command-line tools. This guide shows how to download them safely, back up your seed, get a prl1 payout address and fix sync problems.

Official wallet options

Data as of October 6, 2026, ~17:00 UTC. Sources: Pearl GitHub releases.

The desktop app is open source (ISC license) and bundles oyster, Pearl's wallet daemon, a fork of Bitcoin's btcwallet. It is a light wallet (SPV, simplified payment verification) and needs no full node.

oystercli is the official terminal client, with guided wallet creation, seed backup and a "Doctor" diagnostic tool. No desktop app exists for Linux ARM or Windows ARM, but the node release ships pearl-linux-arm64-v1.4.11.tar.gz, which contains oyster and oystercli.

A "Pearl wallet" repository outside github.com/pearl-research-labs is not official.

Download safely

1. Open the wallet release. github.com/pearl-research-labs/pearl/releases/tag/pearl-wallet-v2.0.7. Use a bookmark, not links from chats or ads.
2. Download your installer and checksums.txt. Windows: Pearl-Wallet-Setup-2.0.7.exe. Apple Silicon Mac: Pearl.Wallet-2.0.7-arm64.dmg. Intel Mac: Pearl.Wallet-2.0.7.dmg. Linux x64: pearl-desktop-wallet_2.0.7_amd64.deb.
3. Compute the file's SHA-256 hash from a terminal in your download folder (commands below).
4. Compare it with checksums.txt. All 64 characters must match; upper or lower case does not matter. If they differ, delete the file and download it again.
5. Install. Windows: run the .exe. macOS: open the .dmg and drag Pearl Wallet to Applications. Debian or Ubuntu: sudo apt install ./pearl-desktop-wallet_2.0.7_amd64.deb.

# Windows (Command Prompt or PowerShell)
certutil -hashfile Pearl-Wallet-Setup-2.0.7.exe SHA256

# macOS: Apple Silicon, then Intel
shasum -a 256 Pearl.Wallet-2.0.7-arm64.dmg
shasum -a 256 Pearl.Wallet-2.0.7.dmg

# Linux
sha256sum pearl-desktop-wallet_2.0.7_amd64.deb

In checksums.txt each name has a folder prefix, and the macOS names have a space instead of the dot (Pearl Wallet-2.0.7-arm64.dmg). GitHub renamed the download; it is the same file. Values for v2.0.7:

Data as of October 6, 2026, ~17:00 UTC. Source: official checksums.txt of the pearl-wallet-v2.0.7 release. For a newer version, use that release's own file.

What a checksum proves, and what it does not

A matching hash proves your file is identical to the one GitHub serves, so it catches corrupted or tampered downloads. It does not prove who built the file: checksums.txt sits in the same release, unsigned, so our copy above is only a second reference.

The installers may not be code-signed or notarized (the release build passes no signing keys), so Windows SmartScreen or macOS Gatekeeper may warn you. A pool's setup guide (September 2026) tells Windows users to pause their antivirus. Do not do that. Verify the checksum, and if you allow a flagged file, allow that one file only.

The app never installs updates itself; it only opens the GitHub releases page, so an update prompt pointing elsewhere is not from the official app.

Command line and Linux ARM64

On a Linux ARM64 machine, download pearl-linux-arm64-v1.4.11.tar.gz and checksums.txt from the v1.4.11 release, then run:

sha256sum -c checksums.txt --ignore-missing
tar -xzf pearl-linux-arm64-v1.4.11.tar.gz
./oystercli --oysterbin "$PWD/oyster"

oystercli then configures a light wallet and guides you through wallet creation. The repository README also documents one-line installers; the macOS and Linux one checks the SHA-256 itself.

Create a wallet and back up the seed

1. Choose "Create A New Wallet" on the welcome screen.
2. Enter a wallet name and a password. The password only encrypts the wallet file on this computer. It is not part of your seed, and the Pearl team cannot recover it.
3. Write the 12 words on paper, in order. Avoid the "Copy Seed" button: other software can read the clipboard.
4. Pass the check. The app asks for words #3, #7 and #12, each from four choices, then opens your dashboard.
5. Store the paper offline. Never type the words into a website, a chat or a photo app.

• Seed: 12 English BIP39 words (128 bits of randomness), with an empty BIP39 passphrase.
• No second look: v2.0.7 cannot show or export the seed after creation. If you lose the paper while the wallet still works, create a new wallet and move your coins to it.
• Forgotten password: choose "Restore Wallet From A Recovery Phrase" and enter your seed under a new wallet name. Restore accepts 12 to 24 words or a raw hex seed.

Get a prl1 mining address

In the desktop app, open Receive. Each visit shows a fresh address and its QR code. All of them belong to your seed, so any one works as a pool payout address. In oystercli, use the Receive menu. Advanced users can call getnewaddress on wallet RPC port 44207.

A mainnet address uses bech32m encoding: prl1p followed by 58 more letters and digits, 63 characters in total. That is prl (network) + 1 (separator) + p (Taproot) + 52 data characters + a 6-character checksum.

Pattern (not a real address, do not send to it): prl1pxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.

Paste the address, never retype it, and check its first and last six characters: some malware swaps addresses on the clipboard. Then pick a miner and a pool with our mining guide and pool comparison.

Your own wallet vs an exchange address for payouts

With your own wallet you hold the keys. With an exchange deposit address, the exchange holds them and can pause deposits, change addresses or delist the coin.

As of October 6, 2026, CoinGecko lists native PRL markets only on SafeTrade and BigONE. CoinEx lists native Pearl under the ticker PEARL and showed its deposits as disabled. The "PRL" on Coinbase, Upbit, MEXC and Bitget is Perle, an unrelated Solana token. A native PRL deposit address starts with prl1p; a 0x… or Solana address is not native Pearl.

Solo miners need their own address anyway: pearld --miningaddr pays block rewards to it, spendable after 100 blocks (about 5.4 hours at the 194-second target). Mine to your own wallet and move coins only when you need to.

Wallet not syncing: checks and fixes

The desktop wallet gets peer addresses from DNS seeds under seeder.pearlnetwork.net, then connects to those peers on TCP port 44108. Check, in order:

• Update to v2.0.7. Node v1.4.8 and v1.4.11 moved the DNS seeds from pearlresearch.ai to pearlnetwork.net, so older apps query dropped seeds. v2.0.7 also fixed sends stuck as pending.
• Compare heights. The official explorer showed block ~124,157 on October 6, 2026. If yours is far behind and stuck, read on.
• Be patient after a restore. It rescans from August 26, 2024 (before mainnet), so it reads the whole chain.
• Check the network. Firewalls, VPNs and some public networks can block outbound TCP port 44108. You can also set a custom peer, such as your own pearld node, in the app's settings.
• Stuck at exactly 96,251? GitHub issue #285 (August 13, 2026, still open on October 6) reports wallet v2.0.5 on Windows stuck at 96,251, the height of the rank-penalty soft fork. Issue #332, a testnet report, notes in passing that mainnet checkpoints (up to block 110,000) skip that check on a fresh sync. In #285 itself, one user found a corrupted wallet.db in the logs and fixed it by backing up the wallet folder and restoring from the seed. We have not reproduced either. Update first; background in Pearl hard forks.
• Re-import only as a last resort. Close the app and copy the whole ~/.pearl-wallet folder somewhere safe. Then restore from the seed under a new wallet name: reusing a name can replace the existing wallet files.

Data as of October 6, 2026, ~17:00 UTC. Source: Pearl Wallet and oyster source code, v2.0.7. Each desktop wallet sits in wallet-data/<wallet name>/mainnet/wallet.db in that folder.

Copying the folder backs up the password-encrypted wallet file; it does not replace the seed.

Mobile, extension and web wallets: what exists

None of these comes from Pearl Research Labs, including apps that name the official Discord as their support channel. We list them, without links, so you can identify what you find in app stores.

Data as of October 6, 2026, ~17:00 UTC. Sources: Chrome Web Store, Firefox Add-ons, Apple App Store and each project's GitHub page.

• Two different extensions share the name "Pearl Wallet". Check the publisher and the extension ID, not the name. "Black Pearl Wallet" is the extension of Black Pearl Market, a third-party project that writes PRC-20 inscriptions on Pearl. It is not an official Pearl product.
• The Kaspador wallets and PocketPRL can use Pearl's public Blockbook indexer, which then sees the addresses they look up.
• MetaMask, Ledger and Trezor do not support native PRL. Ethereum wallets can hold only WPRL, a token from a third-party custodial bridge: a claim on PRL, not PRL. Trezor lists only WPRL. "Oyster Pearl (PRL)" is an unrelated 2017 Ethereum token.

Recovery: restoring your seed in other wallets

A third-party wallet that receives your main seed controls all your coins. To test one, create a new seed in it and send a small amount.

The official wallet derives keys with BIP-86, the Taproot standard. Receiving addresses use m/86'/808276'/0'/0/i and change addresses m/86'/808276'/0'/1/i; 808276 is Pearl's coin type. Leave the optional BIP39 passphrase (sometimes called the extra word) empty. The wallet README still shows an m/44' path inherited from btcwallet, but the code uses m/86'.

Oyster derives hardened keys with an old btcd function, DeriveNonStandard, which mishandles private keys that start with a zero byte; its own code comment warns that 1 in 256 hardened derivations will be wrong. Two steps can be affected (coin type and account), so by our analysis of the code, about 0.8% of seeds (1 − (255/256)², about 1 in 128) produce different addresses, and a zero balance, in a wallet that follows BIP32 strictly.

Your coins are not lost: restore the seed in the official wallet or oystercli. The same mismatch can hit a seed created elsewhere. PocketPRL says it reproduces the quirk on purpose; the Kaspador extension's source code uses a standard BIP32 library. We did not check the others.

Post-quantum addresses

Pearl's script language includes OP_CHECKXMSSSIG, which checks XMSS signatures, a hash-based scheme designed to resist quantum computers. Released node code executes it inside Taproot scripts, although the April 2026 whitepaper called it disabled. We have not seen it used on mainnet.

• Default addresses do not include it. Desktop and oystercli addresses are plain BIP-86 Taproot addresses with Schnorr signatures, like Bitcoin's.
• It is opt-in. Oyster's getnewaddress call has an optional pq flag that adds an XMSS spending path, with keys under m/222'/808276'/…. XMSS keys are stateful: each can sign at most 32 times. The desktop app never sets the flag.
• A pq address still starts with prl1p and keeps the normal Schnorr path. The extra leaf changes the address, so a wallet that derives only standard BIP-86 addresses will not find coins sent to it.
• P2MR outputs (prl1z) have no Schnorr key path at all, per the official FAQ.

For mining payouts, a default prl1p address is enough. Background: What is Pearl.

Frequently asked questions