Gruver87/Absolute_Blockchain_Ultimate_Hybrid

GitHub: Gruver87/Absolute_Blockchain_Ultimate_Hybrid

一个采用 Python 与 Rust 混合架构的 Layer-1 区块链节点项目,以证据优先的工程理念提供生产级多节点 mesh 和长时间稳定性验证。

Stars: 0 | Forks: 0

# 绝对 Blockchain 终极混合 ![Absolute Blockchain Ultimate Hybrid — Python + Rust L1](https://static.pigsec.cn/wp-content/uploads/repos/cas/3b/3b1392ec39ff9a063bb9c0f3fbb732a893d41e7e9980b6dd728af2a96df1de2c.svg) **混合 Python + Rust Layer-1 节点** — 生产级 profile mesh、RocksDB、REST/JSON-RPC 浏览器、原生加密 (`abs_native`)、EVM 路径、Docker/K8s 部署 profile、证据优先运维。 [![Stars](https://img.shields.io/github/stars/Gruver87/Absolute_Blockchain_Ultimate_Hybrid?style=social)](https://github.com/Gruver87/Absolute_Blockchain_Ultimate_Hybrid/stargazers) [![Forks](https://img.shields.io/github/forks/Gruver87/Absolute_Blockchain_Ultimate_Hybrid?style=social)](https://github.com/Gruver87/Absolute_Blockchain_Ultimate_Hybrid/network/members) [![Release](https://img.shields.io/github/v/release/Gruver87/Absolute_Blockchain_Ultimate_Hybrid?include_prereleases&sort=semver)](https://github.com/Gruver87/Absolute_Blockchain_Ultimate_Hybrid/releases) [![License](https://img.shields.io/badge/License-MIT-green)](LICENSE) [![Python](https://img.shields.io/badge/Python-3.10+-blue)](https://www.python.org/) [![Rust](https://img.shields.io/badge/Rust-abs__native%20PyO3-orange)](native/abs_native) [![Tests CI](https://static.pigsec.cn/wp-content/uploads/repos/cas/91/9190239a735c343a9a56e9761453d5839b4a5d5ed49a762a0e1e632c9eb0ff85.svg)](https://github.com/Gruver87/Absolute_Blockchain_Ultimate_Hybrid/actions/workflows/test.yml) [![Docker CI](https://static.pigsec.cn/wp-content/uploads/repos/cas/31/316373dea7c761d5b38ae45a60837177a6cf64befa15932b99cc55a14931c58d.svg)](https://github.com/Gruver87/Absolute_Blockchain_Ultimate_Hybrid/actions/workflows/docker-prod-image.yml) [![Security audit](https://static.pigsec.cn/wp-content/uploads/repos/cas/da/da73d3c2d7dab4fe2f31b40052e770fd8e565978d8f0546e15e0371675a77a31.svg)](https://github.com/Gruver87/Absolute_Blockchain_Ultimate_Hybrid/actions/workflows/security-audit.yml) [![API Wave](https://img.shields.io/badge/API%20Wave-61-blue)](CHANGELOG.md) [![48h soak](https://img.shields.io/badge/48h%20soak-PASS%20Jul%202026-brightgreen)](docs/EVIDENCE_MATRIX.md) [![Release v1.3.91](https://img.shields.io/badge/Release-v1.3.91-blue)](RELEASE_NOTES_v1.3.91.md) [![Native fuzz](https://static.pigsec.cn/wp-content/uploads/repos/cas/2a/2a9c74c5a8c6ebc1de4d226c7751d3e614c7d9684770857810cfdc5f8ea56a0c.svg)](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, 便携式工具, 区块链, 可视化界面, 子域名突变, 无后门, 网络流量审计, 节点网络, 请求拦截, 逆向工具