Absolute Blockchain Ultimate Hybrid

Production-hardened hybrid Python + Rust blockchain node and devnet stack — Python L1/P2P/REST orchestration with Rust/PyO3 native crypto kernels, Rust bridge path, ABS tokenomics model, Docker/Kubernetes deployment profiles.

Repo: github.com/Gruver87/Absolute_Blockchain_Ultimate_Hybrid

Author: ULADZIMIR DABRANSKI (D.U.P.)
Project owner: Gruver87

Field	Value
Version	1.2.0-industrial
Author	ULADZIMIR DABRANSKI
API Wave	61; check GET /status fields: api_wave, core_real
Entry point	python main.py
Storage	SQLite data/blockchain.db
Chain ID (dev)	77777
Native layer	Rust/PyO3 abs_native: SHA-256, Merkle, state root, secp256k1 verify
Production gate	.\scripts\check_hybrid_full.ps1 / bash scripts/check_hybrid_full.sh

Docs	Link
Changelog	CHANGELOG.md
Honest command reference	docs/ALL_COMMANDS.txt
Roadmap	docs/INDUSTRIAL_ROADMAP.md
Disclaimer	DISCLAIMER.md

---

⚠️ Disclaimer (read first)

What it is	Production-hardened R&D blockchain node, local/devnet network stack, portfolio-grade protocol implementation
What it is NOT	Launched public mainnet, formally audited DeFi, listed token, investment product
ABS token	In-repo tokenomics model (221M cap) — not a tradable asset
Security	Stronger production gates are implemented; no external audit yet; do not use for real funds without independent review

---

Snapshot

Absolute Blockchain Ultimate Hybrid is a production-hardened Python + Rust L1 node and devnet stack: Python keeps node orchestration, P2P gossip, REST/RPC and test flexibility, while Rust/PyO3 accelerates deterministic crypto kernels used by consensus paths. It includes real SQLite persistence, deterministic state roots, multi-node P2P sync, a browser explorer, Rust bridge integration, and fail-closed production configuration gates. It is a serious R&D implementation and deployment base, not a claim that a public audited mainnet is already live.

