Linux miner rejects documented --show-payload dry-run flag

[godd-ctrl]

Summary

The dry-run testing instructions in the miner bounty ask users to run:

python3 rustchain_linux_miner.py --dry-run --show-payload

devlog/DEVELOPMENT_LOG.md also mentions --show-payload as added. But the current miners/linux/rustchain_linux_miner.py argument parser rejects that flag.

Reproduction

From a fresh clone:

cd miners/linux
python rustchain_linux_miner.py --dry-run --show-payload

Actual result

usage: rustchain_linux_miner.py [-h] [--version] [--wallet WALLET]
                                [--wart-address WART_ADDRESS]
                                [--wart-pool WART_POOL]
                                [--bzminer-path BZMINER_PATH]
                                [--manage-bzminer] [--dry-run]
rustchain_linux_miner.py: error: unrecognized arguments: --show-payload

Expected result

Either:

1. --show-payload should be implemented for the Linux miner dry-run path, or
2. docs/bounty instructions should remove --show-payload and use the currently supported command:

python rustchain_linux_miner.py --dry-run

Environment

• OS: Windows 11 Home 64-bit
• CPU: AMD Ryzen 5 3600 6-Core Processor, 6 cores / 12 logical processors
• Python: 3.13.2
• Repo path: miners/linux/rustchain_linux_miner.py

[haoyousun60-create]

I would like to work on this bug. I will investigate the --show-payload dry-run flag rejection and submit a fix PR.

Claiming per #305 bounty (5-15 RTC).

[haoyousun60-create]

Bug Report Claim (5-15 RTC per #305)

Confirmed: The --show-payload flag is documented in README but not implemented in the Linux miner.

Root Cause: LocalMiner.init in miners/linux/rustchain_linux_miner.py does not accept a show_payload parameter.

Impact: Users following README dry-run instructions get a CLI error.

Fix Available: PR #3976 addresses this issue.

Claiming bug report bounty.

[jaxint]

Technical Analysis — Issue #3975

Root Cause

The --show-payload flag is documented in README.md and bounty instructions but not recognized by the argument parser in rustchain_linux_miner.py.

Likely Location

In argparse / getopt setup — likely a missing --show-payload entry in the argument definition. The parser probably silently ignores unknown flags in some configurations or throws a parse error that users interpret as "rejection."

Verification Steps

1. Run python3 rustchain_linux_miner.py --help and check if --show-payload appears
2. Run with --dry-run --show-payload and capture the actual error message
3. Grep rustchain_linux_miner.py for --dry-run and check what flags are defined alongside it

Fix Approach

Add --show-payload to the argument parser. If --show-payload is intended to print the JSON payload without mining, it should:

• Be a boolean flag: action='store_true'
• Print the full dry-run payload JSON to stdout
• Exit cleanly without attempting network connection
• Align with the documented behavior in bounty instructions

Impact

Low-risk. Pure CLI flag addition. No consensus or ledger changes. Appropriate for a first PR.

[BossChaos]

Bounty Claim: Fix --show-payload flag missing (Issue #3975)

Delivery

• PR: #3997
• Branch: fix/miner-dry-run-verbose-payload

Fix

• Added --show-payload flag to argument parser
• dry_run() now prints full JSON payloads for /api/attest and /api/enroll endpoints
• Tested: python3 rustchain_linux_miner.py --dry-run --show-payload --wallet test123

Wallet

RTC6d1f27d28961279f1034d9561c2403697eb55602

[fengqiankun6-sudo]

👍