Mining CLI reference
Mine and claim Solana Devnet test BCAT in your terminal. The website displays finalized activity and credit by public address.
Installation
Standalone CLI for Linux x64
Install Node.js 24 and OpenSSH. Download all three files into one directory.
Download the Devnet publisher allowed-signers file into the same directory. It contains a public signing key, never a wallet secret. This website is the distribution trust source; a signature only authenticates an archive relative to the publisher key you trust. Keep a previously trusted copy when checking later releases. Verify the signature and archive before extraction.
export TRUSTED_ALLOWED_SIGNERS="$PWD/devnet-cli-allowed-signers"
ssh-keygen -Y verify -f "$TRUSTED_ALLOWED_SIGNERS" -I bcat-release -n bcat-devnet-cli-release -s 'bcat-devnet-cli-f106c11-linux-x64.tar.gz.sha256.sig' < 'bcat-devnet-cli-f106c11-linux-x64.tar.gz.sha256' &&
sha256sum 'bcat-devnet-cli-f106c11-linux-x64.tar.gz' | cmp - 'bcat-devnet-cli-f106c11-linux-x64.tar.gz.sha256' &&
tar -xzf 'bcat-devnet-cli-f106c11-linux-x64.tar.gz' &&
export PATH="$PWD/bcat-devnet-cli:$PATH" &&
bcat --version &&
bcat --helpThe PATH setting applies to this shell. Keep the extracted folder and run mining jobs from your own working directory.
From a source checkout
For contributors who already have repository access, start in the V6.2 repository root with Node.js 24 and pnpm 11.22.0. The command runs the checked-out source using its locked dependencies.
pnpm install --frozen-lockfile
pnpm bcat --version
pnpm bcat --helpFrom the checkout, use pnpm bcat wherever the standalone examples say bcat. Use bcat COMMAND --help for options. For scripts, pnpm --silent bcat suppresses the package runner banner. Commands print JSON results to stdout and diagnostics to stderr.
Configure and mine
Use the public address of your own dedicated Devnet keypair. Keep its private file on your machine. Replace the address below. Run each command from the same working directory.
bcat init --wallet YOUR_DEVNET_PUBLIC_ADDRESS
bcat statusinit creates bcat.devnet.json once. It pins the release identity and contains only public configuration. status reads the finalized mining round. You can also use status --wallet ADDRESS before creating a config. Start a search when the status is OPEN.
This source checkout and its matching CLI package support init --rpc-url HTTPS_URL --config FILE. Every command using that config selects the same provider. Use a trusted credential-free HTTPS endpoint; never put API tokens in this public file. The CLI still verifies Solana Devnet and the pinned BCAT release. It does not automatically switch providers or resend transactions.
For recovery through another provider, preserve the original config and create a separate config with the same wallet and release identity. Pass that file with --config and keep the original run and journal paths. Recovery reads the existing journaled signature only; it cannot submit a replacement.
On Linux, create the run parent and journals on ext4 under your home directory. Use mode 0700 for these directories. Each ancestor must be owned by you or root and prevent another user from renaming the path. If old storage was shared, retain the originals and reconcile any outstanding submission before starting a new one. Supply a new run directory for each new job.
umask 077
mkdir -p runs journals/proofs journals/claims
bcat mine --run runs/search-001 --attempts 1000000 --seconds 60The miner searches with your CPU until it finds a candidate, exhausts a limit, or the round changes. A win produces runs/search-001/result.json with status UNSIGNED_CANDIDATE. A stopped run records its reason in the same file. Searching costs no SOL. A proof is bound to the configured wallet, release and round.
Submit a winning proof
Continue only after finding an unsigned candidate. Set BCAT_KEYPAIR to the path of the matching Devnet keypair file. Signing requires Linux, private ext4 run and journal storage, and a key file owned by your account with mode 0600. The test wallet needs Devnet SOL for fees.
export BCAT_KEYPAIR="/absolute/path/to/devnet-keypair.json"
bcat submit --candidate runs/search-001/result.json --keypair "$BCAT_KEYPAIR" --run runs/proof-001 --journal journals/proofs --max-fee-lamports 10000This command can send one transaction. It rechecks the proof and fee quote against your limit. Another miner can win first. Record the signature and inspect its finalized outcome before treating a proof as accepted.
Check and claim credit
Replace DAY with the day of your accepted proof. Check credit in the CLI or use the website's public credit lookup.
bcat claim --day DAYWhen the status is AVAILABLE, the same miner can claim to its own token account. Version-4 days allow 30 days from successful daily CLOSE, when credit becomes claimable. Already-closed version-3 days retain their original deadline of 72 hours after the scheduled day end. Check the recorded deadline in the CLI or public credit lookup; retries do not extend it. The example permits a fee quote of at most 10,000 lamports and account rent of at most 3,000,000 lamports. These are spending ceilings, not quoted charges. A new token account has previously required 2,039,280 lamports; the CLI checks the current quote and refuses above your limit. Choose your own limits. One SOL is one billion lamports.
bcat claim --day DAY --submit --keypair "$BCAT_KEYPAIR" --run runs/claim-001 --journal journals/claims --max-fee-lamports 10000 --max-rent-lamports 3000000Recover an original transaction
During a contract upgrade, the CLI waits for the reviewed code to activate. If it reports a program mismatch, pause new submissions and check the release notice before trying again.
If a submission times out or its status is uncertain, keep the original config, run directory and journal. Use the same paths. Recovery inspects the original signature without broadcasting a replacement.
bcat recover proof --run runs/proof-001 --journal journals/proofs
bcat recover claim --day DAY --run runs/claim-001 --journal journals/claimsIf records are missing or disagree, preserve them for inspection. For an older website submission, look up the original signature on Solana Devnet. A new CLI job cannot recover a browser's private journal.
Exit codes: 0 successful read, search or finalized transaction, 1 failure, 2 search stopped (read the recorded reason), 3 unresolved transaction, 64 invalid arguments. For an unresolved transaction, inspect the original.
Difficulty and fees
The reward release starts at roughly one billion expected hashes per proof, with daily adjustment limited to twofold. Expected time depends on hash rate and competition. A capped search can finish without a win. An accepted proof earns a credit; a finalized claim transfers test BCAT.
The deployed Devnet contract includes the scheduled harder-target amendment. Days 1–18 retain the nominal target. From day 19 (November 17, 2026, 3:00 PM EST), the effective target requires approximately 10,000 times more attempts for the same nominal daily target, starting at about 10 trillion expected hashes. The SHA-256 puzzle and rewards stay the same. Use the matching signed miner; downloading it alone does not change difficulty. Check the current finalized target in the explorer. Mining cost does not guarantee market value.
The reward explorer shows finalized rounds and credits. See the whitepaper for Nine Lives, day closure and burn rules.
Zero-reward practice CLI
This optional tutorial requires a source checkout and its installed dependencies; it is not a command in the standalone miner download. Run it from the repository root. The separate Devnet preview program is for practice. Save the following public config as preview-config.json and replace the public address. Use an absolute path for the new output file.
{
"format": "BCAT_V62_PREVIEW_PROOF_CONFIG_V1",
"rpcUrl": "https://api.devnet.solana.com/",
"binding": {
"expectedGenesisHash": "EtWTRABZaYq6iMfeYKouRu166VU2xqa1wcaWoxPkrZBG",
"programId": "EXAyKp1k1svo7gTqJRx1w6n7xnYLs2BwTa4vBVsjbEve",
"mint": "AjhhqFnh5qUfYgT6Gd3a8Sh9A8Wq5aY6E2NbEN6qA3j6",
"policyHash": "3d00465a1f66022c01250d79659157156724e3e656e5f90a3139215dec58c926",
"minerPubkey": "YOUR_DEVNET_PUBLIC_ADDRESS"
},
"attemptCap": 10000
}node --experimental-strip-types scripts/pow/v62-prepare-preview-proof.ts --config /absolute/preview-config.json --output /absolute/practice-proof-001.jsonThis practice command prepares an unsigned instruction and earns zero BCAT. View the practice explorer.