Gruver87/Absolute_Blockchain_Ultimate_Hybrid
GitHub: Gruver87/Absolute_Blockchain_Ultimate_Hybrid
一个采用 Python 与 Rust 混合架构的 Layer-1 区块链节点项目,以证据优先的工程理念提供生产级多节点 mesh 和长时间稳定性验证。
Stars: 0 | Forks: 0
# 绝对 Blockchain 终极混合

**混合 Python + Rust Layer-1 节点** — 生产级 profile mesh、RocksDB、REST/JSON-RPC 浏览器、原生加密 (`abs_native`)、EVM 路径、Docker/K8s 部署 profile、证据优先运维。
[](https://github.com/Gruver87/Absolute_Blockchain_Ultimate_Hybrid/stargazers)
[](https://github.com/Gruver87/Absolute_Blockchain_Ultimate_Hybrid/network/members)
[](https://github.com/Gruver87/Absolute_Blockchain_Ultimate_Hybrid/releases)
[](LICENSE)
[](https://www.python.org/)
[](native/abs_native)
[](https://github.com/Gruver87/Absolute_Blockchain_Ultimate_Hybrid/actions/workflows/test.yml)
[](https://github.com/Gruver87/Absolute_Blockchain_Ultimate_Hybrid/actions/workflows/docker-prod-image.yml)
[](https://github.com/Gruver87/Absolute_Blockchain_Ultimate_Hybrid/actions/workflows/security-audit.yml)
[](CHANGELOG.md)
[](docs/EVIDENCE_MATRIX.md)
[](RELEASE_NOTES_v1.3.91.md)
[](https://github.com/Gruver87/Absolute_Blockchain_Ultimate_Hybrid/actions/workflows/fuzz-native.yml)
**关键词:** Absolute Blockchain · 混合 L1 · Python Rust PyO3 · P2P mesh · RocksDB · EVM · JSON-RPC · 工业级 soak · fail-closed 生产 profile
**仓库:** [github.com/Gruver87/Absolute_Blockchain_Ultimate_Hybrid](https://github.com/Gruver87/Absolute_Blockchain_Ultimate_Hybrid) · **默认分支:** `master`
**作者:** **ULADZIMIR DABRANSKI** (D.U.P.) · **所有者:** [Gruver87](https://github.com/Gruver87)
| | |
|---|---|
| **Release** | **v1.3.91** — [说明](RELEASE_NOTES_v1.3.91.md) · [CHANGELOG](CHANGELOG.md) · [Releases](https://github.com/Gruver87/Absolute_Blockchain_Ultimate_Hybrid/releases) |
| **自检** | `.\scripts\check_all.ps1` (Quick / Standard / Full / Live / Max) |
| **入口** | `python main.py` |
| **开发链** | `77777` |
| **主网-v1 准备** | `778888` (生产 profile — **不是**公开主网) |
| **Native** | Rust/PyO3 `abs_native` (hashes, Merkle, state_root, secp256k1, EVM / P2P kernels) |
| **证据** | [docs/EVIDENCE_MATRIX.md](docs/EVIDENCE_MATRIX.md) |
## 状态一览 (实事求是)
| 声明 | 状态 | 证明 |
|-------|--------|-------|
| 本地 / Docker devnet | **已验证** | `docker_devnet*.ps1`, CI |
| 生产级 profile 3 节点 mesh (778888) | **已验证** | `docker_prod_3node.ps1`, 端口 `:18180–18182` |
| 生产 mesh 上的故障转移 + 签名交易 + EVM 内存池 | **已验证** | 2026 年 7 月证据套件 |
| **7小时 + 48小时 soak** | **通过** | 48小时: 2026-07-19→21 在生产 mesh 上 (`logs/soak_report_48h.json`, `fail_lines=0`; 运行标记在 **v1.2.84** 证据时期 — 后来的工业级标记建立在该基准之上) |
| 公开主网 / 已上市 ABS / 外部审计 | **未声明** | [MAINNET_GAP_ANALYSIS](docs/MAINNET_GAP_ANALYSIS.md) 中的差距 |
| 跨链 L1 切换 | **按设计在生产 mesh 上关闭** | [BRIDGE_L1_MAINNET](docs/BRIDGE_L1_MAINNET.md) |
## 为什么这个仓库与众不同
大多数 GitHub 上的 “区块链” 页面都在宣传功能。而这个仓库将**存在的代码**与**已测量的运维**区分开来:
1. **证据矩阵** — 每个主要运维声明都映射到一个命令 + artifact ([EVIDENCE_MATRIX](docs/EVIDENCE_MATRIX.md))。
2. **Fail-closed 生产 profile** — 密钥、原生加密、无模拟器 bridge、管理 JWT、RPC API 密钥。
3. **Docker 下的 48 小时 soak** — 在 `logs/soak_report_48h.json` 中 `passed=true`、`fail_lines=0` (接受 11 个瞬态 ±1 高度 mesh 警告);在经历真实的 OOM/`daemon.json` 事故后加入了日志轮转和 WSL 内存加固。
4. **混合的诚实** — Python 负责编排;Rust 拥有确定性的热路径;差距 (审计、公开 VPS、bridge 切换) 均已列出,绝无隐瞒。
5. **单命令自检** — `.\scripts\check_all.ps1` (waves → 全量 gate → 可选的实时 + 隔离 P2P CI)。
## 自行验证 (推荐)
```
cd Absolute_Blockchain_Ultimate_Hybrid
.\scripts\check_all.ps1 # Quick — industrial waves + gate (~20–40s)
.\scripts\check_all.ps1 -Mode Standard # full offline pytest/audit
.\scripts\check_all.ps1 -Mode Live # + auto-start local node health
.\scripts\check_all.ps1 -Mode Max # Full + Live + isolated P2P CI
.\scripts\check_all.ps1 -Help
```
报告: `data/check_all.json`。别名: `.\scripts\test_all.ps1`, `.\scripts\check_everything.ps1`, `.\scripts\test_blockchain_full.ps1`。
## 文档导航
| 文档 | 目的 |
|-----|---------|
| [EVIDENCE_MATRIX](docs/EVIDENCE_MATRIX.md) | 已验证 vs 未验证 (事实来源) |
| [MAINNET_GAP_ANALYSIS](docs/MAINNET_GAP_ANALYSIS.md) | 前往主网-v1 的诚实清单 |
| [ARCHITECTURE](docs/ARCHITECTURE.md) | 系统设计 |
| [COMMANDS_REFERENCE](docs/COMMANDS_REFERENCE.md) | 操作员命令 (简短) |
| [ALL_COMMANDS](docs/ALL_COMMANDS.txt) | 完整命令手册 (无密钥) |
| [PUBLIC_TESTNET](docs/PUBLIC_TESTNET.md) | 测试网计划 (本地种子节点已验证;公开 URL 尚未) |
| [STORAGE_ROCKSDB](docs/STORAGE_ROCKSDB.md) | 生产存储 + DR |
| [BRIDGE_L1_MAINNET](docs/BRIDGE_L1_MAINNET.md) | Bridge 切换规则 |
| [SECURITY](SECURITY.md) · [CONTRIBUTING](CONTRIBUTING.md) | 密钥策略 · 如何贡献 |
| [REPO_PROFILE](.github/REPO_PROFILE.md) | GitHub About / topics 备忘单 |
## 快照成熟度
| 领域 | 等级 | 已验证 |
|------|-------|----------|
| **L1 核心** | 强化的 R&D | 区块、余额、燃烧、创世、ECDSA 交易、自动挖矿 ~12–15s |
| **REST + Explorer** | 稳固 | `api/http.py` 中 270+ HTTP 路径分支、OpenAPI、Wave 61、SPA explorer |
| **P2P** | 已验证 | 2/3/5 节点 Docker;state_root;拓扑;重新加入;隔离的 CI |
| **生产 mesh 上的交易 / EVM** | 已验证 | 签名 gossip + 内存池部署冒烟测试 (2026 年 7 月) |
| **Rust native** | 混合路径 | 生产环境中需要 `abs_native` (`ABS_REQUIRE_NATIVE_CRYPTO`) |
| **故障转移 / soak** | **已验证** | 故障转移演练 + **7小时** + **48小时通过** |
| **Bridge** | 准备中 | 实验室中的 Rust 路径;在切换前在生产 mesh 上**关闭** |
| **L2 / PQ / ZK 模块** | R&D | 单元测试过;非主网级的 Lightning/Plasma/已审计 SNARKs |
| **公开主网** | **未启动** | 剩余外部审计 + 验证者运维 + L1 切换 |
**质量门禁:** CI 徽章 · `.\scripts\check_all.ps1` · 收集了 **1260** 个测试 (`pytest tests/ --collect-only`, 2026 年 7 月)
## 架构
```
flowchart TB
EX[Explorer / wallets] --> API[REST + JSON-RPC]
API --> ORCH[NodeOrchestrator Python]
ORCH --> P2P[P2P mesh]
ORCH --> CONS[Consensus]
ORCH --> BC[Blockchain]
BC --> STORE[(RocksDB prod / SQLite dev)]
BC --> RUST[abs_native Rust crypto + state_root]
```
完整图表: **[docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)**
### 操作员速查表 (生产 mesh)
| 操作 | 命令 |
|--------|---------|
| 启动 / 恢复 mesh | `.\scripts\docker_prod_3node.ps1 -SkipBuild -KeepVolumes` |
| 探测 | `.\scripts\probe_prod_mesh.ps1` |
| 韧性 | `.\scripts\prod_mesh_resilience_suite.ps1` |
| Soak 24小时+ | `.\scripts\soak_monitor.ps1 -ProdMesh -Hours 48` |
| 工业级门禁 + soak | `python scripts/industrial_gate.py --min-soak-hours 48` |
| 证据套件 | `.\scripts\prod_evidence_suite.ps1` |
| 审计包 zip | `.\scripts\export_audit_pack.ps1` |
| 统一自检 | `.\scripts\check_all.ps1 -Mode Max` |
## 部署模式
| 运行内容 | Chain ID | 备注 |
|--------------|----------|-------|
| `python main.py` | 77777 | 本地单机 / 小型 mesh |
| `docker_devnet_5validator.ps1` | 77777 | 5 验证者实验室 |
| `docker_prod_3node.ps1` | **778888** | 生产级 profile mesh;bridge **关闭** |
**不要**在同一主机端口上将本地 `python main.py` 与 Docker 混合使用。
```
.\scripts\probe_mesh_nodes.ps1 -ProdMesh
```
## 快速开始
### 环境要求
- Python **3.10+** · Rust 工具链 · Docker Desktop (用于 mesh) · Windows / Linux / macOS
```
git clone https://github.com/Gruver87/Absolute_Blockchain_Ultimate_Hybrid.git
cd Absolute_Blockchain_Ultimate_Hybrid
pip install -r requirements.txt
cp .env.example .env
cp wallet.example.json data/wallet.json
```
```
.\scripts\build_native.ps1
.\scripts\build_bridge.ps1
.\scripts\check_all.ps1 -Mode Standard
python main.py
```
Explorer: http://localhost:8080
密钥只能在 `.env` 中 — 切勿提交。参见 [SECURITY.md](SECURITY.md)。
### 生产 3 节点 mesh
```
.\scripts\setup_prod_env.ps1 # once
.\scripts\docker_prod_3node.ps1
# later:
.\scripts\docker_prod_3node.ps1 -SkipBuild -KeepVolumes
```
| 节点 | Explorer |
|------|----------|
| mesh-1 | http://127.0.0.1:18180 |
| mesh-2 | http://127.0.0.1:18181 |
| mesh-3 | http://127.0.0.1:18182 |
容器日志已设置轮转 (`50m × 3`),因此长时间的 soak 不会填满 Docker VM 磁盘。
## 仓库内置功能
| 功能 | 状态 | 方式 |
|------------|--------|-----|
| 单机节点 + Explorer | 就绪 | `python main.py` |
| Docker 2/3/5 节点实验室 | 就绪 | `docker_devnet*.ps1` |
| 生产 3 节点 mesh | 就绪 | `docker_prod_3node.ps1` |
| P2P / 分叉 / Bridge CI 模式 | 就绪 | `verify_p2p_ci.py` |
| 统一自检 | 就绪 | `check_all.ps1` |
| 完整本地门禁 | 就绪 | `test_blockchain_full.ps1` / `monolith_gate.ps1` |
| 跨链 Bridge | 受切换门控 | 在 L1 合约就绪前,生产环境 778888 上关闭 |
| Lightning / Plasma / WASM / Oracles / ZK / PQ | R&D 模块 | 单元测试过;非完整的主网产品 |
## 核心 L1 + P2P (Waves 47–63)
| Wave | 功能 |
|------|---------|
| **47–50** | 回执、指标、地址索引、proposers、严格的 `state_root` |
| **52–56** | 3 节点测试网、分叉/惩罚 CI、一致性测试套件、多节点证明、5 个验证者 |
| **57** | 确定性 proposer、终局性法定人数、重组防护、内存池 MEV |
| **58–60** | 分叉 CI、Bridge relayer e2e、L1 RPC relayer 证明 |
| **61–63** | 拓扑 / 重新加入、Docker 恢复门禁、管理 JWT 锁定 |
```
(Invoke-RestMethod http://localhost:8080/status).api_wave # → 61
.\scripts\docker_devnet_3node.ps1
python scripts/verify_p2p_ci.py --mode ci --wait 90
```
历史记录: [LOG.md](CHANGELOG.md)
## 代币经济学 (仓库内模型)
| 参数 | 数值 |
|-------|-------|
| 符号 | **ABS** |
| 最大供应量 | **221 000 000** |
| 创始人 (D.U.P.) | **17.4%** = 38 454 000 ABS |
| 生态系统 / 金库 / 质押 / 挖矿 | 10% / 10% / 12.6% / 50% 直至上限 |
代码: `runtime/tokenomics.py` · `GET /tokenomics` — **不是**已上市的代币。
## 生产 profile (fail-closed)
| 要求 | 执行方式 |
|-------------|-------------|
| 无公开 `auto_sign` | REST/RPC |
| 管理 POST JWT | `JWT_ENFORCE_ADMIN` |
| RPC API 密钥 | `RPC_API_KEY_REQUIRED` |
| 无通配符 CORS | 配置验证 |
| 仅限 Rust Bridge | `BRIDGE_MODE=rust` |
| 强制原生加密 | `ABS_REQUIRE_NATIVE_CRYPTO` |
| Bridge 开启时需要 L1 证明 | `BRIDGE_REQUIRE_L1_PROOF` |
| 配置门禁 | `python scripts/prod_gate.py` |
## 运维证据时间轴 (2026 年 7 月)
| 时间 | 事件 |
|------|------|
| 7月 12日 | 故障转移、签名交易、EVM 内存池、**7小时 soak 通过** |
| 7月 13–17日 | 生产 mesh 加固、P2P/TLS/韧性、工业级门禁 |
| 7月 17–18日 | 首次 48 小时尝试中断 (Docker OOM / 损坏的 `daemon.json`) |
| 7月 19–21日 | 日志轮转 + Docker 内存余量优化后,干净的 **48 小时 soak 通过** |
| 7月 21–25日 | 工业级 waves **v1.3.65–v1.3.91** · 原生 TCP+TLS 传输 · Sybil/Eclipse 防护 · fuzz · `check_all` |
详情: [EVIDENCE_MATRIX](docs/EVIDENCE_MATRIX.md) · [RELEASE_NOTES_v1.3.91](RELEASE_NOTES_v1.3.91.md)
## 许可证
MIT — 参见 [LICENSE](LICENSE)。
*最后更新: 2026-07-25 — **v1.3.91** + 原生 rustls P2P TLS。非已启动的公开主网。*
标签:EVM, Layer-1, Python, RocksDB, Rust, 便携式工具, 区块链, 可视化界面, 子域名突变, 无后门, 网络流量审计, 节点网络, 请求拦截, 逆向工具