Skip to content

Conversation

@xngo7993-hue
Copy link
Contributor

This PR adds comprehensive documentation for the RustChain protocol, addressing the inaccuracies in previous drafts.

It covers:

  • Architecture: Python/Flask + SQLite implementation.
  • Consensus: RIP-200 Proof-of-Attestation (1 CPU = 1 Vote).
  • Fingerprinting: Detailed breakdown of the 6 hardware checks.
  • Economics: 8M cap, antiquity multipliers.
  • Anchoring: Ergo blockchain state commitment.

Fixes #8.

Copy link
Owner

@Scottcjn Scottcjn left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good structure and readable format. This maps to Bounty #8 on rustchain-bounties.

However, there are several factual errors that need fixing before merge:

Errors to fix

1. Epoch duration (§2.1)

"Epochs (approx. 24 hours)"

Wrong. Epochs are 10 minutes (BLOCK_TIME = 600 seconds). Attestation TTL is 24 hours, but that's how long an attestation stays valid — not the epoch length.

2. Total supply (§4)

"Total Supply: 8,000,000 RTC (Capped)"

Should be 8,388,608 RTC (2²³). The power-of-2 cap is intentional.

3. Premine amount (§4)

"Premine: 75,000 RTC (Dev fund/Bounties)"

The total premine is 503,316 RTC (6% of supply), split across 4 founder wallets:

  • founder_community: ~76K
  • founder_founders: ~75K
  • founder_dev_fund: ~26K
  • founder_team_bounty: ~4K (after payouts)

4. Epoch pot frequency (§4)

"1.5 RTC distributed every ~24 hours"

Should be 1.5 RTC per epoch (every 10 minutes). That's 216 RTC/day.

5. ARM multiplier (§4.1)

"Generic ARM: 0.0001x"

There's no "Generic ARM" category. VMs get ~0.000000001x (1 billionth). Regular ARM (aarch64) gets 1.0x (same as modern). Apple Silicon (M1/M2/M3) gets 1.2x. The 0.0001x figure doesn't exist in the codebase.

6. Missing architectures (§4.1)
The multiplier table is incomplete. Missing:

  • POWER8: 2.0x
  • Pentium 4: 1.5x
  • Core 2 Duo: 1.3x
  • Nehalem: 1.2x
  • Sandy Bridge: 1.1x

7. Missing Node 3 (§5.1)
Node 3 at 76.8.228.245:8099 (Ryan's Proxmox) is the first external attestation node. Should be listed.

Minor note

The footer says "Generated by Shadow Protocol Auditor (EchoDrifter)" — if this is AI-generated, that's fine, but the factual data needs to come from the actual codebase, not inference. Check the source at rustchain_v2_integrated_v2.2.1_rip200.py and rip_200_round_robin_1cpu1vote.py for ground truth.

Fix these 7 items and this is mergeable.

Copy link
Owner

@Scottcjn Scottcjn left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good structure and readable format. This maps to bounty #8 on rustchain-bounties.

However, there are several factual errors that need fixing:

1. Epoch duration - Epochs are 10 minutes (BLOCK_TIME=600), NOT 24 hours. Attestation TTL is 24h but that is not the epoch length.

2. Total supply - Should be 8,388,608 RTC (2^23), not 8,000,000.

3. Premine - Total premine is 503,316 RTC (6% of supply) across 4 founder wallets, not 75,000.

4. Epoch pot frequency - 1.5 RTC per epoch (every 10 min) = 216 RTC/day. Not every 24 hours.

5. ARM multiplier - No Generic ARM 0.0001x category exists. VMs get ~1 billionth. Regular ARM/aarch64 gets 1.0x. Apple Silicon gets 1.2x.

6. Missing architectures - Table is incomplete. Missing: POWER8 (2.0x), Pentium 4 (1.5x), Core 2 Duo (1.3x), Nehalem (1.2x), Sandy Bridge (1.1x).

7. Missing Node 3 - 76.8.228.245:8099 (first external node) should be listed.

Fix these 7 items and this is mergeable. Check the actual source files for ground truth values.

@Scottcjn Scottcjn merged commit 4510374 into Scottcjn:main Feb 3, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants