README quickstart dry-run command does not match install-miner.sh path

[godd-ctrl]

Summary

The root README quickstart currently tells newcomers to run this sequence:

curl -sSL https://raw.githubusercontent.com/Scottcjn/Rustchain/main/install-miner.sh | bash
rustchain-miner --dry-run

But install-miner.sh downloads the Python miner into ~/.rustchain, creates ~/.rustchain/start.sh, and optionally installs a user service. It does not appear to install a rustchain-miner executable on PATH. A newcomer following the README exactly may get command not found after the installer succeeds.

Where I saw it

• README.md Quickstart section, lines around 260-264
• install-miner.sh, which creates ~/.rustchain/start.sh and runs rustchain_miner.py
• START_HERE.md, which points current users toward clawrtc install, clawrtc start, clawrtc status, and clawrtc logs

Expected

The README dry-run example should match the installer path, for example:

curl -sSL https://raw.githubusercontent.com/Scottcjn/Rustchain/main/install-miner.sh | bash -s -- --dry-run

or it should explain that rustchain-miner --dry-run is for the Rust binary/Homebrew path, not the one-line Python installer path.

Actual

The README mixes the one-line Python installer with the Rust binary command, which is confusing for first-time users trying the safe dry-run path.

Environment

Fresh clone review on Windows/PowerShell; issue found by reading the root README and installer script.

[github-actions]

Welcome to RustChain! Thanks for opening your first issue.

New here? Check out these resources:

• CONTRIBUTING.md — how to earn RTC bounties
• Good First Issues — easy starter tasks (5-10 RTC)
• Bounty Board — all open bounties

Earn RTC tokens by contributing code, docs, or security fixes. Every merged PR gets paid!

1 RTC = $0.10 USD | pip install clawrtc to start mining

[haoyousun60-create]

I would like to fix this README quickstart command mismatch with install-miner.sh. Will update the docs to match the actual script path.

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

[haoyousun60-create]

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

Confirmed: README quickstart uses rustchain-miner --dry-run but the correct command after running install-miner.sh is different.

Root Cause:

README was written before the installer script was updated. The dry-run invocation in the quickstart section doesn't match the actual installer output.

Impact:

• New users hitting 'command not found' on first try
• Poor first-time experience

Fix Available:

PR #3974 addresses this issue.

Claiming bug report bounty.

[jaxint]

Technical Analysis — Issue #3973

Root Cause

The root README's quickstart guide references the wrong executable path after installation. The issue is a documentation-installation mismatch.

Path Analysis

• README instructs: rustchain-miner --dry-run
• Actual script path after install-miner.sh: Likely ~/.local/bin/rustchain-miner or rustchain_linux_miner.py (depending on OS)
• install-miner.sh may install to a non-standard location or create a wrapper script with a different name

Verification Steps

1. Read install-miner.sh to find the actual install destination
2. Check if the README references the correct relative/absolute path
3. Check if the script is added to PATH correctly

Fix Approach

Option A (preferred): Update README quickstart to match what install-miner.sh actually installs:

# After install, the miner is at:
~/.rustchain/miner/rustchain_linux_miner.py
# Or wherever install-miner.sh places it
rustchain_linux_miner.py --dry-run

Option B: Fix install-miner.sh to create a symlink or wrapper named rustchain-miner in PATH.

Impact

Low-risk. Documentation fix only. No code changes required unless Option B is chosen.

[BossChaos]

Bounty Claim: README quickstart command mismatch (#3973)

Delivery

• PR: #3999
• Branch: fix/readme-and-docs-3973-3970-3980

Fix

• Updated rustchain-miner --dry-run → python3 ~/.rustchain/rustchain_miner.py --dry-run --wallet test

Wallet

RTC6d1f27d28961279f1034d9561c2403697eb55602

[fengqiankun6-sudo]

👍