§ 12 · Networking · Overview
Networking
How Pearl nodes find each other and pass blocks around
On this page 4 sections
Pearl has no central server. Its ledger lives on a crowd of computers, nodesNode: A computer running Pearl's software. It keeps a copy of the blockchain, checks every new block and transaction against the rules, and passes them on., each connected to a handful of others, its peersPeer: Another node that yours is directly connected to. Blocks and transactions spread from peer to peer.. A new block or transaction spreads like news in a village: each node checks it, then tells its neighbors.
This group is about that conversation: how a node finds peers, what it says to them, how the conversation is encrypted, and how lighter software follows along. Most of it is inherited from btcd, the Bitcoin node Pearl’s code grew from. The parts that changed all trace back to two facts: Pearl’s blocks carry a ~60 KB certificate, and Pearl encrypts everything.
Try it
The network’s live vital signs: tip height, difficulty, block pace and mining rate.
What happens when a node joins?
-
Find peers
Ask the three DNS seeds (
reef.,tide.andstream.seeder.pearlnetwork.net) for addresses of healthy nodes. See peers and seeds. -
Connect
Open a TCP connection to port 44108. See magic bytes and ports.
-
Encrypt
Run the BIP-324 handshake. From here on, every byte is encrypted. See encrypted transport.
-
Say hello
Swap
versionandverackmessages: protocol version 2, services, user agent. See messages. -
Catch up
Download headers with their certificates, 100 at a time, verifying every certificate, then the blocks themselves.
-
Stay in sync
Hear about new blocks and transactions, check them, and pass them on. See nodes.
The network at a glance
- P2P port
- 44108
- RPC 44107 · wallet 44207
- Magic
- 0x50524C4D "PRLM"
- never sent in the clear
- Transport
- BIP-324 only
- no unencrypted fallback
- Protocol version
- 2
- minimum accepted: 2
- Headers per message
- 100
- each with its certificate
- User agent
- /pearlwire:0.5.0/pearld:1.5.2/
- pearld 1.5.2
What’s different from Bitcoin’s network?
Make a guess
A brand-new node syncs Pearl from scratch. Roughly how much certificate data does it download just for the headers up to block 130,827?
Think of your answer first, then check it.
Answer About 7.8 GB.
Each header arrives with its certificate: 108 + 59,768 = 59,876 bytes today. There were 130,827 blocks by 20 October 2026: 130,827 × 59,876 bytes ≈ 7.8 GB, before a single transaction. (Rough arithmetic: early certificates were a few bytes smaller.) The node verifies every one of those proofs as it goes.
In this group
- 12.01 Nodes The computers that check every rule for themselves
- 12.02 Peers and seeds How a brand-new node finds its first friends
- 12.03 Magic bytes and ports PRLM: a network name that never crosses the wire in the clear
- 12.04 Messages What nodes say to each other, and why headers come 100 at a time
- 12.05 Encrypted transport Every connection encrypted, with no way to switch it off
- 12.06 Light clients Checking the mining work without keeping the blocks