Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
49 commits
Select commit Hold shift + click to select a range
c2c2e0c
docs: add comprehensive RustChain protocol documentation
dagangtj Feb 26, 2026
ea97b74
Add BCOS (Blockchain Certified Open Source) certification
sophiaeagent-beep Feb 26, 2026
fa3298a
Add BCOS Certified badge to README
sophiaeagent-beep Feb 26, 2026
0267d97
Update BCOS certification
Scottcjn Feb 26, 2026
53f1515
Add @sungdark to CONTRIBUTORS.md (#405)
sungdark Feb 26, 2026
2ba7566
API: include miner_id alias in /api/miners response (#406)
econlabsio Feb 26, 2026
d7862ed
Fix: Update python.org link to www.python.org (301 redirect) and stan…
SASAMITTRRR Feb 27, 2026
f207c8c
Add @SASAMITTRRR to CONTRIBUTORS.md (#409)
SASAMITTRRR Feb 27, 2026
67a5a0e
Windows miner v1.6.0: HTTPS, fingerprint attestation, auto-update
Feb 27, 2026
8c95d91
Fix SIMD identity check failing on Windows
Feb 27, 2026
4ce9cef
Fix fingerprint_checks.py for Windows: add IS_WINDOWS, WMI VM detection
Feb 27, 2026
9835dee
fix: add headless attestation JSON output (#411)
createkr Feb 27, 2026
fd9258a
fix(security): reject negative and zero transfer amounts (#412)
createkr Feb 27, 2026
c84f7fb
feat: add dual-mining PoW detection module (Ergo, Warthog, Kaspa, Mon…
Scottcjn Feb 27, 2026
64a85cd
fix(windows-miner): standardize default node URL to rustchain.org\n\n…
createkr Feb 27, 2026
7c54298
feat: add 6 new PoW chains (DERO, Raptoreum, Wownero, Salvium, Concea…
Scottcjn Feb 27, 2026
00194e6
fix: remove cron from mining-status badge (badge is dynamic via shiel…
Scottcjn Feb 27, 2026
1402f08
fix: make BCOS SPDX check non-blocking (continue-on-error for externa…
Scottcjn Feb 27, 2026
519a8f4
fix: replace last IP reference with rustchain.org in Windows miner
Scottcjn Feb 28, 2026
bda7fcb
fix: standardize Explorer URL to HTTPS
jeanmiliuiu-boop Feb 28, 2026
05db727
test: add attestation fuzz testing
Feb 28, 2026
c2dc0a8
miners/macos: v2.5.0 — embedded TLS proxy fallback for legacy Macs
Scottcjn Feb 28, 2026
2d9f367
fix: update HTTP links to HTTPS for security (#449)
scooter7777 Feb 28, 2026
269c4e9
feat: improve fingerprint test coverage with comprehensive test suite…
Joshualover Feb 28, 2026
48e3170
Migrate all user-facing URLs from raw IP to rustchain.org domain
Feb 28, 2026
a3ecf10
Add Telegram Tip Bot for RTC transfers (#426)
xunwen-art Feb 28, 2026
85e742c
Add Epoch Settlement Visualizer (#433)
xunwen-art Feb 28, 2026
2447e9f
RIP-201: Fleet Detection Immune System + Moltbook solver improvements
Scottcjn Feb 28, 2026
2dad3eb
security: remove hardcoded Gemini API key, use env var only
Scottcjn Feb 28, 2026
f93ecce
fix: resolve 6 CI test failures — missing challenge var and empty evi…
Feb 28, 2026
70baa18
RIP-301 Phase 1: Route withdrawal fees to mining pool
Feb 28, 2026
2f1f31f
feat: add Email/SMS miner alert system (tools/miner_alerts)
writsop Feb 28, 2026
2edf06c
feat: RustChain CLI - Command-line network inspector (#503)
Joshualover Mar 1, 2026
441d2ea
fix(ci): add missing beacon_anchor.py module
Scottcjn Mar 1, 2026
037740a
fix(ci): resolve 32 test failures — align tests with hardened server …
Mar 1, 2026
32250b8
feat: RIP-304 — Retro Console Mining via Pico Serial Bridge
Mar 1, 2026
a3c2263
fix: update --version output to RustChain Miner v2.2.1-rip200
Joshualover Mar 1, 2026
ef17832
docs: add CODE_OF_CONDUCT.md
ansomeck Mar 1, 2026
003ddfb
feat: Hall of Fame machine detail + miner dashboard (#479)
createkr Mar 1, 2026
0e75f52
docs: Add Chinese README translation (#486)
createkr Mar 1, 2026
4dfe7ab
fix: correct --version branding from clawrtc to RustChain across all …
Mar 1, 2026
7d15eec
fix: Add OS/arch info to --dry-run output
edisonlv Mar 1, 2026
b11d597
feat: Add rustchain_exporter.py
Joshualover Mar 1, 2026
5a0c85d
feat: Add grafana_dashboard.json
Joshualover Mar 1, 2026
eefb461
docs: Add swagger.html
Joshualover Mar 1, 2026
1a33796
docs: Add README.md
Joshualover Mar 1, 2026
e81cb19
docs: Add Japanese translation of README (README_JA.md) (#501)
edisonlv Mar 2, 2026
1421b0c
docs: Add Spanish translation of README (README_ES.md) (#499)
Joshualover Mar 2, 2026
d5ab586
feat: node server changes for #683
Mar 7, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 10 additions & 4 deletions .github/workflows/bcos.yml
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@ jobs:

if (!hasTier) {
core.warning(
"No BCOS tier label found defaulting to L1. Maintainers: add BCOS-L1 or BCOS-L2 label for explicit tier classification."
"No BCOS tier label found - defaulting to L1. Maintainers: add BCOS-L1 or BCOS-L2 label for explicit tier classification."
);
core.info("Proceeding with default L1 tier.");
} else {
Expand All @@ -77,21 +77,23 @@ jobs:
python -m venv .venv-bcos
. .venv-bcos/bin/activate
python -m pip install --upgrade pip
# SBOM + license report (for evidence; does not change runtime)
python -m pip install cyclonedx-bom pip-licenses

- name: SPDX check (new files)
continue-on-error: true
run: |
. .venv-bcos/bin/activate
python tools/bcos_spdx_check.py --base-ref "origin/${{ github.base_ref }}"
python tools/bcos_spdx_check.py --base-ref "origin/${{ github.base_ref }}" || echo "SPDX check found issues (non-blocking warning)"

- name: Generate SBOM (environment)
continue-on-error: true
run: |
. .venv-bcos/bin/activate
mkdir -p artifacts
python -m cyclonedx_py environment --output-format JSON -o artifacts/sbom_environment.json

- name: Generate dependency license report
continue-on-error: true
run: |
. .venv-bcos/bin/activate
mkdir -p artifacts
Expand All @@ -100,7 +102,11 @@ jobs:
- name: Hash artifacts
run: |
mkdir -p artifacts
sha256sum artifacts/* > artifacts/sha256sums.txt
if ls artifacts/*.json 1>/dev/null 2>&1; then
sha256sum artifacts/* > artifacts/sha256sums.txt
else
echo "No artifacts to hash" > artifacts/sha256sums.txt
fi

- name: Generate BCOS attestation
uses: actions/github-script@v7
Expand Down
23 changes: 2 additions & 21 deletions .github/workflows/mining-status.yml
Original file line number Diff line number Diff line change
@@ -1,8 +1,6 @@
name: RustChain Mining Status Badge

on:
schedule:
- cron: '0 12 * * *'
workflow_dispatch:
inputs:
wallet:
Expand All @@ -11,10 +9,10 @@ on:
default: 'frozen-factorio-ryan'

jobs:
update-badge:
verify-badge:
runs-on: ubuntu-latest
permissions:
contents: write
contents: read

steps:
- name: Checkout
Expand All @@ -32,20 +30,3 @@ jobs:
echo "Badge endpoint not deployed or unreachable yet"
echo "Response: $RESPONSE"
fi

- name: Update mining badge in README
uses: ./.github/actions/mining-status-badge
with:
wallet: ${{ github.event.inputs.wallet || 'frozen-factorio-ryan' }}
readme-path: README.md
badge-style: flat-square

- name: Commit badge update
run: |
git config --local user.email "[email protected]"
git config --local user.name "GitHub Action"
git add README.md
git diff --cached --quiet || (
git commit -m "docs: refresh RustChain mining status badge" && \
git push
)
72 changes: 72 additions & 0 deletions BCOS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,72 @@
# BCOS — Blockchain Certified Open Source

[![BCOS Certified](https://img.shields.io/badge/BCOS-Certified-brightgreen?style=flat&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCIgZmlsbD0id2hpdGUiPjxwYXRoIGQ9Ik0xMiAxTDMgNXY2YzAgNS41NSAzLjg0IDEwLjc0IDkgMTIgNS4xNi0xLjI2IDktNi40NSA5LTEyVjVsLTktNHptLTIgMTZsLTQtNCA1LjQxLTUuNDEgMS40MSAxLjQxTDEwIDE0bDYtNiAxLjQxIDEuNDFMMTAgMTd6Ii8+PC9zdmc+)](https://github.com/nicholaelaw/awesome-bcos)

## What is BCOS?

**Blockchain Certified Open Source (BCOS)** is a human-review certification for open source repositories. It means:

1. **Human Eyes Have Reviewed This Code** — A real person has read through the source, not just an AI. We verify that code does what it claims and nothing more.

2. **Safe for AI Agents** — Certified repositories are safe for autonomous AI agents to install, import, and execute. No hidden telemetry, no supply chain attacks, no obfuscated payloads.

3. **Protecting Open Source** — BCOS exists because the AI agent era creates new risks: agents install packages autonomously, LLMs recommend code they haven't verified, and bad actors publish lookalike packages. BCOS is the human trust layer.

4. **On-Chain Attestation** — Every BCOS certification is backed by a cryptographic attestation on the [RustChain](https://github.com/Scottcjn/Rustchain) blockchain, creating an immutable record of when and by whom the code was reviewed.

## Certification Criteria

| Requirement | Description |
|------------|-------------|
| **Source Readable** | All source code is available and human-readable (no minified/obfuscated blobs) |
| **No Hidden Network Calls** | Code only contacts endpoints documented in README or config |
| **No Credential Harvesting** | Does not collect, exfiltrate, or phone home with user data |
| **Declared Dependencies** | All dependencies listed in manifest (requirements.txt, package.json, Cargo.toml, etc.) |
| **Build Reproducible** | Given the same inputs, produces the same outputs |
| **License Clear** | Open source license present and compatible |
| **Human Reviewed** | At least one named human has read the source and signed off |

## This Repository

| Field | Value |
|-------|-------|
| **Status** | BCOS Certified |
| **Reviewed By** | Scott Boudreaux ([@Scottcjn](https://github.com/Scottcjn)) |
| **Organization** | [Elyan Labs](https://elyanlabs.ai) |
| **Chain** | [RustChain](https://github.com/Scottcjn/Rustchain) (Proof-of-Antiquity) |

## Why BCOS Matters

In the age of AI agents:

- **Agents install packages autonomously** — `pip install`, `npm install`, `cargo add` happen without human oversight
- **LLMs recommend code** — Models suggest libraries they've never verified
- **Supply chain attacks are rising** — Typosquatting, dependency confusion, and trojanized packages target automated systems
- **Open source trust is fragile** — One compromised maintainer can affect millions of downstream users

BCOS provides the missing **human verification layer** between open source code and the AI agents that consume it.

## Verify a BCOS Certification

```bash
# Install the verification tool
pip install clawrtc

# Verify any BCOS-certified repo
clawrtc verify-bcos <github-url>
```

Or check the [RustChain Explorer](https://rustchain.org/explorer) for on-chain attestation records.

## Get BCOS Certified

To certify your own repository:

1. Ensure your code meets all criteria above
2. Submit a review request at [rustchain-bounties](https://github.com/Scottcjn/rustchain-bounties/issues)
3. A human reviewer will audit your source
4. On approval, you receive the BCOS badge and on-chain attestation

---

*BCOS is an initiative of [Elyan Labs](https://elyanlabs.ai) and the [RustChain](https://github.com/Scottcjn/Rustchain) project.*
133 changes: 133 additions & 0 deletions CODE_OF_CONDUCT.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,133 @@
# Contributor Covenant Code of Conduct

## Our Pledge

We as members, contributors, and leaders pledge to make participation in our
community a harassment-free experience for everyone, regardless of age, body
size, visible or invisible disability, ethnicity, sex characteristics, gender
identity and expression, level of experience, education, socio-economic status,
nationality, personal appearance, race, caste, color, religion, or sexual
identity and orientation.

We pledge to act and interact in ways that contribute to an open, welcoming,
diverse, inclusive, and healthy community.

## Our Standards

Examples of behavior that contributes to a positive environment for our
community include:

* Demonstrating empathy and kindness toward other people
* Being respectful of differing opinions, viewpoints, and experiences
* Giving and gracefully accepting constructive feedback
* Accepting responsibility and apologizing to those affected by our mistakes,
and learning from the experience
* Focusing on what is best not just for us as individuals, but for the overall
community

Examples of unacceptable behavior include:

* The use of sexualized language or imagery, and sexual attention or advances of
any kind
* Trolling, insulting or derogatory comments, and personal or political attacks
* Public or private harassment
* Publishing others' private information, such as a physical or email address,
without their explicit permission
* Other conduct which could reasonably be considered inappropriate in a
professional setting

## Enforcement Responsibilities

Community leaders are responsible for clarifying and enforcing our standards of
acceptable behavior and will take appropriate and fair corrective action in
response to any behavior that they deem inappropriate, threatening, offensive,
or harmful.

Community leaders have the right and responsibility to remove, edit, or reject
comments, commits, code, wiki edits, issues, and other contributions that are
not aligned to this Code of Conduct, and will communicate reasons for moderation
decisions when appropriate.

## Scope

This Code of Conduct applies within all community spaces, and also applies when
an individual is officially representing the community in public spaces.
Examples of representing our community include using an official e-mail address,
posting via an official social media account, or acting as an appointed
representative at an online or offline event.

## Enforcement

Instances of abusive, harassing, or otherwise unacceptable behavior may be
reported to the community leaders responsible for enforcement at
[email protected].

All complaints will be reviewed and investigated promptly and fairly.

All community leaders are obligated to respect the privacy and security of the
reporter of any incident.

## Enforcement Guidelines

Community leaders will follow these Community Impact Guidelines in determining
the consequences for any action they deem in violation of this Code of Conduct:

### 1. Correction

**Community Impact**: Use of inappropriate language or other behavior deemed
unprofessional or unwelcome in the community.

**Consequence**: A private, written warning from community leaders, providing
clarity around the nature of the violation and an explanation of why the
behavior was inappropriate. A public apology may be requested.

### 2. Warning

**Community Impact**: A violation through a single incident or series of
actions.

**Consequence**: A warning with consequences for continued behavior. No
interaction with the people involved, including unsolicited interaction with
those enforcing the Code of Conduct, for a specified period of time. This
includes avoiding interactions in community spaces as well as external channels
like social media. Violating these terms may lead to a temporary or permanent
ban.

### 3. Temporary Ban

**Community Impact**: A serious violation of community standards, including
sustained inappropriate behavior.

**Consequence**: A temporary ban from any sort of interaction or public
communication with the community for a specified period of time. No public or
private interaction with the people involved, including unsolicited interaction
with those enforcing the Code of Conduct, is allowed during this period.
Violating these terms may lead to a permanent ban.

### 4. Permanent Ban

**Community Impact**: Demonstrating a pattern of violation of community
standards, including sustained inappropriate behavior, harassment of an
individual, or aggression toward or disparagement of classes of individuals.

**Consequence**: A permanent ban from any sort of public interaction within the
community.

## Attribution

This Code of Conduct is adapted from the [Contributor Covenant][homepage],
version 2.1, available at
[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1].

Community Impact Guidelines were inspired by
[Mozilla's code of conduct enforcement ladder][Mozilla CoC].

For answers to common questions about this code of conduct, see the FAQ at
[https://www.contributor-covenant.org/faq][FAQ]. Translations are available at
[https://www.contributor-covenant.org/translations][translations].

[homepage]: https://www.contributor-covenant.org
[v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
[Mozilla CoC]: https://github.com/mozilla/diversity
[FAQ]: https://www.contributor-covenant.org/faq
[translations]: https://www.contributor-covenant.org/translations
18 changes: 9 additions & 9 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ Thanks for your interest in contributing to RustChain! We pay bounties in RTC to

## What Gets Merged

- Code that works against the live node (`https://50.28.86.131`)
- Code that works against the live node (`https://rustchain.org`)
- Tests that actually test something meaningful
- Documentation that a human can follow end-to-end
- Security fixes with proof of concept
Expand All @@ -49,19 +49,19 @@ python3 -m venv venv && source venv/bin/activate
pip install -r requirements.txt

# Test against live node
curl -sk https://50.28.86.131/health
curl -sk https://50.28.86.131/api/miners
curl -sk https://50.28.86.131/epoch
curl -sk https://rustchain.org/health
curl -sk https://rustchain.org/api/miners
curl -sk https://rustchain.org/epoch
```

## Live Infrastructure

| Endpoint | URL |
|----------|-----|
| Node Health | `https://50.28.86.131/health` |
| Active Miners | `https://50.28.86.131/api/miners` |
| Current Epoch | `https://50.28.86.131/epoch` |
| Block Explorer | `https://50.28.86.131/explorer` |
| Node Health | `https://rustchain.org/health` |
| Active Miners | `https://rustchain.org/api/miners` |
| Current Epoch | `https://rustchain.org/epoch` |
| Block Explorer | `https://rustchain.org/explorer` |
| wRTC Bridge | `https://bottube.ai/bridge` |

## RTC Payout Process
Expand All @@ -77,7 +77,7 @@ curl -sk https://50.28.86.131/epoch

Before opening a docs PR, please verify:

- [ ] Instructions work exactly as written (commands are copy-pasteable).
- [ ] Instructions work exactly as written (commands are copy-pastable).
- [ ] OS/architecture assumptions are explicit (Linux/macOS/Windows).
- [ ] New terms are defined at first use.
- [ ] Broken links are removed or corrected.
Expand Down
3 changes: 3 additions & 0 deletions CONTRIBUTORS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@

| @sungdark | sungdark#0000 | Interested in mining, testing, and automation |
| @SASAMITTRRR | Claw2#0000 | Interested in bounty hunting, documentation, and AI automation |
Loading