Area	Level	What is verified in-repo
L1 core	🟢 Hardened R&D implementation	Blocks, balances, 2% burn, genesis, ECDSA txs, auto-mining ~12–15s
REST API	🟢	288+ route handlers, OpenAPI docs endpoint, API Wave 61, prod admin gates
Web Explorer	🟢	SPA on port 8080; 32 functional tabs
P2P networking	🟢 Verified	2 / 3 / 5-node Docker meshes; strict state root checks, topology, and rejoin APIs
TX propagation	🟢	Signed gossip, mempool pull, transaction trace endpoint
Multi-validator devnet	🟢	5 validators, proposer rotation, 3 miners + 2 attesters
State consistency	🟢	Cross-node harness + auto-repair (/chain/consistency/*)
Fork & slashing CI	🟢	/testnet/fork-status, double-vote detection
JSON-RPC	🟢	eth_* subset on port 8545, API-key protection in prod
Tokenomics model	🟢	221M ABS cap, founder D.U.P. 17.4% — enforced in code
Rust native crypto	🟢 Hybrid path	PyO3 abs_native for SHA-256, Merkle proofs, SQLite state root, secp256k1 verify
EVM / L2 / Bridge	🟡 Mixed	EVM subset and Rust bridge path are integrated; dev-only L2/offchain modules are blocked by prod profile
Production mainnet	🔴 Not launched	Requires external audit, live infra, validator operations, and L1 bridge RPC/secrets

Quality gate (Jun 2026): .\scripts\check_hybrid_full.ps1 → full audit OK (421 passed) + hybrid critical OK (63 passed) · Rust/PyO3 native crypto self-test OK · Rust bridge JSON smoke-test OK

---

What you get out of the box

Capability	Status	How to try
Solo node + Explorer	✅	python main.py → http://localhost:8080
Two-node local devnet	✅	.\scripts\start_two_nodes.ps1
Docker 2-node mesh	✅	.\scripts\docker_devnet.ps1
Docker 3-node testnet (Wave 52)	✅	.\scripts\docker_devnet_3node.ps1
Docker 5-validator devnet (Wave 55)	✅	.\scripts\docker_devnet_5validator.ps1
P2P sync verification	✅	python scripts/verify_p2p_ci.py --mode devnet3
Full project audit (one command)	✅	.\scripts\check_everything.ps1
Unit + integration tests	✅	pytest tests/ -q
Cross-chain bridge	✅ Hardened path	Rust bridge + required L1 proof/RPC in prod; Python simulator is explicit dev/test-only
NFT marketplace	✅ Dev module	Persisted in SQLite
Lightning / Plasma / WASM / Will	✅ Dev module	Available through L2 status endpoint; prod-blocked where unsafe
Oracles (prices + weather)	✅ Dev module	Price/weather feeds; external keys stay in .env
Post-quantum crypto modules	✅ R&D module	SPHINCS+, Kyber, Dilithium; private-key helper endpoints blocked in prod

---

Core L1 + P2P (Waves 47–63)

Wave	Feature	Key endpoints
47	TX receipts + chain metrics	GET /chain/metrics, GET /tx/receipt/{hash}
48	Address tx index	GET /address/{addr}/activity, GET /address/{addr}/txs
49	Block proposer audit	GET /chain/proposers/stats, GET /chain/proposer/{addr}
50	Strict state_root on P2P	GET /chain/state-root/status
52	3-node testnet	GET /testnet/mesh, docker_devnet_3node.ps1
53	Fork / slashing CI	GET /testnet/fork-status, GET /slashing/events, --mode ci3
54	State consistency harness	GET /chain/consistency/harness, POST /chain/consistency/repair
58	Fork CI	POST /testnet/fork-exercise, --mode ci-fork partition recovery
59	Bridge relayer e2e	POST /bridge2/transfer → RustBridge, L1 queue, --mode ci-bridge
60	CI L1 RPC + relayer proof	GET /testnet/bridge-relayer-proof, --mode ci-bridge-relayer
61	Network hygiene + peer rejoin	GET /p2p/topology, POST /p2p/reconnect, stable advertised peer ports
62	Live Docker recovery gate	--mode devnet3-recovery, docker_devnet_3node.ps1 -Recovery, restart/rejoin state_root convergence
63	Admin repair endpoint lockdown	JWT_ENFORCE_ADMIN=true, protected sync/reconnect/repair/fork drill POSTs
57	Real core	deterministic proposer, finality quorum, reorg guard, mempool MEV
56	Multi-node proof	GET /testnet/multi-node-proof, POST /testnet/reorg-exercise, 3-validator rotation
55	5-validator devnet	GET /testnet/validators, docker_devnet_5validator.ps1

(Invoke-RestMethod http://localhost:8080/status -UseBasicParsing).api_wave   # → 61
Invoke-RestMethod http://localhost:8080/p2p/topology -UseBasicParsing
Invoke-RestMethod http://localhost:8080/testnet/validators -UseBasicParsing
Invoke-RestMethod http://localhost:8080/chain/consistency/harness -UseBasicParsing

# 5-validator devnet (Wave 55):
.\scripts\docker_devnet_5validator.ps1
python scripts/verify_p2p_ci.py --mode devnet5

# 3-node testnet (Wave 61 verified):
.\scripts\docker_devnet_3node.ps1
python scripts/verify_p2p_ci.py --mode devnet3 --wait 300

# Industrial recovery gate (Wave 62):
.\scripts\docker_devnet_3node.ps1 -Recovery
python scripts/verify_p2p_ci.py --mode devnet3-recovery --wait 300

# Adversarial / bridge CI (no Docker):
python scripts/verify_p2p_ci.py --mode ci3
python scripts/verify_p2p_ci.py --mode ci-fork
python scripts/verify_p2p_ci.py --mode ci-bridge
python scripts/verify_p2p_ci.py --mode ci-bridge-relayer
# Dev-only convenience send (auto_sign is disabled in prod), then trace:
Invoke-RestMethod http://localhost:8080/tx/send -Method POST -ContentType application/json -Body '{"auto_sign":true,"to":"0x2222222222222222222222222222222222222222","value":0.01}'
Invoke-RestMethod http://localhost:8081/mempool -UseBasicParsing   # same tx on node2
Invoke-RestMethod http://localhost:8080/tx/trace/{hash} -UseBasicParsing

Full wave history (37–63): CHANGELOG.md

---

Tokenomics (in-repo model)

Param	Value
Symbol	ABS
Max supply	221 000 000
Founder	Uladzimir Dabranski (D.U.P.) — 17.4% = 38 454 000 ABS
Ecosystem / Treasury	10% + 10% (DAO unlock rules in code)
Staking pool	12.6% (epoch release)
Mining emission	50% until cap

Config: runtime/tokenomics.py · API: GET /tokenomics

---

Quick start

Requirements

• Python 3.10+ (3.11–3.13 tested)
• Rust toolchain — required for abs_native PyO3 crypto acceleration and Rust bridge builds
• Windows / Linux / macOS
• Docker Desktop — optional, for docker_devnet.ps1

Install

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

Build the real Rust/PyO3 crypto extension for local high-throughput runs:

.\scripts\build_native.ps1
.\scripts\build_bridge.ps1
.\scripts\check_hybrid_full.ps1

Linux/macOS:

bash scripts/build_native.sh
bash scripts/build_bridge.sh
bash scripts/check_hybrid_full.sh

The abs_native extension accelerates deterministic consensus kernels behind the existing Python API: SHA-256, Merkle roots/proofs, and the canonical SQLite account state_root, plus secp256k1 ECDSA verification for signed transaction validation. Production profile sets ABS_REQUIRE_NATIVE_CRYPTO=true so the node fails closed when the native wheel is not installed.

Secrets (BRIDGE_ORACLE_SECRET, TELEGRAM_BOT_TOKEN, RPC keys) — only in .env, never commit.

Production Profile

The production profile is fail-closed by default. It requires explicit secrets and real L1 bridge configuration before startup:

Requirement	Enforced by
Signed transactions only; no public auto_sign	REST/RPC handlers
Admin POST protection	JWT_SECRET, JWT_ENFORCE_ADMIN=true
JSON-RPC protection	RPC_API_KEY_REQUIRED=true, RPC_API_KEYS
No wildcard/localhost CORS	CORS_ORIGINS validation
Rust bridge only; no simulator fallback	BRIDGE_MODE=rust, RustBridge runtime
Native crypto required	ABS_REQUIRE_NATIVE_CRYPTO=true, abs_native PyO3 wheel
Required L1 proof path	BRIDGE_REQUIRE_L1_PROOF=true, ETH_RPC_URL / BSC_RPC_URL / POLYGON_RPC_URL
Dev/offchain modules disabled	feature_* prod defaults and /features API
Production config gate	python scripts/prod_gate.py

Start production only after generating real secrets and mounting data/wallet.json:

# Set JWT_SECRET to a generated long value.
# Set RPC_API_KEYS to one or more generated API keys.
# Set BRIDGE_ORACLE_SECRET to a generated long value.
# Set CORS_ORIGINS to your real explorer origin.
# Set ETH_RPC_URL to your real Ethereum RPC endpoint.
.\scripts\docker_prod.ps1

This is still not a public audited mainnet by itself. Before real funds or public validators, run an independent security audit, operate external L1 RPC infrastructure, deploy validator/key management, and test an actual multi-node environment.

Run

python main.py

Service	URL
Explorer + REST	http://localhost:8080
L2 dashboard	http://localhost:8080/l2/status
JSON-RPC	http://localhost:8545
WebSocket	ws://localhost:8766
P2P	:5000

Two nodes (P2P)

.\scripts\stop_node.ps1
.\scripts\start_two_nodes.ps1 -RustBridge -Fresh    # :8080 + :8081

# or Docker:
.\scripts\docker_devnet.ps1 -RustBridge

Expected when healthy:

OK: peers n1=1 n2=1 heights X / X state_consistent=True state_roots_match=True
api_wave=61

Full audit (recommended before release)

Single script — secrets scan, production gate, syntax, tokenomics, Waves 52–61, mega/final audit, pytest, optional live API/P2P/Docker checks:

.\scripts\check_everything.ps1
# Optional:
.\scripts\check_everything.ps1 -Live -P2P -Docker
# Report: data/full_audit_report.json

Verify

pytest tests/ -q
pytest tests/unit/ -q                              # 258 passed, 1 skipped
python scripts/verify_p2p_ci.py --mode devnet3 --wait 300    # 3-node mesh
python scripts/verify_p2p_ci.py --mode devnet3-recovery --wait 300    # node restart/rejoin
python scripts/verify_p2p_ci.py --mode devnet5    # 5-validator mesh
python scripts/verify_p2p_ci.py --mode ci-bridge-relayer
curl.exe http://localhost:8080/health/live
curl.exe http://localhost:8080/status
curl.exe http://localhost:8080/p2p/topology
curl.exe http://localhost:8080/testnet/validators
curl.exe http://localhost:8080/chain/consistency/harness

---

Architecture (short)

main.py → NodeOrchestrator
├── core/blockchain.py      # L1 blocks, txs, state_root
├── storage/database.py     # SQLite (L1 + L2 tables)
├── api/http.py             # REST + explorer backend
├── consensus/              # PoS adapter, slashing, finality
├── execution/              # VM, state engine, EVM adapter
├── features/               # L2, NFT, oracles, reorg, MEV…
├── network/p2p_node.py     # TCP gossip, sync, state_root wire
└── web/explorer/           # Browser UI

Details: docs/ARCHITECTURE.md · Honest feature list: docs/ALL_COMMANDS.txt Part 0

---

API cheat sheet

Method	Path	Purpose
GET	/status	api_wave, peers, bridge, flags
GET	/native/crypto	Rust/PyO3 native crypto availability, self-test, kernels
GET	/sync/status	heights, state_consistent, policy
GET	/chain/metrics	block time, tx/receipt/proposer counts
GET	/chain/state-root/status	roots vs peers, mismatches
GET	/address/{addr}/activity	balance, blocks_proposed, tx counts
GET	/chain/proposer/{addr}	proposer audit detail
GET	/l2/status	Lightning, Plasma, NFT, WASM…
GET	/features	modules + persisted flags
GET	/tokenomics	supply model
POST	/bridge/dev-confirm-pending	dev only

Full list: api/http.py, /docs, docs/ALL_COMMANDS.txt

---

Troubleshooting

Issue	Fix
Connection closed right after Docker up	Wait for /status or run docker_devnet.ps1
api_wave < 60 in Docker	docker compose -f docker-compose.devnet-rust.yml build --no-cache node1 + recreate
Ports busy	.\scripts\stop_node.ps1
Docker :8080/:8082 shows node-1 or 501	A local python main.py is intercepting host ports; stop it before Docker devnet
Docker not running	Start Docker Desktop

---

Contributing

⭐ Star · 🍴 Fork · 🐛 Issues · 🔧 PRs — see CONTRIBUTING.md

---

Author

Uladzimir Dabranski (D.U.P.)

• GitHub: @Gruver87
• Email: gruverpetrov@gmail.com

---

License

MIT — free for learning and forks. No warranty. See DISCLAIMER.md.

---

Last update: June 2026 — API Wave 61, production profile hardening, real P2P topology/rejoin, Docker 3-node devnet, admin repair lockdown, 258 unit tests locally and 324 tests in full audit.