Pearl CLI Integration¶

Diapason includes a thin diapason pearl wrapper for Pearl's native command line tools. It does not replace Pearl's node or wallet; it makes the common commands discoverable from the same CLI users use for mining.

Binary Discovery¶

diapason pearl looks for pearld, oyster, and prlctl on PATH, then under $PEARL_HOME/bin.

export PEARL_HOME=/path/to/pearl
diapason pearl doctor

Native Pass-Through¶

Use pass-through commands when you need the full Pearl surface:

diapason pearl node -- --help
diapason pearl wallet -- --help
diapason pearl ctl -- --help

These map directly to:

Diapason command	Pearl binary
`diapason pearl node`	`pearld`
`diapason pearl wallet`	`oyster`
`diapason pearl ctl`	`prlctl`

The command format is always diapason pearl <command>. Pearl-native arguments go after that command. Use -- before Pearl arguments when the arguments begin with dashes and you want to make the pass-through boundary explicit.

Wallet Address Helper¶

If Oyster is already running, generate a mining address through wallet RPC:

diapason pearl address \
  -u rpcuser \
  -P rpcpass \
  -s localhost:44207

The helper uses prlctl --wallet and defaults to --notls, which matches the local validation flow. Use --tls --skipverify if your Oyster RPC endpoint is serving TLS with a local certificate.

Boundary¶

diapason mine is the Diapason mining lifecycle. diapason pearl is an escape hatch to Pearl's native node, wallet, and RPC tools. For advanced node or wallet administration, Pearl's own help output is the source of truth.